struktur WWAN_READY_INFO (wwan.h)
Struktur WWAN_READY_INFO mewakili status siap perangkat MB.
Sintaks
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;
Anggota
ReadyState
Status siap perangkat.
EmergencyMode
Mode darurat perangkat. Untuk informasi selengkapnya, lihat WWAN_EMERGENCY_MODE.
SubscriberId[WWAN_SUBSCRIBERID_LEN]
String digit yang dihentikan NULL yang mewakili identitas pelanggan.
Untuk perangkat berbasis GSM, anggota ini mewakili string International Mobile Subscriber Identity (IMSI) (panjangnya hingga 15 digit).
Untuk perangkat berbasis CDMA, ini mewakili string Nomor Identifikasi Seluler (MIN) atau string INTERNATIONAL Roaming MIN (IRM) (panjang keduanya 10 digit).
Driver Miniport harus menentukan string ini ketika status siap perangkat berubah menjadi WwanReadyStateInitialized. Driver Miniport juga harus menentukan string ini ketika status siap perangkat berubah menjadi WwanReadyStateBadSim, WwanReadyStateFailure, atau WwanReadyStateDeviceLocked, jika memungkinkan, untuk tujuan identifikasi.
Untuk fungsi multi-mode operator tunggal, format GSM SubscriberId harus digunakan. Ini tidak berlaku untuk fungsi multi-mode multi-operator karena SubscriberId dapat berubah.
SimIccId[WWAN_SIMICCID_LEN]
String digit yang dihentikan NULL yang mewakili ID International Circuit Card (ICC) SIM. ID ICC bervariasi dari antara 15 hingga 20 digit dan diwakili dalam karakter alfanumerik. Driver Miniport harus menentukan string ini ketika status siap perangkat berubah menjadi WwanReadyStateInitialized dan juga ketika perangkat dikunci, menunggu entri kunci PIN1 dan PUK1.
Driver Miniport harus menentukan nilai ini untuk semua perangkat di mana WwanCellularClass sama dengan WwanCellularClassGsm. Driver miniport perangkat berbasis CDMA harus menentukan nilai ini untuk perangkat di mana SimClass sama dengan WwanSimClassSimRemovable.
CdmaShortMsgSize
Panjang karakter SMS yang didukung oleh jaringan atau perangkat, mana pun yang kurang, jika perangkat berbasis CDMA.
Perangkat berbasis CDMA yang mendukung SMS harus menentukan panjang karakter SMS maksimum khusus operator mereka agar lebih besar dari WWAN_CDMA_SHORT_MSG_SIZE_UNKNOWN dan kurang dari WWAN_CDMA_SHORT_MSG_SIZE_MAX.
Perangkat berbasis CDMA yang tidak mendukung SMS harus mengatur anggota ini ke WWAN_CDMA_SHORT_MSG_SIZE_UNKNOWN.
Anggota ini tidak berlaku untuk perangkat berbasis GSM. Driver miniport perangkat berbasis GSM harus menentukan WWAN_CDMA_SHORT_MSG_SIZE_UNKNOWN.
StatusFlags
Bendera status SIM.
| Nilai | Makna |
|---|---|
| WWAN_READY_STATUS_MASK_IS_ESIM 0x00000001 | 0: SIM saat ini bukan eSIM. 1: SIM saat ini adalah eSIM. Hanya berlaku saat ReadyState adalah MBIMSubscriberReadyStateInitialized atau MBIMSubscriberReadyStateNoEsimProfile. |
| WWAN_READY_STATUS_MASK_SIM_REMOVABILITY_KNOWN 0x00000002 | 0: Penghapusan SIM tidak diketahui. 1: Penghapusan SIM diketahui. |
| WWAN_READY_STATUS_MASK_SIM_FORMFACTOR 0x00000004 | 0: SIM saat ini disematkan. 1: SIM saat ini dapat dilepas. Hanya berlaku saat ReadyState adalah MBIMSubscriberReadyStateInitialized, MBIMSubscriberReadyStateNoEsimProfile, atau MBIMSubscriberReadyStateDeviceLocked. |
| WWAN_READY_STATUS_MASK_SIM_SLOT_ACTIVE 0x00000008 | 0: Indikasi berasal dari slot yang saat ini tidak aktif. 1: Indikasi berasal dari slot yang saat ini aktif. Bit ini dapat diatur independen dari bit WWAN_READY_STATUS_MASK_MASKS_IS_VALID. |
| WWAN_READY_STATUS_MASK_MASKS_IS_VALID 0x80000000 | Menunjukkan apakah bit status lainnya (kecuali WWAN_READY_STATUS_MASK_SIM_SLOT_ACTIVE) tidak valid. Jika bit adalah 0, bit lain tidak valid dan harus diabaikan. Jika bit adalah 1, bit status lainnya valid. |
SlotId
Nilai ULONG yang menentukan ID slot kartu SIM.
TNListHeader
Daftar nomor telepon (TN) yang ditetapkan ke identitas pelanggan.
Setiap elemen dalam daftar adalah string WCHAR, dengan ukuran tetap WWAN_TN_LEN.
Setiap TN yang disimpan dalam elemen daftar adalah nilai yang dihentikan NULL.
Dalam perangkat berbasis GSM, TN disebut Nomor ISDN (MSISDN) Stasiun Seluler. Di perangkat berbasis CDMA, mereka disebut Nomor Direktori Seluler (MDN).
Driver Miniport tidak boleh menentukan nilai ini sampai status siap perangkat berubah menjadi WwanReadyStateInitialized.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Tersedia di Windows 7 dan versi Windows yang lebih baru. |
| Header | wwan.h (sertakan Wwan.h) |