mensaje de LINE_MONITORTONE
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 |
|