estrutura WWAN_SIGNAL_STATE_EXT (wwan.h)
A estrutura WWAN_SIGNAL_STATE_EXT representa uma extensão para o estado de sinal do dispositivo MB. Em Windows 10, versão 1903 e posterior, WWAN_SIGNAL_STATE_EX contém informações primárias sobre o estado do sinal do dispositivo, incluindo uma matriz de estruturas de WWAN_SIGNAL_STATE_EXT que contêm informações de estado de sinal específicas do 5G.
Para obter mais informações sobre o suporte à classe de dados 5G, consulte Suporte à classe de dados MB 5G.
Sintaxe
typedef struct _WWAN_SIGNAL_STATE_EXT {
ULONG RSRP;
ULONG RSRPThreshold;
ULONG SNR;
ULONG SNRThreshold;
ULONG DataClass;
} WWAN_SIGNAL_STATE_EXT, *PWWAN_SIGNAL_STATE_EXT;
Membros
RSRP
O sinal de referência recebeu energia (RSRP), que varia de -156 a -31, em unidades de 1 dBm. Use WWAN_RSRP_UNKNOWN quando essas informações não estiverem disponíveis. A tabela a seguir mostra como mapear o intervalo para o membro RSRP.
| Valor relatado | Valor de quantidade medido (L3 SS_RSRP) | Valor de quantidade medido (L1 SS-RSRP e CSI-RSRP) | Unidade |
|---|---|---|---|
| RSRP_0 | SS-RSRP-156< | Inválido | Dbm |
| RSRP_1 | -156≤ SS-RSRP-55< | Inválido | Dbm |
| RSRP_2 | -155≤ SS-RSRP-54< | Inválido | Dbm |
| RSRP_3 | -154≤ SS-RSRP-153< | Inválido | Dbm |
| RSRP_4 | -153≤ SS-RSRP-152< | Inválido | Dbm |
| RSRP_5 | -152≤ SS-RSRP-151< | Inválido | Dbm |
| ... | ... | ... | ... |
| RSRP_16 | -141≤ SS-RSRP-140< | Invá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< | Inválido | Dbm |
| RSRP_114 | -43≤ SS-RSRP-42< | Inválido | Dbm |
| RSRP_115 | -42≤ SS-RSRP-41< | Inválido | Dbm |
| RSRP_116 | -41≤ SS-RSRP-40< | Inválido | Dbm |
| RSRP_117 | -40≤ SS-RSRP-39< | Inválido | Dbm |
| RSRP_118 | -39≤ SS-RSRP-38< | Inválido | Dbm |
| RSRP_119 | -38≤ SS-RSRP-37< | Inválido | Dbm |
| RSRP_120 | -37≤ SS-RSRP-36< | Inválido | Dbm |
| RSRP_121 | -36≤ SS-RSRP-35< | Inválido | Dbm |
| RSRP_122 | -35≤ SS-RSRP-34< | Inválido | Dbm |
| RSRP_123 | -34≤ SS-RSRP-33< | Inválido | Dbm |
| RSRP_124 | -33≤ SS-RSRP-32< | Inválido | Dbm |
| RSRP_125 | -32≤ SS-RSRP-31< | Inválido | Dbm |
| RSRP_126 | -31≤ SS-RSRP | Inválido | Dbm |
| RSRP_127 | Infinity | Inválido | Dbm |
Esse membro só será válido se o membro DataClass estiver definido como WWAN_DATA_CLASS_LTE ou WWAN_DATA_CLASS_5G_NSA/SA. Caso contrário, use WWAN_RSRP_UNKNOWN.
RSRPThreshold
O limite atual, em unidades de limite (1 dBm), no qual o driver de miniporto foi definido (ou o limite padrão, se não tiver sido definido), em que o driver de miniporto fornece atualizações sobre o estado do sinal. Especifique WWAN_RSRP_DISABLE para indicar que o driver não implementa relatórios baseados em limite. O driver de miniporte deve preencher esse membro com as unidades de limite em resposta a uma solicitação anterior do serviço MB para WWAN_RSRP_DEFAULT.
Esse membro só será válido se o membro DataClass estiver definido como WWAN_DATA_CLASS_LTE ou WWAN_DATA_CLASS_5G_NSA/SA. Caso contrário, use WWAN_RSRP_DISABLE.
SNR
A taxa de sinal para ruído (SNR), variando de -23 a 40, em unidades de 0,5 dB. Use WWAN_SNR_UNKNOWN quando essas informações não estiverem disponíveis. A tabela a seguir mostra como mapear o intervalo para o membro SNR.
| Valor relatado | Valor de quantidade medido | Unidade |
|---|---|---|
| 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 |
Esse membro só será válido se o membro DataClass estiver definido como WWAN_DATA_CLASS_LTE ou WWAN_DATA_CLASS_5G_NSA/SA. Caso contrário, use WWAN_SNR_UNKNOWN.
SNRThreshold
O limite atual, em unidades de limite (1 dBm), no qual o driver de miniporto foi definido (ou o limite padrão, se não tiver sido definido), em que o driver de miniporto fornece atualizações sobre o estado do sinal. Especifique WWAN_SNR_DISABLE para indicar que o driver não implementa relatórios baseados em limite. O driver de miniporte deve preencher esse membro com as unidades de limite em resposta a uma solicitação anterior do serviço MB para WWAN_SNR_DEFAULT.
Esse membro só será válido se o membro DataClass estiver definido como WWAN_DATA_CLASS_LTE ou WWAN_DATA_CLASS_5G_NSA/SA. Caso contrário, use WWAN_SNR_DISABLE.
DataClass
Indica a classe de dados para a qual os parâmetros são válidos. Somente se WWAN_DATA_CLASS_LTE ou WWAN_DATA_CLASS_5G_NSA/SA estiver definido, os membros RSRP, RSRPThreshold, SNR e SNRThreshold serão válidos.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 10, versão 1903 |
| Cabeçalho | wwan.h (inclua Wwan.h) |