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

Метод IDot11AdHocNetwork::GetSignalQuality (adhoc.h)

  • Статья

Возвращает значения качества сигнала, связанные с радиосвязями сети.

Синтаксис

HRESULT GetSignalQuality(
  [out] ULONG *puStrengthValue,
  [out] ULONG *puStrengthMax
);

Параметры

[out] puStrengthValue

Текущая сила сигнала. Этот параметр принимает значение ULONG в диапазоне от 0 до puStrengthMax.

[out] puStrengthMax

Максимальное значение силы сигнала. Этот параметр принимает значение ULONG от 0 до 100. По умолчанию для puStrengthMax задано значение 100.

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

Возможные возвращаемые значения включают, помимо прочего, следующие.

Код возврата Описание
S_OK
 Метод завершился успешно.
E_FAIL
 Сбой метода.
E_INVALIDARG
 Один из параметров является недопустимым.
E_OUTOFMEMORY
 Методу не удалось выделить память, необходимую для выполнения этой операции.
E_POINTER
 Недопустимый указатель, переданный в качестве параметра.

Комментарии

Сила сигнала в этом контексте измеряется по линейной шкале. Если для puStrengthMax задано значение по умолчанию 100, puStrengthValue представляет процент от максимальной силы сигнала, используемой в настоящее время для передачи.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header adhoc.h

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

IDot11AdHocNetwork