WWAN_SIGNAL_STATE 结构 (wwan.h)
WWAN_SIGNAL_STATE结构表示 MB 设备的信号状态。
语法
typedef struct _WWAN_SIGNAL_STATE {
ULONG Rssi;
ULONG ErrorRate;
ULONG RssiInterval;
ULONG RssiThreshold;
WWAN_LIST_HEADER SignalStateListHeader;
} WWAN_SIGNAL_STATE, *PWWAN_SIGNAL_STATE;
成员
Rssi
一个值，该值表示无线信号的强度。 将WWAN_CELLULAR_CLASS报告为 WwanCellularClassGSM 或 WwanCellularClassCDMA 的微型端口驱动程序必须报告 Rssi（以分贝高于设备的敏感度噪声底）。
| dBm) 中的信号强度 ( | 编码值 (Minimum=0，Maximum=31) |
|---|---|
| -113 或更少 | 0 |
| -111 | 1 |
| -109 | 2 |
| ... | ... |
| -51 或更高版本 | 31 |
| 未知或无法检测到 | WWAN_RSSI_UNKNOWN |
基于 CDMA 的设备必须基于补偿 RSSI (的噪声) 而不是原始 RSSI 来报告信号强度。
ErrorRate
一个编码值，表示错误率的百分比范围。 对于基于 GSM 的设备，请使用下表中“通道比特率”列中的值。 对于基于 CDMA 的设备，请使用“帧错误率”列中的值。 对于这两种情况，请使用 WWAN_ERROR_RATE_UNKNOWN 表示未知的错误率。
| 通道误码率 (%) | %) 中的帧错误率 ( | 编码值 (Min=0，Max=7) |
|---|---|---|
| < 0.2 | < 0.01 | 0 |
| 0.2-0.4 | 0.01-0.1 | 1 |
| 0.4-0.8 | 0.1-0.5 | 2 |
| 0.8-1.6 | 0.5-1.0 | 3 |
| - 3.2 | 1.0 - -2.0 | 4 |
| - 6.4 | 2.0-4.0 | 5 |
| 6.4-12.8 | 4.0-8.0 | 6 |
| > 12.8 | > 8.0 | 7 |
| 未知或无法检测到 | WWAN_ERROR_RATE_UNKNOWN | |
RssiInterval
微型端口驱动程序已设置为 (或默认间隔（如果尚未) 设置），微型端口驱动程序将提供有关信号状态的更新的当前间隔（以秒为单位）。 指定WWAN_RSSI_DISABLE以指示微型端口驱动程序不实现基于间隔的报告。 微型端口驱动程序应使用间隔填充此成员，以响应来自 MB 服务的早期请求WWAN_RSSI_DEFAULT。
RssiThreshold
微型端口驱动程序已设置为 (或默认间隔（如果尚未) 设置）的当前阈值（以阈值单位为单位），微型端口驱动程序将提供有关信号状态的更新。 指定WWAN_RSSI_DISABLE以指示微型端口驱动程序不实现基于阈值的报告。 微型端口驱动程序应使用阈值单位填充此成员，以响应来自 MB 服务WWAN_RSSI_DEFAULT的早期请求。
SignalStateListHeader
格式化 WWAN_LIST_HEADER 结构，表示每个数据类的信号状态扩展列表和数据类的数量。 微型端口驱动程序必须返回所有受支持的数据类的列表。
此成员指向使用 WWAN_LIST_HEADER 结构的 WWAN_SIGNAL_STATE_EXT 结构的列表。 WWAN_SIGNAL_STATE_EX结构的其余成员根据最高的可用数据类进行填充。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 在 Windows 7 和更高版本的 Windows 中可用。 |
| 标头 | wwan.h (包括 Wwan.h) |