WWAN_RADIO_STATE - NtDoc
Native API online documentation, based on the System Informer
(formerly Process Hacker) phnt
headers
// wwan.h
typedef struct _WWAN_RADIO_STATE {
WWAN_RADIO HwRadioState;
WWAN_RADIO SwRadioState;
} WWAN_RADIO_STATE, *PWWAN_RADIO_STATE;
View the official Windows Driver Kit DDI referenceNo description available.
The WWAN_RADIO_STATE structure represents the hardware-based and software-based radio power states of the MB device.
HwRadioStateThe 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.
| Value | Meaning |
|---|---|
| WwanRadioOff | The hardware radio is off. |
| WwanRadioOn | The hardware radio is on, or no switch exists to control power to the hardware radio. |
SwRadioStateThe 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.
| Value | Meaning |
|---|---|
| WwanRadioOff | The radio is turned off by Windows. |
| WwanRadioOn | The radio is turned on by Windows. |
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 value | SwRadioState value | Overall 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.