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) |