Método ITLegacyCallMediaControl2::GenerateCustomTonesByCollection (tapi3if.h)

El método GenerateCustomTonesByCollection genera el tono personalizado especificado.

Este método está diseñado para Visual Basic y aplicaciones de scripting. En su lugar, las aplicaciones de C/C++ deben usar el método GenerateCustomTones .

Sintaxis

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

Parámetros

[in] pCustomToneCollection

Puntero a una interfaz ITCollection2 que contiene una colección de punteros de interfaz ITCustomTone que representan los componentes del tono. Si la colección es un tono multifrecuencia, los distintos tonos se reproducen simultáneamente.

[in] lDuration

La duración, en milisegundos, durante la cual debe sostenerse el tono. Un valor de cero usa una duración predeterminada.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto	Descripción
S_OK	El método se realizó correctamente.
E_POINTER	El parámetro pCustomToneCollection no es un puntero válido.
E_OUTOFMEMORY	No hay suficiente memoria para asignar el búfer de tonos.
TAPI_E_INVALCALLSTATE	La llamada debe estar en el estado conectado .

Comentarios

Este método se traduce en una llamada a TAPI 2. FunciónlineGenerateTone x.

Cuando finaliza la generación de tonos, se genera un evento de tipo TE_GENERATEEVENT.

Requisitos

Requisito	Value
Plataforma de destino	Windows
Encabezado	tapi3if.h
Library	Uuid.lib
Archivo DLL	Tapi3.dll

Consulte también

ITCollection2

ITCustomTone

ITLegacyCallMediaControl2