OID_WWAN_RADIO_STATE
OID_WWAN_RADIO_STATE legt Informationen über den Funkleistungszustand eines MB-Geräts fest oder gibt diese zurück.
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_RADIO_STATE status Benachrichtigung senden, die eine NDIS_WWAN_RADIO_STATE-Struktur enthält, die den aktuellen Funkleistungszustand des MB-Geräts unabhängig vom Abschließen von Set- oder Abfrageanforderungen angibt.
Aufrufer, die den Funkleistungszustand des MB-Geräts festlegen möchten, stellen dem Miniporttreiber eine NDIS_WWAN_SET_RADIO_STATE-Struktur mit den entsprechenden Informationen zur Verfügung.
Bemerkungen
Weitere Informationen zur Verwendung dieser OID finden Sie unter MB-Funkstatus.
Miniport-Treiber sollten beim Verarbeiten von Abfrage- oder Setvorgängen nicht auf das Anbieternetzwerk oder das Abonnentenidentitätsmodul (SIM Karte) zugreifen.
Miniport-Treiber müssen den Software-Funkstromzustand über den Systemneustart oder die Geräteentfernung und -wiederherstellung beibehalten. Miniport-Treiber sollten die Software-Funkinformationen des Geräts speichern und sie verwenden, um den Funkstromzustand der Gerätesoftware sofort bei jedem Neustart oder jeder Neuinstallation des Geräts festzulegen. Der effektive Funkleistungszustand des Geräts wird basierend auf der Kombination von Software- und Hardware-Funkleistungszustand gemäß der Tabelle in WWAN_RADIO_STATE bestimmt.
Wenn der Wert WwanRadioOn ist, müssen Miniporttreiber die Funkleistung einschalten und das RadioState.SwRadioState-Element der WWAN_RADIO_STATE-Struktur auf WwanRadioOn festlegen. Wenn der RadioState.HwRadioState-MemberWwanRadioOff ist, sollten Miniporttreiber diese Energiezustandsinformationen zwischenspeichern und sicherstellen, dass der Funkstromzustand physisch aktiviert wird, wenn RadioState.HwRadioState in WwanRadioOn geändert wird.
Wenn der Wert WwanRadioOff ist, müssen Miniporttreiber den Funkstromzustand deaktivieren und das RadioState.SwRadioState-Element auf WwanRadioOff festlegen.
Die erwartete Funkzustandsprogrammierung durch Miniporttreiber finden Sie in der folgenden Tabelle.
Gültige Kombinationen für PIN-Modus und PIN-Status
| HwRadioState-Wert | SwRadioState-Wert | Gesamtzustand der Funkleistung |
|---|---|---|
WwanRadioOff |
WwanRadioOff |
WwanRadioOff |
WwanRadioOff |
WwanRadioOn |
WwanRadioOff |
WwanRadioOn |
WwanRadioOff |
WwanRadioOff |
WwanRadioOn |
WwanRadioOn |
WwanRadioOn |
Für Geräte, die keinen Hardware-Funkleistungsschalter bereitstellen, muss der RadioState.HwRadioState-Member der NDIS_WWAN_RADIO_STATE-Struktur immer auf WwanRadioOn festgelegt werden.
Ab Windows 10, Version 1703, verfügt OID_WWAN_RADIO_STATE über zusätzliche Spezifikationen, wie ein modem, das mehrere Executor unterstützt, die Konfiguration des Funkzustands über das Betriebssystem verarbeiten soll.
Wenn ein Modem mit mehreren Executors unterstützt wird, bietet die Konfiguration des Funkstromzustands pro Executor Leistungsvorteile. Wenn das Funkgerät eines Executors ausgeschaltet ist, erwartet das Betriebssystem, dass das Modem die Registrierung aus dem Netzwerk aufhebt und keine Überprüfungen oder Standortupdates versucht. Das Modem sollte einen Funkzustand für jeden Executor unterstützen, den es dem Betriebssystem angibt, damit es den Hardwareleistungszustand bestimmen kann, in dem es sich befinden soll.
Wenn das Modem beispielsweise über zwei Executors verfügt und einer der Executors ausgeschaltet ist, während der andere eingeschaltet ist, kann das Modem das RF-Front-End eingeschaltet lassen, um die Registrierung auf dem Executor aufrechtzuerhalten, dessen Funkgerät eingeschaltet ist, aber keine Überprüfungs-/Ping-/Standortupdates oder andere Mobilfunkdienste für den ausgeschalteten Executor durchführen muss. Wenn beide Funkgeräte ausgeschaltet sind, kann das Modem sein RF-Front-End ausschalten und die Gesamte hardware in einen niedrigeren Leistungszustand versetzen. Die Implementierungsspezifik wird jedem IHV überlassen.
Requirements (Anforderungen)
Version |
Verfügbar in Windows 7 und späteren Windows-Versionen. |
Header |
Ntddndis.h (include Ndis.h) |