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

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

  • Статья

Метод GenerateCustomTonesByCollection создает указанный пользовательский тон.

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

Синтаксис

HRESULT GenerateCustomTonesByCollection(
  [in] ITCollection2 *pCustomToneCollection,
  [in] long          lDuration
);

Параметры

[in] pCustomToneCollection

Указатель на интерфейс ITCollection2 , содержащий коллекцию указателей интерфейса ITCustomTone , представляющих компоненты тона. Если коллекция является многочастотным, различные тона воспроизводится одновременно.

[in] lDuration

Длительность (в миллисекундах), в течение которой должен поддерживаться тон. Значение, равное нулю, использует длительность по умолчанию.

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

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

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

Комментарии

Этот метод преобразуется в вызов TAPI 2. Функция xlineGenerateTone .

После завершения создания тона создается событие типа TE_GENERATEEVENT.

Требования

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

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

ITCollection2

ITCustomTone

ITLegacyCallMediaControl2