structure NDIS_NIC_SWITCH_INFO_ARRAY (ntddndis.h)

Article
02/26/2024

La structure NDIS_NIC_SWITCH_INFO_ARRAY spécifie un tableau. Chaque élément du tableau spécifie les attributs d’un commutateur de carte réseau qui a été créé sur la carte réseau.

Syntaxe

typedef struct _NDIS_NIC_SWITCH_INFO_ARRAY {
  NDIS_OBJECT_HEADER Header;
  ULONG              FirstElementOffset;
  ULONG              NumElements;
  ULONG              ElementSize;
} NDIS_NIC_SWITCH_INFO_ARRAY, *PNDIS_NIC_SWITCH_INFO_ARRAY;

Membres

Header

Type, révision et taille de la structure NDIS_NIC_SWITCH_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_INFO_ARRAY , NDIS définit le membre Revision de Header sur la valeur suivante :

NDIS_NIC_SWITCH_INFO_ARRAY_REVISION_1

Version d’origine pour NDIS 6.30.

Définissez le membre Size sur NDIS_SIZEOF_NIC_SWITCH_INFO_ARRAY_REVISION_1.

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_INFO_ARRAY jusqu’au début du premier élément. Chaque élément du tableau est une structure NDIS_NIC_SWITCH_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_INFO_ARRAY .

ElementSize

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

Remarques

NDIS retourne une structure NDIS_NIC_SWITCH_INFO_ARRAY des manières suivantes :

Quand NDIS gère une requête OID de OID_NIC_SWITCH_ENUM_SWITCHES, il retourne un pointeur vers une structure de NDIS_NIC_SWITCH_INFO_ARRAY dans le membre InformationBuffer du NDIS_OID_REQUEST.
Lorsque NDIS appelle la fonction ProtocolBindAdapterEx , NDIS passe un pointeur vers une structure NDIS_BIND_PARAMETERS dans le paramètre BindParameters . NDIS définit le membre NicSwitchArray de la structure NDIS_BIND_PARAMETERS sur un pointeur vers une structure NDIS_NIC_SWITCH_INFO_ARRAY .
Lorsque NDIS appelle la fonction FilterAttach , NDIS passe un pointeur vers une structure NDIS_FILTER_ATTACH_PARAMETERS dans le paramètre AttachParameters . NDIS définit le membre NicSwitchArray de la structure NDIS_FILTER_ATTACH_PARAMETERS sur un pointeur vers une structure NDIS_NIC_SWITCH_INFO_ARRAY .

Chaque élément du tableau qui suit la structure NDIS_NIC_SWITCH_INFO_ARRAY est une structure NDIS_NIC_SWITCH_INFO .

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