Partager via


structure NDIS_NIC_SWITCH_INFO_ARRAY (ntddndis.h)

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.
 

Configuration requise

Condition requise Valeur
Client minimal pris en charge Pris en charge dans NDIS 6.30 et versions ultérieures.
En-tête ntddndis.h (inclure Ndis.h)

Voir aussi

FilterAttach

NDIS_BIND_PARAMETERS

NDIS_FILTER_ATTACH_PARAMETERS

NDIS_NIC_SWITCH_INFO

NDIS_OBJECT_HEADER

OID_NIC_SWITCH_ENUM_SWITCHES

ProtocolBindAdapterEx