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) |