Classes d’appareils TAPI

Une classe de périphérique est un groupe d’appareils physiques ou de pilotes de périphériques associés par le biais duquel les applications envoient et reçoivent les informations ou les données qui composent un appel. Chaque classe d’appareil a un nom de classe d’appareil qui identifie de manière unique la classe et fournit des informations sur l’interface de programmation et les commandes qui peuvent être utilisées pour ouvrir et communiquer avec les appareils de la classe.

L’interface de programmation d’applications de téléphonie (TAPI) associe des appareils d’une ou de plusieurs classes d’appareils à chaque appareil de ligne ou de téléphone. Vous accédez à l’un de ces appareils en récupérant l’identificateur de l’appareil à l’aide de la fonction lineGetID ou phoneGetID . Vous fournissez le nom de la classe d’appareil et la fonction retourne le nom de port, le nom de l’appareil, le handle d’appareil ou l’identificateur d’appareil que vous devez ouvrir et accéder à l’appareil. Le format des informations retournées dépend de la classe d’appareil et est décrit dans les rubriques suivantes de cette section.

Vous utilisez également des noms de classe d’appareil avec les fonctions lineConfigDialog et phoneConfigDialog pour permettre à l’utilisateur de définir des options de configuration pour l’appareil donné, avec les fonctions lineGetIcon et phoneGetIcon pour récupérer une icône pour représenter l’appareil donné, et avec les fonctions lineGetDevConfig et lineSetDevConfig pour récupérer et définir directement les options de configuration de l’appareil donné.

La liste suivante affiche les noms des classes d’appareil.

Nom de la classe d’appareil Description
Comm Port de communication.
comm/datamodem Modem via un port de communication.
comm/datamodem/portname Nom de l’appareil auquel un modem est connecté.
wave/in Périphérique audio wave (entrée uniquement).
wave/out Périphérique audio wave (sortie uniquement).
wave/in/out Appareil audio wave, duplex intégral.
midi/in Séquenceur MIDI (entrée uniquement).
midi/sortie Séquenceur MIDI (sortie uniquement).
tapi/line Appareil de ligne.
tapi/phone Téléphone appareil.
Ndis Périphérique réseau.
tapi/terminal Appareil terminal.

 

Remarque

Ces noms ne respectent pas la casse ; vous pouvez utiliser n’importe quelle combinaison de lettres majuscules et minuscules.

 

Des classes d’appareil supplémentaires et des noms de classe d’appareil peuvent être disponibles sur un système donné. En général, si un appareil n’appartient pas à l’une des classes d’appareils par défaut, le fabricant définit généralement une nouvelle classe d’appareil et affecte un nom de classe d’appareil unique. Consultez la documentation de l’appareil pour déterminer les classes d’appareils supplémentaires disponibles. Notez toutefois que bien que la classe d’appareil et le type de média soient liés, ils ne sont pas les mêmes. Un type de média décrit le format des informations d’appel et une classe d’appareil définit l’interface de programmation utilisée pour gérer ces informations. Par conséquent, même si un fabricant définit un nouveau type de média, il n’est pas nécessairement vrai que le fabricant doit également définir une nouvelle classe d’appareil pour prendre en charge le mode.

Le format des données de configuration utilisées avec les fonctions lineSetDevConfig et lineGetDevConfig dépend également de la classe d’appareil. En général, vous utilisez lineGetDevConfig pour enregistrer une copie des données de configuration d’appareil actuelles, puis utilisez lineSetDevConfig avec les données de configuration enregistrées pour restaurer la configuration de l’appareil à l’état précédent. Il s’agit d’un moyen pratique de modifier temporairement la configuration sans obliger l’utilisateur à le restaurer manuellement à l’état précédent. Étant donné que le format exact des données de configuration d’appareil peut être différent avec chaque fournisseur de services, vous ne devez pas utiliser lineSetDevConfig et lineGetDevConfig pour manipuler directement les données de configuration de l’appareil. Certains formats sont fournis uniquement pour des informations.