共用方式為


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

數據指標的一個(且只有一個)(pDataMemoryRangespDataMdlpData) 的指標不得為 NULL。

DXGKCB_XXX 函式是由 Dxgkrnl實作。 若要使用此回呼函式,請設定適當的 DXGKARGCB_SAVEMEMORYFORHOTUPDATE 成員,然後透過 DXGKRNL_INTERFACE呼叫 DxgkCbSaveMemoryForHotUpdate

要求

要求 價值
最低支援的用戶端 Windows 10 版本 1903 (WDDM 2.6)
標頭 d3dkmddi.h
IRQL PASSIVE_LEVEL

另請參閱

DXGKARGCB_SAVEMEMORYFORHOTUPDATE

DXGKRNL_INTERFACE