Метод IMbnSignal::GetSignalStrength (mbnapi.h)

Статья
08/24/2023

Важно!

Начиная с 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.

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

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

Код возврата	Описание
S_OK	Метод завершился успешно.
E_PENDING	Качество сигнала недоступно. Служба мобильной широкополосной связи в настоящее время проверит устройство для получения этих сведений. Когда качество сигнала доступно, служба мобильного широкополосного подключения вызовет метод OnSignalStateChange объекта IMbnSignalEvents.

Код возврата

Описание

S_OK

Метод завершился успешно.

E_PENDING

Качество сигнала недоступно. Служба мобильной широкополосной связи в настоящее время проверит устройство для получения этих сведений. Когда качество сигнала доступно, служба мобильного широкополосного подключения вызовет метод 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

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

IMbnSignal

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