IGPUPMigration::SaveImmutableGpup 方法(igpupvdev.h)
SaveImmutableGpup 方法是 IGPUPMigration 接口的一部分,旨在保存实时迁移过程中虚拟 GPU(vGPU)的不可变状态。
语法
HRESULT SaveImmutableGpup(
PLUID DeviceLuid,
UINT64 *Length,
BYTE [] SaveBuffer
);
参数
DeviceLuid
[in]指向 LUID 结构的指针,该结构表示要保存其不可变状态的设备本地唯一标识符(LUID)。
Length
[in, out]指向一个变量的指针,该变量指定 SaveBuffer 指向的缓冲区的长度(以字节为单位)。 在输入时,此变量指定缓冲区的大小。 在输出中,它接收写入缓冲区的字节数。
SaveBuffer
[in, out]指向接收设备不可变状态的调用方分配的缓冲区的指针。
返回值
SaveImmutableGpup 返回指示方法调用状态的 HRESULT 值。 可能的返回值包括但不限于以下内容:
返回值 | 描述 |
---|---|
S_OK | 方法调用成功。 |
E_INVALIDARG | 将无效参数传递给方法。 |
E_OUTOFMEMORY | 该方法无法为缓冲区分配内存。 |
言论
SaveImmutableGpup 方法捕获 vGPU 设备的不可变状态,该状态在整个设备的生存期内保持不变。 此状态对于确保实时迁移期间的一致性至关重要。
在保存设备的可变状态之前,通常会在实时迁移过程的准备阶段调用它。
有关详细信息,请参阅 GPU-P 计算机上的实时迁移。
要求
要求 | 价值 |
---|---|
标头 | igpupvdev.h |