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 |