WWAN_READY_INFO結構 (wwan.h)

發行項
03/05/2024

WWAN_READY_INFO結構代表 MB 裝置的就緒狀態。

語法

typedef struct _WWAN_READY_INFO {
  WWAN_READY_STATE    ReadyState;
  WWAN_EMERGENCY_MODE EmergencyMode;
  WCHAR               SubscriberId[WWAN_SUBSCRIBERID_LEN];
  WCHAR               SimIccId[WWAN_SIMICCID_LEN];
  BYTE                CdmaShortMsgSize;
  ULONG               StatusFlags;
  ULONG               SlotId;
  WWAN_LIST_HEADER    TNListHeader;
} WWAN_READY_INFO, *PWWAN_READY_INFO;

成員

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，則其他狀態位有效。