OID_WWAN_CONNECT

OID_WWAN_CONNECT active ou désactive un contexte de paquet particulier et lit l’état d’activation d’un contexte.

Les pilotes Miniport doivent traiter de manière asynchrone les requêtes définies et de requête, en retournant initialement NDIS_STATUS_INDICATION_REQUIRED à la demande d’origine, puis en envoyant une notification NDIS_STATUS_WWAN_CONTEXT_STATE status contenant une structure de NDIS_WWAN_CONTEXT_STATE qui indique l’état du contexte PDP (Packet Data Protocol) de l’appareil Mo, quelle que soit la fin des demandes d’ensemble ou de requête.

Les appelants qui demandent de définir l’état du contexte PDP (Packet Data Protocol) de l’appareil Mo fournissent une structure NDIS_WWAN_SET_CONTEXT_STATE au pilote miniport avec les informations appropriées.

Notes

Pour plus d’informations sur l’utilisation de cet OID, consultez Gestion du contexte de paquet WWAN.

Cet objet active ou désactive un contexte de paquet particulier et lit l’état d’activation d’un contexte. Le pilote miniport doit envoyer des notifications d’événements appropriées chaque fois que l’état d’activation change.

Cet objet est appelé uniquement si le pilote miniport est dans un état de registre de WwanRegisterStateHome, WwanRegisterStatePartner ou WwanRegisterStateRoaming. Lorsque le service de paquets est actif, l’appareil doit également être dans un état d’attachement WwanPacketServiceStateAttached.

Les opérations de définition et de requête sont prises en charge pour cet objet.

• Le traitement d’une demande d’ensemble nécessite un accès réseau, mais pas un accès SIM.

• Le traitement d’une requête ne nécessite pas d’accès au réseau ou à la carte SIM.

La structure de données de cet OID est NDIS_WWAN_SET_CONTEXT_STATE. Le pilote miniport émet une indication status de NDIS_STATUS_WWAN_CONTEXT_STATE pour les requêtes définies et de requête.

Dans cette version du modèle de pilote, le pilote miniport tente d’activer le contexte uniquement comme indiqué par le service MB. (Les pilotes miniport peuvent activer un contexte initié par le réseau dans les versions ultérieures.) Les pilotes miniports ne doivent pas activer automatiquement un contexte même après avoir perdu l’inscription ou un signal. Si la chaîne d’accès n’est pas fournie dans la demande d’activation, un pilote miniport ne doit pas tenter de fournir une chaîne par défaut. Au lieu de cela, il doit continuer à activer le contexte avec une chaîne d’accès vide.

En revanche, le pilote miniport peut désactiver un contexte comme indiqué par le service Mo. Cela peut se produire lorsque la connectivité réseau a été perdue pendant une période qui dépasse le seuil de perte temporaire du signal, ou dans le cadre d’un arrêt ou d’un nettoyage d’état correct.

Étant donné qu’un seul contexte activé est pris en charge dans cette version, l’activation ou la désactivation d’un contexte particulier revient à configurer ou à détruire la connexion de couche 2 Mo.

Sur les demandes définies, le service Mo fournit à la fois les paramètres ConnectionId et ActivationCommand dans la structure de données WWAN_CONTEXT_STATE. Il indique au pilote miniport d’activer ou de désactiver un contexte de paquet identifié par ConnectionId, en fonction de la valeur du paramètre ActivationCommand WwanActivationCommandActivate ou WwanActivationCommandDeactivate.

• Si le service ou l’abonnement nécessite une activation, le pilote miniport doit retourner le code d’erreur WWAN_STATUS_SERVICE_NOT_ACTIVATED. L’activation PDP peut ne pas se produire tant que le service ou l’abonnement n’a pas été activé. Tous les services d’urgence peuvent être disponibles sous réserve de la prise en charge de l’appareil et de l’opérateur. Le système d’exploitation peut appeler le OID_WWAN_SERVICE_ACTIVATION en réponse à ce code d’erreur.

• Si le pilote miniport reçoit une demande d’activation de contexte alors qu’un autre contexte de paquet est actuellement activé, il retourne le code d’erreur WWAN_STATUS_MAX_ACTIVATED_CONTEXTS.

• Si le pilote miniport reçoit une demande de désactivation de contexte, mais que le contexte identifié par ConnectionId n’est pas activé, il retourne le code d’erreur WWAN_STATUS_CONTEXT_NOT_ACTIVATED.

Le pilote miniport utilise la logique suivante pour déterminer la validité des paramètres AccessString, UserName et Password à partir d’une demande définie :

• Si ActivationCommand est WwanActivationCommandDeactivate, le pilote miniport doit ignorer les paramètres de ces trois paramètres. Le reste des cas prend uniquement en compte le cas lorsque ActivationCommand est WwanActivationCommandActivate.

L’activation de contexte persiste dans l’ouverture de session et la déconnexion de l’utilisateur. Il n’est pas par utilisateur de connexion.

Sur les requêtes, le service MB utilise cet objet pour connaître l’état d’activation.

Pour répondre aux demandes de requête, le pilote miniport envoie la notification NDIS_STATUS_WWAN_CONTEXT_STATE.

Important Note:

Dans de rares circonstances, mais spécifiques, le service MB sur Windows 7 peut tenter de se connecter automatiquement avant que la connectivité à Internet ait été déterminée pour les connexions préexistantes ou lors d’une interruption momentanée de la connectivité Internet des connexions préexistantes. Cela peut entraîner des connexions Mo et WLAN/Ethernet simultanées. Par exemple, cela peut se produire pendant le démarrage du système lorsque Mo et d’autres connexions sont tentées simultanément et que le service Network List Manager tente toujours de déterminer la connectivité Internet d’autres connexions à l’aide de méthodes actives et passives. Cela peut également se produire en raison de pannes temporaires dans l’infrastructure réseau comme un serveur proxy d’entreprise ou un réseau isP. Par conséquent, le service MB peut tenter de se connecter automatiquement à Internet, que l’option « Connexion automatique uniquement si aucune autre connexion Internet n’est disponible » soit sélectionnée.

Spécifications

Version	Disponible dans Windows 7 et versions ultérieures de Windows.
En-tête	Ntddndis.h (inclure Ndis.h)

Voir aussi

Gestion du contexte des paquets WWAN