WifiDeviceSetStationCapabilities-Funktion (wificx.h)
Die WifiDeviceSetStationCapabilities-Funktion legt die Stationsfunktionen für ein WiFiCx-Gerät fest.
Syntax
NTSTATUS WifiDeviceSetStationCapabilities(
WDFDEVICE Device,
const WIFI_STATION_CAPABILITIES *StationCapabilities
);
Parameter
Device
Ein Handle für ein Framework-Geräteobjekt, das der Clienttreiber aus einem vorherigen Aufruf von WdfDeviceCreate abgerufen 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 entsprechenden NTSTATUS-Fehlercode zurück.
Hinweise
Clienttreiber rufen in der Regel WifiDeviceSetStationCapabilities in EvtDevicePrepareHardware auf. Weitere Informationen finden Sie unter Erstellungsflow für Standardadapter (Station).
Rufen Sie WIFI_STATION_CAPABILITIES_INIT auf, um die WIFI_STATION_CAPABILITIES-Struktur zu initialisieren, und füllen Sie das Feld Größe aus. Rufen Sie dann WifiDeviceSetStationCapabilities auf, um die Stationsfunktionen an WiFiCx zu melden.
Um anzugeben, dass sekundäre Sta-Konnektivität beibehalten werden kann, muss der Treiber die Felder NumSecondaryStaBandCombinations und SecondaryStaBandsCombinations der WIFI_STATION_CAPABILITIES-Struktur auf Werte ungleich 0 festlegen. Wenn entweder der Wert 0 oder NULL ist, wird die sekundäre Sta-Funktion nicht festgelegt.
Um die Unterstützung für MLO-Verbindungen in Wi-Fi 7 anzugeben, muss der Treiber die Felder MaxMLOLinksSupported, MLOAddressesList, NumAkmsSupported und AkmsList der WIFI_STATION_CAPABILITIES-Struktur auf Werte ungleich Null festlegen.
Um SAE-Verbindungen mit AKM 24 oder AKM 8 mit GCMP-256-Verschlüsselung zu unterstützen, muss der Treiber die folgenden Authentifizierungs-Verschlüsselungspaare 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-Verschlüsselung zu unterstützen, muss der Treiber das folgende Authentifizierungs-Verschlüsselungspaar hinzufügen:
- In UnicastAlgorithmsList: { DOT11_AUTH_ALGO_OWE, DOT11_CIPHER_ALGO_GCMP_256 }
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 11 |
| Unterstützte Mindestversion (Server) | Windows Server 2022 |
| Kopfzeile | wificx.h |
| IRQL | PASSIVE_LEVEL |