Función lineMonitorTones (tapi.h)

La función lineMonitorTones 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.

Sintaxis

LONG lineMonitorTones(
  HCALL                   hCall,
  LPLINEMONITORTONE const lpToneList,
  DWORD                   dwNumEntries
);

Parámetros

hCall

Controle la llamada en cuyos tonos de canal de voz se van a supervisar. El estado de llamada de hCall puede ser cualquier estado excepto inactivo.

lpToneList

Lista de tonos que se van a supervisar. Este parámetro es de tipo LINEMONITORTONE. Cada tono de esta lista tiene un campo de etiqueta definido por la aplicación que se usa para identificar los tonos individuales de la lista para notificar una detección de tono. La supervisión de tonos en curso se cancela o cambia llamando a esta operación con NULL para lpToneList o con otra lista de tonos.

dwNumEntries

Número de entradas en lpToneList. Este parámetro se omite si lpToneList es NULL.

Valor devuelto

Devuelve cero si la solicitud se realiza correctamente o un número de error negativo si se produce un error. Los valores devueltos posibles son:

LINEERR_INVALCALLHANDLE, LINEERR_INVALCALLSTATE, LINEERR_INVALPOINTER, LINEERR_INVALTONE, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_UNINITIALIZED.

Comentarios

Esta función se realiza correctamente si se ha iniciado correctamente la supervisión del tono, no cuando la supervisión de tono ha finalizado. La supervisión de tono permanece vigente hasta que se deshabilita explícitamente llamando a lineMonitorTones con otra lista de tonos (o NULL), hasta que la llamada pasa a inactiva o cuando la aplicación desasigna su identificador de llamada para la llamada.

Aunque esta función se puede invocar en cualquier estado de llamada, los tonos normalmente solo se pueden detectar mientras la llamada está en estado conectado . La detección de tonos normalmente requiere recursos computacionales. Según el proveedor de servicios y otras actividades que compiten por estos recursos, el número de tonos que se pueden detectar puede variar con el tiempo. Además, se puede consumir una cantidad equivalente de recursos para supervisar un único tono de frecuencia triple frente a tres tonos de frecuencia única. Si se sobrecommiten los recursos, se devuelve el error LINEERR_RESOURCEUNAVAIL.

La función lineMonitorTones también se usa para detectar silencio. El silencio se especifica como un tono con una frecuencia de cero.

La supervisión de tonos en una llamada de conferencia solo se aplica a hConfCall, no a las llamadas individuales participantes

Si se devuelve el valor de error LINEERR_INVALPOINTER, el parámetro lpToneList especificado no es válido o el valor especificado por el parámetro dwNumEntries es demasiado grande.

Requisitos

Requisito	Value
Plataforma de destino	Windows
Encabezado	tapi.h
Library	Tapi32.lib
Archivo DLL	Tapi32.dll

Consulte también

LINEMONITORTONE

Funciones de servicio de línea complementarias

Información general de referencia de TAPI 2.2