structure DOT11_CIPHER_ALGORITHM_LIST (windot11.h)

Article
08/08/2023

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_CIPHER_ALGORITHM_LIST définit une liste de structures DOT11_CIPHER_ALGORITHM qui peuvent être activées sur la station 802.11.

Syntaxe

typedef struct DOT11_CIPHER_ALGORITHM_LIST {
  NDIS_OBJECT_HEADER     Header;
  ULONG                  uNumOfEntries;
  ULONG                  uTotalNumOfEntries;
  DOT11_CIPHER_ALGORITHM AlgorithmIds[1];
} DOT11_CIPHER_ALGORITHM_LIST, *PDOT11_CIPHER_ALGORITHM_LIST;

Membres

Header

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

Taille

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

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

uNumOfEntries

Nombre d’entrées dans le tableau AlgorithmIds .

uTotalNumOfEntries

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

AlgorithmIds[1]

Algorithme de chiffrement, qui est défini par une valeur d’énumérateur DOT11_CIPHER_ALGORITHM .

La liste des algorithmes de chiffrement est triée par préférence. AlgorithmIds [0] définit l’algorithme de chiffrement avec la préférence la plus élevée.

Remarques

Un pilote miniport retourne la structure DOT11_CIPHER_ALGORITHM_LIST lorsqu’elle est interrogée par 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_CIPHER_ALGORITHM_LIST, y compris toutes les entrées du tableau AlgorithmIds. 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_CIPHER_ALGORITHM_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 l’ensemble de la structure DOT11_CIPHER_ALGORITHM_LIST.
- É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_CIPHER_ALGORITHM_LIST, le pilote miniport doit effectuer les opérations suivantes pour effectuer une demande de requête réussie :
- Pour la structure DOT11_CIPHER_ALGORITHM_LIST, définissez les membres uNumOfEntries et uTotalNumOfEntries sur le nombre total d’entrées dans le tableau AlgorithmIds .
- Pour le paramètre OidRequest , définissez le membre BytesNeeded sur zéro et le membre BytesWritten sur la longueur, en octets, de la structure DOT11_CIPHER_ALGORITHM_LIST entière. Le pilote miniport doit également copier l’intégralité de la structure DOT11_CIPHER_ALGORITHM_LIST dans le membre InformationBuffer .
- Retourne NDIS_STATUS_SUCCESS à partir de sa fonction MiniportOidRequest .