OID_WWAN_SIGNAL_STATE
OID_WWAN_SIGNAL_STATE gibt den aktuellen Signalzustand zurück oder legt diese fest.
Miniport-Treiber müssen Set- und Abfrageanforderungen asynchron verarbeiten und zunächst NDIS_STATUS_INDICATION_REQUIRED an die ursprüngliche Anforderung zurückgeben und später eine NDIS_STATUS_WWAN_SIGNAL_STATE status Benachrichtigung senden, die eine NDIS_WWAN_SIGNAL_STATE-Struktur enthält, um Informationen über die aktuelle Signalzustandsanzeige bereitzustellen, die dem Endbenutzer unabhängig vom Abschließen von Set- oder Abfrageanforderungen angezeigt wird.
Aufrufer, die anfordern, die aktuelle Signalzustandsanzeige für den Endbenutzer festzulegen, stellen dem Miniporttreiber eine NDIS_WWAN_SET_SIGNAL_INDICATION Struktur mit den entsprechenden Informationen zur Verfügung.
Bemerkungen
Weitere Informationen zur Verwendung dieser OID finden Sie unter WWAN-Signalstärkevorgänge.
Miniport-Treiber sollten beim Verarbeiten von Abfrage- oder Setvorgängen nicht auf das Anbieternetzwerk oder das Abonnentenidentitätsmodul (SIM Karte) zugreifen.
Im Allgemeinen sollte der Signalzustand angegeben und nicht abgefragt werden. Diese OID wird jedoch verfügbar gemacht, falls der aktuelle Signalzustand vom MB-Dienst bestimmt werden muss.
Für die Antwort auf Abfrageanforderungen sollten Miniporttreiber eine NDIS_STATUS_WWAN_SIGNAL_STATE Benachrichtigung senden.
Bei einer festgelegten Anforderung vom MB-Dienst sollten Miniporttreiber:
Gibt die aktuellen Werte für Rssi und ErrorRate in der NDIS_WWAN_SIGNAL_STATE-Struktur zurück, zusätzlich zum Melden der absoluten Werte für RssiInterval und RssiThreshold , die im Miniporttreiber festgelegt wurden.
Intern zwischenspeichern sie die RssiInterval - und/oder RssiThreshold-Werte , auch wenn das Gerät derzeit nicht bei einem Operator registriert ist und eine vom Gerät in Einstellungsparametern auferlegte Einschränkung nur nach der Registrierung möglich sein kann. Der Miniporttreiber sollte versuchen, diese Einstellungen in der nächsten sofort verfügbaren Situation anzuwenden.
Führen Sie die Anforderung erfolgreich aus, wenn der Hardware- und/oder Software-Funkschalterstatus derzeit AUS ist. Der Miniporttreiber speichert die Anforderungsdaten zwischen und beginnt mit der Meldung der Signalstärke, nachdem der Schalter aktiviert ist.
Diese Anforderung kann mit dem entsprechenden uStatus-Fehlercode fehlschlagen.
Miniport-Treiber können beim Verarbeiten von Abfrageanforderungen vom MB-Dienst die folgenden Aktionen ausführen:
Gibt die aktuellen Werte für Rssi und ErrorRate in der NDIS_WWAN_SIGNAL_STATE-Struktur zurück, zusätzlich zum Melden der absoluten Werte für RssiInterval und RssiThreshold , die im Miniporttreiber festgelegt wurden.
Führen Sie für diese Anforderung einen Fehlercode mit dem entsprechenden uStatus-Fehlercode aus.
Rückgabewerte:
NDIS_STATUS_NOT_SUPPORTED
Miniport-Treiber können dies für bestimmte Geräte zurückgeben, die sich der Gerätefunktionen bewusst sind, die die Signalstärke nicht unterstützen, kann die Anforderung mit diesem Fehlercode fehlschlagen.
Empfohlene Implementierung
Geräte müssen Signalstärkenanzeigen unterstützen.
Fahrer müssen über einen Zeitraum von fünf Minuten Signalstärken von mindestens 50 % der RssiInterval-Einstellung melden.
Geräte müssen die Meldung der Signalstärke in den folgenden Zuständen vermeiden:
Gerät nicht registriert oder abgemeldet und gilt nur für GSM-Geräte.
Der effektive Funkzustand ist OFF.
In den obigen Zuständen muss vom Miniporttreiber eine Abfrage der Signalstärke mit den folgenden Daten zurückgegeben werden:
Rssi = WWAN_RSSI_UNKNOWN
ErrorRate = WWAN_ERROR_RATE_UNKNOWN;
RssiInterval = < WWAN_RSSI_DISABLE, WWAN_RSSI_DEFAULT oder letzter festgelegter Wert>
RssiThreshold = < WWAN_RSSI_DISABLE, WWAN_RSSI_DEFAULT oder der letzte festgelegte Wert>
Windows 10, Version 1903
Ab Windows 10 Version 1903 wurde OID_WWAN_SIGNAL_STATE auf Revision 3 aktualisiert. Diese Revision ermöglicht es dem Host, neue RSRP-Werte (Reference Signal Received Power) und Signal-to-Noise (SNR) vom Miniporttreiber abzufragen. Ein Miniporttreiber muss Revision 3 dieser OID und deren Datenstrukturen verwenden, wenn der Treiber 5G unterstützt.
Weitere Informationen zur Unterstützung von 5G-Datenklassen finden Sie unter Mb 5G-Datenklassenunterstützung.
Requirements (Anforderungen)
Version |
Verfügbar in Windows 7 und späteren Windows-Versionen. |
Header |
Ntddndis.h (include Ndis.h) |