WWAN_SET_CONTEXT_STATE-Struktur (wwan.h)

Die WWAN_SET_CONTEXT_STATE-Struktur stellt den Befehl zum Festlegen des PDP-Kontextzustands (Packet Data Protocol) des MB-Geräts dar.

Syntax

typedef struct _WWAN_SET_CONTEXT_STATE {
  ULONG                     ConnectionId;
  WWAN_ACTIVATION_COMMAND   ActivationCommand;
  WCHAR                     AccessString[WWAN_ACCESSSTRING_LEN];
  WCHAR                     UserName[WWAN_USERNAME_LEN];
  WCHAR                     Password[WWAN_PASSWORD_LEN];
  WWAN_COMPRESSION          Compression;
  WWAN_AUTH_PROTOCOL        AuthType;
  WWAN_IP_TYPE              IPType;
  WWAN_PSMEDIA_PREFERENCE   MediaPreference;
  WWAN_CONFIGURATION_SOURCE ConnectionMediaSource;
  WWAN_ACTIVATION_OPTION    ActivationOption;
  WWAN_SINGLE_NSSAI         Snssai;
  WWAN_OFFSET_SIZE_ELEMENT  TrafficParameters;
} WWAN_SET_CONTEXT_STATE, *PWWAN_SET_CONTEXT_STATE;

Member

ConnectionId

MB Service gibt diesen Member an, um den PDP-Kontext und den entsprechenden Zustand eindeutig zu identifizieren.

Der MB-Dienst verwendet den Wert in diesem Member, um den aktuellen aktiven Kontext über MB-Netzwerkadapter eindeutig zu identifizieren.

Der Miniporttreiber muss den Wert in diesem Member verwenden, wenn er Mengenanforderungen abschließt. Der MB-Dienst verwendet den Wert in diesem Member in nachfolgenden Abfrageanforderungen sowie in Verbindungsanforderungen an den Miniporttreiber.

ActivationCommand

Aktivieren oder deaktivieren Sie einen PDP-Kontext, auf den im ConnectionId-Member verwiesen wird. Die folgende Tabelle zeigt die möglichen Werte, die ein Miniporttreiber angeben kann.

Wert	Bedeutung
WwanActivationCommandActivate	Aktivieren Sie den PDP-Kontext, auf den von ConnectionId verwiesen wird .
WwanActivationCommandDeactivate	Deaktivieren Sie einen aktuell aktivierten PDP-Kontext, der von ConnectionId verwiesen wird.

AccessString[WWAN_ACCESSSTRING_LEN]

Eine NULL-beendete Zeichenfolge für den Zugriff auf das Netzwerk. Für GSM-basierte Netzwerke wäre dies eine APN-Zeichenfolge (Access Point Name), z. B. "data.thephone-company.com". Bei CDMA-basierten Netzwerken kann dies eine spezielle Wählvorwahl wie "#777" oder eine Netzwerkzugriffs-ID (NAI) wie "foo@thephone-company.com" sein. Dieser Member kann NULL sein.

Die Größe der Zeichenfolge darf 100 Byte nicht überschreiten.

UserName[WWAN_USERNAME_LEN]

Eine NULL-beendete Zeichenfolge, die den zu authentifizierden Benutzernamen darstellt. Dieser Member kann NULL sein.

Password[WWAN_PASSWORD_LEN]

Eine NULL-beendete Zeichenfolge, die das Kennwort des Benutzernamens darstellt. Dieser Member kann NULL sein.

Compression

Ein Wert aus der WWAN_COMPRESSION-Enumeration, der angibt, ob die Komprimierung in der Datenverbindung für Header und Daten verwendet werden soll. Dieser Member gilt nur für GSM-basierte Geräte. Der MB-Dienst legt diesen Member für CDMA-basierte Geräte auf WwanCompressionNone fest.

Wert	Bedeutung
WwanCompressionNone	Es wird keine Komprimierung angewendet.
WwanCompressionEnable	Aktivieren Sie die Header- und Datenkomprimierung.

AuthType

Ein Wert aus der WWAN_AUTH_PROTOCOL-Enumeration, der den Authentifizierungstyp angibt, der für die PDP-Aktivierung verwendet werden soll. Dieser Member gilt nur für GSM-basierte Geräte. Der MB-Dienst legt dieses Element für CDMA-basierte Geräte auf WwanAuthProtocolNone fest.

Wert	Bedeutung
WwanAuthProtocolNone	Kein Authentifizierungsprotokoll.
WwanAuthProtocolPap	Unverschlüsselte Kennwortauthentifizierung.
WwanAuthProtocolChap	Verwenden Sie das Challenge Handshake Authentication Protocol (CHAP).
WwanAuthProtocolMsChapV2	Verwenden Sie das Microsoft Challenge Handshake Authentication Protocol (CHAP) v2.0.

IPType

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

MediaPreference

ConnectionMediaSource

ActivationOption

Ein Wert aus der WWAN_ACTIVATION_OPTION-Enumeration , der die PDP-Aktivierungsoptionen (Packet Data Protocol) darstellt, die vom MB-Gerät unterstützt werden.

Snssai

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

TrafficParameters

Eine WWAN_OFFSET_SIZE_ELEMENT-Struktur . Die ersten 4 Bytes sind der Offset zum DataBuffer, der die Rohdaten MBIM_TLV_TYPE_TRAFFIC_PARAMETERS Datenfelds in Bytes enthält, die von Anfang WWAN_SET_CONTEXT_STATE berechnet werden. Die zweiten 4 Bytes sind die Größe der Rohdaten MBIM_TLV_TYPE_TRAFFIC_PARAMETERS Datenfelds in Bytes.

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_SET_CONTEXT_STATE

WWAN_ACTIVATION_COMMAND

WWAN_AUTH_PROTOCOL

WWAN_COMPRESSION