структура WWAN_READY_INFO (wwan.h)

Статья
08/08/2023

Структура WWAN_READY_INFO представляет состояние готовности устройства в МБ.

Синтаксис

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;
  ULONG               StatusFlags;
  ULONG               SlotId;
  WWAN_LIST_HEADER    TNListHeader;
} WWAN_READY_INFO, *PWWAN_READY_INFO;

Члены

ReadyState

Состояние готовности устройства.

EmergencyMode

Аварийный режим устройства. Дополнительные сведения см. в разделе WWAN_EMERGENCY_MODE.

SubscriberId[WWAN_SUBSCRIBERID_LEN]

Строка цифр, завершающаяся значением NULL, представляющая удостоверение подписчика.

Для устройств на основе GSM этот элемент представляет строку imsi (до 15 цифр в длину).

Для устройств на основе CDMA это строка мобильного идентификационного номера (MIN) или строка INTERNATIONAL Roaming MIN (IRM) (длина 10 цифр).

Драйверы мини-порта должны указывать эту строку, когда состояние готовности устройства изменится на WwanReadyStateInitialized. Драйверы miniport также должны указывать эту строку, когда состояние готовности устройства изменяется на WwanReadyStateBadSim, WwanReadyStateFailure или WwanReadyStateDeviceLocked, если это возможно, для целей идентификации.

Для многомодовых функций с одним оператором необходимо использовать формат Идентификатора подписчика GSM. Это не относится к многомодежимным функциям с несколькими операторами, так как идентификатор подписчика может измениться.

SimIccId[WWAN_SIMICCID_LEN]

Строка цифр, заканчивающаяся null, которая представляет идентификатор международной карты схемы (ICC) SIM-карты. Идентификатор ICC имеет длину от 15 до 20 цифр и представлен буквенно-цифровыми символами. Драйверы мини-порта должны указывать эту строку, когда состояние готовности устройства изменяется на WwanReadyStateInitialized , а также когда устройство заблокировано, ожидая ввода пин-кода 1 и ключа PUK1.

Драйверы мини-портов должны указывать это значение для всех устройств, где WwanCellularClass равно WwanCellularClassGsm. Драйверы мини-портов устройств на основе CDMA должны указывать это значение для устройств, где SimClass равно WwanSimClassSimRemovable.

CdmaShortMsgSize

Длина символа SMS, поддерживаемая сетью или устройством, в зависимости от того, что меньше, если устройство основано на CDMA.

Устройства на основе CDMA, поддерживающие SMS, должны указывать максимальную длину символов SMS для конкретного оператора, чтобы она была больше WWAN_CDMA_SHORT_MSG_SIZE_UNKNOWN и меньше WWAN_CDMA_SHORT_MSG_SIZE_MAX.

Устройства на основе CDMA, которые не поддерживают SMS, должны задать для этого члена значение WWAN_CDMA_SHORT_MSG_SIZE_UNKNOWN.

Этот элемент не применяется к устройствам на основе СТАНДАРТА GSM. Драйверы минипорта для устройств на основе GSM должны указывать WWAN_CDMA_SHORT_MSG_SIZE_UNKNOWN.

StatusFlags

Флаги состояния SIM-карты.

Значение	Значение
WWAN_READY_STATUS_MASK_IS_ESIM 0x00000001	0: текущая SIM-карта не является eSIM. 1. Текущая SIM-карта является eSIM. Допустимо, только если параметр ReadyState имеет значение MBIMSubscriberReadyStateInitialized или MBIMSubscriberReadyStateNoEsimProfile.
WWAN_READY_STATUS_MASK_SIM_REMOVABILITY_KNOWN 0x00000002	0: возможность удаления SIM-карты неизвестна. 1. Съемные SIM-карты известны.
WWAN_READY_STATUS_MASK_SIM_FORMFACTOR 0x00000004	0: текущая SIM-карта внедрена. 1. Текущая SIM-карта является съемной. Допустимо, только если параметр ReadyState имеет значение MBIMSubscriberReadyStateInitialized, MBIMSubscriberReadyStateNoEsimProfile или MBIMSubscriberReadyStateDeviceLocked.
WWAN_READY_STATUS_MASK_SIM_SLOT_ACTIVE 0x00000008	0: указание поступило из текущего неактивного слота. 1: указание поступило из активного в настоящее время слота. Этот бит может быть задан независимо от бита WWAN_READY_STATUS_MASK_MASKS_IS_VALID.
WWAN_READY_STATUS_MASK_MASKS_IS_VALID 0x80000000	Указывает, являются ли другие биты состояния (кроме WWAN_READY_STATUS_MASK_SIM_SLOT_ACTIVE) недопустимыми. Если бит равен 0, другие биты недопустимы и должны игнорироваться. Если бит равен 1, остальные биты состояния являются допустимыми.

SlotId

Значение ULONG, указывающее идентификатор слота sim-карта.

TNListHeader

Список номеров телефонов , назначенных удостоверению подписчика.

Каждый элемент в списке представляет собой строку WCHAR с фиксированным размером WWAN_TN_LEN.

Каждое TN, хранящееся в элементе списка, имеет значение, заканчивающееся null.

В устройствах на основе GSM TN называются номером ISDN мобильной станции (MSISDN). На устройствах на основе CDMA они называются мобильными номерами каталогов (MDN).

Драйверы мини-порта не должны указывать это значение, пока состояние готовности устройства не изменится на WwanReadyStateInitialized.

Требования

Требование	Значение
Минимальная версия клиента	Доступно в Windows 7 и более поздних версиях Windows.
Верхняя часть	wwan.h (включая Wwan.h)

См. также раздел