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

Метод ITLegacyCallMediaControl2::D etectTones (tapi3if.h)

  • Статья

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

Этот метод предназначен для приложений C/C++. Вместо этого в Visual Basic и приложениях для сценариев следует использовать метод DetectTonesByCollection .

Синтаксис

HRESULT DetectTones(
  [in] TAPI_DETECTTONE *pToneList,
  [in] long            lNumTones
);

Параметры

[in] pToneList

Указатель на массив TAPI_DETECTTONE , указывающий тон для обнаружения. Каждый тон в массиве имеет определенное приложением поле тега, которое используется для идентификации отдельных тонов в списке при сообщении о событии обнаружения тона типа TE_TONEEVENT . Дополнительные сведения см. в разделе "Примечания".

[in] lNumTones

Количество записей в массиве, заданное параметром pToneList . Этот параметр игнорируется, если pToneList имеет значение NULL.

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

Этот метод может возвращать одно из этих значений.

Код возврата Описание
S_OK
 Метод успешно выполнен.
E_POINTER
 Параметр pToneList не является допустимым указателем.
TAPI_E_INVALCALLSTATE
 Вызов должен находиться в подключенном состоянии.

Комментарии

Этот метод преобразуется в TAPI 2. Вызов xlineMonitorTones .

Чтобы отменить мониторинг тона, вызовите метод DetectTones и укажите параметр pToneListNULL. Чтобы изменить список отслеживаемых тонов, вызовите этот метод и укажите новый список тонов.

Требования

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

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

ITLegacyCallMediaControl2

TAPI_DETECTTONE