WHvSetVirtualProcessorInterruptControllerState2

设置虚拟处理器的本地 APIC 状态。

Syntax

HRESULT
WINAPI
WHvSetVirtualProcessorInterruptControllerState2(
    _In_ WHV_PARTITION_HANDLE Partition,
    _In_ UINT32 VpIndex,
    _In_reads_bytes_(StateSize) const VOID* State,
    _In_ UINT32 StateSize
    );

参数

Partition

分区对象的句柄。

VpIndex

指定已设置中断控制器状态的虚拟处理器的索引。

State

以标准外部状态格式指定要应用的中断控制器状态。

StateSize

指定大小 State（以字节为单位）。

返回值

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

如果是State，或者如果StateSize小于所需状态大小，则返回值为 E_POINTER。NULL 如果未 VpIndex 标识现有虚拟处理器，则返回值为 WHV_E_VP_DOES_NOT_EXIST。 如果虚拟处理器无法以当前状态访问，则返回值为 WHV_E_INVALID_VP_STATE。

Remarks

该 WHvSetVirtualProcessorInterruptControllerState2 函数从标准外部状态格式的缓冲区中还原指定的虚拟处理器的本地 APIC 状态，通常是以前由 WHvGetVirtualProcessorInterruptControllerState2该缓冲区生成的。 由于任务优先级寄存器（TPR）不是虚拟机监控程序中断控制器状态的一部分，因此当提供的 TPR 不同于当前值时，该函数也会同步虚拟处理器的 CR8 寄存器。

该函数需要为分区配置本地 APIC 的仿真。

要求

另见

• WHvGetVirtualProcessorInterruptControllerState2
• WHvSetVirtualProcessorInterruptControllerState
• WHvSetVirtualProcessorState
• Windows虚拟机监控程序平台 API 定义