WWAN_READY_INFO 構造体 (wwan.h)

  • [アーティクル]

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]

サブスクライバーの ID を表す、NULL で終わる数字の文字列。

GSM ベースのデバイスの場合、このメンバーは国際モバイル サブスクライバー ID (IMSI) 文字列 (最大 15 桁の長さ) を表します。

CDMA ベースのデバイスの場合、これはモバイル識別番号 (MIN) 文字列または国際ローミング MIN (IRM) 文字列 (両方とも 10 桁の長さ) を表します。

ミニポート ドライバーは、デバイスの準備完了状態が WwanReadyStateInitialized に変更されたときに、この文字列を指定する必要があります。 ミニポート ドライバーは、デバイスの準備完了状態が WwanReadyStateBadSim、 WwanReadyStateFailure、または WwanReadyStateDeviceLocked に変更された場合にも、この文字列 を指定する必要があります(可能な場合は識別目的)。

シングルキャリアマルチモード関数の場合は、GSM SubscriberId 形式を使用する必要があります。 SubscriberId が変更される可能性があるため、マルチキャリア マルチモード関数には適用されません。

SimIccId[WWAN_SIMICCID_LEN]

SIM の国際回線カード (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 の場合は、他の状態ビットが有効です。

SlotId

SIM カード スロット ID を指定する ULONG 値。

TNListHeader

サブスクライバー ID に割り当てられている電話番号 (TN) の一覧。

リスト内の各要素は WCHAR の文字列であり、固定サイズのWWAN_TN_LEN。

リスト要素に格納されている各 TN は NULL で終わる値です。

GSM ベースのデバイスでは、TN はモバイル ステーション ISDN 番号 (MSISDN) と呼ばれます。 CDMA ベースのデバイスでは、モバイル ディレクトリ番号 (MDN) と呼ばれます。

ミニポート ドライバーは、デバイスの準備完了状態が WwanReadyStateInitialized に変わるまで、この値を指定しないでください。

要件

要件 値
サポートされている最小のクライアント Windows 7 以降のバージョンの Windows で使用できます。
Header wwan.h (Wwan.h を含む)

こちらもご覧ください

NDIS_WWAN_READY_INFO

WWAN_EMERGENCY_MODE

WWAN_LIST_HEADER

WWAN_READY_STATE