Initialisation et arrêt

Pour qu’une application utilise l’une des 30 fonctions téléphoniques supplémentaires de TAPI, elle a besoin d’une connexion à TAPI, via laquelle elle peut recevoir des messages. L’application établit cette connexion à l’aide de la fonction phoneInitializeEx. Dans cette fonction, l’application spécifie le mécanisme de notification par lequel TAPI informe l’application des modifications apportées à l’état du téléphone et de l’achèvement asynchrone des fonctions téléphoniques.

La fonction phoneInitializeEx retourne deux informations à l’application : une application gèreet le nombre d’appareils téléphoniques. Le handle d’application représente l’utilisation de l’application TAPI. Les fonctions TAPI qui utilisent des handles téléphoniques ne nécessitent pas le handle d’application, car ce handle est dérivé du handle de téléphone spécifié.

Le deuxième élément d’informations retourné par phoneInitializeEx correspond au nombre d’appareils téléphoniques disponibles pour TAPI. Les appareils téléphoniques sont identifiés par leur identificateur d’appareil (ID d’appareil). Les identificateurs d’appareil valides vont de zéro au nombre d’appareils téléphoniques moins un. Par exemple, si phoneInitializeEx signale qu’il existe deux appareils téléphoniques dans un système, les identificateurs d’appareils téléphoniques valides sont 0 et 1. Une fois qu’une application a fini d’utiliser les fonctions téléphoniques de TAPI, elle appelle phoneShutdown, en passant son handle d’application pour arrêter son utilisation de TAPI. Cela permet à TAPI de libérer toutes les ressources affectées à l’application.

Les applications ne doivent pas appeler phoneInitializeEx sans ouvrir par la suite un téléphone (au moins pour la surveillance). Si l’application ne surveille pas et n’utilise aucun appareil, elle doit appeler phoneShutdown afin que les ressources de mémoire allouées par la bibliothèque de liens dynamiques TAPI puissent être libérées si inutiles, et la bibliothèque elle-même peut être déchargée à partir de la mémoire, tout en n’étant pas nécessaire.

Les deux phoneInitializeEx et phoneShutdown fonctionnent de manière synchrone. Autrement dit, ces fonctions retournent une indication de réussite ou d’échec, et ne retournent jamais un identificateur de requête asynchrone.