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 |