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

Статья
03/13/2024

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

Синтаксис

LONG phoneGetGain(
  HPHONE  hPhone,
  DWORD   dwHookSwitchDev,
  LPDWORD lpdwGain
);

Параметры

hPhone

Дескриптор на открытое телефонное устройство.

dwHookSwitchDev

Устройство Hookswitch, уровень получения которого запрашивается. Параметр dwHookSwitchDev может иметь только один бит. Этот параметр использует только одну из констант PHONEHOOKSWITCHDEV_.

lpdwGain

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

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

Возвращает ноль при успешном выполнении запроса или отрицательное число ошибки при возникновении ошибки. Возможные возвращаемые значения:

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

Требования

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

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

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

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

Share via