检索虚拟处理器的本地 APIC 状态。
Important
WHvGetVirtualProcessorInterruptControllerState2 已弃用。 请 WHvGetVirtualProcessorState 改用状态 WHvVirtualProcessorStateTypeInterruptControllerState2 类型。
注释
此函数仅适用于 x64 分区。
Syntax
HRESULT
WINAPI
WHvGetVirtualProcessorInterruptControllerState2(
_In_ WHV_PARTITION_HANDLE Partition,
_In_ UINT32 VpIndex,
_Out_writes_bytes_to_(StateSize, *WrittenSize) VOID* State,
_In_ UINT32 StateSize,
_Out_opt_ UINT32* WrittenSize
);
参数
Partition
分区对象的句柄。
VpIndex
指定检索中断控制器状态的虚拟处理器的索引。
State
接收中断控制器状态。
StateSize
指定大小 State（以字节为单位）。
WrittenSize
如果为非 NULL，则接收写入到 State的字节数。 缓冲区太小时，它会收到所需的字节数。
返回值
如果函数成功，则返回值为 S_OK.
如果 State 太小而无法包含中断控制器状态，则返回值为 WHV_E_INSUFFICIENT_BUFFER，并 WrittenSize 接收所需的字节数。 如果未 VpIndex 标识现有虚拟处理器，则返回值为 WHV_E_VP_DOES_NOT_EXIST。 如果虚拟处理器无法以当前状态访问，则返回值为 WHV_E_INVALID_VP_STATE。
Remarks
该 WHvGetVirtualProcessorInterruptControllerState2 函数以标准外部状态格式检索指定虚拟处理器的本地 APIC 状态。 它取代了已弃用 WHvGetVirtualProcessorInterruptControllerState的格式，该格式返回一种旧格式，该格式打包中断请求、服务内和触发器模式向量与标准外部状态格式不同，不包括处理器优先级寄存器。
该函数需要为分区配置本地 APIC 的仿真。
要求
| 要求 | 价值 |
|---|---|
| 支持的最低Windows | Windows 10 版本 2004 |
| Header | WinHvPlatform.h |
| 图书馆 | WinHvPlatform.lib |
| DLL | WinHvPlatform.dll |
| Architecture | x64 |