MBN_INTERFACE_CAPS 構造体 (mbnapi.h)

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 値に関する追加情報を示します。

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値に関する追加情報を示します。

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 を呼び出してこの文字列を解放する必要があります。

要件