estructura WWAN_DEVICE_CAPS_EX_REV1 (wwan.h)
Importante
Comunicación sin prejuicios
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 sesgo reconoce como exclusionary. La palabra o frase se usa en este artículo para la coherencia porque aparece actualmente en el software. Cuando el software se actualice 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 siguientes campos:
- WwanSimClassBitMasks
- WwanWCLASSBandClass
- 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 minipuerto deben establecer el tipo de dispositivo para que sea un valor distinto de WwanDeviceTypeUnknown.
WwanCellularClass
Clase de telefonía móvil del dispositivo. Los controladores de minipuerto deben establecer la clase de telefonía móvil para que sea un valor distinto de WwanClassUnknown. Los valores de estas características de control de miembros 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 minipuerto 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 cómo interactúa dicho servicio con el servicio de datos. Tenga en cuenta que el servicio MB no admite la voz conmutada por circuito de forma nativa, ni tampoco lo impide. Es el controlador de minipuerto para determinar cómo admitir la voz del circuito. Este miembro 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 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 de Servicio general de radio de paquetes (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 De 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 del Sistema universal de telecomunicaciones móviles (UMTS). Este valor solo se aplica a los dispositivos basados en GSM. |
| WWAN_DATA_CLASS_HSDPA | High-Speed servicio de datos de acceso a paquetes de vínculo descendente (HSDPA) se admite. Este valor solo se aplica a los dispositivos basados en GSM. |
| WWAN_DATA_CLASS_HSUPA | se admite High-Speed servicio de datos de 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 ACRONIS sincrónico de división de tiempo. |
| WWAN_DATA_CLASS_1XRTT | Se admite el servicio de datos de tecnología de transmisión de radio 1x (1xRTT, también conocido como storage2000, CDMA2000 1x, etc.). Este valor solo se aplica a los dispositivos basados en FRAMEWORK. |
| WWAN_DATA_CLASS_1XEVDO | Se admite 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 FRAMEWORK. |
| WWAN_DATA_CLASS_1XEVDO_REVA | Se admite el servicio de datos 1xEVDO RevA. Este valor solo se aplica a los dispositivos basados en FRAMEWORK. |
| WWAN_DATA_CLASS_1XEVDV | Se admite el servicio de datos PRÉ evolution-data/voice (también conocido como FRAMEWORK 2000 1x EV-DV o 1x EVDV). Este valor solo se aplica a los dispositivos basados en FRAMEWORK. |
| WWAN_DATA_CLASS_3XRTT | Se admite el servicio de datos de tecnología de transmisión de radio 3x (3xRTT). Este valor solo se aplica a los dispositivos basados en FRAMEWORK. |
| WWAN_DATA_CLASS_1XEVDO_REVB | Se admite el servicio de datos 1xEVDO RevB. Este valor solo se aplica a los dispositivos basados en FRAMEWORK. |
| WWAN_DATA_CLASS_UMB | Se admite el servicio de datos UMB. Este valor solo se aplica a los dispositivos basados en FRAMEWORK. |
| 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 minipuerto establece el bit de WWAN_DATA_CLASS_CUSTOM en el miembro WwanDataClass .
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 de UMTS2100. |
| WWAN_BAND_CLASS_II | El dispositivo admite el espectro de UMTS1900. |
| WWAN_BAND_CLASS_III | El dispositivo admite el espectro de UMTS1800. |
| WWAN_BAND_CLASS_IV | El dispositivo admite el espectro de AWS. |
| WWAN_BAND_CLASS_V | El dispositivo admite el espectro de UMTS850. |
| WWAN_BAND_CLASS_VI | El dispositivo admite el espectro de 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 minipuerto 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, consulte OID_WWAN_DEVICE_CAPS.
WwanCdmaBandClass
Mapa de bits que representa las bandas de frecuencia compatibles con dispositivos basados en MAP. 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 admite 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 de IMT2000 de 2,5 GHz. |
| WWAN_BAND_CLASS_XIV | El dispositivo es compatible con la banda US PCS 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 2,5 GHz de EE. UU. |
| WWAN_BAND_CLASS_XVII | El dispositivo es compatible con la banda us.2.5 GHz Forward Link Only. |
| WWAN_BAND_CLASS_CUSTOM | El dispositivo admite una banda distinta de las bandas enumeradas en esta tabla. |
Si el controlador de minipuerto 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, consulte 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 miniporta establece el bit de WWAN_BAND_CLASS_CUSTOM en los miembros WwanGsmBandClass o WwanClass, 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. En el caso de los dispositivos basados en INDEFINIDA, este valor significa que el dispositivo es capaz de enviar mensajes SMS en formato binario tal y 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. En el caso de los dispositivos basados en SERVICE, este valor significa que el dispositivo es capaz de leer los mensajes SMS en formato binario tal y 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 FRAMEWORK. |
| WWAN_SMS_CAPS_TEXT_RECEIVE | El dispositivo admite la recepción de mensajes SMS de estilo texto. Esta marca se aplica a los dispositivos basados en FRAMEWORK. |
Los controladores de minipuerto 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 minipuerto recibe un SMS en el formato nativo de la clase de telefonía móvil, por ejemplo, el NAME TEXT o NAME PDU, el controlador de minipuerto es necesario para realizar la traducción a GSM PDU e indicarlo al servicio MB. Del mismo modo, si el controlador de minipuerto recibe una solicitud de envío en formato PDU GSM, es necesario realizar la traducción a su formato de clase celular nativa.
WwanControlCaps
Mapa de bits que representa las funciones de control que admite el dispositivo. En la tabla siguiente se muestran los valores válidos de WwanControlCaps para dispositivos basados en GSM y basados en FRAMEWORK.
| Valor | Significado |
|---|---|
| WWAN_CTRL_CAPS_REG_MANUAL | Indica si la red del proveedor permite la selección manual de red. Los controladores miniporte para dispositivos basados en GSM deben especificar esta marca. Los controladores de minipuerto para dispositivos basados en FRAMEWORK no deben especificar esta marca. |
| WWAN_CTRL_CAPS_HW_RADIO_SWITCH | Indica la presencia de un conmutador de alimentación de radio de hardware. Esto corresponde al valor WwanDeviceTypeEmbedded de la enumeración WWAN_DEVICE_TYPE. |
| WWAN_CTRL_CAPS_CDMA_MOBILE_IP | Indica que el dispositivo basado en FRAMEWORK está configurado para admitir ip móvil. Esta marca solo se aplica a los dispositivos basados en FRAMEWORK. Los controladores de minipuerto 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 FRAMEWORK está configurado para una compatibilidad ip sencilla. Esta marca solo se aplica a los dispositivos basados en FRAMEWORK. Los controladores de minipuerto 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 FRAMEWORK está configurado para admitir ip móvil, con ip simple como opción de reserva. |
| WWAN_CTRL_CAPS_PROTECT_UNIQUEID | Indica que Windows no debe mostrar la identidad de 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 la recepción de mensajes USSD establecen esta marca. Los controladores 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, incluso si el lado EVALÚA de la red no es compatible con 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 (Radio Access Technologies). |
Los controladores de miniporte de dispositivos basados en SERVICE 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 cumplir con el formato de Identidad internacional de equipos móviles (IMEI) (hasta 15 dígitos).
Para los dispositivos basados en LAU, 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 minipuerto compatibles con varios modos, por ejemplo aquellos que establecen la marca 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 desbloquear.
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 minipuerto deben aplicar este límite si se produce 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 en la que el sistema operativo es consciente.
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 | 0h | El dispositivo y el controlador no admiten extensiones de servicio opcionales. | |||||||||||||||
| WWAN_OPTIONAL_SERVICE_CAPS_LTE_ATTACH | 1h | El dispositivo y el controlador admiten la configuración de conexión LTE y los SIGUIENTES CID de MBIM:
|
|||||||||||||||
| WWAN_OPTIONAL_SERVICE_CAPS_CONTEXT_MGMT | 2h | El dispositivo y el controlador admiten el sistema operativo que administra los contextos aprovisionados del módem y el siguiente CID de MBIM:
|
|||||||||||||||
| WWAN_OPTIONAL_SERVICE_CAPS_MULTI_SIM | 4h | El dispositivo y el controlador admiten multi-SIM/multiexecutores y los siguientes identificadores de usuario: | |||||||||||||||
| WWAN_OPTIONAL_SERVICE_CAPS_EX_SAR | 8h | El dispositivo y el controlador admiten la configuración de SAR desde el sistema operativo y los siguientes CID de MBIM:
|
|||||||||||||||
| WWAN_OPTIONAL_SERVICE_CAPS_NETWORK_BLACKLIST | 16h | El dispositivo y el controlador admiten la configuración de la lista de remitentes bloqueados de red desde el sistema operativo y el siguiente CID de MBIM:
|
|||||||||||||||
| 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.
|
CellularClassListHeader
Objeto con formato WWAN_LIST_HEADER 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 de WWAN_LIST_HEADER se establece en el número de clases móviles que siguen la estructura WWAN_LIST_HEADER. Los dispositivos MB que no son compatibles con varios modos deben establecer ElementCount en 0.
Comentarios
Los controladores de minipuerto 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 minipuerto establece la marca WWAN_DATA_CLASS_CUSTOM, el controlador de minipuerto 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-S FRAMEWORK. Si el controlador de minipuerto admite TD-SCLASS, debe especificar WWAN_DATA_CLASS_CUSTOM en el miembro WwanDataClass y la cadena "TD-SCLASS" en el miembro CustomDataClass .
En el caso de los dispositivos basados en STORAGE, solo se deben especificar los servicios de datos relacionados con SERVICE. 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 la integridad.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 10, versión 2004 |
| Encabezado | wwan.h |