struttura WWAN_READY_INFO_REV2_PRE2170 (wwan.h)

  • Articolo

La struttura WWAN_READY_INFO_REV2_PRE2170 è la versione precedente della struttura WWAN_READY_INFO, precedente alla Windows 11.

Sintassi

typedef struct _WWAN_READY_INFO_REV2_PRE2170 {
  WWAN_READY_STATE    ReadyState;
  WWAN_EMERGENCY_MODE EmergencyMode;
  WCHAR               SubscriberId[WWAN_SUBSCRIBERID_LEN];
  WCHAR               SimIccId[WWAN_SIMICCID_LEN];
  BYTE                CdmaShortMsgSize;
  ULONG               StatusFlags;
  WWAN_LIST_HEADER    TNListHeader;
} WWAN_READY_INFO_REV2_PRE2170, *PWWAN_READY_INFO_PRE2170;

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, rappresenta la stringa MIN (Mobile Identification Number) o la stringa International Roaming MIN (IRM) (entrambe 10 cifre di 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 cambia in WwanReadyStateBadSim, WwanReadyStateFailure o WwanReadyStateDeviceLocked, se possibile, a scopo di identificazione.

Per le funzioni a più vettori singoli, è necessario usare il formato SubscriberId GSM. Ciò non si applica alle funzioni multi-carrier multi-mode perché l'Id Sottoscrittore può cambiare.

SimIccId[WWAN_SIMICCID_LEN]

Stringa con terminazione NULL di cifre che rappresenta l'ID della scheda circuito internazionale (CPI) della SIM. L'ID CPI varia da 15 a 20 cifre di lunghezza ed è 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, a seconda di quale sia minore, se il dispositivo è basato su CDMA.

I dispositivi basati su CDMA che supportano SMS devono specificare la lunghezza massima massima del carattere SMS specifica del gestore telefonico 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à 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 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.

TNListHeader

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

Ogni elemento nell'elenco è una stringa di WCHAR, con una dimensione fissa di WWAN_TN_LEN.

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

Nei dispositivi basati su GSM i nomi TN sono denominati numero ISDN della stazione mobile (MSISDN). Nei dispositivi basati su CDMA sono denominati numeri di directory mobili (MDN).

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

Requisiti

Requisito Valore
Intestazione wwan.h

Vedi anche

WWAN_READY_INFO