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 | 無限 | 無效 | 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 | 分貝 |
| SNR_1 | -23≤ SNR<-22.5 | 分貝 |
| SNR_2 | -22.5≤ SNR<-22 | 分貝 |
| SNR_3 | -22≤ SNR<-21.5 | 分貝 |
| SNR_4 | -21.5≤ SNR<-21 | 分貝 |
| ... | ... | ... |
| SNR_123 | 38≤ SNR<38.5 | 分貝 |
| SNR_124 | 38.5≤ SNR<39 | 分貝 |
| SNR_125 | 39≤ SNR<39.5 | 分貝 |
| SNR_126 | 39.5≤ SNR<40 | 分貝 |
| SNR_127 | 40≤ SNR | 分貝 |
只有當 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） |