structure WWAN_CONTEXT_STATE (wwan.h)

Article
08/08/2023

La structure WWAN_CONTEXT_STATE représente l’état du contexte PDP (Packet Data Protocol) de l’appareil Mo.

Syntaxe

typedef struct _WWAN_CONTEXT_STATE {
  ULONG                    uNwError;
  ULONG                    ConnectionId;
  WWAN_ACTIVATION_STATE    ActivationState;
  WWAN_VOICE_CALL_STATE    VoiceCallState;
  WWAN_IP_TYPE             IPType;
  WWAN_CONNECTION_MEDIA    ConnectionMedia;
  WCHAR                    AccessString[WWAN_ACCESSSTRING_LEN];
  WWAN_SINGLE_NSSAI        Snssai;
  ULONG                    FoundMatchingConnectionId;
  WWAN_OFFSET_SIZE_ELEMENT TrafficParameters;
} WWAN_CONTEXT_STATE, *PWWAN_CONTEXT_STATE;

Membres

uNwError

Erreur spécifique au réseau. Le tableau suivant montre les valeurs d’échec de connexion, comme indiqué dans la spécification 3GPP TS 24.008.

Code de cause 3GPP 24.008	Interprétation du code de cause
8 - Barre déterminée par l’opérateur	Le service de données de paquets est bloqué par l’opérateur.
26 - Ressources insuffisantes	Le contexte ne peut pas être activé en raison de ressources insuffisantes sur le réseau.
27 - Nom du point d’accès (APN) manquant ou inconnu	Aucun APN ou APN inconnu n’est fourni dans la demande d’activation.
29 , 30, 31 - Échec de l’authentification utilisateur	Nom d’utilisateur ou mot de passe incorrect fourni dans la demande d’activation.
32 - Option de service non prise en charge	GPRS n’est pas pris en charge par le réseau.
33 - L’option de service demandée n’est pas souscrite	Le service demandé (GPRS) n’est pas souscrit par l’utilisateur.
34 - L’option de service est temporairement hors service	Le service de données de paquets est temporairement hors service. L’utilisateur doit réessayer ultérieurement.
43 - Contexte PDP (Unknown Packet Data Protocol)	Aucun APN ou APN inconnu n’est fourni dans la demande d’activation.

ConnectionId

Le service MB spécifie une valeur pour ce membre au moment de la demande de connexion à l’aide de OID_WWAN_CONNECT. Les pilotes miniport doivent copier cette valeur et l’utiliser lorsqu’ils informent le service Mb des changements d’état de connexion suivants.

ActivationState

État d’activation actuel de l’appareil.

VoiceCallState

État actuel de l’appel vocal de l’appareil.

IPType

Valeur de l’énumération WWAN_IP_TYPE qui spécifie le type d’adresse IP.

ConnectionMedia

Type de média pour un contexte/session établi.

AccessString[WWAN_ACCESSSTRING_LEN]

APN/DNN sélectionné pour un contexte/une session établie.

Snssai

Structure WWAN_SINGLE_NSSAI représentant une seule information d’assistance à la sélection de tranches réseau (NSSAI).

FoundMatchingConnectionId

Valide uniquement si le status est WWAN_STATUS_SESSION_ALREADY_EXISTS.

TrafficParameters

Structure WWAN_OFFSET_SIZE_ELEMENT . Valide uniquement si le status est WWAN_STATUS_DESSOCIATION_NEEDED_FOR_APPLICATION. Les 4 premiers octets sont le décalage vers le DataBuffer contenant les données brutes de MBIM_TLV_TYPE_TRAFFIC_PARAMETERS, en octets, calculées à 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, en octets.

Remarques

Ensemble Les demandes OID ainsi que les événements de status non sollicités utilisent le membre uNwError. S’il n’y a pas d’erreur propre au réseau ou si l’erreur spécifique au réseau n’est pas connue, les pilotes miniport doivent définir ce membre sur 0.

Les points suivants fournissent des instructions sur le renvoi d’une erreur spécifique au réseau dans différents scénarios :

Si une demande de jeu échoue, les pilotes miniport doivent retourner le code d’erreur propre au réseau. Dans ce cas, le pilote miniport doit définir le membre uStatus de la structure NDIS_WWAN_CONTEXT_STATE sur WWAN_STATUS_FAILURE, ou une erreur plus spécifique comme WWAN_STAUS_INVALID_ACCESS_STRING ou WWAN_STATUS_INVALID_USER_NAME_PWD, et définir le membre uNwError sur le code d’erreur propre au réseau.
Chaque fois que l’état d’activation du contexte de l’appareil change en raison de la désactivation du contexte initié par le réseau, les événements de status non sollicités doivent inclure l’erreur spécifique au réseau. Dans ce cas, le pilote miniport doit définir le membre uStatus de la structure NDIS_WWAN_CONTEXT_STATE sur WWAN_STATUS_SUCCESS et définir le membre uNwError sur le code d’erreur propre au réseau.

Les pilotes miniport peuvent fournir des codes d’erreur supplémentaires tels que définis par la spécification des normes GSM des codes d’erreur d’activation de contexte retournés par le réseau. Par exemple, les pilotes miniport peuvent communiquer les codes d’erreur d’activation du contexte de spécification 3GPP TS 24.008, tels que le code d’erreur 8 (barre déterminée par l’opérateur), au service Mo par le biais du membre uNwError . Il n’existe aucune norme disponible pour les codes d’erreur spécifiques au réseau basés sur CDMA. Les réseaux et les appareils CDMA peuvent retourner des informations de code d’erreur spécifiques au réseau à l’aide du membre uNwError .

En cas de réponse au NDIS_WWAN_SET_CONTEXT_STATE, utilisez ce membre pour fournir des codes d’erreur supplémentaires retournés par le réseau.

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_CONTEXT_STATE

WWAN_ACTIVATION_STATE

WWAN_VOICE_CALL_STATE

Partager via