WWAN_READY_INFO_REV2_PRE2170结构(wwan.h)
WWAN_READY_INFO_REV2_PRE2170 结构是 Windows 11 之前的旧版 WWAN_READY_INFO 结构。
语法
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 结尾的数字字符串,表示 SIM 卡的国际线路卡(ICC)ID。 ICC ID 的长度介于 15 到 20 位之间,以字母数字字符表示。 当设备就绪状态更改为 WwanReadyStateInitialized,以及设备锁定时,等待 PIN1 和 PUK1 密钥的输入时,微型端口驱动程序必须指定此字符串。
微型端口驱动程序必须为 WwanCellularClass 等于 WwanCellularClassGsm的所有设备指定此值。 基于 CDMA 设备的微型端口驱动程序必须为 SimClass 等于 WwanSimClassSimRemovable 的设备指定此值。
CdmaShortMsgSize
如果设备基于 CDMA,则网络或设备支持的 SMS 字符长度(以较小者为准)。
支持 SMS 的基于 CDMA 的设备应指定其特定于运营商的最大 SMS 字符长度,使其大于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之前,微型端口驱动程序不应指定此值。
要求
要求 | 价值 |
---|---|
标头 | wwan.h |