次の方法で共有

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

こちらもご覧ください

DXGKARGCB_SAVEMEMORYFORHOTUPDATE

DXGKRNL_INTERFACE