struttura MBN_INTERFACE_CAPS (mbnapi.h)
Importante
A partire da Windows 10 versione 1803, le API Win32 descritte in questa sezione vengono sostituite dalle API Windows Runtime nello spazio dei nomi Windows.Networking.Connectivity.
La struttura MBN_INTERFACE_CAPS rappresenta le funzionalità dell'interfaccia. Questa struttura viene restituita dal metodo GetInterfaceCapability di IMbnInterface.
Sintassi
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
Valore MBN_CELLULAR_CLASS che specifica la tecnologia cellulare usata dal dispositivo.
voiceClass
Valore MBN_VOICE_CLASS che specifica la modalità di gestione delle chiamate vocali.
dataClass
Combinazione OR bit per bit di valori MBN_DATA_CLASS che specifica quali servizi dati sono supportati. Per i dispositivi GSM, solo i servizi dati basati su GSM possono essere presenti, ovvero solo MDFS, EDGE, UMTS, LTE e HSDPA sono valori validi per i dispositivi GSM.
Per i dispositivi CDMA, solo i servizi dati correlati a CDMA saranno presenti, ovvero solo 1xRTT, 1xEV-DO e 1xEV-DO RevA sono valori validi per i dispositivi CDMA. 1xEV-DO RevB è riservato per l'uso futuro.
Questo campo ha il valore bit MBN_DATA_CLASS_CUSTOM impostato se la classe di dati di alcune altre classi di dati non definite nell'enumerazione è supportata anche dal dispositivo. Se MBN_DATA_CLASS_CUSTOM è impostato, le informazioni relative alla classe di dati personalizzata sono disponibili nel campo customDataClass .
customDataClass
Contiene il nome della classe di dati personalizzata. Se il bit di dataClass MBN_DATA_CLASS_CUSTOM non è impostato, la stringa è NULL. In caso contrario, il chiamante deve liberare questa stringa chiamando SysFreeString.
gsmBandClass
Campo bit che specifica le bande di frequenza supportate dal dispositivo GSM. MBN_BAND_CLASS_I tramite MBN_BAND_CLASS_X e MBN_BAND_CLASS_CUSTOM sono valori validi. Questi valori sono definiti da MBN_BAND_CLASS. Se gsmBandClass è impostato su MBN_BAND_CLASS_CUSTOM, vengono visualizzate altre informazioni sulla classe band in customBandClass.
Nella tabella seguente vengono fornite informazioni aggiuntive sui valori di MBN_BAND_CLASS .
| valore MBN_BAND_CLASS | Spettro designato | Nome del settore | Uplink (MS to BTS) | Downlink (BTS to MS) | Regioni |
|---|---|---|---|---|---|
| MBN_BAND_CLASS_I | UMTS2100 | IMT | 1920-1980 | 2110-2170 | Europa, Corea, Giappone Cina |
| MBN_BAND_CLASS_II | UMT21900 | PCS1900 | 1850-1910 | 1930-1990 | America del Nord, America latina |
| MBN_BAND_CLASS_III | UMTS1800 | DCS1800 | 1710-1785 | 1805-1880 | Europa, Cina |
| MBN_BAND_CLASS_IV | AWS | AWS, 1.7/2.1 | 1710-1785 | 2110-2155 | America del Nord, America latina |
| MBN_BAND_CLASS_V | UMTS850 | GSM850 | 824-849 | 869-894 | America del Nord, America latina |
| MBN_BAND_CLASS_VI | UMTS800 | UMTS800 | 830-840 | 875-885 | Giappone |
| MBN_BAND_CLASS_VII | UMTS2600 | UMTS2600 | 2500-2570 | 2620-2690 | Europa |
| MBN_BAND_CLASS_VIII | UMTS900 | EGSM900 | 880-915 | 925-960 | Europa, Cina |
| MBN_BAND_CLASS_IX | UMTS1700 | UMTS1700 | 1750-1770 | 1845-1880 | Giappone |
| MBN_BAND_CLASS_X | 1710-1770 | 2110-2170 |
cdmaBandClass
Campo bit che specifica le bande di frequenza supportate dal dispositivo CDMA. MBN_BAND_CLASS_0 tramite MBN_BAND_CLASS_XVII, MBN_BAND_CLASS_NONE e MBN_BAND_CLASS_CUSTOM sono valori validi. Questi valori sono definiti da MBN_BAND_CLASS. Se cdmaBandClass è impostato su MBN_BAND_CLASS_CUSTOM, vengono visualizzate altre informazioni sulla classe band in customBandClass.
Nella tabella seguente vengono fornite informazioni aggiuntive sui valori MBN_BAND_CLASS.
| valore MBN_BAND_CLASS | Nome settore | Uplink (MS to BTS) | Downlink (BTS to MS) |
|---|---|---|---|
| MBN_BAND_CLASS_0 | Cellulare 800MHx | 824.025.844.995 | 869.025.889.995 |
| MBN_BAND_CLASS_I | Banda 1900MHz | 1850-1910 | 1930-1990 |
| MBN_BAND_CLASS_II | TACS Band | 872.025.914.9875 | 917.0125.959.9875 |
| MBN_BAND_CLASS_III | Banda JTACS | 887.0125.924.9875 | 832.0125.869.9875 |
| MBN_BAND_CLASS_IV | Banda PCS coreana | 1750-1780 | 1840-1870 |
| MBN_BAND_CLASS_V | Banda 450 MHz | 410-483.475 | 420-493.475 |
| MBN_BAND_CLASS_VI | Banda 2 GHz | 1920-1979.950 | 2110-2169.950 |
| MBN_BAND_CLASS_VII | Banda 700 MHz | 776-794 | 746-764 |
| MBN_BAND_CLASS_VIII | Banda 1800 MHz | 1710-1784.950 | 1805-1879.95 |
| MBN_BAND_CLASS_IX | Banda 900 MHz | 880-914-950 | 925-959.950 |
| MBN_BAND_CLASS_X | Banda secondaria a 800 MHz | 806-900.975 | 851-939.975 |
| MBN_BAND_CLASS_XI | Banda PAMR europea a 400 MHz | 410-483.475 | 420-493.475 |
| MBN_BAND_CLASS_XII | Banda PAMR a 800 MHz | 870.125-875.9875 | 915.0125-920.9875 |
| MBN_BAND_CLASS_XIII | Banda di estensione IMT200 da 2,5 GHz | 2500-2570 | 2620-2690 |
| MBN_BAND_CLASS_XIV | Banda US PCS 1,9 GHz | 1850-1915 | 1930-1995 |
| MBN_BAND_CLASS_XV | AWS Band | 1710-1755 | 2110-2155 |
| MBN_BAND_CLASS_XVI | Banda US 2,5 GHz | 2502-2568 | 2624-2690 |
| MBN_BAND_CLASS_XVII | Banda di collegamento in avanti us 2,5 GHz | 2624-2690 |
customBandClass
Contiene il nome della classe band personalizzata. Se il bit MBN_BAND_CLASS_CUSTOM di cdmaBandClass e gsmBandClass non è impostato, la stringa è NULL. In caso contrario, il chiamante deve liberare questa stringa chiamando SysFreeString.
smsCaps
Combinazione OR bit per bit di valori MBN_SMS_CAPS che specifica le funzionalità SMS.
controlCaps
Combinazione OR bit per bit di valori MBN_CTRL_CAPS che rappresenta le funzionalità di controllo Mobile Broadband per questa interfaccia.
deviceID
Contiene l'ID dispositivo. Per i dispositivi GSM, questo deve essere l'IMEI (fino a 15 cifre). Per i dispositivi CDMA, questo deve essere il nome ESN (11 cifre) / MEID (17 cifre). La lunghezza massima della stringa è MBN_DEVICEID_LEN. Per la definizione di MBN_DEVICEID_LEN, vedere MBN_INTERFACE_CAPS_CONSTANTS. Il chiamante deve liberare questa stringa chiamando SysFreeString.
manufacturer
Contiene il nome del produttore del dispositivo. Questa stringa può essere vuota. La lunghezza massima della stringa è MBN_MANUFACTURER_LEN. Per la definizione di MBN_MANUFACTURER_LEN, vedere MBN_INTERFACE_CAPS_CONSTANTS. Il chiamante deve liberare questa stringa chiamando SysFreeString.
model
Contiene il modello di dispositivo. Questa stringa può essere vuota. La lunghezza massima di questa stringa è MBN_MODEL_LEN. Per la definizione di MBN_MODEL_LEN, vedere MBN_INTERFACE_CAPS_CONSTANTS. Il chiamante deve liberare questa stringa chiamando SysFreeString.
firmwareInfo
Contiene le informazioni specifiche del firmware per questo dispositivo. Questa stringa può essere vuota. La lunghezza massima della stringa è MBN_FIRMWARE_LEN. Per la definizione di MBN_FIRMWARE_LEN, vedere MBN_INTERFACE_CAPS_CONSTANTS. Il chiamante deve liberare questa stringa chiamando SysFreeString.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 7 [app desktop | App UWP] |
| Server minimo supportato | Nessuno supportato |
| Intestazione | mbnapi.h |