Classes d’appareils TAPI

Une classe d’appareil est un groupe d’appareils physiques ou de pilotes de périphériques 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 de façon 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 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 fonctionlineGetIDou 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 classes d’appareil avec les fonctionslineConfigDialoget 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 options de configuration pour l’appareil donné.

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

Des classes d’appareil supplémentaires et des noms de classes d’appareil peuvent être disponibles sur un système donné. En règle générale, si un appareil n’appartient pas à l’une des classes d’appareil 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 même si la classe d’appareil et le type de média sont associés, ils ne sont pas identiques. 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 règle générale, vous utilisez lineGetDevConfig pour enregistrer une copie des données de configuration d’appareil actuelles, puis utilisez ultérieurement 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.