WWAN_CONTEXT_STATE-Struktur (wwan.h)

Die WWAN_CONTEXT_STATE-Struktur stellt den PDP-Kontextstatus (Packet Data Protocol) des MB-Geräts dar.

Syntax

typedef struct _WWAN_CONTEXT_STATE {
  ULONG                    uNwError;
  ULONG                    ConnectionId;
  WWAN_ACTIVATION_STATE    ActivationState;
  WWAN_VOICE_CALL_STATE    VoiceCallState;
  WWAN_IP_TYPE             IPType;
  WWAN_CONNECTION_MEDIA    ConnectionMedia;
  WCHAR                    AccessString[WWAN_ACCESSSTRING_LEN];
  WWAN_SINGLE_NSSAI        Snssai;
  ULONG                    FoundMatchingConnectionId;
  WWAN_OFFSET_SIZE_ELEMENT TrafficParameters;
} WWAN_CONTEXT_STATE, *PWWAN_CONTEXT_STATE;

Member

uNwError

Ein netzwerkspezifischer Fehler. In der folgenden Tabelle sind die Werte für Verbindungsfehler aufgeführt, die in der 3GPP TS 24.008-Spezifikation dokumentiert sind.

3GPP 24.008-Ursachecode	Interpretation von Ursachecode
8 - Operator bestimmt Sperrung	Der Paketdatendienst wird vom Operator blockiert.
26 – Unzureichende Ressourcen	Der Kontext kann aufgrund unzureichender Ressourcen im Netzwerk nicht aktiviert werden.
27: Fehlender oder unbekannter Zugriffspunktname (APN)	In der Aktivierungsanforderung wird kein APN oder unbekannter APN angegeben.
29 , 30, 31 – Fehler bei der Benutzerauthentifizierung	Falscher Benutzername oder falsches Kennwort in der Aktivierungsanforderung angegeben.
32 : Dienstoption wird nicht unterstützt	GPRS wird vom Netzwerk nicht unterstützt.
33 : Die Option Angeforderter Dienst ist nicht abonniert	Der angeforderte Dienst (GPRS) wird vom Benutzer nicht abonniert.
34 : Die Dienstoption ist vorübergehend nicht in Ordnung	Der Paketdatendienst ist vorübergehend nicht in Ordnung. Der Benutzer muss es später wiederholen.
43: PdP-Kontext (Unknown Packet Data Protocol)	In der Aktivierungsanforderung wird kein APN oder unbekannter APN angegeben.

ConnectionId

Der MB-Dienst gibt einen Wert für dieses Element zum Zeitpunkt der Verbindungsanforderung mithilfe von OID_WWAN_CONNECT an. Miniporttreiber müssen diesen Wert kopieren und verwenden, wenn sie den MB-Dienst über nachfolgende Verbindungsstatusänderungen benachrichtigen.

ActivationState

Der aktuelle Aktivierungsstatus des Geräts.

VoiceCallState

Der aktuelle Sprachanrufstatus des Geräts.

IPType

Ein Wert aus der WWAN_IP_TYPE-Enumeration, der den IP-Typ angibt.

ConnectionMedia

Der Medientyp für einen festgelegten Kontext/eine festgelegte Sitzung.

AccessString[WWAN_ACCESSSTRING_LEN]

Der ausgewählte APN/DNN für einen festgelegten Kontext/eine festgelegte Sitzung.

Snssai

Eine WWAN_SINGLE_NSSAI-Struktur , die eine einzelne Netzwerkschnittauswahlunterstützungsinformation (Network Slice Selection Assistance Information, NSSAI) darstellt.

FoundMatchingConnectionId

Nur gültig, wenn die status WWAN_STATUS_SESSION_ALREADY_EXISTS ist.

TrafficParameters

Eine WWAN_OFFSET_SIZE_ELEMENT-Struktur . Nur gültig, wenn die status WWAN_STATUS_DESSOCIATION_NEEDED_FOR_APPLICATION ist. Die ersten 4 Bytes sind der Offset auf den DataBuffer, der die Rohdaten von MBIM_TLV_TYPE_TRAFFIC_PARAMETERS in Bytes enthält, die von Anfang WWAN_SET_CONTEXT_STATE berechnet werden. Die zweiten 4 Bytes sind die Größe der Rohdaten von MBIM_TLV_TYPE_TRAFFIC_PARAMETERS in Bytes.

Hinweise

Festgelegt OID-Anforderungen sowie unerwünschte status Ereignisse verwenden das uNwError-Element. Wenn kein netzwerkspezifischer Fehler vorliegt oder der netzwerkspezifische Fehler nicht bekannt ist, sollten Miniporttreiber diesen Member auf 0 festlegen.

Die folgenden Punkte enthalten Richtlinien zum Zurückgeben netzwerkspezifischer Fehler in verschiedenen Szenarien:

• Wenn bei einer Setanforderung ein Fehler auftritt, sollten Miniporttreiber den netzwerkspezifischen Fehlercode zurückgeben. In diesem Fall sollte der Miniporttreiber den uStatus-Member der NDIS_WWAN_CONTEXT_STATE-Struktur auf WWAN_STATUS_FAILURE oder einen spezifischeren Fehler wie WWAN_STAUS_INVALID_ACCESS_STRING oder WWAN_STATUS_INVALID_USER_NAME_PWD festlegen und den uNwError-Member auf den netzwerkspezifischen Fehlercode festlegen.
• Wenn sich der Aktivierungsstatus des Gerätekontexts aufgrund einer netzwerkinitiierten Kontextaktivierung ändert, sollten nicht angeforderte status Ereignisse den netzwerkspezifischen Fehler enthalten. In diesem Fall sollte der Miniporttreiber den uStatus-Member der NDIS_WWAN_CONTEXT_STATE-Struktur auf WWAN_STATUS_SUCCESS festlegen und den uNwError-Member auf den netzwerkspezifischen Fehlercode festlegen.

Miniporttreiber können zusätzliche Fehlercodes bereitstellen, die in der GSM-Standardspezifikation der vom Netzwerk zurückgegebenen Kontextaktivierungsfehlercodes definiert sind. Miniporttreiber können beispielsweise die Fehlercodes der 3GPP-Spezifikation TS 24.008 für die Kontextaktivierung, z. B. Fehlercode 8 (Operator ermittelte Sperrung), an den MB-Dienst über das uNwError-Member kommunizieren. Für CDMA-basierte netzwerkspezifische Fehlercodes ist kein Standard verfügbar. CDMA-basierte Geräte und Netzwerke können mithilfe des uNwError-Members netzwerkspezifische Fehlercodeinformationen zurückgeben.

Im Fall einer Antwort auf die NDIS_WWAN_SET_CONTEXT_STATE verwenden Sie dieses Element, um zusätzliche Fehlercodes bereitzustellen, die vom Netzwerk zurückgegeben werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows 8 und höheren Versionen von Windows.
Kopfzeile	wwan.h (include Wwan.h)

Weitere Informationen

NDIS_WWAN_CONTEXT_STATE

WWAN_ACTIVATION_STATE

WWAN_VOICE_CALL_STATE