структура WWAN_DEVICE_CAPS_EX_REV1 (wwan.h)

Статья
08/08/2023

Важно!

Обмен данными без смещения

Корпорация Майкрософт поддерживает разнообразную и инклюзивную среду. В этой статье содержатся ссылки на терминологию, которую руководство майкрософт по стилю для общения без предубеждений распознает как исключающую. Слово или фраза используется в этой статье для обеспечения согласованности, так как они в настоящее время отображаются в программном обеспечении. При обновлении программного обеспечения для удаления языка эта статья будет обновлена до выравнивания.

Структура WWAN_DEVICE_CAPS_EX_REV1 представляет возможности мобильного широкополосного устройства. WWAN_DEVICE_CAPS_EX_REV1 обновляет существующую структуру WWAN_DEVICE_CAPS_EX , удалив следующие поля:

WwanSimClassBitMasks
WwanWCDMABandClass
WwanLTEBandClass
WwanNRBandClass
WwanMiscCaps

Синтаксис

typedef struct _WWAN_DEVICE_CAPS_EX_REV1 {
  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;
  ULONG               ExecutorIndex;
  ULONG               WwanOptionalServiceCaps;
  WWAN_LIST_HEADER    CellularClassListHeader;
} WWAN_DEVICE_CAPS_EX_REV1, *PWWAN_DEVICE_CAPS_EX_REV1;

Члены

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, то драйвер мини-порта должен выполнить перевод в PDU GSM и указать его в службе MB. Аналогичным образом, если драйвер минипорта получает запрос на отправку в формате PDU в формате GSM, необходимо выполнить преобразование в собственный формат класса сотовой связи.

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

Растровое изображение, представляющее типы методов проверки подлинности, поддерживаемых устройством MB.

Значение	Значение
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).

ExecutorIndex

Член WwanDeviceType для WWAN_DEVICE_CAPS_EX_REV1 больше не относится к модему, а к отдельному исполнителю. Каждое устройство является субъектом-исполнителем RF, о котором известно ОС.

WwanOptionalServiceCaps

Структура ULONG, представляющая расширения служб Майкрософт, поддерживаемые базовым модемом. Это 64-битовая структура растрового изображения, для которой зарезервированы неопределенные биты и должны иметь значение "0". По мере введения новых расширений служб зарезервированные биты будут использоваться для представления новых расширений служб.

Значение

Mask

Значение

WWAN_OPTIONAL_SERVICE_CAPS_NONE

0ч

Устройство и драйвер не поддерживают дополнительные расширения служб.

WWAN_OPTIONAL_SERVICE_CAPS_LTE_ATTACH

1ч

Устройство и драйвер поддерживают конфигурацию подключения LTE и следующие CID MBIM:

MBIM_CID_MS_LTE_ATTACH_CONFIG
MBIM_CID_MS_LTE_ATTACH_STATUS

WWAN_OPTIONAL_SERVICE_CAPS_CONTEXT_MGMT

2 ч

Устройство и драйвер поддерживают ос, управляя контекстами, подготовленными модемом, и следующие идентификаторы CID MBIM:

MBIM_CID_PROVISIONED_CONTEXT_V2

WWAN_OPTIONAL_SERVICE_CAPS_MULTI_SIM

4 ч.

Устройство и драйвер поддерживают несколько SIM-карт или нескольких исполнителей и следующие идентификаторы OID:

WWAN_OPTIONAL_SERVICE_CAPS_EX_SAR

8 ч.

Устройство и драйвер поддерживают конфигурацию SAR из ОС и следующих CID MBIM:

MBIM_CID_MS_SAR_CONFIG
MBIM_CID_MS_TRANSMISSION_STATUS

WWAN_OPTIONAL_SERVICE_CAPS_NETWORK_BLACKLIST

16 ч

Устройство и драйвер поддерживают конфигурацию списка заблокированных в сети отправителей из ОС и следующего идентификатора CID MBIM:

MBIM_CID_MS_NETWORK_BLACKLIST

WWAN_OPTIONAL_SERVICE_CAPS_5G_NSA

Устройство и драйвер поддерживают все новые расширения, связанные с 5G, в Windows 10 версии 1903. В следующей таблице показаны сообщения NDIS и их редакции, которые должен поддерживать драйвер мини-порта, если задан этот бит.

OID	Сообщение	Редакция
WWAN_DEVICE_CAPS_EX	NDIS_WWAN_DEVICE_CAPS_EX	1
WWAN_REGISTER_STATE	NDIS_WWAN_REGISTRATION_STATE	3
WWAN_PACKET_SERVICE	NDIS_WWAN_PACKET_SERVICE_STATE	2
WWAN_SIGNAL_STATE	NDIS_WWAN_SIGNAL_STATE	2

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 также определены для полноты.