Notification d'événement

La notification d’événement est le principal moyen par lequel une application obtient des informations à partir de TAPI et des fournisseurs de services. Ces informations peuvent être les status d’une opération asynchrone initiée par l’application ou concerner un processus qui a démarré en dehors de l’application, comme les notifications de nouveaux appels entrants.

TAPI 2.x : Les 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 à status modifications pour la ligne spécifiée ou l’une de ses adresses.

TAPI 3.x : Les applications gèrent les notifications générales à l’aide d’objets connectables com standard. ITTAPIEventNotification est l’interface sortante qui doit être inscrite auprès de l’objet conteneur de TAPI, et ITTAPIEventNotification::Event est la méthode appelée TAPI pour déterminer la réponse de l’application. La méthode ITTAPI::p ut_EventFilter indique à TAPI quels événements intéressent 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 de médias et les adresses pour lesquels l’application gérera les sessions entrantes. Pour plus d’informations sur la gestion des événements TAPI 3, consultez vue d’ensemble des événements ou l’exemple de code Inscrire les événements .

Les fournisseurs de services de téléphonie implémentent des TSPI_lineSetDefaultMediaDetection et des TSPI_lineSetStatusMessages. TAPI appelle ces fonctions pour indiquer l’ensemble de tous les événements de ligne, d’adresse et de type multimédia demandés par les applications.