WHvGetVpciDeviceNotification

Извлекает следующее ожидающее уведомление для виртуального устройства PCI (VPCI).

Синтаксис

typedef enum WHV_VPCI_DEVICE_NOTIFICATION_TYPE
{
    WHvVpciDeviceNotificationUndefined = 0,
    WHvVpciDeviceNotificationMmioRemapping = 1,
    WHvVpciDeviceNotificationSurpriseRemoval = 2
} WHV_VPCI_DEVICE_NOTIFICATION_TYPE;

typedef struct WHV_VPCI_DEVICE_NOTIFICATION
{
    WHV_VPCI_DEVICE_NOTIFICATION_TYPE NotificationType;
    UINT32 Reserved1;
    union
    {
        UINT64 Reserved2;
    };
} WHV_VPCI_DEVICE_NOTIFICATION;

HRESULT
WINAPI
WHvGetVpciDeviceNotification(
    _In_ WHV_PARTITION_HANDLE Partition,
    _In_ UINT64 LogicalDeviceId,
    _Out_writes_bytes_(NotificationSizeInBytes) WHV_VPCI_DEVICE_NOTIFICATION* Notification,
    _In_ UINT32 NotificationSizeInBytes
    );

Parameters

Partition

Обработайте секцию, которая владеет устройством VPCI.

LogicalDeviceId

Указывает идентификатор логического устройства устройства VPCI.

Notification

Получает тип уведомления и данные в виде WHV_VPCI_DEVICE_NOTIFICATION структуры.

NotificationSizeInBytes

Задает размер буфера Notification в байтах.

Возвращаемое значение

Если функция выполнена успешно, возвращается S_OKзначение.

Remarks

Функция WHvGetVpciDeviceNotification извлекает следующее доступное асинхронное уведомление для устройства VPCI. Вызовите эту функцию после передачи сигнала события WHvCreateVpciDevice уведомления устройства и повторно вызовите функцию до тех пор, пока не будет WHvVpciDeviceNotificationUndefinedполучен тип уведомления, что указывает на отсутствие дополнительных уведомлений.

Уведомление WHvVpciDeviceNotificationMmioRemapping указывает, что диапазоны MMIO устройства переназначены и должны быть повторно приобретены.WHvMapVpciDeviceMmioRanges Уведомление WHvVpciDeviceNotificationSurpriseRemoval указывает, что устройство было удалено неожиданно.

Требования

Requirement Ценность
Минимальный поддерживаемый Windows Windows 10 версии 20H2 (x64); Windows 11 версии 24H2, сборка 26100.3915 (Arm64)
Header WinHvPlatform.h
Библиотека WinHvPlatform.lib
DLL WinHvPlatform.dll
Architecture x64, Arm64

См. также

  • Last updated on