estrutura WWAN_SIGNAL_STATE_EXT (wwan.h)
A estrutura WWAN_SIGNAL_STATE_EXT representa uma extensão para o estado do sinal do dispositivo MB. No 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 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 RSRP (sinal de referência recebido), 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 | Não válido | Dbm |
| RSRP_1 | -156≤ SS-RSRP<-55 | Não válido | Dbm |
| RSRP_2 | -155≤ SS-RSRP<-54 | Não válido | Dbm |
| RSRP_3 | -154≤ SS-RSRP<-153 | Não válido | Dbm |
| RSRP_4 | -153≤ SS-RSRP<-152 | Não válido | Dbm |
| RSRP_5 | -152≤ SS-RSRP<-151 | Não válido | Dbm |
| ... | ... | ... | ... |
| RSRP_16 | -141≤ SS-RSRP<-140 | Não 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 | Não válido | Dbm |
| RSRP_114 | -43≤ SS-RSRP<-42 | Não válido | Dbm |
| RSRP_115 | -42≤ SS-RSRP<-41 | Não válido | Dbm |
| RSRP_116 | -41≤ SS-RSRP<-40 | Não válido | Dbm |
| RSRP_117 | -40≤ SS-RSRP<-39 | Não válido | Dbm |
| RSRP_118 | -39≤ SS-RSRP<-38 | Não válido | Dbm |
| RSRP_119 | -38≤ SS-RSRP<-37 | Não válido | Dbm |
| RSRP_120 | -37≤ SS-RSRP<-36 | Não válido | Dbm |
| RSRP_121 | -36≤ SS-RSRP<-35 | Não válido | Dbm |
| RSRP_122 | -35≤ SS-RSRP<-34 | Não válido | Dbm |
| RSRP_123 | -34≤ SS-RSRP<-33 | Não válido | Dbm |
| RSRP_124 | -33≤ SS-RSRP<-32 | Não válido | Dbm |
| RSRP_125 | -32≤ SS-RSRP<-31 | Não válido | Dbm |
| RSRP_126 | -31≤ SS-RSRP | Não válido | Dbm |
| RSRP_127 | Infinito | Não válido | Dbm |
Esse membro será válido somente 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 miniporto 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 será válido somente 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 SNR (sinal para ruído), 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 será válido somente 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 miniporto 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 será válido somente 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, SNRe SNRThreshold são válidos.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 10, versão 1903 |
| cabeçalho | wwan.h (inclua Wwan.h) |