NDIS_OPEN_PARAMETERS estrutura (ndis.h)

Artigo
02/07/2025

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 NDIS_OPEN_PARAMETERS. Defina o membro tipo da estrutura que de Cabeçalho especifica para NDIS_OBJECT_TYPE_OPEN_PARAMETERS, o membro de Revisão de para NDIS_OPEN_PARAMETERS_REVISION_1 e o membro tamanho do para 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 AdapterName membro 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 de 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;

Observaçã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.

Observações

Um driver de protocolo passa uma estrutura NDIS_OPEN_PARAMETERS quando chama a função NdisOpenAdapterEx para abrir um adaptador de miniporto.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Com suporte no NDIS 6.0 e posterior.
cabeçalho	ndis.h (inclua Ndis.h)

Consulte também

NDIS_MEDIUM

NDIS_OBJECT_HEADER

NdisOpenAdapterEx

ProtocolBindAdapterEx

Partilhar via