ITCallStateEvent interface (tapi3if.h)

The ITCallStateEvent interface contains methods that retrieve the description of call state events. When the application's implementation of the ITTAPIEventNotification::Event method indicates a TAPI_EVENT equal to TE_CALLSTATE, the method's pEvent parameter is an IDispatch pointer for the ITCallStateEvent interface. The methods of this interface can be used to retrieve information concerning the change that has occurred in the call state.

Note  You must call the ITTAPI::put_EventFilter method and set an event filter mask that includes the TE_CALLSTATE event to enable reception of call state events. If you do not call ITTAPI::put_EventFilter, your application will not receive any events. For more information, see the Events overview.

 

Inheritance

The ITCallStateEvent interface inherits from the IDispatch interface. ITCallStateEvent also has these types of members:

Methods

The ITCallStateEvent interface has these methods.

ITCallStateEvent::get_Call The get_Call method gets a pointer to the call information interface for the call on which the event has occurred. (ITCallStateEvent.get_Call)
ITCallStateEvent::get_CallbackInstance The get_CallbackInstance method gets a pointer to the callback instance associated with this event. (ITCallStateEvent.get_CallbackInstance)
ITCallStateEvent::get_Cause The get_Cause method gets the cause associated with this event. (ITCallStateEvent.get_Cause)
ITCallStateEvent::get_State The get_State method gets information on the new call state.

Requirements

Requirement	Value
Target Platform	Windows
Header	tapi3if.h (include Tapi3.h)

See also

CALL_STATE

CALL_STATE_EVENT_CAUSE

Call Object

IDispatch

ITTAPI::put_EventFilter

ITTAPIEventNotification::Event

Register Events code snippet

TAPI_EVENT