Mensaje LINE_GENERATE
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 |
|