WifiDeviceSetStationCapabilities function (wificx.h)
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 |