NDIS_SWITCH_PORT_ARRAY structure (ntddndis.h)

Article
02/29/2024

La structure NDIS_SWITCH_PORT_ARRAY spécifie un tableau de paramètres de configuration de port. Chaque élément du tableau spécifie les paramètres d’un port de commutateur extensible Hyper-V. Chaque élément est mis en forme en tant que structure NDIS_SWITCH_PORT_PARAMETERS .

Syntaxe

typedef struct _NDIS_SWITCH_PORT_ARRAY {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  USHORT             FirstElementOffset;
  ULONG              NumElements;
  ULONG              ElementSize;
} NDIS_SWITCH_PORT_ARRAY, *PNDIS_SWITCH_PORT_ARRAY;

Membres

Header

Type, révision et taille de la structure NDIS_SWITCH_PORT_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_PORT_ARRAY , le membre Revision de Header doit être défini sur la valeur suivante :

NDIS_SWITCH_PORT_ARRAY_REVISION_1

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

Définissez le membre Taille sur NDIS_SIZEOF_NDIS_SWITCH_PORT_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, vers 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_SWITCH_PORT_ARRAY jusqu’au début du premier élément. Chaque élément du tableau est une structure NDIS_SWITCH_PORT_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_PORT_PARAMETERS qui suivent la structure NDIS_SWITCH_PORT_ARRAY .

ElementSize

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

Remarques

La structure NDIS_SWITCH_PORT_ARRAY est retournée dans les requêtes de requête OID de OID_SWITCH_PORT_ARRAY. Un tableau de structures NDIS_SWITCH_PORT_PARAMETERS suit la structure NDIS_SWITCH_PORT_ARRAY dans la mémoire tampon d’informations associée à ces requêtes 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 éléments de NDIS_SWITCH_PORT_PARAMETERS individuels à l’intérieur d’une structure NDIS_SWITCH_PORT_ARRAY à l’aide de la macro NDIS_SWITCH_PORT_AT_ARRAY_INDEX .