若要指示 GPU 支持 GDI 硬件加速，顯示微型端口驅動程序的 DriverEntry 函數實現必須使用指向驅動程序實現的 DxgkDdiRenderKm 函數的指針填充 DRIVER_INITIALIZATION_DATA 結構的 DxgkDdiRenderKm 成員。
DirectX 圖形內核子系統調用 DxgkDdiRenderKm 函數，以從操作系統提供的內核模式規范顯示驅動程序 (CDD) 傳遞的命令緩沖區生成 DMA 緩沖區。
當 DirectX 圖形內核子系統的顯示端口驅動程序 (Dxgkrnl.sys) 調用 DxgkDdiCreateContext 函數時，它會設置 pCreateContext-Flags-GdiContext >> 成員以指示用于 GDI 硬件加速的上下文。
同樣，當顯示端口驅動程序調用 DxgkDdiCreateDevice 函數時，它會設置 pCreateDevice-Flags-GdiDevice >> 成員以指示用于 GDI 硬件加速的設備。
1. 核心目標
確保顯示微型端口驅動程序正確聲明對 GDI 硬件加速 的支持，使 Windows 圖形子系統（DWM/GDI）能利用 GPU 加速渲染。
2. 關鍵驅動初始化設置
(1) DriverEntry 必須注冊 DxgkDdiRenderKm
作用：
驅動程序必須實現 DxgkDdiRenderKm，用于處理 GDI 命令緩沖區 并生成 GPU 可執行的 DMA 緩沖區。
在 DRIVER_INITIALIZATION_DATA 結構中顯式聲明支持：
DRIVER_INITIALIZATION_DATA DriverInitData = {0};
DriverInitData.DxgkDdiRenderKm = YourDxgkDdiRenderKmFunction; // 必須指向有效實現DriverInitData.DxgkDdiRenderKm = YourDxgkDdiRenderKmFunction; // 必須指向有效實現
調用關系：
DxgkDdiRenderKm 由 DirectX 圖形內核（Dxgkrnl.sys） 調用，用于轉換 CDD（內核模式規范顯示驅動程序） 提供的命令。
(2) 關鍵標志：GdiContext 和 GdiDevice
DxgkDdiCreateContext 中的 GdiContext 標志
當顯示端口驅動創建 GDI 硬件加速上下文 時，會設置：
pCreateContext->Flags.GdiContext = TRUE; // 表示此上下文用于 GDI 加速驅動程序行為：
需分配適合 GDI 渲染的 GPU 資源（如專用命令隊列/狀態）。
DxgkDdiCreateDevice 中的 GdiDevice 標志
當顯示端口驅動創建 GDI 兼容設備 時，會設置：
pCreateDevice->Flags.GdiDevice = TRUE; // 表示此設備支持 GDI 加速驅動程序行為：需初始化與 GDI 兼容的設備特性（如線性內存布局、特定像素格式支持）。
3. 關鍵調用流程
驅動加載時：DriverEntry 注冊 DxgkDdiRenderKm，聲明支持 GDI 加速。
設備初始化時：DxgkDdiCreateDevice 收到 GdiDevice=TRUE，配置 GDI 兼容設備。
上下文創建時：DxgkDdiCreateContext 收到 GdiContext=TRUE，分配 GDI 專用資源。
渲染時：DxgkDdiRenderKm 被調用，將 CDD 的 GDI 命令轉換為 DMA 緩沖區供 GPU 執行。
4. 實現注意事項
| 場景 | 驅動程序需處理的操作 |
|---|---|
GdiDevice=TRUE | 確保設備支持 GDI 要求的特性（如?DXGI_FORMAT_B8G8R8A8_UNORM?像素格式）。 |
GdiContext=TRUE | 可能需禁用某些 GPU 優化（如 Tile-Based Rendering），以匹配 GDI 的立即模式渲染。 |
DxgkDdiRenderKm | 需正確處理 CDD 提供的?GDI 命令緩沖區，生成合規的 DMA 緩沖區。 |
5. 偽代碼示例
// DriverEntry 中初始化 GDI 支持
NTSTATUS DriverEntry(PDRIVER_OBJECT DriverObj, PUNICODE_STRING RegistryPath) {DRIVER_INITIALIZATION_DATA InitData = {0};InitData.DxgkDdiRenderKm = YourRenderKmHandler; // 關鍵：注冊渲染函數// ... 其他初始化 ...DxgkInitialize(&InitData);
}// DxgkDdiCreateDevice 處理 GDI 設備
NTSTATUS DxgkDdiCreateDevice(D3DKMDT_HDEVICE hDevice, CONST DXGKARG_CREATEDEVICE* pArgs) {if (pArgs->Flags.GdiDevice) {// 配置 GDI 兼容設備（如線性內存模式）}
}// DxgkDdiRenderKm 處理 GDI 命令
NTSTATUS DxgkDdiRenderKm(D3DKMDT_HDEVICE hDevice, CONST DXGKARG_RENDER* pArgs) {if (pArgs->Flags.GdiContext) {// 轉換 CDD 的 GDI 命令為 DMA 緩沖區}
}6. 總結
- 必須實現：DxgkDdiRenderKm 是 GDI 加速的核心，未注冊會導致回退到軟件渲染。
- 標志處理：GdiDevice 和 GdiContext 指示需啟用 GDI 兼容模式。
- 性能影響：正確的實現可顯著提升 GDI/DWM 渲染效率，錯誤實現可能導致黑屏或性能下降。
適用于 WDDM v1.2+ 驅動程序開發，尤其是需要兼容傳統 GDI 應用的 GPU 驅動。
)
