структура MBN_INTERFACE_CAPS (mbnapi.h)
Важно!
Начиная с Windows 10 версии 1803, API Win32, описанные в этом разделе, заменяются среда выполнения Windows API в пространстве имен Windows.Networking.Connectivity.
Структура MBN_INTERFACE_CAPS представляет возможности интерфейса. Эта структура возвращается методом GetInterfaceCapabilityобъекта IMbnInterface.
Синтаксис
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;
Члены
cellularClass
Значение MBN_CELLULAR_CLASS , указывающее технологию сотовой связи, используемую устройством.
voiceClass
Значение MBN_VOICE_CLASS , указывающее способ обработки голосовых вызовов.
dataClass
Побитовое или сочетание MBN_DATA_CLASS значений, указывающее, какие службы данных поддерживаются. Для устройств GSM могут присутствовать только службы данных на основе GSM, т. е. допустимыми значениями для устройств GSM являются только ТЕХНОЛОГИИ БЕЗОПАСНОСТИ, EDGE, UMTS, LTE и HSDPA.
Для устройств CDMA будут присутствовать только службы данных, связанные с CDMA, то есть только 1xRTT, 1xEV-DO и 1xEV-DO RevA являются допустимыми значениями для устройств CDMA. 1xEV-DO RevB зарезервировано для использования в будущем.
Это поле имеет битовое значение , MBN_DATA_CLASS_CUSTOM задано, если устройство также поддерживает класс данных другого класса данных, который не определен в перечислении. Если задано MBN_DATA_CLASS_CUSTOM , сведения о пользовательском классе данных доступны в поле customDataClass .
customDataClass
Содержит имя пользовательского класса данных. Если MBN_DATA_CLASS_CUSTOM бит dataClass не задан, строка имеет значение NULL. В противном случае вызывающий объект должен освободить эту строку, вызвав SysFreeString.
gsmBandClass
Битовое поле, указывающее диапазоны частот, поддерживаемые устройством GSM. MBN_BAND_CLASS_IMBN_BAND_CLASS_X и MBN_BAND_CLASS_CUSTOM являются допустимыми значениями. Эти значения определяются MBN_BAND_CLASS. Если параметру gsmBandClass присвоено значение MBN_BAND_CLASS_CUSTOM, дополнительные сведения о классе группы отображаются в customBandClass.
В следующей таблице приведены дополнительные сведения о значениях MBN_BAND_CLASS .
| Значение MBN_BAND_CLASS | Назначенный спектр | Название отрасли | Исходящей связи (MS to BTS) | Нисходящей ссылки (BTS на MS) | Регионы |
|---|---|---|---|---|---|
| MBN_BAND_CLASS_I | UMTS2100 | IMT | 1920-1980 | 2110-2170 | Европа, Корея, Япония Китай |
| MBN_BAND_CLASS_II | UMT21900 | PCS1900 | 1850-1910 | 1930-1990 | Северная Америка, Латинская Америка |
| MBN_BAND_CLASS_III | UMTS1800 | DCS1800 | 1710-1785 | 1805-1880 | Европа, Китай |
| MBN_BAND_CLASS_IV | AWS | AWS, 1.7/2.1 | 1710-1785 | 2110-2155 | Северная Америка, Латинская Америка |
| MBN_BAND_CLASS_V | UMTS850 | GSM850 | 824-849 | 869-894 | Северная Америка, Латинская Америка |
| MBN_BAND_CLASS_VI | UMTS800 | UMTS800 | 830-840 | 875-885 | Япония |
| MBN_BAND_CLASS_VII | UMTS2600 | UMTS2600 | 2500-2570 | 2620-2690 | Европа |
| MBN_BAND_CLASS_VIII | UMTS900 | EGSM900 | 880-915 | 925-960 | Европа, Китай |
| MBN_BAND_CLASS_IX | UMTS1700 | UMTS1700 | 1750-1770 | 1845-1880 | Япония |
| MBN_BAND_CLASS_X | 1710-1770 | 2110-2170 |
cdmaBandClass
Битовое поле, указывающее диапазоны частот, поддерживаемые устройством CDMA. MBN_BAND_CLASS_0MBN_BAND_CLASS_XVII, MBN_BAND_CLASS_NONE и MBN_BAND_CLASS_CUSTOM являются допустимыми значениями. Эти значения определяются MBN_BAND_CLASS. Если параметру cdmaBandClass присвоено значение MBN_BAND_CLASS_CUSTOM, дополнительные сведения о классе группы отображаются в customBandClass.
В следующей таблице приведены дополнительные сведения о MBN_BAND_CLASS значениях.
| Значение MBN_BAND_CLASS | Название отрасли | Исходящей связи (MS to BTS) | Нисходящей ссылки (BTS на MS) |
|---|---|---|---|
| MBN_BAND_CLASS_0 | 800MHx Cellular | 824.025.844.995 | 869.025.889.995 |
| MBN_BAND_CLASS_I | Диапазон 1900 МГц | 1850-1910 | 1930-1990 |
| MBN_BAND_CLASS_II | Диапазон TACS | 872.025.914.9875 | 917.0125.959.9875 |
| MBN_BAND_CLASS_III | Диапазон JTACS | 887.0125.924.9875 | 832.0125.869.9875 |
| MBN_BAND_CLASS_IV | Корейский pcs band | 1750-1780 | 1840-1870 |
| MBN_BAND_CLASS_V | Диапазон 450 МГц | 410-483.475 | 420-493.475 |
| MBN_BAND_CLASS_VI | Диапазон 2 ГГц | 1920-1979.950 | 2110-2169.950 |
| MBN_BAND_CLASS_VII | Диапазон 700 МГц | 776-794 | 746-764 |
| MBN_BAND_CLASS_VIII | Диапазон 1800 МГц | 1710-1784.950 | 1805-1879.95 |
| MBN_BAND_CLASS_IX | Диапазон 900 МГц | 880-914-950 | 925-959.950 |
| MBN_BAND_CLASS_X | Вторичный диапазон 800 МГц | 806-900.975 | 851-939.975 |
| MBN_BAND_CLASS_XI | 400 МГц европейский диапазон PAMR | 410-483.475 | 420-493.475 |
| MBN_BAND_CLASS_XII | Диапазон PAMR 800 МГц | 870.125-875.9875 | 915.0125-920.9875 |
| MBN_BAND_CLASS_XIII | Диапазон расширений IMT200 с тактовой частотой 2,5 ГГц | 2500-2570 | 2620-2690 |
| MBN_BAND_CLASS_XIV | US PCS 1,9 ГГц | 1850-1915 | 1930-1995 |
| MBN_BAND_CLASS_XV | AWS Band | 1710-1755 | 2110-2155 |
| MBN_BAND_CLASS_XVI | Диапазон 2,5 ГГц для США | 2502-2568 | 2624-2690 |
| MBN_BAND_CLASS_XVII | Us 2,5 GHz Forward Link Only Band | 2624-2690 |
customBandClass
Содержит имя настраиваемого класса band. Если бит MBN_BAND_CLASS_CUSTOMcdmaBandClass и gsmBandClass не задан, строка имеет значение NULL. В противном случае вызывающий объект должен освободить эту строку, вызвав SysFreeString.
smsCaps
Побитовое или сочетание MBN_SMS_CAPS значений, задающее возможности SMS.
controlCaps
Побитовое или сочетание MBN_CTRL_CAPS значений, представляющих возможности управления мобильной широкополосной связью для этого интерфейса.
deviceID
Содержит идентификатор устройства. Для устройств GSM это должен быть IMEI (до 15 цифр). Для устройств CDMA это должно быть ESN (11 цифр) или MEID (17 цифр). Максимальная длина строки — MBN_DEVICEID_LEN. Определение MBN_DEVICEID_LEN см. в разделе MBN_INTERFACE_CAPS_CONSTANTS. Вызывающий объект должен освободить эту строку, вызвав SysFreeString.
manufacturer
Содержит имя изготовителя устройства. Эта строка может быть пустой. Максимальная длина строки — MBN_MANUFACTURER_LEN. Определение MBN_MANUFACTURER_LEN см. в разделе MBN_INTERFACE_CAPS_CONSTANTS. Вызывающий объект должен освободить эту строку, вызвав SysFreeString.
model
Содержит модель устройства. Эта строка может быть пустой. Максимальная длина этой строки составляет MBN_MODEL_LEN. Определение MBN_MODEL_LEN см. в разделе MBN_INTERFACE_CAPS_CONSTANTS. Вызывающий объект должен освободить эту строку, вызвав SysFreeString.
firmwareInfo
Содержит сведения о встроенном ПО для этого устройства. Эта строка может быть пустой. Максимальная длина строки — MBN_FIRMWARE_LEN. Определение MBN_FIRMWARE_LEN см. в разделе MBN_INTERFACE_CAPS_CONSTANTS. Вызывающий объект должен освободить эту строку, вызвав SysFreeString.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 7 [классические приложения | Приложения UWP] |
| Минимальная версия сервера | Ни одна версия не поддерживается |
| Верхняя часть | mbnapi.h |