VPCI_INTERFACE_STANDARD structure (vpci.h)

Article
03/01/2024

La structure d’interface VPCI_INTERFACE_STANDARD permet aux pilotes de périphérique d’accéder à des blocs de données de configuration spécifiques à une fonction virtuelle PCI Express (PCIe) d’appareils qui prennent en charge l’interface de virtualisation d’E/S racine unique (SR-IOV).

Cette structure décrit l’interface GUID_VPCI_INTERFACE_STANDARD .

Notes

L’emplacement du bloc de configuration VF et le format des données de configuration sont définis par le fournisseur de matériel indépendant (IHV) de l’appareil. Ils sont utilisés uniquement par les pilotes de la fonction physique PCIe (PF) et de la VF.

Syntaxe

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;

Membres

Size

Taille, en octets, de cette structure.

Version

Version de l’interface définie par le pilote.

Context

Pointeur vers des informations de contexte spécifiques à l’interface.

InterfaceReference

Pointeur vers une routine InterfaceReference qui incrémente le nombre de références de l’interface.

InterfaceDereference

Pointeur vers une routine InterfaceDereference qui décrémente le nombre de références de l’interface.

WriteVfConfigBlock

Pointeur vers une routine WriteVfConfigBlock qui écrit un bloc de données de configuration pour une VF PCIe.

ReadVfConfigBlock

Pointeur vers une routine ReadVfConfigBlock qui lit un bloc de données de configuration pour un VF PCIe.

SerialNumber

Valeur UINT32 qui contient le numéro de série de la VF PCIe sur l’appareil. La pile de virtualisation génère un numéro de série unique pour chaque VF exposée sur l’appareil.

Remarques

L’interface GUID_VPCI_INTERFACE_STANDARD est fournie par le pilote de bus PCI virtuel (VPCI) qui crée les objets de périphérique physique (PPO) qui sont superposés sous les pilotes chargés pour les machines virtuelles. Ces pilotes sont chargés dans le système d’exploitation invité qui s’exécute dans une partition enfant Hyper-V.

Un pilote obtient un pointeur vers la structure VPCI_INTERFACE_STANDARD en envoyant un IRP IRP_MN_QUERY_INTERFACE à son pilote de bus avec InterfaceType défini sur GUID_VPCI_INTERFACE_STANDARD.