Método ITLegacyCallMediaControl2::D etectTones (tapi3if.h)

El método DetectTones 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 aplicaciones de C/C++. En su lugar, las aplicaciones de Scripting y Visual Basic deben usar el método DetectTonesByCollection .

Sintaxis

HRESULT DetectTones(
  [in] TAPI_DETECTTONE *pToneList,
  [in] long            lNumTones
);

Parámetros

[in] pToneList

Puntero a una matriz TAPI_DETECTTONE que especifica los tonos que se van a detectar. Cada tono de la matriz tiene un campo de etiqueta definido por la aplicación que se usa para identificar los tonos individuales de la lista cuando se notifica un evento de detección de tono de tipo TE_TONEEVENT . Para obtener más información, vea la sección Comentarios que se muestra más adelante.

[in] lNumTones

Número de entradas de la matriz especificada por el parámetro pToneList . Este parámetro se omite si pToneList es NULL.

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 pToneList no es un puntero válido.
TAPI_E_INVALCALLSTATE	La llamada debe estar en el estado conectado .

Comentarios

Este método se traduce en un TAPI 2. Llamada a xlineMonitorTones .

Para cancelar la supervisión de tono en curso, llame al método DetectTones y especifique un parámetro pToneListNULL. Para cambiar la lista de tonos que se van a supervisar, llame a este método y especifique una nueva lista de tonos.

Requisitos

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

Consulte también

ITLegacyCallMediaControl2

TAPI_DETECTTONE