WLAN_PHY_RADIO_STATE structure (wlanapi.h)

The WLAN_PHY_RADIO_STATE structure specifies the radio state on a specific physical layer (PHY) type.

Syntax

typedef struct _WLAN_PHY_RADIO_STATE {
  DWORD             dwPhyIndex;
  DOT11_RADIO_STATE dot11SoftwareRadioState;
  DOT11_RADIO_STATE dot11HardwareRadioState;
} WLAN_PHY_RADIO_STATE, *PWLAN_PHY_RADIO_STATE;

Members

dwPhyIndex

The index of the PHY type on which the radio state is being set or queried. The WlanGetInterfaceCapability function returns a list of valid PHY types.

dot11SoftwareRadioState

A DOT11_RADIO_STATE value that indicates the software radio state.

dot11HardwareRadioState

A DOT11_RADIO_STATE value that indicates the hardware radio state.

Remarks

The WLAN_PHY_RADIO_STATE structure is used with the WlanSetInterface function when the OpCode parameter is set to wlan_intf_opcode_radio_state.

The WLAN_PHY_RADIO_STATE structure is also used for notification by the media specific module (MSM) when the radio state changes. An application registers to receive MSM notifications by calling the WlanRegisterNotification function with the dwNotifSource parameter set to a value that includes WLAN_NOTIFICATION_SOURCE_MSM. For more information on these notifications, see the WLAN_NOTIFICATION_DATA structure and the WLAN_NOTIFICATION_MSM enumeration reference.

The radio state of a PHY is off if either dot11SoftwareRadioState or dot11HardwareRadioState member of the WLAN_PHY_RADIO_STATE structure is dot11_radio_state_off.

The hardware radio state cannot be changed by calling the WlanSetInterface function. The dot11HardwareRadioState member of the WLAN_PHY_RADIO_STATE structure is ignored when the WlanSetInterface function is called with the OpCode parameter set to wlan_intf_opcode_radio_state and the pData parameter points to a WLAN_PHY_RADIO_STATE structure.

The software radio state can be changed by calling the WlanSetInterface function.

Changing the software radio state of a physical network interface could cause related changes in the state of the wireless Hosted Network or virtual wireless adapter radio states. The PHYs of every virtual wireless adapter are linked. For more information, see the About the Wireless Hosted Network.

The radio state of a PHY is off if either the software radio state (dot11SoftwareRadioState member) or the hardware radio state (dot11HardwareRadioState member) is off.

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2008 [desktop apps only]
Header	wlanapi.h

See also

About the Wireless Hosted Network

DOT11_RADIO_STATE

WLAN_NOTIFICATION_DATA

WLAN_NOTIFICATION_MSM

WLAN_RADIO_STATE

WlanGetInterfaceCapability

WlanSetInterface