DOT11_CIPHER_ALGORITHM_LIST struttura (windot11.h)

Articolo
02/27/2024

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_CIPHER_ALGORITHM_LIST definisce un elenco di strutture DOT11_CIPHER_ALGORITHM che possono essere abilitate nella stazione 802.11.

Sintassi

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;

Members

Header

Tipo, revisione e dimensione della struttura DOT11_CIPHER_ALGORITHM_LIST. Questo membro viene formattato come struttura NDIS_OBJECT_HEADER .

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

Tipo

Questo membro deve essere impostato su NDIS_OBJECT_TYPE_DEFAULT.

Revisione

Questo membro deve essere impostato su DOT11_CIPHER_ALGORITHM_LIST_REVISION_1.

Dimensione

Questo membro deve essere impostato su sizeof(DOT11_CIPHER_ALGORITHM_LIST).

Per altre informazioni su questi membri, vedere NDIS_OBJECT_HEADER.

uNumOfEntries

Numero di voci nella matrice AlgorithmIds .

uTotalNumOfEntries

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

AlgorithmIds[1]

Algoritmo di crittografia, definito da un valore dell'enumeratore DOT11_CIPHER_ALGORITHM .

L'elenco degli algoritmi di crittografia viene ordinato in base alle preferenze. AlgorithmIds [0] definisce l'algoritmo di crittografia con la preferenza più alta.

Commenti

Un driver miniport restituisce la struttura DOT11_CIPHER_ALGORITHM_LIST quando viene eseguita una query da OID_DOT11_SUPPORTED_UNICAST_ALGORITHM_PAIR o OID_DOT11_SUPPORTED_MULTICAST_ALGORITHM_PAIR.

Quando questi OID vengono sottoposti a query, il driver miniport deve verificare che il membro InformationBuffer del parametro OidRequest della funzione MiniportOidRequest sia abbastanza grande per restituire l'intera struttura DOT11_CIPHER_ALGORITHM_LIST, incluse tutte le voci nella matrice AlgorithmIds. Il valore del membro InformationBufferLength del parametro OidRequest determina le operazioni del driver miniport, come illustrato nell'elenco seguente:

Se il valore del membro InformationBufferLength è minore della lunghezza, in byte, dell'intera struttura DOT11_CIPHER_ALGORITHM_LIST, il driver miniport deve eseguire le operazioni seguenti:
- Per il parametro OidRequest impostare il membro BytesScritto su zero e il membro ByteNeeded sulla lunghezza, in byte, dell'intera struttura DOT11_CIPHER_ALGORITHM_LIST.
- Eseguire l'errore della 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_CIPHER_ALGORITHM_LIST, il driver miniport deve eseguire le operazioni seguenti per completare una richiesta di query riuscita:
- Per la struttura DOT11_CIPHER_ALGORITHM_LIST, impostare i membri uNumOfEntries e uTotalNumOfEntries sul numero totale di voci nella matrice AlgorithmIds.
- Per il parametro OidRequest impostare il membro BytesNeeded su zero e il membro ByteScritto sulla lunghezza, in byte, dell'intera struttura DOT11_CIPHER_ALGORITHM_LIST. Il driver miniport deve anche copiare l'intera struttura DOT11_CIPHER_ALGORITHM_LIST nel membro InformationBuffer .
- Restituire NDIS_STATUS_SUCCESS dalla funzione MiniportOidRequest .