MÉTODO ITLegacyCallMediaControl2::D etectTonesByCollection (tapi3if.h)

Artículo
03/02/2024

El método DetectTonesByCollection habilita y deshabilita la detección de tonos de banda en la llamada. Cada vez que se detecta un tono especificado, se envía un mensaje a la aplicación.

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 DetectTones .

Sintaxis

HRESULT DetectTonesByCollection(
  [in] ITCollection2 *pDetectToneCollection
);

Parámetros

[in] pDetectToneCollection

Puntero a una interfaz ITCollection2 que contiene una colección de punteros de interfaz ITDetectTone que representan los tonos que se van a supervisar. Cada tono de la lista tiene un campo de etiqueta definido por la aplicación que se usa para identificar los tonos individuales cuando un evento TE_TONEEVENT notifica la detección de tonos. Para obtener más información, vea la sección Comentarios que se muestra más adelante.

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 pDetectToneCollection 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 un TAPI 2. xllamada a LineMonitorTones .

Para cancelar la supervisión de tono en curso, llame al método DetectTonesByCollection y especifique una colección vacía. Para cambiar la lista de tonos que se van a supervisar, llame a este método y especifique una nueva colección de tonos.