Функция phoneSetGain (tapi.h)

Статья
03/05/2024

Функция phoneSetGain задает для микрофона указанного устройства-перехватчика заданный уровень усиления.

Синтаксис

LONG phoneSetGain(
  HPHONE hPhone,
  DWORD  dwHookSwitchDev,
  DWORD  dwGain
);

Параметры

hPhone

Дескриптор на открытое телефонное устройство. Приложение должно быть владельцем телефона.

dwHookSwitchDev

Устройство hookswitch, для которого требуется установить коэффициент усиления микрофона. Этот параметр использует только одну из констант PHONEHOOKSWITCHDEV_.

dwGain

Указатель на DWORD , содержащий новый параметр получения устройства. Параметр dwGain указывает уровень получения устройства-перехватчика. Это число в диапазоне 0x00000000 (тишина) до 0x0000FFFF (максимальный объем). Фактическая степень детализации и квантование параметров получения в этом диапазоне зависят от поставщика услуг. Для dwGain , которое выходит за пределы диапазона, устанавливается ближайшее значение в диапазоне.

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

Возвращает положительный идентификатор запроса, если функция выполняется асинхронно, или отрицательный номер ошибки при возникновении ошибки. Параметр dwParam2 соответствующего сообщения PHONE_REPLY равен нулю при успешном выполнении функции или отрицательным номером ошибки при возникновении ошибки. Возможные возвращаемые значения:

PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_NOTOWNER, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALHOOKSWITCHDEV, PHONEERR_UNINITIALIZED PHONEERR_OPERATIONUNAVAIL.

Требования

Требование	Значение
Целевая платформа	Windows
Header	tapi.h
Библиотека	Tapi32.lib
DLL	Tapi32.dll

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

PHONE_REPLY

Дополнительные функции телефонной службы

Обзор справочника по TAPI 2.2

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