通过

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 返回的值进行第二次调用， 并且数据 指向分配的缓冲区。 Dxgkrnl 控制调用后此已分配内存的生存期。

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

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

要求

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

另请参阅

DXGKARG_GPUP_SAVE_MUTABLE_MIGRATION_DATA

DxgkDdiSaveImmutableMigrationData