estructura WWAN_DEVICE_CAPS_EX_REV1 (wwan.h)

Artículo
02/07/2025

Importante

Comunicación sin sesgos

Microsoft admite un entorno diverso e inclusivo. Este artículo contiene referencias a la terminología que la guía de estilo de Microsoft para la comunicación sin sesgos reconoce como excluyente. La palabra o frase se usa en este artículo para la coherencia porque aparece actualmente en el software. Cuando el software se actualiza para quitar el idioma, este artículo se actualizará para que esté en alineación.

La estructura WWAN_DEVICE_CAPS_EX_REV1 representa las funciones de un dispositivo de banda ancha móvil. WWAN_DEVICE_CAPS_EX_REV1 actualiza la estructura de WWAN_DEVICE_CAPS_EX existente quitando los campos siguientes:

WwanSimClassBitMasks
WwanWCDMABandClass
WwanLTEBandClass
WwanNRBandClass
WwanMiscCaps

Sintaxis

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;

Miembros

WwanDeviceType

Tipo del dispositivo. Los controladores de miniport deben establecer el tipo de dispositivo para que sea un valor distinto de WwanDeviceTypeUnknown.

WwanCellularClass

La clase de telefonía móvil del dispositivo. Los controladores de miniport deben establecer la clase de telefonía móvil para que sea un valor distinto de WwanClassUnknown. Los valores de esta característica de control de miembro que son específicas de la tecnología de telefonía móvil, como los modos de registro del proveedor de red.

Los controladores de miniport que admiten el modo múltiple deben establecerlo en WwanClassGsm.

WwanVoiceClass

Clase de voz del dispositivo. Este miembro informa al servicio MB sobre la presencia del servicio de voz del circuito y de cómo este servicio interactúa con el servicio de datos. Tenga en cuenta que el servicio MB no admite la voz conmutada por circuito de forma nativa, ni lo impide. Es hasta el controlador de miniportar para determinar cómo admitir la voz del circuito. Este miembro de WwanVoiceClass permite que el servicio MB admita esta característica en el futuro.

WwanSimClass

Clase del módulo de identidad del suscriptor (tarjeta SIM). Los controladores de miniport deben establecer la clase SIM para que sea un valor distinto de WwanSimClassUnknown.

WwanDataClass

Mapa de bits que representa las clases de datos que admite el dispositivo. En la tabla siguiente se muestran los valores posibles para este miembro.

Valor	Significado
WWAN_DATA_CLASS_NONE	El dispositivo no admite el servicio de datos.
WWAN_DATA_CLASS_GPRS	Se admite el servicio de datos general packet Radio Service (GPRS). Este valor solo se aplica a los dispositivos basados en GSM.
WWAN_DATA_CLASS_EDGE	Se admiten datos mejorados para el servicio de datos Evolución global (EDGE). Este valor solo se aplica a los dispositivos basados en GSM.
WWAN_DATA_CLASS_UMTS	Se admite el servicio de datos Universal Mobile Telecommunications System (UMTS). Este valor solo se aplica a los dispositivos basados en GSM.
WWAN_DATA_CLASS_HSDPA	se admite High-Speed servicio de datos de acceso a paquetes de vínculo descendente (HSDPA). Este valor solo se aplica a los dispositivos basados en GSM.
WWAN_DATA_CLASS_HSUPA	se admite High-Speed servicio de datos acceso a paquetes de vínculo superior (HSUPA). Este valor solo se aplica a los dispositivos basados en GSM.
WWAN_DATA_CLASS_LTE	Se admite el servicio de datos LTE. Este valor solo se aplica a los dispositivos basados en GSM.
WWAN_DATA_CLASS_5G	Se admite el servicio de datos 5G.
WWAN_DATA_CLASS_TDSCDMA	Se admite el servicio de datos CDMA sincrónico de división de tiempo.
WWAN_DATA_CLASS_1XRTT	La tecnología de transmisión de radio CDMA 1x (1xRTT, también conocida como cdma2000, CDMA2000 1x, etc.) se admite el servicio de datos. Este valor solo se aplica a los dispositivos basados en CDMA.
WWAN_DATA_CLASS_1XEVDO	Se admite el servicio de datos CDMA Evolution-Data Optimizado (originalmente Solo datos, 1xEDVO, también conocido como CDMA2000 1x EV-DO o 1x EVDO). Este valor solo se aplica a los dispositivos basados en CDMA.
WWAN_DATA_CLASS_1XEVDO_REVA	Se admite el servicio de datos 1xEVDO RevA. Este valor solo se aplica a los dispositivos basados en CDMA.
WWAN_DATA_CLASS_1XEVDV	Se admite el servicio de datos CDMA Evolution-Data/Voice (también conocido como CDMA 2000 1x EV-DV o 1x EVDV). Este valor solo se aplica a los dispositivos basados en CDMA.
WWAN_DATA_CLASS_3XRTT	Se admite el servicio de datos CDMA 3x Radio Transmission Technology (3xRTT). Este valor solo se aplica a los dispositivos basados en CDMA.
WWAN_DATA_CLASS_1XEVDO_REVB	Se admite el servicio de datos 1xEVDO RevB. Este valor solo se aplica a los dispositivos basados en CDMA.
WWAN_DATA_CLASS_UMB	Se admite el servicio de datos UMB. Este valor solo se aplica a los dispositivos basados en CDMA.
WWAN_DATA_CLASS_CUSTOM	El dispositivo admite un servicio de datos que no aparece en esta tabla.

CustomDataClass[WWAN_CUSTOM_DATA_CLASS_LEN]

Cadena terminada en NULL que representa el nombre de la clase de datos personalizada. Este miembro solo es válido cuando el controlador de miniporta establece el bit de WWAN_DATA_CLASS_CUSTOM en el miembro wwanDataClass de.

WwanGsmBandClass

Mapa de bits que representa la compatibilidad de los dispositivos basados en GSM de bandas de frecuencia. En la tabla siguiente se muestran los valores posibles para este miembro.

Valor	Significado
WWAN_BAND_CLASS_UNKNOWN	No se da la banda de frecuencia compatible con el dispositivo.
WWAN_BAND_CLASS_I	El dispositivo admite el espectro UMTS2100.
WWAN_BAND_CLASS_II	El dispositivo admite el espectro UMTS1900.
WWAN_BAND_CLASS_III	El dispositivo admite el espectro UMTS1800.
WWAN_BAND_CLASS_IV	El dispositivo admite el espectro de AWS.
WWAN_BAND_CLASS_V	El dispositivo admite el espectro UMTS850.
WWAN_BAND_CLASS_VI	El dispositivo admite el espectro UMTS800.
WWAN_BAND_CLASS_VII	El dispositivo admite el espectro de UMTS2600.
WWAN_BAND_CLASS_VIII	El dispositivo admite el espectro de UMTS900.
WWAN_BAND_CLASS_IX	El dispositivo admite el espectro de UMTS1700.
WWAN_BAND_CLASS_X
WWAN_BAND_CLASS_CUSTOM	El dispositivo admite un espectro distinto de los enumerados en esta tabla.

Si el controlador de miniporte especifica WWAN_BAND_CLASS_CUSTOM, también debe proporcionar el nombre de la clase de datos en CustomBandClass.

Para obtener más información sobre estos valores, vea OID_WWAN_DEVICE_CAPS.

WwanCdmaBandClass

Mapa de bits que representa la compatibilidad con dispositivos basados en CDMA de bandas de frecuencia. En la tabla siguiente se muestran los valores posibles para este miembro.

Valor	Significado
WWAN_BAND_CLASS_UNKNOWN	No se da la banda de frecuencia compatible con el dispositivo.
WWAN_BAND_CLASS_0	El dispositivo admite la banda de 800 MHz.
WWAN_BAND_CLASS_I	El dispositivo admite la banda de 1900MHz.
WWAN_BAND_CLASS_II	El dispositivo admite la banda TACS.
WWAN_BAND_CLASS_III	El dispositivo admite la banda JTACS.
WWAN_BAND_CLASS_IV	El dispositivo es compatible con la banda de PCS coreano.
WWAN_BAND_CLASS_V	El dispositivo admite la banda de 450 MHz.
WWAN_BAND_CLASS_VI	El dispositivo admite la banda de 2 GHz.
WWAN_BAND_CLASS_VII	El dispositivo admite la banda de 700 MHz.
WWAN_BAND_CLASS_VIII	El dispositivo admite la banda de 1800 MHz.
WWAN_BAND_CLASS_IX	El dispositivo admite la banda de 900 MHz.
WWAN_BAND_CLASS_X	El dispositivo admite la banda secundaria de 800 MHz.
WWAN_BAND_CLASS_XI	El dispositivo admite la banda PAMR europea de 400 MHz.
WWAN_BAND_CLASS_XII	El dispositivo admite la banda PAMR de 800 MHz.
WWAN_BAND_CLASS_XIII	El dispositivo admite la banda de extensión IMT2000 de 2,5 GHz.
WWAN_BAND_CLASS_XIV	El dispositivo admite la banda PCS de EE. UU. de 1,9 GHz.
WWAN_BAND_CLASS_XV	El dispositivo admite la banda de AWS.
WWAN_BAND_CLASS_XVI	El dispositivo admite la banda de EE. UU. de 2,5 GHz.
WWAN_BAND_CLASS_XVII	El dispositivo admite la banda de solo vínculo hacia delante de EE. UU. de 2,5 GHz.
WWAN_BAND_CLASS_CUSTOM	El dispositivo admite una banda distinta de las bandas enumeradas en esta tabla.

Si el controlador de miniporte especifica WWAN_BAND_CLASS_CUSTOM, también debe proporcionar el nombre de la clase de datos en CustomBandClass.

Para obtener más información sobre estos valores, vea OID_WWAN_DEVICE_CAPS.

CustomBandClass[WWAN_CUSTOM_BAND_CLASS_LEN]

Cadena terminada en NULL que representa el nombre de la clase de banda personalizada. Este miembro solo es válido cuando el controlador de miniporte establece el bit de WWAN_BAND_CLASS_CUSTOM en los miembros WwanGsmBandClass o WwanCdmaBandClass, según corresponda.

WwanSmsCaps

Mapa de bits que representa el tipo de mensajes SMS y flujo direccional que admite el dispositivo. En la tabla siguiente se muestra la configuración válida de las funcionalidades de SMS.

Valor	Significado
WWAN_SMS_CAPS_NONE	El dispositivo no admite mensajes SMS.
WWAN_SMS_CAPS_PDU_SEND	En el caso de los dispositivos basados en GSM, este valor significa que el dispositivo admite el envío de mensajes SMS de estilo PDU. Para los dispositivos basados en CDMA, este valor significa que el dispositivo es capaz de enviar mensajes SMS en formato binario tal como se define en la sección "3.4.2.1 SMS Point-to-Point Message" en la especificación 3GPP2 C.S0015-A "Short Message Service (SMS) for Wideband Spread Spectrum Systems".
WWAN_SMS_CAPS_PDU_RECEIVE	En el caso de los dispositivos basados en GSM, este valor significa que el dispositivo admite la recepción de mensajes SMS de estilo PDU. Para los dispositivos basados en CDMA, este valor significa que el dispositivo es capaz de leer los mensajes SMS en formato binario tal como se define en la sección "3.4.2.1 SMS Point-to-Point Message" en la especificación 3GPP2 C.S0015-A "Short Message Service (SMS) for Wideband Spread Spectrum Systems".
WWAN_SMS_CAPS_TEXT_SEND	El dispositivo admite el envío de mensajes SMS de estilo de texto. Esta marca se aplica a los dispositivos basados en CDMA.
WWAN_SMS_CAPS_TEXT_RECEIVE	El dispositivo admite la recepción de mensajes SMS de estilo de texto. Esta marca se aplica a los dispositivos basados en CDMA.

Los controladores de miniport deben establecer este miembro para reflejar la compatibilidad solo con el formato PDU GSM para recibir y enviar SMS cuando el proveedor principal actual es compatible con varios modos. Por lo tanto, si el controlador de miniporte recibe un SMS en el formato nativo de la clase de telefonía móvil, por ejemplo, CDMA TEXT o CDMA PDU, se requiere el controlador de miniporte para realizar la traducción a GSM PDU e indicarlo al servicio MB. Del mismo modo, si el controlador de miniporte recibe una solicitud de envío en formato PDU GSM, es necesario realizar la traducción a su formato nativo de clase de telefonía móvil.

WwanControlCaps

Mapa de bits que representa las funcionalidades de control que admite el dispositivo. En la tabla siguiente se muestra la configuración válida de WwanControlCaps para dispositivos basados en GSM y basados en CDMA.

Valor	Significado
WWAN_CTRL_CAPS_REG_MANUAL	Indica si la red del proveedor permite la selección manual de red. Los controladores de minipuerto para dispositivos basados en GSM deben especificar esta marca. Los controladores de miniport para dispositivos basados en CDMA no deben especificar esta marca.
WWAN_CTRL_CAPS_HW_RADIO_SWITCH	Indica la presencia de un conmutador de alimentación radiofónica de hardware. Esto corresponde al wwanDeviceTypeEmbedded valor de la enumeración WWAN_DEVICE_TYPE.
WWAN_CTRL_CAPS_CDMA_MOBILE_IP	Indica que el dispositivo basado en CDMA está configurado para admitir ip móvil. Esta marca solo se aplica a los dispositivos basados en CDMA. Los controladores de miniport no deben establecer esta marca cuando el proveedor principal actual es compatible con varios modos.
WWAN_CTRL_CAPS_CDMA_SIMPLE_IP	Indica que el dispositivo basado en CDMA está configurado para una compatibilidad ip sencilla. Esta marca solo se aplica a los dispositivos basados en CDMA. Los controladores de miniport no deben establecer esta marca cuando el proveedor principal actual es compatible con varios modos.
WWAN_CTRL_CAPS_CDMA_MOBILE_IP combinado con WWAN_CTRL_CAPS_CDMA_SIMPLE_IP	Indica que el dispositivo basado en CDMA está configurado para admitir ip móvil, con una dirección IP simple como opción de reserva.
WWAN_CTRL_CAPS_PROTECT_UNIQUEID	Indica que Windows no debe mostrar la identidad del suscriptor móvil internacional (IMSI).
WWAN_CTRL_CAPS_USSD	Indica que el dispositivo MB basado en GSM está configurado para admitir el protocolo USSD. Esta marca solo se aplica a los dispositivos basados en GSM. Los controladores de miniporte que admiten el envío y recepción de mensajes USSD establecen esta marca. Los controladores de miniporte pueden establecer esta marca cuando el lado GSM de los proveedores domésticos compatibles con múltiples modos actuales de la red admite USSD aunque el lado CDMA de la red no admita USSD.
WWAN_CTRL_CAPS_MODEL_MULTI_CARRIER	Indica que el dispositivo MB admite el registro y la conexión a varios operadores de red.
WWAN_CTRL_CAPS_MULTI_MODE	Esta marca indica que el proveedor principal actual admite varias clases de telefonía móvil o RAT (Tecnologías de acceso de radio).

Los controladores de miniportar de dispositivos basados en CDMA deben especificar WWAN_CTRL_CAPS_CDMA_MOBILE_IP, o WWAN_CTRL_CAPS_CDMA_SIMPLE_IP, o ambas marcas para informar al servicio MB sobre el tipo de IP que admite el dispositivo.

DeviceId[WWAN_DEVICEID_LEN]

Cadena terminada en NULL que representa el identificador del dispositivo.

En el caso de los dispositivos basados en GSM, la cadena debe ajustarse al formato De Identidad internacional de equipos móviles (IMEI) (hasta 15 dígitos).

Para los dispositivos basados en CDMA, la cadena debe cumplir con los formatos número de serie electrónico (ESN, 11 dígitos) y identificador de equipo móvil (MEID, 17 dígitos).

En el caso de los controladores de miniport compatibles con varios modos, por ejemplo los que establecen la marca de WWAN_CTRL_CAPS_MULTI_MODE en WwanControlCaps, solo se debe notificar el DeviceId basado en GSM.

Este valor debe almacenarse en la memoria del dispositivo y debe estar disponible incluso cuando el dispositivo MB/SIM requiere un PIN para desbloquearlo.

Manufacturer[WWAN_MANUFACTURER_LEN]

Cadena terminada en NULL que representa el fabricante del dispositivo. Este miembro es opcional.

Model[WWAN_MODEL_LEN]

Cadena terminada en NULL que representa el modelo del dispositivo. Este miembro es opcional.

FirmwareInfo[WWAN_FIRMWARE_LEN]

Cadena terminada en NULL que representa la información específica del firmware sobre el dispositivo. Este miembro es opcional.

MaxActivatedContexts

Número máximo de contextos activados compatibles con el dispositivo. Los controladores de miniport deben aplicar este límite mediante un error en los intentos de activación que superen MaxActivatedContexts.

WwanAuthAlgoCaps

Mapa de bits que representa los tipos de métodos de autenticación que admite el dispositivo MB.

Valor	Significado
WWAN_AUTH_ALGO_CAPS_NONE	El dispositivo MB no admite ningún método de autenticación.
WWAN_AUTH_ALGO_CAPS_SIM	El dispositivo MB admite el método de autenticación SIM.
WWAN_AUTH_ALGO_CAPS_AKA	El dispositivo MB admite el método de autenticación AKA.
WWAN_AUTH_ALGO_CAPS_AKAP	El dispositivo MB admite el método de autenticación AKA' (AKA Prime).

ExecutorIndex

El miembro WwanDeviceType para WWAN_DEVICE_CAPS_EX_REV1 ya no hace referencia al dispositivo módem, sino a un ejecutor individual. Cada dispositivo es una entidad del ejecutor de RF que reconoce el sistema operativo.

WwanOptionalServiceCaps

Estructura ULONG que representa las extensiones de servicio de Microsoft que admite el módem subyacente. Es una estructura de mapa de bits de 64 bits que cuyos bits no definidos están reservados y deben establecerse en "0". A medida que se introducen nuevas extensiones de servicio, los bits reservados se usarán para representar las nuevas extensiones de servicio.

Valor

Máscara

Significado

WWAN_OPTIONAL_SERVICE_CAPS_NONE

El dispositivo y el controlador no admiten extensiones de servicio opcionales.

WWAN_OPTIONAL_SERVICE_CAPS_LTE_ATTACH

El dispositivo y el controlador admiten la configuración de conexión LTE y los siguientes CID de MBIM:

MBIM_CID_MS_LTE_ATTACH_CONFIG
MBIM_CID_MS_LTE_ATTACH_STATUS

WWAN_OPTIONAL_SERVICE_CAPS_CONTEXT_MGMT

El dispositivo y el controlador admiten los contextos aprovisionados del módem y el siguiente CID de MBIM:

MBIM_CID_PROVISIONED_CONTEXT_V2

WWAN_OPTIONAL_SERVICE_CAPS_MULTI_SIM

El dispositivo y el controlador admiten varios ejecutores sim/multiexecutores y los siguientes OID:

WWAN_OPTIONAL_SERVICE_CAPS_EX_SAR

El dispositivo y el controlador admiten la configuración de SAR desde el sistema operativo y los siguientes CID de MBIM:

MBIM_CID_MS_SAR_CONFIG
MBIM_CID_MS_TRANSMISSION_STATUS

WWAN_OPTIONAL_SERVICE_CAPS_NETWORK_BLACKLIST

16h

El dispositivo y el controlador admiten la configuración de la lista de remitentes bloqueados de red del sistema operativo y el siguiente CID de MBIM:

MBIM_CID_MS_NETWORK_BLACKLIST

WWAN_OPTIONAL_SERVICE_CAPS_5G_NSA

El dispositivo y el controlador admiten todas las nuevas extensiones relacionadas con 5G en Windows 10, versión 1903. En la tabla siguiente se muestran los mensajes NDIS y sus revisiones que el controlador de miniporte debe admitir si se establece este bit.

OID	Mensaje	Revisión
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

Objeto WWAN_LIST_HEADER con formato que representa una lista de clases de telefonía móvil que admite un dispositivo compatible con varios modos. El miembro ElementType de WWAN_LIST_HEADER siempre debe establecerse en WwanStructClass. El miembro ElementCount en WWAN_LIST_HEADER se establece en el número de clases de telefonía móvil que siguen la estructura de WWAN_LIST_HEADER. Los dispositivos MB que no son compatibles con varios modos deben establecer ElementCount en 0.

Observaciones

Los controladores de miniport deben especificar WWAN_DATA_CLASS_CUSTOM si el servicio de datos admitido por el dispositivo no pertenece a ninguno de los demás valores definidos en la tabla para el miembro WwanDataClass. Si un controlador de miniporte establece la marca de WWAN_DATA_CLASS_CUSTOM, el controlador de miniporte también debe proporcionar el nombre de la clase de datos en el miembro customDataClass.

En el caso de los dispositivos basados en GSM, solo se deben especificar clases de datos basadas en GSM. Por ejemplo, GPRS, EDGE, UMTS, HSDPA, LTE y TD-SCDMA. Si el controlador de miniporte admite TD-SCDMA, debe especificar WWAN_DATA_CLASS_CUSTOM en el miembro de WwanDataClass y la cadena "TD-SCDMA" en el miembro CustomDataClass.

Para los dispositivos basados en CDMA, solo se deben especificar servicios de datos relacionados con CDMA. Por ejemplo, 1xRTT, 1xEV-DO, 1xEV-DO RevA y UMB. 1xEV-DO RevB se define para su uso futuro. 1xEV-DV y 3xRTT también se definen para su integridad.