Partilhar via

Controle de Dispositivo (API de Telefonia)

  • Artigo

O controle do 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:

  • Rede: 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.
  • Linha: uma conexão com uma rede. Esse conceito é muito usado no TAPI 2.2 (TAPI/C).
  • Canal: uma subdivisão de uma linha. Normalmente, o conhecimento de 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 fundamental no TAPI 3.1 (TAPI/COM) e no TAPI 2.2 (TAPI/C).
  • Terminal: uma origem ou renderizador para um determinado endereço e tipo de mídia.

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 entã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ços fornecem informações sobre a capacidade de um determinado endereço para executar várias operações de sessão.

Características complementares podem estar associadas a determinados dispositivos, se os provedores de serviços derem suporte a eles. Um aplicativo TAPI 2.x descobre recursos usando as funções lineGetDevCaps e 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 de Telefone.

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

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 que o usuário configure 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 status atuais, como o número de chamadas ativas.
lineSetLineDevStatus Define 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 directShow™.
ITBasicAudioTerminal Define e obtém características padrão do terminal de áudio, 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 específicas do provedor Dependente do provedor de serviços.