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.