DOT11_CIPHER_ALGORITHM_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_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;
Angehörige
Header
Der Typ, die Überarbeitung und die Größe der DOT11_CIPHER_ALGORITHM_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_CIPHER_ALGORITHM_LIST_REVISION_1 festgelegt werden.
Größe
Dieses Element muss auf sizeof(DOT11_CIPHER_ALGORITHM_LIST) festgelegt werden.
Weitere Informationen zu diesen Mitgliedern finden Sie unter NDIS_OBJECT_HEADER.
uNumOfEntries
Die Anzahl der Einträge im AlgorithmIds Arrays.
uTotalNumOfEntries
Die maximale Anzahl von Einträgen, die die AlgorithmIds Array enthalten können.
AlgorithmIds[1]
Der Verschlüsselungsalgorithmus, der durch einen DOT11_CIPHER_ALGORITHM Enumerationswert definiert wird.
Die Liste der Verschlüsselungsalgorithmen wird nach Einstellung sortiert. AlgorithmIds [0] definiert den Verschlüsselungsalgorithmus mit der höchsten Einstellung.
Bemerkungen
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_PAIRabgefragt wird.
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_CIPHER_ALGORITHM_LIST Struktur zurückzugeben, einschließlich aller Einträge im AlgorithmIds Array. 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_CIPHER_ALGORITHM_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_CIPHER_ALGORITHM_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_CIPHER_ALGORITHM_LIST Struktur ist, muss der Miniporttreiber folgendes ausführen, um eine erfolgreiche Abfrageanforderung abzuschließen:
- Legen Sie für die DOT11_CIPHER_ALGORITHM_LIST-Struktur die uNumOfEntries und uTotalNumOfEntries-Member auf die Gesamtanzahl der Einträge im AlgorithmIds 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_CIPHER_ALGORITHM_LIST struktur fest. Der Miniporttreiber muss auch die gesamte DOT11_CIPHER_ALGORITHM_LIST Struktur in das InformationBuffer- element kopieren.
- Gibt NDIS_STATUS_SUCCESS aus der MiniportOidRequest--Funktion zurück.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar ab Windows Vista. |
| Header- | windot11.h (include Ndis.h) |
Siehe auch
OID_DOT11_SUPPORTED_UNICAST_ALGORITHM_PAIR