estructura MBN_INTERFACE_CAPS (mbnapi.h)
Importante
A partir de Windows 10, versión 1803, las API de Win32 descritas en esta sección se reemplazan por las API de Windows Runtime en el espacio de nombres Windows.Networking.Connectivity.
La estructura MBN_INTERFACE_CAPS representa las funcionalidades de la interfaz. El método GetInterfaceCapability devuelve esta estructura de IMbnInterface.
Sintaxis
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;
Miembros
cellularClass
Valor MBN_CELLULAR_CLASS que especifica la tecnología de telefonía móvil utilizada por el dispositivo.
voiceClass
Valor MBN_VOICE_CLASS que especifica cómo se controlan las llamadas de voz.
dataClass
Combinación OR bit a bit de MBN_DATA_CLASS valores que especifica qué servicios de datos se admiten. En el caso de los dispositivos GSM, solo los servicios de datos basados en GSM pueden estar presentes, es decir, solo GPRS, EDGE, UMTS, LTE y HSDPA son valores válidos para dispositivos GSM.
En el caso de los dispositivoss, solo estarán presentes los servicios de datos relacionados con SERVICE, es decir, solo 1xRTT, 1xEV-DO y 1xEV-DO RevA son valores válidos para dispositivos STORAGE. 1xEV-DO RevB está reservado para uso futuro.
Este campo tiene el valor de bit MBN_DATA_CLASS_CUSTOM establecer si el dispositivo también admite la clase de datos alguna otra clase de datos que no está definida en la enumeración. Si MBN_DATA_CLASS_CUSTOM se establece, la información sobre la clase de datos personalizada está disponible en el campo customDataClass .
customDataClass
Contiene el nombre de la clase de datos personalizada. Si no se establece el bit de MBN_DATA_CLASS_CUSTOMdataClass , la cadena es NULL. De lo contrario, el autor de la llamada debe liberar esta cadena llamando a SysFreeString.
gsmBandClass
Campo de bits que especifica las bandas de frecuencia admitidas por el dispositivo GSM. MBN_BAND_CLASS_I a través de MBN_BAND_CLASS_X y MBN_BAND_CLASS_CUSTOM son valores válidos. Estos valores se definen mediante MBN_BAND_CLASS. Si gsmBandClass está establecido en MBN_BAND_CLASS_CUSTOM, aparece información adicional sobre la clase band en customBandClass.
En la tabla siguiente se proporciona información adicional sobre los valores de MBN_BAND_CLASS .
| valor de MBN_BAND_CLASS | Espectro designado | Nombre del sector | Vínculo superior (MS a BTS) | Vínculo descendente (BTS a MS) | Regions |
|---|---|---|---|---|---|
| MBN_BAND_CLASS_I | UMTS2100 | IMT | 1920-1980 | 2110-2170 | Europa, Corea, Japón China |
| MBN_BAND_CLASS_II | UMT21900 | PCS1900 | 1850-1910 | 1930-1990 | Norteamérica, América Latina |
| 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 | Norteamérica, América Latina |
| MBN_BAND_CLASS_V | UMTS850 | GSM850 | 824-849 | 869-894 | Norteamérica, América Latina |
| MBN_BAND_CLASS_VI | UMTS800 | UMTS800 | 830-840 | 875-885 | Japón |
| 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 | Japón |
| MBN_BAND_CLASS_X | 1710-1770 | 2110-2170 |
cdmaBandClass
Campo de bits que especifica las bandas de frecuencia admitidas por el dispositivo STORAGE. MBN_BAND_CLASS_0 a través de MBN_BAND_CLASS_XVII, MBN_BAND_CLASS_NONE y MBN_BAND_CLASS_CUSTOM son valores válidos. Estos valores se definen mediante MBN_BAND_CLASS. Si serviceBandClass se establece en MBN_BAND_CLASS_CUSTOM, aparece información adicional sobre la clase band en customBandClass.
En la tabla siguiente se proporciona información adicional sobre los valores de MBN_BAND_CLASS.
| valor de MBN_BAND_CLASS | Nombre del sector | Vínculo superior (MS a BTS) | Vínculo descendente (BTS a MS) |
|---|---|---|---|
| MBN_BAND_CLASS_0 | Telefonía móvil 800MHx | 824.025.844.995 | 869.025.889.995 |
| MBN_BAND_CLASS_I | Banda de 1900MHz | 1850-1910 | 1930-1990 |
| MBN_BAND_CLASS_II | Banda TACS | 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 de PCS coreano | 1750-1780 | 1840-1870 |
| MBN_BAND_CLASS_V | Banda de 450 MHz | 410-483.475 | 420-493.475 |
| MBN_BAND_CLASS_VI | Banda de 2 GHz | 1920-1979.950 | 2110-2169.950 |
| MBN_BAND_CLASS_VII | Banda de 700 MHz | 776-794 | 746-764 |
| MBN_BAND_CLASS_VIII | Banda de 1800 MHz | 1710-1784.950 | 1805-1879.95 |
| MBN_BAND_CLASS_IX | Banda de 900 MHz | 880-914-950 | 925-959.950 |
| MBN_BAND_CLASS_X | Banda secundaria de 800 MHz | 806-900.975 | 851-939.975 |
| MBN_BAND_CLASS_XI | Banda PAMR europea de 400 MHz | 410-483.475 | 420-493.475 |
| MBN_BAND_CLASS_XII | Banda PAMR de 800 MHz | 870.125-875.9875 | 915.0125-920.9875 |
| MBN_BAND_CLASS_XIII | Banda de extensión IMT200 de 2,5 GHz | 2500-2570 | 2620-2690 |
| MBN_BAND_CLASS_XIV | BANDA DE 1,9 GHz DE EE. UU. | 1850-1915 | 1930-1995 |
| MBN_BAND_CLASS_XV | Banda de AWS | 1710-1755 | 2110-2155 |
| MBN_BAND_CLASS_XVI | Banda de 2,5 GHz de EE. UU. | 2502-2568 | 2624-2690 |
| MBN_BAND_CLASS_XVII | Banda de solo enlace hacia delante de US 2,5 GHz | 2624-2690 |
customBandClass
Contiene el nombre de la clase de banda personalizada. Si no se establece el bit MBN_BAND_CLASS_CUSTOM de classBandClass y gsmBandClass , la cadena es NULL. De lo contrario, el autor de la llamada debe liberar esta cadena llamando a SysFreeString.
smsCaps
Combinación OR bit a bit de valores MBN_SMS_CAPS que especifica las funcionalidades de SMS.
controlCaps
Combinación OR bit a bit de MBN_CTRL_CAPS valores que representa las funcionalidades de control de banda ancha móvil para esta interfaz.
deviceID
Contiene el identificador de dispositivo. Para los dispositivos GSM, debe ser el IMEI (hasta 15 dígitos). Para los dispositivos XAML, debe ser el ESN (11 dígitos) / MEID (17 dígitos). La longitud máxima de la cadena es MBN_DEVICEID_LEN. Para obtener la definición de MBN_DEVICEID_LEN, vea MBN_INTERFACE_CAPS_CONSTANTS. El autor de la llamada debe liberar esta cadena llamando a SysFreeString.
manufacturer
Contiene el nombre del fabricante del dispositivo. Esta cadena puede estar vacía. La longitud máxima de la cadena es MBN_MANUFACTURER_LEN. Para obtener la definición de MBN_MANUFACTURER_LEN, vea MBN_INTERFACE_CAPS_CONSTANTS. El autor de la llamada debe liberar esta cadena llamando a SysFreeString.
model
Contiene el modelo de dispositivo. Esta cadena puede estar vacía. La longitud máxima de esta cadena es MBN_MODEL_LEN. Para obtener la definición de MBN_MODEL_LEN, consulte MBN_INTERFACE_CAPS_CONSTANTS. El autor de la llamada debe liberar esta cadena llamando a SysFreeString.
firmwareInfo
Contiene la información específica del firmware para este dispositivo. Esta cadena puede estar vacía. La longitud máxima de la cadena es MBN_FIRMWARE_LEN. Para obtener la definición de MBN_FIRMWARE_LEN, vea MBN_INTERFACE_CAPS_CONSTANTS. El autor de la llamada debe liberar esta cadena llamando a SysFreeString.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP] |
| Servidor mínimo compatible | No se admite ninguno |
| Encabezado | mbnapi.h |