LINE_GATHERDIGITS mensagem
A mensagem LINE_GATHERDIGITS TAPI é enviada quando a solicitação de coleta de dígitos em buffer atual é encerrada ou cancelada. O buffer de dígitos pode ser examinado depois que essa mensagem for recebida pelo aplicativo.
Parâmetros
-
hDevice
-
Um identificador para a chamada.
-
dwCallbackInstance
-
A instância de retorno de chamada fornecida ao abrir a linha.
-
Dwparam1
-
O motivo pelo qual a coleta de dígitos foi encerrada. Esse parâmetro deve ser apenas uma das constantes LINEGATHERTERM_.
-
Dwparam2
-
Não utilizado.
-
dwParam3
-
A "contagem de tiques" (número de milissegundos desde o início do Windows) na qual a coleta de dígitos foi concluída. Para versões TAPI anteriores à 2.0, esse parâmetro não é usado.
Valor retornado
Sem valor de retorno.
Comentários
A mensagem LINE_GATHERDIGITS é enviada apenas para o aplicativo que iniciou a coleta de dígitos na chamada usando lineGatherDigits.
Se a função lineGatherDigits for usada para cancelar uma solicitação anterior para coletar dígitos, o TAPI enviará uma mensagem de LINE_GATHERDIGITS com dwParam1 definido como LINEGATHERTERM_CANCEL para o aplicativo, indicando que o buffer especificado originalmente contém os dígitos coletados até o cancelamento.
Como o carimbo de data/hora especificado por dwParam3 pode ter sido gerado em um computador diferente do em que o aplicativo está sendo executado, ele é útil apenas para comparação com outras mensagens com carimbo de data/hora semelhantes geradas no mesmo dispositivo de linha ( LINE_GENERATE, LINE_MONITORDIGITS, LINE_MONITORMEDIA, LINE_MONITORTONE), a fim de determinar seu tempo relativo (separação entre eventos). A contagem de tiques pode "encapsular" após aproximadamente 49,7 dias; os aplicativos devem levar isso em conta ao executar cálculos.
Se o provedor de serviços não gerar o carimbo de data/hora (por exemplo, se ele tiver sido criado usando uma versão anterior do TAPI), o TAPI fornecerá um carimbo de data/hora no ponto mais próximo do provedor de serviços que gera o evento para que o carimbo de data/hora sintetizado seja o mais preciso possível.
Observação
Quando um aplicativo invoca qualquer operação assíncrona que grava dados de volta na memória do aplicativo, o aplicativo deve manter essa memória disponível para gravação até que uma mensagem LINE_REPLY ou LINE_GATHERDIGITS seja recebida.
Requisitos
| Requisito | Valor |
|---|---|
| Versão do TAPI |
Requer TAPI 2.0 ou posterior |
| Cabeçalho |
|