estrutura DOT11_EXTSTA_ATTRIBUTES (windot11.h)
Importante
WiFiCx é o novo modelo de driver Wi-Fi lançado no Windows 11. Recomendamos que você use o WiFiCx para aproveitar os recursos mais recentes. O modelo de driver WDI agora está no modo de manutenção e receberá apenas correções de alta prioridade.
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 ExtSTA (Estação Extensível). Para obter mais informações sobre esse modo de operação, consulte modo de operação extensível da 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 miniporto deve definir os membros do cabeçalho 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 deve 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 tamanhos de(DOT11_EXTSTA_ATTRIBUTES).
Para obter mais informações sobre esses membros, consulte NDIS_OBJECT_HEADER.
uScanSSIDListSize
O número máximo de SSIDs (identificadores de 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ída desejada, 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 codificada 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 criptografia 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 de hardware independente), 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.
| Codificação 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 mestra) no par suportado pela estação 802.11.
Se a estação 802.11 não der 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 criptografia 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 criptografia padrão por estação, consulte Per-Stationde Chaves Padrão.
bStrictlyOrderedServiceClassImplemented
Um valor booliano que, se definido como VERDADEIRO, especifica que a estação 802.11 dá suporte à entrega de pacotes da MSDU (unidade de dados de serviço) IEEE 802.11 StrictlyOrdered para entrega de pacotes msdu (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 QoS (qualidade de serviço) 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
A funcionalidade de suporte do modo de segurança 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 National Institute of Standards and Technology (NIST) em Federal Information Processing Standards (FIPS) Publication 140-2, Security Requirements for Cryptographic Modules.
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 der 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 criptografia compatíveis com a estação 802.11 para enviar e receber pacotes unicast quando configurado 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 pela 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 de transmissão quando configurado 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 pela estação 802.11 para enviar e receber pacotes multicast e de transmissã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 configurado 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 membro.
pAdhocSupportedUcastAlgoPairs
Um ponteiro para uma matriz de algoritmos de autenticação e criptografia com suporte pela 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 de transmissão quando configurado 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 pela estação 802.11 para enviar e receber pacotes multicast e de transmissã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 nic/miniport driver para gerenciar a energia de forma autônoma, incluindo a detecção e a negociação de Wi-Fi PSM (Power Save Mode) adequados entre o dispositivo e o ponto de acesso Wi-Fi. Os drivers de miniporto de Wi-Fi compatíveis com NDIS 6.30 devem 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 à funcionalidade de Descarregamento de Lista de Rede.
bMFPCapable
A funcionalidade de suporte do driver NIC/miniport para a combinação para dar suporte à proteção de quadro de gerenciamento entre o dispositivo e o ponto de acesso Wi-Fi, conforme especificado na especificação 802.11w-2009. Defina como TRUE se houver suporte. Caso contrário, esse membro deve ser definido como FALSE.
uInfraNumSupportedMcastMgmtAlgoPairs
O comprimento da matriz de pares de algoritmo de autenticação e criptografia apontado em pInfraSupportedMcastMgmtAlgoPairs.
pInfraSupportedMcastMgmtAlgoPairs
Um ponteiro para uma matriz de autenticação e par de algoritmos de 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
Observações
O NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES estrutura contém um membro (pExtSTAAttributes) que especifica o endereço de uma estrutura de DOT11_EXTSTA_ATTRIBUTES. Quando o driver de miniporto chama NdisMSetMiniportAttributes, o driver define o parâmetro MiniportAttributes para 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 a estrutura DOT11_EXTSTA_ATTRIBUTES.
Não há suporte para a imposição da MFPR (Proteção de Quadros de Gerenciamento) no Windows 8. Portanto, os drivers de miniporto 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 mfpr que permitirá que o STA compatível com MFP associe. Os pontos de acesso que não dão suporte à funcionalidade de MFP falharão na associação. Se a MFPR for definida por um ponto de acesso e o STA não for compatível com MFP, o 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 |
|---|---|
| de cliente com suporte mínimo | Disponível no Windows 8 e versões posteriores dos sistemas operacionais Windows. |
| cabeçalho | windot11.h (inclua Ndis.h) |
Consulte também
modo de operação da estação extensível
OID_DOT11_EXCLUDED_MAC_ADDRESS_LIST DOT11_COUNTRY_OR_REGION_STRING OID_DOT11_PRIVACY_EXEMPTION_LIST OID_DOT11_CIPHER_KEY_MAPPING_KEY NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES