Ler em inglês

Partilhar via

Mensagens TSPI

  • Artigo

Esta seção contém uma lista das mensagens na TSPI (Telephony Service Provider Interface). Essas mensagens são usadas para notificar a TAPI da ocorrência de eventos assíncronos que ocorrem espontaneamente dentro do provedor de serviços. O provedor de serviços passa esses eventos para a TAPI chamando umLINEEVENTou função de retorno de chamada PHONEEVENT, dependendo se o provedor de serviços está relatando um evento em uma linha, chamada ou dispositivo telefônico. O procedimento de LINEEVENT para relatar eventos que ocorrem em uma linha ou chamada é fornecido ao provedor de serviços no momento em que a linha é aberta com a função TSPI_lineOpen. O procedimento de PHONEEVENT para relatar eventos que ocorrem em um telefone é fornecido com a função TSPI_phoneOpen.

Estes eventos espontâneos não são solicitados pela TAPI no sentido de que não são uma resposta direta a qualquer pedido. Estes acontecimentos contrastam com os que comunicam a conclusão dos pedidos apresentados pela TAPI. Esses eventos de conclusão são relatados através da função de retorno de chamada ASYNC_COMPLETION.

Os perfis de parâmetros para os procedimentos de evento espontâneo incluem parâmetros que identificam o objeto relevante para o qual o evento está sendo relatado (telefone, linha ou chamada). A identificação assume a forma de um identificador opaco cuja interpretação exata não é publicada pela TSPI. A TAPI determina internamente a relação entre esses identificadores opacos e quaisquer estruturas de dados usadas para representar os dispositivos.

O perfil de parâmetros para procedimentos de eventos espontâneos também inclui um parâmetro de mensagem que identifica o tipo da mensagem. Cada tipo de mensagem tem uma definição correspondente que determina os identificadores que são incluídos, juntamente com outros parâmetros e seus significados. Existe uma correspondência muito forte entre as mensagens que aparecem ao nível do TSPI e as que aparecem ao nível do TAPI. Estas são as regras gerais de correspondência:

  • O conjunto de mensagens é quase idêntico. Onde as mensagens correspondem, o mesmo nome e valor da mensagem é usado no nível TSPI.
  • As alças que aparecem no nível TSPI são os tipos opacos definidos pela especificação TSPI. Esses tipos (e sua interpretação) diferem daqueles no nível TAPI, embora se refiram à mesma classe de dispositivo. Por exemplo, quando uma mensagem TAPI inclui um identificador HLINE, a mensagem TSPI correspondente normalmente incluiria um identificador deHTAPILINE.
  • Não há nenhum dwCallbackInstance dados passados para o retorno de chamada.
  • Os parâmetros dwParam1, dwParam2e dwParam3 são geralmente idênticos aos parâmetros correspondentes para a mensagem TAPI.
  • As mensagens orientadas para linha e chamadas são passadas para um procedimento de retorno de chamada diferente das mensagens orientadas por telefone.

Para cada mensagem, esta seção lista os seguintes itens:

  • O objetivo da mensagem
  • O procedimento de retorno de chamada para o qual esta mensagem é passada
  • Uma descrição dos parâmetros da mensagem
  • Comentários opcionais sobre o uso da mensagem
  • Referências opcionais a outras funções, mensagens e estruturas de dados
  • Comentários opcionais comparando esta mensagem com a interface TAPI

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

Quando ocorre um evento, uma mensagem pode ou não ser enviada para a TAPI. Para alguns tipos de evento, como alterações de status, a TAPI especifica um conjunto de alterações de status nas quais está interessada. O provedor de serviços é aconselhado a limitar os eventos de mensagem de alteração de status que relata aos incluídos neste conjunto. O prestador de serviços não é obrigado a respeitar este limite. Por outras palavras, pode comunicar mais alterações do que as estritamente necessárias. No entanto, deve tentar observar o limite por razões de desempenho.

A mensagem LINE_REPLY não é usada no nível TSPI. A conclusão de uma solicitação assíncrona é relatada usando o retorno de chamada ASYNC_COMPLETION.

A mensagem PHONE_REPLY não é usada no nível TSPI. A conclusão de uma solicitação assíncrona é relatada usando o retorno de chamada ASYNC_COMPLETION.

Para obter mais informações, consulte os seguintes tópicos: