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

Статья
02/07/2025

Структура интерфейса 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, которая записывает блок данных конфигурации для VF PCIe.

ReadVfConfigBlock

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

SerialNumber

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

Замечания

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

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