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

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

Синтаксис

LONG phoneGetVolume(
  HPHONE  hPhone,
  DWORD   dwHookSwitchDev,
  LPDWORD lpdwVolume
);

Параметры

hPhone

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

dwHookSwitchDev

Одно устройство перехватчика, уровень громкости которого запрашивается. Этот параметр использует одну из констант PHONEHOOKSWITCHDEV_.

lpdwVolume

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

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

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

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

Требования

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

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

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

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