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
デバイスの携帯ネットワーク クラス。 ミニポート ドライバーは、cellular クラスを WwanCellularClassUnknown 以外の値に設定する必要があります。 このメンバーコントロール機能の値は、ネットワーク プロバイダーの登録モードなど、携帯電話テクノロジに固有です。
マルチモードをサポートするミニポート ドライバーは、これを WwanCellularClassGsm に設定する必要があります。
WwanVoiceClass
デバイスの音声クラス。 このメンバーは、回線音声サービスの存在と、そのようなサービスがデータ サービスとどのようにやり取りするかを MB サービスに通知します。 MB サービスでは、回線切り替え音声がネイティブでサポートされておらず、除外もされていないことに注意してください。 回線音声をサポートする方法を決定するのはミニポート ドライバー次第です。 この WwanVoiceClass メンバーを使用すると、MB サービスは今後この機能をサポートできます。
WwanSimClass
サブスクライバー ID モジュール (SIM カード) のクラス。 ミニポート ドライバーは、SIM クラスを WwanSimClassUnknown 以外の値に設定する必要があります。
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 Radio Transmission Technology (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.5 GHz IMT2000拡張機能バンドをサポートしています。 |
| WWAN_BAND_CLASS_XIV | このデバイスは、US PCS 1.9GHz 帯をサポートしています。 |
| WWAN_BAND_CLASS_XV | デバイスは AWS バンドをサポートしています。 |
| WWAN_BAND_CLASS_XVI | このデバイスは、US 2.5GHz 帯をサポートしています。 |
| 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.S0015-A の「ワイドバンド拡散スペクトル システムのショート メッセージ サービス (SMS)」の「3.4.2.1 SMS ポイントツーポイント メッセージ」セクションで定義されているバイナリ形式で SMS メッセージを送信できることを意味します。 |
| WWAN_SMS_CAPS_PDU_RECEIVE |
GSM ベースのデバイスの場合、この値は、デバイスが PDU スタイルの SMS メッセージの受信をサポートしていることを意味します。
CDMA ベースのデバイスの場合、この値は、3GPP2 仕様 C.S0015-A の「ワイドバンド拡散スペクトル システムのショート メッセージ サービス (SMS)」のセクション「3.4.2.1 SMS ポイントツーポイント メッセージ」で定義されているバイナリ形式で SMS メッセージを読み取ることができることを意味します。 |
| 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 メッセージの送受信をサポートするミニポート ドライバーは、このフラグを設定します。 ネットワークの CDMA 側が USSD をサポートしていない場合でも、ネットワークの現在のマルチモード対応ホーム プロバイダー GSM 側が 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 ベースのデバイスの場合、文字列は International Mobile Equipment Identity (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 で使用できます。 |
| Header | wwan.h (Wwan.h を含む) |
こちらもご覧ください
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示