Compartilhar via


LINE_MONITORTONE mensagem

A mensagem LINE_MONITORTONE TAPI é enviada quando um tom é detectado. O envio dessa mensagem é controlado com a função lineMonitorTones .

            

Parâmetros

hDevice

Um identificador para a chamada.

dwCallbackInstance

A instância de retorno de chamada fornecida ao abrir a linha da chamada.

Dwparam1

O membro dwAppSpecific específico do aplicativo da estrutura LINEMONITORTONE para o tom detectado.

Dwparam2

Não utilizado.

dwParam3

A "contagem de tiques" (número de milissegundos desde que o Windows começou) na qual o tom foi detectado. Para versões de API anteriores à 2.0, esse parâmetro não é usado.

Valor retornado

Sem valor de retorno.

Comentários

A mensagem LINE_MONITORTONE é enviada apenas para o aplicativo que solicitou que o tom fosse monitorado.

Como esse carimbo de data/hora pode ter sido gerado em um computador diferente do em que o aplicativo está em execução, ele é útil apenas para comparação com outras mensagens com carimbo de data/hora semelhantes geradas no mesmo dispositivo de linha ( LINE_GATHERDIGITS, LINE_GENERATE, LINE_MONITORDIGITSLINE_MONITORTONE), a fim de determinar o 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 ao provedor de serviços que gera o evento para que o carimbo de data/hora sintetizado seja o mais preciso possível.

Requisitos

Requisito Valor
Versão do TAPI
Requer TAPI 2.0 ou posterior
Cabeçalho
Tapi.h

Confira também

LINE_GATHERDIGITS

LINE_GENERATE

LINE_MONITORDIGITS

LINEMONITORTONE

lineMonitorTones