Share via

estrutura WWAN_SIGNAL_STATE_EXT (wwan.h)

  • Artigo

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)

Confira também

WWAN_SIGNAL_STATE