DEVICE_RADIO_STATE enumeration
The DEVICE_RADIO_STATE enumeration defines values that indicate the current state of software and hardware radio support for a specific device.
Syntax
typedef enum {
DRS_RADIO_ON = 0x0,
DRS_SW_RADIO_OFF = 0x1,
DRS_HW_RADIO_OFF = 0x2,
DRS_SW_HW_RADIO_OFF = 0x3,
DRS_HW_RADIO_ON_UNCONTROLLABLE = 0x4,
DRS_RADIO_INVALID = 0x5,
DRS_HW_RADIO_OFF_UNCONTROLLABLE = 0x6
} DEVICE_RADIO_STATE;
Constants
DRS_RADIO_ON
The device radio is "On". In this state the device is working, open to software control, and ready to make connection.DRS_SW_RADIO_OFF
The device radio is "Off". Transition to this state is the result of a programmatic call.DRS_HW_RADIO_OFF
The device radio is "Off". Transition to this state is accomplished via the hardware switch located on the device.DRS_SW_HW_RADIO_OFF
The device radio is "Off". Transition to this state is the result of a programmatic call and use of the hardware switch present on the device. Returning the device radio to the DRS_RADIO_ON state requires that another programmatic call and hardware switch flip take place.DRS_HW_RADIO_ON_UNCONTROLLABLE
The device radio is "On", but a state transition cannot be accomplished programmatically. Use of the hardware switch is required to transition the device radio to the DRS_HW_RADIO_UNCONTROLLABLE state.DRS_RADIO_INVALID
ReservedDRS_HW_RADIO_OFF_UNCONTROLLABLE
The device radio is "Off", but a state transition cannot be accomplished programmatically. Use of the hardware switch is required to transition the device radio to the DRS_RADIO_UNCONTROLLABLE state.
Remarks
The device radio states will be reported by the device driver to the service stack. If a device radio is not programmatically controllable by media radio manager, it is considered uncontrollable. If the radio manager passes an invalid radio state, the default radio state, DEVICE_RADIO_ON_UNCONTROLLABLE, is used.
Requirements
Minimum supported client |
Windows 8 |
Minimum supported server |
Windows Server 2012 |
See also