estrutura NDIS_NIC_SWITCH_INFO_ARRAY (ntddndis.h)

Artigo
08/07/2023

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 NDIS_NIC_SWITCH_INFO_ARRAY . Esse membro é formatado como uma estrutura NDIS_OBJECT_HEADER .

O NDIS define o membro Type de Header como NDIS_OBJECT_TYPE_DEFAULT. Para especificar a versão da estrutura NDIS_NIC_SWITCH_INFO_ARRAY , o NDIS define o membro Revision do Header com o seguinte valor:

NDIS_NIC_SWITCH_INFO_ARRAY_REVISION_1

Versão original do NDIS 6.30.

Defina o membro Size 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 .

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

Comentários

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

Nota A partir do 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.