structure NDIS_NIC_SWITCH_VF_INFO (ntddndis.h)

Article
02/07/2025

La structure NDIS_NIC_SWITCH_VF_INFO spécifie les informations relatives à une fonction virtuelle PCI Express (PCIe) 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 de l'd’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 Revision de Header sur la valeur suivante :

NDIS_NIC_SWITCH_VF_INFO_REVISION_1

Version d’origine de NDIS 6.30.

Définissez le membre Size sur NDIS_SIZEOF_NIC_SWITCH_VF_INFO_REVISION_1.

Flags

Valeur ULONG qui contient une OR au niveau du bit des 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.

Remarque à partir de Windows Server 2012, l’interface 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 au VF. Ce membre contient la description conviviale de la partition.

Remarque 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 au 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 de données VF basé sur le matériel via l’interface SR-IOV.

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

MacAddressLength

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

PermanentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH]

Adresse MAC permanente du 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 du VF. Il s’agit de l’adresse MAC actuelle de 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 machine virtuelle sur la carte réseau.

RequestorId

Un NDIS_VF_RID qui spécifie l’ID de demandeur PCI Express (PCIe) du VF.

Remarques

Une structure NDIS_NIC_SWITCH_VF_INFO contient des informations sur une machine virtuelle créée précédemment par le biais d’une requête de méthode OID de OID_NIC_SWITCH_ALLOCATE_VF. Lorsque cette requête OID est émise, une ou plusieurs structures NDIS_NIC_SWITCH_VF_INFO sont retournées dans une structure 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).