Classes d’appareils TAPI

Une classe d’appareil est un groupe d’appareils physiques ou de pilotes de périphérique associés via lesquels 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 la classe de manière unique 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 TAPI (Telephony Application Programming Interface) associe les appareils d’une ou de plusieurs classes d’appareils à chaque ligne ou appareil téléphonique. 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 spécifique dont vous avez besoin pour 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 classes d’appareils 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 représentant l’appareil donné, et avec les fonctions lineGetDevConfig et lineSetDevConfig pour récupérer et définir directement les options de configuration pour l’appareil donné.

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

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).
vague/sortie	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/out	Séquenceur MIDI (sortie uniquement).
tapi/line	Appareil de ligne.
tapi/phone	Appareil téléphonique.
Ndis	Périphérique réseau.
tapi/terminal	Terminal.

 

Notes

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

 

Des classes d’appareils et des noms de classes d’appareils supplémentaires 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 attribue un nom de classe d’appareil unique. Consultez la documentation de l’appareil pour déterminer quelles classes d’appareils supplémentaires sont disponibles pour celui-ci. 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. Ainsi, 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 actuelles de l’appareil, puis vous utilisez plus tard 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 à la restaurer manuellement à l’état précédent. Étant donné que le format exact des données de configuration d’appareil peut être différent pour 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 à des fins d’information.