estrutura NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES (ndis.h)

Importante A interface lan sem fio Native 802.11 foi preterida no Windows 10 e posterior. Em vez disso, use a WDI (Interface de Driver de Dispositivo) da WLAN. Para obter mais informações sobre o WDI, consulte Modelo de driver universal do Windows da WLAN.
 
A estrutura NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES define os atributos físicos e operacionais do driver de miniporto Nativo 802.11 e da estação 802.11.

Sintaxe

typedef struct {
  NDIS_OBJECT_HEADER       Header;
  ULONG                    OpModeCapability;
  ULONG                    NumOfTXBuffers;
  ULONG                    NumOfRXBuffers;
  BOOLEAN                  MultiDomainCapabilityImplemented;
  ULONG                    NumSupportedPhys;
  PDOT11_PHY_ATTRIBUTES    SupportedPhyAttributes;
  PDOT11_EXTSTA_ATTRIBUTES ExtSTAAttributes;
#if (NDIS_SUPPORT_NDIS620)
  PDOT11_VWIFI_ATTRIBUTES  VWiFiAttributes;
  PDOT11_EXTAP_ATTRIBUTES  ExtAPAttributes;
#endif
#if (NDIS_SUPPORT_NDIS630)
  PDOT11_WFD_ATTRIBUTES    WFDAttributes;
#endif
} NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES, *PNDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES;

Membros

Header

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

O driver de miniporta deve definir os membros de Header para os seguintes valores:

Tipo

Esse membro deve ser definido como NDIS_OBJECT_TYPE_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES.

Revisão

Para os sistemas operacionais Windows Vista ou Windows Server 2008, esse membro deve ser definido como NDIS_MINIPORT_ADAPTER_802_11_ATTRIBUTES_REVISION_1.

Para versões posteriores dos sistemas operacionais Windows, esse membro deve ser definido como NDIS_MINIPORT_ADAPTER_802_11_ATTRIBUTES_REVISION_2.

Tamanho

Para os sistemas operacionais Windows Vista ou Windows Server 2008, esse membro deve ser definido como NDIS_SIZEOF_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES_REVISION_1.

Para versões posteriores dos sistemas operacionais Windows, esse membro deve ser definido como NDIS_SIZEOF_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES_REVISION_2.

Para obter mais informações sobre esses membros, consulte NDIS_OBJECT_HEADER.

OpModeCapability

Uma máscara de bits dos modos de operação com suporte do driver de miniport. Essa máscara de bits é definida por meio do seguinte:

DOT11_OPERATION_MODE_EXTENSIBLE_AP

Especifica que o driver de miniporto dá suporte ao modo de operação ExtAP (Ponto de Acesso Extensível).

Esse valor está disponível a partir do Windows 7.

DOT11_OPERATION_MODE_EXTENSIBLE_STATION

Especifica que o driver de miniporto dá suporte ao modo de operação ExtSTA (Estação Extensível).

DOT11_OPERATION_MODE_NETWORK_MONITOR

Especifica que o driver de miniporto dá suporte ao modo de operação do Monitor de Rede (NetMon).

Para obter mais informações sobre modos de operação, consulte Modos de operação nativos 802.11.

NumOfTXBuffers

O número máximo de pacotes de MSDU (unidade de dados de serviço) do MAC (controle de acesso à mídia) que a estação 802.11 pode conter em sua fila de transmissão. O driver de miniporta deve dar suporte a uma profundidade mínima da fila de transmissão de 64.

O valor desse membro não deve incluir o número de buffers de transmissão que a estação 802.11 usa para enviar pacotes por conta própria, como pacotes Beacon ou pacotes de controle 802.11.

NumOfRXBuffers

O número máximo de pacotes MSDU que a estação 802.11 pode armazenar em buffer em sua fila de recebimento. O driver de miniporta deve dar suporte a uma profundidade mínima da fila de recebimento de 64.

MultiDomainCapabilityImplemented

Um valor booliano que, se TRUE, especifica que a estação 802.11 pode operar em vários domínios regulatórios. Para obter mais informações sobre domínios regulatórios 802.11, consulte o padrão IEEE 802.11d-2001.

NumSupportedPhys

O número de PHYs na estação 802.11.

SupportedPhyAttributes

Um ponteiro para uma matriz de estruturas DOT11_PHY_ATTRIBUTES . Essa matriz deve ter entradas NumSupportedPhys e deve ser classificada na mesma ordem que a lista de tipos PHY retornada por meio de uma consulta de OID_DOT11_SUPPORTED_PHY_TYPES.

ExtSTAAttributes

Um ponteiro para uma estrutura DOT11_EXTSTA_ATTRIBUTES que especifica os atributos do driver de miniporto e da estação 802.11 ao operar no modo ExtSTA (Estação Extensível). Para obter mais informações sobre esse modo de operação, consulte Modo de operação de estação extensível.

VWiFiAttributes

Um ponteiro para uma estrutura DOT11_VWIFI_ATTRIBUTES que especifica os atributos do driver de miniporto e da estação 802.11 quando ele opera no modo WiFi Virtual.

Este membro está disponível a partir do Windows 7.

ExtAPAttributes

Um ponteiro para uma estrutura DOT11_EXTAP_ATTRIBUTES que especifica os atributos do driver de miniporto e da estação 802.11 quando ele opera no modo ExtAP (Ponto de Acesso Extensível).

Este membro está disponível a partir do Windows 7.

WFDAttributes

Um ponteiro para uma estrutura DOT11_WFD_ATTRIBUTES que especifica os atributos do driver de miniporto e da estação 802.11 quando ele opera no modo Wi-Fi Direct (WFD).

Esse membro está disponível a partir do Windows 8.

Comentários

Quando sua função MiniportInitializeEx é chamada, o driver de miniporto deve chamar o A função NdisMSetMiniportAttributes para definir os atributos Native 802.11 do driver e da estação 802.11. O driver de miniporta deve seguir estas diretrizes ao fazer a chamada para NdisMSetMiniportAttributes:

  • O parâmetro MiniportAttributes deve ser definido como o endereço de um bloco de memória alocado pelo driver que contém uma estrutura NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES juntamente com os atributos ExtSTA e uma matriz de atributos PHY.
  • O membro SupportedPhyAttributes deve ser o endereço da matriz de estruturas DOT11_PHY_ATTRIBUTES . Essa matriz deve estar dentro do bloco de memória alocado pelo driver referenciado pelo parâmetro MiniportAttributes .
  • O membro ExtSTAAttributes deve ser o endereço de uma estrutura DOT11_EXTSTA_ATTRIBUTES . Essa estrutura deve estar dentro do bloco de memória alocado pelo driver referenciado pelo parâmetro MiniportAttributes .
Para obter mais informações sobre os requisitos de inicialização para um driver de miniporta Nativo 802.11, consulte Inicialização de driver de miniporto nativo 802.11.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.
Cabeçalho ndis.h

Confira também

Modo de operação de estação extensível

Modos de operação nativos 802.11

DOT11_EXTAP_ATTRIBUTES

DOT11_EXTSTA_ATTRIBUTES

OID_DOT11_SUPPORTED_PHY_TYPES

DOT11_PHY_ATTRIBUTES

Inicialização nativa do driver de miniporto 802.11

NdisMSetMiniportAttributes

MiniportInitializeEx

DOT11_WFD_ATTRIBUTES

DOT11_VWIFI_ATTRIBUTES

NDIS_OBJECT_HEADER