estrutura NDIS_OPEN_PARAMETERS (ndis.h)

Artigo
08/07/2023

A estrutura NDIS_OPEN_PARAMETERS define os parâmetros abertos quando um driver de protocolo chama a função NdisOpenAdapterEx .

Sintaxe

typedef struct _NDIS_OPEN_PARAMETERS {
  NDIS_OBJECT_HEADER Header;
  PNDIS_STRING       AdapterName;
  PNDIS_MEDIUM       MediumArray;
  UINT               MediumArraySize;
  PUINT              SelectedMediumIndex;
  PNET_FRAME_TYPE    FrameTypeArray;
  UINT               FrameTypeArraySize;
} NDIS_OPEN_PARAMETERS, *PNDIS_OPEN_PARAMETERS;

Membros

Header

A estrutura NDIS_OBJECT_HEADER para a estrutura de NDIS_OPEN_PARAMETERS. Defina o membro Type da estrutura especificada por Header como NDIS_OBJECT_TYPE_OPEN_PARAMETERS, o membro Revision como NDIS_OPEN_PARAMETERS_REVISION_1 e o membro Size como o NDIS_SIZEOF_OPEN_PARAMETERS_REVISION_1.

AdapterName

Uma cadeia de caracteres Unicode que contém o nome do adaptador de miniporto que o NDIS passou para ProtocolBindAdapterEx no membro AdapterName do parâmetro BindParameters . Esse nome pode identificar um adaptador físico (ou seja, uma NIC) ou um adaptador virtual associado a um driver intermediário.

MediumArray

Um ponteiro para uma matriz de valores NdisMediumXxx que lista os tipos de mídia que o chamador pode dar suporte. Essa lista é um subconjunto dos tipos de NDIS_MEDIUM .

MediumArraySize

O número de elementos no membro MediumArray .

SelectedMediumIndex

Um ponteiro para uma variável UINT fornecida pelo driver que contém um índice na matriz MediumArray . O NDIS grava esse índice que identifica o tipo de mídia que o driver subjacente usa.

FrameTypeArray

Um ponteiro para uma matriz de valores NET_FRAME_TYPE, especificando os tipos de quadro que você deseja que o driver de protocolo receba. O tipo de quadro é um valor USHORT que segue o destino e o endereço MAC de origem em quadros Ethernet. Na presença de marcas VLAN, esse valor segue o destino, o endereço MAC de origem e a marca VLAN. NET_FRAME_TYPE é definido da seguinte maneira:

typedef USHORT  NET_FRAME_TYPE;
typedef NET_FRAME_TYPE *PNET_FRAME_TYPE;

Nota O NDIS usa os valores de tipo de quadro que o driver de protocolo fornece nessa matriz como uma dica para otimizar as indicações de recebimento que o NDIS envia para o driver de protocolo. O NDIS não garante que um driver de protocolo receba apenas pacotes com tipos de quadro que correspondam aos tipos na matriz.

FrameTypeArraySize

O número de elementos no membro FrameTypeArray . Esse número deve ser igual ou menor que NDIS_MAX_FRAME_TYPES_PER_OPEN.