structure NDIS_WWAN_CONTEXT_STATE (ndiswwan.h)
La structure NDIS_WWAN_CONTEXT_STATE représente l’état de 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 affichées dans le tableau suivant lorsqu’il envoie la structure de données au pilote miniport pour définir opérations. 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 | Les pilotes miniport Windows 8 doivent définir cette valeur sur NDIS_WWAN_CONTEXT_STATE_REVISION_2. Les pilotes miniport Windows 7 doivent définir cette valeur 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
État de l’activation du contexte ou de l’opération de désactivation. Le tableau suivant présente les valeurs possibles pour ce membre.
| Valeur | Signification |
|---|---|
| WWAN_STATUS_SUCCESS | L’activation de contexte ou la désactivation 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 carte SIM incorrecte a été détectée. |
| WWAN_STATUS_SIM_NOT_INSERTED | L’opération a échoué, car la carte SIM n’a pas été insérée entièrement 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 après que l’état prêt de l’appareil change pour 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 de l’opération d’activation PDP.
| 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 requête OID_WWAN_CONNECT définie. Si l’état radio est désactivé, le pilote miniport doit répondre à OID_WWAN_CONNECT requête requêtes 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 PDP. |
| WWAN_STATUS_PROVIDER_NOT_VISIBLE | L’opération a échoué, car le fournisseur de services n’est pas visible actuellement. |
| 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 spécifique 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 continuer avec 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 de contexte PDP (Packet Data Protocol) de l’appareil.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible dans Windows 7 et versions ultérieures de Windows. |
| d’en-tête | ndiswwan.h (include Ndiswwan.h) |