DXGKCB_SAVEMEMORYFORHOTUPDATE回呼函式 (d3dkmddi.h)
核心模式顯示迷你埠驅動程式可以呼叫 DXGKCB_SAVEMEMORYFORHOTUPDATE,以儲存配接器記憶體以支持驅動程序熱更新。
語法
DXGKCB_SAVEMEMORYFORHOTUPDATE DxgkcbSavememoryforhotupdate;
NTSTATUS DxgkcbSavememoryforhotupdate(
[in] IN_CONST_HANDLE hAdapter,
[in] IN_CONST_PDXGKARGCB_SAVEMEMORYFORHOTUPDATE pArgs
)
{...}
參數
[in] hAdapter
傳遞至 dxgkDdiStartDevice 之 DXGK 適配卡的句柄。
[in] pArgs
包含這個回呼自變數之 DXGKARGCB_SAVEMEMORYFORHOTUPDATE 結構的指標。
傳回值
如果作業成功,DXGKCB_SAVEMEMORYFORHOTUPDATE 會傳回STATUS_SUCCESS;否則它會從 Ntstatus.h傳回錯誤碼。
言論
每次呼叫 DXGKCB_SAVEMEMORYFORHOTUPDATE 都會儲存實體記憶體頁面區塊,以及驅動程式想要與記憶體區塊建立關聯的選擇性元數據。 還原頁面時,驅動程式會針對每個儲存的記憶體區塊以及元數據取得個別呼叫。
為了方便起見,回呼提供 3 個選項來儲存物理記憶體:
- 作為連續物理記憶體範圍的陣列(pDataMemoryRanges)
- 作為 MDL (pDataMdl)
- 作為虛擬記憶體緩衝區 (pData)
數據指標的一個(且只有一個)(pDataMemoryRanges、pDataMdl 或 pData) 的指標不得為 NULL。
DXGKCB_XXX 函式是由 Dxgkrnl實作。 若要使用此回呼函式,請設定適當的 DXGKARGCB_SAVEMEMORYFORHOTUPDATE 成員,然後透過 DXGKRNL_INTERFACE呼叫 DxgkCbSaveMemoryForHotUpdate。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows 10 版本 1903 (WDDM 2.6) |
標頭 | d3dkmddi.h |
IRQL | PASSIVE_LEVEL |