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

另请参阅

RestoreImmutableGpup