structure NDIS_NIC_SWITCH_INFO (ntddndis.h)

Article
08/07/2023

La structure NDIS_NIC_SWITCH_INFO spécifie les informations relatives à un commutateur de carte réseau sur une carte réseau.

Syntaxe

typedef struct _NDIS_NIC_SWITCH_INFO {
  NDIS_OBJECT_HEADER           Header;
  ULONG                        Flags;
  NDIS_NIC_SWITCH_TYPE         SwitchType;
  NDIS_NIC_SWITCH_ID           SwitchId;
  NDIS_NIC_SWITCH_FRIENDLYNAME SwitchFriendlyName;
  ULONG                        NumVFs;
  ULONG                        NumAllocatedVFs;
  ULONG                        NumVPorts;
  ULONG                        NumActiveVPorts;
  ULONG                        NumQueuePairsForDefaultVPort;
  ULONG                        NumQueuePairsForNonDefaultVPorts;
  ULONG                        NumActiveDefaultVPortMacAddresses;
  ULONG                        NumActiveNonDefaultVPortMacAddresses;
  ULONG                        NumActiveDefaultVPortVlanIds;
  ULONG                        NumActiveNonDefaultVPortVlanIds;
} NDIS_NIC_SWITCH_INFO, *PNDIS_NIC_SWITCH_INFO;

Membres

Header

Type, révision et taille de la structure NDIS_NIC_SWITCH_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_INFO , le pilote doit définir le membre Révision de l’en-tête sur la valeur suivante :

NDIS_NIC_SWITCH_INFO_REVISION_1

Version d’origine pour NDIS 6.30.

Définissez le membre Size sur NDIS_SIZEOF_NIC_SWITCH_INFO_REVISION_1.

Flags

Valeur ULONG qui contient un OR au niveau du bit des indicateurs de configuration activés sur le commutateur.

Note Pour NDIS 6.30, aucun indicateur de configuration n’est défini pour le commutateur. Le membre Flags doit être défini sur zéro.

SwitchType

Valeur NDIS_NIC_SWITCH_TYPE qui spécifie le type du commutateur.

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.

SwitchFriendlyName

Valeur NDIS_NIC_SWITCH_FRIENDLYNAME qui contient la description conviviale du commutateur.

NumVFs

Valeur ULONG qui spécifie le nombre de fonctions virtuelles (VF) PCI Express (PCIe) activées sur la carte réseau. Les machines virtuelles activées peuvent être dans un état alloué ou non alloué.

NumAllocatedVFs

Valeur ULONG qui spécifie le nombre de machines virtuelles qui ont été allouées sur le commutateur de carte réseau spécifié par SwitchId. Les machines virtuelles sont allouées par le biais de requêtes d’ensemble OID de OID_NIC_SWITCH_ALLOCATE_VF.

NumVPorts

Valeur ULONG qui spécifie le nombre de ports virtuels (VPorts) configurés sur le commutateur de carte réseau spécifié par SwitchId.

Cette valeur ULONG est la somme des éléments suivants :

Nombre maximal de VPorts pouvant être créés via des demandes de jeu OID de OID_NIC_SWITCH_CREATE_VPORT.
VPort par défaut attaché à la fonction physique (PF).

NumActiveVPorts

Valeur ULONG qui spécifie le nombre de VPorts qui ont été créés sur le commutateur de carte réseau spécifié par SwitchId.

Note Cette valeur ULONG inclut le VPort par défaut, en plus des VPorts non par défaut créés par le biais des requêtes de jeu OID de OID_NIC_SWITCH_CREATE_VPORT.

NumQueuePairsForDefaultVPort

Valeur ULONG qui spécifie le nombre de paires de files d’attente allouées pour le VPort par défaut. Le VPort par défaut est toujours attaché au pf.

Une paire de files d’attente se compose d’une file d’attente de transmission et d’une file d’attente de réception. Le pilote miniport associe une ou plusieurs paires de file d’attente au VPort par défaut au moment de la création du commutateur via une demande de méthode OID de OID_NIC_SWITCH_CREATE_SWITCH.

Note À compter de NDIS 6.30, il ne peut y avoir qu’une seule paire de file d’attente qui peut être configurée pour le VPort par défaut.

NumQueuePairsForNonDefaultVPorts

Valeur ULONG qui spécifie le nombre de paires de files d’attente allouées pour les VPorts non par défaut. Un VPort non par défaut peut être attaché au PF ou à n’importe quelle VF de la carte réseau.

Le pilote miniport associe une ou plusieurs paires de files d’attente à un VPort non par défaut via une demande de méthode OID de OID_NIC_SWITCH_CREATE_VPORT.

NumActiveDefaultVPortMacAddresses

Valeur ULONG qui spécifie le nombre de filtres d’adresse MAC unicast actuellement définis sur le VPort par défaut attaché au PF de la carte réseau.

NumActiveNonDefaultVPortMacAddresses

Valeur ULONG qui spécifie le nombre de filtres d’adresses MAC unicast actuellement définis sur des VPorts non par défaut.

NumActiveDefaultVPortVlanIds

Valeur ULONG qui spécifie le nombre de filtres d’identificateur de réseau local virtuel (VLAN) actuellement définis sur le VPort par défaut.

NumActiveNonDefaultVPortVlanIds

Valeur ULONG qui spécifie le nombre de filtres d’identificateur VLAN actuellement définis sur les VPorts non par défaut.

Remarques

La structure NDIS_NIC_SWITCH_INFO est utilisée dans les requêtes OID de OID_NIC_SWITCH_ENUM_SWITCHES. Cette demande OID est utilisée pour énumérer les commutateurs de carte réseau sur une carte réseau. Lorsque cette demande OID est émise, une ou plusieurs structures NDIS_NIC_SWITCH_INFO sont retournées dans une structure de NDIS_NIC_SWITCH_INFO_ARRAY .

Note À compter de NDIS 6.30, seule la NDIS_NIC_SWITCH_INFO qui décrit les informations sur le commutateur de carte réseau par défaut est retournée via une requête OID de OID_NIC_SWITCH_ENUM_SWITCHES.

Une structure de NDIS_NIC_SWITCH_INFO contient des informations sur un commutateur de carte réseau précédemment créé via une demande de méthode OID de OID_NIC_SWITCH_CREATE_SWITCH.

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