DXGKDDI_DESTROYALLOCATION回呼函式 (d3dkmddi.h)

發行項
02/23/2024

DxgkDdiDestroyAllocation 函式會釋放配置。

語法

DXGKDDI_DESTROYALLOCATION DxgkddiDestroyallocation;

NTSTATUS DxgkddiDestroyallocation(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARG_DESTROYALLOCATION pDestroyAllocation
)
{...}

參數

[in] hAdapter

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

[in] pDestroyAllocation

DXGKARG_DESTROYALLOCATION 結構的指標，其中包含釋放配置的資訊。

傳回值

DxgkDdiDestroyAllocation 會傳回STATUS_SUCCESS，如果配置未成功釋放，則傳回適當的錯誤結果。

備註

當使用者模式顯示驅動程式呼叫 pfnDeallocateCb 函式時，DirectX 圖形核心子系統 (，這是 Dxgkrnl.sys) 呼叫顯示迷你埠驅動程式的 DxgkDdiDestroyAllocation 函式以釋放配置。顯示迷你埠驅動程序應該清除其內部數據結構和配置參考。 Microsoft Direct3D 運行時間會起始對視訊記憶體管理員的呼叫 (，這也是 Dxgkrnl.sys) 的 一部分，然後呼叫 GPU 排程 器 (， 這也是Dxgkrnl.sys) 實際釋放視訊記憶體之前同步處理的一部分。

顯示迷你埠驅動程式可以釋放整個資源以及配置。若要判斷是否應該釋放資源，顯示迷你埠驅動程式可以檢查 DestroyResource 旗標是否設定在 pDestroyAllocation 參數指向之 DXGKARG_DESTROYALLOCATION 結構的 Flags 成員中。若要釋放資源，顯示迷你埠驅動程序必須清除 DXGKARG_DESTROYALLOCATION指定之 hResource 成員的句柄。如果顯示迷你埠驅動程式未釋放資源，驅動程式可以視需要變更 hResource 中的值。

DxgkDdiDestroyAllocation 應設為可分頁。