WWAN_CONTEXT_STATE-Struktur (wwan.h)

Artikel
02/27/2024

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

Freigeben über