MBN_INTERFACE_CAPS structure

The MBN_INTERFACE_CAPS structure represents the interface capabilities. This structure is returned by the GetInterfaceCapability method of IMbnInterface.

Syntax


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;

Members

cellularClass

An MBN_CELLULAR_CLASS value that specifies the cellular technology used by the device.

voiceClass

An MBN_VOICE_CLASS value that specifies how voice calls are handled.

dataClass

A bitwise OR combination of MBN_DATA_CLASS values that specifies which data services are supported. For GSM devices, only the GSM-based data services can be present, that is, only GPRS, EDGE, UMTS, LTE, and HSDPA are valid values for GSM devices.

For CDMA devices, only the CDMA-related data services will be present, that is, only 1xRTT, 1xEV-DO, and 1xEV-DO RevA are valid values for CDMA devices. 1xEV-DO RevB is reserved for future use.

This field has the bit value MBN_DATA_CLASS_CUSTOM set if the data class some other data class which is not defined in the enumeration is also supported by device. If MBN_DATA_CLASS_CUSTOM is set then information regarding custom data class is available in customDataClass field.

customDataClass

Contains the name of the custom data class. If the MBN_DATA_CLASS_CUSTOM bit of dataClass is not set, then the string is NULL. Otherwise, the caller must free this string by calling SysFreeString.

gsmBandClass

A bit field that specifies the frequency bands supported by the GSM device. MBN_BAND_CLASS_I through MBN_BAND_CLASS_X and MBN_BAND_CLASS_CUSTOM are valid values. These values are defined by MBN_BAND_CLASS. If gsmBandClass is set to MBN_BAND_CLASS_CUSTOM, additional information about the band class appears in customBandClass.

The following table provides additional information about the MBN_BAND_CLASS values.

MBN_BAND_CLASS ValueDesignated spectrumIndustry nameUplink (MS to BTS)Downlink (BTS to MS)Regions
MBN_BAND_CLASS_IUMTS2100IMT1920-19802110-2170Europe, Korea, Japan China
MBN_BAND_CLASS_IIUMT21900PCS19001850-19101930-1990North America, Latin America
MBN_BAND_CLASS_IIIUMTS1800DCS18001710-17851805-1880Europe, China
MBN_BAND_CLASS_IVAWSAWS, 1.7/2.11710-17852110-2155North America, Latin America
MBN_BAND_CLASS_VUMTS850GSM850824-849869-894North America, Latin America
MBN_BAND_CLASS_VIUMTS800UMTS800830-840875-885Japan
MBN_BAND_CLASS_VIIUMTS2600UMTS26002500-25702620-2690Europe
MBN_BAND_CLASS_VIIIUMTS900EGSM900880-915925-960Europe, China
MBN_BAND_CLASS_IXUMTS1700UMTS17001750-17701845-1880Japan
MBN_BAND_CLASS_X1710-17702110-2170

 

cdmaBandClass

A bit field that specifies the frequency bands supported by the CDMA device. MBN_BAND_CLASS_0 through MBN_BAND_CLASS_XVII, MBN_BAND_CLASS_NONE, and MBN_BAND_CLASS_CUSTOM are valid values. These values are defined by MBN_BAND_CLASS. If cdmaBandClass is set to MBN_BAND_CLASS_CUSTOM, additional information about the band class appears in customBandClass.

The following table provides additional information about MBN_BAND_CLASS values.

MBN_BAND_CLASS ValueIndustry NameUplink (MS to BTS)Downlink (BTS to MS)
MBN_BAND_CLASS_0800MHx Cellular824.025.844.995869.025.889.995
MBN_BAND_CLASS_I1900MHz Band1850-19101930-1990
MBN_BAND_CLASS_IITACS Band872.025.914.9875917.0125.959.9875
MBN_BAND_CLASS_IIIJTACS Band887.0125.924.9875832.0125.869.9875
MBN_BAND_CLASS_IVKorean PCS Band1750-17801840-1870
MBN_BAND_CLASS_V450 MHz Band410-483.475420-493.475
MBN_BAND_CLASS_VI2 GHz Band1920-1979.9502110-2169.950
MBN_BAND_CLASS_VII700 MHz Band776-794746-764
MBN_BAND_CLASS_VIII1800 MHz Band1710-1784.9501805-1879.95
MBN_BAND_CLASS_IX900 MHz Band880-914-950925-959.950
MBN_BAND_CLASS_XSecondary 800 MHz Band806-900.975851-939.975
MBN_BAND_CLASS_XI400 MHz European PAMR Band410-483.475420-493.475
MBN_BAND_CLASS_XII800 MHz PAMR Band870.125-875.9875915.0125-920.9875
MBN_BAND_CLASS_XIII2.5 GHz IMT200 Extension Band2500-25702620-2690
MBN_BAND_CLASS_XIVUS PCS 1.9 GHz Band1850-19151930-1995
MBN_BAND_CLASS_XVAWS Band1710-17552110-2155
MBN_BAND_CLASS_XVIUS 2.5 GHz Band2502-25682624-2690
MBN_BAND_CLASS_XVIIUS 2.5 GHz Forward Link Only Band2624-2690

 

customBandClass

Contains the name of the custom band class. If the MBN_BAND_CLASS_CUSTOM bit of cdmaBandClass and gsmBandClass is not set, then the string is NULL. Otherwise, the caller must free this string by calling SysFreeString.

smsCaps

A bitwise OR combination of MBN_SMS_CAPS values that specifies the SMS capabilities.

controlCaps

A bitwise OR combination of MBN_CTRL_CAPS values that represents the Mobile Broadband control capabilities for this interface.

deviceID

Contains the device ID. For GSM devices, this must be the IMEI (up to 15 digits). For CDMA devices, this must be the ESN (11 digits) / MEID (17 digits). The maximum length of the string is MBN_DEVICEID_LEN. For the definition of MBN_DEVICEID_LEN, see MBN_INTERFACE_CAPS_CONSTANTS. The caller must free this string by calling SysFreeString.

manufacturer

Contains the name of the device manufacturer. This string can be empty. The maximum length of the string is MBN_MANUFACTURER_LEN. For the definition of MBN_MANUFACTURER_LEN, see MBN_INTERFACE_CAPS_CONSTANTS. The caller must free this string by calling SysFreeString.

model

Contains the device model. This string can be empty. The maximum length of this string is MBN_MODEL_LEN. For the definition of MBN_MODEL_LEN, see MBN_INTERFACE_CAPS_CONSTANTS. The caller must free this string by calling SysFreeString.

firmwareInfo

Contains the firmware-specific information for this device. This string can be empty. The maximum length of the string is MBN_FIRMWARE_LEN. For the definition of MBN_FIRMWARE_LEN, see MBN_INTERFACE_CAPS_CONSTANTS. The caller must free this string by calling SysFreeString.

Requirements

Minimum supported client

Windows 7 [desktop apps | Windows Store apps]

Minimum supported server

None supported [desktop apps | Windows Store apps]

IDL

Mbnapi.idl

 

 

Community Additions

ADD
Show:
© 2014 Microsoft