Expand Minimize

WWAN_READY_INFO structure

The WWAN_READY_INFO structure represents the ready-state of the MB device.

Syntax


typedef struct _WWAN_READY_INFO {
  WWAN_READY_STATE    ReadyState;
  WWAN_EMERGENCY_MODE EmergencyMode;
  WCHAR               SubscriberId[WWAN_SUBSCRIBERID_LEN];
  WCHAR               SimIccId[WWAN_SIMICCID_LEN];
  BYTE                CdmaShortMsgSize;
  WWAN_LIST_HEADER    TNListHeader;
} WWAN_READY_INFO, *PWWAN_READY_INFO;

Members

ReadyState

The ready-state of the device.

EmergencyMode

The emergency mode of the device. For more information, see WWAN_EMERGENCY_MODE.

SubscriberId

A NULL-terminated string of digits that represents the identity of the subscriber.

For GSM-based devices, this member represents the International Mobile Subscriber Identity (IMSI) string (up to 15 digits in length).

For CDMA-based devices, this represents the Mobile Identification Number (MIN) string or the International Roaming MIN (IRM) string (both 10 digits in length).

Miniport drivers must specify this string when the device ready-state changes to WwanReadyStateInitialized. Miniport drivers should also specify this string when the device ready-state changes to WwanReadyStateBadSim, WwanReadyStateFailure, or WwanReadyStateDeviceLocked, if possible, for identification purposes.

For single-carrier multi-mode functions, the GSM SubscriberId format must be used. This does not apply to multi-carrier multi-mode functions as the SubscriberId may change.

SimIccId

A NULL-terminated string of digits that represents the International Circuit Card (ICC) ID of the SIM. The ICC ID varies from between 15 to 20 digits in length and is represented in alphanumeric characters. Miniport drivers must specify this string when the device ready-state changes to WwanReadyStateInitialized and also when the device is locked, waiting for entry of PIN1 and PUK1 keys.

Miniport drivers must specify this value for all devices where WwanCellularClass equals WwanCellularClassGsm. Miniport drivers of CDMA-based devices must specify this value for devices where SimClass equals WwanSimClassSimRemovable.

CdmaShortMsgSize

The SMS character length that is supported by the network or the device, whichever is less, if the device is CDMA-based.

CDMA-based devices that support SMS should specify their carrier-specific maximum SMS character length to be greater than WWAN_CDMA_SHORT_MSG_SIZE_UNKNOWN and less than WWAN_CDMA_SHORT_MSG_SIZE_MAX.

CDMA-based devices that do not support SMS should set this member to WWAN_CDMA_SHORT_MSG_SIZE_UNKNOWN.

This member does not apply to GSM-based devices. Miniport drivers of GSM-based devices should specify WWAN_CDMA_SHORT_MSG_SIZE_UNKNOWN.

TNListHeader

A list of telephone numbers (TNs) that are assigned to the subscriber identity.

Each element in the list is a string of WCHARs, with a fixed size of WWAN_TN_LEN.

Each TN stored in a list element is a NULL-terminated value.

In GSM-based devices the TNs are called Mobile Station ISDN Number (MSISDNs). In CDMA-based devices they are called Mobile Directory Numbers (MDNs).

Miniport drivers should not specify this value until the device ready-state changes to WwanReadyStateInitialized.

Requirements

Version

Available in Windows 7 and later versions of Windows.

Header

Wwan.h (include Wwan.h)

See also

WWAN_READY_STATE
WWAN_EMERGENCY_MODE
WWAN_LIST_HEADER
NDIS_WWAN_READY_INFO

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft