Share via

OID_WWAN_SIGNAL_STATE

  • Artikel

OID_WWAN_SIGNAL_STATE mengembalikan atau mengatur status sinyal saat ini.

Driver Miniport harus memproses set dan permintaan kueri secara asinkron, awalnya mengembalikan NDIS_STATUS_INDICATION_REQUIRED ke permintaan asli, dan kemudian mengirim pemberitahuan status NDIS_STATUS_WWAN_SIGNAL_STATE yang berisi struktur NDIS_WWAN_SIGNAL_STATE untuk memberikan informasi tentang indikasi status sinyal saat ini yang ditunjukkan kepada pengguna akhir terlepas dari penyelesaian set atau permintaan kueri.

Penelepon yang meminta untuk mengatur indikasi status sinyal saat ini ke pengguna akhir memberikan struktur NDIS_WWAN_SET_SIGNAL_INDICATION ke driver miniport dengan informasi yang sesuai.

Keterangan

Untuk informasi selengkapnya tentang menggunakan OID ini, lihat Operasi Kekuatan Sinyal WWAN.

Driver Miniport tidak boleh mengakses jaringan penyedia, atau Modul Identitas Pelanggan (kartu SIM), saat memproses kueri atau mengatur operasi.

Umumnya, status sinyal harus ditunjukkan daripada dijajaki. Namun, OID ini tersedia jika status sinyal saat ini perlu ditentukan oleh Layanan MB.

Untuk respons terhadap permintaan kueri, driver miniport harus mengirim pemberitahuan NDIS_STATUS_WWAN_SIGNAL_STATE.

Pada permintaan yang ditetapkan dari Layanan MB, driver miniport harus:

  • Mengembalikan nilai saat ini untuk Rssi dan ErrorRate dalam struktur NDIS_WWAN_SIGNAL_STATE selain melaporkan nilai absolut untuk RssiInterval dan RssiThreshold yang telah diatur dalam driver miniport.

  • Cache nilai RssiInterval dan/atau RssiThreshold secara internal bahkan jika perangkat saat ini tidak terdaftar dengan operator apa pun dan bahwa pembatasan apa pun yang diberlakukan oleh perangkat dalam mengatur parameter hanya dapat menjadi status pasca-pendaftaran. Driver miniport harus mencoba menerapkan pengaturan ini dalam situasi segera yang tersedia berikutnya.

  • Selesaikan permintaan dengan sukses, jika status sakelar radio perangkat keras dan/atau perangkat lunak saat ini NONAKTIF. Driver Miniport menyimpan data permintaan dan mulai melaporkan kekuatan sinyal setelah sakelar diaktifkan.

  • Dapat mengalihkan permintaan ini dengan kumpulan kode kesalahan uStatus yang sesuai.

Driver Miniport dapat melakukan hal berikut saat memproses permintaan kueri dari Layanan MB:

  • Mengembalikan nilai saat ini untuk Rssi dan ErrorRate dalam struktur NDIS_WWAN_SIGNAL_STATE selain melaporkan nilai absolut untuk RssiInterval dan RssiThreshold yang telah diatur dalam driver miniport.

  • Gagalkan permintaan ini dengan kumpulan kode kesalahan uStatus yang sesuai.

Mengembalikan Nilai:

NDIS_STATUS_NOT_SUPPORTED

Driver Miniport dapat mengembalikan ini untuk perangkat tertentu yang mengetahui kemampuan perangkat yang tidak mendukung kekuatan sinyal dapat gagal permintaan dengan kode kesalahan ini.

Implementasi yang Direkomendasikan

  1. Perangkat harus mendukung indikasi kekuatan sinyal.

  2. Driver harus melaporkan indikasi kekuatan sinyal setidaknya 50% dari pengaturan RssiInterval selama periode waktu lima menit.

  3. Perangkat harus menghindari pelaporan kekuatan sinyal dalam status berikut:

    1. Perangkat tidak terdaftar atau dibatalkan pendaftarannya dan hanya berlaku untuk perangkat GSM.

    2. Status efektif radio NONAKTIF.

    3. Dalam status di atas, kueri ke kekuatan sinyal harus dikembalikan dengan data berikut oleh driver miniport:

      Rssi = WWAN_RSSI_UNKNOWN

      ErrorRate = WWAN_ERROR_RATE_UNKNOWN;

      RssiInterval = < nilai WWAN_RSSI_DISABLE, WWAN_RSSI_DEFAULT, atau set terakhir>

      RssiThreshold = < WWAN_RSSI_DISABLE, WWAN_RSSI_DEFAULT, atau nilai set terakhir>

Windows 10, versi 1903

Mulai Windows 10, versi 1903, OID_WWAN_SIGNAL_STATE telah ditingkatkan ke revisi 3. Revisi ini memungkinkan host untuk mengkueri nilai sinyal referensi baru yang diterima daya (RSRP) dan Signal-to-Noise (SNR) dari driver miniport. Driver miniport harus menggunakan revisi 3 OID ini dan struktur datanya jika driver mendukung 5G.

Untuk informasi selengkapnya tentang dukungan kelas data 5G, lihat dukungan kelas data MB 5G.

Persyaratan

Versi

Tersedia di Windows 7 dan versi Windows yang lebih baru.

Header

 Ntddndis.h (termasuk Ndis.h)

Lihat juga

NDIS_WWAN_SET_SIGNAL_INDICATION

Operasi Kekuatan Sinyal WWAN