共用方式為


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

另請參閱

DXGKARG_DESTROYALLOCATION

DxgkDdiAddDevice

pfnDeallocateCb