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	Tapi.h

Confira também

LINE_GENERATE

LINE_MONITORDIGITS

LINE_MONITORMEDIA

LINE_MONITORTONE

LINE_REPLY

lineGatherDigits