structure DOT11_AUTH_CIPHER_PAIR_LIST (windot11.h)
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 .
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) |