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 結尾的數位字串,代表 SIM 卡國際線路卡 () 識別碼。 ICC標識符的長度介於15到20位數之間,並以英數位元表示。 當裝置就緒狀態變更為 WwanReadyStateInitialized 時,以及裝置鎖定時,等待 PIN1 和 PUK1 密鑰進入時,迷你埠驅動程式必須指定此字串。
Miniport 驅動程式必須針對 WwanCellularClass 等於 WwanCellularClassGsm 的所有裝置指定此值。 CDMA 型裝置的迷你埠驅動程式必須針對 SimClass 等於 WwanSimClassSimRemovable 的裝置指定此值。
CdmaShortMsgSize
網路或裝置所支援的SMS字元長度,如果裝置是以CDMA為基礎,則為較少的字元長度。
支援SMS的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,則其他狀態位有效。 |
TNListHeader
指派給訂閱者身分識別的電話號碼 (TN) 清單。
清單中的每個元素都是 WCHAR 的字串,固定大小為 WWAN_TN_LEN。
儲存在清單元素中的每個 TN 都是 NULL 終止的值。
在 GSM 型裝置中,TN 稱為行動站 ISDN 號碼 (MSISDN) 。 在 CDMA 型裝置中,它們稱為行動目錄號碼 (MDN) 。
在裝置就緒狀態變更為 WwanReadyStateInitialized 之前,迷你埠驅動程式不應該指定此值。
規格需求
需求 | 值 |
---|---|
標頭 | wwan.h |