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) の 1 つだけを NULL にすることはできません。
DXGKCB_XXX 関数は Dxgkrnl によって実装されます。 このコールバック関数を使用するには、DXGKARGCB_SAVEMEMORYFORHOTUPDATEの適切なメンバーを設定し、DXGKRNL_INTERFACE経由で DxgkCbSaveMemoryForHotUpdate を呼び出します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 10バージョン 1903 (WDDM 2.6) |
| Header | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |