Événements (API téléphonie)

Les événements sont une partie cruciale de la gestion des appels sous TAPI 3. La gestion des événements comprend quatre phases.

Pour s’inscrire et activer la réception d’événements

1. Implémentez la méthode ITTAPIEventNotification::Event . (TAPI appelle cette méthode lorsqu’un événement se produit.) En règle générale, cette implémentation ne fait pas plus que AddRef le pointeur d’interface IDispatch , puis publie dans la pompe de messages de l’application.

2. Inscrivez l’interface sortante ITTAPIEventNotification à l’aide des interfaces IConnectionPointContainer et IConnectionPoint standard COM, et passez à la méthode IConnectionPoint::Advise un pointeur vers ITTAPIEventNotification::Event.

3. Appelez la méthode ITTAPI::p ut_EventFilter pour indiquer à TAPI quels événements l’application va gérer. Le filtre d’événements se compose de membres ORed de l’énumération TAPI_EVENT .

   Notes

   Vous devez appeler la méthode ITTAPI::p ut_EventFilter pour définir le masque de filtre d’événements et activer la réception des événements. Si vous n’appelez pas ITTAPI::p ut_EventFilter, votre application ne recevra aucun événement.

    

Vous devez également appeler la méthode ITTAPI::RegisterCallNotifications pour chaque objet d’adresse sur lequel l’application gère les appels.

Pour obtenir la liste de toutes les interfaces d’événement, consultez Interfaces d’événement. Consultez Inscrire des événements pour obtenir des exemples de code illustrant le processus d’inscription et Recevoir un appel pour obtenir un exemple de code montrant une utilisation d’événements.