Compartilhar via


estrutura DOT11_EXTSTA_ATTRIBUTES (windot11.h)

Importante A interface lan sem fio Native 802.11 foi preterida em Windows 10 e posteriores. Em vez disso, use a WDI (Interface do Driver de Dispositivo) WLAN. Para obter mais informações sobre o WDI, consulte WLAN Modelo de driver Universal do Windows.
 
A estrutura DOT11_EXTSTA_ATTRIBUTES define os atributos físicos e operacionais do driver de miniporto e da estação 802.11 ao operar no modo Estação Extensível (ExtSTA). Para obter mais informações sobre esse modo de operação, consulte Modo extensível de operação de estação.

Sintaxe

typedef struct DOT11_EXTSTA_ATTRIBUTES {
  NDIS_OBJECT_HEADER              Header;
  ULONG                           uScanSSIDListSize;
  ULONG                           uDesiredBSSIDListSize;
  ULONG                           uDesiredSSIDListSize;
  ULONG                           uExcludedMacAddressListSize;
  ULONG                           uPrivacyExemptionListSize;
  ULONG                           uKeyMappingTableSize;
  ULONG                           uDefaultKeyTableSize;
  ULONG                           uWEPKeyValueMaxLength;
  ULONG                           uPMKIDCacheSize;
  ULONG                           uMaxNumPerSTADefaultKeyTables;
  BOOLEAN                         bStrictlyOrderedServiceClassImplemented;
  UCHAR                           ucSupportedQoSProtocolFlags;
  BOOLEAN                         bSafeModeImplemented;
  ULONG                           uNumSupportedCountryOrRegionStrings;
  PDOT11_COUNTRY_OR_REGION_STRING pSupportedCountryOrRegionStrings;
  ULONG                           uInfraNumSupportedUcastAlgoPairs;
  PDOT11_AUTH_CIPHER_PAIR         pInfraSupportedUcastAlgoPairs;
  ULONG                           uInfraNumSupportedMcastAlgoPairs;
  PDOT11_AUTH_CIPHER_PAIR         pInfraSupportedMcastAlgoPairs;
  ULONG                           uAdhocNumSupportedUcastAlgoPairs;
  PDOT11_AUTH_CIPHER_PAIR         pAdhocSupportedUcastAlgoPairs;
  ULONG                           uAdhocNumSupportedMcastAlgoPairs;
  PDOT11_AUTH_CIPHER_PAIR         pAdhocSupportedMcastAlgoPairs;
  BOOLEAN                         bAutoPowerSaveMode;
  ULONG                           uMaxNetworkOffloadListSize;
  BOOLEAN                         bMFPCapable;
  ULONG                           uInfraNumSupportedMcastMgmtAlgoPairs;
  PDOT11_AUTH_CIPHER_PAIR         pInfraSupportedMcastMgmtAlgoPairs;
} DOT11_EXTSTA_ATTRIBUTES, *PDOT11_EXTSTA_ATTRIBUTES;

Membros

Header

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

O driver de miniporte deve definir os membros de Header para os valores a seguir.

Tipo

Esse membro deve ser definido como NDIS_OBJECT_TYPE_DEFAULT.

Revisão

Esse membro deve ser definido como um dos seguintes valores de acordo com o sistema operacional no qual o driver se destina a ser executado:

DOT11_EXTSTA_ATTRIBUTES_REVISION_1

Windows Vista

DOT11_EXTSTA_ATTRIBUTES_REVISION_2

Windows Vista com Service Pack 1 (SP1) ou versões posteriores dos sistemas operacionais Windows

DOT11_EXTSTA_ATTRIBUTES_REVISION_3

Windows 8 ou versões posteriores dos sistemas operacionais Windows

Esses valores determinam como o sistema operacional interpreta o membro bSafeModeImplemented .

Tamanho

Esse membro deve ser definido como sizeof(DOT11_EXTSTA_ATTRIBUTES).

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

uScanSSIDListSize

O número máximo de SSIDs (identificadores do conjunto de serviços) com suporte na estação 802.11 para operações de verificação. A estação 802.11 deve dar suporte a uma lista SSID de pelo menos quatro entradas.

A lista SSID que a estação 802.11 usa para verificação é especificada quando OID_DOT11_SCAN_REQUEST é definido.

uDesiredBSSIDListSize

O número máximo de entradas na lista desejada de BSSIDs (identificadores básicos do conjunto de serviços) com suporte na estação 802.11. A estação 802.11 deve dar suporte a uma lista BSSID com pelo menos uma entrada.

Para obter mais informações sobre a lista BSSID desejada, consulte OID_DOT11_DESIRED_BSSID_LIST.

uDesiredSSIDListSize

O número máximo de entradas na lista SSID desejada compatível com a estação 802.11. A estação 802.11 deve dar suporte a uma lista SSID desejada com pelo menos uma entrada.

Para obter mais informações sobre a lista SSID desejada, consulte OID_DOT11_DESIRED_SSID_LIST.

uExcludedMacAddressListSize

O número máximo de entradas na lista de endereços MAC excluída com suporte na estação 802.11. A estação 802.11 deve dar suporte a uma lista de endereços MAC excluída com pelo menos quatro entradas.

Para obter mais informações sobre a lista de endereços MAC excluídos desejados, consulte OID_DOT11_EXCLUDED_MAC_ADDRESS_LIST.

uPrivacyExemptionListSize

O número máximo de entradas na lista de isenção de privacidade compatível com a estação 802.11. A estação 802.11 deve dar suporte a uma lista de isenção de privacidade com pelo menos uma entrada.

Para obter mais informações sobre a lista de isenção de privacidade, consulte OID_DOT11_PRIVACY_EXEMPTION_LIST.

uKeyMappingTableSize

O número máximo de chaves de mapeamento de chave de criptografia com suporte na estação 802.11. É recomendável que a estação 802.11 dê suporte a pelo menos 32 chaves de mapeamento de chave.

Para obter mais informações sobre chaves de mapeamento de chave, consulte OID_DOT11_CIPHER_KEY_MAPPING_KEY.

uDefaultKeyTableSize

O número máximo de chaves de codificação que a estação 802.11 dá suporte para a chave padrão e as tabelas de chaves padrão por estação.

Para algoritmos de criptografia padrão 802.11, a estação 802.11 deve dar suporte a um tamanho de tabela de pelo menos quatro chaves de criptografia. Para algoritmos de criptografia desenvolvidos pelo IHV (fornecedor independente de hardware), o tamanho da tabela pode ser quatro ou maior.

uWEPKeyValueMaxLength

O comprimento máximo, em bytes, de uma chave de criptografia WEP com suporte na estação 802.11.

A tabela a seguir lista os comprimentos mínimo e máximo de chave, em bytes, para os vários valores de criptografia WEP definidos por meio de DOT11_CIPHER_ALGORITHM.

Criptografia WEP Comprimento mínimo da chave Comprimento máximo da chave
DOT11_CIPHER_ALGO_WEP40 5 5
DOT11_CIPHER_ALGO_WEP104 13 13
DOT11_CIPHER_ALGO_WEP 13 Qualquer comprimento compatível com a estação 802.11

uPMKIDCacheSize

O número máximo de entradas no cache PMKID (identificador de chave) master par com suporte na estação 802.11.

Se a estação 802.11 não oferecer suporte a um cache PMKID, o driver de miniporto deverá definir esse membro como zero. Caso contrário, a estação 802.11 deve dar suporte a um tamanho de cache PMKID de pelo menos três entradas.

Para obter mais informações sobre o cache PMKID, consulte OID_DOT11_PMKID_LIST.

uMaxNumPerSTADefaultKeyTables

O número máximo de tabelas de chaves de codificação padrão por estação com suporte na estação 802.11. É recomendável que a estação 802.11 dê suporte a pelo menos 32 tabelas de chaves de codificação padrão por estação.

Para obter mais informações sobre tabelas de chaves de codificação padrão por estação, consulte Chaves padrão por estação.

bStrictlyOrderedServiceClassImplemented

Um valor booliano que, se definido como TRUE, especifica que a estação 802.11 dá suporte à classe de serviço IEEE 802.11 StrictlyOrdered para entrega de pacotes MSDU (unidade de dados de serviço) do MAC (controle de acesso à mídia).

Para obter mais informações sobre a classe de serviço StrictlyOrdered, consulte a Cláusula 5.1.3 do padrão IEEE 802.11-2012.

ucSupportedQoSProtocolFlags

Um conjunto de sinalizadores que especificam os protocolos de qualidade de serviço (QoS) que a NIC implementa. Esse membro é zero ou uma combinação OR bit a bit dos seguintes sinalizadores:

DOT11_QOS_PROTOCOL_FLAG_WMM

A NIC implementa o protocolo QoS do WMM 802.11.

DOT11_QOS_PROTOCOL_FLAG_11E

A NIC implementa o protocolo QoS 802.11e.

bSafeModeImplemented

O modo de segurança dá suporte à funcionalidade da combinação de driver NIC/miniport. O sistema operacional interpreta esse membro de forma diferente dependendo do valor de Header.Revision:

Revisão = DOT11_EXTSTA_ATTRIBUTES_REVISION_1

O sistema operacional interpreta o membro bSafeModeImplemented como um valor booliano. Se esse valor for TRUE, a NIC implementará o modo de operação seguro 802.11. Caso contrário, o valor será FALSE.

Revisão = DOT11_EXTSTA_ATTRIBUTES_REVISION_2 ou superior

O sistema operacional interpreta o membro bSafeModeImplemented como um campo de bits com os seguintes valores de bit possíveis definidos:

  • Se o campo de bits estiver definido como DOT11_EXTSTA_ATTRIBUTES_SAFEMODE_OID_SUPPORTED sem outros bits definidos, o driver de miniporto implementará o modo de operação seguro 802.11.
  • Se o campo de bits estiver definido como DOT11_EXTSTA_ATTRIBUTES_SAFEMODE_CERTIFIED, a combinação NIC/miniport recebeu um certificado de validação do NIST (National Institute of Standards and Technology) na Publicação 140-2 do Federal Information Processing Standards (FIPS), requisitos de segurança para módulos criptográficos.
Esse membro é usado em conjunto com OID_DOT11_SAFE_MODE_ENABLED.

uNumSupportedCountryOrRegionStrings

O número de cadeias de caracteres de país ou região com suporte na estação 802.11. Se a estação 802.11 der suporte a vários domínios regulatórios conforme especificado pelo padrão IEEE 802.11d-2001, cada cadeia de caracteres de país ou região identificará um domínio regulatório compatível com a estação 802.11.

Se a estação 802.11 não oferecer suporte ao padrão IEEE 802.11d-2001, o driver de miniporto deverá definir uNumSupportedCountryOrRegionStrings como zero.

pSupportedCountryOrRegionStrings

Um ponteiro para uma matriz de cadeias de caracteres de país ou região de 802,11d com suporte na estação 802.11. Cada entrada na matriz é formatada como um DOT11_COUNTRY_OR_REGION_STRING estrutura.

uInfraNumSupportedUcastAlgoPairs

O número de algoritmos de autenticação e codificação compatíveis com a estação 802.11 para enviar e receber pacotes unicast quando configurados para operação em uma rede BSS (conjunto de serviços básico) de infraestrutura. O membro uInfraNumSupportedUcastAlgoPairs deve ser o número de estruturas DOT11_AUTH_CIPHER_PAIR na matriz referenciada pelo membro pInfraSupportedUcastAlgoPairs .

pInfraSupportedUcastAlgoPairs

Um ponteiro para uma matriz de algoritmos de autenticação e criptografia com suporte na estação 802.11 para enviar e receber pacotes unicast em uma rede BSS de infraestrutura. Cada entrada na matriz é formatada como um DOT11_AUTH_CIPHER_PAIR estrutura.

uInfraNumSupportedMcastAlgoPairs

O número de algoritmos de autenticação e criptografia compatíveis com a estação 802.11 para enviar e receber pacotes multicast e difusão quando configurados para operação em uma rede BSS (conjunto de serviços básico) de infraestrutura. O membro uInfraNumSupportedMcastAlgoPairs deve ser o número de estruturas DOT11_AUTH_CIPHER_PAIR na matriz referenciada pelo membro pInfraSupportedMcastAlgoPairs .

pInfraSupportedMcastAlgoPairs

Um ponteiro para uma matriz de algoritmos de autenticação e criptografia com suporte na estação 802.11 para enviar e receber pacotes multicast e difusão em uma rede BSS de infraestrutura. Cada entrada na matriz é formatada como um DOT11_AUTH_CIPHER_PAIR estrutura.

uAdhocNumSupportedUcastAlgoPairs

O número de algoritmos de autenticação e criptografia compatíveis com a estação 802.11 para enviar e receber pacotes unicast quando configurados para operação em uma rede independente do BSS (IBSS). O membro uAdhocNumSupportedUcastAlgoPairs deve ser o número de estruturas DOT11_AUTH_CIPHER_PAIR na matriz referenciada pelo membro pAdhocSupportedUcastAlgoPairs .

pAdhocSupportedUcastAlgoPairs

Um ponteiro para uma matriz de algoritmos de autenticação e criptografia com suporte na estação 802.11 para enviar e receber pacotes unicast em uma rede IBSS. Cada entrada na matriz é formatada como um DOT11_AUTH_CIPHER_PAIR estrutura.

uAdhocNumSupportedMcastAlgoPairs

O número de algoritmos de autenticação e criptografia compatíveis com a estação 802.11 para enviar e receber pacotes multicast e difusão quando configurados para operação em uma rede IBSS. O membro uAdhocNumSupportedMcastAlgoPairs deve ser o número de estruturas DOT11_AUTH_CIPHER_PAIR na matriz referenciada pelo membro pAdhocSupportedMcastAlgoPairs .

pAdhocSupportedMcastAlgoPairs

Um ponteiro para uma matriz de algoritmos de autenticação e criptografia com suporte na estação 802.11 para enviar e receber pacotes multicast e difusão em uma rede IBSS. Cada entrada na matriz é formatada como um DOT11_AUTH_CIPHER_PAIR estrutura.

bAutoPowerSaveMode

A capacidade de suporte da combinação de driver NIC/miniport para gerenciar o poço de energia de forma autônoma, incluindo a detecção e a negociação de Wi-Fi PSM (Modo de Salvamento de Energia) adequados entre o dispositivo e o ponto de acesso Wi-Fi. O NDIS 6.30 compatível com Wi-Fi drivers de miniporte deve definir esse membro como TRUE.

uMaxNetworkOffloadListSize

O número máximo de redes que um driver de miniporto pode descarregar, se ele tiver a capacidade de dar suporte à capacidade de descarregamento de lista de rede.

bMFPCapable

A capacidade de suporte do driver NIC/miniport para combinação para dar suporte à proteção de quadro de gerenciamento entre o dispositivo e o Wi-Fi Ponto de Acesso, conforme especificado na especificação 802.11w-2009. Defina como TRUE se houver suporte. Caso contrário, esse membro deverá ser definido como FALSE.

uInfraNumSupportedMcastMgmtAlgoPairs

O comprimento da matriz de pares de algoritmos de autenticação e criptografia apontados em pInfraSupportedMcastMgmtAlgoPairs.

pInfraSupportedMcastMgmtAlgoPairs

Um ponteiro para uma matriz de pares de algoritmos de autenticação e criptografia que o dispositivo dá suporte para MFP no modo Infra. A criptografia recomendada para Windows 8 é BIP com autenticação WPA ou WPA2. Cada entrada na matriz é formatada como um DOT11_AUTH_CIPHER_PAIR estrutura.

bNeighborReportSupported

bAPChannelReportSupported

bActionFramesSupported

bANQPQueryOffloadSupported

bHESSIDConnectionSupported

Comentários

O NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES estrutura contém um membro (pExtSTAAttributes) que especifica o endereço de uma estrutura DOT11_EXTSTA_ATTRIBUTES. Quando o driver de miniporto chama NdisMSetMiniportAttributes, o driver define o parâmetro MiniportAttributes 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 junto com a estrutura DOT11_EXTSTA_ATTRIBUTES.

Não há suporte para a imposição de MFPR (Proteção de Quadros de Gerenciamento) no Windows 8. Portanto, os drivers de miniporte nunca devem definir esse bit nos recursos RSN do RSN IE durante uma solicitação de associação. Para a política, o ponto de acesso pode anunciar a MFPR, que permitirá que a STA compatível com MFP associe. Os pontos de acesso que não dão suporte à funcionalidade MFP falharão na associação. Se o MFPR for definido por um ponto de acesso e o STA não for compatível com MFP, Windows 8 tratará a rede como incompatível com a funcionalidade e não enviará uma solicitação de associação para o miniporto.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível em Windows 8 e versões posteriores dos sistemas operacionais Windows.
Cabeçalho windot11.h (inclua Ndis.h)

Confira também

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

OID_DOT11_DESIRED_BSSID_LIST

OID_DOT11_EXCLUDED_MAC_ADDRESS_LIST

OID_DOT11_PMKID_LIST

OID_DOT11_DESIRED_SSID_LIST

DOT11_COUNTRY_OR_REGION_STRING

OID_DOT11_SAFE_MODE_ENABLED

OID_DOT11_PRIVACY_EXEMPTION_LIST

NDIS_OBJECT_HEADER

OID_DOT11_CIPHER_KEY_MAPPING_KEY

DOT11_AUTH_CIPHER_PAIR

DOT11_CIPHER_ALGORITHM

Chaves padrão por estação

NdisMSetMiniportAttributes

NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES

OID_DOT11_SCAN_REQUEST