Classes de dispositivo TSPI

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 nesta 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 fornecido; 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 seguir estão os nomes de classe de dispositivo padrão.

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

 

Esses nomes não diferenciam maiúsculas de minúsculas, portanto, 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. Você deve marcar 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 um formato de informações em uma 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, pode não ser verdade que o fabricante também deve 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, não use lineSetDevConfig e lineGetDevConfig para manipular os dados de configuração do dispositivo diretamente. Alguns formatos são fornecidos apenas para informações.