WHvStartPartitionMigration

開始在來源主機上遷移分割區。

語法

HRESULT
WINAPI
WHvStartPartitionMigration(
    _In_ WHV_PARTITION_HANDLE Partition,
    _Out_ HANDLE* MigrationHandle
    );

Parameters

Partition

將 handle 轉到 partition 物件進行遷移。

MigrationHandle

接收一個代表正在進行遷移的句柄。 來源程序將此句柄傳送給目的程序，目的程序再將其傳達 WHvAcceptPartitionMigration 至接收分割區。

傳回值

如果函式成功，則傳回值為 S_OK。

若分割區已參與遷移，函數返回 HRESULT_FROM_WIN32(ERROR_INVALID_STATE)。

Remarks

該 WHvStartPartitionMigration 函式啟動分割區遷移的來源端。 它會序列化分割區的狀態、屬性、虛擬處理器、門鈴及虛擬 PCI 裝置，並將這些裝置連同必要的句柄一併傳送至目的地程序。 傳送操作會一直待處理，直到目的主機接受帶有 WHvAcceptPartitionMigration的分割。

呼叫成功後，分割區進入遷移狀態，阻擋會使已序列化狀態失效的操作。 從此時起，來源必須以 完成遷移WHvCompletePartitionMigration，或以 中止遷移。WHvCancelPartitionMigration 刪除 的 WHvDeletePartition 分割區也會取消遷移。

回傳的 MigrationHandle handle 是標準的 Win32 把柄。 來源程序負責以適當方式（例如處理重複）將該程序傳送到目的程序。 WHvAcceptPartitionMigration 成功時會關閉目的地側的把手。

典型的遷移序列為：

1. 來源呼叫 WHvStartPartitionMigration 開始遷移並取得 MigrationHandle。
2. 目的埠會呼叫 WHvAcceptPartitionMigration 傳輸的句柄來建立目標分割區。
3. 原始碼呼叫 WHvCompletePartitionMigration 以完成並釋放原始碼分割。
4. 目的地呼叫 WHvSetupPartition 完成目標遷移並恢復正常運作。

Requirements

另請參閱

• WHvAcceptPartitionMigration
• WHvCompletePartitionMigration
• WHvCancelPartitionMigration
• WHvSetupPartition
• Windows Hypervisor 平台 API 定義