OID_WDI_TASK_SET_RADIO_STATE (dot11wificxintf.h)

Important

This topic is part of the WiFiCx driver model. WiFiCx is the Wi-Fi driver model released in Windows 11. We recommend that you use WiFiCx to take advantage of the latest features. The previous Wi-Fi driver model WDI is in maintenance mode and will only receive high priority fixes.

OID_WDI_TASK_SET_RADIO_STATE is used to set the Wi-Fi radio state for the adapter.

Object Abort capable Default priority (host driver policy) Normal execution time (seconds)
Adapter No 1 1

The task must be completed only after the disconnect activity has been completed.

The IHV component may also send unsolicited indications about radio state changes to the host.

Before the host turns off the radio, it disconnects all peers and stops any Group Owner that is running. The adapter is not expected to remember the station/GO profile information across a radio OFF/ON transition.

Task parameters

TLV Multiple TLV instances allowed Optional Description
WDI_TLV_RADIO_STATE_PARAMETERS The desired state of the radio. If this set to 1, the radio is enabled. If this is set to 0, the radio is turned off.

Task completion indication

NDIS_STATUS_WDI_INDICATION_SET_RADIO_STATE_COMPLETE

Unsolicited indication

NDIS_STATUS_WDI_INDICATION_RADIO_STATUS

This indication is used to report changes in the radio state for the adapter. This is sent both when a software radio change is triggered by the host and when a hardware radio state change is detected by the adapter.

Requirements

Requirement Value
Minimum supported client Windows 11
Minimum supported server Windows Server 2022
Header dot11wificxintf.h