wwan.h) (WWAN_READY_INFO 结构

项目
02/27/2024

WWAN_READY_INFO结构表示 MB 设备的就绪状态。

语法

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) 字符串或国际漫游 MIN (IRM) 字符串 (长度为 10 位) 。

当设备就绪状态更改为 WwanReadyStateInitialized 时，微型端口驱动程序必须指定此字符串。如果可能，当设备就绪状态更改为 WwanReadyStateBadSim、 WwanReadyStateFailure 或 WwanReadyStateDeviceLocked 时，微型端口驱动程序还应指定此字符串，以便进行标识。

对于单载波多模式函数，必须使用 GSM SubscriberId 格式。这不适用于多运营商多模式函数，因为 SubscriberId 可能会更改。

SimIccId[WWAN_SIMICCID_LEN]

以 NULL 结尾的数字字符串，表示 SIM 卡的国际线路卡 (ICC) ID。 ICC ID 的长度介于 15 到 20 位之间，以字母数字字符表示。当设备就绪状态更改为 WwanReadyStateInitialized 时，微型端口驱动程序必须指定此字符串，并且当设备锁定时，必须等待输入 PIN1 和 PUK1 密钥。

微型端口驱动程序必须为 WwanCellularClass 等于 WwanCellularClassGsm 的所有设备指定此值。基于 CDMA 的设备微型端口驱动程序必须为 SimClass 等于 WwanSimClassSimRemovable 的设备指定此值。

CdmaShortMsgSize

网络或设备支持的 SMS 字符长度，如果设备基于 CDMA，则以较小者为准。

支持短信的基于 CDMA 的设备应将其特定于运营商的最大 SMS 字符长度指定为大于 WWAN_CDMA_SHORT_MSG_SIZE_UNKNOWN 且小于 WWAN_CDMA_SHORT_MSG_SIZE_MAX。

不支持 SMS 的基于 CDMA 的设备应将此成员设置为 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，则其他状态位有效。