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


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

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

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

Синтаксис

HRESULT DetectTonesByCollection(
  [in] ITCollection2 *pDetectToneCollection
);

Параметры

[in] pDetectToneCollection

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

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

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

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

Комментарии

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

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

Требования

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

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

ITCollection2

ITDetectTone

ITLegacyCallMediaControl2