WWAN_SIGNAL_STATE_EXT structure (wwan.h)
La structure WWAN_SIGNAL_STATE_EXT représente une extension de 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, y compris un tableau de structures WWAN_SIGNAL_STATE_EXT qui contiennent des informations d’état du signal spécifiques à la 5G.
Pour plus d’informations sur la prise en charge des classes de données 5G, consultez Prise en charge de la classe de données MB 5G.
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
Puissance reçue du signal de référence (RSRP), comprise entre -156 et -31, en unités de 1 dBm. 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 est valide uniquement 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 est valide uniquement 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), compris entre -23 et 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 est valide uniquement 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 est valide uniquement 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. Seulement si WWAN_DATA_CLASS_LTE ou WWAN_DATA_CLASS_5G_NSA/SA est défini, les membres RSRP, RSRPThreshold, SNR et SNRThreshold sont valides.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 10 version 1903 |
| En-tête | wwan.h (inclure Wwan.h) |