Classes de dispositivo TAPI

Uma classe de dispositivo é um grupo de dispositivos físicos relacionados ou drivers de dispositivo através 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 os comandos que podem ser usados para abrir e se comunicar com os dispositivos na classe.

A TAPI (Telephony Application Programming Interface) associa dispositivos de uma ou mais classes de dispositivos a cada linha ou dispositivo telefônico. Você acessa um desses dispositivos recuperando o identificador de dispositivo para o dispositivo usando o lineGetID ou função phoneGetID. Você fornece o nome da classe do dispositivo e a função retorna o nome da porta específica, 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 do dispositivo e é descrito nos tópicos subsequentes desta seção.

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

A lista a seguir mostra nomes de classes de dispositivos.

Nome da classe do dispositivo	Descrição
comunicação	Porta de comunicações.
comm/datamodem	Modem através de uma porta de comunicação.
comm/datamodem/portname	Nome do dispositivo ao qual um modem está conectado.
onda/em	Dispositivo de áudio Wave (apenas entrada).
wave/out	Dispositivo de áudio Wave (apenas saída).
de onda/entrada/saída	Dispositivo de áudio Wave, full duplex.
midi/in	Sequenciador MIDI (apenas entrada).
midi/out	Sequenciador MIDI (apenas saída).
tapi/linha	Dispositivo de linha.
tapi/telefone	Dispositivo telefónico.
ndis	Dispositivo de rede.
TAPI/Terminal	Dispositivo terminal.

 

Observação

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

 

Classes de dispositivos adicionais e nomes de classes de dispositivos 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 do 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. Assim, 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 suportar o modo.

O formato dos dados de configuração usados com o lineSetDevConfig e funções de lineGetDevConfig também depende da classe do dispositivo. Em geral, você usa lineGetDevConfig para salvar uma cópia dos dados de configuração do dispositivo atual e, posteriormente, usar lineSetDevConfig com os dados de configuração salvos para restaurar a configuração do dispositivo para o estado anterior. Esta é 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 informação.