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

Статья
03/08/2023

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

Синтаксис

LONG lineMonitorDigits(
  HCALL hCall,
  DWORD dwDigitModes
);

Параметры

hCall

Дескриптор вызова, в котором должны быть обнаружены цифры. Состояние вызова hCall может быть любым, кроме состояния простоя или отключения.

dwDigitModes

Режим цифр или режимы, которые необходимо отслеживать. Если значение dwDigitModes равно нулю, мониторинг цифр отменяется. Этот параметр использует одну или несколько констант LINEDIGITMODE_.

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

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

LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONFAILED, LINEERR_INVALDIGITMODE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM LINEERR_UNINITIALIZED.

Эта функция считается успешной, если мониторинг цифр был запущен правильно, а не после завершения мониторинга цифр. Мониторинг цифр остается в силе до тех пор, пока он не будет явно отключен путем вызова lineMonitorDigits с параметром dwDigitModes, для параметра dwDigitModes установлено значение 0, пока вызов не перейдет в режим простоя или пока приложение не освободит свой дескриптор вызова для вызова. Хотя эту функцию можно вызвать в любом состоянии вызова, цифры обычно обнаруживаются только в том случае, когда вызов находится в подключенном состоянии.

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

Приложение может использовать lineMonitorDigits для включения или отключения обнаружения небуферизованных цифр. Он может использовать lineGatherDigits для обнаружения буферизованной цифры. После завершения сбора буферизованной цифры в приложение отправляется LINE_GATHERDIGITS сообщение. Обнаружение буферизованных и небуферизованных цифр можно включить одновременно при одном вызове.

Мониторинг цифр на конференции применяется только к hConfCall, а не к отдельным участвующим звонкам.