WWAN_DEVICE_CAPS_EX 構造体 (wwan.h)

WWAN_DEVICE_CAPS_EX構造は、モバイル ブロードバンド デバイスの機能を表します。 WWAN_DEVICE_CAPS_EXは、Executor Index メンバー (特定の Executor の追跡用) と WwanOptionalServiceCaps メンバー (Microsoft サービス拡張機能) を追加することで、既存のWWAN_DEVICE_CAPS構造を拡張します。

構文

typedef struct _WWAN_DEVICE_CAPS_EX {
  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;
  ULONG               WwanSimClassBitMasks;
  ULONG               WwanWCDMABandClass;
  USHORT              WwanLTEBandClass[WWAN_MAX_NUM_LTE_BAND];
  USHORT              WwanNRBandClass[WWAN_MAX_NUM_NR_BAND];
  ULONGLONG           WwanDataSubClass;
  ULONGLONG           WwanMiscCaps;
  WWAN_LIST_HEADER    CellularClassListHeader;
} WWAN_DEVICE_CAPS_EX, *PWWAN_DEVICE_CAPS_EX;

メンバー

WwanDeviceType

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

WwanCellularClass

デバイスの携帯ネットワーク クラス。 ミニポート ドライバーは、cellular クラスを WwanCellularClassUnknown 以外の値に設定する必要があります。 このメンバーコントロール機能の値は、ネットワーク プロバイダーの登録モードなど、携帯電話テクノロジに固有です。

マルチモードをサポートするミニポート ドライバーは、これを WwanCellularClassGsm に設定する必要があります。

WwanVoiceClass

デバイスの音声クラス。 このメンバーは、回線音声サービスの存在と、そのようなサービスがデータ サービスとどのようにやり取りするかを MB サービスに通知します。 MB サービスでは、回線切り替え音声がネイティブでサポートされておらず、除外もされていないことに注意してください。 回線音声をサポートする方法を決定するのはミニポート ドライバー次第です。 この WwanVoiceClass メンバーを使用すると、MB サービスは今後この機能をサポートできます。

WwanSimClass

WWAN_SIM_CLASS 列挙型で指定されたサブスクライバー ID モジュール (SIM カード) のクラス。 ミニポート ドライバーは、SIM クラスを WwanSimClassUnknown 以外の値に設定する必要があります。

WwanDataClass

デバイスがサポートするデータ クラスを表すビットマップ。 次の表に、このメンバーに使用できる値を示します。

CustomDataClass[WWAN_CUSTOM_DATA_CLASS_LEN]

カスタム データ クラスの名前を表す NULL で終わる文字列。 このメンバーは、ミニポート ドライバーが WwanDataClass メンバーのWWAN_DATA_CLASS_CUSTOM ビットを設定する場合にのみ有効です。

WwanGsmBandClass

GSM ベースのデバイスがサポートする周波数帯を表すビットマップ。 次の表に、このメンバーに使用できる値を示します。

ミニポート ドライバーがWWAN_BAND_CLASS_CUSTOMを指定する場合は、 CustomBandClass のデータ クラスの名前も指定する必要があります。

これらの値の詳細については、「 OID_WWAN_DEVICE_CAPS」を参照してください。

WwanCdmaBandClass

CDMA ベースのデバイスがサポートする周波数帯を表すビットマップ。 次の表に、このメンバーに使用できる値を示します。

ミニポート ドライバーが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 機能の設定を示しています。

ミニポート ドライバーは、現在のホーム プロバイダーがマルチモード対応の場合に SMS を受信および送信するための GSM PDU 形式のみのサポートを反映するようにこのメンバーを設定する必要があります。 ミニポート ドライバーが携帯ネットワーク クラスのネイティブ形式 (CDMA TEXT や CDMA PDU など) で SMS を受信する場合、ミニポート ドライバーは GSM PDU への変換を行い、MB サービスに示す必要があります。 同様に、ミニポート ドライバーが GSM PDU 形式で送信要求を受信する場合は、ネイティブの携帯ネットワーク クラス形式への変換を行う必要があります。

WwanControlCaps

デバイスがサポートするコントロール機能を表すビットマップ。 次の表は、GSM ベースおよび CDMA ベースのデバイスの有効な WwanControlCaps 設定を示しています。

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 デバイスがサポートする認証方法の種類を表すビットマップ。

ExecutorIndex

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

WwanOptionalServiceCaps

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

WwanSimClassBitMasks

SIM クラス マスクを表すビットマップ。 少なくとも WwanSimClass フィールドに対応するマスクが含まれている必要があります。

WwanWCDMABandClass

FDD の 3GPP TS25.101 で定義されているバンド番号。 LSB は、バンド番号 1 (2100MHz) を示します。

WwanLTEBandClass[WWAN_MAX_NUM_LTE_BAND]

WwanNRBandClass[WWAN_MAX_NUM_NR_BAND]

WwanDataSubClass

デバイスがサポートするデータ サブクラスを表すビットマップ。

WwanMiscCaps

デバイスがサポートするその他の機能を表すビットマップ。 |値| |--- | |WWAN_DEVICE_MISC_CAPS_NONE 0x00000000| |WWAN_DEVICE_MISC_CAPS_ETHERNET_PDU_SESSION 0x00000001| |WWAN_DEVICE_MISC_CAPS_UNSTRUCTURED_PDU_SESSION 0x00000002| |WWAN_DEVICE_MISC_CAPS_ESIM 0x00000004| |WWAN_DEVICE_MISC_CAPS_REFLECTIVE_QOS 0x00000008|

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 も完全のために定義されています。

要件

こちらもご覧ください

NDIS_WWAN_DEVICE_CAPS_EX

OID_WWAN_DEVICE_CAPS_EX

WWAN_DEVICE_CAPS