estructura NDIS_SWITCH_NIC_ARRAY (ntddndis.h)

Artículo
03/05/2024

La estructura NDIS_SWITCH_NIC_ARRAY especifica una matriz de parámetros de configuración del adaptador de red. Cada elemento de la matriz especifica los parámetros de un adaptador de red que está conectado a un puerto en un conmutador extensible de Hyper-V. Cada elemento tiene formato de estructura NDIS_SWITCH_NIC_PARAMETERS .

Sintaxis

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;

Miembros

Header

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

El miembro Type de Header debe establecerse en NDIS_OBJECT_TYPE_DEFAULT. Para especificar la versión de la estructura de NDIS_SWITCH_NIC_ARRAY , el miembro Revision de Header debe establecerse en el siguiente valor:

NDIS_SWITCH_NIC_ARRAY_REVISION_1

Versión original para NDIS 6.30 y versiones posteriores.

Establezca el miembro Size en NDIS_SIZEOF_NDIS_SWITCH_NIC_ARRAY_REVISION_1.

Flags

Valor de ULONG que contiene un OR bit a bit de marcas. Este miembro está reservado para NDIS.

FirstElementOffset

Valor de USHORT 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_SWITCH_NIC_ARRAY hasta el principio del primer elemento. Cada elemento de la matriz es una estructura NDIS_SWITCH_NIC_PARAMETERS .

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

NumElements

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

ElementSize

Valor ULONG que especifica el tamaño, en bytes, de los elementos NDIS_SWITCH_NIC_PARAMETERS que siguen a la estructura NDIS_SWITCH_NIC_ARRAY .

Comentarios

La estructura NDIS_SWITCH_NIC_ARRAY se devuelve en las solicitudes de consulta OID de OID_SWITCH_NIC_ARRAY. Una matriz de estructuras de NDIS_SWITCH_NIC_PARAMETERS sigue la estructura de NDIS_SWITCH_NIC_ARRAY en el búfer de información asociado a la solicitud de consulta OID. El miembro InformationBuffer de la estructura NDIS_OID_REQUEST contiene un puntero a este búfer de información.

Las extensiones de conmutador extensible pueden acceder a estructuras de NDIS_SWITCH_NIC_PARAMETERS individuales dentro de una estructura de NDIS_SWITCH_NIC_ARRAY mediante la macro NDIS_SWITCH_NIC_AT_ARRAY_INDEX .