Freigeben über


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)

Weitere Informationen

WWAN_SIGNAL_STATE