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时,微型端口驱动程序必须指定此字符串。 当设备就绪状态更改为 WwanReadyStateBadSimWwanReadyStateFailureWwanReadyStateDeviceLocked(如果可能)时,微型端口驱动程序还应指定此字符串。

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

另请参阅

WWAN_READY_INFO