OID_WWAN_CONNECT

OID_WWAN_CONNECT einen bestimmten Paketkontext aktiviert oder deaktiviert und liest den Aktivierungsstatus eines Kontexts.

Miniporttreiber müssen Satz- 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 Statusbenachrichtigung senden, die eine NDIS_WWAN_CONTEXT_STATE Struktur enthält, die den Kontextstatus des MB-Geräts angibt, unabhängig vom Abschließen von Satz- oder Abfrageanforderungen.

Aufrufer, die anfordern, den Kontextstatus des Paketdatenprotokolls (PACKET Data Protocol, PDP) des MB-Geräts festzulegen, stellen dem Miniporttreiber eine NDIS_WWAN_SET_CONTEXT_STATE Struktur mit den entsprechenden Informationen bereit.

Bemerkungen

Weitere Informationen zur Verwendung dieses OID finden Sie unter WWAN Packet Context Management.

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 in einem Registerstatus von WwanRegisterStateHome, WwanRegisterStatePartneroder WwanRegisterStateRoaming-befindet. Wenn der Paketdienst aktiv ist, muss sich das Gerät auch im Anfügungszustand WwanPacketServiceStateAttachedbefinden.

Sowohl Set- als auch Abfragevorgänge werden für dieses Objekt unterstützt.

• Die Verarbeitung einer festgelegten Anforderung erfordert Netzwerkzugriff, aber keinen SIM-Zugriff.

• Die Verarbeitung einer Abfrageanforderung erfordert keinen Zugriff auf das Netzwerk oder die SIM.

Die Datenstruktur für dieses OID ist NDIS_WWAN_SET_CONTEXT_STATE. Der Miniporttreiber gibt eine Statusanzeige für NDIS_STATUS_WWAN_CONTEXT_STATE für Set- und Abfrageanforderungen aus.

In dieser Version des Treibermodells versucht der Miniport-Treiber nur die Kontextaktivierung, wie vom MB-Dienst angewiesen. (Miniport-Treiber können einen Kontext aktivieren, der vom Netzwerk in späteren Versionen initiiert wird.) Miniport-Treiber dürfen einen Kontext auch nach dem Verlust der Registrierung oder eines Signals nicht automatisch aktivieren. Wenn die Zugriffszeichenfolge in der Aktivierungsanforderung nicht 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 wie vom MB-Dienst angewiesen deaktivieren. Dies kann auftreten, wenn die Netzwerkkonnektivität für einen Zeitraum verloren gegangen ist, der den Schwellenwert des temporären Signalverlusts überschreitet, oder als Teil einer ordnungsgemäßen Herunterfahren oder Zustandsbereinigung.

Da nur ein aktivierter Kontext in dieser Version unterstützt wird, bedeutet die Aktivierung oder Deaktivierung eines bestimmten Kontexts das Einrichten oder Abreißen der Layer-2 MB-Verbindung.

Bei festgelegten Anforderungen werden vom MB-Dienst sowohl ConnectionId als auch ActivationCommand-Parameter in der WWAN_CONTEXT_STATE Datenstruktur bereitgestellt. Er weist den Miniporttreiber an, einen paketkontext zu aktivieren oder zu deaktivieren, der durch ConnectionIdidentifiziert wird, basierend auf dem ActivationCommand Parameterwert WwanActivationCommandActivate oder WwanActivationCommandDeactivate.

• Wenn der Dienst oder das Abonnement eine Aktivierung erfordert, 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. Möglicherweise stehen alle Notfalldienste dem Support des Geräts und des Betreibers zur Verfügung. Das Betriebssystem ruft möglicherweise die OID_WWAN_SERVICE_ACTIVATION als Reaktion auf diesen Fehlercode auf.

• Wenn der Miniporttreiber eine Kontextaktivierungsanforderung empfängt, während derzeit ein anderer Paketkontext aktiviert ist, wird fehlercode WWAN_STATUS_MAX_ACTIVATED_CONTEXTS zurückgegeben.

• Wenn der Miniporttreiber eine Kontext deaktivierungsanforderung empfängt, aber der durch ConnectionId identifizierte Kontext derzeit nicht aktiviert ist, wird fehlercode WWAN_STATUS_CONTEXT_NOT_ACTIVATED zurückgegeben.

Der Miniporttreiber verwendet die folgende Logik, um die Gültigkeit von AccessString-, UserName- und Kennworteinstellungen aus einer festgelegten Anforderung zu ermitteln:

• Wenn ActivationCommand-WwanActivationCommandDeactivateist, sollte der Miniporttreiber die Einstellungen dieser drei Parameter ignorieren. Die restlichen Fälle berücksichtigen nur den Fall, wenn ActivationCommand-WwanActivationCommandActivateist.

Die Kontextaktivierung wird über die Benutzeranmeldung und -abmeldung hinweg beibehalten. 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.

Wichtiger Hinweis:

In seltenen, aber bestimmten Umständen kann der MB-Dienst unter Windows 7 versuchen, eine automatische Verbindung herzustellen, bevor die Verbindung mit dem Internet für bereits vorhandene Verbindungen oder während einer momentären Unterbrechung der Internetverbindung von bereits vorhandenen Verbindungen ermittelt wurde. Dies kann zu gleichzeitigen MB- und WLAN/Ethernet-Verbindungen führen. Dies kann z. B. während des Systemstarts auftreten, wenn MB und andere Verbindungen gleichzeitig versucht werden, und der Netzwerklisten-Manager-Dienst versucht weiterhin, die Internetverbindung anderer Verbindungen mit aktiven und passiven Methoden zu ermitteln. Sie 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 Internetverbindung herzustellen, unabhängig davon, ob die Option "Automatische Verbindung nur dann hergestellt wird, wenn keine alternative Internetverbindung verfügbar ist" ausgewählt ist.

Anforderungen

Siehe auch

WWAN-Paketkontextverwaltung