MBN_INTERFACE_CAPS Struktur (mbnapi.h)

Die MBN_INTERFACE_CAPS-Struktur stellt die Schnittstellenfunktionen dar. Diese Struktur wird von der GetInterfaceCapability-Methode von IMbnInterface zurückgegeben.

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;

Member

cellularClass

Ein MBN_CELLULAR_CLASS Wert, der die vom Gerät verwendete Mobilfunktechnologie angibt.

voiceClass

Ein MBN_VOICE_CLASS Wert, der angibt, wie Sprachanrufe behandelt werden.

dataClass

Eine bitweise OR-Kombination aus MBN_DATA_CLASS Werten, die angibt, welche Datendienste unterstützt werden. Für GSM-Geräte können nur die GSM-basierten Datendienste vorhanden sein, d. h. nur GPRS, EDGE, UMTS, LTE und HSDPA sind gültige Werte für GSM-Geräte.

Für CDMA-Geräte sind nur die CDMA-bezogenen Datendienste vorhanden, d. h. nur 1xRTT, 1xEV-DO und 1xEV-DO RevA sind gültige Werte für CDMA-Geräte. 1xEV-DO RevB ist für die zukünftige Verwendung reserviert.

Dieses Feld hat den Bitwert MBN_DATA_CLASS_CUSTOM festgelegt, wenn die Datenklasse eine andere Datenklasse, die nicht in der Enumeration definiert ist, auch vom Gerät unterstützt wird. Wenn MBN_DATA_CLASS_CUSTOM festgelegt ist, sind Informationen zur benutzerdefinierten Datenklasse im Feld customDataClass verfügbar.

customDataClass

Enthält den Namen der benutzerdefinierten Datenklasse. Wenn das MBN_DATA_CLASS_CUSTOM Bit von dataClass nicht festgelegt ist, ist die Zeichenfolge NULL. Andernfalls muss der Aufrufer diese Zeichenfolge durch Aufrufen von SysFreeString freigeben.

gsmBandClass

Ein Bitfeld, das die vom GSM-Gerät unterstützten Frequenzbänder angibt. MBN_BAND_CLASS_I bis MBN_BAND_CLASS_X und MBN_BAND_CLASS_CUSTOM sind gültige Werte. Diese Werte werden durch MBN_BAND_CLASS definiert. Wenn gsmBandClass auf MBN_BAND_CLASS_CUSTOM festgelegt ist, werden zusätzliche Informationen zur Bandklasse in customBandClass angezeigt.

Die folgende Tabelle enthält zusätzliche Informationen zu den MBN_BAND_CLASS-Werten .

cdmaBandClass

Ein Bitfeld, das die vom CDMA-Gerät unterstützten Frequenzbänder angibt. MBN_BAND_CLASS_0 bis MBN_BAND_CLASS_XVII, MBN_BAND_CLASS_NONE und MBN_BAND_CLASS_CUSTOM sind gültige Werte. Diese Werte werden durch MBN_BAND_CLASS definiert. Wenn cdmaBandClass auf MBN_BAND_CLASS_CUSTOM festgelegt ist, werden zusätzliche Informationen zur Bandklasse in customBandClass angezeigt.

Die folgende Tabelle enthält zusätzliche Informationen zu MBN_BAND_CLASS Werten.

customBandClass

Enthält den Namen der benutzerdefinierten Bandklasse. Wenn das MBN_BAND_CLASS_CUSTOM Bit von cdmaBandClass und gsmBandClass nicht festgelegt ist, ist die Zeichenfolge NULL. Andernfalls muss der Aufrufer diese Zeichenfolge durch Aufrufen von SysFreeString freigeben.

smsCaps

Eine bitweise OR-Kombination aus MBN_SMS_CAPS Werten, die die SMS-Funktionen angibt.

controlCaps

Eine bitweise OR-Kombination aus MBN_CTRL_CAPS Werten, die die Steuerungsfunktionen für mobiles Breitband für diese Schnittstelle darstellt.

deviceID

Enthält die Geräte-ID. Bei GSM-Geräten muss dies die IMEI (bis zu 15 Ziffern) sein. Bei CDMA-Geräten muss dies der ESN (11 Ziffern) / MEID (17 Ziffern) sein. Die maximale Länge der Zeichenfolge ist MBN_DEVICEID_LEN. Die Definition von MBN_DEVICEID_LEN finden Sie unter MBN_INTERFACE_CAPS_CONSTANTS. Der Aufrufer muss diese Zeichenfolge durch Aufrufen von SysFreeString freigeben.

manufacturer

Enthält den Namen des Geräteherstellers. Diese Zeichenfolge kann leer sein. Die maximale Länge der Zeichenfolge ist MBN_MANUFACTURER_LEN. Die Definition von MBN_MANUFACTURER_LEN finden Sie unter MBN_INTERFACE_CAPS_CONSTANTS. Der Aufrufer muss diese Zeichenfolge durch Aufrufen von SysFreeString freigeben.

model

Enthält das Gerätemodell. Diese Zeichenfolge kann leer sein. Die maximale Länge dieser Zeichenfolge ist MBN_MODEL_LEN. Die Definition von MBN_MODEL_LEN finden Sie unter MBN_INTERFACE_CAPS_CONSTANTS. Der Aufrufer muss diese Zeichenfolge durch Aufrufen von SysFreeString freigeben.

firmwareInfo

Enthält die firmwarespezifischen Informationen für dieses Gerät. Diese Zeichenfolge kann leer sein. Die maximale Länge der Zeichenfolge ist MBN_FIRMWARE_LEN. Die Definition von MBN_FIRMWARE_LEN finden Sie unter MBN_INTERFACE_CAPS_CONSTANTS. Der Aufrufer muss diese Zeichenfolge durch Aufrufen von SysFreeString freigeben.

Anforderungen