WHvGetVpciDeviceProperty

Sanal PCI (VPCI) cihazının özelliğini alır.

Sözdizimi

typedef enum WHV_VPCI_DEVICE_PROPERTY_CODE
{
    WHvVpciDevicePropertyCodeUndefined   = 0,
    WHvVpciDevicePropertyCodeHardwareIDs = 1,
    WHvVpciDevicePropertyCodeProbedBARs  = 2
} WHV_VPCI_DEVICE_PROPERTY_CODE;

HRESULT
WINAPI
WHvGetVpciDeviceProperty(
    _In_ WHV_PARTITION_HANDLE Partition,
    _In_ UINT64 LogicalDeviceId,
    _In_ WHV_VPCI_DEVICE_PROPERTY_CODE PropertyCode,
    _Out_writes_bytes_to_(PropertyBufferSizeInBytes, *WrittenSizeInBytes) VOID* PropertyBuffer,
    _In_ UINT32 PropertyBufferSizeInBytes,
    _Out_opt_ UINT32* WrittenSizeInBytes
    );

Parameters

Partition

VPCI cihazının sahibi olan bölümün işleyicisi.

LogicalDeviceId

VPCI cihazının mantıksal cihaz tanımlayıcısını belirtir.

PropertyCode

Sorguya alınacak özelliği bir WHV_VPCI_DEVICE_PROPERTY_CODE değer olarak belirtir.

PropertyBuffer

İstenen özelliğin değerini alır. için WHvVpciDevicePropertyCodeHardwareIDsarabellek bir WHV_VPCI_HARDWARE_IDS yapı alır. için WHvVpciDevicePropertyCodeProbedBARsbir WHV_VPCI_PROBED_BARS yapı alır.

PropertyBufferSizeInBytes

Arabelleğin bayt cinsinden PropertyBuffer boyutunu belirtir.

WrittenSizeInBytes

öğesine yazılan PropertyBufferbayt sayısını alır. Bu parametre isteğe bağlıdır ve olabilir NULL.

Dönüş Değeri

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

İstenen özellik için gereken yapıdan küçükse PropertyBufferSizeInBytes , işlevi döndürür WHV_E_INSUFFICIENT_BUFFER. Tanınan bir özellik değilse PropertyCode işlevi döndürür WHV_E_UNKNOWN_PROPERTY.

Açıklamalar

WHvGetVpciDeviceProperty işlevi ile WHvCreateVpciDeviceoluşturulan bir VPCI cihazının özelliğini alır. Cihazın PCI satıcısını, cihazını, düzeltmesini, sınıfını ve alt sistem tanımlayıcılarını almak ve WHvVpciDevicePropertyCodeProbedBARs cihazın tür 0 temel adres yazmaçlarının (BAR) olası değerlerini almak için kullanınWHvVpciDevicePropertyCodeHardwareIDs.

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