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