OID_WWAN_READY_INFO
OID_WWAN_READY_INFO retourne l’état prêt pour l’appareil, qui inclut son module d’identité de l’abonné (carte SIM). Cela se produit généralement au début d’une session.
Les demandes de définition ne sont pas prises en charge.
L’hôte peut interroger l’état prêt à partir de l’emplacement SIM actif ou de l’emplacement SIM inactif de l’appareil si l’appareil prend en charge les emplacements double SIM. La charge utile de cet OID contient une structure NDIS_WWAN_QUERY_READY_INFO , qui à son tour contient une structure WWAN_QUERY_READY_INFO qui spécifie l’ID d’emplacement UICC.
Les pilotes Miniport doivent traiter les demandes de requête de manière asynchrone, en retournant initialement NDIS_STATUS_INDICATION_REQUIRED à la requête d’origine, puis en envoyant une notification NDIS_STATUS_WWAN_READY_INFO status contenant une structure de NDIS_WWAN_READY_INFO qui indique l’état prêt de l’appareil Mo lors de l’exécution des demandes de requête.
Notes
Pour plus d’informations sur l’utilisation de cet OID, consultez Disponibilité de l’appareil mo.
Les pilotes Miniport peuvent accéder à la mémoire du périphérique ou à la carte SIM carte lors du traitement des opérations de requête, mais ne doivent pas accéder au réseau du fournisseur.
Les pilotes Miniport doivent attendre que le code confidentiel soit effacé (si nécessaire), puis lire l’identité et les numéros de téléphone (TN) de l’abonné, puis définir le membre ReadyInfo.ReadyState de la structure NDIS_WWAN_READY_INFO sur WwanReadyStateInitialized.
Les pilotes Miniport ne doivent jamais échouer OID_WWAN_READY_INFO et doivent toujours retourner le bon état prêt pour l’appareil.
Les pilotes miniport doivent toujours avertir le service Mo chaque fois que l’état prêt pour l’appareil change.
Les pilotes miniport doivent suivre ces étapes pour offrir une bonne expérience utilisateur :
Si PIN1 est verrouillé, les pilotes miniport doivent d’abord envoyer une notification d’événement ready-state avec ReadyInfo.ReadyState défini sur WwanReadyStateDeviceLocked. Le service MB envoie ensuite au pilote miniport une demande de jeu d’OID de OID_WWAN_PIN. Une fois l’appareil déverrouillé, le pilote miniport doit envoyer une autre notification d’événement ready-state avec ReadyInfo.ReadyState défini sur WwanReadyStateInitialized. Tant que PIN1 n’est pas correctement déverrouillé, les pilotes miniport ne doivent pas changer l’état prêt pour l’appareil en WwanReadyStateInitialized.
Les pilotes miniport doivent d’abord envoyer une notification d’événement avec ReadyInfo.ReadyState défini sur WwanReadyStateSimNotInserted lorsque le service MO charge le pilote miniport si aucune carte SIM n’est présente, comme cela peut être le cas avec les appareils qui permettent l’insertion ou la suppression de cartes SIM. Si l’appareil a la capacité de détecter une insertion à chaud d’un carte SIM, le pilote miniport doit envoyer une autre notification d’événement avec ReadyInfo.ReadyState défini sur WwanReadyStateInitialized lorsque l’utilisateur insère une carte SIM.
Les appareils qui ont la capacité de détecter l’état d’activation du service doivent définir ReadyInfo.ReadyState sur WwanReadyStateNotActivated. En outre, si le pilote miniport prend en charge l’activation du service, le pilote miniport reçoit une demande de jeu d’OID de OID_WWAN_SERVICE_ACTIVATION. Une fois l’activation du service terminée, les pilotes miniport doivent envoyer une autre notification d’événement avec ReadyInfo.ReadyState défini sur WwanReadyStateInitialized.
Les pilotes Miniport qui nécessitent une révision spécifique du microprogramme doivent s’assurer que la révision correcte du microprogramme est disponible. Si la révision du microprogramme n’est pas disponible, le pilote miniport doit terminer la transaction de notification d’événement en définissant ReadyInfo.ReadyState sur WwanReadyStateFailure.
Spécifications
Version : disponible dans Windows 7 et versions ultérieures de Windows.
En-tête : Ntddndis.h (inclure Ndis.h)