mensaje de LINE_MONITORTONE

  • Artículo

El mensaje de LINE_MONITORTONE TAPI se envía cuando se detecta un tono. El envío de este mensaje se controla con la función lineMonitorTones .

Parámetros

hDevice

Identificador de la llamada.

dwCallbackInstance

La instancia de devolución de llamada proporcionada al abrir la línea de la llamada.

dwParam1

Miembro dwAppSpecific específico de la aplicación de la estructura LINEMONITORTONE para el tono que se detectó.

dwParam2

Sin usar.

dwParam3

El "recuento de tics" (número de milisegundos desde que Se inició Windows) en el que se detectó el tono. En el caso de las versiones de API anteriores a la 2.0, este parámetro no se usa.

Valor devuelto

No de devuelve ningún valor.

Comentarios

El mensaje de LINE_MONITORTONE solo se envía a la aplicación que ha solicitado supervisar el tono.

Dado que esta marca de tiempo puede haberse generado en un equipo distinto del en el que se ejecuta la aplicación, solo es útil para comparar otros mensajes con marcas de tiempo similares generados en el mismo dispositivo de línea ( LINE_GATHERDIGITS, LINE_GENERATE, LINE_MONITORDIGITS, LINE_MONITORTONE), con el fin de determinar su tiempo relativo (separación entre eventos). El recuento de tics puede "encapsularse" después de aproximadamente 49,7 días; Las aplicaciones deben tener esto en cuenta al realizar cálculos.

Si el proveedor de servicios no genera la marca de tiempo (por ejemplo, si se creó con una versión anterior de TAPI), TAPI proporciona una marca de tiempo en el punto más cercano al proveedor de servicios que genera el evento para que la marca de tiempo sintetizada sea lo más precisa posible.

Requisitos

Requisito Value
Versión de TAPI
 Requiere TAPI 2.0 o posterior
Encabezado
Tapi.h

Consulte también

LINE_GATHERDIGITS

LINE_GENERATE

LINE_MONITORDIGITS

LINEMONITORTONE

lineMonitorTones