WifiDeviceSetStationCapabilities-Funktion (wificx.h)
Die WifiDeviceSetStationCapabilities Funktion legt die Station-Funktionen für ein WiFiCx-Gerät fest.
Syntax
NTSTATUS WifiDeviceSetStationCapabilities(
WDFDEVICE Device,
const WIFI_STATION_CAPABILITIES *StationCapabilities
);
Parameter
Device
Ein Handle zu einem Framework-Geräteobjekt, das der Clienttreiber aus einem vorherigen Aufruf von WdfDeviceCreateabgerufen hat.
StationCapabilities
Ein Zeiger auf eine vom Clienttreiber zugewiesene und initialisierte WIFI_STATION_CAPABILITIES Struktur.
Rückgabewert
Gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt diese Funktion möglicherweise einen geeigneten NTSTATUS-Fehlercode zurück.
Bemerkungen
Clienttreiber rufen in der Regel WifiDeviceSetStationCapabilities in EvtDevicePrepareHardwareauf. Weitere Informationen finden Sie unter Erstellungsfluss des Standardadapters (Station).
Rufen Sie WIFI_STATION_CAPABILITIES_INIT auf, um die WIFI_STATION_CAPABILITIES Struktur zu initialisieren und das feld Größe auszufüllen. Rufen Sie dann WifiDeviceSetStationCapabilities auf, um Die Station-Funktionen an WiFiCx zu melden.
Um anzugeben, dass sekundäre Sta-Konnektivitätbeibehalten werden kann, muss der Treiber die NumSecondaryStaBandCombinations- und SecondaryStaBandsCombinations-Felder der WIFI_STATION_CAPABILITIES Struktur auf Nicht-Null-Werte festlegen. Wenn ein Wert 0 oder NULL-ist, wird die Funktion "Sekundäres Sta" nicht festgelegt.
Um die Unterstützung für MLO-Verbindungen in Wi-Fi 7 anzugeben, muss der Treiber die felder MaxMLOLinksSupported, MLOAddressesList, NumAkmsSupportedund AkmsList Felder der WIFI_STATION_CAPABILITIES Struktur auf Nicht-Null-Werte festlegen.
Um SAE-Verbindungen mit AKM 24 oder AKM 8 mit GCMP-256-Chiffre zu unterstützen, muss der Treiber die folgenden Authentifizierungschiffrepaare in der WIFI_STATION_CAPABILITIES-Struktur hinzufügen:
- In UnicastAlgorithmsList: { DOT11_AUTH_ALGO_WPA3_SAE, DOT11_CIPHER_ALGO_GCMP_256 }
- In MulticastMgmtAlgorithmsList: { DOT11_AUTH_ALGO_WPA3_SAE, DOT11_CIPHER_ALGO_GCMP_256 }
Um OWE-Verbindungen mit GCMP-256-Chiffre zu unterstützen, muss der Treiber das folgende Authentifizierungschiffrepaar hinzufügen:
- In UnicastAlgorithmsList: { DOT11_AUTH_ALGO_OWE, DOT11_CIPHER_ALGO_GCMP_256 }
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 11 |
| mindestens unterstützte Server- | Windows Server 2022 |
| Header- | wificx.h |
| IRQL- | PASSIVE_LEVEL |