structure NDIS_NIC_SWITCH_VPORT_INFO_ARRAY (ntddndis.h)

Article
03/01/2024

La structure NDIS_NIC_SWITCH_VPORT_INFO_ARRAY spécifie un tableau. Chaque élément du tableau spécifie les attributs d’un port virtuel (VPort) qui a été créé sur le commutateur de carte réseau d’une carte réseau.

Syntaxe

typedef struct _NDIS_NIC_SWITCH_VPORT_INFO_ARRAY {
  NDIS_OBJECT_HEADER     Header;
  ULONG                  Flags;
  NDIS_NIC_SWITCH_ID     SwitchId;
  NDIS_SRIOV_FUNCTION_ID AttachedFunctionId;
  ULONG                  FirstElementOffset;
  ULONG                  NumElements;
  ULONG                  ElementSize;
} NDIS_NIC_SWITCH_VPORT_INFO_ARRAY, *PNDIS_NIC_SWITCH_VPORT_INFO_ARRAY;

Membres

Header

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

NDIS définit le membre Type de l’en-tête sur NDIS_OBJECT_TYPE_DEFAULT. Pour spécifier la version de la structure NDIS_NIC_SWITCH_VPORT_INFO_ARRAY , NDIS définit le membre Revision de Header sur la valeur suivante :

NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_REVISION_1

Version d’origine pour NDIS 6.30 et versions ultérieures.

Définissez le membre Size sur NDIS_SIZEOF_NIC_SWITCH_VPORT_INFO_ARRAY_REVISION_1.

Flags

Valeur ULONG qui contient un OR au niveau du bit des indicateurs suivants :

NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_ENUM_ON_SPECIFIC_FUNCTION

Cet indicateur spécifie d’énumérer les VPorts attachés à une fonction PCI Express (PCIe) spécifique. La fonction est spécifiée dans le membre AttachedFunctionId . Cet indicateur peut être utilisé pour énumérer les VPorts attachés à la fonction physique PCIe (PF) ou à une fonction virtuelle PCIe (VF) spécifiée.

NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_ENUM_ON_SPECIFIC_SWITCH

Cet indicateur spécifie d’énumérer les VPorts créés sur un commutateur spécifique, spécifiés par le SwitchId. Cette opération énumère tous les VPorts créés sur le commutateur.

Note Ces indicateurs s’excluent mutuellement. Un seul indicateur peut être défini dans le membre Indicateurs .

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.

Le membre SwitchId n’est valide que si NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_ENUM_ON_SPECIFIC_SWITCH est spécifié dans le membre Flags .

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.

AttachedFunctionId

Valeur NDIS_SRIOV_FUNCTION_ID qui spécifie l’identificateur du PF ou d’une VF sur la carte réseau.

Note Si cette valeur est NDIS_PF_FUNCTION_ID, le VPort est attaché au PF.

Le membre AttachedFunctionId n’est valide que si NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_ENUM_ON_SPECIFIC_FUNCTION est spécifié dans le membre Flags .

FirstElementOffset

Valeur ULONG qui spécifie le décalage, en octets, sur le premier élément d’un tableau d’éléments qui suivent cette structure. Le décalage est mesuré du début de la structure NDIS_NIC_SWITCH_VPORT_INFO_ARRAY jusqu’au début du premier élément. Chaque élément du tableau est une structure NDIS_NIC_SWITCH_VPORT_INFO .

Note Si NumElements est défini sur zéro, ce membre est ignoré.

NumElements

Valeur ULONG qui spécifie le nombre d’éléments qui suivent la structure NDIS_NIC_SWITCH_VPORT_INFO_ARRAY .

ElementSize

Valeur ULONG qui spécifie la taille, en octets, de chaque élément qui suit la structure NDIS_NIC_SWITCH_VPORT_INFO_ARRAY .

Remarques

NDIS retourne une structure de NDIS_NIC_SWITCH_VPORT_INFO_ARRAY lorsque NDIS gère une demande de méthode OID de OID_NIC_SWITCH_ENUM_VPORTS. Chaque élément du tableau qui suit la structure NDIS_NIC_SWITCH_VPORT_INFO_ARRAY est un
NDIS_NIC_SWITCH_VPORT_INFO structure.

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