WWAN_SIGNAL_STATE-Struktur (wwan.h)

Die WWAN_SIGNAL_STATE-Struktur stellt den Signalzustand des MB-Geräts dar.

Syntax

typedef struct _WWAN_SIGNAL_STATE {
  ULONG            Rssi;
  ULONG            ErrorRate;
  ULONG            RssiInterval;
  ULONG            RssiThreshold;
  WWAN_LIST_HEADER SignalStateListHeader;
} WWAN_SIGNAL_STATE, *PWWAN_SIGNAL_STATE;

Member

Rssi

Ein Wert, der die Stärke des Drahtlossignals darstellt. Miniporttreiber, die ihre WWAN_CELLULAR_CLASS als WwanCellularClassGSM oder WwanCellularClassCDMA melden, müssen Rssi in Dezibel über dem Empfindlichkeitsrauschboden des Geräts melden.

Signalstärke (in dBm)	Codierter Wert (Minimum=0, Maximum=31)
-113 oder weniger	0
-111	1
-109	2
...	...
-51 oder höher	31
Unbekannt oder nicht nachweisbar	WWAN_RSSI_UNKNOWN

 

CDMA-basierte Geräte müssen die Signalstärke basierend auf kompensierten RSSI (Meldungen für Rauschen) und nicht auf rohem RSSI melden.

ErrorRate

Ein codierter Wert, der einen prozentualen Bereich von Fehlerraten darstellt. Verwenden Sie für GSM-basierte Geräte die Werte aus der Spalte Kanalbitfehlerrate in der folgenden Tabelle. Verwenden Sie für CDMA-basierte Geräte die Werte aus der Spalte Framefehlerrate. Verwenden Sie in beiden Fällen WWAN_ERROR_RATE_UNKNOWN, um eine unbekannte Fehlerrate anzugeben.

Kanalbitfehlerrate (in %)	Framefehlerrate (in %)	Codierter Wert (Min=0, Max=7)
< 0.2	< 0.01	0
0.2-0.4	0.01-0.1	1
0.4-0.8	0.1-0.5	2
0.8-1.6	0.5-1.0	3
- 3.2	1.0 - -2.0	4
- 6.4	2.0-4.0	5
6.4-12.8	4.0-8.0	6
> 12.8	> 8.0	7
Unbekannt oder nicht nachweisbar		WWAN_ERROR_RATE_UNKNOWN

RssiInterval

Das aktuelle Intervall in Sekunden, in dem der Miniporttreiber auf festgelegt wurde (oder das Standardintervall, falls noch keins festgelegt wurde), für das der Miniporttreiber Updates zum Signalzustand bereitstellt. Geben Sie WWAN_RSSI_DISABLE an, um anzugeben, dass der Miniporttreiber keine intervallbasierte Berichterstellung implementiert. Miniporttreiber sollten diesen Member als Reaktion auf eine frühere Anforderung des MB-Diensts für WWAN_RSSI_DEFAULT mit dem Intervall füllen.

RssiThreshold

Der aktuelle Schwellenwert in Schwellenwerteinheiten, bei dem der Miniporttreiber auf festgelegt wurde (oder das Standardintervall, falls nicht festgelegt), das der Miniporttreiber Updates zum Signalzustand bereitstellt. Geben Sie WWAN_RSSI_DISABLE an, um anzugeben, dass der Miniporttreiber keine schwellenwertbasierte Berichterstellung implementiert. Miniporttreiber sollten diesen Member als Reaktion auf eine frühere Anforderung des MB-Diensts für WWAN_RSSI_DEFAULT mit den Schwellenwerteinheiten auffüllen.

SignalStateListHeader

Eine formatierte WWAN_LIST_HEADER-Struktur , die eine Liste von Signalstatuserweiterungen pro Datenklasse und die Anzahl der Datenklassen darstellt. Der Miniporttreiber muss eine Liste aller unterstützten Datenklassen zurückgeben.

Dieses Element verweist auf eine Liste von WWAN_SIGNAL_STATE_EXT Strukturen, die die WWAN_LIST_HEADER-Struktur verwenden. Die restlichen Member der WWAN_SIGNAL_STATE_EX-Strukturen werden basierend auf der höchsten verfügbaren Datenklasse gefüllt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows 7 und späteren Windows-Versionen.
Kopfzeile	wwan.h (include Wwan.h)

Weitere Informationen

NDIS_WWAN_SIGNAL_STATE