Notification d’événement
La notification d’événement est le moyen principal par lequel une application obtient des informations à partir de TAPI et des fournisseurs de services. Ces informations peuvent être l’état d’une opération asynchrone déclenchée par l’application ou peuvent concerner un processus qui a démarré en dehors de l’application, comme les notifications de nouveaux appels entrants.
TAPI 2.x : Applications gèrent la notification de l’une des trois manières suivantes : fenêtre masquée, handle d’événement ou port d’achèvement. Pour plus d’informations sur ces mécanismes de notification, consultez la section Remarques pour lineInitializeEx. Une application spécifie le mécanisme en définissant le membre dwOptions de la structure LINEINITIALIZEEXPARAMS avant d’appeler lineInitializeEx.
La fonction lineSetStatusMessages permet à une application de spécifier les messages de notification à recevoir pour les événements liés aux modifications d’état de la ligne spécifiée ou de l’une de ses adresses.
TAPI 3.x : Applications gèrent les notifications générales à l’aide d’objets com standard connectables. ITTAPIEventNotification est l’interface sortante qui doit être inscrite auprès de l’objet conteneur de TAPI, et ITTAPIEventNotification ::Event est la méthode TAPI appelle pour déterminer la réponse de l’application. La méthode ITTAPI ::p ut_EventFilter indique à TAPI quels événements sont intéressants pour l’application. Si aucun filtre d’événement n’est entré, l’application ne reçoit aucune notification d’événements. La méthode ITTAPI ::RegisterCallNotifications indique à TAPI les types et adresses multimédias pour lesquels l’application gère les sessions entrantes. Pour plus d’informations sur la gestion des événements TAPI 3, consultez la vue d’ensemble des événements ou l’exemple de code Inscrire des événements.
Les fournisseurs de services de téléphonie implémentent TSPI_lineSetDefaultMediaDetection et TSPI_lineSetStatusMessages. TAPI appelle ces fonctions pour indiquer l’ensemble de tous les événements de type ligne, adresse et média demandés par les applications.