structure DOT11_EXTSTA_ATTRIBUTES (windot11.h)
Syntaxe
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;
Membres
Header
Type, révision et taille de la structure DOT11_EXTSTA_ATTRIBUTES . Ce membre est mis en forme en tant que structure NDIS_OBJECT_HEADER .
Le pilote miniport doit définir les membres de Header sur les valeurs suivantes.
Type
Ce membre doit être défini sur NDIS_OBJECT_TYPE_DEFAULT.
Révision
Ce membre doit être défini sur l’une des valeurs suivantes en fonction du système d’exploitation sur lequel le pilote est destiné à s’exécuter :
DOT11_EXTSTA_ATTRIBUTES_REVISION_1
Windows Vista
DOT11_EXTSTA_ATTRIBUTES_REVISION_2
Windows Vista avec Service Pack 1 (SP1) ou versions ultérieures des systèmes d’exploitation Windows
DOT11_EXTSTA_ATTRIBUTES_REVISION_3
Windows 8 ou versions ultérieures des systèmes d’exploitation Windows
Ces valeurs déterminent la façon dont le système d’exploitation interprète le membre bSafeModeImplemented .
Taille
Ce membre doit être défini sur sizeof(DOT11_EXTSTA_ATTRIBUTES).
Pour plus d’informations sur ces membres, consultez NDIS_OBJECT_HEADER.
uScanSSIDListSize
Nombre maximal d’identificateurs de jeu de services (SSID) pris en charge par la station 802.11 pour les opérations d’analyse. La station 802.11 doit prendre en charge une liste SSID d’au moins quatre entrées.
La liste SSID utilisée par la station 802.11 pour l’analyse est spécifiée lorsque OID_DOT11_SCAN_REQUEST est défini.
uDesiredBSSIDListSize
Nombre maximal d’entrées dans la liste souhaitée des identificateurs de jeu de services de base (BSSID) pris en charge par la station 802.11. La station 802.11 doit prendre en charge une liste BSSID avec au moins une entrée.
Pour plus d’informations sur la liste BSSID souhaitée, consultez OID_DOT11_DESIRED_BSSID_LIST.
uDesiredSSIDListSize
Nombre maximal d’entrées dans la liste SSID souhaitée prise en charge par la station 802.11. La station 802.11 doit prendre en charge une liste SSID souhaitée avec au moins une entrée.
Pour plus d’informations sur la liste SSID souhaitée, consultez OID_DOT11_DESIRED_SSID_LIST.
uExcludedMacAddressListSize
Nombre maximal d’entrées dans la liste d’adresses MAC exclue prise en charge par la station 802.11. La station 802.11 doit prendre en charge une liste d’adresses MAC exclue avec au moins quatre entrées.
Pour plus d’informations sur la liste d’adresses MAC exclue souhaitée, consultez OID_DOT11_EXCLUDED_MAC_ADDRESS_LIST.
uPrivacyExemptionListSize
Nombre maximal d’entrées dans la liste des exemptions de confidentialité prises en charge par la station 802.11. La station 802.11 doit appuyer une liste d’exemption de confidentialité comportant au moins une entrée.
Pour plus d’informations sur la liste des exemptions de confidentialité, consultez OID_DOT11_PRIVACY_EXEMPTION_LIST.
uKeyMappingTableSize
Nombre maximal de clés de mappage de clés de chiffrement prises en charge par la station 802.11. Il est recommandé que la station 802.11 prend en charge au moins 32 clés de mappage de clés.
Pour plus d’informations sur les clés de mappage de clés, consultez OID_DOT11_CIPHER_KEY_MAPPING_KEY.
uDefaultKeyTableSize
Nombre maximal de clés de chiffrement que la station 802.11 prend en charge pour les tables de clé par défaut et par station.
Pour les algorithmes de chiffrement 802.11 standard, la station 802.11 doit prendre en charge une taille de table d’au moins quatre clés de chiffrement. Pour les algorithmes de chiffrement développés par le fournisseur de matériel indépendant (IHV), la taille de la table peut être supérieure ou égale à quatre.
uWEPKeyValueMaxLength
Longueur maximale, en octets, d’une clé de chiffrement WEP prise en charge par la station 802.11.
Le tableau suivant répertorie les longueurs de clé minimale et maximale, en octets, pour les différentes valeurs de chiffrement WEP définies par DOT11_CIPHER_ALGORITHM.
| Chiffrement WEP | Longueur minimale de la clé | Longueur maximale de la clé |
|---|---|---|
| DOT11_CIPHER_ALGO_WEP40 | 5 | 5 |
| DOT11_CIPHER_ALGO_WEP104 | 13 | 13 |
| DOT11_CIPHER_ALGO_WEP | 13 | Toute longueur prise en charge par la station 802.11 |
uPMKIDCacheSize
Nombre maximal d’entrées dans le cache d’identificateur de clé master (PMKID) par paire pris en charge par la station 802.11.
Si la station 802.11 ne prend pas en charge un cache PMKID, le pilote miniport doit définir ce membre sur zéro. Sinon, la station 802.11 doit prendre en charge une taille de cache PMKID d’au moins trois entrées.
Pour plus d’informations sur le cache PMKID, consultez OID_DOT11_PMKID_LIST.
uMaxNumPerSTADefaultKeyTables
Nombre maximal de tables de clé de chiffrement par station par défaut prises en charge par la station 802.11. Il est recommandé que la station 802.11 prend en charge au moins 32 tables de clés de chiffrement par station par station.
Pour plus d’informations sur les tables de clés de chiffrement par défaut par station, consultez Clés par défaut par station.
bStrictlyOrderedServiceClassImplemented
Valeur booléenne qui, si elle est définie sur TRUE, spécifie que la station 802.11 prend en charge la classe de service StrictlyOrdered IEEE 802.11 pour la remise de paquets MSDU (Media Access Control).
Pour plus d’informations sur la classe de service StrictlyOrdered, reportez-vous à la clause 5.1.3 de la norme IEEE 802.11-2012.
ucSupportedQoSProtocolFlags
Ensemble d’indicateurs qui spécifient les protocoles de qualité de service (QoS) que la carte réseau implémente. Ce membre est égal à zéro ou à une combinaison de bits OU des indicateurs suivants :
DOT11_QOS_PROTOCOL_FLAG_WMM
La carte réseau implémente le protocole 802.11 WMM QoS.
DOT11_QOS_PROTOCOL_FLAG_11E
La carte réseau implémente le protocole QoS 802.11e.
bSafeModeImplemented
Fonctionnalité de prise en charge en mode sans échec de la combinaison de pilotes carte réseau/miniport. Le système d’exploitation interprète ce membre différemment en fonction de la valeur de Header.Revision :
Révision = DOT11_EXTSTA_ATTRIBUTES_REVISION_1
Le système d’exploitation interprète le membre bSafeModeImplemented comme une valeur booléenne. Si cette valeur est TRUE, la carte réseau implémente le mode de fonctionnement sans échec 802.11. Sinon, la valeur est FALSE.
Révision = DOT11_EXTSTA_ATTRIBUTES_REVISION_2 ou version ultérieure
Le système d’exploitation interprète le membre bSafeModeImplemented comme un champ bit avec les valeurs de bits possibles suivantes définies :
- Si le champ bit est défini sur DOT11_EXTSTA_ATTRIBUTES_SAFEMODE_OID_SUPPORTED sans autres bits définis, le pilote miniport implémente le mode de fonctionnement sans échec 802.11.
- Si le champ bit est défini sur DOT11_EXTSTA_ATTRIBUTES_SAFEMODE_CERTIFIED, la combinaison carte réseau/miniport a reçu un certificat de validation du National Institute of Standards and Technology (NIST) sous la publication FIPS (Federal Information Processing Standards) 140-2, Exigences de sécurité pour les modules de chiffrement.
uNumSupportedCountryOrRegionStrings
Nombre de chaînes de pays ou de régions prises en charge par la station 802.11. Si la station 802.11 prend en charge plusieurs domaines réglementaires comme spécifié par la norme IEEE 802.11d-2001, chaque chaîne de pays ou de région identifie un domaine réglementaire pris en charge par la station 802.11.
Si la station 802.11 ne prend pas en charge la norme IEEE 802.11d-2001, le pilote miniport doit définir uNumSupportedCountryOrRegionStrings sur zéro.
pSupportedCountryOrRegionStrings
Pointeur vers un tableau de chaînes de pays ou de régions 802.11d prises en charge par la station 802.11. Chaque entrée du tableau est mise en forme en tant que DOT11_COUNTRY_OR_REGION_STRING structure.
uInfraNumSupportedUcastAlgoPairs
Nombre d’algorithmes d’authentification et de chiffrement pris en charge par la station 802.11 pour l’envoi et la réception de paquets unicast lorsqu’ils sont configurés pour fonctionner dans un réseau BSS (Infrastructure Basic Service Set). Le membre uInfraNumSupportedUcastAlgoPairs doit être le nombre de structures DOT11_AUTH_CIPHER_PAIR dans le tableau référencé par le membre pInfraSupportedUcastAlgoPairs .
pInfraSupportedUcastAlgoPairs
Pointeur vers un tableau d’algorithmes d’authentification et de chiffrement pris en charge par la station 802.11 pour l’envoi et la réception de paquets unicast dans un réseau BSS d’infrastructure. Chaque entrée du tableau est mise en forme en tant que DOT11_AUTH_CIPHER_PAIR structure.
uInfraNumSupportedMcastAlgoPairs
Nombre d’algorithmes d’authentification et de chiffrement pris en charge par la station 802.11 pour l’envoi et la réception de paquets de multidiffusion et de diffusion lorsqu’ils sont configurés pour fonctionner dans un réseau BSS (Infrastructure Basic Service Set). Le membre uInfraNumSupportedMcastAlgoPairs doit être le nombre de structures DOT11_AUTH_CIPHER_PAIR dans le tableau référencé par le membre pInfraSupportedMcastAlgoPairs .
pInfraSupportedMcastAlgoPairs
Pointeur vers un tableau d’algorithmes d’authentification et de chiffrement pris en charge par la station 802.11 pour l’envoi et la réception de paquets multidiffusion et de diffusion dans un réseau BSS d’infrastructure. Chaque entrée du tableau est mise en forme en tant que DOT11_AUTH_CIPHER_PAIR structure.
uAdhocNumSupportedUcastAlgoPairs
Nombre d’algorithmes d’authentification et de chiffrement pris en charge par la station 802.11 pour l’envoi et la réception de paquets unicast lorsqu’ils sont configurés pour fonctionner dans un réseau BSS (IBSS) indépendant. Le membre uAdhocNumSupportedUcastAlgoPairs doit être le nombre de structures DOT11_AUTH_CIPHER_PAIR dans le tableau référencé par le membre pAdhocSupportedUcastAlgoPairs .
pAdhocSupportedUcastAlgoPairs
Pointeur vers un tableau d’algorithmes d’authentification et de chiffrement pris en charge par la station 802.11 pour l’envoi et la réception de paquets unicast dans un réseau IBSS. Chaque entrée du tableau est mise en forme en tant que DOT11_AUTH_CIPHER_PAIR structure.
uAdhocNumSupportedMcastAlgoPairs
Nombre d’algorithmes d’authentification et de chiffrement pris en charge par la station 802.11 pour l’envoi et la réception de paquets multidiffusion et de diffusion lorsqu’ils sont configurés pour fonctionner dans un réseau IBSS. Le membre uAdhocNumSupportedMcastAlgoPairs doit être le nombre de structures DOT11_AUTH_CIPHER_PAIR dans le tableau référencé par le membre pAdhocSupportedMcastAlgoPairs .
pAdhocSupportedMcastAlgoPairs
Pointeur vers un tableau d’algorithmes d’authentification et de chiffrement pris en charge par la station 802.11 pour l’envoi et la réception de paquets de multidiffusion et de diffusion dans un réseau IBSS. Chaque entrée du tableau est mise en forme en tant que DOT11_AUTH_CIPHER_PAIR structure.
bAutoPowerSaveMode
Capacité de prise en charge de la combinaison de pilotes carte réseau/miniport pour gérer de manière autonome l’alimentation, y compris la détection et la négociation d'Wi-Fi un mode d’économie d’alimentation (PSM) approprié entre l’appareil et le point d’accès Wi-Fi. Les pilotes miniport conformes à NDIS 6.30 Wi-Fi doivent définir ce membre sur TRUE.
uMaxNetworkOffloadListSize
Nombre maximal de réseaux qu’un pilote miniport peut décharger, s’il peut prendre en charge la fonctionnalité de déchargement de liste réseau.
bMFPCapable
Capacité de prise en charge du pilote de carte réseau/miniport à combiner pour prendre en charge la protection des trames de gestion entre l’appareil et le point d’accès Wi-Fi, comme spécifié dans la spécification 802.11w-2009. Définissez sur TRUE si pris en charge. Sinon, ce membre doit avoir la valeur FALSE.
uInfraNumSupportedMcastMgmtAlgoPairs
Longueur du tableau des paires d’algorithmes d’authentification et de chiffrement pointées dans pInfraSupportedMcastMgmtAlgoPairs.
pInfraSupportedMcastMgmtAlgoPairs
Pointeur vers un tableau de paires d’algorithmes d’authentification et de chiffrement que l’appareil prend en charge pour MFP en mode Infra. Le chiffrement recommandé pour Windows 8 est BIP avec authentification WPA ou WPA2. Chaque entrée du tableau est mise en forme en tant que DOT11_AUTH_CIPHER_PAIR structure.
bNeighborReportSupported
bAPChannelReportSupported
bActionFramesSupported
bANQPQueryOffloadSupported
bHESSIDConnectionSupported
Remarques
The NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES structure contient un membre (pExtSTAAttributes) qui spécifie l’adresse d’une structure DOT11_EXTSTA_ATTRIBUTES. Lorsque le pilote miniport appelle NdisMSetMiniportAttributes, le pilote définit le paramètre MiniportAttributes sur l’adresse d’un bloc de mémoire alloué au pilote qui contient une structure NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES ainsi que la structure DOT11_EXTSTA_ATTRIBUTES.
L’application MFPR (Management Frame Protection Required) sur Windows 8 n’est pas prise en charge. Par conséquent, les pilotes miniport ne doivent jamais définir ce bit dans les fonctionnalités RSN de RSN IE lors d’une demande d’association. Pour la stratégie, le point d’accès peut publier mfpr qui permettra à sta compatible MFP d’associer. L’association des points d’accès ne prenant pas en charge la fonctionnalité MFP échoue. Si MFPR est défini par un point d’accès et que STA n’est pas compatible avec MFP, Windows 8 traitera le réseau comme étant incompatible en termes de capacité et n’enverra pas de demande d’association au miniport.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible dans Windows 8 et versions ultérieures des systèmes d’exploitation Windows. |
| En-tête | windot11.h (inclure Ndis.h) |
Voir aussi
Mode d’opération de station extensible
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_ATTRIBUTESCommentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour