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.

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.

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.

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

Weitere Informationen

NDIS_WWAN_SET_CONTEXT_STATE

WWAN_ACTIVATION_COMMAND

WWAN_AUTH_PROTOCOL

WWAN_COMPRESSION