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 |
|