Metode IMbnSignal::GetSignalStrength (mbnapi.h)

Penting

Mulai dari Windows 10, versi 1803, API Win32 yang dijelaskan di bagian ini digantikan oleh WINDOWS Runtime API di namespace Windows.Networking.Connectivity.

Mendapatkan kekuatan sinyal yang diterima oleh perangkat.

Sintaks

HRESULT GetSignalStrength(
  [out, retval] ULONG *signalStrength
);

Parameter

[out, retval] signalStrength

Arahkan ke kualitas sinyal yang diterima oleh perangkat. Ketika kekuatan sinyal tidak diketahui atau tidak dapat dideteksi oleh perangkat maka ini diatur ke MBN_RSSI_UNKNOWN. Jika metode ini mengembalikan nilai apa pun selain S_OK, parameter ini adalah 0.

Menampilkan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil diselesaikan.
E_PENDING	Kualitas sinyal tidak tersedia. Layanan Broadband Seluler saat ini sedang memeriksa perangkat untuk mengambil informasi ini. Ketika kualitas sinyal tersedia, layanan Mobile Broadband akan memanggil metode OnSignalStateChange dari IMbnSignalEvents.

Keterangan

GetSignalStrength melaporkan kekuatan sinyal yang diterima oleh perangkat Mobile Broadband. Untuk perangkat berbasis GSM, ia melaporkan kekuatan sinyal sebagai kekuatan sinyal yang diterima dalam nilai yang dikodekan. Untuk perangkat CDMA, ia melaporkan berdasarkan RSSI Kompensasi (akun kebisingan) dan tidak berdasarkan Raw RSSI.

Tabel berikut berisi nilai berkode yang mungkin dikembalikan.

Kekuatan Sinyal (dalam dBm)	Nilai Berkode (Min: 0 Maks: 31)
-113 atau kurang	0
-111	1
-109	2
...	...
...	...
-51 atau lebih besar	31
Tidak diketahui atau tidak terdeteksi	MBN_RSSI_UNKNOWN

 

Untuk kesalahan yang dapat dipulihkan E_MBN_PIN_REQUIRED, dan E_MBN_RADIO_POWER_OFF, layanan Broadband Seluler akan meminta perangkat lagi untuk status sinyal ketika kondisi kesalahan berakhir. Metode ini akan mengembalikan E_PENDING hingga operasi kueri selesai. Ketika kueri baru selesai, layanan Mobile Broadband akan memanggil metode OnSignalStateChange dari IMbnSignalEvents.

Persyaratan

Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Tidak ada yang didukung
Target Platform	Windows
Header	mbnapi.h

Lihat juga

IMbnSignal