OID_WWAN_SLOT_INFO

Article
06/15/2023

OID_WWAN_SLOT_INFO récupère un status agrégé de haut niveau d’un emplacement UICC spécifié et les carte qu’il contient (le cas échéant). Il peut également être utilisé pour envoyer une notification non sollicitée lorsque l’status de l’un des emplacements change.

Les pilotes miniport doivent traiter les requêtes de manière asynchrone, en retournant d’abord NDIS_STATUS_INDICATION_REQUIRED à la demande d’origine avant d’envoyer ultérieurement une notification NDIS_STATUS_WWAN_SLOT_INFO status contenant une structure de NDIS_WWAN_SLOT_INFO, qui à son tour contient une structure de WWAN_SLOT_INFO, pour fournir des informations sur la fonctionnalité globale du système modem.

Les requêtes spécifient NDIS_WWAN_GET_SLOT_INFO structure comme entrée. Le pilote miniport doit retourner l’emplacement status en fonction de l’ID d’emplacement spécifié dans le membre SlotIndex de la structure WWAN_GET_SLOT_INFO.

Le diagramme suivant illustre une demande de requête.

Diagramme montrant le processus d’une requête d’emplacement status.

Les requêtes définies ne sont pas applicables.

Une notification NDIS_STATUS_WWAN_SLOT_INFO avec une structure NDIS_WWAN_SLOT_INFO est envoyée à l’hôte lorsque l’état de l’emplacement/carte change.

Notes

L’hôte utilise OID_WWAN_SLOT_INFO pour interroger le status d’un emplacement spécifique sur le modem. Cet OID n’est pas spécifique à l’exécuteur et peut être envoyé à n’importe quel instance NDIS appartenant à un modem. L’état de l’emplacement représente un résumé de l’emplacement et de l’état carte.

L’ensemble d’états signalés est limité par la capacité du matériel d’emplacement. Dans le cas le plus restrictif, le matériel d’emplacement peut uniquement être en mesure de déterminer qu’un carte est présent lorsqu’il est sous tension et actif. Dans ce cas, les états OffEmpty et Off ne seront pas signalés.

OID_WWAN_READY_INFO et OID_WWAN_SLOT_INFO effectuent la même fonction principale de récupération de l’état prêt de l’appareil d’un emplacement d’carte SIM ; toutefois, OID_WWAN_READY_INFO est une commande par exécuteur alors que OID_WWAN_SLOT_INFO peut être utilisé sur n’importe quel instance physique (exécuteur) et est censé retourner l’état d’emplacement approprié même s’il n’est mappé à aucun exécuteur pour le moment.