structure WWAN_SET_CONTEXT_STATE (wwan.h)
La structure WWAN_SET_CONTEXT_STATE représente la commande pour 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 la fin de définir demandes. Le service Mo utilise la valeur de ce membre dans les requête suivantes requêtes, 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 montre 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’agirait d’une chaîne APN (Access Point Name) telle que « data.thephone-company.com ». Pour les réseaux CDMA, il peut s’agir d’un code de numérotation spécial tel que « #777 » ou 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 | Activer l’en-tête et la compression 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 Mo 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ée. |
| 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 de sélection de tranche 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 secondes octets sont de taille des données brutes de MBIM_TLV_TYPE_TRAFFIC_PARAMETERS champ de données, en octets.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible dans Windows 8 et versions ultérieures de Windows. |
| d’en-tête | wwan.h (include Wwan.h) |