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,数据 为 NULL。 KMD 应 DataSize 更改为存储不可变数据的字节总数。
  • Dxgkrnl 创建一个 DataSize 字节的缓冲区,并进行第二次调用,DataSize 设置为 KMD 返回的值,数据 指向分配的缓冲区。 Dxgkrnl 控制调用后此分配内存的生存期。

在实时迁移开始时调用 DxgkDdiSaveImmutableMigrationData 以收集不可变数据。

有关详细信息,请参阅 GPU-P 设备上的实时迁移

要求

要求 价值
最低支持的客户端 Windows 11 版本 24H2 (WDDM 3.2)
标头 d3dkmddi.h
IRQL PASSIVE_LEVEL

另请参阅

DXGKARG_GPUP_SAVE_MUTABLE_MIGRATION_DATA

DxgkDdiSaveImmutableMigrationData