WHvResetPartition

将分区重置为其初始状态。

Syntax

HRESULT
WINAPI
WHvResetPartition(
    _In_ WHV_PARTITION_HANDLE Partition
    );

参数

Partition

要重置的分区对象的句柄。

返回值

如果函数成功,则返回值为 S_OK.

如果分区处于不允许重置的状态,该函数将 HRESULT_FROM_WIN32(ERROR_INVALID_STATE)返回。

Remarks

WHvResetPartition 函数将重置分区,将其虚拟处理器返回到分区设置 WHvSetupPartition后立即的状态。 将每个现有虚拟处理器的寄存器状态还原到其初始值,并清除每个虚拟处理器的状态,例如挂起、取消和调度通知状态。

为了执行重置,该函数会阻止分区的所有虚拟处理器并冻结分区时间:下次运行虚拟处理器时,将再次解冻时间。 现有虚拟处理器已就地重新初始化而不是删除,因此在重置后保留虚拟处理器数和分区配置的属性数。

重置分区不会删除其来宾物理地址(GPA)映射或更改建立的 WHvMapGpaRange后盾内存的内容。

要求

要求 价值
支持的最低Windows Windows 11版本 21H2 (x64):Windows 11版本 24H2 内部版本 26100.3915 (Arm64)
Header WinHvPlatform.h
图书馆 WinHvPlatform.lib
DLL WinHvPlatform.dll
Architecture x64、Arm64

另见