Compartilhar via

Mensagens TSPI

Esta seção contém uma lista das mensagens na TSPI (Interface do Provedor de Serviços de Telefonia). Essas mensagens são usadas para notificar o TAPI sobre a ocorrência de eventos assíncronos que ocorrem espontaneamente dentro do provedor de serviços. O provedor de serviços passa esses eventos para TAPI chamando um LINEEVENT ou função de retorno de chamada PHONEEVENT, dependendo se o provedor de serviços está relatando um evento em um dispositivo de linha, chamada ou telefone. O procedimento 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 PHONEEVENT para relatar eventos que ocorrem em um telefone é fornecido com a função TSPI_phoneOpen.

Esses eventos espontâneos não são solicitados pela TAPI no sentido de que não são uma resposta direta a nenhuma solicitação. Esses eventos contrastam com os relatórios de conclusão de solicitações feitas pelo TAPI. Esses eventos de conclusão são relatados por meio da função de retorno de chamada ASYNC_COMPLETION.

Os perfis de parâmetro 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 está na forma de um identificador opaco cuja interpretação exata não é publicada pelo TSPI. O TAPI determina internamente a relação entre essas alças opacas e quaisquer estruturas de dados usadas para representar os dispositivos.

O perfil de parâmetro 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 incluídos, juntamente com outros parâmetros e seus significados. Há uma correspondência muito forte entre as mensagens que aparecem no nível do TSPI e as que aparecem no nível do TAPI. Estas são as regras gerais de correspondência:

  • O conjunto de mensagens é quase idêntico. Quando as mensagens correspondem, o mesmo nome e valor da mensagem é usado no nível de TSPI.
  • Os identificadores que aparecem no nível de TSPI são os tipos opacos definidos pela especificação de TSPI. Esses tipos (e sua interpretação) diferem daqueles no nível tapi, embora se refiram à mesma classe de dispositivo. Por exemplo, em que uma mensagem TAPI inclui um identificador HLINE, a mensagem TSPI correspondente normalmente incluiria um identificador deHTAPILINE.
  • Não há dwCallbackInstance dados passados para o retorno de chamada.
  • Os parâmetros dwParam1, dwParam2e dwParam3 geralmente são idênticos aos parâmetros correspondentes da mensagem TAPI.
  • Mensagens orientadas a linhas e orientadas a 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:

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

Determinadas mensagens são usadas para notificar o 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. O TAPI pode, posteriormente, chamar uma função apropriada de "obter status" do objeto para obter o status completo do objeto.

Quando um evento ocorre, uma mensagem pode ou não ser enviada para TAPI. Para alguns tipos de evento, como alterações de status, o TAPI especifica um conjunto de alterações de status no qual ele está interessado. O provedor de serviços é aconselhado a limitar os eventos de mensagem de alteração de status que ele relata aos incluídos neste conjunto. O provedor de serviços não é necessário para seguir esse limite. Em outras palavras, ele pode relatar mais alterações do que são estritamente necessárias. No entanto, ele deve tentar observar o limite por motivos de desempenho.

A mensagem LINE_REPLY não é usada no nível de 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 de 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:

 

 

  • Last updated on