가상 프로세서의 로컬 APIC 상태를 검색합니다.
Important
WHvGetVirtualProcessorInterruptControllerState2 더 이상 사용되지 않습니다. 대신 상태 형식과 WHvVirtualProcessorStateTypeInterruptControllerState2 함께 사용합니다WHvGetVirtualProcessorState.
메모
이 함수는 x64 파티션에만 적용됩니다.
문법
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
);
Parameters
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의 에뮬레이션을 구성해야 합니다.
Requirements
| 요구 사항 | Value |
|---|---|
| 지원되는 최소 Windows | Windows 10, 버전 2004 |
| Header | WinHvPlatform.h |
| 라이브러리 | WinHvPlatform.lib |
| 동적 링크 라이브러리 (DLL) | WinHvPlatform.dll |
| 아키텍처 | X64 |