WWAN_SIGNAL_STATE_EXT 結構 (wwan.h)
WWAN_SIGNAL_STATE_EXT 結構代表 MB 裝置訊號狀態的延伸模組。 在 Windows 10 1903 版和更新版本中,WWAN_SIGNAL_STATE_EX包含裝置訊號狀態的主要資訊,包括包含 5G 特定訊號狀態資訊的WWAN_SIGNAL_STATE_EXT結構數位。
如需 5G 資料類別支援的詳細資訊,請參閱 MB 5G 資料類別支援。
語法
typedef struct _WWAN_SIGNAL_STATE_EXT {
ULONG RSRP;
ULONG RSRPThreshold;
ULONG SNR;
ULONG SNRThreshold;
ULONG DataClass;
} WWAN_SIGNAL_STATE_EXT, *PWWAN_SIGNAL_STATE_EXT;
成員
RSRP
參考訊號接收的電源 (RSRP) ,範圍從 -156 到 -31,單位為 1 dBm。 無法使用此資訊時 ,請使用WWAN_RSRP_UNKNOWN 。 下表顯示如何將範圍對應至 RSRP 成員。
回報的值 | 測量的數量值 (L3 SS_RSRP) | 測量的數量值 (L1 SS-RSRP 和 CSI-RSRP) | 單位 |
---|---|---|---|
RSRP_0 | SS-RSRP-156< | 無效 | Dbm |
RSRP_1 | -156≤ SS-RSRP-55< | 無效 | Dbm |
RSRP_2 | -155≤ SS-RSRP-54< | 無效 | Dbm |
RSRP_3 | -154≤ SS-RSRP-153< | 無效 | Dbm |
RSRP_4 | -153≤ SS-RSRP-152< | 無效 | Dbm |
RSRP_5 | -152≤ SS-RSRP-151< | 無效 | Dbm |
... | ... | ... | ... |
RSRP_16 | -141≤ SS-RSRP-140< | 無效 | 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< | 無效 | Dbm |
RSRP_114 | -43≤ SS-RSRP-42< | 無效 | Dbm |
RSRP_115 | -42≤ SS-RSRP-41< | 無效 | Dbm |
RSRP_116 | -41≤ SS-RSRP-40< | 無效 | Dbm |
RSRP_117 | -40≤ SS-RSRP-39< | 無效 | Dbm |
RSRP_118 | -39≤ SS-RSRP-38< | 無效 | Dbm |
RSRP_119 | -38≤ SS-RSRP-37< | 無效 | Dbm |
RSRP_120 | -37≤ SS-RSRP-36< | 無效 | Dbm |
RSRP_121 | -36≤ SS-RSRP-35< | 無效 | Dbm |
RSRP_122 | -35≤ SS-RSRP-34< | 無效 | Dbm |
RSRP_123 | -34≤ SS-RSRP-33< | 無效 | Dbm |
RSRP_124 | -33≤ SS-RSRP-32< | 無效 | Dbm |
RSRP_125 | -32≤ SS-RSRP-31< | 無效 | Dbm |
RSRP_126 | -31≤ SS-RSRP | 無效 | Dbm |
RSRP_127 | Infinity | 無效 | Dbm |
只有當 DataClass 成員設定為 WWAN_DATA_CLASS_LTE 或 WWAN_DATA_CLASS_5G_NSA/SA 時,此成員才有效。 否則,請使用 WWAN_RSRP_UNKNOWN。
RSRPThreshold
目前的臨界值,以臨界值單位 (1 dBm) ,其中迷你埠驅動程式已設定 (或預設閾值,如果尚未設定) ,則迷你埠驅動程式會提供訊號狀態的更新。 指定 WWAN_RSRP_DISABLE ,指出驅動程式不會實作臨界值型報告。 迷你埠驅動程序應該會填入此成員的臨界值單位,以回應 MB 服務的先前要求 ,以進行WWAN_RSRP_DEFAULT。
只有當 DataClass 成員設定為 WWAN_DATA_CLASS_LTE 或 WWAN_DATA_CLASS_5G_NSA/SA 時,此成員才有效。 否則,請使用 WWAN_RSRP_DISABLE。
SNR
訊號對雜訊 (SNR) 比率,範圍從 -23 到 40,單位為 0.5 dB。 無法使用此資訊時 ,請使用WWAN_SNR_UNKNOWN 。 下表顯示如何將範圍對應至SNR成員。
回報的值 | 測量的數量值 | 單位 |
---|---|---|
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 |
只有當 DataClass 成員設定為 WWAN_DATA_CLASS_LTE 或 WWAN_DATA_CLASS_5G_NSA/SA 時,此成員才有效。 否則,請使用 WWAN_SNR_UNKNOWN。
SNRThreshold
目前的臨界值,以臨界值單位 (1 dBm) ,其中迷你埠驅動程式已設定 (或預設閾值,如果尚未設定) ,則迷你埠驅動程式會提供訊號狀態的更新。 指定 WWAN_SNR_DISABLE ,指出驅動程式不會實作臨界值型報告。 迷你埠驅動程序應該會填入此成員的臨界值單位,以回應 MB 服務的先前要求 ,以進行WWAN_SNR_DEFAULT。
只有當 DataClass 成員設定為 WWAN_DATA_CLASS_LTE 或 WWAN_DATA_CLASS_5G_NSA/SA 時,此成員才有效。 否則,請使用 WWAN_SNR_DISABLE。
DataClass
指出參數有效的數據類別。 只有在設定WWAN_DATA_CLASS_LTE或WWAN_DATA_CLASS_5G_NSA/SA 時,RSRP、RSRPThreshold、SNR 和 SNRThreshold 成員才有效。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 10 (版本 1903) |
標頭 | wwan.h (包含 Wwan.h) |