structure NDIS_NIC_SWITCH_VF_INFO (ntddndis.h)

Article
03/01/2024

La structure NDIS_NIC_SWITCH_VF_INFO spécifie les informations relatives à une fonction virtuelle (VF) PCI Express (PCIe) qui a été allouée sur la carte réseau.

Syntaxe

typedef struct _NDIS_NIC_SWITCH_VF_INFO {
  NDIS_OBJECT_HEADER     Header;
  ULONG                  Flags;
  NDIS_NIC_SWITCH_ID     SwitchId;
  NDIS_VM_NAME           VMName;
  NDIS_VM_FRIENDLYNAME   VMFriendlyName;
  NDIS_SWITCH_NIC_NAME   NicName;
  USHORT                 MacAddressLength;
  UCHAR                  PermanentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH];
  UCHAR                  CurrentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH];
  NDIS_SRIOV_FUNCTION_ID VFId;
  NDIS_VF_RID            RequestorId;
} NDIS_NIC_SWITCH_VF_INFO, *PNDIS_NIC_SWITCH_VF_INFO;

Membres

Header

Type, révision et taille de la structure NDIS_NIC_SWITCH_VF_INFO . Ce membre est mis en forme en tant que structure NDIS_OBJECT_HEADER .

Le pilote miniport doit définir le membre Type de l’en-tête sur NDIS_OBJECT_TYPE_DEFAULT. Pour spécifier la version de la structure NDIS_NIC_SWITCH_VF_INFO , le pilote doit définir le membre Révision de l’en-tête sur la valeur suivante :

NDIS_NIC_SWITCH_VF_INFO_REVISION_1

Version d’origine pour NDIS 6.30.

Définissez le membre Size sur NDIS_SIZEOF_NIC_SWITCH_VF_INFO_REVISION_1.

Flags

Valeur ULONG qui contient un OR au niveau du bit d’indicateurs. Ce membre est réservé à NDIS.

SwitchId

Valeur NDIS_NIC_SWITCH_ID qui spécifie un identificateur de commutateur. L’identificateur de commutateur est un entier compris entre zéro et le nombre de commutateurs pris en charge par la carte réseau. Une valeur NDIS_DEFAULT_SWITCH_ID indique le commutateur de carte réseau par défaut.

Note À compter de Windows Server 2012, l’interface de virtualisation d’E/S racine unique (SR-IOV) prend uniquement en charge le commutateur de carte réseau par défaut sur la carte réseau. La valeur de ce membre doit être définie sur NDIS_DEFAULT_SWITCH_ID.

VMName

Valeur NDIS_VM_NAME qui spécifie le nom de la partition enfant Hyper-V attachée à la VF. Ce membre contient la description conviviale de la partition.

Note La partition enfant Hyper-V est également appelée machine virtuelle.

VMFriendlyName

Valeur NDIS_VM_FRIENDLYNAME qui spécifie le nom externe de la partition enfant Hyper-V attachée à la VF. Ce membre contient la description conviviale de la partition.

NicName

Valeur NDIS_SWITCH_NIC_NAME qui spécifie le nom de la carte réseau de la machine virtuelle. Ce membre contient la description conviviale de la carte réseau.

La carte réseau de machine virtuelle est un appareil virtuel exposé dans le système d’exploitation invité qui s’exécute dans une partition enfant Hyper-V. La carte réseau de machine virtuelle s’associe à la carte réseau VF pour fournir le chemin des données VF basée sur le matériel via l’interface SR-IOV.

Pour plus d’informations sur le chemin des données VF, consultez Chemin des données VF SR-IOV.

MacAddressLength

Valeur USHORT qui spécifie la longueur des membres PermanentMacAddress et CurrentMacAddress .

PermanentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH]

Adresse MAC permanente de la VF. Il s’agit de l’adresse MAC permanente de la carte réseau VF exposée dans le système d’exploitation invité.

CurrentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH]

Adresse MAC actuelle de la VF. Il s’agit de l’adresse MAC actuelle pour la carte réseau VF exposée dans le système d’exploitation invité.

VFId

Valeur NDIS_SRIOV_FUNCTION_ID qui spécifie l’identificateur unique de la VF sur la carte réseau.

RequestorId

Une NDIS_VF_RID qui spécifie l’ID de demandeur (RID) PCI Express (PCIe) de la VF.

Remarques

Une structure de NDIS_NIC_SWITCH_VF_INFO contient des informations sur une VF qui a été créée précédemment via une demande de méthode OID de OID_NIC_SWITCH_ALLOCATE_VF. Lorsque cette demande OID est émise, une ou plusieurs structures NDIS_NIC_SWITCH_VF_INFO sont retournées dans une structure de NDIS_NIC_SWITCH_VF_INFO_ARRAY .

Pour plus d’informations sur l’interface SR-IOV, consultez Vue d’ensemble de la virtualisation d’E/S racine unique (SR-IOV).