struttura DOT11_AUTH_CIPHER_PAIR_LIST (windot11.h)

Articolo
08/08/2023

Importante L'interfaccia LAN wireless native 802.11 è deprecata in Windows 10 e versioni successive. Usare invece l'interfaccia WDI (WLAN Device Driver Interface). Per altre informazioni su WDI, vedere Modello di driver WINDOWS universale WLAN.

La struttura DOT11_AUTH_CIPHER_PAIR_LIST definisce un elenco di strutture DOT11_AUTH_CIPHER_PAIR.

Sintassi

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;

Members

Header

Tipo, revisione e dimensioni della struttura DOT11_AUTH_CIPHER_PAIR_LIST. Questo membro viene formattato come struttura NDIS_OBJECT_HEADER .

Il driver miniport deve impostare i membri di Header sui valori seguenti:

Tipo

Questo membro deve essere impostato su NDIS_OBJECT_TYPE_DEFAULT.

Revisione

Questo membro deve essere impostato su DOT11_AUTH_CIPHER_PAIR_LIST_REVISION_1.

Dimensione

Questo membro deve essere impostato su sizeof(DOT11_AUTH_CIPHER_PAIR_LIST).

Per altre informazioni su questi membri, vedere NDIS_OBJECT_HEADER.

uNumOfEntries

Numero di voci nella matrice AuthCipherPairs .

uTotalNumOfEntries

Numero massimo di voci che la matrice AuthCipherPairs può contenere.

AuthCipherPairs[1]

Elenco di DOT11_AUTH_CIPHER_PAIR strutture.

Commenti

Un driver miniport restituisce la struttura DOT11_AUTH_CIPHER_PAIR_LIST quando viene eseguita una query in uno dei due OID_DOT11_SUPPORTED_UNICAST_ALGORITHM_PAIR o OID_DOT11_SUPPORTED_MULTICAST_ALGORITHM_PAIR.

Quando vengono eseguite query su questi IDE, il driver miniport deve verificare che il membro InformationBuffer del parametro OidRequest della funzione MiniportOidRequest sia sufficientemente grande da restituire l'intera struttura DOT11_AUTH_CIPHER_PAIR_LIST, incluse tutte le voci nella matrice AuthCipherPairs. Il valore del membro InformationBufferLength del parametro OidRequest determina le operazioni che il driver miniport deve eseguire, come illustrato nell'elenco seguente:

Se il valore del membro InformationBufferLength è minore della lunghezza, espressa in byte, dell'intera struttura DOT11_AUTH_CIPHER_PAIR_LIST, il driver miniport deve eseguire le operazioni seguenti:
- Per il parametro OidRequest , impostare il membro BytesWritten su zero e il membro BytesNeeded sulla lunghezza, in byte, dell'intera struttura DOT11_AUTH_CIPHER_PAIR_LIST.
- Interrompere la richiesta di query restituendo NDIS_STATUS_BUFFER_OVERFLOW dalla relativa funzione MiniportOidRequest .
Se il valore del membro InformationBufferLength è maggiore o uguale alla lunghezza, in byte, dell'intera struttura DOT11_AUTH_CIPHER_PAIR_LIST, il driver miniport deve eseguire le operazioni seguenti per completare una richiesta di query riuscita:
- Per la struttura DOT11_AUTH_CIPHER_PAIR_LIST, impostare i membri uNumOfEntries e uTotalNumOfEntries sul numero totale di voci nella matrice AuthCipherPairs .
- Per il parametro OidRequest , impostare il membro BytesNeeded su zero e il membro BytesWritten sulla lunghezza, in byte, dell'intera struttura DOT11_AUTH_CIPHER_PAIR_LIST. Il driver miniport deve anche copiare l'intera struttura DOT11_AUTH_CIPHER_PAIR_LIST nel membro InformationBuffer .
- Restituisce NDIS_STATUS_SUCCESS dalla funzione MiniportOidRequest .

A partire da Windows 7, un driver miniport 802.11 può segnalare qualsiasi combinazione di coppie di algoritmi di autenticazione e crittografia supportate in DOT11_AUTH_CIPHER_PAIR_LIST. Tuttavia, se il sistema operativo avvia Soft AP, abilita solo l'algoritmo di autenticazione DOT11_AUTH_ALGO_RSNA_PSK e l'algoritmo di crittografia DOT11_CIPHER_ALGO_CCMP . Per supportare soft AP, il driver miniport deve supportare questa coppia di autenticazione/crittografia.

Se WPS è abilitato in una scheda di interfaccia di rete che opera in modalità API estendibile, il driver miniport deve consentire alle stazioni peer di associarsi all'API Estendibile tramite algoritmi OPEN System Authentication o WEP (Wired Equivalent Privacy), indipendentemente dagli algoritmi di autorizzazione e crittografia abilitati. Per altre informazioni su WPS ed Extensible AP, vedere OID_DOT11_WPS_ENABLED.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows.
Intestazione	windot11.h (include Ndis.h)

Vedi anche

OID_DOT11_SUPPORTED_UNICAST_ALGORITHM_PAIR OID_DOT11_SUPPORTED_MULTICAST_ALGORITHM_PAIR

DOT11_AUTH_CIPHER_PAIR

NDIS_OBJECT_HEADER

Condividi tramite