estructura WWAN_SIGNAL_STATE_EXT (wwan.h)
La estructura WWAN_SIGNAL_STATE_EXT representa una extensión al estado de señal del dispositivo MB. En Windows 10, versión 1903 y posteriores, WWAN_SIGNAL_STATE_EX contiene información principal sobre el estado de señal del dispositivo, incluida una matriz de estructuras de WWAN_SIGNAL_STATE_EXT que contienen información de estado de señal específica de 5G.
Para obtener más información sobre la compatibilidad con clases de datos 5G, consulta Compatibilidad con clases de datos 5G de MB.
Sintaxis
typedef struct _WWAN_SIGNAL_STATE_EXT {
ULONG RSRP;
ULONG RSRPThreshold;
ULONG SNR;
ULONG SNRThreshold;
ULONG DataClass;
} WWAN_SIGNAL_STATE_EXT, *PWWAN_SIGNAL_STATE_EXT;
Miembros
RSRP
La señal de referencia recibió potencia (RSRP), que oscila entre -156 y -31, en unidades de 1 dBm. Use WWAN_RSRP_UNKNOWN cuando esta información no esté disponible. En la tabla siguiente se muestra cómo asignar el intervalo al miembro RSRP.
| Valor notificado | Valor de cantidad medido (L3 SS_RSRP) | Valor de cantidad medido (L1 SS-RSRP y CSI-RSRP) | Unidad |
|---|---|---|---|
| RSRP_0 | SS-RSRP-156< | No válido | Dbm |
| RSRP_1 | -156≤ SS-RSRP-55< | No válido | Dbm |
| RSRP_2 | -155≤ SS-RSRP-54< | No válido | Dbm |
| RSRP_3 | -154≤ SS-RSRP-153< | No válido | Dbm |
| RSRP_4 | -153≤ SS-RSRP-152< | No válido | Dbm |
| RSRP_5 | -152≤ SS-RSRP-151< | No válido | Dbm |
| ... | ... | ... | ... |
| RSRP_16 | -141≤ SS-RSRP-140< | No válido | Dbm |
| RSRP_17 | -140≤ SS-RSRP-139< | RSRP-139< dBm | |
| RSRP_18 | -139≤ SS-RSRP-138< | -139≤ RSRP-138< dBm | |
| ... | ... | ... | ... |
| RSRP_111 | -46≤ SS-RSRP-45< | -46≤ RSRP-45< | Dbm |
| RSRP_112 | -45≤ SS-RSRP-44< | -45≤ RSRP | Dbm |
| RSRP_113 | -44≤ SS-RSRP-43< | No válido | Dbm |
| RSRP_114 | -43≤ SS-RSRP-42< | No válido | Dbm |
| RSRP_115 | -42≤ SS-RSRP-41< | No válido | Dbm |
| RSRP_116 | -41≤ SS-RSRP-40< | No válido | Dbm |
| RSRP_117 | -40≤ SS-RSRP-39< | No válido | Dbm |
| RSRP_118 | -39≤ SS-RSRP-38< | No válido | Dbm |
| RSRP_119 | -38≤ SS-RSRP-37< | No válido | Dbm |
| RSRP_120 | -37≤ SS-RSRP-36< | No válido | Dbm |
| RSRP_121 | -36≤ SS-RSRP-35< | No válido | Dbm |
| RSRP_122 | -35≤ SS-RSRP-34< | No válido | Dbm |
| RSRP_123 | -34≤ SS-RSRP-33< | No válido | Dbm |
| RSRP_124 | -33≤ SS-RSRP-32< | No válido | Dbm |
| RSRP_125 | -32≤ SS-RSRP-31< | No válido | Dbm |
| RSRP_126 | -31≤ SS-RSRP | No válido | Dbm |
| RSRP_127 | Infinito | No válido | Dbm |
Este miembro solo es válido si el miembro DataClass está establecido en WWAN_DATA_CLASS_LTE o WWAN_DATA_CLASS_5G_NSA/SA. De lo contrario, use WWAN_RSRP_UNKNOWN.
RSRPThreshold
El umbral actual, en unidades de umbral (1 dBm), en el que se ha establecido el controlador de miniporte (o el umbral predeterminado, si no se ha establecido uno), donde el controlador de minipuerto proporciona actualizaciones sobre el estado de señal. Especifique WWAN_RSRP_DISABLE para indicar que el controlador no implementa informes basados en umbrales. El controlador de minipuerto debe rellenar este miembro con las unidades de umbral en respuesta a una solicitud anterior del servicio MB para WWAN_RSRP_DEFAULT.
Este miembro solo es válido si el miembro DataClass está establecido en WWAN_DATA_CLASS_LTE o WWAN_DATA_CLASS_5G_NSA/SA. De lo contrario, use WWAN_RSRP_DISABLE.
SNR
La relación de señal a ruido (SNR), que oscila entre -23 y 40, en unidades de 0,5 dB. Use WWAN_SNR_UNKNOWN cuando esta información no esté disponible. En la tabla siguiente se muestra cómo asignar el intervalo al miembro SNR.
| Valor notificado | Valor de cantidad medido | Unidad |
|---|---|---|
| SNR_0 | SNR-23< | Db |
| SNR_1 | -23≤ SNR-22.5< | Db |
| SNR_2 | -22.5≤ SNR-22< | Db |
| SNR_3 | -22≤ SNR-21.5< | Db |
| SNR_4 | -21.5≤ SNR-21< | Db |
| ... | ... | ... |
| SNR_123 | 38≤ SNR<38.5 | Db |
| SNR_124 | 38.5≤ SNR<39 | Db |
| SNR_125 | 39≤ SNR<39.5 | Db |
| SNR_126 | 39.5≤ SNR<40 | Db |
| SNR_127 | 40≤ SNR | Db |
Este miembro solo es válido si el miembro DataClass está establecido en WWAN_DATA_CLASS_LTE o WWAN_DATA_CLASS_5G_NSA/SA. De lo contrario, use WWAN_SNR_UNKNOWN.
SNRThreshold
El umbral actual, en unidades de umbral (1 dBm), en el que se ha establecido el controlador de miniporte (o el umbral predeterminado, si no se ha establecido uno), donde el controlador de minipuerto proporciona actualizaciones sobre el estado de señal. Especifique WWAN_SNR_DISABLE para indicar que el controlador no implementa informes basados en umbrales. El controlador de miniporte debe rellenar este miembro con las unidades de umbral en respuesta a una solicitud anterior del servicio MB para WWAN_SNR_DEFAULT.
Este miembro solo es válido si el miembro DataClass está establecido en WWAN_DATA_CLASS_LTE o WWAN_DATA_CLASS_5G_NSA/SA. De lo contrario, use WWAN_SNR_DISABLE.
DataClass
Indica la clase de datos para la que los parámetros son válidos. Solo si se establece WWAN_DATA_CLASS_LTE o WWAN_DATA_CLASS_5G_NSA/SA , los miembros RSRP, RSRPThreshold, SNR y SNRThreshold son válidos.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 10, versión 1903 |
| Encabezado | wwan.h (incluye Wwan.h) |