NDIS_WWAN_RADIO_STATE structure (ndiswwan.h)

  • Article

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

Syntax

typedef struct _NDIS_WWAN_RADIO_STATE {
  NDIS_OBJECT_HEADER Header;
  WWAN_STATUS        uStatus;
  WWAN_RADIO_STATE   RadioState;
} NDIS_WWAN_RADIO_STATE, *PNDIS_WWAN_RADIO_STATE;

Members

Header

The header with type, revision, and size information about the NDIS_WWAN_RADIO_STATE structure. The MB Service sets the header with the values that are shown in the following table when it sends the data structure to the miniport driver for set operations. Miniport drivers must set the header with the same values when they send the data structure to the MB service.

Header submember Value
Type NDIS_OBJECT_TYPE_DEFAULT
Revision NDIS_WWAN_RADIO_STATE_REVISION_1
Size sizeof(NDIS_WWAN_RADIO_STATE)
 

For more information about these members, see NDIS_OBJECT_HEADER.

uStatus

The status of the radio state operation. The following table shows the possible values for this member.

Value Meaning
WWAN_STATUS_SUCCESS Radio state operation succeeded.
WWAN_STATUS_BUSY Radio state operation failed because the device is busy.
WWAN_STATUS_FAILURE Radio state operation failed.
WWAN_STATUS_NOT_INITIALIZED The operation failed because the device is in the process of initializing. Retry the operation after the ready-state of the device changes to WwanReadyStateInitialized.

RadioState

A formatted WWAN_RADIO_STATE object that represents the hardware-based and software-based radio power states of the device.

Remarks

The miniport driver must set the uStatus member to WWAN_STATUS_SUCCESS for unsolicited events (NDIS_STATUS_INDICATION::RequestId = 0).

Miniport drivers can set the uStatus member to WWAN_STATUS_SUCCESS if the current radio state is the same as the requested state.

Requirements

Requirement Value
Minimum supported client Available in Windows 7 and later versions of Windows.
Header ndiswwan.h (include Ndiswwan.h)

See also

NDIS_OBJECT_HEADER

WWAN_RADIO_STATE