DXGKDDI_OPENALLOCATIONINFO回呼函式 (d3dkmddi.h)

發行項
02/25/2024

DxgkDdiOpenAllocation 函式會系結 DxgkDdiCreateAllocation 函式所建立的非裝置特定配置，以用於指定圖形內容裝置的特定配置。

語法

DXGKDDI_OPENALLOCATIONINFO DxgkddiOpenallocationinfo;

NTSTATUS DxgkddiOpenallocationinfo(
  [in] IN_CONST_HANDLE hDevice,
  [in] IN_CONST_PDXGKARG_OPENALLOCATION pOpenAllocation
)
{...}

參數

[in] hDevice

配置所系結之圖形內容裝置的句柄。顯示迷你埠驅動程式的 DxgkDdiCreateDevice 函式先前已將此句柄提供給 DXGKARG_CREATEDEVICE 結構的 hDevice 成員中的 Microsoft DirectX 圖形核心子系統。

[in] pOpenAllocation

包含系結配置相關信息之DXGKARG_OPENALLOCATION 結構的指標。

傳回值

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

傳回碼	Description
STATUS_SUCCESS	DxgkDdiOpenAllocation 已成功將配置系結至 hDevice 參數指定的圖形內容裝置。
STATUS_INVALID_PARAMETER	傳遞至 DxgkDdiOpenAllocation 的參數包含防止它完成的錯誤。
STATUS_NO_MEMORY	DxgkDdiOpenAllocation 無法配置完成所需的記憶體。
STATUS_GRAPHICS_DRIVER_MISMATCH	顯示迷你埠驅動程式與起始對 DxgkDdiOpenAl (location 呼叫的使用者模式顯示驅動程式不相容，也就是提供私人數據給顯示迷你埠驅動程式) 。

備註

DirectX 圖形核心子系統會呼叫 display miniport 驅動程式的 DxgkDdiOpenAllocation 函式，將 DxgkDdiCreateAllocation 函式所建立的非裝置特定配置系結至 hDevice 參數所指定圖形內容裝置特定的配置。顯示迷你埠驅動程式會將配置系結至裝置，讓驅動程式可以追蹤裝置特有的配置數據。

顯示迷你埠驅動程式可以將配置系結至任何裝置，任何進程 (在同一個圖形適配卡上建立) ，而不只是在建立程式中的裝置。

當 DxgkDdiOpenAllocation 傳回STATUS_SUCCESS時，驅動程式會將每個配置DXGK_OPENALLOCATIONINFO結構的 hDeviceSpecificAllocation 成員設定為非 NULL 值。每個配置DXGK_OPENALLOCATIONINFO結構都是DXGKARG_OPENALLOCATION結構所指定之 pOpenAllocation 成員的陣列元素。

只有在建立配置 (時，才能修改DXGK_OPENALLOCATIONINFO結構的pPrivateDriverData 成員中傳遞的配置私用驅動程序數據，這在設定DXGKARG_OPENALLOCATION結構的 Flags 成員中建立位欄位旗標時，才會) 。當未) 設定 [ 建立位字段] 旗標時，驅動程式應該判斷它只能在開啟配置 (時讀取配置私人驅動程序數據。

DxgkDdiOpenAllocation 應設為可分頁。