Classes d’appareils TSPI
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 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é.
Voici les noms de classe d’appareil par défaut.
| 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 | Périphérique de ligne |
| tapi/phone | Appareil téléphonique |
| Ndis | Appareil réseau |
| tapi/terminal | Appareil terminal |
Ces noms ne respectant pas la casse, vous pouvez donc 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. Vous devez case activée la documentation de l’appareil afin de 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 un format d’informations sur un 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 peut ne pas être 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, n’utilisez pas lineSetDevConfig et lineGetDevConfig pour manipuler directement les données de configuration de l’appareil. Certains formats sont fournis à des fins d’information uniquement.