DOT11_AUTH_CIPHER_PAIR_LIST Struktur (windot11.h)
Wichtig
WiFiCx- ist das neue Wi-Fi Treibermodell, das in Windows 11 veröffentlicht wurde. Es wird empfohlen, wiFiCx zu verwenden, um die neuesten Features nutzen zu können. Das WDI-Treibermodell befindet sich jetzt im Wartungsmodus und erhält nur Korrekturen mit hoher Priorität.
Die DOT11_AUTH_CIPHER_PAIR_LIST Struktur definiert eine Liste der DOT11_AUTH_CIPHER_PAIR Strukturen.
Syntax
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;
Angehörige
Header
Der Typ, die Überarbeitung und die Größe der DOT11_AUTH_CIPHER_PAIR_LIST Struktur. Dieses Element ist als NDIS_OBJECT_HEADER Struktur formatiert.
Der Miniporttreiber muss die Member Header- auf die folgenden Werte festlegen:
Art
Dieses Element muss auf NDIS_OBJECT_TYPE_DEFAULT festgelegt werden.
Revision
Dieses Element muss auf DOT11_AUTH_CIPHER_PAIR_LIST_REVISION_1 festgelegt werden.
Größe
Dieses Element muss auf sizeof(DOT11_AUTH_CIPHER_PAIR_LIST)festgelegt werden.
Weitere Informationen zu diesen Mitgliedern finden Sie unter NDIS_OBJECT_HEADER.
uNumOfEntries
Die Anzahl der Einträge im AuthCipherPairs Array.
uTotalNumOfEntries
Die maximale Anzahl von Einträgen, die die AuthCipherPairs Array enthalten können.
AuthCipherPairs[1]
Die Liste der DOT11_AUTH_CIPHER_PAIR Strukturen.
Bemerkungen
Ein Miniporttreiber gibt die DOT11_AUTH_CIPHER_PAIR_LIST Struktur zurück, wenn sie von einer der beiden Abfragen abgefragt wird. OID_DOT11_SUPPORTED_UNICAST_ALGORITHM_PAIR oder OID_DOT11_SUPPORTED_MULTICAST_ALGORITHM_PAIR.
Wenn diese OIDs abgefragt werden, muss der Miniporttreiber überprüfen, ob der InformationBuffer Mitglied des MiniportOidRequest-Funktionsparameters OidRequest Parameter groß genug ist, um die gesamte DOT11_AUTH_CIPHER_PAIR_LIST Struktur zurückzugeben, einschließlich aller Einträge in der AuthCipherPairs Arrays. Der Wert des InformationBufferLength Members des OidRequest Parameter bestimmt, was der Miniporttreiber tun muss, wie in der folgenden Liste dargestellt:
-
Wenn der Wert des InformationBufferLength- Members kleiner als die Länge der gesamten DOT11_AUTH_CIPHER_PAIR_LIST-Struktur ist, muss der Miniporttreiber folgendes ausführen:
- Legen Sie für den parameter OidRequest das element BytesWritten auf 0 und das BytesNeededed-Element auf die Länge der gesamten DOT11_AUTH_CIPHER_PAIR_LIST Struktur in Byte fest.
- Schlägt die Abfrageanforderung fehl, indem NDIS_STATUS_BUFFER_OVERFLOW von der MiniportOidRequest--Funktion zurückgegeben wird.
-
Wenn der Wert des InformationBufferLength Member größer oder gleich der Länge der gesamten DOT11_AUTH_CIPHER_PAIR_LIST-Struktur ist, muss der Miniporttreiber folgendes ausführen, um eine erfolgreiche Abfrageanforderung abzuschließen:
- Legen Sie für die DOT11_AUTH_CIPHER_PAIR_LIST Struktur die uNumOfEntries und uTotalNumOfEntries Member auf die Gesamtanzahl der Einträge im AuthCipherPairs Array fest.
- Legen Sie für den parameter OidRequest den BytesNeededed member auf null und das BytesWritten member auf die Länge der gesamten DOT11_AUTH_CIPHER_PAIR_LIST-Struktur fest. Der Miniporttreiber muss auch die gesamte DOT11_AUTH_CIPHER_PAIR_LIST Struktur in das InformationBuffer Member kopieren.
- Gibt NDIS_STATUS_SUCCESS aus der MiniportOidRequest--Funktion zurück.
Wenn WPS auf einer NIC aktiviert ist, die im Extensible AP-Modus ausgeführt wird, muss der Miniporttreiber Peerstationen erlauben, die mit der erweiterbaren AP zu verknüpfen, indem Open System Authentication oder Wired Equivalent Privacy (WEP) Algorithmen verwendet wird, unabhängig von den aktivierten Autorisierungs- und Verschlüsselungsalgorithmen. Weitere Informationen zu WPS und Extensible AP finden Sie unter OID_DOT11_WPS_ENABLED.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
| Header- | windot11.h (include Ndis.h) |