WHvStartPartitionMigration

Начинает перенос секции на исходном узле.

Синтаксис

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

Parameters

Partition

Обработка объекта секции для миграции.

MigrationHandle

Получает дескриптор, представляющий выполняющуюся миграцию. Исходный процесс передает этот дескриптор в целевой процесс, который передает его для WHvAcceptPartitionMigration получения секции.

Возвращаемое значение

Если функция выполнена успешно, возвращается S_OKзначение.

Если секция уже участвует в миграции, функция возвращается HRESULT_FROM_WIN32(ERROR_INVALID_STATE).

Remarks

Функция WHvStartPartitionMigration запускает исходную сторону миграции секции. Он сериализует состояние секции, свойства, виртуальные процессоры, двери и виртуальные устройства PCI и отправляет их вместе с необходимыми дескрипторами в целевой процесс. Операция отправки остается ожидающей, пока конечный узел не примет секцию.WHvAcceptPartitionMigration

После успешного выполнения этого вызова секция вводит состояние миграции, в котором операции, которые будут недопустимыми уже сериализованным состоянием, блокируются. С этого момента источник должен завершить миграцию с WHvCompletePartitionMigration помощью или прервать ее WHvCancelPartitionMigration. При удалении секции WHvDeletePartition также отменяется миграция.

Возвращенный MigrationHandle дескриптор является стандартным дескриптором Win32. Исходный процесс отвечает за передачу его в целевой процесс любым подходящим средством (например, обработка дублирования). WHvAcceptPartitionMigration закрывает дескриптор на стороне назначения при успешном выполнении.

Типичная последовательность миграции:

  1. Исходные вызовы WHvStartPartitionMigration для начала миграции и получения MigrationHandle.
  2. Конечные вызовы WHvAcceptPartitionMigration с переданным дескриптором для создания целевой секции.
  3. Исходные вызовы WHvCompletePartitionMigration для завершения и выпуска исходной секции.
  4. Вызовы WHvSetupPartition назначения для завершения миграции в целевом объекте и возобновления нормальной работы.

Требования

Requirement Ценность
Минимальный поддерживаемый Windows Windows 10 версии 20H2 (x64); Windows 11 версии 24H2, сборка 26100.3915 (Arm64)
Header WinHvPlatform.h
Библиотека WinHvPlatform.lib
DLL WinHvPlatform.dll
Architecture x64, Arm64

См. также

  • Last updated on