DXGKDDI_DESTROYALLOCATION回呼函式 (d3dkmddi.h)
DxgkDdiDestroyAllocation 函式會釋放配置。
語法
DXGKDDI_DESTROYALLOCATION DxgkddiDestroyallocation;
NTSTATUS DxgkddiDestroyallocation(
[in] IN_CONST_HANDLE hAdapter,
[in] IN_CONST_PDXGKARG_DESTROYALLOCATION pDestroyAllocation
)
{...}
參數
[in] hAdapter
與顯示配接器相關聯的內容區塊句柄。 顯示迷你埠驅動程式先前已將此句柄提供給 MiniportDeviceContextDxgkDdiAddDevice 函式的 Microsoft DirectX 圖形核心子系統。
[in] pDestroyAllocation
DXGKARG_DESTROYALLOCATION 結構的指標,其中包含釋放配置的資訊。
傳回值
DxgkDdiDestroyAllocation 會傳回STATUS_SUCCESS,如果配置未成功發行,則傳回適當的錯誤結果。
言論
當使用者模式顯示驅動程式呼叫 pfnDeallocateCb 函式時,DirectX 圖形核心子系統(屬於 Dxgkrnl.sys的一部分)會呼叫 display miniport 驅動程式的 DxgkDdiDestroyAllocation 函式來釋放配置。 顯示迷你埠驅動程序應該清除其內部數據結構和配置參考。 Microsoft Direct3D 運行時間會起始對視訊記憶體管理員的呼叫(這也是 Dxgkrnl.sys的一部分),然後呼叫 GPU 排程器(這也是 Dxgkrnl.sys的一部分),以在實際釋放視訊記憶體之前同步處理。
顯示迷你埠驅動程式可以釋放整個資源以及配置。 若要判斷是否應該釋放資源,顯示迷你埠驅動程式可以檢查 DestroyResource 旗標是否已設定 在 DXGKARG_DESTROYALLOCATION 結構 pDestroyAllocation 參數所指向之 DXGKARG_DESTROYALLOCATION 結構 成員。 若要釋放資源,顯示迷你埠驅動程序必須清除DXGKARG_DESTROYALLOCATION所指定 hResource 成員的句柄。 如果顯示迷你埠驅動程式未釋放資源,驅動程式可以視需要變更 hResource 中的值。
DxgkDdiDestroyAllocation 應設為可分頁。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows Vista |
目標平臺 | 桌面 |
標頭 | d3dkmddi.h |
IRQL | PASSIVE_LEVEL |