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)

另请参阅

NDIS_WWAN_SIGNAL_STATE