Поделиться через

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

  • Статья

Структура WWAN_READY_INFO_REV2_PRE2170 — это более ранняя версия структуры WWAN_READY_INFO до Windows 11.

Синтаксис

typedef struct _WWAN_READY_INFO_REV2_PRE2170 {
  WWAN_READY_STATE    ReadyState;
  WWAN_EMERGENCY_MODE EmergencyMode;
  WCHAR               SubscriberId[WWAN_SUBSCRIBERID_LEN];
  WCHAR               SimIccId[WWAN_SIMICCID_LEN];
  BYTE                CdmaShortMsgSize;
  ULONG               StatusFlags;
  WWAN_LIST_HEADER    TNListHeader;
} WWAN_READY_INFO_REV2_PRE2170, *PWWAN_READY_INFO_PRE2170;

Члены

ReadyState

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

EmergencyMode

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

SubscriberId[WWAN_SUBSCRIBERID_LEN]

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

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

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

Драйверы минипорта должны указывать эту строку, когда состояние готовности устройства изменится на WwanReadyStateInitialized. Драйверы мини-порта также должны указывать эту строку, когда состояние готовности устройства изменится на 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. Драйверы miniport устройств на основе 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, остальные биты состояния являются допустимыми.

TNListHeader

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

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

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

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

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

Требования

Требование Значение
Заголовок wwan.h

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

WWAN_READY_INFO