次の方法で共有

WWAN_DEVICE_CAPS_EX_REV1 構造体 (wwan.h)

  • [アーティクル]

重要

バイアスフリーなコミュニケーション

Microsoft は、多様で包括的な環境をサポートしています。 この記事には、 バイアスフリー通信の Microsoft スタイル ガイド が除外として認識する用語への参照が含まれています。 この単語または語句は、現在ソフトウェアに表示されているため、一貫性を保つ目的でこの記事で使用されています。 言語を削除するようにソフトウェアが更新されると、この記事は一致するように更新されます。

WWAN_DEVICE_CAPS_EX_REV1構造は、モバイル ブロードバンド デバイスの機能を表します。 WWAN_DEVICE_CAPS_EX_REV1 は、次のフィールドを削除して、既存の WWAN_DEVICE_CAPS_EX 構造を更新します。

  • WwanSimClassBitMasks
  • WwanWCDMABandClass
  • WwanLTEBandClass
  • WwanNRBandClass
  • WwanMiscCaps

構文

typedef struct _WWAN_DEVICE_CAPS_EX_REV1 {
  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;
  ULONG               ExecutorIndex;
  ULONG               WwanOptionalServiceCaps;
  WWAN_LIST_HEADER    CellularClassListHeader;
} WWAN_DEVICE_CAPS_EX_REV1, *PWWAN_DEVICE_CAPS_EX_REV1;

メンバー

WwanDeviceType

デバイスの種類。 ミニポート ドライバーは、デバイスの種類を WwanDeviceTypeUnknown 以外の値に設定する必要があります。

WwanCellularClass

デバイスの携帯ネットワーク クラス。 ミニポート ドライバーは、携帯ネットワーク クラスを 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 無線伝送テクノロジ (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.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) 認証方法がサポートされています。

ExecutorIndex

WWAN_DEVICE_CAPS_EX_REV1の WwanDeviceType メンバーは、モデム デバイスではなく、個々の Executor を参照しなくなりました。 各デバイスは、OS が認識する RF Executor エンティティです。

WwanOptionalServiceCaps

基になるモデムがサポートする Microsoft サービス拡張機能を表す ULONG 構造体。 未定義のビットが予約されており、"0" に設定する必要がある 64 ビットのビットマップ構造体です。新しいサービス拡張機能が導入されると、予約済みビットを使用して新しいサービス拡張機能が表されます。

値 マスク 意味
WWAN_OPTIONAL_SERVICE_CAPS_NONE 0h デバイスとドライバーは、オプションのサービス拡張機能をサポートしていません。
WWAN_OPTIONAL_SERVICE_CAPS_LTE_ATTACH 1h デバイスとドライバーは、LTE アタッチ構成と次の MBIM CID をサポートします。
  • MBIM_CID_MS_LTE_ATTACH_CONFIG
  • MBIM_CID_MS_LTE_ATTACH_STATUS
WWAN_OPTIONAL_SERVICE_CAPS_CONTEXT_MGMT 2h デバイスとドライバーは、OS 管理モデムのプロビジョニングされたコンテキストと、次の MBIM CID をサポートします。
  • MBIM_CID_PROVISIONED_CONTEXT_V2
WWAN_OPTIONAL_SERVICE_CAPS_MULTI_SIM 4h デバイスとドライバーは、マルチ SIM/マルチ Executor と次の OID をサポートしています。
WWAN_OPTIONAL_SERVICE_CAPS_EX_SAR 8h デバイスとドライバーは、OS と次の MBIM CID からの SAR 構成をサポートします。
  • MBIM_CID_MS_SAR_CONFIG
  • MBIM_CID_MS_TRANSMISSION_STATUS
WWAN_OPTIONAL_SERVICE_CAPS_NETWORK_BLACKLIST 16h OS と次の MBIM CID からのネットワーク受信拒否リストのデバイスとドライバーのサポート構成:
  • MBIM_CID_MS_NETWORK_BLACKLIST
WWAN_OPTIONAL_SERVICE_CAPS_5G_NSA   デバイスとドライバーは、Windows 10 バージョン 1903 のすべての新しい 5G 関連拡張機能をサポートします。 次の表に、NDIS メッセージと、このビットが設定されている場合にミニポート ドライバーがサポートする必要があるリビジョンを示します。
OID Message リビジョン
WWAN_DEVICE_CAPS_EX NDIS_WWAN_DEVICE_CAPS_EX 1
WWAN_REGISTER_STATE NDIS_WWAN_REGISTRATION_STATE 3
WWAN_PACKET_SERVICE NDIS_WWAN_PACKET_SERVICE_STATE 2
WWAN_SIGNAL_STATE NDIS_WWAN_SIGNAL_STATE 2

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 10 バージョン 2004
Header wwan.h

こちらもご覧ください

WWAN_DEVICE_CAPS_EX

NDIS_WWAN_DEVICE_CAPS

WWAN_CELLULAR_CLASS

WWAN_DEVICE_TYPE

WWAN_SIM_CLASS

WWAN_VOICE_CLASS