struktur WWAN_SIGNAL_STATE (wwan.h)

Artikel
08/08/2023

Struktur WWAN_SIGNAL_STATE mewakili status sinyal perangkat MB.

Sintaks

typedef struct _WWAN_SIGNAL_STATE {
  ULONG            Rssi;
  ULONG            ErrorRate;
  ULONG            RssiInterval;
  ULONG            RssiThreshold;
  WWAN_LIST_HEADER SignalStateListHeader;
} WWAN_SIGNAL_STATE, *PWWAN_SIGNAL_STATE;

Anggota

Rssi

Nilai yang mewakili kekuatan sinyal nirkabel. Driver miniport yang melaporkan WWAN_CELLULAR_CLASS mereka menjadi WwanCellularClassGSM atau WwanCellularClassCDMA harus melaporkan Rssi dalam desibel di atas lantai kebisingan sensitivitas perangkat.

Kekuatan Sinyal (dalam dBm)	Nilai Berkode (Minimum=0, Maksimum=31)
-113 atau kurang	0
-111	1
-109	2
...	...
-51 atau lebih besar	31
Tidak diketahui atau tidak terdeteksi	WWAN_RSSI_UNKNOWN

Perangkat berbasis CDMA harus melaporkan kekuatan sinyal berdasarkan RSSI yang dikompensasi (akun kebisingan) dan tidak berdasarkan RSSI mentah.

ErrorRate

Nilai berkode yang mewakili rentang persentase tingkat kesalahan. Untuk perangkat berbasis GSM, gunakan nilai dari kolom Tingkat kesalahan bit saluran dalam tabel berikut. Untuk perangkat berbasis CDMA, gunakan nilai dari kolom Tingkat kesalahan bingkai. Untuk kedua kasus, gunakan WWAN_ERROR_RATE_UNKNOWN untuk menunjukkan tingkat kesalahan yang tidak diketahui.

Tingkat kesalahan bit saluran (dalam %)	Tingkat kesalahan bingkai (dalam %)	Nilai berkode (Min=0, Maks=7)
< 0,2	< 0,01	0
0.2-0.4	0.01-0.1	1
0.4-0.8	0.1-0.5	2
0.8-1.6	0.5-1.0	3
- 3.2	1.0 - -2.0	4
- 6.4	2.0-4.0	5
6.4-12.8	4.0-8.0	6
> 12,8	> 8.0	7
Tidak diketahui atau tidak terdeteksi		WWAN_ERROR_RATE_UNKNOWN

RssiInterval

Interval saat ini, dalam detik, di mana driver miniport telah diatur ke (atau interval default, jika belum diatur), bahwa driver miniport akan memberikan pembaruan tentang status sinyal. Tentukan WWAN_RSSI_DISABLE untuk menunjukkan bahwa driver miniport tidak menerapkan pelaporan berbasis interval. Driver miniport harus mengisi anggota ini dengan interval sebagai respons terhadap permintaan sebelumnya dari Layanan MB untuk WWAN_RSSI_DEFAULT.

RssiThreshold

Ambang saat ini, dalam unit ambang batas, tempat driver miniport telah diatur ke (atau interval default, jika belum ditetapkan), bahwa driver miniport akan memberikan pembaruan tentang status sinyal. Tentukan WWAN_RSSI_DISABLE untuk menunjukkan bahwa driver miniport tidak menerapkan pelaporan berbasis ambang batas. Driver miniport harus mengisi anggota ini dengan unit ambang sebagai respons terhadap permintaan sebelumnya dari Layanan MB untuk WWAN_RSSI_DEFAULT.

SignalStateListHeader

Struktur WWAN_LIST_HEADER yang diformat yang mewakili daftar ekstensi status sinyal per kelas data dan jumlah kelas data. Driver miniport harus mengembalikan daftar semua kelas data yang didukung.

Anggota ini menunjuk ke daftar struktur WWAN_SIGNAL_STATE_EXT yang menggunakan struktur WWAN_LIST_HEADER . Anggota struktur WWAN_SIGNAL_STATE_EX lainnya diisi berdasarkan kelas data tertinggi yang tersedia.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Windows 7 dan versi Windows yang lebih baru.
Header	wwan.h (termasuk Wwan.h)

Lihat juga

NDIS_WWAN_SIGNAL_STATE

Share via