mensaje de LINE_GATHERDIGITS
El mensaje de LINE_GATHERDIGITS TAPI se envía cuando la solicitud de recopilación de dígitos almacenada en búfer actual ha finalizado o se cancela. La aplicación puede examinar el búfer de dígitos una vez recibido este mensaje.
Parámetros
-
hDevice
-
Identificador de la llamada.
-
dwCallbackInstance
-
La instancia de devolución de llamada proporcionada al abrir la línea.
-
dwParam1
-
Motivo por el que se terminó la recopilación de dígitos. Este parámetro debe ser una y solo una de las constantes LINEGATHERTERM_.
-
dwParam2
-
Sin usar.
-
dwParam3
-
El "recuento de tics" (número de milisegundos desde que Se inició Windows) en el que se completó la recopilación de dígitos. Para las versiones de TAPI anteriores a la 2.0, este parámetro no se usa.
Valor devuelto
No de devuelve ningún valor.
Comentarios
El mensaje de LINE_GATHERDIGITS solo se envía a la aplicación que inició la recopilación de dígitos en la llamada mediante lineGatherDigits.
Si la función lineGatherDigits se usa para cancelar una solicitud anterior para recopilar dígitos, TAPI envía un mensaje de LINE_GATHERDIGITS con dwParam1 establecido en LINEGATHERTERM_CANCEL a la aplicación que indica que el búfer especificado originalmente contiene los dígitos recopilados hasta la cancelación.
Dado que es posible que la marca de tiempo especificada por dwParam3 se haya generado en un equipo distinto del en el que se ejecuta la aplicación, solo es útil para comparar otros mensajes con marca de tiempo similares generados en el mismo dispositivo de línea ( LINE_GENERATE, LINE_MONITORDIGITS, LINE_MONITORMEDIA, 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.
Nota
Cuando una aplicación invoca cualquier operación asincrónica que vuelva a escribir datos en la memoria de la aplicación, la aplicación debe mantener esa memoria disponible para escribir hasta que se reciba un mensaje de LINE_REPLY o LINE_GATHERDIGITS .
Requisitos
| Requisito | Value |
|---|---|
| Versión de TAPI |
Requiere TAPI 2.0 o posterior |
| Encabezado |
|