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

信噪 (信噪比) ，范围为 -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)

另请参阅

WWAN_SIGNAL_STATE