Bagikan melalui

NDIS_STATUS_WWAN_REGISTER_STATE

  • Artikel

Driver Miniport menggunakan pemberitahuan NDIS_STATUS_WWAN_REGISTER_STATE untuk mengkomunikasikan perubahan pada status pendaftaran perangkat MB ke Layanan MB.

Driver Miniport juga dapat mengirim peristiwa yang tidak diminta dengan pemberitahuan ini.

Pemberitahuan ini menggunakan struktur NDIS_WWAN_REGISTRATION_STATE .

Keterangan

Saat status pendaftaran perangkat berubah, driver miniport harus mengirim indikasi yang sesuai sehingga Layanan MB dapat mencerminkan status yang benar kepada pengguna.

Perubahan status pendaftaran karena sejumlah alasan. Ini dapat langsung dihasilkan dari permintaan yang ditetapkan dari Layanan MB untuk OID_WWAN_REGISTER_STATE seperti transisi status sementara dari WwanRegisterStateSearching ke WwanRegisterStateHome. Ini juga dapat dihasilkan dari operasi otomatis oleh driver miniport dalam kasus pemilihan penyedia otomatis. Akhirnya, ini mungkin disebabkan oleh perubahan ketersediaan jaringan, misalnya, kehilangan cakupan jaringan dapat mengakibatkan transisi dari WwanRegisterStateHome ke WwanRegisterStateDeregistered.

Kecuali untuk perubahan yang disebabkan oleh permintaan OID_WWAN_REGISTER_STATE Layanan MB, driver miniport harus memberi tahu Layanan MB setiap kali status pendaftaran berubah terlepas dari penyebab yang mendasar.

Perangkat CDMA tidak mendukung pendaftaran dan deregistrasi yang dimulai Layanan MB. Namun, pemberitahuan perubahan status register yang dimulai perangkat berdasarkan ketersediaan atau non-ketersediaan jaringan operator harus dikirim ke Layanan MB. Perangkat CDMA harus melakukan pendaftaran otomatis.

Untuk perangkat yang melakukan pendaftaran otomatis pada power-up, terlepas dari mode pendaftaran saat ini--otomatis atau manual, driver miniport harus mengirim pemberitahuan status register pada pendaftaran yang berhasil.

Untuk pendaftaran manual, Layanan MB hanya akan memulai pendaftaran setelah driver miniport menunjukkan bahwa ReadyState adalah WwanReadyStateInitialized.

Driver Miniport harus menggunakan panduan berikut saat menanggapi permintaan yang ditetapkan :

  • Driver tidak boleh merespons dengan status sementara untuk permintaan yang ditetapkan . Status sementara untuk pendaftaran adalah WwanRegisterStateSearching.

  • Ketika RegisterAction diatur ke WwanRegisterActionManual, jika penyedia tidak terlihat ketika driver miniport menerima permintaan, driver miniport akan mengembalikan kode kesalahan WWAN_STATUS_PROVIDER_NOT_VISIBLE. Perangkat tidak boleh beralih ke pendaftaran otomatis karena kegagalan dalam mengatur mode manual. Jika perangkat sebelumnya diatur untuk mendaftar secara manual ke jaringan lain, permintaan ini harus mengubah perangkat untuk mendaftar ke jaringan yang ditentukan dalam permintaan. Nilai RegisterState sebagai respons terhadap permintaan harus diatur ke WwanRegisterStateDeregistered.

  • Ketika RegisterAction diatur ke WwanRegisterActionManual, jika driver miniport telah terdaftar dengan jaringan yang sama yang telah diminta, itu akan merespons dengan WWAN_STATUS_SUCCESS.

  • Driver harus mencoba mendaftar ke kelas data yang diminta dalam permintaan OID_WWAN_REGISTER yang ditetapkan. Jika driver miniport tidak dapat mendaftar ke kelas data yang diminta, driver tersebut harus mendaftar ke kelas data terbaik. Ini juga berlaku ketika perangkat sudah terdaftar ke penyedia (mode pendaftaran otomatis dan manual) dengan beberapa kelas data lainnya. Setiap perubahan di kelas data juga harus mengakibatkan pemberitahuan NDIS_STATUS_WWAN_PACKET_SERVICE.

  • Ketika RegisterAction diatur ke WwanRegisterActionManual, dan Radio NONAKTIF, driver miniport harus memprogram perangkat ke mode pendaftaran manual dan menyelesaikan permintaan dengan pemberitahuan transaksi. RegisterState harus diatur ke WwanRegisterStateDeregistered. Perangkat harus mencoba pendaftaran manual ketika Radio berubah menjadi status ON dan pemberitahuan peristiwa harus dikirim.

  • Ketika RegisterAction diatur ke WwanRegisterActionAutomatic, dan Radio NONAKTIF, driver miniport harus memprogram perangkat ke mode pendaftaran otomatis dan harus menyelesaikan permintaan dengan pemberitahuan transaksi. RegisterState harus diatur ke WwanRegisterStateDeregistered. Perangkat harus melakukan pendaftaran otomatis ketika Radio masuk ke status ON dan pemberitahuan peristiwa harus dikirim.

  • Dalam kasus pendaftaran status darurat ( WwanRegisterStateDenied), uStatus harus diatur ke WWAN_STATUS_SUCCESS dan pemberitahuan NDIS_STATUS_WWAN_READY_INFO harus dikirim dengan EmergencyMode diatur ke WwanEmergencyModeOn.

  • Untuk menggunakan status WwanRegisterStateDeregistered , driver miniport harus menggunakan panduan berikut:

    • WwanRegisterStateDeregistered digunakan oleh driver miniport untuk memberi tahu Layanan MB bahwa Radio NONAKTIF tetapi permintaan RegisterAction selesai.

    • WwanRegisterStateDeregistered digunakan oleh driver miniport untuk memberi tahu Layanan MB tentang deregistrasi yang dimulai jaringan.

    • WwanRegisterStateDeregistered digunakan oleh driver miniport untuk memberi tahu Layanan MB tentang konektivitas yang hilang ke jaringan karena tidak ada cakupan jaringan.

  • Perangkat GSM dan CDMA harus mengirim pemberitahuan status register untuk memberi tahu ketersediaan atau tidak tersedianya operator untuk koneksi PS. Ketika perangkat MB mendeteksi ketersediaan jaringan operator, perangkat harus mengirim pemberitahuan peristiwa dengan salah satu status register yang sesuai-- WwanRegisterStateHome, WwanRegisterStateRoaming, atau WwanRegisterStatePartner. Saat kehilangan sinyal jaringan operator, pemberitahuan peristiwa dengan WwanRegisterStateDeregistered harus ditunjukkan ke Layanan MB.

Driver miniport mengembalikan hasil kueri sesuai dengan aturan berikut:

  • Ketika perangkat mencoba mengunci ke penyedia selama pendaftaran, driver miniport akan mengatur RegisterState sebagai WwanRegisterStateSearching. Anggota ProviderName dan RoamingText harus diatur ke NULL. Dalam kasus mode register Manual, ProviderId harus diisi dengan ProviderId dari permintaan set pendaftaran manual terakhir. ProviderId dapat diatur ke NULL jika ada mode register otomatis.

  • Ini adalah keadaan sementara karena driver miniport pada akhirnya akan pindah ke keadaan stabil pada akhir pendaftaran, misalnya, WwanRegisterStateHome, WwanRegisterStatePartner, atau WwanRegisterStateRoaming untuk pendaftaran yang berhasil; atau WwanRegisterStateDenied untuk pendaftaran status darurat.

  • Jika perangkat tidak terdaftar di penyedia apa pun, driver miniport akan mengembalikan WwanRegisterStateDeregistered. Anggota ProviderName dan RoamingText harus diatur ke NULL. Dalam kasus mode register Manual, ProviderId harus diisi dengan ProviderId dari permintaan set pendaftaran manual terakhir. ProviderId dapat diatur ke NULL jika ada mode register otomatis.

  • Jika perangkat terdaftar di penyedia rumah, driver miniport akan menetapkan RegisterState sebagai WwanRegisterStateHome. Anggota ProviderId akan diatur ke ID penyedia rumah. ProviderName harus diatur ke nama jaringan penyedia rumah. Anggota RoamingText harus diatur ke NULL.

  • Jika perangkat terdaftar dengan penyedia roaming, driver miniport harus menetapkan RegisterState sebagai WwanRegisterStatePartner jika penyedia adalah mitra roaming pilihan atau hanya WwanRegisterStateRoaming untuk mitra roaming, masing-masing. Jika driver miniport tidak membedakan keduanya, itu akan menetapkan nilai ke WwanRegisterStateRoaming. Anggota ProviderId harus diatur ke ID penyedia penyedia saat ini yang terdaftar dengan perangkat dan ProviderName harus diisi dengan nama penyedia terdaftar saat ini. Anggota RoamingText harus diatur ke beberapa nilai string tertentu penyedia jika ada atau ke NULL sebaliknya.

Persyaratan

Versi

Tersedia di Windows 7 dan versi Windows yang lebih baru.

Header

 Ndis.h

Lihat juga

NDIS_WWAN_REGISTRATION_STATE

OID_WWAN_REGISTER_STATE