Partager via


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)

Voir aussi

NDIS_WWAN_SET_CONTEXT_STATE

WWAN_ACTIVATION_COMMAND

WWAN_AUTH_PROTOCOL

WWAN_COMPRESSION