Поделиться через

Метод 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

Возвращаемое значение

Этот метод может возвращать одно из этих значений.

Код возврата Описание
S_OK
 Метод успешно завершен

.
E_PENDING
 Частота ошибок пока недоступна. Служба мобильного широкополосного подключения в настоящее время проверит устройство для получения информации. Если частота ошибок доступна, служба мобильного широкополосного подключения вызовет метод OnSignalStateChangeобъекта IMbnSignalEvents.

Комментарии

Интерфейсы мобильной широкополосной связи сообщают частоту ошибок сигнала в виде закодированного значения, которое сопоставляется с процентным диапазоном частоты ошибок. Это скорость битовых ошибок канала для GSM и частота ошибок кадров для CDMA. В обоих случаях MBN_ERROR_RATE_UNKNOWN указывает неизвестная частота ошибок.

Требования

Требование Значение
Минимальная версия клиента Windows 7 [только классические приложения]
Минимальная версия сервера Ни одна версия не поддерживается
Целевая платформа Windows
Header mbnapi.h

См. также раздел

IMbnSignal