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 5G-spezifische Signalzustandsinformationen 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;
Member
RSRP
Die Referenzsignal-Empfangenleistung (RSRP), die zwischen -156 und -31 liegt, in Einheiten von 1 dBm. Verwenden Sie WWAN_RSRP_UNKNOWN , wenn diese Informationen nicht verfügbar sind. Die folgende Tabelle zeigt, wie sie den Bereich dem RSRP-Element zuordnen.
| 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 | Unendlich | Ungültig | Dbm |
Dieser Member ist nur gültig, wenn das DataClass-Element 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), bei dem der Miniporttreiber festgelegt wurde (oder der Standardschwellenwert, falls nicht festgelegt), wobei der Miniporttreiber Updates zum Signalzustand bereitstellt. Geben Sie WWAN_RSRP_DISABLE an, um anzugeben, dass der Treiber keine schwellenwertbasierte Berichterstellung implementiert. Der Miniporttreiber sollte diesen Member als Reaktion auf eine frühere Anforderung des MB-Diensts für WWAN_RSRP_DEFAULT mit den Schwellenwerteinheiten auffüllen.
Dieser Member ist nur gültig, wenn das DataClass-Element auf WWAN_DATA_CLASS_LTE oder WWAN_DATA_CLASS_5G_NSA/SA festgelegt ist. Verwenden Sie andernfalls WWAN_RSRP_DISABLE.
SNR
Das Signal-Rausch-Verhältnis (SNR) 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 |
Dieser Member ist nur gültig, wenn das DataClass-Element 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), bei dem der Miniporttreiber festgelegt wurde (oder der Standardschwellenwert, falls nicht festgelegt), wobei der Miniporttreiber Updates zum Signalzustand bereitstellt. Geben Sie WWAN_SNR_DISABLE an, um anzugeben, dass der Treiber keine schwellenwertbasierte Berichterstellung implementiert. Der Miniporttreiber sollte diesen Member als Reaktion auf eine frühere Anforderung des MB-Diensts für WWAN_SNR_DEFAULT mit den Schwellenwerteinheiten auffüllen.
Dieser Member ist nur gültig, wenn das DataClass-Element 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 entweder WWAN_DATA_CLASS_LTE oder WWAN_DATA_CLASS_5G_NSA/SA festgelegt ist, sind die Member RSRP, RSRPThreshold, SNR und SNRThreshold gültig.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 10, Version 1903 |
| Kopfzeile | wwan.h (include Wwan.h) |