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的微型端口驱动程序 WwanCellularClassGSMWwanCellularClassCDMA 必须在设备敏感度噪音地板上方的分贝中报告 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)

另请参阅

NDIS_WWAN_SIGNAL_STATE