Función lineMonitorDigits (tapi.h)

Artículo
08/26/2023

La función lineMonitorDigits habilita y deshabilita la detección sin búfer de dígitos recibidos en la llamada. Cada vez que se detecta un dígito del modo de dígito especificado, se envía un mensaje a la aplicación que indica qué dígito se ha detectado.

Sintaxis

LONG lineMonitorDigits(
  HCALL hCall,
  DWORD dwDigitModes
);

Parámetros

hCall

Controle la llamada en la que se detectarán los dígitos. El estado de llamada de hCall puede ser cualquier estado excepto inactivo o desconectado.

dwDigitModes

Modo de dígito o modos que se van a supervisar. Si dwDigitModes es cero, se cancela la supervisión de dígitos. Este parámetro usa una o varias de las LINEDIGITMODE_ Constantes.

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_OPERATIONUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONFAILED, LINEERR_INVALDIGITMODE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED.

Comentarios

Esta función se considera correcta si la supervisión de dígitos se ha iniciado correctamente, no cuando la supervisión de dígitos ha finalizado. La supervisión de dígitos permanece vigente hasta que se deshabilita explícitamente llamando a lineMonitorDigits con dwDigitModes establecido en cero, 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 dígitos se suelen detectar solo mientras la llamada está en estado conectado .

Cada vez que se detecta un dígito, se envía un mensaje de LINE_MONITORDIGITS a la aplicación pasando el dígito detectado como parámetro.

Una aplicación puede usar lineMonitorDigits para habilitar o deshabilitar la detección de dígitos sin búfer. Puede usar lineGatherDigits para la detección de dígitos almacenados en búfer. Una vez completada la recopilación de dígitos almacenados en búfer, se envía un mensaje de LINE_GATHERDIGITS a la aplicación. La detección de dígitos almacenados en búfer y sin búfer se puede habilitar en la misma llamada simultáneamente.

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