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 函式的MiniportDeviceContext 輸出參數中，將此句柄提供給 Dxgkrnl。
pArgs
[in/out] DXGKARG_GPUP_SAVE_MUTABLE_MIGRATION_DATA 結構的指標，以取得與呼叫相關的資訊。
傳回值
如果呼叫成功，DxgkDdiSaveMutableMigrationData 會傳回STATUS_SUCCESS。 否則，它會傳回適當的NTSTATUS程式代碼。
備註
當即時移轉即將結束時，會呼叫 DxgkDdiSaveMutableMigrationData 來收集可變動的數據。 目前暫停的 VF 應該只呼叫此 DDI。
在傳統動態緩衝區模式中呼叫 DxgkDdiSaveMutableMigrationData：
- 在第一次呼叫時， DataSize 會設定為 0， 並將 Data 設定為 NULL。 KMD 應該將 DataSize 變更為儲存不可變數據的位元組總數。
- Dxgkrnl 會建立 DataSize 位元組的緩衝區，並將 DataSize 設定為指向已配置緩衝區之 KMD 和 Data 所傳回的值進行第二次呼叫。 Dxgkrnl 控制呼叫之後此配置記憶體的存留期。
在即時移轉開始時呼叫 DxgkDdiSaveImmutableMigrationData，以收集不可變的數據。
如需詳細資訊，請參閱 GPU-P 裝置上的即時移轉。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 11 版本 24H2 (WDDM 3.2) |
| 標頭 | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |