WHvResetPartition

Сбрасывает секцию в исходное состояние.

Синтаксис

HRESULT
WINAPI
WHvResetPartition(
    _In_ WHV_PARTITION_HANDLE Partition
    );

Parameters

Partition

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

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

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

Если раздел находится в состоянии, которое не разрешает сброс, функция возвращается HRESULT_FROM_WIN32(ERROR_INVALID_STATE).

Remarks

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

Чтобы выполнить сброс, функция блокирует все виртуальные процессоры секции и зависает время секции; время снова оттаивается при следующем запуске виртуального процессора. Существующие виртуальные процессоры повторно инициализированы вместо удаления, поэтому количество виртуальных процессоров и настроенных свойств секции сохраняются во время сброса.

Сброс секции не удаляет сопоставления гостевых физических адресов (GPA) или не изменяет содержимое резервной памяти, установленной.WHvMapGpaRange

Требования

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

См. также

• WHvCreatePartition
• WHvSetupPartition
• WHvDeletePartition
• Windows Определения API платформы гипервизора