NDIS_WWAN_CONTEXT_STATE structure (ndiswwan.h)

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

Syntaxe

typedef struct _NDIS_WWAN_CONTEXT_STATE {
  NDIS_OBJECT_HEADER Header;
  WWAN_STATUS        uStatus;
  WWAN_CONTEXT_STATE ContextState;
} NDIS_WWAN_CONTEXT_STATE, *PNDIS_WWAN_CONTEXT_STATE;

Membres

Header

En-tête avec des informations de type, de révision et de taille sur la structure NDIS_WWAN_CONTEXT_STATE. Le service Mo définit l’en-tête avec les valeurs indiquées dans le tableau suivant lorsqu’il envoie la structure de données au pilote miniport pour les opérations de définition . Les pilotes Miniport doivent définir l’en-tête avec les mêmes valeurs lorsqu’ils envoient la structure de données au service Mo.

Sous-membre d’en-tête	Valeur
Type	NDIS_OBJECT_TYPE_DEFAULT
Révision	Windows 8 pilotes de miniport doivent définir cette valeur sur NDIS_WWAN_CONTEXT_STATE_REVISION_2. Les pilotes miniport Windows 7 doivent définir ce paramètre sur NDIS_WWAN_CONTEXT_STATE_REVISION_1.
Taille	sizeof(NDIS_WWAN_CONTEXT_STATE)

 

Pour plus d’informations sur ces membres, consultez NDIS_OBJECT_HEADER.

uStatus

Status de l’opération d’activation ou de désactivation du contexte. Le tableau suivant montre les valeurs possibles pour ce membre.

Valeur	Signification
WWAN_STATUS_SUCCESS	L’activation ou la désactivation du contexte a réussi.
WWAN_STATUS_FAILURE	L'opération a échoué. Les pilotes Miniport peuvent retourner cette valeur si le contexte a déjà été activé.
WWAN_STATUS_PIN_REQUIRED	L’opération a échoué, car l’appareil nécessite un code confidentiel.
WWAN_STATUS_BAD_SIM	L’opération a échoué car une mauvaise carte SIM a été détectée.
WWAN_STATUS_SIM_NOT_INSERTED	L’opération a échoué, car le carte SIM n’a pas été entièrement inséré dans l’appareil.
WWAN_STATUS_NOT_INITIALIZED	L’opération a échoué, car l’appareil est en cours d’initialisation. Réessayez l’opération une fois l’état prêt de l’appareil passé à WwanReadyStateInitialized.

 

Les pilotes Miniport peuvent retourner les codes d’erreur suivants (en plus de ceux décrits précédemment) uniquement en cas d’échec d’une opération d’activation PDP définie.

Valeur	Signification
WWAN_STATUS_RADIO_POWER_OFF	L’opération a échoué, car la radio est actuellement désactivée. Ce code d’erreur doit être retourné uniquement en réponse à une demande de définition de OID_WWAN_CONNECT. Si l’état radio est désactivé, le pilote miniport doit répondre aux requêtes de OID_WWAN_CONNECT avec WWAN_STATUS_SUCCESS et spécifier l’état de contexte actuel comme WwanActivationStateDeactivated.
WWAN_STATUS_SERVICE_NOT_ACTIVATED	L’opération a échoué, car l’abonnement a expiré ou l’appareil n’autorise pas l’activation de PDP.
WWAN_STATUS_PROVIDER_NOT_VISIBLE	L’opération a échoué, car le fournisseur de services n’est actuellement pas visible.
WWAN_STATUS_MAX_ACTIVATED_CONTEXTS	L’opération a échoué, car le nombre maximal de contextes activés a été atteint.
WWAN_STATUS_INVALID_ACCESS_STRING	L’opération a échoué, car la chaîne d’accès n’est pas valide.
WWAN_STATUS_INVALID_USER_NAME_PWD	L’opération a échoué, car le nom d’utilisateur et/ou le mot de passe fournis ne sont pas valides. Le code d’erreur propre au réseau peut être disponible dans uNwError .
WWAN_STATUS_PACKET_SVC_DETACHED	L’opération a échoué, car le service de paquets est détaché.
WWAN_STATUS_NOT_REGISTERED	L’opération a échoué, car l’appareil n’est pas dans l’état inscrit pour effectuer l’activation PDP.
WWAN_STATUS_VOICE_CALL_IN_PROGRESS	L’opération a échoué et ne peut pas poursuivre l’activation PDP, car un appel vocal est en cours. Cette valeur s’applique uniquement aux appareils dont la classe vocale est définie sur WwanVoiceClassSeparateVoiceData.
WWAN_STATUS_CONTEXT_NOT_ACTIVATED	L’opération a échoué, car le contexte identifié par ConnectionId n’est pas le contexte actuellement activé.

ContextState

Objet WWAN_CONTEXT_STATE mis en forme qui représente l’état du contexte PDP (Packet Data Protocol) de l’appareil.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows 7 et versions ultérieures de Windows.
En-tête	ndiswwan.h (include Ndiswwan.h)

Voir aussi

NDIS_OBJECT_HEADER

WWAN_CONTEXT_STATE