DXGKDDI_GETSTANDARDALLOCATIONDRIVERDATA回呼函式 (d3dkmddi.h)
DxgkDdiGetStandardAllocationDriverData 函式會傳回標準配置類型的描述。
語法
DXGKDDI_GETSTANDARDALLOCATIONDRIVERDATA DxgkddiGetstandardallocationdriverdata;
NTSTATUS DxgkddiGetstandardallocationdriverdata(
[in] IN_CONST_HANDLE hAdapter,
[in/out] INOUT_PDXGKARG_GETSTANDARDALLOCATIONDRIVERDATA pGetStandardAllocationDriverData
)
{...}
參數
[in] hAdapter
與顯示配接器相關聯的內容區塊句柄。 核心模式顯示驅動程式 (KMD) 先前在其 DxgkDdiAddDevice 函式中提供了此句柄來 Dxgkrnl。
[in/out] pGetStandardAllocationDriverData
描述標準配置之DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA 結構的指標。
傳回值
DxgkDdiGetStandardAllocationDriverData 會傳回下列其中一個值:
傳回碼 | 描述 |
---|---|
STATUS_SUCCESS | DxgkDdiGetStandardAllocationDriverData 成功傳回標準配置類型的描述。 |
STATUS_NO_MEMORY | DxgkDdiGetStandardAllocationDriverData 無法配置完成所需的記憶體。 |
言論
標準配置類型 是必須在核心模式中建立的配置,而不需與使用者模式顯示驅動程序通訊。
Dxgkrnl 呼叫核心模式驅動程式 DxgkDdiGetStandardAllocationDriverData 函式,以產生 pGetStandardAllocationDriverData 參數所指定之標準配置類型的描述。 KMD 會傳回 pAllocationPrivateDriverData 中的配置類型描述,pResourcePrivateDriverDatapGetStandardAllocationDriverData 參數所指向之 DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA 結構的成員。 Dxgkrnl 接著將描述傳遞至 DxgkDdiCreateAllocation 函式,以實際建立配置。
從 Windows 7 開始,如果 KMD 處理對 DxgkDdiGetStandardAllocationDriverData 函式的呼叫,以建立 GDI 硬體加速的配置,驅動程式應設定 CPU 可見配置的配置音調 **pGetStandardAllocationDriverData->pCreateGdiSurfaceData->**Pitch。
DxgkDdiGetStandardAllocationDriverData 應設為可分頁。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows Vista |
目標平臺 | 桌面 |
標頭 | d3dkmddi.h |
IRQL | PASSIVE_LEVEL |