DOT11_CIPHER_ALGORITHM_LIST-Struktur (windot11.h)

Artikel
08/08/2023

Wichtig

Die native WLAN-Schnittstelle 802.11 ist in Windows 10 und höher veraltet. Verwenden Sie stattdessen die WLAN Device Driver Interface (WDI). Weitere Informationen zu WDI finden Sie unter Wlan Universal Windows driver model.

Die DOT11_CIPHER_ALGORITHM_LIST-Struktur definiert eine Liste der DOT11_CIPHER_ALGORITHM Strukturen, die auf der Station 802.11 aktiviert werden können.

Syntax

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;

Member

Header

Typ, Revision und Größe der DOT11_CIPHER_ALGORITHM_LIST-Struktur. Dieser Member ist als NDIS_OBJECT_HEADER-Struktur formatiert.

Der Miniporttreiber muss die Member von Header auf die folgenden Werte festlegen:

Typ

Dieser Member muss auf NDIS_OBJECT_TYPE_DEFAULT festgelegt werden.

Revision

Dieser Member muss auf DOT11_CIPHER_ALGORITHM_LIST_REVISION_1 festgelegt werden.

Size

Dieser Member muss auf sizeof(DOT11_CIPHER_ALGORITHM_LIST) festgelegt werden.

Weitere Informationen zu diesen Membern finden Sie unter NDIS_OBJECT_HEADER.

uNumOfEntries

Die Anzahl der Einträge im AlgorithmIds-Array .

uTotalNumOfEntries

Die maximale Anzahl von Einträgen, die das AlgorithmIds-Array enthalten kann.

AlgorithmIds[1]

Der Verschlüsselungsalgorithmus, der durch einen DOT11_CIPHER_ALGORITHM Enumeratorwert definiert wird.

Die Liste der Verschlüsselungsalgorithmen ist nach Präferenz sortiert. AlgorithmIds [0] definiert den Verschlüsselungsalgorithmus mit der höchsten Einstellung.

Hinweise

Ein Miniporttreiber gibt die DOT11_CIPHER_ALGORITHM_LIST-Struktur zurück, wenn sie von OID_DOT11_SUPPORTED_UNICAST_ALGORITHM_PAIR oder OID_DOT11_SUPPORTED_MULTICAST_ALGORITHM_PAIR abgefragt wird.

Wenn diese OIDs abgefragt werden, muss der Miniporttreiber überprüfen, ob der InformationBuffer-Member des OidRequest-Parameters der MiniportOidRequest-Funktion groß genug ist, um die gesamte DOT11_CIPHER_ALGORITHM_LIST-Struktur zurückzugeben, einschließlich aller Einträge im AlgorithmIds-Array. Der Wert des InformationBufferLength-Elements des OidRequest-Parameters bestimmt, was der Miniporttreiber tun muss, wie in der folgenden Liste gezeigt:

Wenn der Wert des InformationBufferLength-Elements kleiner als die Länge der gesamten DOT11_CIPHER_ALGORITHM_LIST-Struktur in Bytes ist, muss der Miniporttreiber die folgenden Schritte ausführen:
- Legen Sie für den OidRequest-Parameter das BytesWritten-Element auf Null und das BytesNeeded-Element auf die Länge der gesamten DOT11_CIPHER_ALGORITHM_LIST-Struktur in Bytes fest.
- Führen Sie einen Fehler für die Abfrageanforderung durch Zurückgeben von NDIS_STATUS_BUFFER_OVERFLOW von der MiniportOidRequest-Funktion aus.
Wenn der Wert des InformationBufferLength-Elements größer oder gleich der Länge (in Byte) der gesamten DOT11_CIPHER_ALGORITHM_LIST-Struktur ist, muss der Miniporttreiber die folgenden Schritte ausführen, um eine erfolgreiche Abfrageanforderung abzuschließen:
- Legen Sie für die DOT11_CIPHER_ALGORITHM_LIST-Struktur die Elemente uNumOfEntries und uTotalNumOfEntries auf die Gesamtzahl der Einträge im AlgorithmIds-Array fest.
- Legen Sie für den OidRequest-Parameter das BytesNeeded-Element auf 0 und das BytesWritten-Element auf die Länge der gesamten DOT11_CIPHER_ALGORITHM_LIST-Struktur in Bytes fest. Der Miniporttreiber muss auch die gesamte DOT11_CIPHER_ALGORITHM_LIST-Struktur in den InformationBuffer-Member kopieren.
- Gibt NDIS_STATUS_SUCCESS aus der MiniportOidRequest-Funktion zurück.