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.
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;
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.
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) |