ITDigitDetectionEvent interface (tapi3if.h)
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 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. You must also call ITLegacyCallMediaControl::DetectDigits to indicate which type of digit detection is needed. For more information, see the
Events overview.
Inheritance
The ITDigitDetectionEvent interface inherits from the IDispatch interface. ITDigitDetectionEvent also has these types of members:
Methods
The ITDigitDetectionEvent interface has these methods.
| ITDigitDetectionEvent::get_Call The get_Call method gets a pointer to the ITCallInfo interface for the call on which the event occurred. |
| ITDigitDetectionEvent::get_CallbackInstance The get_CallbackInstance method gets a pointer to the callback instance associated with the event. (ITDigitDetectionEvent.get_CallbackInstance) |
| ITDigitDetectionEvent::get_Digit The get_Digit method retrieves an unsigned char pointer to the digit that was detected. |
| ITDigitDetectionEvent::get_DigitMode The get_DigitMode method gets the indicator of the line digit mode, such as LINEDIGITMODE_DTMF. |
| ITDigitDetectionEvent::get_TickCount The get_TickCount method gets the "tick count" (number of milliseconds since Windows started) at which the digit gathering completed. |
Requirements
| Requirement | Value |
|---|---|
| Target Platform | Windows |
| Header | tapi3if.h (include Tapi3.h) |