Функция 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 |