IMbnSignal::GetSignalError 方法 (mbnapi.h)
重要
从 Windows 10 版本 1803 开始,本部分所述的 Win32 API 将替换为 Windows.Networking.Connectivity 命名空间中的Windows 运行时 API。
获取收到的信号错误率。
语法
HRESULT GetSignalError(
[out, retval] ULONG *signalError
);
参数
[out, retval] signalError
指向接收信号中的错误率的指针。
移动宽带接口将信号错误率报告为映射到错误率百分比范围的编码值。 这是 GSM 的通道位错误率和 CDMA 的帧错误率。 在这两种情况下,MBN_ERROR_RATE_UNKNOWN指定未知的错误率。
下表显示了错误代码的值。
%) 中的位错误率 ( | %) 中的帧错误率 ( | 编码值 (0-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 |
1.6 - 3.2 | 1.0 - 2.0 | 4 |
3.2 - 6.4 | 2.0 - 4.0 | 5 |
6.4 - 12.8 | 4.0 - 8.0 | 6 |
> 12.8 | > 8.0 | 7 |
未知 | 未知 | MBN_ERROR_RATE_UNKNOWN |
返回值
此方法可以返回其中一个值。
返回代码 | 说明 |
---|---|
|
方法已成功完成 . |
|
错误率尚不可用。 移动宽带服务当前正在探测设备以检索信息。 当错误率可用时,移动宽带服务将调用 IMbnSignalEvents 的 OnSignalStateChange 方法。 |
注解
移动宽带接口将信号错误率报告为映射到错误率百分比范围的编码值。 这是 GSM 的通道位错误率和 CDMA 的帧错误率。 对于这两种情况, MBN_ERROR_RATE_UNKNOWN 指定未知的错误率。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 7 [仅限桌面应用] |
最低受支持的服务器 | 无受支持的版本 |
目标平台 | Windows |
标头 | mbnapi.h |