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 SubscriberId 格式。 这不适用于多运营商多模式函数,因为 SubscriberId 可能会更改。
SimIccId[WWAN_SIMICCID_LEN]
以 NULL 结尾的数字字符串,表示国际线路卡 (ICC) SIM ID。 ICC ID 的长度介于 15 到 20 位之间,以字母数字字符表示。 当设备就绪状态更改为 WwanReadyStateInitialized 时,以及设备锁定(等待输入 PIN1 和 PUK1 密钥)时,微型端口驱动程序必须指定此字符串。
微型端口驱动程序必须为 WwanCellularClass 等于 WwanCellularClassGsm 的所有设备指定此值。 基于 CDMA 的设备微型端口驱动程序必须为 SimClass 等于 WwanSimClassSimRemovable 的设备指定此值。
CdmaShortMsgSize
网络或设备支持的短信字符长度,如果设备基于 CDMA,则以较小者为准。
支持短信的基于 CDMA 的设备应将其特定于运营商的最大短信字符长度指定为大于 WWAN_CDMA_SHORT_MSG_SIZE_UNKNOWN 且小于 WWAN_CDMA_SHORT_MSG_SIZE_MAX。
不支持短信的基于 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,则其他状态位有效。 |
TNListHeader
分配给订阅者标识的电话号码 (TN) 的列表。
列表中的每个元素都是一个 WCHAR 字符串,其固定大小为 WWAN_TN_LEN。
存储在列表元素中的每个 TN 都是以 NULL 结尾的值。
在基于 GSM 的设备中,TN 称为移动站 ISDN 号码 (MSISDN) 。 在基于 CDMA 的设备中,它们称为移动目录编号 (MDN) 。
在设备就绪状态更改为 WwanReadyStateInitialized 之前,微型端口驱动程序不应指定此值。
要求
要求 | 值 |
---|---|
Header | wwan.h |