Edit

Share via

IGPUPMigration::SaveImmutableGpup method (igpupvdev.h)

  • Article

The SaveImmutableGpup method is part of the IGPUPMigration interface, designed to save the immutable state of a virtual GPU (vGPU) during live migration processes.

Syntax

HRESULT SaveImmutableGpup(
  PLUID   DeviceLuid,
  UINT64  *Length,
  BYTE [] SaveBuffer
);

Parameters

DeviceLuid

[in] Pointer to a LUID structure that represents the locally unique identifier (LUID) of the device whose immutable state is to be saved.

Length

[in, out] Pointer to a variable that specifies the length in bytes of the buffer that SaveBuffer points to. On input, this variable specifies the size of the buffer. On output, it receives the number of bytes written to the buffer.

SaveBuffer

[in, out] Pointer to a caller-allocated buffer that receives the immutable state of the device.

Return value

SaveImmutableGpup returns an HRESULT value that indicates the status of the method call. Possible return values include, but are not limited to, the following:

Return value Description
S_OK The method call was successful.
E_INVALIDARG An invalid argument was passed to the method.
E_OUTOFMEMORY The method failed to allocate memory for the buffer.

Remarks

The SaveImmutableGpup method captures the immutable state of a vGPU device, which remains constant throughout the device's lifetime. This state is essential for ensuring consistency during live migration.

It's typically called during the preparation phase of a live migration process, before the device's mutable state is saved.

For more information see Live migration on GPU-P machines.

Requirements

Requirement Value
Header igpupvdev.h

See also

RestoreImmutableGpup