structure DOT11_AUTH_CIPHER_PAIR_LIST (windot11.h)

  • Article
Important L’interface LAN sans fil Native 802.11 est déconseillée dans Windows 10 et versions ultérieures. Utilisez plutôt l’interface WDI (WLAN Device Driver Interface). Pour plus d’informations sur WDI, consultez Modèle de pilote Windows universel WLAN.
 
La structure DOT11_AUTH_CIPHER_PAIR_LIST définit une liste de structures DOT11_AUTH_CIPHER_PAIR.

Syntaxe

typedef struct DOT11_AUTH_CIPHER_PAIR_LIST {
  NDIS_OBJECT_HEADER     Header;
  ULONG                  uNumOfEntries;
  ULONG                  uTotalNumOfEntries;
  DOT11_AUTH_CIPHER_PAIR AuthCipherPairs[1];
} DOT11_AUTH_CIPHER_PAIR_LIST, *PDOT11_AUTH_CIPHER_PAIR_LIST;

Membres

Header

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

Taille

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

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

uNumOfEntries

Nombre d’entrées dans le tableau AuthCipherPairs .

uTotalNumOfEntries

Nombre maximal d’entrées que le tableau AuthCipherPairs peut contenir.

AuthCipherPairs[1]

Liste de DOT11_AUTH_CIPHER_PAIR structures.

Remarques

Un pilote miniport retourne la structure DOT11_AUTH_CIPHER_PAIR_LIST lorsqu’il est interrogé par l’un ou l’autre OID_DOT11_SUPPORTED_UNICAST_ALGORITHM_PAIR ou OID_DOT11_SUPPORTED_MULTICAST_ALGORITHM_PAIR.

Lorsque ces OID sont interrogés, le pilote miniport doit vérifier que le membre InformationBuffer du paramètre OidRequest de la fonction MiniportOidRequest est suffisamment grand pour renvoyer l’ensemble de la structure DOT11_AUTH_CIPHER_PAIR_LIST, y compris toutes les entrées du tableau AuthCipherPairs. La valeur du membre InformationBufferLength du paramètre OidRequest détermine ce que le pilote miniport doit faire, comme le montre la liste suivante :

  • Si la valeur du membre InformationBufferLength est inférieure à la longueur, en octets, de l’ensemble de la structure DOT11_AUTH_CIPHER_PAIR_LIST, le pilote miniport doit effectuer les opérations suivantes :
    • Pour le paramètre OidRequest , définissez le membre BytesWritten sur zéro et le membre BytesNeeded sur la longueur, en octets, de la structure DOT11_AUTH_CIPHER_PAIR_LIST entière.
    • Échec de la requête en retournant NDIS_STATUS_BUFFER_OVERFLOW à partir de sa fonction MiniportOidRequest .
  • Si la valeur du membre InformationBufferLength est supérieure ou égale à la longueur, en octets, de l’ensemble de la structure DOT11_AUTH_CIPHER_PAIR_LIST, le pilote miniport doit effectuer les opérations suivantes pour effectuer une requête réussie :
    • Pour la structure DOT11_AUTH_CIPHER_PAIR_LIST, définissez les membres uNumOfEntries et uTotalNumOfEntries sur le nombre total d’entrées dans le tableau AuthCipherPairs .
    • Pour le paramètre OidRequest , définissez le membre BytesNeeded sur zéro et le membre BytesWritten sur la longueur, en octets, de l’ensemble de la structure DOT11_AUTH_CIPHER_PAIR_LIST. Le pilote miniport doit également copier l’ensemble de la structure DOT11_AUTH_CIPHER_PAIR_LIST dans le membre InformationBuffer .
    • Retourne NDIS_STATUS_SUCCESS à partir de sa fonction MiniportOidRequest .
À compter de Windows 7, un pilote miniport 802.11 peut signaler n’importe quelle combinaison de paires d’algorithmes d’authentification et de chiffrement prises en charge dans DOT11_AUTH_CIPHER_PAIR_LIST. Toutefois, si le système d’exploitation démarre Soft AP, il active uniquement l’algorithme d’authentification DOT11_AUTH_ALGO_RSNA_PSK et l’algorithme de chiffrement DOT11_CIPHER_ALGO_CCMP . Pour prendre en charge soft AP, le pilote miniport doit prendre en charge cette paire d’authentification/chiffrement.

Si WPS est activé sur une carte réseau qui fonctionne en mode d’accès extensible, le pilote miniport doit autoriser les stations homologues à s’associer à l’AP extensible à l’aide d’algorithmes d’authentification du système ouvert ou weP (Wired Equivalent Privacy), quels que soient les algorithmes d’autorisation et de chiffrement activés. Pour plus d’informations sur WPS et l’AP extensible, consultez OID_DOT11_WPS_ENABLED.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible dans Windows Vista et les versions ultérieures des systèmes d’exploitation Windows.
En-tête windot11.h (inclure Ndis.h)

Voir aussi

OID_DOT11_SUPPORTED_UNICAST_ALGORITHM_PAIR OID_DOT11_SUPPORTED_MULTICAST_ALGORITHM_PAIR

DOT11_AUTH_CIPHER_PAIR

NDIS_OBJECT_HEADER