estructura WWAN_DEVICE_CAPS (wwan.h)

Artículo
03/05/2024

La estructura WWAN_DEVICE_CAPS representa las funciones del dispositivo MB.

Sintaxis

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;

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 la compatibilidad de los dispositivos basados en JAILBREAK de bandas de frecuencia. En la tabla siguiente se muestran los valores posibles para este miembro.

Valor	Significado
WWAN_BAND_CLASS_UNKNOWN	La banda de frecuencia admitida por el dispositivo no se da.
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 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 2,5 GHz de EE. UU.
WWAN_BAND_CLASS_XVII	El dispositivo admite la banda de vínculo de reenvío de 2,5 GHz de EE. UU.
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 minipuerto 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 POINT, 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 POINT, 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 texto. Esta marca se aplica a los dispositivos basados en JAILBREAK.
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 JAILBREAK.

Los controladores 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. Therefure, si el controlador de miniporte recibe un SMS en el formato nativo de la clase de telefonía móvil, por ejemplo, CONFIDENCIALIDAD TEXT o ICODE 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 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 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 PANEL.

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 miniporte para dispositivos basados en POINT 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 VOTADO está configurado para admitir ip móvil. Esta marca solo se aplica a los dispositivos basados en JAILBREAK. 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 NULL está configurado para una compatibilidad con IP sencilla. Esta marca solo se aplica a los dispositivos basados en JAILBREAK. 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 o con WWAN_CTRL_CAPS_CDMA_SIMPLE_IP	Indica que el dispositivo basado en NULL 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 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 minipuerto pueden establecer esta marca cuando el lado GSM actual de los proveedores domésticos compatibles con múltiples modos de la red admite USSD aunque el lado POINT 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 radio).

Los controladores miniporte de dispositivos basados en POINT 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).

En el caso de los dispositivos basados en NULL, 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).

Para los controladores de minipuerto compatibles con varios modos, por ejemplo aquellos 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 con errores 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).

Nota Este miembro solo es válido en Windows 8 y versiones posteriores, cuando se especifica NDIS_WWAN_DEVICE_CAPS_REVISION_2 en el sub-miembro Header.Revision de la estructura NDIS_WWAN_DEVICE_CAPS.

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 WwanStructPanelClass. 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 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 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-SGRAM. Si el controlador de minipuerto admite TD-S NULL, debe especificar WWAN_DATA_CLASS_CUSTOM en el miembro WwanDataClass y la cadena "TD-S NULL" en el miembro CustomDataClass .

En el caso de los dispositivos basados en STORAGE, solo se deben especificar los servicios de datos relacionados con STORAGE. 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.