Classes de dispositivo TAPI

Uma classe de dispositivo é um grupo de dispositivos físicos ou drivers de dispositivo relacionados por meio dos quais os aplicativos enviam e recebem as informações ou dados que compõem uma chamada. Cada classe de dispositivo tem um nome de classe de dispositivo que identifica exclusivamente a classe e fornece informações sobre a interface de programação e comandos que podem ser usados para abrir e se comunicar com os dispositivos na classe .

A TAPI (Interface de Programação de Aplicativo de Telefonia) associa dispositivos de uma ou mais classes de dispositivo a cada dispositivo de linha ou telefone. Você acessa um desses dispositivos recuperando o identificador de dispositivo para o dispositivo usando a função lineGetID ou phoneGetID . Você fornece o nome da classe do dispositivo e a função retorna o nome da porta específico, o nome do dispositivo, o identificador do dispositivo ou o identificador do dispositivo que você precisa para abrir e acessar o dispositivo. O formato das informações retornadas depende da classe de dispositivo e é descrito nos tópicos subsequentes desta seção.

Você também usa nomes de classe de dispositivo com as funções lineConfigDialog e phoneConfigDialog para permitir que o usuário defina opções de configuração para o dispositivo especificado, com as funções lineGetIcon e phoneGetIcon para recuperar um ícone para representar o dispositivo especificado e com as funções lineGetDevConfig e lineSetDevConfig para recuperar e definir diretamente as opções de configuração para o dispositivo especificado.

A lista a seguir mostra nomes de classe de dispositivo.

Nome da classe do dispositivo	Descrição
Comunicação	Porta de comunicações.
comm/datamodem	Modem por meio de uma porta de comunicação.
comm/datamodem/portname	Nome do dispositivo ao qual um modem está conectado.
wave/in	Dispositivo de áudio wave (somente entrada).
onda/saída	Dispositivo de áudio wave (somente saída).
wave/in/out	Dispositivo de áudio wave, duplex completo.
midi/in	Sequenciador MIDI (somente entrada).
midi/out	Sequenciador MIDI (somente saída).
tapi/line	Dispositivo de linha.
tapi/phone	Dispositivo de telefone.
Ndis	Dispositivo de rede.
tapi/terminal	Dispositivo de terminal.

 

Observação

Esses nomes não diferenciam maiúsculas de minúsculas; você pode usar qualquer combinação de letras maiúsculas e minúsculas.

 

Classes de dispositivo adicionais e nomes de classe de dispositivo podem estar disponíveis em um determinado sistema. Em geral, se um dispositivo não pertencer a uma das classes de dispositivo padrão, o fabricante normalmente define uma nova classe de dispositivo e atribui um nome de classe de dispositivo exclusivo. Verifique a documentação do dispositivo para determinar quais classes de dispositivo adicionais estão disponíveis para ele. No entanto, observe que, embora a classe de dispositivo e o tipo de mídia estejam relacionados, eles não são os mesmos. Um tipo de mídia descreve o formato de informações de chamada e uma classe de dispositivo define a interface de programação usada para gerenciar essas informações. Portanto, mesmo que um fabricante defina um novo tipo de mídia, não é necessariamente verdade que o fabricante também precisa definir uma nova classe de dispositivo para dar suporte ao modo.

O formato dos dados de configuração usados com as funções lineSetDevConfig e lineGetDevConfig também depende da classe de dispositivo. Em geral, você usa lineGetDevConfig para salvar uma cópia dos dados atuais de configuração do dispositivo e, posteriormente, usar lineSetDevConfig com os dados de configuração salvos para restaurar a configuração do dispositivo para o estado anterior. Essa é uma maneira conveniente de alterar temporariamente a configuração sem exigir que o usuário a restaure manualmente para o estado anterior. Como o formato exato dos dados de configuração do dispositivo pode ser diferente com cada provedor de serviços, você não deve usar lineSetDevConfig e lineGetDevConfig para manipular os dados de configuração do dispositivo diretamente. Alguns formatos são fornecidos apenas para obter informações.