Freigeben über


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

Weitere Informationen

WIFI_STATION_CAPABILITIES

WIFI_STATION_CAPABILITIES_INIT

Standard(Station)-Adaptererstellungsflow