Метод ITLegacyCallMediaControl2::D etectTonesByCollection (tapi3if.h)
Метод DetectTonesByCollection включает и отключает обнаружение сигналов по полосе при вызове. При каждом обнаружении указанного сигнала в приложение отправляется сообщение.
Этот метод предназначен для Приложений Visual Basic и сценариев. Вместо этого приложения C/C++ должны использовать метод DetectTones .
Синтаксис
HRESULT DetectTonesByCollection(
[in] ITCollection2 *pDetectToneCollection
);
Параметры
[in] pDetectToneCollection
Указатель на интерфейс ITCollection2 , содержащий коллекцию указателей интерфейса ITDetectTone , представляющих отслеживаемые тона. Каждый тон в списке имеет определяемое приложением поле тега, которое используется для идентификации отдельных тонов при обнаружении сигнала событием TE_TONEEVENT . Дополнительные сведения см. в разделе "Примечания".
Возвращаемое значение
Этот метод может возвращать одно из этих значений.
Код возврата | Описание |
---|---|
|
Метод успешно выполнен. |
|
Параметр pDetectToneCollection не является допустимым указателем. |
|
Недостаточно памяти для выделения буфера тонов. |
|
Вызов должен находиться в подключенном состоянии. |
Комментарии
Этот метод преобразуется в TAPI 2. Вызов xlineMonitorTones .
Чтобы отменить мониторинг тона, вызовите метод DetectTonesByCollection и укажите пустую коллекцию. Чтобы изменить список отслеживаемых тонов, вызовите этот метод и укажите новую коллекцию тонов.
Требования
Требование | Значение |
---|---|
Целевая платформа | Windows |
Header | tapi3if.h |
Библиотека | Uuid.lib |
DLL | Tapi3.dll |