| Platform SDK: TAPI |
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.
IUnknown Methods
IDispatch Methods
| ITCallStateEvent methods | Description |
|---|---|
| get_Call | Gets a pointer to the ITCallInfo interface. |
| get_State | Gets a CALL_STATE descriptor of the event. |
| get_Cause | Gets a CALL_STATE_EVENT_CAUSE descriptor of the event. |
| get_CallbackInstance | Gets the callback instance associated with the event. |
Windows NT/2000: Requires Windows 2000.
Version: Requires TAPI 3.0 or later.
Header: Declared in Tapi3.h.
Library: Use T3iid.lib.
Call Object, ITTAPIEventNotification::Event, TAPI_EVENT, ITTAPI::put_EventFilter, CALL_STATE_EVENT_CAUSE, CALL_STATE