OID_WWAN_CONNECT
OID_WWAN_CONNECT aktiviert oder deaktiviert einen bestimmten Paketkontext und liest den Aktivierungsstatus eines Kontexts.
Miniport-Treiber müssen Set- und Abfrageanforderungen asynchron verarbeiten, zunächst NDIS_STATUS_INDICATION_REQUIRED an die ursprüngliche Anforderung zurückgeben und später eine NDIS_STATUS_WWAN_CONTEXT_STATE status Benachrichtigung senden, die eine NDIS_WWAN_CONTEXT_STATE-Struktur enthält, die den PDP-Kontextstatus (Packet Data Protocol) des MB-Geräts unabhängig vom Abschließen von Set- oder Abfrageanforderungen angibt.
Anrufer, die den PDP-Kontextstatus (Packet Data Protocol) des MB-Geräts festlegen möchten, stellen dem Miniporttreiber eine NDIS_WWAN_SET_CONTEXT_STATE Struktur mit den entsprechenden Informationen bereit.
Bemerkungen
Weitere Informationen zur Verwendung dieser OID finden Sie unter WWAN-Paketkontextverwaltung.
Dieses Objekt aktiviert oder deaktiviert einen bestimmten Paketkontext und liest den Aktivierungsstatus eines Kontexts. Der Miniporttreiber muss entsprechende Ereignisbenachrichtigungen senden, wenn sich der Aktivierungsstatus ändert.
Dieses Objekt wird nur aufgerufen, wenn sich der Miniporttreiber im Registerstatus WwanRegisterStateHome, WwanRegisterStatePartner oder WwanRegisterStateRoaming befindet. Wenn der Paketdienst aktiv ist, muss sich das Gerät auch im Angefügten Zustand WwanPacketServiceStateAttached befinden.
Sowohl Set- als auch Abfragevorgänge werden für dieses Objekt unterstützt.
Die Verarbeitung einer festgelegten Anforderung erfordert Netzwerkzugriff, aber keinen SIM-Zugriff.
Für die Verarbeitung einer Abfrageanforderung ist kein Zugriff auf das Netzwerk oder die SIM erforderlich.
Die Datenstruktur für diese OID ist NDIS_WWAN_SET_CONTEXT_STATE. Der Miniporttreiber gibt einen status Hinweis auf NDIS_STATUS_WWAN_CONTEXT_STATE sowohl für Set- als auch für Abfrageanforderungen aus.
In dieser Version des Treibermodells versucht der Miniporttreiber die Kontextaktivierung nur auf Anweisung des MB-Diensts. (Miniport-Treiber können in späteren Versionen einen vom Netzwerk initiierten Kontext aktivieren.) Miniport-Treiber dürfen einen Kontext auch nach dem Verlust der Registrierung oder eines Signals nicht automatisch aktivieren. Wenn die Zugriffszeichenfolge nicht in der Aktivierungsanforderung angegeben wird, sollte ein Miniporttreiber nicht versuchen, eine Standardzeichenfolge bereitzustellen. Stattdessen muss der Kontext mit einer leeren Zugriffszeichenfolge aktiviert werden.
Andererseits kann der Miniporttreiber einen Kontext deaktivieren, wie vom MB-Dienst angewiesen. Dies kann auftreten, wenn die Netzwerkkonnektivität für einen Zeitraum, der den Schwellenwert des vorübergehenden Signalverlusts überschreitet, oder im Rahmen eines ordnungsgemäßen Herunterfahrens oder einer Zustandsbereinigung verloren gegangen ist.
Da in dieser Version nur ein aktivierter Kontext unterstützt wird, bedeutet die Aktivierung oder Deaktivierung eines bestimmten Kontexts das Einrichten oder Herunterreißen der Layer-2-MB-Verbindung.
Bei festgelegten Anforderungen gibt der MB-Dienst sowohl die Parameter ConnectionId als auch ActivationCommand in der WWAN_CONTEXT_STATE Datenstruktur an. Er weist den Miniporttreiber an, einen von ConnectionId identifizierten Paketkontext basierend auf dem ActivationCommand-ParameterwertWwanActivationCommandActivate oder WwanActivationCommandDeactivate zu aktivieren oder zu deaktivieren.
Wenn für den Dienst oder das Abonnement eine Aktivierung erforderlich ist, sollte der Miniporttreiber fehlercode WWAN_STATUS_SERVICE_NOT_ACTIVATED zurückgeben. Die PDP-Aktivierung erfolgt möglicherweise erst, wenn der Dienst oder das Abonnement aktiviert ist. Alle Notfalldienste sind möglicherweise verfügbar, abhängig vom Support des Geräts und des Bedieners. Das Betriebssystem kann als Reaktion auf diesen Fehlercode den OID_WWAN_SERVICE_ACTIVATION aufrufen.
Wenn der Miniporttreiber eine Kontextaktivierungsanforderung empfängt, während ein anderer Paketkontext derzeit aktiviert ist, gibt er fehlercode WWAN_STATUS_MAX_ACTIVATED_CONTEXTS zurück.
Wenn der Miniporttreiber eine Anforderung zur Deaktivierung des Kontexts empfängt, der durch ConnectionId identifizierte Kontext jedoch derzeit nicht aktiviert ist, wird der Fehlercode WWAN_STATUS_CONTEXT_NOT_ACTIVATED zurückgegeben.
Der Miniporttreiber verwendet die folgende Logik, um die Gültigkeit der Einstellungen AccessString, UserName und Password aus einer festgelegten Anforderung zu bestimmen:
- Wenn ActivationCommandWwanActivationCommandDeactivate ist, sollte der Miniporttreiber die Einstellungen dieser drei Parameter ignorieren. In den restlichen Fällen wird nur der Fall berücksichtigt, wenn ActivationCommandWwanActivationCommandActivate ist.
Die Kontextaktivierung bleibt bei der Benutzeranmeldung und -abmeldung erhalten. Dies ist nicht pro Anmeldebenutzer.
Bei Abfrageanforderungen verwendet der MB-Dienst dieses Objekt, um den Aktivierungsstatus zu ermitteln.
Für die Antwort auf Abfrageanforderungen sendet der Miniporttreiber die NDIS_STATUS_WWAN_CONTEXT_STATE Benachrichtigung.
Wichtig Hinweis:
In seltenen, aber spezifischen Umständen kann der MB-Dienst unter Windows 7 versuchen, eine automatische Verbindung herzustellen, bevor die Konnektivität mit dem Internet für bereits vorhandene Verbindungen oder während einer vorübergehenden Unterbrechung der Internetkonnektivität bereits vorhandener Verbindungen ermittelt wurde. Dies kann zu gleichzeitigen MB- und WLAN/Ethernet-Verbindungen führen. Dies kann beispielsweise während des Systemstarts auftreten, wenn mb- und andere Verbindungen gleichzeitig versucht werden und der Netzwerklisten-Manager-Dienst weiterhin versucht, die Internetkonnektivität anderer Verbindungen mithilfe aktiver und passiver Methoden zu ermitteln. Es kann auch aufgrund temporärer Ausfälle in der Netzwerkinfrastruktur wie einem Unternehmensproxyserver oder einem ISP-Netzwerk auftreten. Daher kann der MB-Dienst versuchen, eine automatische Verbindung mit dem Internet herzustellen, unabhängig davon, ob die Option "Automatische Verbindung nur herstellen, wenn keine alternative Internetverbindung verfügbar ist" ausgewählt ist.
Requirements (Anforderungen)
Version |
Verfügbar in Windows 7 und späteren Windows-Versionen. |
Header |
Ntddndis.h (include Ndis.h) |