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]
サブスクライバーの ID を表す NULL で終わる数字の文字列。
GSM ベースのデバイスの場合、このメンバーは国際モバイル サブスクライバー ID (IMSI) 文字列 (最大 15 桁の長さ) を表します。
CDMA ベースのデバイスの場合、これは Mobile Identification Number (MIN) 文字列または International Roaming MIN (IRM) 文字列 (両方とも 10 桁の長さ) を表します。
ミニポート ドライバーは、WwanReadyStateInitializedにデバイスの準備状態が変更されたときに、この文字列を指定する必要があります。 ミニポート ドライバーは、デバイスの準備完了状態が WwanReadyStateBadSim 、WwanReadyStateFailure、または WwanReadyStateDeviceLocked (可能な場合) に変更されたときにも、この文字列を指定する必要があります。
シングルキャリアマルチモード機能の場合、GSM SubscriberId 形式を使用する必要があります。 これは、SubscriberId が変更される可能性があるため、マルチキャリア マルチモード機能には適用されません。
SimIccId[WWAN_SIMICCID_LEN]
SIM の INTERNATIONAL Circuit Card (ICC) ID を表す NULL で終わる数字の文字列。 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未満に指定する必要があります。
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
サブスクライバー ID に割り当てられている電話番号 (TN) の一覧。
リスト内の各要素は WCHAR の文字列であり、固定サイズのWWAN_TN_LEN。
リスト要素に格納されている各 TN は NULL で終わる値です。
GSM ベースのデバイスでは、TN はモバイル ステーション ISDN 番号 (MSISDN) と呼ばれます。 CDMA ベースのデバイスでは、モバイル ディレクトリ番号 (MDN) と呼ばれます。
ミニポート ドライバーは、デバイスの準備完了状態が WwanReadyStateInitialized に変わるまで、この値指定しないでください。
必要条件
要件 | 価値 |
---|---|
ヘッダー | wwan.h |