structure NDIS_NIC_SWITCH_VF_INFO_ARRAY (ntddndis.h)

Article
02/07/2025

La structure NDIS_NIC_SWITCH_VF_INFO_ARRAY spécifie un tableau. Chaque élément du tableau spécifie les attributs d’une fonction virtuelle PCI Express (PCIe) activée et allouée sur une carte réseau.

Syntaxe

typedef struct _NDIS_NIC_SWITCH_VF_INFO_ARRAY {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  NDIS_NIC_SWITCH_ID SwitchId;
  ULONG              FirstElementOffset;
  ULONG              NumElements;
  ULONG              ElementSize;
} NDIS_NIC_SWITCH_VF_INFO_ARRAY, *PNDIS_NIC_SWITCH_VF_INFO_ARRAY;

Membres

Header

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

NDIS définit le membre type de d’en-tête sur NDIS_OBJECT_TYPE_DEFAULT. Pour spécifier la version de la structure NDIS_NIC_SWITCH_VF_INFO_ARRAY, NDIS définit le membre Révision de Header sur la valeur suivante :

NDIS_NIC_SWITCH_VF_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_VF_INFO_ARRAY_REVISION_1.

Flags

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

NDIS_NIC_SWITCH_VF_INFO_ARRAY_ENUM_ON_SPECIFIC_SWITCH

Si cet indicateur est défini, le pilote miniport ne doit retourner qu’un tableau de structures NDIS_NIC_SWITCH_VF_INFO pour les machines virtuelles qui ont été allouées sur le commutateur de carte réseau spécifié par le SwitchId membre. Pour plus d’informations, consultez la section Remarques.

Si le membre Flags est défini sur zéro, le pilote miniport doit retourner un tableau de structures NDIS_NIC_SWITCH_VF_INFO pour chaque VF allouée sur chaque commutateur de carte réseau de la carte réseau.

Remarque à partir de Windows Server 2012, l’interface SR-IOV prend uniquement en charge le commutateur de carte réseau par défaut sur la carte réseau. Par conséquent, le pilote miniport ne doit retourner qu’un tableau de structures NDIS_NIC_SWITCH_VF_INFO pour chaque machine virtuelle allouée sur le commutateur de carte réseau par défaut.

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 SR-IOV prend uniquement en charge le commutateur de carte réseau par défaut créé sur la carte réseau. Par conséquent, ce membre doit toujours être défini sur NDIS_DEFAULT_SWITCH_ID.

FirstElementOffset

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

Remarque Si nombre d’éléments 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_VF_INFO_ARRAY.

ElementSize

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

Remarques

NDIS retourne une structure NDIS_NIC_SWITCH_VF_INFO_ARRAY lorsqu’elle gère une requête de méthode OID de OID_NIC_SWITCH_ENUM_VFS. Chaque élément du tableau qui suit la structure NDIS_NIC_SWITCH_VF_INFO_ARRAY est une
structure NDIS_NIC_SWITCH_VF_INFO.