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

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

構文

DXGKDDI_SAVEMUTABLEMIGRATIONDATA DxgkddiSavemutablemigrationdata;

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

パラメーター

hAdapter

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

pArgs

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

戻り値

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

注釈

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

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

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

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

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

要件

こちらもご覧ください

DXGKARG_GPUP_SAVE_MUTABLE_MIGRATION_DATA

DxgkDdiSaveImmutableMigrationData