WHvCreateVirtualProcessor2

선택적 생성 시간 속성을 사용하여 파티션에 새 가상 프로세서를 만듭니다.

문법

typedef enum WHV_VIRTUAL_PROCESSOR_PROPERTY_CODE
{
    WHvVirtualProcessorPropertyCodeNumaNode = 0x00000000,
} WHV_VIRTUAL_PROCESSOR_PROPERTY_CODE;

typedef struct WHV_VIRTUAL_PROCESSOR_PROPERTY
{
    WHV_VIRTUAL_PROCESSOR_PROPERTY_CODE PropertyCode;
    UINT32 Reserved;
    union
    {
        USHORT NumaNode;
        UINT64 Padding;
    };
} WHV_VIRTUAL_PROCESSOR_PROPERTY;

HRESULT
WINAPI
WHvCreateVirtualProcessor2(
    _In_ WHV_PARTITION_HANDLE Partition,
    _In_ UINT32 VpIndex,
    _In_reads_(PropertyCount) const WHV_VIRTUAL_PROCESSOR_PROPERTY* Properties,
    _In_ UINT32 PropertyCount
    );

Parameters

Partition

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

VpIndex

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

Properties

생성 시 새 가상 프로세서에 적용할 속성 배열을 지정합니다. 0일 수 NULLPropertyCount 있습니다.

PropertyCount

배열의 요소 Properties 수를 지정합니다. 0이면 가상 프로세서가 기본 속성을 사용하여 만들어집니다.

속성

배열의 Properties 각 요소는 해당 멤버가 WHV_VIRTUAL_PROCESSOR_PROPERTYPropertyCode 적용할 속성을 선택하고 값 멤버가 설정을 제공하는 요소입니다. 동일한 속성 코드가 두 번 이상 표시되면 제공된 마지막 값이 적용됩니다. 다음 속성 코드가 정의됩니다.

WHvVirtualProcessorPropertyCodeNumaNode

멤버에서 가상 프로세서를 백업하는 NUMA 노드를 NumaNode 지정합니다. 이 속성을 제공하지 않으면 가상 프로세서가 호출 스레드의 이상적인 NUMA 노드에 배치됩니다.

반환 값

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

가상 프로세서가 이미 있는 VpIndex경우 반환 값은 .입니다 WHV_E_VP_ALREADY_EXISTS. 파티션의 프로세서 수보다 크거나 같은 경우 VpIndex , 속성이 알 수 없는 속성 코드를 지정하거나 값이 유효한 NUMA 노드가 아닌 경우 NumaNode 반환 값은 다음과 같습니다 E_INVALIDARG.

Remarks

이 함수는 WHvCreateVirtualProcessor2 파티션에 새 가상 프로세서를 만듭니다. x64에서 가상 프로세서의 인덱스는 프로세서의 APIC ID를 설정하는 데 사용됩니다. WHvCreateVirtualProcessor(Partition, VpIndex, 0) 호출은 WHvCreateVirtualProcessor2(Partition, VpIndex, NULL, 0) 호출과 동일합니다.

Requirements

참고하십시오

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