NDIS_STATUS_WWAN_REGISTER_STATE
Miniporttreiber verwenden die NDIS_STATUS_WWAN_REGISTER_STATE-Benachrichtigung, um Änderungen am Registrierungsstatus des MB-Geräts an den MB-Dienst zu übermitteln.
Miniport-Treiber können mit dieser Benachrichtigung auch unerwünschte Ereignisse senden.
Diese Benachrichtigung verwendet die NDIS_WWAN_REGISTRATION_STATE-Struktur .
Bemerkungen
Wenn sich der Registrierungsstatus des Geräts ändert, muss der Miniporttreiber entsprechende Hinweise senden, damit der MB-Dienst dem Benutzer den richtigen Zustand widerspiegeln kann.
Der Registrierungsstatus ändert sich aus verschiedenen Gründen. Dies kann direkt auf Anforderungen des MB-Diensts für OID_WWAN_REGISTER_STATE wie einen vorübergehenden Zustandsübergang von WwanRegisterStateSearching zu WwanRegisterStateHome resultieren. Bei der automatischen Anbieterauswahl kann es auch zu automatischen Vorgängen durch den Miniporttreiber führen. Schließlich kann dies durch eine Änderung der Netzwerkverfügbarkeit verursacht werden, z. B. ein Verlust der Netzwerkabdeckung kann zu einem Übergang von WwanRegisterStateHome zu WwanRegisterStateDeregistered führen.
Mit Ausnahme der Änderungen, die durch MB Service OID_WWAN_REGISTER_STATE-Anforderungen verursacht werden, benachrichtigt der Miniporttreiber den MB-Dienst, wenn sich der Registrierungsstatus unabhängig von der zugrunde liegenden Ursache ändert.
CDMA-Geräte unterstützen die vom MB-Dienst initiierte Registrierung und Aufhebung der Registrierung nicht. Allerdings müssen Benachrichtigungen über eine vom Gerät initiierte Statusänderung basierend auf der Verfügbarkeit oder Nichtverfügbarkeit des Carriernetzwerks an den MB-Dienst gesendet werden. CDMA-Geräte müssen eine automatische Registrierung durchführen.
Bei Geräten, die die automatische Registrierung beim Einschalten durchführen, muss der Miniporttreiber unabhängig vom aktuellen Registrierungsmodus (auto oder manuell) die Statusbenachrichtigung des Registers über die erfolgreiche Registrierung senden.
Für die manuelle Registrierung initiiert der MB-Dienst die Registrierung erst, nachdem der Miniporttreiber angegeben hat, dass ReadyStateWwanReadyStateInitialized ist.
Der Miniporttreiber muss die folgenden Richtlinien verwenden, wenn er auf festgelegte Anforderungen reagiert:
Treiber dürfen nicht mit vorübergehendem Zustand auf eine festgelegte Anforderung reagieren. Vorübergehender Status für die Registrierung ist WwanRegisterStateSearching.
Wenn RegisterAction auf WwanRegisterActionManual festgelegt ist, gibt der Miniporttreiber fehlercode WWAN_STATUS_PROVIDER_NOT_VISIBLE zurück, wenn der Anbieter nicht sichtbar ist, wenn der Miniporttreiber die Anforderung empfängt. Das Gerät darf aufgrund eines Fehlers beim Festlegen des manuellen Modus nicht zur automatischen Registrierung wechseln. Wenn das Gerät zuvor auf die manuelle Registrierung bei einem anderen Netzwerk festgelegt wurde, sollte diese Anforderung das Gerät so ändern, dass es sich bei dem in der Anforderung angegebenen Netzwerk registriert. Der Wert von RegisterState als Antwort auf die Anforderung sollte auf WwanRegisterStateDeregistered festgelegt werden.
Wenn RegisterAction auf WwanRegisterActionManual festgelegt ist, antwortet er mit WWAN_STATUS_SUCCESS, wenn sich der Miniporttreiber bereits bei dem angeforderten Netzwerk registriert hat.
Der Treiber sollte versuchen, sich in der OID_WWAN_REGISTER Anforderung bei der angeforderten Datenklasse zu registrieren. Wenn sich der Miniporttreiber nicht bei der angeforderten Datenklasse registrieren kann, sollte er sich bei der bestmöglichen Datenklasse registrieren. Dies gilt auch, wenn das Gerät bereits bei einem Anbieter registriert ist (automatischer und manueller Registrierungsmodus) mit einer anderen Datenklasse. Jede Änderung der Datenklasse sollte auch zu NDIS_STATUS_WWAN_PACKET_SERVICE Benachrichtigung führen.
Wenn RegisterAction auf WwanRegisterActionManual festgelegt ist und das Radio off ist, muss der Miniporttreiber das Gerät auf den manuellen Registrierungsmodus programmieren und die Anforderung mit der Transaktionsbenachrichtigung abschließen. RegisterState sollte auf WwanRegisterStateDeregistered festgelegt werden. Das Gerät muss eine manuelle Registrierung versuchen, wenn das Funkgerät in den Zustand ON wechselt und die Ereignisbenachrichtigung gesendet werden muss.
Wenn RegisterAction auf WwanRegisterActionAutomatic festgelegt ist und das Radio AUS ist, muss der Miniporttreiber das Gerät in den automatischen Registrierungsmodus programmieren und die Anforderung mit der Transaktionsbenachrichtigung abschließen. RegisterState sollte auf WwanRegisterStateDeregistered festgelegt werden. Das Gerät muss eine automatische Registrierung durchführen, wenn das Radio in den Zustand ON wechselt und die Ereignisbenachrichtigung gesendet werden muss.
Im Falle einer Notfallstatusregistrierung ( WwanRegisterStateDenied) sollte der uStatus auf WWAN_STATUS_SUCCESS festgelegt werden, und NDIS_STATUS_WWAN_READY_INFO Benachrichtigung muss gesendet werden, wobei EmergencyMode auf WwanEmergencyModeOn festgelegt ist.
Für die Verwendung des Status WwanRegisterStateDeregistered muss der Miniporttreiber die folgenden Richtlinien verwenden:
WwanRegisterStateDeregistered wird von den Miniporttreibern verwendet, um den MB-Dienst darüber zu benachrichtigen, dass das Radio AUS ist, aber die Anforderung für RegisterAction abgeschlossen ist.
WwanRegisterStateDeregistered wird von den Miniporttreibern verwendet, um den MB-Dienst über eine netzwerkinitiierte Deregistrierung zu benachrichtigen.
WwanRegisterStateDeregistered wird von den Miniporttreibern verwendet, um den MB-Dienst über den Verlust der Verbindung mit dem Netzwerk zu benachrichtigen, da keine Netzwerkabdeckung vorhanden ist.
GSM- und CDMA-Geräte müssen die Registerzustandsbenachrichtigung senden, um die Verfügbarkeit oder Nichtverfügbarkeit des Netzbetreibers für eine PS-Verbindung zu benachrichtigen. Wenn das MB-Gerät die Verfügbarkeit des Carriernetzwerks erkennt, muss es eine Ereignisbenachrichtigung mit einem der entsprechenden Registerzustände senden: WwanRegisterStateHome, WwanRegisterStateRoaming oder WwanRegisterStatePartner. Beim Verlust des Carriernetzwerksignals muss eine Ereignisbenachrichtigung mit WwanRegisterStateDeregistered für den MB-Dienst angegeben werden.
Der Miniporttreiber gibt das Abfrageergebnis gemäß den folgenden Regeln zurück:
Wenn das Gerät versucht, sich während der Registrierung für einen Anbieter zu sperren, muss der Miniporttreiber RegisterState auf WwanRegisterStateSearching festlegen. Sowohl das ProviderName- als auch das RoamingText-Element sollten auf NULL festgelegt werden. Im Fall des manuellen Registrierungsmodus muss Die ProviderId mit der ProviderId aus der letzten manuellen Registrierungssatzanforderung ausgefüllt werden. ProviderId kann im Fall des automatischen Registrierungsmodus auf NULL festgelegt werden.
Dies ist ein vorübergehender Zustand, da der Miniporttreiber am Ende der Registrierung schließlich in einen stabilen Zustand wechselt, z. B. WwanRegisterStateHome, WwanRegisterStatePartner oder WwanRegisterStateRoaming für eine erfolgreiche Registrierung. oder WwanRegisterStateDenied für eine Notstandsregistrierung.
Wenn das Gerät bei keinem Anbieter registriert ist, gibt der Miniporttreiber WwanRegisterStateDeregistered zurück. Sowohl das ProviderName- als auch das RoamingText-Element sollten auf NULL festgelegt werden. Im Fall des manuellen Registrierungsmodus muss Die ProviderId mit der ProviderId aus der letzten manuellen Registrierungssatzanforderung ausgefüllt werden. ProviderId kann im Fall des automatischen Registrierungsmodus auf NULL festgelegt werden.
Wenn das Gerät beim Heimanbieter registriert ist, muss der Miniporttreiber RegisterState als WwanRegisterStateHome festlegen. Das ProviderId-Mitglied wird auf die Heimanbieter-ID festgelegt. ProviderName muss auf den Namen des Heimanbieternetzwerks festgelegt werden. Das RoamingText-Element sollte auf NULL festgelegt werden.
Wenn das Gerät bei einem Roaminganbieter registriert ist, legt der Miniporttreiber RegisterState auf WwanRegisterStatePartner fest, wenn der Anbieter ein bevorzugter Roamingpartner oder nur WwanRegisterStateRoaming für einen Roamingpartner ist. Wenn der Miniporttreiber die beiden nicht unterscheidet, muss er den Wert auf WwanRegisterStateRoaming festlegen. Das ProviderId-Mitglied wird auf die Anbieter-ID des aktuellen Anbieters festgelegt, bei dem das Gerät registriert ist, und der ProviderName muss mit dem aktuellen registrierten Anbieternamen ausgefüllt werden. Der RoamingText-Member sollte auf einen anbieterspezifischen Zeichenfolgenwert festgelegt werden, sofern vorhanden, oder andernfalls auf NULL .
Requirements (Anforderungen)
Version |
Verfügbar in Windows 7 und späteren Windows-Versionen. |
Header |
Ndis.h |