Partilhar via


Mensagens TAPI

As mensagens são usadas para notificar o aplicativo de eventos assíncronos. Todas essas mensagens são enviadas para o aplicativo através do mecanismo de notificação de mensagem que o aplicativo especificado em lineInitializeEx.

A mensagem sempre contém um identificador para o objeto relevante (telefone, linha ou chamada), que o aplicativo pode usar para determinar o tipo de mensagem.

Certas mensagens são usadas para notificar o aplicativo sobre uma alteração no status de um objeto. Essas mensagens fornecem o identificador de objeto e dão uma indicação de qual item de status foi alterado. O aplicativo pode chamar a função apropriada "get status" do objeto para obter o status completo do objeto.

Quando ocorre um evento, as mensagens podem ser enviadas para zero, um ou mais aplicativos. Os aplicativos de destino para uma mensagem são determinados por vários fatores diferentes, incluindo o significado da mensagem, o privilégio do aplicativo para o objeto, se o aplicativo iniciou ou não a solicitação para a qual a mensagem é um resultado direto e o mascaramento de mensagem que foi definido pelo aplicativo. Observe os seguintes pontos sobre mensagens:

  • As mensagens de resposta assíncronas são enviadas apenas para o aplicativo que originou a solicitação e não podem ser mascaradas.
  • As mensagens que sinalizam a conclusão da geração de dígitos ou tons ou a coleta de dígitos são enviadas apenas para o aplicativo que solicitou a geração de dígitos ou tons.
  • As mensagens que indicam alterações no estado da linha ou do endereço são enviadas para todos os aplicativos que abriram a linha, desde que a mensagem tenha sido habilitada por meio lineSetStatusMessages.
  • As mensagens que indicam o estado da chamada e as alterações nas informações da chamada são enviadas para todos os aplicativos que têm um identificador para a chamada.
  • As mensagens que sinalizam uma deteção de dígitos, deteção de tom ou deteção de tipo de mídia são enviadas para os aplicativos que solicitaram o monitoramento desse evento.

Esta seção contém as informações de referência para as seguintes mensagens TAPI: