共用方式為


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時,Miniport 驅動程序必須指定此字串。 如果可能的話,當裝置就緒狀態變更為 WwanReadyStateBadSimWwanReadyStateFailure,或 WwanReadyStateDeviceLocked時,迷你埠驅動程式也應該指定此字符串。

對於單一電信業多模式函式,必須使用 GSM SubscriberId 格式。 這不適用於多航母多模式函式,因為 SubscriberId 可能會變更。

SimIccId[WWAN_SIMICCID_LEN]

NULL 終止的數位字串,代表 SIM 卡的國際線路卡 (ICC) 識別碼。 ICC標識符的長度介於15到20位數之間,並以英數位元表示。 當裝置就緒狀態變更為 WwanReadyStateInitialized,以及裝置鎖定時,等待 PIN1 和 PUK1 密鑰進入時,迷你埠驅動程式必須指定此字元串。

Miniport 驅動程式必須針對 WwanCellularClass 等於 WwanCellularClassGsm的所有裝置指定此值。 CDMA 型裝置的迷你埠驅動程式必須針對 SimClass 等於 WwanSimClassSimSimRemovable 的裝置指定此值。

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

指派給訂閱者身分識別的電話號碼清單。

清單中的每個元素都是 WCHAR 的字串,大小固定為 WWAN_TN_LEN。

儲存在清單元素中的每個 TN 都是 NULL 終止的值。

在 GSM 型裝置中,TN 稱為行動站 ISDN 號碼(MSISDN)。 在 CDMA 型裝置中,它們稱為行動目錄號碼(MDN)。

在裝置就緒狀態變更為 WwanReadyStateInitialized之前,迷你埠驅動程序不應該指定此值。

要求

要求 價值
標頭 wwan.h

另請參閱

WWAN_READY_INFO