NDIS_SWITCH_PORT_ARRAY estrutura (ntddndis.h)

Artigo
02/07/2025

A estrutura NDIS_SWITCH_PORT_ARRAY especifica uma matriz de parâmetros de configuração de porta. Cada elemento na matriz especifica os parâmetros para uma porta de comutador extensível Hyper-V. Cada elemento é formatado como uma estrutura NDIS_SWITCH_PORT_PARAMETERS.

Sintaxe

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;

Membros

Header

O tipo, a revisão e o tamanho da estrutura NDIS_SWITCH_PORT_ARRAY. Esse membro é formatado como uma estrutura NDIS_OBJECT_HEADER.

O membro tipo do de cabeçalho deve ser definido como NDIS_OBJECT_TYPE_DEFAULT. Para especificar a versão da estrutura de NDIS_SWITCH_PORT_ARRAY, o membro de Revisão do de Cabeçalho deve ser definido com o seguinte valor:

NDIS_SWITCH_PORT_ARRAY_REVISION_1

Versão original do NDIS 6.30 e posterior.

Defina o membro tamanho como NDIS_SIZEOF_NDIS_SWITCH_PORT_ARRAY_REVISION_1.

Flags

Um valor ULONG que contém um or bit a bit de sinalizadores. Este membro é reservado para NDIS.

FirstElementOffset

Um valor USHORT que especifica o deslocamento, em bytes, para o primeiro elemento em uma matriz de elementos que seguem essa estrutura. O deslocamento é medido desde o início da estrutura NDIS_SWITCH_PORT_ARRAY até o início do primeiro elemento. Cada elemento na matriz é uma estrutura NDIS_SWITCH_PORT_PARAMETERS.

Observação Se numElements estiver definido como zero, esse membro será ignorado.

NumElements

Um valor ULONG que especifica o número de elementos NDIS_SWITCH_PORT_PARAMETERS que seguem a estrutura de NDIS_SWITCH_PORT_ARRAY.

ElementSize

Um valor ULONG que especifica o tamanho, em bytes, dos elementos NDIS_SWITCH_PORT_PARAMETERS que seguem a estrutura NDIS_SWITCH_PORT_ARRAY.

Observações

A estrutura de NDIS_SWITCH_PORT_ARRAY é retornada em solicitações de consulta OID de OID_SWITCH_PORT_ARRAY. Uma matriz de estruturas de NDIS_SWITCH_PORT_PARAMETERS segue a estrutura NDIS_SWITCH_PORT_ARRAY no buffer de informações associado a essas solicitações de consulta OID. O informationBuffer membro da estrutura NDIS_OID_REQUEST contém um ponteiro para esse buffer de informações.

As extensões de comutador extensível podem acessar elementos NDIS_SWITCH_PORT_PARAMETERS individuais dentro de uma estrutura NDIS_SWITCH_PORT_ARRAY usando a macro NDIS_SWITCH_PORT_AT_ARRAY_INDEX.