WWAN_READY_INFO struttura (wwan.h)

Articolo
08/08/2023

La struttura WWAN_READY_INFO rappresenta lo stato pronto del dispositivo MB.

Sintassi

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;

Members

ReadyState

Stato pronto del dispositivo.

EmergencyMode

Modalità di emergenza del dispositivo. Per altre informazioni, vedere WWAN_EMERGENCY_MODE.

SubscriberId[WWAN_SUBSCRIBERID_LEN]

Stringa con terminazione NULL di cifre che rappresenta l'identità del sottoscrittore.

Per i dispositivi basati su GSM, questo membro rappresenta la stringa International Mobile Subscriber Identity (IMSI) (fino a 15 cifre di lunghezza).

Per i dispositivi basati su CDMA, questo rappresenta la stringa Mobile Identification Number (MIN) o la stringa International Roaming MIN (IRM) (entrambe le 10 cifre in lunghezza).

I driver Miniport devono specificare questa stringa quando lo stato pronto per il dispositivo viene modificato in WwanReadyStateInitialized. I driver Miniport devono specificare anche questa stringa quando lo stato pronto per il dispositivo viene modificato in WwanReadyStateBadSim, WwanReadyStateFailure o WwanReadyStateDeviceLocked, se possibile, a scopo di identificazione.

Per le funzioni multi-vettore singolo, è necessario usare il formato Gsm SubscriberId . Ciò non si applica alle funzioni multi-carrier multi-mode perché il SottoscrittoreId può cambiare.

SimIccId[WWAN_SIMICCID_LEN]

Stringa con terminazione NULL di cifre che rappresenta l'ID della scheda circuito internazionale (ICC) della SIM. L'ID ICC varia da 15 a 20 cifre in lunghezza e viene rappresentato in caratteri alfanumerici. I driver Miniport devono specificare questa stringa quando lo stato pronto per il dispositivo viene modificato in WwanReadyStateInitialized e anche quando il dispositivo è bloccato, in attesa di immissione di chiavi PIN1 e PUK1.

I driver Miniport devono specificare questo valore per tutti i dispositivi in cui WwanCellularClass è uguale a WwanCellularClassGsm. I driver miniport dei dispositivi basati su CDMA devono specificare questo valore per i dispositivi in cui SimClass è uguale a WwanSimClassSimRemovable.

CdmaShortMsgSize

Lunghezza del carattere SMS supportata dalla rete o dal dispositivo, che tuttavia è minore, se il dispositivo è basato su CDMA.

I dispositivi basati su CDMA che supportano SMS devono specificare la lunghezza massima massima specifica del gestore SMS per essere maggiore di WWAN_CDMA_SHORT_MSG_SIZE_UNKNOWN e minore di WWAN_CDMA_SHORT_MSG_SIZE_MAX.

I dispositivi basati su CDMA che non supportano SMS devono impostare questo membro su WWAN_CDMA_SHORT_MSG_SIZE_UNKNOWN.

Questo membro non si applica ai dispositivi basati su GSM. I driver miniport dei dispositivi basati su GSM devono specificare WWAN_CDMA_SHORT_MSG_SIZE_UNKNOWN.

StatusFlags

Flag di stato SIM.

Valore	Significato
WWAN_READY_STATUS_MASK_IS_ESIM 0x00000001	0: la SIM corrente non è un'eSIM. 1: la SIM corrente è un'eSIM. Valido solo quando ReadyState è MBIMSubscriberReadyStateInitialized o MBIMSubscriberReadyStateNoEsimProfile.
WWAN_READY_STATUS_MASK_SIM_REMOVABILITY_KNOWN 0x00000002	0: la removbilità della SIM è sconosciuta. 1: la removbilità sim è nota.
WWAN_READY_STATUS_MASK_SIM_FORMFACTOR 0x00000004	0: la SIM corrente è incorporata. 1: la SIM corrente è rimovibile. Valido solo quando ReadyState è MBIMSubscriberReadyStateInitialized, MBIMSubscriberReadyStateNoEsimProfile o MBIMSubscriberReadyStateDeviceLocked.
WWAN_READY_STATUS_MASK_SIM_SLOT_ACTIVE 0x00000008	0: l'indicazione proviene dallo slot attualmente inattivo. 1: l'indicazione proviene dallo slot attualmente attivo. Questo bit può essere impostato indipendentemente dal bit di WWAN_READY_STATUS_MASK_MASKS_IS_VALID.
WWAN_READY_STATUS_MASK_MASKS_IS_VALID 0x80000000	Indica se altri bit di stato (ad eccezione di WWAN_READY_STATUS_MASK_SIM_SLOT_ACTIVE) non sono validi. Se il bit è 0, gli altri bit non sono validi e devono essere ignorati. Se il bit è 1, gli altri bit di stato sono validi.

SlotId

Valore ULONG che specifica l'ID dello slot della scheda SIM.

TNListHeader

Elenco di numeri di telefono (TN) assegnati all'identità del sottoscrittore.

Ogni elemento nell'elenco è una stringa di WCHAR, con dimensioni fisse di WWAN_TN_LEN.

Ogni TN archiviato in un elemento elenco è un valore con terminazione NULL.

Nei dispositivi basati su GSM vengono chiamati numero ISDN (MSISDN) della stazione mobile. Nei dispositivi basati su CDMA sono denominati numeri di directory mobile (MDN).

I driver Miniport non devono specificare questo valore finché lo stato pronto per il dispositivo non viene modificato in WwanReadyStateInitialized.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows 7 e versioni successive di Windows.
Intestazione	wwan.h (include Wwan.h)

Vedi anche