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

Статья
08/26/2023

Функция phoneSetRing вызывает указанное открытое телефонное устройство, используя указанный режим звонка и громкость.

Синтаксис

LONG phoneSetRing(
  HPHONE hPhone,
  DWORD  dwRingMode,
  DWORD  dwVolume
);

Параметры

hPhone

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

dwRingMode

Шаблон звонка, с помощью которого нужно позвонить на телефон. Этот параметр должен находиться в диапазоне от нуля до значения элемента dwNumRingModes в структуре PHONECAPS . Если параметр dwNumRingModes равен нулю, режим звонка телефона нельзя контролировать; Если dwNumRingModes имеет значение 1, значение 0 для dwRingMode указывает, что телефон не должен выполняться (тишина), а другие значения от 1 до dwNumRingModes являются допустимыми режимами звонка для телефонного устройства.

dwVolume

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

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

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

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