WWAN_READY_INFO struttura (wwan.h)
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) |