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、WwanReadyStateFailureWwanReadyStateDeviceLocked(如果可能)时,微型端口驱动程序还应指定此字符串,以便进行标识。

对于单载波多模式函数,必须使用 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

另请参阅

WWAN_READY_INFO