DXGKDDI_SAVEIMMUTABLEMIGRATIONDATA回呼函式 (d3dkmddi.h)

KMD 的 DxgkDdiSaveImmutableMigrationData 函式會儲存不可變的數據，以供即將啟動的即時移轉。

語法

DXGKDDI_SAVEIMMUTABLEMIGRATIONDATA DxgkddiSaveimmutablemigrationdata;

NTSTATUS DxgkddiSaveimmutablemigrationdata(
  IN_CONST_HANDLE hAdapter,
  INOUT_PDXGKARG_GPUP_SAVE_IMMUTABLE_MIGRATION_DATA pArgs
)
{...}

參數

hAdapter

[in]與顯示配接器相關聯的內容區塊句柄。 顯示迷你埠驅動程式先前在 DXGKDDI_ADD_DEVICE 函式的MiniportDeviceContext 輸出參數中，將此句柄提供給 Dxgkrnl。

pArgs

[in/out] DXGKARG_GPUP_SAVE_IMMUTABLE_MIGRATION_DATA 結構的指標，以取得與呼叫相關的資訊。

傳回值

如果呼叫成功，DxgkDdiSaveImmutableMigrationData 會傳回STATUS_SUCCESS。 否則，它會傳回適當的NTSTATUS程式代碼。

備註

呼叫 KMD 的 DxgkDdiPrepareLiveMigration 函式之後， Dxgkrnl 接著會呼叫DxgkDdiSaveImmutableMigrationData ，以收集裝置在目標端還原的相關信息。 這點也是系統驗證遠端設定的機會，因此 DxgkDdiSaveImmutableMigrationData 應該封裝足夠的資訊，以驗證任何可偵測 VF 移至目標組態的功能的硬體、韌體或驅動程式驗證數據。

驅動程式應該儲存 VF 的相關數據，而 VF 在運作時，目標 KMD 可用來協助初始化新的 VF。 此數據不需要包含 vGPU 建立參數，因為這些參數會以較低層級傳輸，並用來使用一般 DDI 建立 vGPU。 這可以包含系結至 VF 的所有數據，而且不需要全部還原於目標端。 數據只能針對驗證目的傳送，這是此介面的重要部分。

DxgkDdiSaveImmutableMigrationData 是在傳統動態緩衝區模式中呼叫：

• 在第一次呼叫時， DataSize 會設定為 0， 並將 Data 設定為 NULL。 KMD 應該將 DataSize 變更為儲存不可變數據的位元組總數。
• Dxgkrnl 會建立 DataSize 位元組的緩衝區，並將 DataSize 設定為 KMD 和指向配置緩衝區 的數據 所傳回的值進行第二次呼叫。 Dxgkrnl 會控制呼叫之後此配置記憶體的存留期。

DxgkDdiSaveMutableMigrationData 會在即時移轉結束時呼叫，以收集可變動的數據。

如需詳細資訊，請參閱 GPU-P 裝置上的即時移轉。

規格需求

另請參閱

DXGKARG_GPUP_SAVE_IMMUTABLE_MIGRATION_DATA

DxgkDdiPrepareLiveMigration

DxgkDdiSaveMutableMigrationData