WHvCreateVirtualProcessor2

İsteğe bağlı oluşturma zamanı özelliklerine sahip bir bölümde yeni bir sanal işlemci oluşturur.

Sözdizimi

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

Bölüm nesnesi için tanıtıcı.

VpIndex

Yeni sanal işlemcinin dizinini belirtir.

Properties

Oluşturma zamanında yeni sanal işlemciye uygulanacak bir özellik dizisi belirtir. Sıfır olduğunda PropertyCount olabilirNULL.

PropertyCount

Dizideki Properties öğelerin sayısını belirtir. Sıfır olduğunda, sanal işlemci varsayılan özelliklerle oluşturulur.

Properties

Dizinin her öğesi, üyesi uygulanacak özelliği seçen PropertyCode ve değer üyesi ayarı sağlayan bir WHV_VIRTUAL_PROCESSOR_PROPERTY öğedirProperties. Aynı özellik kodu birden çok kez görünüyorsa, sağlanan son değer geçerlilik kazanır. Aşağıdaki özellik kodları tanımlanır.

WHvVirtualProcessorPropertyCodeNumaNode

Üyede sanal işlemciyi destekleyen NUMA düğümünü NumaNode belirtir. Bu özellik sağlanmadığında, sanal işlemci çağıran iş parçacığının ideal NUMA düğümüne yerleştirilir.

Dönüş Değeri

İşlev başarılı olursa, dönüş değeri olur S_OK.

konumunda zaten bir sanal işlemci varsa VpIndex, dönüş değeri olur WHV_E_VP_ALREADY_EXISTS. VpIndex Bölümün işlemci sayısına eşit veya ondan büyükse, bir özellik bilinmeyen bir özellik kodu belirtiyorsa veya değer geçerli bir NUMA düğümü değilseNumaNode, dönüş değeri olurE_INVALIDARG.

Açıklamalar

İşlev, WHvCreateVirtualProcessor2 bir bölümde yeni bir sanal işlemci oluşturur. x64'te, işlemcinin APIC kimliğini ayarlamak için sanal işlemcinin dizini kullanılır. Çağrı WHvCreateVirtualProcessor(Partition, VpIndex, 0), WHvCreateVirtualProcessor2(Partition, VpIndex, NULL, 0) çağrısıyla eşdeğerdir.

Requirements

Requirement Değer
Desteklenen en düşük Windows Windows 10, sürüm 20H2 (x64); Windows 11, sürüm 24H2, derleme 26100.3915 (Arm64)
Header WinHvPlatform.h
Kütüphane WinHvPlatform.lib
DLL WinHvPlatform.dll
Architecture x64, Arm64

Ayrıca bakınız

  • Last updated on