estrutura NDIS_SWITCH_PORT_ARRAY (ntddndis.h)

Artigo
08/07/2023

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 do 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 de Cabeçalho deve ser definido como NDIS_OBJECT_TYPE_DEFAULT. Para especificar a versão da estrutura NDIS_SWITCH_PORT_ARRAY , o membro Revision de Header deve ser definido como o seguinte valor:

NDIS_SWITCH_PORT_ARRAY_REVISION_1

Versão original do NDIS 6.30 e posterior.

Defina o membro Size como NDIS_SIZEOF_NDIS_SWITCH_PORT_ARRAY_REVISION_1.

Flags

Um valor ULONG que contém um OR bit a bit de sinalizadores. Esse membro é reservado para o 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 .

Nota 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 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 .

Comentários

A estrutura 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 membro InformationBuffer da estrutura NDIS_OID_REQUEST contém um ponteiro para esse buffer de informações.

Extensíveis extensíveis 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 .