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 |