Recolha de Dígitos

** Além de permitir a monitorização de dígitos e a notificação dos dígitos um a um, uma aplicação pode também solicitar que vários dígitos sejam recolhidos num buffer. Somente quando o buffer estiver cheio ou quando alguma outra condição de rescisão for atendida é que o aplicativo é notificado. A coleta de dígitos é útil para funções como a coleta de números de cartão de crédito. Ele é executado quando um aplicativo chama lineGatherDigits, especificando um buffer para preencher com dígitos. A coleta de dígitos termina quando uma das seguintes condições for verdadeira:

• O número de dígitos solicitado foi recolhido.
• Um dos múltiplos dígitos finais é detetado. Os dígitos de terminação são especificados para lineGatherDigits, e o dígito de terminação também é colocado no buffer.
• Um dos dois tempos limite expira. Os tempos limite são um tempo limite de primeiro dígito, especificando a duração máxima antes que o primeiro dígito deva ser coletado, e um tempo limite entre dígitos, especificando a duração máxima entre dígitos sucessivos.
• A coleta de dígitos é cancelada explicitamente por lineGatherDigits novamente com um novo conjunto de parâmetros para iniciar uma nova solicitação de coleta ou usando um parâmetro de buffer de dígitos NULL para cancelar.

Quando a coleta de dígitos termina por qualquer motivo, uma mensagem de LINE_GATHERDIGITS é enviada para o aplicativo que solicitou a coleta de dígitos. Apenas uma solicitação de recolha de um único dígito pode permanecer pendente numa chamada a qualquer momento em todos os aplicativos que gerem a chamada.

A coleta e o monitoramento de dígitos podem ser habilitados na mesma chamada ao mesmo tempo. Nesse caso, o aplicativo receberá uma mensagem LINE_MONITORDIGITS para cada dígito detetado e uma mensagem LINE_GATHERDIGITS separada quando o buffer for enviado de volta.