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 |