WWAN_SET_CONTEXT_STATE structure (wwan.h)
La structure WWAN_SET_CONTEXT_STATE représente la commande permettant de définir l’état du contexte PDP (Packet Data Protocol) de l’appareil Mo.
Syntaxe
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;
Membres
ConnectionId
Le service MB spécifie ce membre pour identifier de manière unique le contexte PDP et son état correspondant.
Le service Mo utilise la valeur de ce membre pour identifier de manière unique le contexte actif actuel sur les cartes réseau Mo.
Le pilote miniport doit utiliser la valeur dans ce membre lors de l’exécution des demandes de définition . Le service Mo utilise la valeur de ce membre dans les demandes de requête suivantes, ainsi que les demandes de déconnexion au pilote miniport.
ActivationCommand
Activez ou désactivez un contexte PDP référencé dans le membre ConnectionId . Le tableau suivant présente les valeurs possibles qu’un pilote miniport peut spécifier.
Valeur | Signification |
---|---|
WwanActivationCommandActivate | Activez le contexte PDP référencé par ConnectionId . |
WwanActivationCommandDeactivate | Désactivez un contexte PDP actuellement activé référencé par ConnectionId . |
AccessString[WWAN_ACCESSSTRING_LEN]
Chaîne terminée par NULL pour accéder au réseau. Pour les réseaux gsm, il s’agit d’une chaîne de nom de point d’accès (APN) telle que « data.thephone-company.com ». Pour les réseaux basés sur CDMA, il peut s’agir d’un code de numérotation spécial tel que « #777 » ou d’un identificateur d’accès réseau (NAI) tel que «foo@thephone-company.com ». Ce membre peut être NULL.
La taille de la chaîne ne doit pas dépasser 100 octets.
UserName[WWAN_USERNAME_LEN]
Chaîne terminée par NULL qui représente le nom d’utilisateur à authentifier. Ce membre peut être NULL.
Password[WWAN_PASSWORD_LEN]
Chaîne terminée par NULL qui représente le mot de passe du nom d’utilisateur. Ce membre peut être NULL.
Compression
Valeur de l’énumération WWAN_COMPRESSION qui spécifie si la compression doit être utilisée dans la connexion de données pour l’en-tête et les données. Ce membre s’applique uniquement aux appareils GSM. Le service Mo définit ce membre sur WwanCompressionNone pour les appareils CDMA.
Valeur | Signification |
---|---|
WwanCompressionNone | Aucune compression n’est appliquée. |
WwanCompressionEnable | Activez la compression des en-têtes et des données. |
AuthType
Valeur de l’énumération WWAN_AUTH_PROTOCOL qui spécifie le type d’authentification à utiliser pour l’activation PDP. Ce membre s’applique uniquement aux appareils GSM. Le service MB définit ce membre sur WwanAuthProtocolNone pour les appareils CDMA.
Valeur | Signification |
---|---|
WwanAuthProtocolNone | Aucun protocole d’authentification. |
WwanAuthProtocolPap | Authentification par mot de passe non chiffré. |
WwanAuthProtocolChap | Utilisez le protocole CHAP (Challenge Handshake Authentication Protocol). |
WwanAuthProtocolMsChapV2 | Utilisez le protocole CHAP (Microsoft Challenge Handshake Authentication Protocol) v2.0. |
IPType
Valeur de l’énumération WWAN_IP_TYPE qui spécifie le type d’adresse IP.
MediaPreference
ConnectionMediaSource
ActivationOption
Valeur de l’énumération WWAN_ACTIVATION_OPTION qui représente les options d’activation PDP (Packet Data Protocol) que l’appareil Mo prend en charge.
Snssai
Structure WWAN_SINGLE_NSSAI représentant une seule information d’assistance à la sélection de tranches réseau (NSSAI).
TrafficParameters
Structure WWAN_OFFSET_SIZE_ELEMENT . Les 4 premiers octets sont le décalage vers le DataBuffer contenant les données brutes de MBIM_TLV_TYPE_TRAFFIC_PARAMETERS champ de données, en octets, calculés à partir du début de WWAN_SET_CONTEXT_STATE. Les 4 deuxièmes octets correspondent à la taille des données brutes de MBIM_TLV_TYPE_TRAFFIC_PARAMETERS champ de données, en octets.
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Disponible dans Windows 8 et versions ultérieures de Windows. |
En-tête | wwan.h (inclure Wwan.h) |