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）比率，范围为 0.5 dB，范围为 -23 到 40。 当此信息不可用时，请使用 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） |