structure DOT11_CIPHER_DEFAULT_KEY_VALUE (windot11.h)

Article
02/07/2025

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_CIPHER_DEFAULT_KEY_VALUE définit une clé de chiffrement par défaut ou une clé de chiffrement par station par défaut qui sera ajoutée ou supprimée des tables de clés sur la station 802.11. Pour plus d’informations sur ces types de clés de chiffrement, consultez 802.11 Types de clés de chiffrement.

Syntaxe

typedef struct DOT11_CIPHER_DEFAULT_KEY_VALUE {
  NDIS_OBJECT_HEADER     Header;
  ULONG                  uKeyIndex;
  DOT11_CIPHER_ALGORITHM AlgorithmId;
  DOT11_MAC_ADDRESS      MacAddr;
  BOOLEAN                bDelete;
  BOOLEAN                bStatic;
  USHORT                 usKeyLength;
  UCHAR                  ucKey[1];
} DOT11_CIPHER_DEFAULT_KEY_VALUE, *PDOT11_CIPHER_DEFAULT_KEY_VALUE;

Membres

Header

Type, révision et taille de la structure DOT11_CIPHER_DEFAULT_KEY_VALUE. 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 DOT11_CIPHER_DEFAULT_KEY_VALUE_REVISION_1.

Taille

Ce membre doit être défini sur sizeof(DOT11_CIPHER_DEFAULT_KEY_VALUE).

Pour plus d’informations sur ces membres, consultez NDIS_OBJECT_HEADER.

uKeyIndex

Index de la clé dans le tableau de clés par défaut de la station 802.11.

Pour les algorithmes de chiffrement 802.11 standard, uKeyIndex doivent être comprises entre 0 et 3. Pour un algorithme de chiffrement développé par un IHV, uKeyIndex peut être n’importe quelle valeur dans la plage définie par l’IHV.

Pour BIP uKeyIndex doit être 4 ou 5.

La norme IEEE 802.11-2012 définit les valeurs d’index de clé par défaut comprises entre 1 et 4. La valeur x spécifiée par ce membre est mappée à l’index de clé par défaut 802.11 (x + 1).

AlgorithmId

Valeur de l’algorithme de chiffrement qui utilise cette clé. Pour plus d’informations sur les valeurs des algorithmes de chiffrement, consultez DOT11_CIPHER_ALGORITHM.

Pour BIP, il doit être défini sur DOT11_CIPHER_ALGO_BIP pour prédéfinis le numéro de paquet IGTK initial.

Le pilote miniport doit ignorer ce membre si bDelete est TRUE.

MacAddr

Adresse MAC (Media Access Control), qui identifie la table de clés par défaut pour ajouter ou supprimer la clé.

Si l’objet dot11DesiredBSSType base d’informations de gestion (MIB) est défini sur dot11_BSS_type_infrastructure, la station 802.11 ajoute ou supprime la clé de la table de clés par défaut, quelle que soit la valeur du membre MacAddr. Si la clé est obtenue dynamiquement à partir du point d’accès (AP), la station est associée, le membre MacAddr contient l’adresse MAC de l’AP. Sinon, MacAddr aura une valeur de 0x000000000000.

Si l’objet dot11DesiredBSSType base d’informations de gestion (MIB) est défini sur dot11_BSS_type_independent, la station 802.11 doit ajouter ou supprimer la clé de la manière suivante :

Si la valeur de ce membre est 0x000000000000, la station 802.11 ajoute ou supprime la clé de la table de clés par défaut. Lorsque la carte réseau est en mode OP De point d’accès extensible (ExtAP), cette valeur est égale à zéro.
Si la valeur de ce membre est une adresse MAC monodiffusion valide, la station 802.11 ajoute ou supprime la clé de la table de clés par station par station par défaut pour la station homologue dans un réseau BSS (IBSS) indépendant avec une adresse MAC égale à la valeur de MacAddr.

Si une table de clés par station par défaut n’existe pas pour la valeur de MacAddr, la station 802.11 doit utiliser une table de clés par station par défaut inutilisée.

Pour plus d’informations sur l’objet dot11DesiredBSSType MIB, consultez OID_DOT11_DESIRED_BSS_TYPE.

bDelete

Valeur booléenne qui spécifie si le pilote miniport doit supprimer la clé par défaut.

Si la valeur est TRUE, le pilote miniport doit supprimer la clé par défaut référencée par uKeyIndex. Si la valeur est FALSE, le pilote miniport doit ajouter ou mettre à jour la clé par défaut référencée par uKeyIndex.

bStatic

Valeur booléenne qui spécifie si le pilote miniport doit supprimer la clé par défaut après une opération de connexion ou d’itinérance.

Si la valeur est FALSE, le pilote miniport doit supprimer la clé par défaut référencée par uKeyIndex chaque fois que la station 802.11 :

Se déconnecte du réseau BSS (Basic Service Set).
Se déplace vers un nouveau réseau BSS.
Se reconnecte au même réseau BSS.

Si la valeur est TRUE, la clé par défaut référencée par uKeyIndex ne doit pas être supprimée, sauf s’il s’agit de :

Supprimé explicitement par le biais d’une requête définie de OID_DOT11_CIPHER_DEFAULT_KEY.
Suppression implicite par le biais d’une requête de méthode de OID_DOT11_RESET_REQUEST.

usKeyLength

Longueur, en octets, du matériau de clé dans le tableau ucKey.

ucKey[*]

Matériau clé.

Si algorithmId est défini sur DOT11_CIPHER_ALGO_TKIP, le tableau ucKey définit le matériau de clé par le biais de la structure DOT11_KEY_ALGO_TKIP_MIC.

Si AlgorithmId est défini sur DOT11_CIPHER_ALGO_CCMP, le tableau ucKey définit le matériau clé par le biais de la structure DOT11_KEY_ALGO_CCMP.

Si AlgorithmId est défini sur DOT11_CIPHER_ALGO_BIP, le tableau ucKey définit le matériau clé par le biais de la structure DOT11_KEY_ALGO_BIP.

ucKey[1]

Matériau clé.

Si algorithmId est défini sur DOT11_CIPHER_ALGO_TKIP, le tableau ucKey définit le matériau de clé par le biais de la structure DOT11_KEY_ALGO_TKIP_MIC.

Si AlgorithmId est défini sur DOT11_CIPHER_ALGO_CCMP, le tableau ucKey définit le matériau clé par le biais de la structure DOT11_KEY_ALGO_CCMP.

Si AlgorithmId est défini sur DOT11_CIPHER_ALGO_BIP, le tableau ucKey définit le matériau clé par le biais de la structure DOT11_KEY_ALGO_BIP.

Remarques

Si le membre bDelete est TRUE, les membres suivants ne sont pas valides et doivent être ignorés :

bStatic
usKeyLength
ucKey

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)