WHvStartPartitionMigration

Beginnt mit der Migration einer Partition auf dem Quellhost.

Syntax

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

Parameter

Partition

Behandeln Sie das zu migrierende Partitionsobjekt.

MigrationHandle

Empfängt ein Handle, das die laufende Migration darstellt. Der Quellprozess überträgt dieses Handle an den Zielprozess, der es an WHvAcceptPartitionMigration den Empfang der Partition übergibt.

Rückgabewert

Wenn die Funktion erfolgreich ist, lautet S_OKder Rückgabewert .

Wenn die Partition bereits an einer Migration beteiligt ist, gibt die Funktion zurück HRESULT_FROM_WIN32(ERROR_INVALID_STATE).

Remarks

Die WHvStartPartitionMigration Funktion startet die Quellseite einer Partitionsmigration. Sie serialisiert den Zustand der Partition, Eigenschaften, virtuellen Prozessoren, Türglocken und virtuellen PCI-Geräte und sendet sie zusammen mit den erforderlichen Ziehpunkten an den Zielprozess. Der Sendevorgang bleibt aus, bis der Zielhost die Partition akzeptiert WHvAcceptPartitionMigration.

Nachdem dieser Aufruf erfolgreich war, wechselt die Partition in einen Migrationsstatus, in dem Vorgänge, die den bereits serialisierten Zustand ungültig würden, blockiert werden. Ab diesem Zeitpunkt muss die Quelle die Migration entweder mit WHvCompletePartitionMigration oder abbrechen mit WHvCancelPartitionMigration. Wenn Sie die Partition löschen, und WHvDeletePartition die Migration wird ebenfalls abgebrochen.

Das zurückgegebene MigrationHandle Handle ist ein standardmäßiger Win32-Handle. Der Quellprozess ist dafür verantwortlich, ihn auf geeignete Weise an den Zielprozess zu übertragen (z. B. Duplizierung behandeln). WHvAcceptPartitionMigration schließt den Handle auf der Zielseite, wenn er erfolgreich ist.

Die typische Migrationssequenz lautet:

1. Die Quellaufrufe WHvStartPartitionMigration , um mit der Migration zu beginnen und abzurufen MigrationHandle.
2. Die Zielaufrufe WHvAcceptPartitionMigration mit dem übertragenen Handle zum Erstellen der Zielpartition.
3. Die Quellaufrufe WHvCompletePartitionMigration zum Abschließen und Freigeben der Quellpartition.
4. Die Zielaufrufe WHvSetupPartition , um die Migration für das Ziel abzuschließen und den normalen Vorgang fortzusetzen.

Anforderungen

Siehe auch

• WHvAcceptPartitionMigration
• WHvCompletePartitionMigration
• WHvCancelPartitionMigration
• WHvSetupPartition
• Windows Hypervisor-Plattform-API-Definitionen