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 |