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

另請參閱

DXGKARGCB_SAVEMEMORYFORHOTUPDATE

DXGKRNL_INTERFACE