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
  Reserved

• DRS_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

See also

SYSTEM_RADIO_STATE

Send comments about this topic to Microsoft