Compartir a través de


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