Метод IMbnSignal::GetSignalError (mbnapi.h)
Важно!
Начиная с Windows 10 версии 1803, API Win32, описанные в этом разделе, заменяются среда выполнения Windows API в пространстве имен Windows.Networking.Connectivity.
Возвращает частоту ошибок полученного сигнала.
Синтаксис
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 |
Возвращаемое значение
Этот метод может возвращать одно из этих значений.
| Код возврата | Описание |
|---|---|
|
Метод успешно завершен . |
|
Частота ошибок пока недоступна. Служба мобильного широкополосного подключения в настоящее время проверит устройство для получения информации. Если частота ошибок доступна, служба мобильного широкополосного подключения вызовет метод OnSignalStateChangeобъекта IMbnSignalEvents. |
Комментарии
Интерфейсы мобильной широкополосной связи сообщают частоту ошибок сигнала в виде закодированного значения, которое сопоставляется с процентным диапазоном частоты ошибок. Это скорость битовых ошибок канала для GSM и частота ошибок кадров для CDMA. В обоих случаях MBN_ERROR_RATE_UNKNOWN указывает неизвестная частота ошибок.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 7 [только классические приложения] |
| Минимальная версия сервера | Ни одна версия не поддерживается |
| Целевая платформа | Windows |
| Header | mbnapi.h |