structure NDIS_NIC_SWITCH_VF_INFO_ARRAY (ntddndis.h)

Article
08/07/2023

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) qui a été 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 l’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 Revision 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 un 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 doit uniquement retourner 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 membre SwitchId . Pour plus d'informations, consultez la section Notes.

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 qui a été alloué sur chaque commutateur de carte réseau de la carte réseau.

Note À compter 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 doit uniquement retourner un tableau de structures NDIS_NIC_SWITCH_VF_INFO pour chaque VF qui a été 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.

Note À compter 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, 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_VF_INFO_ARRAY jusqu’au début du premier élément. Chaque élément du tableau est une structure NDIS_NIC_SWITCH_VF_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_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 de NDIS_NIC_SWITCH_VF_INFO_ARRAY lorsqu’il gère une demande 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 un
NDIS_NIC_SWITCH_VF_INFO structure.