struktur WWAN_REGISTRATION_STATE (wwan.h)
Struktur WWAN_REGISTRATION_STATE mewakili status pendaftaran perangkat MB.
Sintaks
typedef struct _WWAN_REGISTRATION_STATE {
ULONG uNwError;
WWAN_REGISTER_STATE RegisterState;
WWAN_REGISTER_MODE RegisterMode;
WCHAR ProviderId[WWAN_PROVIDERID_LEN];
WCHAR ProviderName[WWAN_PROVIDERNAME_LEN];
WCHAR RoamingText[WWAN_ROAMTEXT_LEN];
DWORD WwanRegFlags;
WWAN_CELLULAR_CLASS CurrentCellularClass;
ULONG PreferredDataClasses;
} WWAN_REGISTRATION_STATE, *PWWAN_REGISTRATION_STATE;
Anggota
uNwError
Kesalahan khusus jaringan, jika terjadi kegagalan pendaftaran. Untuk informasi selengkapnya tentang anggota ini, lihat bagian "Keterangan" berikut ini.
RegisterState
Status pendaftaran perangkat. Untuk daftar nilai yang ditentukan, lihat WWAN_REGISTER_STATE.
Nilai WwanRegisterStatePartner menunjukkan perangkat menjelajah pada penyedia jaringan mitra pilihan, sedangkan nilai WwanRegisterStateRoaming menunjukkan perangkat hanya menjelajah. Jika karakterisasi mitra dari status roaming tidak tersedia, driver miniport harus melaporkan WwanRegisterStateRoaming.
RegisterMode
Mode pendaftaran perangkat. Untuk daftar nilai yang ditentukan, lihat WWAN_REGISTER_MODE.
ProviderId[WWAN_PROVIDERID_LEN]
String numerik yang dihentikan NULL (0-9) yang mewakili identitas penyedia jaringan.
Untuk jaringan berbasis GSM, string ini adalah perangkaian Kode Negara Seluler (MCC) tiga digit dan Kode Jaringan Seluler (MNC) dua atau tiga digit. Operator berbasis GSM mungkin memiliki lebih dari satu MNC, dan karenanya lebih dari satu ProviderId .
Untuk jaringan berbasis CDMA, string ini adalah ID Sistem (SID) lima digit. Umumnya, operator berbasis CDMA memiliki lebih dari satu SID. Biasanya, operator memiliki satu SID untuk setiap pasar, yang biasanya dibagi secara geografis dalam suatu negara berdasarkan peraturan, seperti Metropolitan Statistical Areas (MSA) di Amerika Serikat Amerika. Driver miniport perangkat berbasis CDMA harus menentukan WWAN_CDMA_DEFAULT_PROVIDER_ID jika informasi ini tidak tersedia.
Saat memproses permintaan kueri , dan status pendaftaran dalam mode pendaftaran otomatis, anggota ini berisi ID penyedia yang saat ini dikaitkan dengan perangkat (jika berlaku). Ketika status pendaftaran dalam mode pendaftaran manual, anggota ini berisi ID penyedia tempat perangkat diminta untuk mendaftar (bahkan jika penyedia tidak tersedia).
Saat memproses permintaan yang ditetapkan dan status pendaftaran dalam mode manual, ini berisi ID penyedia yang dipilih oleh Layanan MB untuk didaftarkan perangkat. Ketika status pendaftaran dalam mode register otomatis, parameter ini diabaikan.
Penyedia CDMA 1xRTT harus diatur ke WWAN_CDMA_DEFAULT_PROVIDER_ID jika ID penyedia tidak tersedia.
ProviderName[WWAN_PROVIDERNAME_LEN]
String yang dihentikan NULL yang mewakili nama penyedia jaringan. Anggota ini terbatas pada, paling banyak, WWAN_PROVIDERNAME_LEN karakter.
Untuk jaringan berbasis GSM, jika Presentasi Pilihan Inisial Negara dan Nama Jaringan Seluler (PPCI&N) lebih panjang dari dua puluh karakter, driver miniport harus menghubungkan nama jaringan.
Anggota ini diabaikan ketika Layanan MB menetapkan daftar penyedia pilihan.
Driver Miniport harus menentukan string NULL untuk perangkat yang tidak memiliki informasi ini.
RoamingText[WWAN_ROAMTEXT_LEN]
String yang dihentikan NULL untuk memberi tahu pengguna bahwa perangkat menjelajah. Anggota ini terbatas pada paling banyak WWAN_ROAMTEXT_LEN karakter.
Teks ini harus memberikan informasi tambahan kepada pengguna ketika status pendaftaran adalah WwanRegisterStatePartner atau WwanRegisterStateRoaming. Anggota ini bersifat opsional.
WwanRegFlags
Bendera pendaftaran.
| Nilai | Makna |
|---|---|
| WWAN_REG_FLAGS_NONE | Tidak ada bendera pendaftaran. |
| WWAN_REG_FLAGS_NO_MANUAL_REG | Tidak ada lampiran manual. |
| WWAN_REG_FLAGS_PS_AUTO_ATTACH | Menunjukkan bahwa perangkat MB mengelola konteks paketnya sendiri. Layanan MB tidak akan mengirim pelampiran paket ke driver miniport, tetapi dapat mengirim lampiran paket. |
CurrentCellularClass
Kelas seluler saat ini dari jaringan terdaftar. Untuk jaringan yang hanya mendukung satu kelas seluler, anggota ini harus diatur ke kelas seluler tersebut. Untuk jaringan multi-mode yang mampu, driver miniport mengirimkan NDIS_STATUS_WWAN_REGISTER_STATE pemberitahuan ke layanan MB ketika jaringan mengubah kelas selulernya.
PreferredDataClasses
Bitmask yang mewakili teknologi akses data yang lebih disukai untuk koneksi.
Keterangan
Kueri dan atur permintaan OID serta peristiwa status yang tidak diminta menggunakan anggota uNwError . Jika tidak ada kesalahan khusus jaringan atau kesalahan spesifik jaringan tidak diketahui, driver miniport harus mengatur anggota ini ke nol. Bagian "Struktur Indikasi Status" di Semantik Operasional MB menunjukkan pendaftaran menyebabkan nilai kegagalan kode yang ditentukan dalam Spesifikasi 3GPP TS 24.008.
Poin-poin berikut memberikan panduan tentang mengembalikan kesalahan spesifik jaringan dalam skenario yang berbeda:
- Jika pendaftaran jaringan gagal karena kesalahan khusus jaringan, driver miniport harus mengembalikan kesalahan spesifik jaringan sebagai respons terhadap permintaan kueri . Dalam hal ini, driver miniport harus mengatur anggota uStatus dari struktur NDIS_WWAN_REGISTRATION_STATE ke WWAN_STATUS_SUCCESS dan mengatur anggota uNwError ke kode kesalahan khusus jaringan.
- Jika permintaan yang ditetapkan gagal, driver miniport harus mengembalikan kode kesalahan khusus jaringan. Dalam hal ini, driver miniport harus mengatur anggota uStatus dari struktur NDIS_WWAN_REGISTRATION_STATE ke WWAN_STATUS_FAILURE dan mengatur anggota uNwError ke kode kesalahan khusus jaringan.
- Setiap kali status pendaftaran perangkat berubah karena jaringan membatalkan pendaftaran perangkat (misalnya, jaringan membatalkan pendaftaran perangkat karena langganan perangkat kedaluwarsa) maka peristiwa status yang tidak diminta harus menyertakan kesalahan spesifik jaringan. Dalam hal ini, driver miniport harus mengatur anggota uStatus dari struktur NDIS_WWAN_REGISTRATION_STATE ke WWAN_STATUS_SUCCESS dan mengatur anggota uNwError ke kode kesalahan khusus jaringan.
Driver Miniport dapat memberikan kode kesalahan tambahan seperti yang didefinisikan oleh spesifikasi standar GSM dari kode kesalahan packet-attach yang dikembalikan oleh jaringan. Misalnya, driver miniport dapat mengkomunikasikan spesifikasi 3GPP kode kesalahan TS 24.008 packet-attach, seperti kode kesalahan 12 (Area lokasi tidak diizinkan), ke Layanan MB melalui anggota uNwError .
Driver Miniport harus melaporkan kode penyebab pada instans paling awal yang mungkin. Misalnya, jika perangkat MB menemukan salah satu kode ini saat mencoba mendaftarkan perangkat dengan penyedia jaringan, driver miniport harus melaporkannya pada saat itu.
Driver miniport yang terhubung ke jaringan multi-mode harus menunjukkan perubahan kelas seluler melalui pemberitahuan NDIS_STATUS_WWAN_REGISTER_STATE .
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Tersedia di Windows versi Windows 8 dan yang lebih baru. |
| Header | wwan.h (sertakan Wwan.h) |
Lihat juga
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk