Функция phoneGetGain (tapi.h)
Функция 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 |