structure WWAN_READY_INFO (wwan.h)

Article
03/05/2024

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 null de chiffres 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 Numéro d’identification mobile (MIN) ou la chaîne IRM (International Roaming MIN) (10 chiffres).

Les pilotes miniport doivent spécifier cette chaîne lorsque l’état prêt de l’appareil devient WwanReadyStateInitialized. Les pilotes miniport doivent également spécifier cette chaîne lorsque l’état prêt de l’appareil devient WwanReadyStateBadSim, WwanReadyStateFailure ou WwanReadyStateDeviceLocked, si possible, à des fins d’identification.

Pour les fonctions multimodes monofacteur, le format GSM SubscriberId doit être utilisé. Cela ne s’applique pas aux fonctions multimode multifacteur, car l’SubscriberId peut changer.

SimIccId[WWAN_SIMICCID_LEN]

Chaîne null de chiffres qui représente l’ID de carte de circuit international (ICC) de la carte 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 de l’appareil passe à WwanReadyStateInitialized et également lorsque l’appareil est verrouillé, en attendant l’entrée des clés PIN1 et PUK1.

Les pilotes miniport doivent spécifier cette valeur pour tous les appareils où WwanCellularClass est égal à WwanCellularClassGsm. Les pilotes miniport des appareils CDMA doivent spécifier cette valeur pour les appareils où SimClass est égal à WwanSimClassSimRemovable.

CdmaShortMsgSize

Longueur de caractères SMS prise en charge par le réseau ou l’appareil, selon la valeur la moins importante, si l’appareil est basé sur CDMA.

Les appareils CDMA qui prennent en charge les SMS doivent spécifier leur longueur maximale de caractères SMS spécifique à l’opérateur pour qu’elle soit 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 miniport des appareils GSM doivent spécifier WWAN_CDMA_SHORT_MSG_SIZE_UNKNOWN.

StatusFlags

Indicateurs de status SIM.

Valeur	Signification
WWAN_READY_STATUS_MASK_IS_ESIM 0x00000001	0 : la carte SIM actuelle n’est pas une eSIM. 1 : La carte SIM actuelle est une eSIM. Valide uniquement lorsque le ReadyState est MBIMSubscriberReadyStateInitialized ou MBIMSubscriberReadyStateNoEsimProfile.
WWAN_READY_STATUS_MASK_SIM_REMOVABILITY_KNOWN 0x00000002	0 : la suppression de la carte SIM est inconnue. 1 : la suppression de la carte SIM est connue.
WWAN_READY_STATUS_MASK_SIM_FORMFACTOR 0x00000004	0 : la carte SIM actuelle est incorporée. 1 : La carte SIM actuelle est amovible. Valide uniquement lorsque le 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 WWAN_READY_STATUS_MASK_MASKS_IS_VALID bit.
WWAN_READY_STATUS_MASK_MASKS_IS_VALID 0x80000000	Indique si les autres bits status (à l’exception des 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, les autres bits status sont valides.

SlotId

Valeur ULONG qui spécifie l’ID d’emplacement sim carte.

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 NULL terminée.

Dans les appareils GSM, les TN sont appelés numéro ISDN de 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 de l’appareil n’est pas modifié en WwanReadyStateInitialized.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows 7 et versions ultérieures de Windows.
En-tête	wwan.h (inclure Wwan.h)

Voir aussi