Функция phoneSetVolume (tapi.h)
Функция phoneSetVolume устанавливает громкость компонента динамиков указанного устройства-перехватчика на указанный уровень.
Синтаксис
LONG phoneSetVolume(
HPHONE hPhone,
DWORD dwHookSwitchDev,
DWORD dwVolume
);
Параметры
hPhone
Дескриптор на открытое телефонное устройство. Приложение должно быть владельцем телефона.
dwHookSwitchDev
Устройство Hookswitch, громкость которого должна быть задана, одна из констант PHONEHOOKSWITCHDEV_.
dwVolume
Новый параметр тома устройства. Параметр dwVolume указывает уровень громкости устройства-перехватчика. Это число в диапазоне 0x00000000 (тишина) до 0x0000FFFF (максимальный объем). Фактическая степень детализации и квантование параметров тома в этом диапазоне зависят от поставщика услуг. Для dwVolume , которое находится вне диапазона, устанавливается ближайшее значение в диапазоне.
Возвращаемое значение
Возвращает положительный идентификатор запроса, если функция выполняется асинхронно, или отрицательный номер ошибки при возникновении ошибки. Параметр 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 |