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) |