Platform SDK: TAPI

ITDigitDetectionEvent

The ITDigitDetectionEvent interface contains methods that retrieve the description of DTMF digit events. When the application's implementation of the ITTAPIEventNotification::Event method indicates a TAPI_EVENT equal to TE_DIGITEVENT, the method's pEvent parameter is an IDispatch pointer for the ITDigitDetectionEvent interface. The methods of this interface can be used to detect DTMF digits during a call. This interface is implemented by the application and called by the TAPI 3.0 DLL.

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

Methods in Vtable Order

IUnknown Methods

IDispatch Methods

ITDigitDetectionEvent methods Description
get_Call Gets a pointer to the ITCallInfo interface.
get_Digit Gets a digit.
get_DigitMode Gets the descriptor of the line digit mode.
get_TickCount Gets the "tick count" (number of milliseconds since Windows started) at which the digit-gathering completed.
get_CallbackInstance Gets the callback instance associated with the event.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Version: Requires TAPI 3.0 or later.
  Header: Declared in Tapi3.h.
  Library: Use T3iid.lib.

See Also

Events, ITTAPIEventNotification, ITTAPI::RegisterCallNotifications