structure DOT11_EXTSTA_ATTRIBUTES (windot11.h)
Important
WiFiCx est le nouveau modèle de pilote Wi-Fi publié dans Windows 11. Nous vous recommandons d’utiliser WiFiCx pour tirer parti des dernières fonctionnalités. Le modèle de pilote WDI est désormais en mode maintenance et ne reçoit que des correctifs de priorité élevée.
La structure DOT11_EXTSTA_ATTRIBUTES définit les attributs physiques et d’exploitation du pilote miniport et de la station 802.11 lors de l’exploitation en mode ExtSTA (Extensible Station). Pour plus d’informations sur ce mode d’opération, consultez mode d’opération de station extensible.
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 l’en-tête 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
Versions windows 8 ou ultérieures des systèmes d’exploitation Windows
Ces valeurs déterminent comment le système d’exploitation interprète le membre bSafeModeImplemented.
Taille
Ce membre doit être défini sur taille de(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éfinie.
uDesiredBSSIDListSize
Nombre maximal d’entrées dans la liste souhaitée d’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 d’exemption de confidentialité prise en charge par la station 802.11. La station 802.11 doit prendre en charge une liste d’exemption de confidentialité avec au moins une entrée.
Pour plus d’informations sur la liste d’exemption 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és 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 de quatre ou plus.
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é minimales et maximales, en octets, pour les différentes valeurs de chiffrement WEP définies via 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 PMKID (Pairwise Master Key Identifier) 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és de chiffrement par station 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 défaut.
Pour plus d’informations sur les tables de clés de chiffrement par station par défaut, consultez Per-Station clés par défaut.
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 IEEE 802.11 StrictlyOrdered pour la distribution 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) implémentés par la carte réseau. Ce membre est égal à zéro ou à une combinaison OR au niveau du bit des indicateurs suivants :
DOT11_QOS_PROTOCOL_FLAG_WMM
La carte réseau implémente le protocole WMM QoS 802.11.
DOT11_QOS_PROTOCOL_FLAG_11E
La carte réseau implémente le protocole QoS 802.11e.
bSafeModeImplemented
Fonctionnalité de prise en charge du 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 valeur booléenne. Si cette valeur est TRUE, la carte réseau implémente le mode sans échec 802.11 de l’opération. 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 en tant que champ de bits avec les valeurs de bits possibles suivantes définies :
- Si le champ de bits est défini sur DOT11_EXTSTA_ATTRIBUTES_SAFEMODE_OID_SUPPORTED sans aucun autre bits défini, le pilote miniport implémente le mode sans échec 802.11 de l’opération.
- Si le champ de bits est défini sur DOT11_EXTSTA_ATTRIBUTES_SAFEMODE_CERTIFIED, la combinaison carte réseau/miniport a reçu un certificat de validation de l’Institut national des normes et technologies (NIST) sous la publication FIPS (Federal Information Processing Standards) publication 140-2, Security Requirements for Cryptographic Modules.
uNumSupportedCountryOrRegionStrings
Nombre de chaînes de pays ou de région 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 pris en charge par la station 802.11. Chaque entrée du tableau est mise en forme en tant que structure DOT11_COUNTRY_OR_REGION_STRING.
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 de monodiffusion lorsqu’ils sont configurés pour l’opération 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 de monodiffusion dans un réseau BSS d’infrastructure. Chaque entrée du tableau est mise en forme en tant que structure DOT11_AUTH_CIPHER_PAIR.
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 une opération 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 de multidiffusion et de diffusion dans un réseau BSS d’infrastructure. Chaque entrée du tableau est mise en forme en tant que structure DOT11_AUTH_CIPHER_PAIR.
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 de monodiffusion lorsqu’ils sont configurés pour l’opération 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 de monodiffusion dans un réseau IBSS. Chaque entrée du tableau est mise en forme en tant que structure DOT11_AUTH_CIPHER_PAIR.
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 de multidiffusion et de diffusion lorsqu’ils sont configurés pour l’opération 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 structure DOT11_AUTH_CIPHER_PAIR.
bAutoPowerSaveMode
La fonctionnalité de prise en charge de la combinaison de pilotes de carte réseau/miniport pour gérer de manière autonome l’alimentation, notamment la détection et la négociation d'Wi-Fi un mode d’enregistrement d’alimentation approprié (PSM) entre l’appareil et le point d’accès Wi-Fi. Les pilotes miniport compatibles NDIS 6.30 Wi-Fi doivent définir ce membre sur TRUE.
uMaxNetworkOffloadListSize
Le nombre maximal de réseaux qu’un pilote miniport peut décharger, s’il a la possibilité de 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 images 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 la valeur TRUE si elle est prise en charge. Dans le cas contraire, 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 d’authentification et de paire d’algorithmes de chiffrement pris en charge par l’appareil pour MFP en mode Infra. Le chiffrement recommandé pour Windows 8 est BIP avec l’authentification WPA ou WPA2. Chaque entrée du tableau est mise en forme en tant que structure DOT11_AUTH_CIPHER_PAIR.
bNeighborReportSupported
bAPChannelReportSupported
bActionFramesSupported
bANQPQueryOffloadSupported
bHESSIDConnectionSupported
Remarques
Le 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 à l’adresse d’un bloc de mémoire alloué par le pilote qui contient une structure NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES ainsi que la structure DOT11_EXTSTA_ATTRIBUTES.
L’application de la protection des images de gestion requise (MFPR) 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 d’IE RSN lors d’une demande d’association. Pour la stratégie, le point d’accès peut publier MFPR, ce qui permettra à l’agent STA compatible MFP d’associer. Les points d’accès ne prenant pas en charge la fonctionnalité MFP échouent. Si MFPR est défini par un point d’accès et que STA n’est pas compatible avec MFP, Windows 8 traite le réseau comme incompatible avec la fonctionnalité et n’envoie pas de demande d’association au miniport.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible dans Windows 8 et versions ultérieures des systèmes d’exploitation Windows. |
| d’en-tête | windot11.h (include 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_ATTRIBUTES