structure WWAN_SIGNAL_STATE_EXT (wwan.h)
La structure WWAN_SIGNAL_STATE_EXT représente une extension à l’état du signal de l’appareil Mo. Dans Windows 10, version 1903 et ultérieure, WWAN_SIGNAL_STATE_EX contient des informations principales sur l’état du signal de l’appareil, notamment un tableau de structures WWAN_SIGNAL_STATE_EXT qui contiennent des informations d’état de signal spécifiques à 5G.
Pour plus d’informations sur la prise en charge de la classe de données 5G, consultez prise en charge de la classe de données 5G mo.
Syntaxe
typedef struct _WWAN_SIGNAL_STATE_EXT {
ULONG RSRP;
ULONG RSRPThreshold;
ULONG SNR;
ULONG SNRThreshold;
ULONG DataClass;
} WWAN_SIGNAL_STATE_EXT, *PWWAN_SIGNAL_STATE_EXT;
Membres
RSRP
Le signal de référence a reçu la puissance (RSRP), comprise entre -156 et -31, en unités de 1 sgbd. Utilisez WWAN_RSRP_UNKNOWN lorsque ces informations ne sont pas disponibles. Le tableau suivant montre comment mapper la plage au membre RSRP.
| Valeur signalée | Valeur de quantité mesurée (L3 SS_RSRP) | Valeur de quantité mesurée (L1 SS-RSRP et CSI-RSRP) | Unité |
|---|---|---|---|
| RSRP_0 | SS-RSRP<-156 | Non valide | Dbm |
| RSRP_1 | -156≤ SS-RSRP<-55 | Non valide | Dbm |
| RSRP_2 | -155≤ SS-RSRP<-54 | Non valide | Dbm |
| RSRP_3 | -154≤ SS-RSRP<-153 | Non valide | Dbm |
| RSRP_4 | -153≤ SS-RSRP<-152 | Non valide | Dbm |
| RSRP_5 | -152≤ SS-RSRP<-151 | Non valide | Dbm |
| ... | ... | ... | ... |
| RSRP_16 | -141≤ SS-RSRP<-140 | Non valide | 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 | Non valide | Dbm |
| RSRP_114 | -43≤ SS-RSRP<-42 | Non valide | Dbm |
| RSRP_115 | -42≤ SS-RSRP<-41 | Non valide | Dbm |
| RSRP_116 | -41≤ SS-RSRP<-40 | Non valide | Dbm |
| RSRP_117 | -40≤ SS-RSRP<-39 | Non valide | Dbm |
| RSRP_118 | -39≤ SS-RSRP<-38 | Non valide | Dbm |
| RSRP_119 | -38≤ SS-RSRP<-37 | Non valide | Dbm |
| RSRP_120 | -37≤ SS-RSRP<-36 | Non valide | Dbm |
| RSRP_121 | -36≤ SS-RSRP<-35 | Non valide | Dbm |
| RSRP_122 | -35≤ SS-RSRP<-34 | Non valide | Dbm |
| RSRP_123 | -34≤ SS-RSRP<-33 | Non valide | Dbm |
| RSRP_124 | -33≤ SS-RSRP<-32 | Non valide | Dbm |
| RSRP_125 | -32≤ SS-RSRP<-31 | Non valide | Dbm |
| RSRP_126 | -31≤ SS-RSRP | Non valide | Dbm |
| RSRP_127 | Infini | Non valide | Dbm |
Ce membre n’est valide que si le membre DataClass est défini sur WWAN_DATA_CLASS_LTE ou WWAN_DATA_CLASS_5G_NSA/SA. Sinon, utilisez WWAN_RSRP_UNKNOWN.
RSRPThreshold
Seuil actuel, en unités de seuil (1 dBm), auquel le pilote miniport a été défini (ou le seuil par défaut, s’il n’en a pas été défini), où le pilote miniport fournit des mises à jour sur l’état du signal. Spécifiez WWAN_RSRP_DISABLE pour indiquer que le pilote n’implémente pas de rapports basés sur des seuils. Le pilote miniport doit remplir ce membre avec les unités de seuil en réponse à une demande antérieure du service Mo pour WWAN_RSRP_DEFAULT.
Ce membre n’est valide que si le membre DataClass est défini sur WWAN_DATA_CLASS_LTE ou WWAN_DATA_CLASS_5G_NSA/SA. Sinon, utilisez WWAN_RSRP_DISABLE.
SNR
Le rapport signal-à-bruit (SNR), allant de -23 à 40, en unités de 0,5 dB. Utilisez WWAN_SNR_UNKNOWN lorsque ces informations ne sont pas disponibles. Le tableau suivant montre comment mapper la plage au membre SNR.
| Valeur signalée | Valeur de quantité mesurée | Unité |
|---|---|---|
| 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 |
Ce membre n’est valide que si le membre DataClass est défini sur WWAN_DATA_CLASS_LTE ou WWAN_DATA_CLASS_5G_NSA/SA. Sinon, utilisez WWAN_SNR_UNKNOWN.
SNRThreshold
Seuil actuel, en unités de seuil (1 dBm), auquel le pilote miniport a été défini (ou le seuil par défaut, s’il n’en a pas été défini), où le pilote miniport fournit des mises à jour sur l’état du signal. Spécifiez WWAN_SNR_DISABLE pour indiquer que le pilote n’implémente pas de rapports basés sur des seuils. Le pilote miniport doit remplir ce membre avec les unités de seuil en réponse à une demande antérieure du service Mo pour WWAN_SNR_DEFAULT.
Ce membre n’est valide que si le membre DataClass est défini sur WWAN_DATA_CLASS_LTE ou WWAN_DATA_CLASS_5G_NSA/SA. Sinon, utilisez WWAN_SNR_DISABLE.
DataClass
Indique la classe de données pour laquelle les paramètres sont valides. Uniquement si WWAN_DATA_CLASS_LTE ou WWAN_DATA_CLASS_5G_NSA/SA est défini, les RSRP, RSRPThreshold, SNRet membres SNRThreshold sont valides.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 10, version 1903 |
| d’en-tête | wwan.h (include Wwan.h) |