structure WWAN_READY_INFO (wwan.h)
La structure WWAN_READY_INFO représente l’état prêt de l’appareil Mo.
Syntaxe
typedef struct _WWAN_READY_INFO {
WWAN_READY_STATE ReadyState;
WWAN_EMERGENCY_MODE EmergencyMode;
WCHAR SubscriberId[WWAN_SUBSCRIBERID_LEN];
WCHAR SimIccId[WWAN_SIMICCID_LEN];
BYTE CdmaShortMsgSize;
ULONG StatusFlags;
ULONG SlotId;
WWAN_LIST_HEADER TNListHeader;
} WWAN_READY_INFO, *PWWAN_READY_INFO;
Membres
ReadyState
État prêt de l’appareil.
EmergencyMode
Mode d’urgence de l’appareil. Pour plus d’informations, consultez WWAN_EMERGENCY_MODE.
SubscriberId[WWAN_SUBSCRIBERID_LEN]
Chaîne de chiffres terminée par NULL qui représente l’identité de l’abonné.
Pour les appareils GSM, ce membre représente la chaîne IMSI (International Mobile Subscriber Identity) (jusqu’à 15 chiffres).
Pour les appareils CDMA, cela représente la chaîne MIN (Mobile Identification Number) ou la chaîne IRM (International Roaming MIN) (à la fois 10 chiffres).
Les pilotes miniport doivent spécifier cette chaîne lorsque l’état prêt pour l’appareil passe à WwanReadyStateInitialized. Les pilotes miniport doivent également spécifier cette chaîne lorsque l’état prêt pour l’appareil passe à WwanReadyStateBadSim, WwanReadyStateFailureou WwanReadyStateDeviceLocked, si possible, à des fins d’identification.
Pour les fonctions multi-opérateurs monofacteur, le format SubscriberId GSM doit être utilisé. Cela ne s’applique pas aux fonctions multifacteur multifacteur, car le SubscriberId peut changer.
SimIccId[WWAN_SIMICCID_LEN]
Chaîne de chiffres terminée par NULL qui représente l’ID de carte de circuit international (ICC) du SIM. L’ID ICC varie entre 15 et 20 chiffres et est représenté en caractères alphanumériques. Les pilotes miniport doivent spécifier cette chaîne lorsque l’état prêt pour l’appareil passe à WwanReadyStateInitialized et également lorsque l’appareil est verrouillé, en attendant l’entrée de clés PIN1 et PUK1.
Les pilotes miniport doivent spécifier cette valeur pour tous les appareils où WwanCacheClass est égal à Wwan AllocateClassGsm. Les pilotes miniports des appareils CDMA doivent spécifier cette valeur pour les appareils où SimClass est égal à WwanSimClassSimRemovable.
CdmaShortMsgSize
Longueur du caractère SMS prise en charge par le réseau ou l’appareil, le cas échéant, si l’appareil est basé sur CDMA.
Les appareils CDMA qui prennent en charge SMS doivent spécifier leur longueur maximale de caractères SMS spécifique à l’opérateur pour être supérieure à WWAN_CDMA_SHORT_MSG_SIZE_UNKNOWN et inférieure à WWAN_CDMA_SHORT_MSG_SIZE_MAX.
Les appareils CDMA qui ne prennent pas en charge SMS doivent définir ce membre sur WWAN_CDMA_SHORT_MSG_SIZE_UNKNOWN.
Ce membre ne s’applique pas aux appareils GSM. Les pilotes miniports des appareils GSM doivent spécifier WWAN_CDMA_SHORT_MSG_SIZE_UNKNOWN.
StatusFlags
Indicateurs d’état SIM.
| Valeur | Signification |
|---|---|
| WWAN_READY_STATUS_MASK_IS_ESIM 0x00000001 | 0: le SIM actuel n’est pas un eSIM. 1: le SIM actuel est un eSIM. Valide uniquement lorsque ReadyState est MBIMSubscriberReadyStateInitialized ou MBIMSubscriberReadyStateNoEsimProfile. |
| WWAN_READY_STATUS_MASK_SIM_REMOVABILITY_KNOWN 0x00000002 | 0: la suppression sim est inconnue. 1: la suppression sim est connue. |
| WWAN_READY_STATUS_MASK_SIM_FORMFACTOR 0x00000004 | 0: la carte SIM actuelle est incorporée. 1: le SIM actuel est amovible. Valide uniquement lorsque ReadyState est MBIMSubscriberReadyStateInitialized, MBIMSubscriberReadyStateNoEsimProfile ou MBIMSubscriberReadyStateDeviceLocked. |
| WWAN_READY_STATUS_MASK_SIM_SLOT_ACTIVE 0x00000008 | 0: l’indication provient de l’emplacement actuellement inactif. 1: l’indication provient de l’emplacement actuellement actif. Ce bit peut être défini indépendamment du bit WWAN_READY_STATUS_MASK_MASKS_IS_VALID. |
| WWAN_READY_STATUS_MASK_MASKS_IS_VALID 0x80000000 | Indique si d’autres bits d’état (à l’exception de WWAN_READY_STATUS_MASK_SIM_SLOT_ACTIVE) ne sont pas valides. Si le bit est 0, les autres bits ne sont pas valides et doivent être ignorés. Si le bit est 1, d’autres bits d’état sont valides. |
SlotId
Valeur ULONG qui spécifie l’ID d’emplacement de carte SIM.
TNListHeader
Liste des numéros de téléphone (TN) attribués à l’identité de l’abonné.
Chaque élément de la liste est une chaîne de WCHAR, avec une taille fixe de WWAN_TN_LEN.
Chaque TN stocké dans un élément de liste est une valeur terminée par NULL.
Dans les appareils GSM, les TN sont appelés numéro ISDN de la station mobile (MSISDN). Dans les appareils CDMA, ils sont appelés numéros d’annuaire mobile (MDN).
Les pilotes miniport ne doivent pas spécifier cette valeur tant que l’état prêt pour l’appareil n’est pas modifié pour WwanReadyStateInitialized.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible dans Windows 7 et versions ultérieures de Windows. |
| d’en-tête | wwan.h (include Wwan.h) |