NDIS_NIC_SWITCH_INFO_ARRAY estrutura (ntddndis.h)

Artigo
02/07/2025

A estrutura NDIS_NIC_SWITCH_INFO_ARRAY especifica uma matriz. Cada elemento na matriz especifica os atributos de um comutador de adaptador de rede que foi criado no adaptador de rede.

Sintaxe

typedef struct _NDIS_NIC_SWITCH_INFO_ARRAY {
  NDIS_OBJECT_HEADER Header;
  ULONG              FirstElementOffset;
  ULONG              NumElements;
  ULONG              ElementSize;
} NDIS_NIC_SWITCH_INFO_ARRAY, *PNDIS_NIC_SWITCH_INFO_ARRAY;

Membros

Header

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

O NDIS define o membro tipo do de Cabeçalho como NDIS_OBJECT_TYPE_DEFAULT. Para especificar a versão da estrutura de NDIS_NIC_SWITCH_INFO_ARRAY, o NDIS define o membro de Revisão do de Cabeçalho para o seguinte valor:

NDIS_NIC_SWITCH_INFO_ARRAY_REVISION_1

Versão original do NDIS 6.30.

Defina o membro tamanho como NDIS_SIZEOF_NIC_SWITCH_INFO_ARRAY_REVISION_1.

FirstElementOffset

Um valor ULONG 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_NIC_SWITCH_INFO_ARRAY até o início do primeiro elemento. Cada elemento na matriz é uma estrutura NDIS_NIC_SWITCH_INFO.

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

NumElements

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

ElementSize

Um valor ULONG que especifica o tamanho, em bytes, de cada elemento que segue a estrutura NDIS_NIC_SWITCH_INFO_ARRAY.

Observações

O NDIS retorna uma estrutura NDIS_NIC_SWITCH_INFO_ARRAY das seguintes maneiras:

Quando o NDIS manipula uma solicitação de consulta OID de OID_NIC_SWITCH_ENUM_SWITCHES, ele retorna um ponteiro para uma estrutura de NDIS_NIC_SWITCH_INFO_ARRAY no membro InformationBuffer do NDIS_OID_REQUEST.
Quando o NDIS chama a função ProtocolBindAdapterEx, o NDIS passa um ponteiro para uma estrutura de NDIS_BIND_PARAMETERS no parâmetro BindParameters. O NDIS define o membro NicSwitchArray da estrutura NDIS_BIND_PARAMETERS como um ponteiro para uma estrutura NDIS_NIC_SWITCH_INFO_ARRAY.
Quando o NDIS chama a função FilterAttach, o NDIS passa um ponteiro para uma estrutura de NDIS_FILTER_ATTACH_PARAMETERS no parâmetro AttachParameters. O NDIS define o membro nicSwitchArray da estrutura NDIS_FILTER_ATTACH_PARAMETERS como um ponteiro para uma estrutura NDIS_NIC_SWITCH_INFO_ARRAY.

Cada elemento na matriz que segue a estrutura NDIS_NIC_SWITCH_INFO_ARRAY é uma estrutura NDIS_NIC_SWITCH_INFO.

Observação Começando com o NDIS 6.30, somente o NDIS_NIC_SWITCH_INFO que descreve as informações sobre o comutador de adaptador de rede padrão é retornado por meio de uma solicitação de consulta OID de OID_NIC_SWITCH_ENUM_SWITCHES.