WWAN_RADIO_STATE structure

The WWAN_RADIO_STATE structure represents the hardware-based and software-based radio power states of the MB device.

Syntax


typedef struct _WWAN_RADIO_STATE {
  WWAN_RADIO HwRadioState;
  WWAN_RADIO SwRadioState;
} WWAN_RADIO_STATE, *PWWAN_RADIO_STATE;

Members

HwRadioState

The hardware radio power state of the device. The MB Service cannot set this state because it is read-only. The following table shows the possible values for this member.

ValueMeaning

WwanRadioOff

The hardware radio is off.

WwanRadioOn

The hardware radio is on, or no switch exists to control power to the hardware radio.

 

SwRadioState

The software-based radio power state of the device. The MB Service can get and set this state. The following table shows the possible values for this member.

ValueMeaning

WwanRadioOff

The radio is turned off by Windows.

WwanRadioOn

The radio is turned on by Windows.

 

Remarks

Miniport drivers should continue the software-based radio power state across system restart or device removal and reinsertion. Miniport drivers should store the device software-based radio power state information and use it to set the device radio power state for each restart or reinsertion of the device.

The following table defines the relationship between hardware-based and software-based radio power state settings and their effective result.

HwRadioState valueSwRadioState valueOverall radio power state

WwanRadioOff

WwanRadioOff

WwanRadioOff

WwanRadioOff

WwanRadioOn

WwanRadioOff

WwanRadioOn

WwanRadioOff

WwanRadioOff

WwanRadioOn

WwanRadioOn

WwanRadioOn

 

The miniport driver should send all applicable status indications such as NDIS_STATUS_WWAN_CONTEXT_STATE, NDIS_STATUS_WWAN_PACKET_SERVICE, and NDIS_STATUS_WWAN_REGISTER_STATE whenever the effective radio state changes from WwanRadioOn to WwanRadioOff or from WwanRadioOff to WwanRadioOn.

Requirements

Version

Available in Windows 7 and later versions of Windows.

Header

Wwan.h (include Wwan.h)

See also

WWAN_RADIO
NDIS_WWAN_RADIO_STATE

 

 

Send comments about this topic to Microsoft

Show: