Interface ITPhoneEvent (tapi3if.h)

L’interface ITPhoneEvent contient des méthodes qui récupèrent la description des événements de téléphone qui se sont produits. Lorsque l’implémentation de l’application de la méthode ITTAPIEventNotification::Event indique un TAPI_EVENT égal à TE_PHONEEVENT, le paramètre pEvent de la méthode est un pointeur IDispatch pour l’interface ITPhoneEvent .

Note Vous devez appeler la méthode ITTAPI::p ut_EventFilter et définir un masque de filtre d’événements qui inclut TE_PHONEEVENT pour activer la réception des événements téléphoniques. Si vous n’appelez pas ITTAPI::p ut_EventFilter, votre application ne recevra aucun événement. Pour plus d’informations, consultez vue d’ensemble des événements .

 

Héritage

L’interface ITPhoneEvent hérite de l’interface IDispatch. ITPhoneEvent a également les types de membres suivants :

Méthodes

L’interface ITPhoneEvent possède ces méthodes.

ITPhoneEvent::get_ButtonLampId La méthode get_ButtonLampId retourne une valeur longue indiquant le bouton ou la lampe qui a déclenché l’événement. Ces informations sont disponibles uniquement lorsque ITPhoneEvent::get_Event retourne PE_LAMPMODE ou PE_BUTTON.
ITPhoneEvent::get_ButtonState La méthode get_ButtonState retourne une valeur PHONE_BUTTON_STATE spécifiant l’état vers lequel le bouton a été transféré. Ces informations sont disponibles uniquement lorsque la méthode ITPhoneEvent::get_Event retourne PE_BUTTON.
ITPhoneEvent::get_Call La méthode get_Call retourne un pointeur vers l’interface ITCallInfo pour l’objet d’appel impliqué dans l’événement.
ITPhoneEvent::get_Event La méthode get_Event retourne une valeur PHONE_EVENT spécifiant le type d’événement de téléphone qui s’est produit.
ITPhoneEvent::get_HookSwitchDevice La méthode get_HookSwitchDevice retourne une valeur de PHONE_HOOK_SWITCH_DEVICE spécifiant le périphérique de commutateur de connexion qui a changé d’état. Ces informations sont disponibles uniquement lorsque la méthode ITPhoneEvent::get_Event retourne PE_HOOKSWITCH.
ITPhoneEvent::get_HookSwitchState La méthode get_HookSwitchState retourne une valeur de PHONE_HOOK_SWITCH_STATE spécifiant l’état vers lequel le hookswitch a été transféré. Ces informations sont disponibles uniquement lorsque la méthode ITPhoneEvent::get_Event retourne PE_HOOKSWITCH.
ITPhoneEvent::get_NumberGathered La méthode get_NumberGathered retourne une valeur BSTR spécifiant le numéro de téléphone qui a été collecté. Ces informations sont disponibles uniquement lorsque la méthode ITPhoneEvent::get_Event retourne PE_NUMBERGATHERED.
ITPhoneEvent::get_Phone La méthode get_Phone retourne un pointeur vers l’interface ITPhone sur l’objet téléphone qui a déclenché cet événement.
ITPhoneEvent::get_RingMode La méthode get_RingMode retourne une valeur longue spécifiant le mode d’anneau vers lequel le téléphone a effectué la transition. Ces informations sont disponibles uniquement lorsque la méthode ITPhoneEvent::get_Event retourne PE_RINGMODE.

Configuration requise

Plateforme cible	Windows
En-tête	tapi3if.h (inclure Tapi3.h)