estructura WWAN_SIGNAL_STATE (wwan.h)

La estructura WWAN_SIGNAL_STATE representa el estado de señal del dispositivo MB.

Sintaxis

typedef struct _WWAN_SIGNAL_STATE {
  ULONG            Rssi;
  ULONG            ErrorRate;
  ULONG            RssiInterval;
  ULONG            RssiThreshold;
  WWAN_LIST_HEADER SignalStateListHeader;
} WWAN_SIGNAL_STATE, *PWWAN_SIGNAL_STATE;

Miembros

Rssi

Valor que representa la intensidad de la señal inalámbrica. Los controladores de minipuerto que informan de su WWAN_CELLULAR_CLASS para que sean WwanClassGSM o WwanClassCLASSFILE deben notificar Rssi en decibelios por encima del suelo de ruido de sensibilidad del dispositivo.

Intensidad de señal (en dBm)	Valor codificado (Mínimo=0, Máximo=31)
-113 o menos	0
-111	1
-109	2
...	...
-51 o superior	31
Desconocido o no detectable	WWAN_RSSI_UNKNOWN

 

Los dispositivos basados en FRAMEWORK deben notificar la intensidad de la señal en función de RSSI compensado (cuentas para el ruido) y no en función de RSSI sin procesar.

ErrorRate

Valor codificado que representa un intervalo de porcentajes de tasas de error. En el caso de los dispositivos basados en GSM, use los valores de la columna Tasa de errores de bits del canal en la tabla siguiente. En el caso de los dispositivos basados en LEE, utilice los valores de la columna Velocidad de errores de fotogramas. En ambos casos, use WWAN_ERROR_RATE_UNKNOWN para indicar una tasa de errores desconocida.

Tasa de errores de bits de canal (en %)	Tasa de errores de fotogramas (en %)	Valor codificado (Min=0, Max=7)
< 0.2	< 0.01	0
0.2-0.4	0.01-0.1	1
0.4-0.8	0.1-0.5	2
0.8-1.6	0.5-1.0	3
- 3.2	1.0 - -2.0	4
- 6.4	2.0-4.0	5
6.4-12.8	4.0-8.0	6
> 12.8	> 8.0	7
Desconocido o no detectable		WWAN_ERROR_RATE_UNKNOWN

RssiInterval

El intervalo actual, en segundos, en el que el controlador de minipuerto se ha establecido en (o el intervalo predeterminado, si no se ha establecido uno), que el controlador de minipuerto proporcionará actualizaciones sobre el estado de la señal. Especifique WWAN_RSSI_DISABLE para indicar que el controlador de minipuerto no implementa informes basados en intervalos. Los controladores de minipuerto deben rellenar este miembro con el intervalo en respuesta a una solicitud anterior del servicio MB para WWAN_RSSI_DEFAULT.

RssiThreshold

El umbral actual, en unidades de umbral, en el que el controlador de minipuerto se ha establecido en (o el intervalo predeterminado, si no se ha establecido uno), que el controlador de minipuerto proporcionará actualizaciones sobre el estado de la señal. Especifique WWAN_RSSI_DISABLE para indicar que el controlador de miniporte no implementa informes basados en umbrales. Los controladores de minipuerto deben rellenar este miembro con las unidades de umbral en respuesta a una solicitud anterior del servicio MB para WWAN_RSSI_DEFAULT.

SignalStateListHeader

Estructura de WWAN_LIST_HEADER con formato que representa una lista de extensiones de estado de señal por clase de datos y el número de clases de datos. El controlador de minipuerto debe devolver una lista de todas las clases de datos admitidas.

Este miembro apunta a una lista de estructuras de WWAN_SIGNAL_STATE_EXT que usan la estructura WWAN_LIST_HEADER . El resto de los miembros de las estructuras de WWAN_SIGNAL_STATE_EX se rellenan en función de la clase de datos más alta disponible.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Windows 7 y versiones posteriores de Windows.
Encabezado	wwan.h (incluye Wwan.h)

Consulte también

NDIS_WWAN_SIGNAL_STATE