仮想プロセッサのローカル APIC 状態を設定します。
Important
WHvSetVirtualProcessorInterruptControllerState2 は非推奨とされます。 代わりに、WHvVirtualProcessorStateTypeInterruptControllerState2状態の種類でWHvSetVirtualProcessorStateを使用します。
Note
この関数は x64 パーティションにのみ適用されます。
構文
HRESULT
WINAPI
WHvSetVirtualProcessorInterruptControllerState2(
_In_ WHV_PARTITION_HANDLE Partition,
_In_ UINT32 VpIndex,
_In_reads_bytes_(StateSize) const VOID* State,
_In_ UINT32 StateSize
);
Parameters
Partition
パーティション オブジェクトへのハンドル。
VpIndex
割り込みコントローラーの状態が設定されている仮想プロセッサのインデックスを指定します。
State
適用する割り込みコントローラーの状態を標準の外部状態形式で指定します。
StateSize
Stateのサイズをバイト単位で指定します。
戻り値
関数が成功した場合、戻り値は S_OK。
StateがNULLの場合、またはStateSizeが必要な状態サイズより小さい場合、戻り値はE_POINTER。
VpIndexが既存の仮想プロセッサを識別しない場合、戻り値はWHV_E_VP_DOES_NOT_EXIST。 仮想プロセッサに現在の状態でアクセスできない場合、戻り値は WHV_E_INVALID_VP_STATE。
Remarks
WHvSetVirtualProcessorInterruptControllerState2関数は、指定された仮想プロセッサのローカル APIC 状態を、通常は WHvGetVirtualProcessorInterruptControllerState2 によって生成された標準の外部状態形式のバッファーから復元します。 タスク優先度レジスタ (TPR) はハイパーバイザーの割り込みコントローラーの状態の一部ではないため、指定された TPR が現在の値と異なる場合、この関数は仮想プロセッサの CR8 レジスタも同期します。
この関数では、パーティションに対してローカル APIC のエミュレーションを構成する必要があります。
Requirements
| 要件 | 価値 |
|---|---|
| サポートされている最小Windows | Windows 10 バージョン 2004 |
| Header | WinHvPlatform.h |
| 図書館 | WinHvPlatform.lib |
| DLL | WinHvPlatform.dll |
| Architecture | x64 |