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 demandes définies et de requête, en retournant initialement NDIS_STATUS_INDICATION_REQUIRED à la demande d’origine, puis en envoyant ultérieurement une notification d’état NDIS_STATUS_WWAN_CONTEXT_STATE contenant une structure NDIS_WWAN_CONTEXT_STATE qui indique l’état de contexte PDP (Packet Data Protocol) de l’appareil Mo, quel que soit l’ensemble des demandes de requête.

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

Remarques

Pour plus d’informations sur l’utilisation de cet OID, consultez WWAN Packet Context Management.

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 d’enregistrement de WwanRegisterStateHome, WwanRegisterStatePartnerou WwanRegisterStateRoaming. Lorsque le service de paquets est actif, l’appareil doit également être dans un état d’attachement de WwanPacketServiceStateAttached.

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

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

• Le traitement d’une demande de 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 d’état de NDIS_STATUS_WWAN_CONTEXT_STATE pour les demandes définies et de requête.

Dans cette version du modèle de pilote, le pilote miniport tente l’activation du contexte uniquement comme indiqué par le service Mo. (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 tel qu’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 de signal, ou dans le cadre d’un arrêt ou d’un nettoyage d’état approprié.

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

Sur les demandes définies, le service Mb fournit à la fois des 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 de paramètre ActivationCommandWwanActivationCommandActivate ou WwanActivationCommandDeactivate.

• Si le service ou l’abonnement nécessite l’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’est pas 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 actuellement 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 ne tient compte que du 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 d’ouverture de session.

Sur les demandes de requête, le service Mo utilise cet objet pour déterminer l’état d’activation.

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

remarque importante :

Dans de rares circonstances, mais spécifiques, le service Mo 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 pendant une interruption momentanée de la connectivité Internet des connexions préexistantes. Cela peut entraîner des connexions WI/Ethernet simultanées. Par exemple, cela peut se produire pendant le démarrage du système lorsque des 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 Mo peut tenter de se connecter automatiquement à Internet, que l’option « Se connecter automatiquement uniquement si aucune autre connexion Internet n’est disponible » est sélectionnée.

Exigences

Voir aussi

gestion du contexte de paquet WWAN