Share via

Mensaje LINE_GENERATE

  • Artículo

El mensaje TAPI LINE_GENERATE se envía para notificar a la aplicación que la generación actual de dígitos o tonos ha terminado. Solo puede haber una solicitud de generación en curso en una llamada determinada en cualquier momento. Este mensaje también se envía cuando se cancela la generación de dígitos o tonos.

Parámetros

hDevice

Identificador de la llamada.

dwCallbackInstance

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

dwParam1

Motivo por el que se terminó la generación de dígitos o tonos. Este parámetro debe ser una y solo una de las constantes LINEGENERATETERM_.

dwParam2

Sin usar.

dwParam3

El "recuento de tics" (número de milisegundos desde el inicio de Windows) en el que se completó la generación de dígitos o tonos. En las versiones de la API anteriores a la 2.0, este parámetro no se utiliza.

Valor devuelto

No devuelve ningún valor.

Comentarios

El mensaje LINE_GENERATE solo se envía a la aplicación que solicitó la generación de dígitos o tonos.

Dado que la marca de tiempo especificada por dwParam3 se puede haber generado en un equipo distinto de aquel en el que se está ejecutando la aplicación, solo es útil para compararla con otros mensajes con marcas de tiempo similares generados en el mismo dispositivo de línea (LINE_GATHERDIGITS, LINE_MONITORDIGITS, LINE_MONITORMEDIA, LINE_MONITORTONE), con el fin de determinar su tiempo relativo (separación entre eventos). El recuento de tics puede "recomenzar" 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 Valor
Versión de TAPI
 Requiere TAPI 2.0 o posterior
Encabezado
Tapi.h

Consulte también

LINE_GATHERDIGITS

LINE_MONITORDIGITS

LINE_MONITORMEDIA

LINE_MONITORTONE