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;
Angehörige
Rssi
Ein Wert, der die Stärke des drahtlosen Signals darstellt. Miniporttreiber, die ihre WWAN_CELLULAR_CLASS als WwanCellularClassGSM oder WwanCellularClassCDMA melden, müssen Rssi in Dezibel über dem Empfindlichkeitsgeräuschboden 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 erkennbar | WWAN_RSSI_UNKNOWN |
CDMA-basierte Geräte müssen die Signalstärke basierend auf kompensierten RSSI (Konten für Rauschen) melden und nicht auf rohem RSSI basieren.
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 "Frame-Fehlerrate". Verwenden Sie für beide Fälle WWAN_ERROR_RATE_UNKNOWN, um eine unbekannte Fehlerrate zu kennzeichnen.
| 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 erkennbar | WWAN_ERROR_RATE_UNKNOWN | |
RssiInterval
Das aktuelle Intervall in Sekunden, auf das der Miniporttreiber festgelegt wurde (oder auf das Standardintervall, falls nicht festgelegt wurde), dass der Miniporttreiber Updates über den Signalzustand bereitstellt. Geben Sie WWAN_RSSI_DISABLE an, um anzugeben, dass der Miniporttreiber keine intervallbasierte Berichterstellung implementiert. Miniport-Treiber sollten dieses Element als Reaktion auf eine frühere Anforderung des MB-Diensts für WWAN_RSSI_DEFAULT mit dem Intervall auffüllen.
RssiThreshold
Der aktuelle Schwellenwert in Schwellenwerteinheiten, bei denen der Miniporttreiber auf (oder das Standardintervall festgelegt wurde, falls noch nicht festgelegt) festgelegt wurde, dass der Miniporttreiber Updates über den Signalzustand bereitstellt. Geben Sie WWAN_RSSI_DISABLE an, um anzugeben, dass der Miniporttreiber keine schwellenwertbasierte Berichterstellung implementiert. Miniport-Treiber sollten dieses Mitglied 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 der Signalzustandserweiterungen 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 WWAN_SIGNAL_STATE_EXT Strukturen, die die WWAN_LIST_HEADER Struktur verwenden. Die restlichen Elemente der WWAN_SIGNAL_STATE_EX Strukturen werden basierend auf der höchsten verfügbaren Datenklasse gefüllt.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows 7 und höheren Versionen von Windows. |
| Header- | wwan.h (include Wwan.h) |