Partilhar via


Controle de dispositivos (API de telefonia)

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

As principais categorias de dispositivos 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 incorporadas no tipo de endereço, como LINEADDRESSTYPE_PHONENUMBER.
  • Linha: Uma conexão com uma rede. Este conceito é muito utilizado na TAPI 2.2 (TAPI/C).
  • Canal: Uma subdivisão de uma linha. O conhecimento dos canais normalmente não é exigido de 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 tanto na TAPI 3.1 (TAPI/COM) como na TAPI 2.2 (TAPI/C).
  • Terminal: Uma fonte ou renderizador para um determinado endereço e tipo de mídia.

Os provedores de serviços relatam as características do dispositivo à TAPI em resposta a consultas de aplicativos. 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 prestadores de serviços fornecem informações sobre a capacidade de um determinado endereço para realizar várias operações de sessão.

Características suplementares podem ser associadas a determinados dispositivos, se os prestadores de serviços os suportarem. Um aplicativo TAPI 2.x descobre recursos usando olineGetDevCaps e funções lineGetAddressCaps. Os aplicativos TAPI 3.x usam a interfaceITAddressCapabilities para essa finalidade.

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

Os recursos estendidos são específicos do provedor e não são diretamente cobertos pela API de telefonia da Microsoft. Consulte Extended Line Functions, Extended Telephony Phone Functionsou Provider-Specific Interfaces.

Abaixo está um resumo das operações TAPI que consultam provedores de serviços sobre as 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 Exiba 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 para usar com o dispositivo de linha especificado.
lineDevSpecific Dá 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 suportada.
ITTerminalSupport Obtém informações sobre os terminais disponíveis e cria terminais adicionais.
Provider-Specific Interfaces Dependente do prestador de serviços.