Mensagem LINE_GENERATE
A mensagem LINE_GENERATE da TAPI é enviada para notificar o aplicativo de que a geração atual de dígitos ou tons foi encerrada. Apenas uma solicitação de geração desse tipo pode estar em andamento em uma determinada chamada a qualquer momento. Essa mensagem também é enviada quando a geração de dígito ou tom é cancelada.
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 geração de dígitos ou tons foi encerrada. Esse parâmetro deve ser uma e apenas uma das constantes LINEGENERATETERM_.
-
Dwparam2
-
Não utilizado.
-
dwParam3
-
A "contagem de tiques" (número de milissegundos desde que o Windows foi iniciado) na qual a geração de dígitos ou tons foi concluída. 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_GENERATE é enviada apenas para o aplicativo que solicitou a geração de dígito ou tom.
Como o carimbo de data/hora especificado por dwParam3 pode ter sido gerado em um computador diferente do que o aplicativo está executando, ele é útil apenas para comparação com outras mensagens com carimbo de data/hora geradas no mesmo dispositivo de linha (LINE_GATHERDIGITS, LINE_MONITORDIGITS, LINE_MONITORMEDIA, LINE_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 |
|