structure NDIS_SWITCH_NIC_ARRAY (ntddndis.h)

Article
03/05/2024

La structure NDIS_SWITCH_NIC_ARRAY spécifie un tableau de paramètres de configuration de carte réseau. Chaque élément du tableau spécifie les paramètres d’une carte réseau connectée à un port sur un commutateur extensible Hyper-V. Chaque élément est mis en forme en tant que structure NDIS_SWITCH_NIC_PARAMETERS .

Syntaxe

typedef struct _NDIS_SWITCH_NIC_ARRAY {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  USHORT             FirstElementOffset;
  ULONG              NumElements;
  ULONG              ElementSize;
} NDIS_SWITCH_NIC_ARRAY, *PNDIS_SWITCH_NIC_ARRAY;

Membres

Header

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

Le membre Type de l’en-tête doit être défini sur NDIS_OBJECT_TYPE_DEFAULT. Pour spécifier la version de la structure NDIS_SWITCH_NIC_ARRAY , le membre Revision de Header doit avoir la valeur suivante :

NDIS_SWITCH_NIC_ARRAY_REVISION_1

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

Définissez le membre Size sur NDIS_SIZEOF_NDIS_SWITCH_NIC_ARRAY_REVISION_1.

Flags

Valeur ULONG qui contient un OR au niveau du bit d’indicateurs. Ce membre est réservé à NDIS.

FirstElementOffset

Valeur USHORT qui spécifie le décalage, en octets, du 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_SWITCH_NIC_ARRAY jusqu’au début du premier élément. Chaque élément du tableau est une structure NDIS_SWITCH_NIC_PARAMETERS .

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

NumElements

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

ElementSize

Valeur ULONG qui spécifie la taille, en octets, des éléments NDIS_SWITCH_NIC_PARAMETERS qui suivent la structure NDIS_SWITCH_NIC_ARRAY .

Remarques

La structure NDIS_SWITCH_NIC_ARRAY est retournée dans les requêtes de requête OID de OID_SWITCH_NIC_ARRAY. Un tableau de structures NDIS_SWITCH_NIC_PARAMETERS suit la structure NDIS_SWITCH_NIC_ARRAY dans la mémoire tampon d’informations associée à la demande de requête OID. Le membre InformationBuffer de la structure NDIS_OID_REQUEST contient un pointeur vers cette mémoire tampon d’informations.

Les extensions de commutateur extensible peuvent accéder à des structures de NDIS_SWITCH_NIC_PARAMETERS individuelles à l’intérieur d’une structure de NDIS_SWITCH_NIC_ARRAY à l’aide de la macro NDIS_SWITCH_NIC_AT_ARRAY_INDEX .