Поделиться через


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

Функция phoneGetRing позволяет приложению запрашивать указанное открытое телефонное устройство в соответствии с текущим режимом звонка.

Синтаксис

LONG phoneGetRing(
  HPHONE  hPhone,
  LPDWORD lpdwRingMode,
  LPDWORD lpdwVolume
);

Параметры

hPhone

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

lpdwRingMode

Шаблон звонка, с которым звонит телефон. Ноль означает, что телефон не звонит.

lpdwVolume

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

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

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

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

Комментарии

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

Требования

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

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

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

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