次の方法で共有

DXGKDDI_SAVEMUTABLEMIGRATIONDATA コールバック関数 (d3dkmddi.h)

  • [アーティクル]

KMD の DxgkDdiSaveMutableMigrationData 関数は、終了しようとしているライブ マイグレーションの変更可能なデータを収集します。

構文

DXGKDDI_SAVEMUTABLEMIGRATIONDATA DxgkddiSavemutablemigrationdata;

NTSTATUS DxgkddiSavemutablemigrationdata(
  IN_CONST_HANDLE hAdapter,
  INOUT_PDXGKARG_GPUP_SAVE_MUTABLE_MIGRATION_DATA pArgs
)
{...}

パラメーター

hAdapter

[in]ディスプレイ アダプターに関連付けられているコンテキスト ブロックへのハンドル。 ディスプレイ ミニポート ドライバーは、DXGKDDI_ADD_DEVICE 関数の出力パラメーター ミニポートDeviceContext で Dxgkrnl を するこのハンドルを提供しました。

pArgs

[入力/出力]呼び出しに関連する情報の DXGKARG_GPUP_SAVE_MUTABLE_MIGRATION_DATA 構造体へのポインター。

戻り値

DxgkDdiSaveMutableMigrationData 、呼び出しが成功した場合にSTATUS_SUCCESSを返します。 それ以外の場合は、適切な NTSTATUS コードが返されます。

備考

DxgkDdiSaveMutableMigrationDataは、ライブ マイグレーションが終了しようとしているときに変更可能なデータを収集するために呼び出されます。 この DDI は、現在一時停止されている VM に対してのみ呼び出す必要があります。

DxgkDdiSaveMutableMigrationData は、クラシック動的バッファー パターンで呼び出されます。

  • 最初の呼び出しでは、DataSize は 0 に設定され、Data は NULL に設定されます。 KMD DataSize は、変更できないデータを格納するために必要な合計バイト数に変更する必要があります。
  • Dxgkrnl 、DataSize バイトのバッファーを作成し、DataSize KMD によって返される値に設定され、割り当てられたバッファーを指すデータ を して 2 回目の呼び出しを行います。 Dxgkrnl は、呼び出し後に割り当てられたこのメモリの有効期間を制御します。

DxgkDdiSaveImmutableMigrationData は、ライブ マイグレーションの開始時に呼び出され、変更できないデータを収集します。

詳細については、「GPU-P デバイスでのライブ マイグレーション」を参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows 11 バージョン 24H2 (WDDM 3.2)
ヘッダー d3dkmddi.h
IRQL PASSIVE_LEVEL

関連項目

DXGKARG_GPUP_SAVE_MUTABLE_MIGRATION_DATA

DxgkDdiSaveImmutableMigrationDataをする