struktur WWAN_SIGNAL_STATE_EXT (wwan.h)

Artikel
08/08/2023

Struktur WWAN_SIGNAL_STATE_EXT mewakili ekstensi ke status sinyal perangkat MB. Dalam Windows 10, versi 1903 dan yang lebih baru, WWAN_SIGNAL_STATE_EX berisi informasi utama tentang status sinyal perangkat, termasuk array struktur WWAN_SIGNAL_STATE_EXT yang berisi informasi status sinyal khusus untuk 5G.

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

Sintaks

typedef struct _WWAN_SIGNAL_STATE_EXT {
  ULONG RSRP;
  ULONG RSRPThreshold;
  ULONG SNR;
  ULONG SNRThreshold;
  ULONG DataClass;
} WWAN_SIGNAL_STATE_EXT, *PWWAN_SIGNAL_STATE_EXT;

Anggota

RSRP

Sinyal referensi yang diterima daya (RSRP), yang berkisar dari -156 hingga -31, dalam satuan 1 dBm. Gunakan WWAN_RSRP_UNKNOWN ketika informasi ini tidak tersedia. Tabel berikut ini memperlihatkan cara memetakan rentang ke anggota RSRP.

Nilai yang dilaporkan	Nilai kuantitas terukur (SS_RSRP L3)	Nilai kuantitas terukur (L1 SS-RSRP dan CSI-RSRP)	Unit
RSRP_0	SS-RSRP-156<	Tidak valid	Dbm
RSRP_1	-156≤ SS-RSRP-55<	Tidak valid	Dbm
RSRP_2	-155≤ SS-RSRP-54<	Tidak valid	Dbm
RSRP_3	-154≤ SS-RSRP-153<	Tidak valid	Dbm
RSRP_4	-153≤ SS-RSRP-152<	Tidak valid	Dbm
RSRP_5	-152≤ SS-RSRP-151<	Tidak valid	Dbm
...	...	...	...
RSRP_16	-141≤ SS-RSRP-140<	Tidak valid	Dbm
RSRP_17	-140≤ SS-RSRP-139<	RSRP-139< dBm
RSRP_18	-139≤ SS-RSRP-138<	-139≤ RSRP-138< dBm
...	...	...	...
RSRP_111	-46≤ SS-RSRP-45<	-46≤ RSRP-45<	Dbm
RSRP_112	-45≤ SS-RSRP-44<	-45≤ RSRP	Dbm
RSRP_113	-44≤ SS-RSRP-43<	Tidak valid	Dbm
RSRP_114	-43≤ SS-RSRP-42<	Tidak valid	Dbm
RSRP_115	-42≤ SS-RSRP-41<	Tidak valid	Dbm
RSRP_116	-41≤ SS-RSRP-40<	Tidak valid	Dbm
RSRP_117	-40≤ SS-RSRP-39<	Tidak valid	Dbm
RSRP_118	-39≤ SS-RSRP-38<	Tidak valid	Dbm
RSRP_119	-38≤ SS-RSRP-37<	Tidak valid	Dbm
RSRP_120	-37≤ SS-RSRP-36<	Tidak valid	Dbm
RSRP_121	-36≤ SS-RSRP-35<	Tidak valid	Dbm
RSRP_122	-35≤ SS-RSRP-34<	Tidak valid	Dbm
RSRP_123	-34≤ SS-RSRP-33<	Tidak valid	Dbm
RSRP_124	-33≤ SS-RSRP-32<	Tidak valid	Dbm
RSRP_125	-32≤ SS-RSRP-31<	Tidak valid	Dbm
RSRP_126	-31≤ SS-RSRP	Tidak valid	Dbm
RSRP_127	Tak terbatas	Tidak valid	Dbm

Anggota ini hanya valid jika anggota DataClass diatur ke WWAN_DATA_CLASS_LTE atau WWAN_DATA_CLASS_5G_NSA/SA. Jika tidak, gunakan WWAN_RSRP_UNKNOWN.

RSRPThreshold

Ambang saat ini, dalam unit ambang (1 dBm), di mana driver miniport telah ditetapkan (atau ambang default, jika belum ditetapkan), di mana driver miniport menyediakan pembaruan tentang status sinyal. Tentukan WWAN_RSRP_DISABLE untuk menunjukkan bahwa driver 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_RSRP_DEFAULT.

Anggota ini hanya valid jika anggota DataClass diatur ke WWAN_DATA_CLASS_LTE atau WWAN_DATA_CLASS_5G_NSA/SA. Jika tidak, gunakan WWAN_RSRP_DISABLE.

SNR

Rasio signal-to-noise (SNR), berkisar antara -23 hingga 40, dalam satuan 0,5 dB. Gunakan WWAN_SNR_UNKNOWN ketika informasi ini tidak tersedia. Tabel berikut ini memperlihatkan cara memetakan rentang ke anggota SNR.

Nilai yang dilaporkan	Nilai kuantitas terukur	Unit
SNR_0	SNR-23<	Db
SNR_1	-23≤ SNR-22.5<	Db
SNR_2	-22.5≤ SNR-22<	Db
SNR_3	-22≤ SNR-21.5<	Db
SNR_4	-21,5≤ SNR-21<	Db
...	...	...
SNR_123	38≤ SNR<38,5	Db
SNR_124	38.5≤ SNR<39	Db
SNR_125	39≤ SNR<39,5	Db
SNR_126	39,5≤ SNR<40	Db
SNR_127	40≤ SNR	Db

Anggota ini hanya valid jika anggota DataClass diatur ke WWAN_DATA_CLASS_LTE atau WWAN_DATA_CLASS_5G_NSA/SA. Jika tidak, gunakan WWAN_SNR_UNKNOWN.

SNRThreshold

Ambang saat ini, dalam unit ambang (1 dBm), di mana driver miniport telah ditetapkan (atau ambang default, jika belum ditetapkan), di mana driver miniport menyediakan pembaruan tentang status sinyal. Tentukan WWAN_SNR_DISABLE untuk menunjukkan bahwa driver 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_SNR_DEFAULT.

Anggota ini hanya valid jika anggota DataClass diatur ke WWAN_DATA_CLASS_LTE atau WWAN_DATA_CLASS_5G_NSA/SA. Jika tidak, gunakan WWAN_SNR_DISABLE.

DataClass

Menunjukkan kelas data yang parameternya valid. Hanya jika WWAN_DATA_CLASS_LTE atau WWAN_DATA_CLASS_5G_NSA/SA diatur, maka anggota RSRP, RSRPThreshold, SNR, dan SNRThreshold valid.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 10, versi 1903
Header	wwan.h (sertakan Wwan.h)

Lihat juga

WWAN_SIGNAL_STATE

Share via