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.
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) |