MBN_INTERFACE_CAPS 構造体 (mbnapi.h)

[アーティクル]
02/28/2024

重要

バージョン 1803 Windows 10以降、このセクションで説明する Win32 API は、Windows.Networking.Connectivity 名前空間のWindows ランタイム API に置き換えられます。

MBN_INTERFACE_CAPS構造体は、インターフェイス機能を表します。この構造体は、IMbnInterface の GetInterfaceCapability メソッドによって返されます。

構文

typedef struct MBN_INTERFACE_CAPS {
  MBN_CELLULAR_CLASS cellularClass;
  MBN_VOICE_CLASS    voiceClass;
  ULONG              dataClass;
  BSTR               customDataClass;
  ULONG              gsmBandClass;
  ULONG              cdmaBandClass;
  BSTR               customBandClass;
  ULONG              smsCaps;
  ULONG              controlCaps;
  BSTR               deviceID;
  BSTR               manufacturer;
  BSTR               model;
  BSTR               firmwareInfo;
} MBN_INTERFACE_CAPS;

メンバー

cellularClass

デバイスで使用されるセルラーテクノロジを指定するMBN_CELLULAR_CLASS値。

voiceClass

音声通話の処理方法を指定する MBN_VOICE_CLASS 値。

dataClass

サポートされるデータサービスを指定するMBN_DATA_CLASS 値のビットごとの OR の組み合わせ。 GSM デバイスの場合、GSM ベースのデータサービスのみが存在できます。つまり、GSM デバイスの有効な値は GPRS、EDGE、UMTS、LTE、HSDPA のみです。

CDMA デバイスの場合、CDMA 関連のデータサービスのみが存在します。つまり、CDMA デバイスの有効な値は 1xRTT、1xEV-DO、1xEV-DO RevA のみです。 1xEV-DO RevB は将来の使用のために予約されています。

このフィールドには、列挙体で定義されていない他のデータクラスのデータクラスもデバイスでサポートされている場合、 ビット値MBN_DATA_CLASS_CUSTOM 設定されます。 MBN_DATA_CLASS_CUSTOMが設定されている場合、カスタムデータクラスに関する情報は customDataClass フィールドで使用できます。

customDataClass

カスタムデータクラスの名前を格納します。 dataClass のMBN_DATA_CLASS_CUSTOM ビットが設定されていない場合、文字列は NULL になります。それ以外の場合、呼び出し元は SysFreeString を呼び出してこの文字列を解放する必要があります。

gsmBandClass

GSM デバイスでサポートされる周波数帯域を指定するビットフィールド。 MBN_BAND_CLASS_X と MBN_BAND_CLASS_CUSTOM を介した MBN_BAND_CLASS_I は有効な値です。これらの値は、MBN_BAND_CLASSによって定義されます。 gsmBandClass をMBN_BAND_CLASS_CUSTOMに設定すると、バンドクラスに関する追加情報が customBandClass に表示されます。

次の表に、 MBN_BAND_CLASS 値に関する追加情報を示します。

MBN_BAND_CLASS値	指定されたスペクトル	業界名	アップリンク (MS から BTS)	下りリンク (BTS から MS)	リージョン
MBN_BAND_CLASS_I	UMTS2100	Imt	1920-1980	2110-2170	ヨーロッパ、韓国、日本中国
MBN_BAND_CLASS_II	UMT21900	PCS1900	1850-1910	1930-1990	北米, ラテンアメリカ
MBN_BAND_CLASS_III	UMTS1800	DCS1800	1710-1785	1805-1880	ヨーロッパ、中国
MBN_BAND_CLASS_IV	AWS	AWS、1.7/2.1	1710-1785	2110-2155	北米, ラテンアメリカ
MBN_BAND_CLASS_V	UMTS850	GSM850	824-849	869-894	北米, ラテンアメリカ
MBN_BAND_CLASS_VI	UMTS800	UMTS800	830-840	875-885	日本
MBN_BAND_CLASS_VII	UMTS2600	UMTS2600	2500-2570	2620-2690	ヨーロッパ
MBN_BAND_CLASS_VIII	UMTS900	EGSM900	880-915	925-960	ヨーロッパ、中国
MBN_BAND_CLASS_IX	UMTS1700	UMTS1700	1750-1770	1845-1880	日本
MBN_BAND_CLASS_X			1710-1770	2110-2170

cdmaBandClass

CDMA デバイスでサポートされる周波数帯域を指定するビットフィールド。 MBN_BAND_CLASS_XVII 、 MBN_BAND_CLASS_NONE、 MBN_BAND_CLASS_CUSTOMを MBN_BAND_CLASS_0は有効 な値です。これらの値は、MBN_BAND_CLASSによって定義されます。 cdmaBandClass が MBN_BAND_CLASS_CUSTOM に設定されている場合、バンドクラスに関する追加情報が customBandClass に表示されます。

次の表に、MBN_BAND_CLASS値に関する追加情報を示します。

MBN_BAND_CLASS値	業界名	アップリンク (MS から BTS)	下りリンク (BTS から MS)
MBN_BAND_CLASS_0	800MHx セルラー	824.025.844.995	869.025.889.995
MBN_BAND_CLASS_I	1900MHz 帯	1850-1910	1930-1990
MBN_BAND_CLASS_II	TACS バンド	872.025.914.9875	917.0125.959.9875
MBN_BAND_CLASS_III	JTACS バンド	887.0125.924.9875	832.0125.869.9875
MBN_BAND_CLASS_IV	韓国語 PCS バンド	1750-1780	1840-1870
MBN_BAND_CLASS_V	450 MHz 帯	410-483.475	420-493.475
MBN_BAND_CLASS_VI	2 GHz 帯	1920-1979.950	2110-2169.950
MBN_BAND_CLASS_VII	700 MHz 帯	776-794	746-764
MBN_BAND_CLASS_VIII	1800 MHz 帯	1710-1784.950	1805-1879.95
MBN_BAND_CLASS_IX	900 MHz 帯	880-914-950	925-959.950
MBN_BAND_CLASS_X	セカンダリ 800 MHz バンド	806-900.975	851-939.975
MBN_BAND_CLASS_XI	400 MHz ヨーロッパ PAMR バンド	410-483.475	420-493.475
MBN_BAND_CLASS_XII	800 MHz PAMR バンド	870.125-875.9875	915.0125-920.9875
MBN_BAND_CLASS_XIII	2.5 GHz IMT200 拡張バンド	2500-2570	2620-2690
MBN_BAND_CLASS_XIV	US PCS 1.9 GHz バンド	1850-1915	1930-1995
MBN_BAND_CLASS_XV	AWS バンド	1710-1755	2110-2155
MBN_BAND_CLASS_XVI	US 2.5 GHz バンド	2502-2568	2624-2690
MBN_BAND_CLASS_XVII	US 2.5 GHz 転送リンク専用バンド		2624-2690

customBandClass

カスタムバンドクラスの名前を格納します。 cdmaBandClass と gsmBandClass のMBN_BAND_CLASS_CUSTOM ビットが設定されていない場合、文字列は NULL になります。それ以外の場合、呼び出し元は SysFreeString を呼び出してこの文字列を解放する必要があります。

smsCaps

SMS 機能を指定するMBN_SMS_CAPS 値のビットごとの OR の組み合わせ。

controlCaps

このインターフェイスのモバイルブロードバンド制御機能を表す MBN_CTRL_CAPS 値のビットごとの OR の組み合わせ。

deviceID

デバイス ID が含まれます。 GSM デバイスの場合、これは IMEI (最大 15 桁) である必要があります。 CDMA デバイスの場合、これは ESN (11 桁) / MEID (17 桁) である必要があります。文字列の最大長は MBN_DEVICEID_LEN。 MBN_DEVICEID_LENの定義については、「MBN_INTERFACE_CAPS_CONSTANTS」を参照してください。呼び出し元は、SysFreeString を呼び出してこの文字列を解放する必要があります。

manufacturer

デバイスの製造元の名前が含まれます。この文字列は空にすることができます。文字列の最大長は MBN_MANUFACTURER_LEN。 MBN_MANUFACTURER_LENの定義については、「MBN_INTERFACE_CAPS_CONSTANTS」を参照してください。呼び出し元は、SysFreeString を呼び出してこの文字列を解放する必要があります。

model

デバイスモデルが含まれています。この文字列は空にすることができます。この文字列の最大長は MBN_MODEL_LEN。 MBN_MODEL_LENの定義については、「MBN_INTERFACE_CAPS_CONSTANTS」を参照してください。呼び出し元は、SysFreeString を呼び出してこの文字列を解放する必要があります。

firmwareInfo

このデバイスのファームウェア固有の情報が含まれています。この文字列は空にすることができます。文字列の最大長は MBN_FIRMWARE_LEN。 MBN_FIRMWARE_LENの定義については、「MBN_INTERFACE_CAPS_CONSTANTS」を参照してください。呼び出し元は、SysFreeString を呼び出してこの文字列を解放する必要があります。

要件

要件	値
サポートされている最小のクライアント	Windows 7 [デスクトップアプリ \|UWP アプリ]
サポートされている最小のサーバー	サポートなし
Header	mbnapi.h

次の方法で共有

MBN_INTERFACE_CAPS 構造体 (mbnapi.h)

構文

メンバー

要件

フィードバック

その他のリソース