MBN_INTERFACE_CAPS Struktur (mbnapi.h)
Wichtig
Ab Windows 10 Version 1803 werden die in diesem Abschnitt beschriebenen Win32-APIs durch die Windows-Runtime-APIs im Windows.Networking.Connectivity-Namespace ersetzt.
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 .
| MBN_BAND_CLASS Wert | Angegebenes Spektrum | Branchenname | Uplink (MS mit BTS) | Downlink (BTS zu MS) | Regions |
|---|---|---|---|---|---|
| MBN_BAND_CLASS_I | UMTS2100 | IMT | 1920-1980 | 2110-2170 | Europa, Korea, Japan China |
| MBN_BAND_CLASS_II | UMT21900 | PCS1900 | 1850-1910 | 1930-1990 | Nordamerika, Lateinamerika |
| MBN_BAND_CLASS_III | UMTS1800 | DCS1800 | 1710-1785 | 1805-1880 | Europa, China |
| MBN_BAND_CLASS_IV | AWS | AWS, 1.7/2.1 | 1710-1785 | 2110-2155 | Nordamerika, Lateinamerika |
| MBN_BAND_CLASS_V | UMTS850 | GSM850 | 824-849 | 869-894 | Nordamerika, Lateinamerika |
| MBN_BAND_CLASS_VI | UMTS800 | UMTS800 | 830-840 | 875-885 | Japan |
| MBN_BAND_CLASS_VII | UMTS2600 | UMTS2600 | 2500-2570 | 2620-2690 | Europa |
| MBN_BAND_CLASS_VIII | UMTS900 | EGSM900 | 880-915 | 925-960 | Europa, China |
| MBN_BAND_CLASS_IX | UMTS1700 | UMTS1700 | 1750-1770 | 1845-1880 | Japan |
| MBN_BAND_CLASS_X | 1710-1770 | 2110-2170 |
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.
| MBN_BAND_CLASS Wert | Branchenname | Uplink (MS mit BTS) | Downlink (BTS zu MS) |
|---|---|---|---|
| MBN_BAND_CLASS_0 | 800MHx Mobilfunk | 824.025.844.995 | 869.025.889.995 |
| MBN_BAND_CLASS_I | 1900 MHz Band | 1850-1910 | 1930-1990 |
| MBN_BAND_CLASS_II | TACS-Band | 872.025.914.9875 | 917.0125.959.9875 |
| MBN_BAND_CLASS_III | JTACS-Band | 887.0125.924.9875 | 832.0125.869.9875 |
| MBN_BAND_CLASS_IV | Koreanisches PCS-Band | 1750-1780 | 1840-1870 |
| MBN_BAND_CLASS_V | 450 MHz Band | 410-483.475 | 420-493.475 |
| MBN_BAND_CLASS_VI | 2-GHz-Band | 1920-1979.950 | 2110-2169.950 |
| MBN_BAND_CLASS_VII | 700 MHz Band | 776-794 | 746-764 |
| MBN_BAND_CLASS_VIII | 1800 MHz Band | 1710-1784.950 | 1805-1879.95 |
| MBN_BAND_CLASS_IX | 900 MHz Band | 880-914-950 | 925-959.950 |
| MBN_BAND_CLASS_X | Sekundäres 800-MHz-Band | 806-900.975 | 851-939.975 |
| MBN_BAND_CLASS_XI | 400 MHz Europäisches PAMR-Band | 410-483.475 | 420-493.475 |
| MBN_BAND_CLASS_XII | PAMR-Band mit 800 MHz | 870.125-875.9875 | 915.0125-920.9875 |
| MBN_BAND_CLASS_XIII | 2,5 GHz IMT200-Erweiterungsband | 2500-2570 | 2620-2690 |
| MBN_BAND_CLASS_XIV | US PCS 1,9 GHz Band | 1850-1915 | 1930-1995 |
| MBN_BAND_CLASS_XV | AWS-Band | 1710-1755 | 2110-2155 |
| MBN_BAND_CLASS_XVI | US 2,5 GHz Band | 2502-2568 | 2624-2690 |
| MBN_BAND_CLASS_XVII | Us 2,5 GHz Forward Link Only Band | 2624-2690 |
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
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 7 [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Nicht unterstützt |
| Kopfzeile | mbnapi.h |