Метод IMbnSignal::GetSignalStrength (mbnapi.h)
Важно!
Начиная с Windows 10 версии 1803 API Win32, описанные в этом разделе, заменяются API среда выполнения Windows в пространстве имен Windows.Networking.Connectivity.
Возвращает уровень сигнала, полученный устройством.
Синтаксис
HRESULT GetSignalStrength(
[out, retval] ULONG *signalStrength
);
Параметры
[out, retval] signalStrength
Указатель на качество сигнала, полученного устройством. Если уровень сигнала неизвестен или не обнаруживается устройством, устанавливается значение MBN_RSSI_UNKNOWN. Если этот метод возвращает любое значение, отличное от S_OK, этот параметр равен 0.
Возвращаемое значение
Этот метод может возвращать одно из этих значений.
| Код возврата | Описание |
|---|---|
|
Метод завершился успешно. |
|
Качество сигнала недоступно. Служба мобильной широкополосной связи в настоящее время проверит устройство для получения этих сведений. Когда качество сигнала доступно, служба мобильного широкополосного подключения вызовет метод OnSignalStateChangeобъекта IMbnSignalEvents. |
Комментарии
GetSignalStrength сообщает о силе сигнала, полученной мобильным широкополосным устройством. Для устройств на основе GSM он сообщает о силе сигнала как о силе сигнала, полученном в закодированном значении. Для устройств CDMA он сообщает на основе компенсированного RSSI (учитывает шум), а не на основе raw RSSI.
В следующей таблице содержатся закодированные значения, которые могут быть возвращены.
| Сила сигнала (в дБм) | Закодированное значение (мин. 0 макс. 31) |
|---|---|
| -113 или меньше | 0 |
| -111 | 1 |
| -109 | 2 |
| ... | ... |
| ... | ... |
| -51 или больше | 31 |
| Неизвестный или неизобнаружимый | MBN_RSSI_UNKNOWN |
Для исправлений ошибок E_MBN_PIN_REQUIRED и E_MBN_RADIO_POWER_OFF служба мобильной широкополосной связи снова запросит у устройства состояние сигнала после завершения состояния ошибки. Этот метод возвращает E_PENDING до завершения операции запроса. По завершении нового запроса служба мобильной широкополосной связи вызовет метод OnSignalStateChangeобъекта IMbnSignalEvents.
Требования
| Минимальная версия клиента | Windows 7 [только классические приложения] |
| Минимальная версия сервера | Ни одна версия не поддерживается |
| Целевая платформа | Windows |
| Header | mbnapi.h |