OID_WWAN_REGISTER_STATE
OID_WWAN_REGISTER_STATE wählt einen Netzwerkanbieter für die Registrierung aus.
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_REGISTER_STATE status Benachrichtigung senden, die eine NDIS_WWAN_REGISTRATION_STATE-Struktur enthält, um Informationen zum registrierten Netzwerkanbieter bereitzustellen, unabhängig vom Abschließen von Set- oder Abfrageanforderungen.
Aufrufer, die anfordern, den Netzwerkanbieter für die Registrierung mit festzulegen, stellen dem Miniporttreiber eine NDIS_WWAN_SET_REGISTER_STATE Struktur mit den entsprechenden Informationen zur Verfügung.
Bemerkungen
Weitere Informationen zur Verwendung dieser OID finden Sie unter WWAN-Registrierungsvorgänge.
Miniport-Treiber können beim Verarbeiten von Abfrage- oder Setvorgängen auf das Anbieternetzwerk zugreifen, sollten aber nicht auf das Abonnentenidentitätsmodul (SIM-Karte) zugreifen.
Das MB-Treibermodell unterstützt zwei Registrierungsmethoden: automatisch und manuell. Für CDMA-basierte Netzwerke unterstützt das MB-Treibermodell nur die automatische Registrierung.
Geräte, die die manuelle Registrierung unterstützen, müssen das WwanControlCaps-Element in WWAN_DEVICE_CAPS Struktur auf WWAN_CTRL_CAPS_REG_MANUAL festlegen. Beachten Sie, dass GSM-basierte Geräte die manuelle Registrierung unterstützen müssen.
Wenn der Registrierungsstatus automatisch ist, müssen Miniporttreiber ihr Gerät anweisen, einen Netzwerkanbieter basierend auf dem für die Mobilfunktechnologie spezifischen Auswahlalgorithmus auszuwählen und mit der Registrierung fortzufahren.
Die Semantik von RegisterAction-Werten ist wie folgt definiert:
Das WwanRegisterActionAutomatic-Flag wird vom MB-Dienst verwendet, um den Miniporttreiber anzuweisen, das Gerät auf den automatischen Registrierungsmodus festzulegen und dem Gerät die Auswahl des besten Anbieternetzwerks zu ermöglichen. Der Miniporttreiber muss den ProviderId-Parameter ignorieren. Diese Einstellung ist über Funkzustände (ON/OFF) und Gerätebetriebszyklen hinweg persistent, bis sie explizit vom MB-Dienst geändert wird.
Das WwanRegisterActionManual-Flag wird vom MB-Dienst verwendet, um den Miniporttreiber anzuweisen, sich bei dem Anbieternetzwerk zu registrieren, das durch den ProviderId-Parameter identifiziert wird. Der ProviderId-Wert stammt aus dem ProviderId-Member WWAN_PROVIDER Datenstruktur eines der sichtbaren Anbieter. Diese Einstellung ist für Funkzustände (EIN/AUS) und Geräteeinschaltzyklen persistent, bis sie explizit vom MB-Dienst geändert wird.
Der Wechsel zwischen den verschiedenen RegisterAction-Werten ist auch dann zulässig, wenn das Gerät derzeit bei einem Anbieter registriert ist. Wenn das Gerät die Registrierung vor dem Wechsel zwischen dem Automatischen und manuellen Registrierungsmodus aufheben muss, muss der Miniporttreiber sicherstellen, dass das Gerät auf Die Registrierung eingestellt ist, bevor er den neuen Registrierungsmodus aktiviert.
Der Modus "Manuelle und automatische Registrierung" wirkt sich nur auf den Netzwerkauswahlmodus aus. Das MB-Gerät sollte versuchen, sich beim ausgewählten Netzwerk zu registrieren, wenn das Funkgerät eingeschaltet ist.
Windows 10, Version 1903
Eine neue Revision 3 für diese OID wird ab Windows 10 Version 1903 unterstützt. Diese Erweiterung ermöglicht es dem Host, die bevorzugten Funkzugriffstechnologien (RATs) vom Miniporttreiber abzufragen.
Um die bevorzugte RAT zu steuern, legt der Host eine Bitmaske fest, die WWAN_DATA_CLASS Werte im WwanDataClass-Element der WWAN_SET_REGISTER_STATE-Struktur darstellt. Dieses Element stellt die Datenzugriffstechnologien dar, die für eine Verbindung bevorzugt werden. Wenn dieses Feld auf WWAN_DATA_CLASS_NONE festgelegt ist, sollte das Modem keine Aktion für diesen Parameter ausführen.
Der Host kann auch die derzeit bevorzugten Datenklassen vom Miniporttreiber abfragen. Der Miniporttreiber verwendet das Feld PreferredDataClasses der WWAN_REGISTRATION_STATE-Struktur , um die bevorzugten Datenzugriffstechnologien zu melden, die derzeit im Modem festgelegt sind.
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) |