WHvSetVirtualProcessorState

가상 프로세서에서 저장된 상태의 범주를 설정합니다.

문법

// WHvGetVirtualProcessorState and WHvSetVirtualProcessorState types.
#if defined(_AMD64_)

typedef enum WHV_VIRTUAL_PROCESSOR_STATE_TYPE
{
    WHvVirtualProcessorStateTypeSynicMessagePage          = 0x00000000,
    WHvVirtualProcessorStateTypeSynicEventFlagPage        = 0x00000001,
    WHvVirtualProcessorStateTypeSynicTimerState           = 0x00000002,

    WHvVirtualProcessorStateTypeInterruptControllerState2 = 0x00001000,
    WHvVirtualProcessorStateTypeXsaveState                = 0x00001001,
    WHvVirtualProcessorStateTypeNestedState               = 0x00001002,
} WHV_VIRTUAL_PROCESSOR_STATE_TYPE;

#elif defined (_ARM64_)

#define WHV_VIRTUAL_PROCESSOR_STATE_TYPE_PFN    (1ui32 << 31)
#define WHV_VIRTUAL_PROCESSOR_STATE_TYPE_ANY_VP (1ui32 << 30)

typedef enum WHV_VIRTUAL_PROCESSOR_STATE_TYPE
{
    WHvVirtualProcessorStateTypeInterruptControllerState  = 0x00000000 | WHV_VIRTUAL_PROCESSOR_STATE_TYPE_PFN,

    WHvVirtualProcessorStateTypeSynicMessagePage          = 0x00000002 | WHV_VIRTUAL_PROCESSOR_STATE_TYPE_PFN,
    WHvVirtualProcessorStateTypeSynicEventFlagPage        = 0x00000003 | WHV_VIRTUAL_PROCESSOR_STATE_TYPE_PFN,
    WHvVirtualProcessorStateTypeSynicTimerState           = 0x00000004,

    WHvVirtualProcessorStateTypeGlobalInterruptState      = 0x00000006 | WHV_VIRTUAL_PROCESSOR_STATE_TYPE_PFN | WHV_VIRTUAL_PROCESSOR_STATE_TYPE_ANY_VP,
    WHvVirtualProcessorStateTypeSveState                  = 0x00000007 | WHV_VIRTUAL_PROCESSOR_STATE_TYPE_PFN,
} WHV_VIRTUAL_PROCESSOR_STATE_TYPE;

#endif

HRESULT
WINAPI
WHvSetVirtualProcessorState(
    _In_ WHV_PARTITION_HANDLE Partition,
    _In_ UINT32 VpIndex,
    _In_ WHV_VIRTUAL_PROCESSOR_STATE_TYPE StateType,
    _In_reads_bytes_(BufferSizeInBytes) const VOID* Buffer,
    _In_ UINT32 BufferSizeInBytes
    );

Parameters

Partition

파티션 개체에 대한 핸들입니다.

VpIndex

상태가 설정된 가상 프로세서의 인덱스를 지정합니다.

StateType

설정할 상태의 범주를 지정합니다. 각 값의 의미는 참조 WHvGetVirtualProcessorState 하세요.

Buffer

적용할 상태를 지정합니다. 버퍼의 형식은 .에 StateType따라 달라집니다.

BufferSizeInBytes

크기 Buffer(바이트)를 지정합니다. 크기는 로 식별되는 StateType상태의 크기와 일치해야 합니다.

반환 값

함수가 성공하면 반환 값은 .입니다 S_OK.

함수는 유효한 상태 형식이 아니면 반환 E_INVALIDARGStateType 합니다.

Remarks

함수는 WHvSetVirtualProcessorState 로 식별되는 가상 프로세서 상태의 범주를 StateType적용합니다. 의 대응 WHvGetVirtualProcessorState입니다.

get 작업과 달리 집합 작업에 제공된 버퍼는 복원되는 상태의 크기여야 합니다.

Requirements

참고하십시오

• WHvGetVirtualProcessorState
• WHvSetVirtualProcessorXsaveState
• WHvSetVirtualProcessorInterruptControllerState
• 가상 프로세서 레지스터 이름 및 값
• Windows 하이퍼바이저 플랫폼 API 정의