Поделиться через


структура 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