WWAN_SIGNAL_STATE_EXT Struktur (wwan.h)
Die WWAN_SIGNAL_STATE_EXT-Struktur stellt eine Erweiterung des Signalzustands des MB-Geräts dar. In Windows 10, Version 1903 und höher, enthält WWAN_SIGNAL_STATE_EX primäre Informationen zum Signalzustand des Geräts, einschließlich eines Arrays von WWAN_SIGNAL_STATE_EXT Strukturen, die Für 5G spezifische Signalstatusinformationen enthalten.
Weitere Informationen zur Unterstützung von 5G-Datenklassen finden Sie unter MB 5G-Datenklassenunterstützung.
Syntax
typedef struct _WWAN_SIGNAL_STATE_EXT {
ULONG RSRP;
ULONG RSRPThreshold;
ULONG SNR;
ULONG SNRThreshold;
ULONG DataClass;
} WWAN_SIGNAL_STATE_EXT, *PWWAN_SIGNAL_STATE_EXT;
Angehörige
RSRP
Das Referenzsignal, das die Stromversorgung (RSRP) hat, die von -156 bis -31 in Einheiten von 1 dBm reicht. Verwenden Sie WWAN_RSRP_UNKNOWN, wenn diese Informationen nicht verfügbar sind. In der folgenden Tabelle wird gezeigt, wie der Bereich dem RSRP-Element zugeordnet wird.
| Gemeldeter Wert | Gemessener Mengenwert (L3 SS_RSRP) | Gemessener Mengenwert (L1 SS-RSRP und CSI-RSRP) | Einheit |
|---|---|---|---|
| RSRP_0 | SS-RSRP<-156 | Ungültig | Dbm |
| RSRP_1 | -156≤ SS-RSRP<-55 | Ungültig | Dbm |
| RSRP_2 | -155≤ SS-RSRP<-54 | Ungültig | Dbm |
| RSRP_3 | -154≤ SS-RSRP<-153 | Ungültig | Dbm |
| RSRP_4 | -153≤ SS-RSRP<-152 | Ungültig | Dbm |
| RSRP_5 | -152≤ SS-RSRP<-151 | Ungültig | Dbm |
| ... | ... | ... | ... |
| RSRP_16 | -141≤ SS-RSRP<-140 | Ungültig | 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 | Ungültig | Dbm |
| RSRP_114 | -43≤ SS-RSRP<-42 | Ungültig | Dbm |
| RSRP_115 | -42≤ SS-RSRP<-41 | Ungültig | Dbm |
| RSRP_116 | -41≤ SS-RSRP<-40 | Ungültig | Dbm |
| RSRP_117 | -40≤ SS-RSRP<-39 | Ungültig | Dbm |
| RSRP_118 | -39≤ SS-RSRP<-38 | Ungültig | Dbm |
| RSRP_119 | -38≤ SS-RSRP<-37 | Ungültig | Dbm |
| RSRP_120 | -37≤ SS-RSRP<-36 | Ungültig | Dbm |
| RSRP_121 | -36≤ SS-RSRP<-35 | Ungültig | Dbm |
| RSRP_122 | -35≤ SS-RSRP<-34 | Ungültig | Dbm |
| RSRP_123 | -34≤ SS-RSRP<-33 | Ungültig | Dbm |
| RSRP_124 | -33≤ SS-RSRP<-32 | Ungültig | Dbm |
| RSRP_125 | -32≤ SS-RSRP<-31 | Ungültig | Dbm |
| RSRP_126 | -31≤ SS-RSRP | Ungültig | Dbm |
| RSRP_127 | Unendlichkeit | Ungültig | Dbm |
Dieses Element ist nur gültig, wenn das DataClass Member auf WWAN_DATA_CLASS_LTE oder WWAN_DATA_CLASS_5G_NSA/SA-festgelegt ist. Verwenden Sie andernfalls WWAN_RSRP_UNKNOWN.
RSRPThreshold
Der aktuelle Schwellenwert in Schwellenwerteinheiten (1 dBm), an dem der Miniporttreiber festgelegt wurde (oder der Standardschwellenwert, falls nicht festgelegt wurde), wo der Miniporttreiber Updates zum Signalzustand bereitstellt. Geben Sie WWAN_RSRP_DISABLE an, um anzugeben, dass der Treiber keine schwellenwertbasierte Berichterstellung implementiert. Der Miniporttreiber sollte dieses Element als Reaktion auf eine frühere Anforderung des MB-Diensts für WWAN_RSRP_DEFAULTmit den Schwellenwerteinheiten auffüllen.
Dieses Element ist nur gültig, wenn das DataClass Member auf WWAN_DATA_CLASS_LTE oder WWAN_DATA_CLASS_5G_NSA/SA-festgelegt ist. Verwenden Sie andernfalls WWAN_RSRP_DISABLE.
SNR
Das Signal-zu-Rausch-Verhältnis (SNR) reicht von -23 bis 40 in Einheiten von 0,5 dB. Verwenden Sie WWAN_SNR_UNKNOWN, wenn diese Informationen nicht verfügbar sind. In der folgenden Tabelle wird gezeigt, wie der Bereich dem SNR-Element zugeordnet wird.
| Gemeldeter Wert | Gemessener Mengenwert | Einheit |
|---|---|---|
| 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 |
Dieses Element ist nur gültig, wenn das DataClass Member auf WWAN_DATA_CLASS_LTE oder WWAN_DATA_CLASS_5G_NSA/SA-festgelegt ist. Verwenden Sie andernfalls WWAN_SNR_UNKNOWN.
SNRThreshold
Der aktuelle Schwellenwert in Schwellenwerteinheiten (1 dBm), an dem der Miniporttreiber festgelegt wurde (oder der Standardschwellenwert, falls nicht festgelegt wurde), wo der Miniporttreiber Updates zum Signalzustand bereitstellt. Geben Sie WWAN_SNR_DISABLE an, um anzugeben, dass der Treiber keine schwellenwertbasierte Berichterstellung implementiert. Der Miniporttreiber sollte dieses Element als Reaktion auf eine frühere Anforderung des MB-Diensts für WWAN_SNR_DEFAULTmit den Schwellenwerteinheiten auffüllen.
Dieses Element ist nur gültig, wenn das DataClass Member auf WWAN_DATA_CLASS_LTE oder WWAN_DATA_CLASS_5G_NSA/SA-festgelegt ist. Verwenden Sie andernfalls WWAN_SNR_DISABLE.
DataClass
Gibt die Datenklasse an, für die die Parameter gültig sind. Nur wenn WWAN_DATA_CLASS_LTE oder WWAN_DATA_CLASS_5G_NSA/SA festgelegt ist, sind die RSRP, RSRPThreshold, SNRund SNRThreshold Member gültig.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 10, Version 1903 |
| Header- | wwan.h (include Wwan.h) |