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 |