структура VPCI_INTERFACE_STANDARD (vpci.h)

Статья
03/05/2024

Структура интерфейса VPCI_INTERFACE_STANDARD позволяет драйверам устройств получать доступ к блокам данных конфигурации, которые относятся к виртуальной функции PCI Express (PCIe) устройств, поддерживающих интерфейс SR-IOV.

Эта структура описывает интерфейс GUID_VPCI_INTERFACE_STANDARD .

Примечание

Расположение блока конфигурации VF и формат данных конфигурации определяются независимым поставщиком оборудования (IHV) устройства. Они используются только драйверами физической функции PCIe (PF) и VF.

Синтаксис

typedef struct _VPCI_INTERFACE_STANDARD {
  USHORT                 Size;
  USHORT                 Version;
  PVOID                  Context;
  PINTERFACE_REFERENCE   InterfaceReference;
  PINTERFACE_DEREFERENCE InterfaceDereference;
  PVPCI_WRITE_BLOCK      WriteVfConfigBlock;
  PVPCI_READ_BLOCK       ReadVfConfigBlock;
  UINT32                 SerialNumber;
} VPCI_INTERFACE_STANDARD, *PVPCI_INTERFACE_STANDARD;

Члены

Size

Размер данной структуры (в байтах).

Version

Версия интерфейса, определяемого драйвером.

Context

Указатель на сведения о контексте для конкретного интерфейса.

InterfaceReference

Указатель на подпрограмму InterfaceReference , которая увеличивает количество ссылок интерфейса.

InterfaceDereference

Указатель на подпрограмму InterfaceDereference , которая уменьшает количество ссылок интерфейса.

WriteVfConfigBlock

Указатель на подпрограмму WriteVfConfigBlock , которая записывает блок данных конфигурации для PCIe VF.

ReadVfConfigBlock

Указатель на подпрограмму ReadVfConfigBlock , которая считывает блок данных конфигурации для PCIe VF.

SerialNumber

Значение UINT32, содержащее серийный номер pcIe VF на устройстве. Стек виртуализации создает уникальный серийный номер для каждой виртуальной машины, которая предоставляется на устройстве.

Интерфейс GUID_VPCI_INTERFACE_STANDARD предоставляется драйвером виртуальной шины PCI (VPCI), который создает объекты физических устройств (PDO), которые расположены под загруженными драйверами для виртуальных машин. Эти драйверы загружаются в гостевую операционную систему, которая выполняется в дочернем разделе Hyper-V.

Драйвер получает указатель на структуру VPCI_INTERFACE_STANDARD , отправляя IRP_MN_QUERY_INTERFACE IRP драйверу шины с параметром InterfaceType , для GUID_VPCI_INTERFACE_STANDARD.