structure VPCI_INTERFACE_STANDARD (vpci.h)
La structure d’interface VPCI_INTERFACE_STANDARD permet aux pilotes de périphérique d’accéder aux blocs de données de configuration spécifiques à une fonction virtuelle PCI Express (PCIe) d’appareils qui prennent en charge l’interface d’E/S racine unique (SR-IOV).
Cette structure décrit l’interface GUID_VPCI_INTERFACE_STANDARD.
Note
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 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 InterfaceReference routine qui incrémente le nombre de références de l’interface.
InterfaceDereference
Pointeur vers une InterfaceDereference routine qui décrémente le nombre de références de l’interface.
WriteVfConfigBlock
Pointeur vers un WriteVfConfigBlock routine qui écrit un bloc de données de configuration pour un VF PCIe.
ReadVfConfigBlock
Pointeur vers un ReadVfConfigBlock routine qui lit un bloc de données de configuration pour une machine virtuelle PCIe.
SerialNumber
Valeur UINT32 qui contient le numéro de série du pcIe VF sur l’appareil. La pile de virtualisation génère un numéro de série unique pour chaque machine virtuelle 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 d’appareil physique (PDO) 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.
Exigences
| Exigence | Valeur |
|---|---|
| serveur minimum pris en charge | Windows Server 2012 |
| d’en-tête | vpci.h |