NDIS_SWITCH_NIC_ARRAY estrutura (ntddndis.h)

Artigo
02/07/2025

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 de um adaptador de rede conectado a uma porta em um comutador extensível 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 tipo do de cabeçalho deve ser definido como NDIS_OBJECT_TYPE_DEFAULT. Para especificar a versão da estrutura de NDIS_SWITCH_NIC_ARRAY, o membro de Revisão do de Cabeçalho deve ser definido como o seguinte valor:

NDIS_SWITCH_NIC_ARRAY_REVISION_1

Versão original do NDIS 6.30 e posterior.

Defina o membro tamanho como NDIS_SIZEOF_NDIS_SWITCH_NIC_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 de NDIS_SWITCH_NIC_ARRAY até o início do primeiro elemento. Cada elemento na matriz é uma estrutura NDIS_SWITCH_NIC_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_NIC_PARAMETERS que seguem a estrutura de 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.

Observações

A estrutura de 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 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 estruturas de NDIS_SWITCH_NIC_PARAMETERS individuais dentro de uma estrutura NDIS_SWITCH_NIC_ARRAY usando a macro NDIS_SWITCH_NIC_AT_ARRAY_INDEX.