estrutura NDIS_SWITCH_NIC_ARRAY (ntddndis.h)

Artigo
08/07/2023

A estrutura NDIS_SWITCH_NIC_ARRAY especifica uma matriz de parâmetros de configuração do adaptador de rede. Cada elemento na matriz especifica os parâmetros para um adaptador de rede conectado a uma porta em um comutador extensível do Hyper-V. Cada elemento é formatado como uma estrutura NDIS_SWITCH_NIC_PARAMETERS .

Sintaxe

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;

Membros

Header

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

O membro Type de Header deve ser definido como NDIS_OBJECT_TYPE_DEFAULT. Para especificar a versão da estrutura NDIS_SWITCH_NIC_ARRAY , o membro Revision do Header deve ser definido com o seguinte valor:

NDIS_SWITCH_NIC_ARRAY_REVISION_1

Versão original do NDIS 6.30 e posterior.

Defina o membro Size como NDIS_SIZEOF_NDIS_SWITCH_NIC_ARRAY_REVISION_1.

Flags

Um valor ULONG que contém um OR bit a bit de sinalizadores. Esse 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_NIC_ARRAY até o início do primeiro elemento. Cada elemento na matriz é uma estrutura NDIS_SWITCH_NIC_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_NIC_PARAMETERS que seguem a estrutura NDIS_SWITCH_NIC_ARRAY .

ElementSize

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

Comentários

A estrutura NDIS_SWITCH_NIC_ARRAY é retornada em solicitações de consulta OID de OID_SWITCH_NIC_ARRAY. Uma matriz de estruturas de NDIS_SWITCH_NIC_PARAMETERS segue a estrutura NDIS_SWITCH_NIC_ARRAY no buffer de informações associado à solicitação de consulta OID. O membro InformationBuffer da estrutura NDIS_OID_REQUEST contém um ponteiro para esse buffer de informações.

As extensões de comutador extensíveis podem acessar estruturas de NDIS_SWITCH_NIC_PARAMETERS individuais dentro de uma estrutura NDIS_SWITCH_NIC_ARRAY usando a macro NDIS_SWITCH_NIC_AT_ARRAY_INDEX .