Compartilhar via

Controle de dispositivo (API de telefonia)

  • Artigo

O controle de dispositivo no nível do aplicativo do usuário final ou do servidor requer um conjunto relativamente pequeno de informações básicas. A camada de abstração do provedor de serviços executa um controle de dispositivo detalhado. Os provedores de serviços relatam as informações necessárias do dispositivo para um aplicativo por meio do TAPI.

As principais categorias de dispositivo incluem:

  • Network: a camada de transporte para comunicações. Do ponto de vista de um aplicativo, as informações sobre a rede normalmente são inseridas no tipo de endereço, como LINEADDRESSTYPE_PHONENUMBER.
  • Line: uma conexão com uma rede. Esse conceito é muito usado no TAPI 2.2 (TAPI/C).
  • Channel: uma subdivisão de uma linha. Normalmente, o conhecimento dos canais não é necessário para um aplicativo porque o provedor de serviços configura como eles aparecerão como endereços.
  • Endereço: um local de rede em uma rede. Cada linha ou canal tem um ou mais endereços associados. O endereço é um conceito chave no TAPI 3.1 (TAPI/COM) e NO TAPI 2.2 (TAPI/C).
  • Terminal: um renderizador ou de origem para um determinado tipo de mídia e endereço.

Os provedores de serviços relatam características do dispositivo para TAPI em resposta a consultas de aplicativo. Os provedores de serviços também iniciam relatórios sobre alterações no estado do dispositivo. Essas alterações são relatadas a um aplicativo com base nas notificações solicitadas durante a inicialização.

As características básicas do dispositivo são:

Além disso, os provedores de serviço fornecem informações sobre a capacidade de um determinado endereço para executar várias operações de sessão.

As características complementares poderão ser associadas a determinados dispositivos, se os provedores de serviços derem suporte a eles. Um aplicativo TAPI 2.x descobre funcionalidades usando as funçõeslineGetDevCapse lineGetAddressCaps. Os aplicativos TAPI 3.x usam a interface ITAddressCapabilities para essa finalidade.

O TAPI 2.x fornece um conjunto especial de operações complementares que o provedor de serviços pode implementar para uso com dispositivos de telefone. Consulte dispositivos telefônicos.

Os recursos estendidos são específicos do provedor e não são cobertos diretamente pela API de Telefonia da Microsoft. Consulte de funções de linha estendida, de funções telefônicas de telefonia estendida ou interfaces de Provider-Specific.

Veja abaixo um resumo das operações TAPI que consultam provedores de serviços nas características do dispositivo e fornecem dados sobre o estado atual.

Funções TAPI 2.x Descrição
lineGetDevCaps Consulta um dispositivo de linha especificado para determinar os recursos de telefonia dos endereços associados.
lineGetAddressCaps Consulta um dispositivo de linha especificado para determinar os recursos de telefonia de um endereço específico.
lineGetDevConfig Retorna uma estrutura de dados "opaca" que armazena a configuração atual de um dispositivo.
lineSetDevConfig Restaura a configuração do dispositivo.
lineConfigDialog Exibir uma caixa de diálogo que permite ao usuário configurar parâmetros relacionados ao dispositivo.
lineGetID Recupera um identificador de dispositivo estável que pode ser usado em outras chamadas de função TAPI ou com uma API diferente.
lineGetLineDevStatus Consulta o dispositivo para o status atual, como o número de chamadas ativas.
lineSetLineDevStatus Define o status do dispositivo, como definir um dispositivo como não em serviço.
lineGetIcon Recupera o ícone específico do provedor para exibição ao usuário.
lineNegotiateExtVersion Permite que um aplicativo negocie uma versão de extensão a ser usada com o dispositivo de linha especificado.
lineDevSpecific Fornece acesso a recursos específicos do dispositivo.
lineDevSpecificFeature Envia recursos específicos do dispositivo para o provedor de serviços.

 

Interfaces ou métodos TAPI 3.x Descrição
ITAddressCapabilities Obtém informações sobre os recursos de um endereço.
ITAMMediaFormat Define e obtém o formato de mídia do DirectShow™.
ITBasicAudioTerminal Define e obtém características de terminal de áudio padrão, como volume.
ITMediaSupport Obtém informações sobre os recursos de suporte de mídia de um endereço.
ITTerminal Interface base para o objeto Terminal. Obtém informações como classe de terminal e mídia com suporte.
ITTerminalSupport Obtém informações sobre terminais disponíveis e cria terminais adicionais.
interfaces Provider-Specific Dependente do provedor de serviços.