estructura NDIS_NIC_SWITCH_INFO_ARRAY (ntddndis.h)

Artículo
08/07/2023

La estructura NDIS_NIC_SWITCH_INFO_ARRAY especifica una matriz. Cada elemento de la matriz especifica los atributos de un conmutador de adaptador de red que se ha creado en el adaptador de red.

Sintaxis

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;

Miembros

Header

Tipo, revisión y tamaño de la estructura NDIS_NIC_SWITCH_INFO_ARRAY . Este miembro tiene el formato de estructura NDIS_OBJECT_HEADER .

NDIS establece el miembro Type de Header en NDIS_OBJECT_TYPE_DEFAULT. Para especificar la versión de la estructura de NDIS_NIC_SWITCH_INFO_ARRAY , NDIS establece el miembro Revision de Header en el valor siguiente:

NDIS_NIC_SWITCH_INFO_ARRAY_REVISION_1

Versión original de NDIS 6.30.

Establezca el miembro Size en NDIS_SIZEOF_NIC_SWITCH_INFO_ARRAY_REVISION_1.

FirstElementOffset

Valor ULONG que especifica el desplazamiento, en bytes, al primer elemento de una matriz de elementos que siguen esta estructura. El desplazamiento se mide desde el principio de la estructura NDIS_NIC_SWITCH_INFO_ARRAY hasta el principio del primer elemento. Cada elemento de la matriz es una estructura NDIS_NIC_SWITCH_INFO .

Nota Si NumElements se establece en cero, se omite este miembro.

NumElements

Valor de ULONG que especifica el número de elementos que siguen a la estructura NDIS_NIC_SWITCH_INFO_ARRAY .

ElementSize

Valor de ULONG que especifica el tamaño, en bytes, de cada elemento que sigue a la estructura NDIS_NIC_SWITCH_INFO_ARRAY .

Comentarios

NDIS devuelve una estructura de NDIS_NIC_SWITCH_INFO_ARRAY de las siguientes maneras:

Cuando NDIS controla una solicitud de consulta OID de OID_NIC_SWITCH_ENUM_SWITCHES, devuelve un puntero a una estructura de NDIS_NIC_SWITCH_INFO_ARRAY en el miembro InformationBuffer del NDIS_OID_REQUEST.
Cuando NDIS llama a la función ProtocolBindAdapterEx , NDIS pasa un puntero a una estructura de NDIS_BIND_PARAMETERS en el parámetro BindParameters . NDIS establece el miembro NicSwitchArray de la estructura NDIS_BIND_PARAMETERS en un puntero a una estructura de NDIS_NIC_SWITCH_INFO_ARRAY .
Cuando NDIS llama a la función FilterAttach , NDIS pasa un puntero a una estructura de NDIS_FILTER_ATTACH_PARAMETERS en el parámetro AttachParameters . NDIS establece el miembro NicSwitchArray de la estructura NDIS_FILTER_ATTACH_PARAMETERS en un puntero a una estructura NDIS_NIC_SWITCH_INFO_ARRAY .

Cada elemento de la matriz que sigue a la estructura NDIS_NIC_SWITCH_INFO_ARRAY es una estructura NDIS_NIC_SWITCH_INFO .

Nota A partir de NDIS 6.30, solo el NDIS_NIC_SWITCH_INFO que describe la información sobre el conmutador de adaptador de red predeterminado se devuelve a través de una solicitud de consulta OID de OID_NIC_SWITCH_ENUM_SWITCHES.