共用方式為


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