структура WWAN_DEVICE_CAPS (wwan.h)
Структура WWAN_DEVICE_CAPS представляет возможности устройства с мб.
Синтаксис
typedef struct _WWAN_DEVICE_CAPS {
WWAN_DEVICE_TYPE WwanDeviceType;
WWAN_CELLULAR_CLASS WwanCellularClass;
WWAN_VOICE_CLASS WwanVoiceClass;
WWAN_SIM_CLASS WwanSimClass;
ULONG WwanDataClass;
WCHAR CustomDataClass[WWAN_CUSTOM_DATA_CLASS_LEN];
ULONG WwanGsmBandClass;
ULONG WwanCdmaBandClass;
WCHAR CustomBandClass[WWAN_CUSTOM_BAND_CLASS_LEN];
ULONG WwanSmsCaps;
ULONG WwanControlCaps;
WCHAR DeviceId[WWAN_DEVICEID_LEN];
WCHAR Manufacturer[WWAN_MANUFACTURER_LEN];
WCHAR Model[WWAN_MODEL_LEN];
WCHAR FirmwareInfo[WWAN_FIRMWARE_LEN];
ULONG MaxActivatedContexts;
ULONG WwanAuthAlgoCaps;
WWAN_LIST_HEADER CellularClassListHeader;
} WWAN_DEVICE_CAPS, *PWWAN_DEVICE_CAPS;
Члены
WwanDeviceType
Тип устройства. Драйверы мини-порта должны задать для типа устройства значение, отличное от WwanDeviceTypeUnknown.
WwanCellularClass
Класс сотовой связи устройства. Драйверы минипорта должны задать для класса сотовой связи значение, отличное от WwanCellularClassUnknown. Значения в этом элементе управления функциями, характерными для сотовой технологии, например режимы регистрации поставщика сетей.
Драйверы мини-портов, поддерживающие несколько режимов, должны иметь значение WwanCellularClassGsm.
WwanVoiceClass
Класс voice устройства. Этот участник информирует службу MB о наличии службы голосовой связи и о том, как эта служба взаимодействует со службой данных. Имейте в виду, что служба MB не поддерживает голос с переключением каналов в собственном коде и не исключает его. Это зависит от драйвера мини-порта, чтобы определить, как поддерживать голос цепи. Этот член WwanVoiceClass позволяет службе MB поддерживать эту функцию в будущем.
WwanSimClass
Класс модуля идентификации подписчика (SIM-карта). Для драйверов miniport необходимо задать для класса SIM-карты значение, отличное от WwanSimClassUnknown.
WwanDataClass
Растровое изображение, представляющее классы данных, поддерживаемые устройством. В следующей таблице показаны возможные значения для этого элемента.
| Значение | Значение |
|---|---|
| WWAN_DATA_CLASS_NONE | Устройство не поддерживает службу данных. |
| WWAN_DATA_CLASS_GPRS | Поддерживается служба данных общей службы передачи пакетов (JSON). Это значение применяется только к устройствам на основе GSM. |
| WWAN_DATA_CLASS_EDGE | Служба данных Enhanced Data for Global Evolution (EDGE) поддерживается. Это значение применяется только к устройствам на основе GSM. |
| WWAN_DATA_CLASS_UMTS | Поддерживается служба данных Универсальной мобильной телекоммуникационной системы (UMTS). Это значение применяется только к устройствам на основе GSM. |
| WWAN_DATA_CLASS_HSDPA | High-Speed поддерживается служба данных доступ к пакетам по нисходящей связи (HSDPA). Это значение применяется только к устройствам на основе GSM. |
| WWAN_DATA_CLASS_HSUPA | High-Speed поддерживается служба данных доступа к пакетам исходящей связи (HSUPA). Это значение применяется только к устройствам на основе GSM. |
| WWAN_DATA_CLASS_LTE | Поддерживается служба данных LTE. Это значение применяется только к устройствам на основе GSM. |
| WWAN_DATA_CLASS_5G | Поддерживается служба данных 5G. |
| WWAN_DATA_CLASS_TDSCDMA | Поддерживается синхронная служба данных CDMA по разделу времени. |
| WWAN_DATA_CLASS_1XRTT | Служба данных CDMA 1x Radio Transmission Technology (1xRTT, также известная как cdma2000, CDMA2000 1x и т. д.) поддерживается. Это значение применяется только к устройствам на основе CDMA. |
| WWAN_DATA_CLASS_1XEVDO | Поддерживается служба данных CDMA Evolution-Data Оптимизированная (изначально только данные, 1xEDVO, также известная как CDMA2000 1x EV-DO или 1x EVDO). Это значение применяется только к устройствам на основе CDMA. |
| WWAN_DATA_CLASS_1XEVDO_REVA | Поддерживается служба данных 1xEVDO RevA. Это значение применяется только к устройствам на основе CDMA. |
| WWAN_DATA_CLASS_1XEVDV | Поддерживается служба данных CDMA Evolution-Data/Voice (также известная как CDMA 2000 1x EV-DV или 1x EVDV). Это значение применяется только к устройствам на основе CDMA. |
| WWAN_DATA_CLASS_3XRTT | Поддерживается служба данных ТЕХНОЛОГИИ радиопередачи CDMA 3x (3xRTT). Это значение применяется только к устройствам на основе CDMA. |
| WWAN_DATA_CLASS_1XEVDO_REVB | Поддерживается служба данных 1xEVDO RevB. Это значение применяется только к устройствам на основе CDMA. |
| WWAN_DATA_CLASS_UMB | Поддерживается служба данных UMB. Это значение применяется только к устройствам на основе CDMA. |
| WWAN_DATA_CLASS_CUSTOM | Устройство поддерживает службу данных, не указанную в этой таблице. |
CustomDataClass[WWAN_CUSTOM_DATA_CLASS_LEN]
Строка, завершающаяся значением NULL, представляющая имя пользовательского класса данных. Этот элемент действителен, только если драйвер мини-порта задает бит WWAN_DATA_CLASS_CUSTOM в элементе WwanDataClass .
WwanGsmBandClass
Растровое изображение, представляющее частотные диапазоны, которые поддерживаются устройствами на основе СТАНДАРТА GSM. В следующей таблице показаны возможные значения для этого элемента.
| Значение | Значение |
|---|---|
| WWAN_BAND_CLASS_UNKNOWN | Диапазон частот, поддерживаемый устройством, не указан. |
| WWAN_BAND_CLASS_I | Устройство поддерживает спектр UMTS2100. |
| WWAN_BAND_CLASS_II | Устройство поддерживает спектр UMTS1900. |
| WWAN_BAND_CLASS_III | Устройство поддерживает спектр UMTS1800. |
| WWAN_BAND_CLASS_IV | Устройство поддерживает спектр AWS. |
| WWAN_BAND_CLASS_V | Устройство поддерживает спектр UMTS850. |
| WWAN_BAND_CLASS_VI | Устройство поддерживает спектр UMTS800. |
| WWAN_BAND_CLASS_VII | Устройство поддерживает спектр UMTS2600. |
| WWAN_BAND_CLASS_VIII | Устройство поддерживает спектр UMTS900. |
| WWAN_BAND_CLASS_IX | Устройство поддерживает спектр UMTS1700. |
| WWAN_BAND_CLASS_X | |
| WWAN_BAND_CLASS_CUSTOM | Устройство поддерживает спектр, отличный от перечисленных в этой таблице. |
Если драйвер мини-порта указывает WWAN_BAND_CLASS_CUSTOM, он также должен указать имя класса данных в CustomBandClass .
Дополнительные сведения об этих значениях см. в разделе OID_WWAN_DEVICE_CAPS.
WwanCdmaBandClass
Растровое изображение, представляющее частотные диапазоны, которые поддерживают устройства на основе CDMA. В следующей таблице показаны возможные значения для этого элемента.
| Значение | Значение |
|---|---|
| WWAN_BAND_CLASS_UNKNOWN | Диапазон частот, поддерживаемый устройством, не задан. |
| WWAN_BAND_CLASS_0 | Устройство поддерживает диапазон 800 МГц. |
| WWAN_BAND_CLASS_I | Устройство поддерживает диапазон 1900 МГц. |
| WWAN_BAND_CLASS_II | Устройство поддерживает диапазон TACS. |
| WWAN_BAND_CLASS_III | Устройство поддерживает диапазон JTACS. |
| WWAN_BAND_CLASS_IV | Устройство поддерживает корейский диапазон PCS. |
| WWAN_BAND_CLASS_V | Устройство поддерживает диапазон 450 МГц. |
| WWAN_BAND_CLASS_VI | Устройство поддерживает диапазон 2 ГГц. |
| WWAN_BAND_CLASS_VII | Устройство поддерживает диапазон 700 МГц. |
| WWAN_BAND_CLASS_VIII | Устройство поддерживает диапазон 1800 МГц. |
| WWAN_BAND_CLASS_IX | Устройство поддерживает диапазон 900 МГц. |
| WWAN_BAND_CLASS_X | Устройство поддерживает дополнительный диапазон 800 МГц. |
| WWAN_BAND_CLASS_XI | Устройство поддерживает европейский диапазон PAMR с частотой 400 МГц. |
| WWAN_BAND_CLASS_XII | Устройство поддерживает диапазон PAMR с частотой 800 МГц. |
| WWAN_BAND_CLASS_XIII | Устройство поддерживает диапазон расширения IMT2000 2,5 ГГц. |
| WWAN_BAND_CLASS_XIV | Устройство поддерживает диапазон PCS США 1,9 ГГц. |
| WWAN_BAND_CLASS_XV | Устройство поддерживает диапазон AWS. |
| WWAN_BAND_CLASS_XVI | Устройство поддерживает диапазон 2,5 ГГц в США. |
| WWAN_BAND_CLASS_XVII | Устройство поддерживает диапазон только для прямого канала с тактовой частотой 2,5 ГГц. |
| WWAN_BAND_CLASS_CUSTOM | Устройство поддерживает диапазон, отличный от полос, перечисленных в этой таблице. |
Если драйвер мини-порта указывает WWAN_BAND_CLASS_CUSTOM, он также должен указать имя класса данных в CustomBandClass .
Дополнительные сведения об этих значениях см. в разделе OID_WWAN_DEVICE_CAPS.
CustomBandClass[WWAN_CUSTOM_BAND_CLASS_LEN]
Строка с завершением NULL, представляющая имя пользовательского класса диапазона. Этот член действителен, только если драйвер мини-порта задает бит WWAN_BAND_CLASS_CUSTOM в членах WwanGsmBandClass или WwanCdmaBandClass соответствующим образом.
WwanSmsCaps
Растровое изображение, представляющее тип SMS-сообщений и направленный поток, поддерживаемый устройством. В следующей таблице показаны допустимые параметры возможностей SMS.
| Значение | Значение |
|---|---|
| WWAN_SMS_CAPS_NONE | Устройство не поддерживает SMS-сообщения. |
| WWAN_SMS_CAPS_PDU_SEND |
Для устройств на основе GSM это значение означает, что устройство поддерживает отправку SMS-сообщений в стиле PDU.
Для устройств на основе CDMA это значение означает, что устройство может отправлять SMS-сообщения в двоичном формате, как определено в разделе "3.4.2.1 SMS-сообщение типа "точка — точка" спецификации 3GPP2 C.S0015-A "Short Message Service (SMS) for Wideband Spread Spectrum Systems". |
| WWAN_SMS_CAPS_PDU_RECEIVE |
Для устройств на основе GSM это значение означает, что устройство поддерживает получение SMS-сообщений в стиле PDU.
Для устройств на основе CDMA это значение означает, что устройство может считывать SMS-сообщения в двоичном формате, как определено в разделе "3.4.2.1 SMS-сообщение типа "точка — точка" спецификации 3GPP2 C.S0015-A "Short Message Service (SMS) for Wideband Spread Spectrum Systems". |
| WWAN_SMS_CAPS_TEXT_SEND | Устройство поддерживает отправку текстовых SMS-сообщений. Этот флаг применяется к устройствам на основе CDMA. |
| WWAN_SMS_CAPS_TEXT_RECEIVE | Устройство поддерживает получение текстовых SMS-сообщений. Этот флаг применяется к устройствам на основе CDMA. |
Драйверы мини-порта должны настроить этот элемент, чтобы отразить поддержку только формата PDU GSM для получения и отправки SMS, если текущий домашний поставщик поддерживает многомодовый режим. Если драйвер минипорта получает SMS в собственном формате класса сотовой связи, например CDMA TEXT или CDMA PDU, то драйвер минипорта должен выполнить перевод в GSM PDU и указать его службе MB. Аналогичным образом, если драйвер минипорта получает запрос на отправку в формате GSM PDU, необходимо выполнить перевод в собственный формат класса сотовой связи.
WwanControlCaps
Растровое изображение, представляющее возможности управления, поддерживаемые устройством. В следующей таблице показаны допустимые параметры WwanControlCaps для устройств на основе GSM и CDMA.
| Значение | Значение |
|---|---|
| WWAN_CTRL_CAPS_REG_MANUAL | Указывает, допускает ли сеть поставщика выбор сети вручную. Этот флаг должен быть указан в драйверах miniport для устройств на основе GSM. Этот флаг не должен указываться в драйверах мини-портов для устройств на основе CDMA. |
| WWAN_CTRL_CAPS_HW_RADIO_SWITCH | Указывает на наличие аппаратного переключателя питания. Соответствует значению WwanDeviceTypeEmbedded перечисления WWAN_DEVICE_TYPE. |
| WWAN_CTRL_CAPS_CDMA_MOBILE_IP |
Указывает, что устройство на основе CDMA настроено для поддержки мобильных IP-адресов. Этот флаг применяется только к устройствам на основе CDMA.
Драйверы мини-портов не должны устанавливать этот флаг, если текущий домашний поставщик поддерживает несколько режимов. |
| WWAN_CTRL_CAPS_CDMA_SIMPLE_IP |
Указывает, что устройство на основе CDMA настроено для поддержки простых IP-адресов. Этот флаг применяется только к устройствам на основе CDMA.
Драйверы мини-портов не должны устанавливать этот флаг, если текущий домашний поставщик поддерживает несколько режимов. |
| WWAN_CTRL_CAPS_CDMA_MOBILE_IP с WWAN_CTRL_CAPS_CDMA_SIMPLE_IP | Указывает, что устройство на основе CDMA настроено для поддержки мобильного IP-адреса с простым IP-адресом в качестве резервного варианта. |
| WWAN_CTRL_CAPS_PROTECT_UNIQUEID | Указывает, что Windows не должна отображать международное удостоверение мобильного подписчика (IMSI). |
| WWAN_CTRL_CAPS_USSD |
Указывает, что на устройстве на основе GSM настроена поддержка протокола USSD. Этот флаг применяется только к устройствам на основе GSM.
Этот флаг задают драйверы мини-портов, поддерживающие отправку и получение сообщений USSD. Драйверы мини-порта могут установить этот флаг, если текущая многомодовая сторона сети домашних поставщиков, поддерживающих несколько режимов, поддерживает USSD, даже если cdma-сторона сети не поддерживает USSD. |
| WWAN_CTRL_CAPS_MODEL_MULTI_CARRIER | Указывает, что устройство в МБ поддерживает регистрацию и подключение к нескольким сетевым операторам. |
| WWAN_CTRL_CAPS_MULTI_MODE | Этот флаг указывает, что текущий домашний поставщик поддерживает несколько классов сотовой связи или РАТ (технологии радиодоступа). |
Драйверы мини-портов устройств на основе CDMA должны указывать WWAN_CTRL_CAPS_CDMA_MOBILE_IP, WWAN_CTRL_CAPS_CDMA_SIMPLE_IP или оба флага, чтобы сообщить службе MB о типе IP-адреса, который поддерживает устройство.
DeviceId[WWAN_DEVICEID_LEN]
Строка, завершающаяся значением NULL, представляющая идентификатор устройства.
Для устройств на основе GSM строка должна соответствовать формату IMEI (до 15 цифр).
Для устройств на основе CDMA строка должна соответствовать форматам Электронный серийный номер (ESN, 11 цифр) и Идентификатор мобильного оборудования (MEID, 17 цифр).
Для драйверов мини-портов с поддержкой нескольких режимов, например для драйверов, устанавливающих флаг WWAN_CTRL_CAPS_MULTI_MODE в WwanControlCaps, необходимо сообщать только идентификатор устройства на основе GSM.
Это значение должно храниться в памяти устройства и должно быть доступно, даже если для разблокировки устройства или SIM-карты в МБ требуется ПИН-код.
Manufacturer[WWAN_MANUFACTURER_LEN]
Строка, завершающаяся значением NULL, представляющая производителя устройства. Этот член является необязательным.
Model[WWAN_MODEL_LEN]
Строка, завершающаяся значением NULL, представляющая модель устройства. Этот член является необязательным.
FirmwareInfo[WWAN_FIRMWARE_LEN]
Строка, завершающаяся значением NULL, представляющая сведения об устройстве, относящиеся к встроенному ПО. Этот член является необязательным.
MaxActivatedContexts
Максимальное количество активированных контекстов, поддерживаемых устройством. Драйверы минипорта должны применять это ограничение, завершив сбой любых попыток активации, превышающих MaxActivatedContexts.
WwanAuthAlgoCaps
Растровое изображение, представляющее типы методов проверки подлинности, поддерживаемых устройством МБ.
| Значение | Значение |
|---|---|
| WWAN_AUTH_ALGO_CAPS_NONE | Устройство MB не поддерживает никакие методы проверки подлинности. |
| WWAN_AUTH_ALGO_CAPS_SIM | Устройство в МБ поддерживает метод проверки подлинности SIM-карты. |
| WWAN_AUTH_ALGO_CAPS_AKA | Устройство MB поддерживает метод проверки подлинности AKA. |
| WWAN_AUTH_ALGO_CAPS_AKAP | Устройство MB поддерживает метод проверки подлинности AKA ' (AKA Prime). |
CellularClassListHeader
Отформатированный объект WWAN_LIST_HEADER, представляющий список классов сотовой связи, поддерживаемых устройством с поддержкой нескольких режимов. Элемент ElementType в WWAN_LIST_HEADER всегда должен иметь значение WwanStructCellularClass. Для элемента ElementCount в WWAN_LIST_HEADER задается число классов сотовой связи, следуют за WWAN_LIST_HEADER структурой. Для устройств с несколькими режимами, которые не поддерживают несколько режимов, для элемента ElementCount должно быть задано значение 0.
Комментарии
Драйверы мини-порта должны указывать WWAN_DATA_CLASS_CUSTOM, если служба данных, поддерживаемая устройством, не принадлежит ни одному из других значений, определенных в таблице для элемента WwanDataClass . Если драйвер мини-порта устанавливает флаг WWAN_DATA_CLASS_CUSTOM, драйвер минипорта также должен указать имя класса данных в элементе CustomDataClass .
Для устройств на основе GSM необходимо указать только классы данных на основе GSM. Например, КОДОВ, EDGE, UMTS, HSDPA, LTE и TD-SCDMA. Если драйвер мини-порта поддерживает TD-SCDMA, он должен указать WWAN_DATA_CLASS_CUSTOM в элементе WwanDataClass и строку "TD-SCDMA" в элементе CustomDataClass .
Для устройств на основе CDMA необходимо указать только службы данных, связанные с CDMA. Например, 1xRTT, 1xEV-DO, 1xEV-DO RevA и UMB. 1xEV-DO RevB определен для использования в будущем. 1xEV-DV и 3xRTT также определены для полноты.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Доступно в Windows 8 и более поздних версиях Windows. |
| Верхняя часть | wwan.h (включая Wwan.h) |
См. также раздел
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по