estructura NDIS_SWITCH_PORT_ARRAY (ntddndis.h)

Artículo
02/26/2024

La estructura NDIS_SWITCH_PORT_ARRAY especifica una matriz de parámetros de configuración de puerto. Cada elemento de la matriz especifica los parámetros de un puerto de conmutador extensible de Hyper-V. Cada elemento tiene formato de estructura NDIS_SWITCH_PORT_PARAMETERS .

Sintaxis

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;

Miembros

Header

Tipo, revisión y tamaño de la estructura NDIS_SWITCH_PORT_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 NDIS_SWITCH_PORT_ARRAY , el miembro Revision de Header debe establecerse en el siguiente valor:

NDIS_SWITCH_PORT_ARRAY_REVISION_1

Versión original para NDIS 6.30 y versiones posteriores.

Establezca el miembro Size en NDIS_SIZEOF_NDIS_SWITCH_PORT_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_PORT_ARRAY hasta el principio del primer elemento. Cada elemento de la matriz es una estructura NDIS_SWITCH_PORT_PARAMETERS .

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

NumElements

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

ElementSize

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

Comentarios

La estructura NDIS_SWITCH_PORT_ARRAY se devuelve en las solicitudes de consulta OID de OID_SWITCH_PORT_ARRAY. Una matriz de estructuras de NDIS_SWITCH_PORT_PARAMETERS sigue la estructura NDIS_SWITCH_PORT_ARRAY en el búfer de información asociado a estas solicitudes 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 elementos individuales de NDIS_SWITCH_PORT_PARAMETERS dentro de una estructura de NDIS_SWITCH_PORT_ARRAY mediante la macro NDIS_SWITCH_PORT_AT_ARRAY_INDEX .