Contrôle de version TAPI

Au fil du temps, différentes versions de TAPI, d’applications et de fournisseurs de services peuvent être produites. Ces nouvelles versions peuvent créer de nouvelles définitions, comme pour les nouvelles fonctionnalités, les nouveaux membres dans les structures de données et les nouveaux champs de bits. Les numéros de version sont donc nécessaires pour indiquer comment interpréter différentes structures de données.

Pour permettre une interopérabilité optimale des différentes versions d’applications, des versions de TAPI proprement dites et des versions de fournisseurs de services par différents fournisseurs, Microsoft Telephony fournit un mécanisme de négociation de version simple pour les applications. Il existe deux versions différentes que TAPI et le fournisseur de services de téléphonie doivent convenir pour chaque appareil de ligne. La première est la version négociée avec TAPI et le fournisseur de services de téléphonie (TSP) Téléphonie de base et complémentaire, appelée version de l’interface TAPI. L’autre concerne les extensions spécifiques au fournisseur, le cas échéant, et est appelée version de l’extension. Le format des structures de données et des types de données utilisés par les fonctionnalités De base et Supplémentaire de TAPI est défini par la version TAPI, tandis que la version de l’extension détermine le format des structures de données définies par les extensions spécifiques au fournisseur.

La fonction lineNegotiateAPIVersion négocie une version TAPI et lineNegotiateExtVersion négocie la version de l’extension TSP. Un fournisseur de services partagés unique peut être capable de gérer plusieurs versions, et une application doit « revenir » à l’utilisation d’une version antérieure si elle utilise un fournisseur de services partagés plus ancien. Dans lineNegotiateAPIVersion , le paramètre dwApiVersion prend par défaut une valeur en fonction de la version, comme suit.

Version TAPI	Valeur par défaut
1.3	0x00010003
1.4	0x00010004
2.0	0x00020000
2.1	0x00020001
2.2	0x00020002

 

Toutefois, TAPI rend cela beaucoup plus facile tant que le fournisseur de services TSP lui-même utilise une version plus récente que l’application. Si le fournisseur de services TSP est effectivement plus récent, TAPI est capable de traduire « down » en version de l’application. Par exemple, les TSP TAPI 2.0 n’ont pas besoin d’être spécifiquement capables de traiter TAPI version 1.4. Si une application TAPI 1.4 est exécutée, TAPI convertit toutes les structures et messages TAPI 2.0 en équivalents TAPI 1.4, ou aussi près que possible. S’il n’existe aucune approximation étroite dans TAPI 1.4, toutes les informations spécifiques à TAPI 2.0 seront perdues.

La signification précise d’une version d’extension est spécifique au fournisseur. Pour utiliser un fournisseur de services partagés qui prend en charge les extensions, consultez la documentation du fournisseur.

Il existe un certain nombre de versions de TAPI. Bien que la plupart de ces versions impliquent des modifications apportées aux ensembles de documentation TAPI et TSPI (Téléphonie Service Provider Interface), il existe d’autres implications pour chaque version, notamment les différences architecturales, les variations du système d’exploitation, les redistribuables et les problèmes de développement TSP.

Version TAPI	Distribution
1.0 – 1.2	Versions bêta qui ne doivent plus être utilisées.
1.4	Inclus dans Windows 95.
1.5	Inclus dans Windows CE 1.0.
2.0	Inclus dans Windows NT 4.0 avec SP3.
2.1	Inclus dans Windows NT 4.0 avec SP4 et Windows 98.
2.2	Inclus dans Windows Server 2003, Windows XP et Windows 2000.