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