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.

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.

Requirements

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

See also

WIFI_STATION_CAPABILITIES

Default (station) adapter creation flow