WifiDeviceSetStationCapabilities function (wificx.h)

Article
05/22/2024

The WifiDeviceSetStationCapabilities function sets the station capabilities for a WiFiCx device.

Syntax

NTSTATUS WifiDeviceSetStationCapabilities(
  WDFDEVICE                       Device,
  const WIFI_STATION_CAPABILITIES *StationCapabilities
);

Parameters

Device

A handle to a framework device object the client driver obtained from a previous call to WdfDeviceCreate.

StationCapabilities

A pointer to a client driver-allocated and initialized WIFI_STATION_CAPABILITIES structure.

Return value

Returns STATUS_SUCCESS if the operation succeeds. Otherwise, this function may return an appropriate NTSTATUS error code.

Remarks

Client drivers typically call WifiDeviceSetStationCapabilities within EvtDevicePrepareHardware. For more information see Default (station) adapter creation flow.

Call WIFI_STATION_CAPABILITIES_INIT to initialize the WIFI_STATION_CAPABILITIES structure and fill in its Size field. Then call WifiDeviceSetStationCapabilities to report station capabilities to WiFiCx.

To indicate the ability to maintain Secondary Sta connectivity, the driver must set the NumSecondaryStaBandCombinations and SecondaryStaBandsCombinations fields of the WIFI_STATION_CAPABILITIES structure to non-zero values. If either value is 0 or NULL, then the Secondary Sta capability will not be set.

To indicate support for MLO connections in Wi-Fi 7, the driver must set the MaxMLOLinksSupported, MLOAddressesList, NumAkmsSupported, and AkmsList fields of the WIFI_STATION_CAPABILITIES structure to non-zero values.

To support SAE connections using AKM 24 or AKM 8 with GCMP-256 cipher, the driver must add the following auth-cipher pairs in the WIFI_STATION_CAPABILITIES structure:

In UnicastAlgorithmsList: { DOT11_AUTH_ALGO_WPA3_SAE, DOT11_CIPHER_ALGO_GCMP_256 }
In MulticastMgmtAlgorithmsList: { DOT11_AUTH_ALGO_WPA3_SAE, DOT11_CIPHER_ALGO_GCMP_256 }

To support OWE connections with GCMP-256 cipher, the driver must add the following auth-cipher pair:

In UnicastAlgorithmsList: { DOT11_AUTH_ALGO_OWE, DOT11_CIPHER_ALGO_GCMP_256 }

Requirements

Requirement	Value
Minimum supported client	Windows 11
Minimum supported server	Windows Server 2022
Header	wificx.h
IRQL	PASSIVE_LEVEL

Share via