WWAN_DEVICE_CAPS構造体 (wwan.h)
WWAN_DEVICE_CAPS構造体は、MB デバイスの機能を表します。
構文
typedef struct _WWAN_DEVICE_CAPS {
WWAN_DEVICE_TYPE WwanDeviceType;
WWAN_CELLULAR_CLASS WwanCellularClass;
WWAN_VOICE_CLASS WwanVoiceClass;
WWAN_SIM_CLASS WwanSimClass;
ULONG WwanDataClass;
WCHAR CustomDataClass[WWAN_CUSTOM_DATA_CLASS_LEN];
ULONG WwanGsmBandClass;
ULONG WwanCdmaBandClass;
WCHAR CustomBandClass[WWAN_CUSTOM_BAND_CLASS_LEN];
ULONG WwanSmsCaps;
ULONG WwanControlCaps;
WCHAR DeviceId[WWAN_DEVICEID_LEN];
WCHAR Manufacturer[WWAN_MANUFACTURER_LEN];
WCHAR Model[WWAN_MODEL_LEN];
WCHAR FirmwareInfo[WWAN_FIRMWARE_LEN];
ULONG MaxActivatedContexts;
ULONG WwanAuthAlgoCaps;
WWAN_LIST_HEADER CellularClassListHeader;
} WWAN_DEVICE_CAPS, *PWWAN_DEVICE_CAPS;
メンバーズ
WwanDeviceType
デバイスの種類。 ミニポート ドライバーは、WwanDeviceTypeUnknown以外の値にデバイスの種類を設定する必要があります。
WwanCellularClass
デバイスの携帯ネットワーク クラス。 ミニポート ドライバーは、WwanCellularClassUnknown以外の値に携帯ネットワーク クラスを設定する必要があります。 このメンバーコントロール機能の値は、ネットワーク プロバイダーの登録モードなど、携帯ネットワーク テクノロジに固有です。
マルチモードをサポートするミニポート ドライバーは、これを WwanCellularClassGsm に設定する必要があります。
WwanVoiceClass
デバイスの音声クラス。 このメンバーは、回線音声サービスの存在と、そのようなサービスがデータ サービスと対話する方法について MB サービスに通知します。 MB サービスは、回線切り替え音声をネイティブにサポートせず、またそれを妨げません。 回線音声をサポートする方法は、ミニポート ドライバーによって決まります。 この WwanVoiceClass メンバーにより、MB サービスは今後この機能をサポートできます。
WwanSimClass
サブスクライバー ID モジュール (SIM カード) のクラス。 ミニポート ドライバーは、WwanSimClassUnknown以外の値に SIM クラスを設定する必要があります。
WwanDataClass
デバイスがサポートするデータ クラスを表すビットマップ。 次の表に、このメンバーに使用できる値を示します。
| 価値 | 意味 |
|---|---|
| WWAN_DATA_CLASS_NONE | デバイスはデータ サービスをサポートしていません。 |
| WWAN_DATA_CLASS_GPRS | 汎用パケット 無線サービス (GPRS) データ サービスがサポートされています。 この値は、GSM ベースのデバイスにのみ適用されます。 |
| WWAN_DATA_CLASS_EDGE | 拡張データ for Global Evolution (EDGE) データ サービスがサポートされています。 この値は、GSM ベースのデバイスにのみ適用されます。 |
| WWAN_DATA_CLASS_UMTS | ユニバーサル モバイル 通信システム (UMTS) データ サービスがサポートされています。 この値は、GSM ベースのデバイスにのみ適用されます。 |
| WWAN_DATA_CLASS_HSDPA | High-Speed ダウンリンク パケット アクセス (HSDPA) データ サービスがサポートされています。 この値は、GSM ベースのデバイスにのみ適用されます。 |
| WWAN_DATA_CLASS_HSUPA | High-Speed アップリンク パケット アクセス (HSUPA) データ サービスがサポートされています。 この値は、GSM ベースのデバイスにのみ適用されます。 |
| WWAN_DATA_CLASS_LTE | LTE データ サービスがサポートされています。 この値は、GSM ベースのデバイスにのみ適用されます。 |
| WWAN_DATA_CLASS_5G | 5G データ サービスがサポートされています。 |
| WWAN_DATA_CLASS_TDSCDMA | Time Division 同期 CDMA データ サービスがサポートされています。 |
| WWAN_DATA_CLASS_1XRTT | CDMA 1x 無線伝送テクノロジ (1xRTT、cdma2000、CDMA2000 1x など) データ サービスがサポートされています。 この値は、CDMA ベースのデバイスにのみ適用されます。 |
| WWAN_DATA_CLASS_1XEVDO | CDMA Evolution-Data 最適化 (元はデータのみ、1xEDVO、CDMA2000 1x EV-DO、または 1x EVDO とも呼ばれます) データ サービスがサポートされています。 この値は、CDMA ベースのデバイスにのみ適用されます。 |
| WWAN_DATA_CLASS_1XEVDO_REVA | 1xEVDO RevA データ サービスがサポートされています。 この値は、CDMA ベースのデバイスにのみ適用されます。 |
| WWAN_DATA_CLASS_1XEVDV | CDMA Evolution-Data/Voice (CDMA 2000 1x EV-DV または 1x EVDV とも呼ばれます) データ サービスがサポートされています。 この値は、CDMA ベースのデバイスにのみ適用されます。 |
| WWAN_DATA_CLASS_3XRTT | CDMA 3x 無線伝送技術 (3xRTT) データ サービスがサポートされています。 この値は、CDMA ベースのデバイスにのみ適用されます。 |
| WWAN_DATA_CLASS_1XEVDO_REVB | 1xEVDO RevB データ サービスがサポートされています。 この値は、CDMA ベースのデバイスにのみ適用されます。 |
| WWAN_DATA_CLASS_UMB | UMB データ サービスがサポートされています。 この値は、CDMA ベースのデバイスにのみ適用されます。 |
| WWAN_DATA_CLASS_CUSTOM | デバイスは、この表に記載されていないデータ サービスをサポートしています。 |
CustomDataClass[WWAN_CUSTOM_DATA_CLASS_LEN]
カスタム データ クラスの名前を表す NULL で終わる文字列。 このメンバーは、ミニポート ドライバーが WwanDataClass メンバーのWWAN_DATA_CLASS_CUSTOM ビットを設定する場合にのみ有効です。
WwanGsmBandClass
GSM ベースのデバイスがサポートする周波数帯を表すビットマップ。 次の表に、このメンバーに使用できる値を示します。
| 価値 | 意味 |
|---|---|
| WWAN_BAND_CLASS_UNKNOWN | デバイスでサポートされている周波数帯域は指定されていません。 |
| WWAN_BAND_CLASS_I | デバイスは、UMTS2100スペクトルをサポートします。 |
| WWAN_BAND_CLASS_II | デバイスは、UMTS1900スペクトルをサポートします。 |
| WWAN_BAND_CLASS_III | デバイスは、UMTS1800スペクトルをサポートします。 |
| WWAN_BAND_CLASS_IV | デバイスは AWS スペクトルをサポートします。 |
| WWAN_BAND_CLASS_V | デバイスは、UMTS850スペクトルをサポートします。 |
| WWAN_BAND_CLASS_VI | デバイスは、UMTS800スペクトルをサポートします。 |
| WWAN_BAND_CLASS_VII | デバイスは、UMTS2600スペクトルをサポートします。 |
| WWAN_BAND_CLASS_VIII | デバイスは、UMTS900スペクトルをサポートします。 |
| WWAN_BAND_CLASS_IX | デバイスは、UMTS1700スペクトルをサポートします。 |
| WWAN_BAND_CLASS_X | |
| WWAN_BAND_CLASS_CUSTOM | デバイスは、この表に記載されているもの以外のスペクトルをサポートしています。 |
ミニポート ドライバーがWWAN_BAND_CLASS_CUSTOMを指定する場合は、CustomBandClass でデータ クラスの名前 指定する必要があります。
これらの値の詳細については、OID_WWAN_DEVICE_CAPSを参照してください。
WwanCdmaBandClass
CDMA ベースのデバイスがサポートする周波数帯を表すビットマップ。 次の表に、このメンバーに使用できる値を示します。
| 価値 | 意味 |
|---|---|
| WWAN_BAND_CLASS_UNKNOWN | デバイスでサポートされている周波数帯域は指定されていません。 |
| WWAN_BAND_CLASS_0 | デバイスは 800MHz 帯域をサポートします。 |
| WWAN_BAND_CLASS_I | デバイスは 1900MHz 帯をサポートします。 |
| WWAN_BAND_CLASS_II | デバイスは TACS バンドをサポートします。 |
| WWAN_BAND_CLASS_III | デバイスは JTACS バンドをサポートします。 |
| WWAN_BAND_CLASS_IV | このデバイスは韓国の PCS バンドをサポートしています。 |
| WWAN_BAND_CLASS_V | デバイスは 450 MHz バンドをサポートします。 |
| WWAN_BAND_CLASS_VI | デバイスは 2 GHz 帯域をサポートします。 |
| WWAN_BAND_CLASS_VII | デバイスは 700 MHz 帯をサポートします。 |
| WWAN_BAND_CLASS_VIII | デバイスは 1800 MHz 帯域をサポートします。 |
| WWAN_BAND_CLASS_IX | デバイスは 900 MHz 帯域をサポートします。 |
| WWAN_BAND_CLASS_X | デバイスは、セカンダリ 800 MHz バンドをサポートします。 |
| WWAN_BAND_CLASS_XI | このデバイスは、400 MHz のヨーロッパ PAMR バンドをサポートします。 |
| WWAN_BAND_CLASS_XII | デバイスは 800 MHz PAMR バンドをサポートします。 |
| WWAN_BAND_CLASS_XIII | デバイスは、2.5GHz IMT2000拡張バンドをサポートします。 |
| WWAN_BAND_CLASS_XIV | このデバイスは、US PCS 1.9GHz バンドをサポートしています。 |
| WWAN_BAND_CLASS_XV | デバイスは AWS バンドをサポートします。 |
| WWAN_BAND_CLASS_XVI | このデバイスは、米国の 2.5 GHz バンドをサポートしています。 |
| WWAN_BAND_CLASS_XVII | このデバイスは、US 2.5 GHz Forward Link Only バンドをサポートしています。 |
| WWAN_BAND_CLASS_CUSTOM | デバイスは、この表に示されているバンド以外のバンドをサポートしています。 |
ミニポート ドライバーがWWAN_BAND_CLASS_CUSTOMを指定する場合は、CustomBandClass でデータ クラスの名前 指定する必要があります。
これらの値の詳細については、OID_WWAN_DEVICE_CAPSを参照してください。
CustomBandClass[WWAN_CUSTOM_BAND_CLASS_LEN]
カスタム バンド クラスの名前を表す NULL で終わる文字列。 このメンバーは、ミニポート ドライバーが必要に応じて、WwanGsmBandClass または WwanCdmaBandClass メンバーでWWAN_BAND_CLASS_CUSTOM ビットを設定する場合にのみ有効です。
WwanSmsCaps
デバイスがサポートする SMS メッセージと方向フローの種類を表すビットマップ。 次の表に、有効な SMS 機能の設定を示します。
| 価値 | 意味 |
|---|---|
| WWAN_SMS_CAPS_NONE | デバイスは SMS メッセージをサポートしていません。 |
| WWAN_SMS_CAPS_PDU_SEND |
GSM ベースのデバイスの場合、この値は、デバイスが PDU スタイルの SMS メッセージの送信をサポートしていることを意味します。
CDMA ベースのデバイスの場合、この値は、デバイスが 3GPP2 仕様 C のセクション「3.4.2.1 SMS ポイントツーポイント メッセージ」で定義されているバイナリ形式で SMS メッセージを送信できることを意味します。S0015-A「ワイドバンド 拡散スペクトル システムのショート メッセージ サービス (SMS)」を参照してください。 |
| WWAN_SMS_CAPS_PDU_RECEIVE |
GSM ベースのデバイスの場合、この値は、デバイスが PDU スタイルの SMS メッセージの受信をサポートしていることを意味します。
CDMA ベースのデバイスの場合、この値は、デバイスが 3GPP2 仕様 C. のセクション「3.4.2.1 SMS ポイントツーポイント メッセージ」で定義されているバイナリ形式で SMS メッセージを読み取ることができることを意味します。S0015-A「Short Message Service (SMS) for Wideband Spread Spectrum Systems」を参照してください。 |
| WWAN_SMS_CAPS_TEXT_SEND | デバイスは、テキスト スタイルの SMS メッセージの送信をサポートしています。 このフラグは、CDMA ベースのデバイスに適用されます。 |
| WWAN_SMS_CAPS_TEXT_RECEIVE | デバイスは、テキスト スタイルの SMS メッセージの受信をサポートしています。 このフラグは、CDMA ベースのデバイスに適用されます。 |
ミニポート ドライバーは、現在のホーム プロバイダーがマルチモード対応の場合に SMS を受信および送信するための GSM PDU 形式のみのサポートを反映するように、このメンバーを設定する必要があります。 したがって、ミニポート ドライバーが携帯ネットワーク クラスのネイティブ形式 (CDMA TEXT や CDMA PDU など) で SMS を受信する場合、ミニポート ドライバーは GSM PDU への変換を行い、MB サービスに指示する必要があります。 同様に、ミニポート ドライバーが GSM PDU 形式で送信要求を受信する場合は、ネイティブの携帯ネットワーク クラス形式への変換を行う必要があります。
WwanControlCaps
デバイスがサポートするコントロール機能を表すビットマップ。 次の表は、GSM ベースおよび CDMA ベースのデバイスの有効な WwanControlCaps 設定を示しています。
| 価値 | 意味 |
|---|---|
| WWAN_CTRL_CAPS_REG_MANUAL | プロバイダー ネットワークで手動でネットワークを選択できるかどうかを示します。 GSM ベースのデバイスのミニポート ドライバーは、このフラグを指定する必要があります。 CDMA ベースのデバイスのミニポート ドライバーでは、このフラグを指定しないでください。 |
| WWAN_CTRL_CAPS_HW_RADIO_SWITCH | ハードウェア無線電源スイッチの存在を示します。 これは、WWAN_DEVICE_TYPE列挙型の WwanDeviceTypeEmbedded 値に対応します。 |
| WWAN_CTRL_CAPS_CDMA_MOBILE_IP |
CDMA ベースのデバイスがモバイル IP をサポートするように構成されていることを示します。 このフラグは、CDMA ベースのデバイスにのみ適用されます。
ミニポート ドライバーは、現在のホーム プロバイダーがマルチモード対応の場合は、このフラグを設定しないでください。 |
| WWAN_CTRL_CAPS_CDMA_SIMPLE_IP |
CDMA ベースのデバイスが単純な IP サポート用に構成されていることを示します。 このフラグは、CDMA ベースのデバイスにのみ適用されます。
ミニポート ドライバーは、現在のホーム プロバイダーがマルチモード対応の場合は、このフラグを設定しないでください。 |
| WWAN_CTRL_CAPS_CDMA_MOBILE_IPまたはWWAN_CTRL_CAPS_CDMA_SIMPLE_IP | CDMA ベースのデバイスが、フォールバック オプションとして単純な IP を使用してモバイル IP をサポートするように構成されていることを示します。 |
| WWAN_CTRL_CAPS_PROTECT_UNIQUEID | Windows で国際モバイル サブスクライバー ID (IMSI) を表示しないことを示します。 |
| WWAN_CTRL_CAPS_USSD |
GSM ベースの MB デバイスが USSD プロトコルをサポートするように構成されていることを示します。 このフラグは、GSM ベースのデバイスにのみ適用されます。
USSD メッセージの送受信をサポートするミニポート ドライバーは、このフラグを設定します。 ミニポート ドライバーは、ネットワークの現在のマルチモード対応ホーム プロバイダー GSM 側は、ネットワークの CDMA 側が USSD をサポートしていない場合でも USSD をサポートする場合、このフラグを設定できます。 |
| WWAN_CTRL_CAPS_MODEL_MULTI_CARRIER | MB デバイスが複数のネットワークオペレーターの登録と接続をサポートしていることを示します。 |
| WWAN_CTRL_CAPS_MULTI_MODE | このフラグは、現在のホーム プロバイダーが複数の携帯ネットワーク クラス/RAT (無線アクセス テクノロジ) をサポートしていることを示します。 |
CDMA ベースのデバイスのミニポート ドライバーは、デバイスがサポートする IP の種類について MB サービスに通知するために、WWAN_CTRL_CAPS_CDMA_MOBILE_IP、WWAN_CTRL_CAPS_CDMA_SIMPLE_IP、または両方のフラグを指定する必要があります。
DeviceId[WWAN_DEVICEID_LEN]
デバイス ID を表す NULL で終わる文字列。
GSM ベースのデバイスの場合、文字列は国際モバイル機器 ID (IMEI) 形式 (最大 15 桁) に準拠している必要があります。
CDMA ベースのデバイスの場合、文字列は電子シリアル番号 (ESN、11 桁) とモバイル機器識別子 (MEID、17 桁) の両方の形式に準拠している必要があります。
WwanControlCaps で WWAN_CTRL_CAPS_MULTI_MODE フラグを設定するドライバーなど、マルチモード対応ミニポート ドライバーの場合は、GSM ベースの DeviceId のみを報告する必要があります。
この値はデバイスのメモリに格納する必要があり、MB デバイス/SIM で PIN のロックを解除する必要がある場合でも使用できる必要があります。
Manufacturer[WWAN_MANUFACTURER_LEN]
デバイスの製造元を表す NULL で終わる文字列。 このメンバーは省略可能です。
Model[WWAN_MODEL_LEN]
デバイスのモデルを表す NULL で終わる文字列。 このメンバーは省略可能です。
FirmwareInfo[WWAN_FIRMWARE_LEN]
デバイスに関するファームウェア固有の情報を表す NULL で終わる文字列。 このメンバーは省略可能です。
MaxActivatedContexts
デバイスでサポートされているアクティブ化されたコンテキストの最大数。 ミニポート ドライバーは、MaxActivatedContexts を超えるアクティブ化の試行失敗することによって、この制限を適用する必要があります。
WwanAuthAlgoCaps
MB デバイスがサポートする認証方法の種類を表すビットマップ。
| 価値 | 意味 |
|---|---|
| WWAN_AUTH_ALGO_CAPS_NONE | MB デバイスでは、認証方法はサポートされていません。 |
| WWAN_AUTH_ALGO_CAPS_SIM | MB デバイスでは、SIM 認証方法がサポートされています。 |
| WWAN_AUTH_ALGO_CAPS_AKA | MB デバイスでは、AKA 認証方法がサポートされています。 |
| WWAN_AUTH_ALGO_CAPS_AKAP | MB デバイスでは、AKA' (AKA Prime) 認証方法がサポートされています。 |
CellularClassListHeader
マルチモード対応デバイスがサポートする携帯ネットワーク クラスの一覧を表す書式設定されたWWAN_LIST_HEADER オブジェクト。 WWAN_LIST_HEADER の ElementType メンバーは、常に WwanStructCellularClass に設定する必要があります。 WWAN_LIST_HEADER の ElementCount メンバーは、WWAN_LIST_HEADER構造体に続く携帯ネットワーク クラスの数に設定されます。 マルチモード対応ではない MB デバイスは、ElementCount 0 に設定する必要があります。
備考
デバイスでサポートされているデータ サービスが、WwanDataClass メンバーのテーブルで定義されている他の値のいずれかに属していない場合、ミニポート ドライバーはWWAN_DATA_CLASS_CUSTOMを指定する必要があります。 ミニポート ドライバーがWWAN_DATA_CLASS_CUSTOMフラグを設定する場合、ミニポート ドライバーは、CustomDataClass メンバーのデータ クラスの名前も指定する必要があります。
GSM ベースのデバイスでは、GSM ベースのデータ クラスのみを指定する必要があります。 たとえば、GPRS、EDGE、UMTS、HSDPA、LTE、TD-SCDMA などです。 ミニポート ドライバーが TD-SCDMA をサポートしている場合は、WwanDataClass メンバーのWWAN_DATA_CLASS_CUSTOMと、CustomDataClass メンバーの文字列 "TD-SCDMA" を指定する必要があります。
CDMA ベースのデバイスの場合は、CDMA 関連のデータ サービスのみを指定する必要があります。 たとえば、1xRTT、1xEV-DO、1xEV-DO RevA、UMB などです。 1xEV-DO RevB は将来使用するために定義されています。 1xEV-DV と 3xRTT も完全のために定義されています。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 8 以降のバージョンの Windows で使用できます。 |
| ヘッダー | wwan.h (Wwan.h を含む) |