DXGKDDI_GETSTANDARDALLOCATIONDRIVERDATA回呼函式 (d3dkmddi.h)

發行項
02/23/2024

DxgkDdiGetStandardAllocationDriverData 函式會傳回標準配置類型的描述。

語法

DXGKDDI_GETSTANDARDALLOCATIONDRIVERDATA DxgkddiGetstandardallocationdriverdata;

NTSTATUS DxgkddiGetstandardallocationdriverdata(
  [in]     IN_CONST_HANDLE hAdapter,
  [in/out] INOUT_PDXGKARG_GETSTANDARDALLOCATIONDRIVERDATA pGetStandardAllocationDriverData
)
{...}

參數

[in] hAdapter

與顯示配接器相關聯的內容區塊句柄。顯示迷你埠驅動程式先前已將此句柄提供給 DxgkDdiAddDevice 函式之 MiniportDeviceContext 輸出參數中的 Microsoft DirectX 圖形核心子系統。

[in/out] pGetStandardAllocationDriverData

描述標準配置之DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA 結構的指標。

傳回值

DxgkDdiGetStandardAllocationDriverData 會傳回下列其中一個值：

傳回碼	Description
STATUS_SUCCESS	DxgkDdiGetStandardAllocationDriverData 已成功傳回標準配置類型的描述。
STATUS_NO_MEMORY	DxgkDdiGetStandardAllocationDriverData 無法配置完成所需的記憶體。

備註

標準配置類型 是在核心模式中必須建立的配置，而不需從使用者模式顯示驅動程式進行通訊。 DirectX 圖形核心子系統會呼叫 DxgkDdiGetStandardAllocationDriverData 函式，以產生 pGetStandardAllocationDriverData 參數所指定之標準配置類型的描述。顯示迷你埠驅動程式會傳回 pAllocationPrivateDriverData 和 pResourcePrivateDriverData 結構中 pGetStandardAllocationDriverData 參數指向之DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA結構中配置類型的描述。 DirectX 圖形核心子系統接著會將描述傳遞至 DxgkDdiCreateAllocation 函式，以實際建立配置。

從 Windows 7 開始，如果顯示迷你埠驅動程式處理對 DxgkDdiGetStandardAllocationDriverData 函式的呼叫來建立 GDI 硬體加速的配置，則驅動程式應該設定 CPU 可見配置的配置間距 pGetStandardAllocationDriverData-pCreateGdiSurfaceData-Pitch>>。

DxgkDdiGetStandardAllocationDriverData 應設為可分頁。