Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This message is sent when a digit is detected. The sending of this message is controlled with the lineMonitorDigitsfunction.

Syntax 

LINE_MONITORDIGITS

hDevice = (DWORD) 
hCall;

dwCallbackInstance = (DWORD) 
hCallback;

dwParam1 = (DWORD) 
Digit;

dwParam2 = (DWORD) 
DigitMode;

dwParam3 = (DWORD) 0;

Parameters

hDevice

Handle to the call.

dwCallbackInstance

Callback instance supplied when opening the call's line.

dwParam1

Low-order byte contains the last digit received in a text representation.

dwParam2

Digit mode that was detected. This parameter must be one and only one of the LINEDIGITMODEconstants.

dwParam3

Tick count (the number of milliseconds since Windows started) at which the specified digit was detected. For TAPI versions earlier than 2.0, this parameter is not used.

Return Value

None.

Remarks

The LINE_MONITORDIGITS message is sent to the application that has enabled digit monitoring.

Because this timestamp may have been generated on a computer other than the one on which the application is executing, it is useful only for comparison to other similarly timestamped messages generated on the same line device ( LINE_GATHERDIGITS, LINE_MONITORDIGITS, LINE_MONITORMEDIA (TAPI)), in order to determine their relative timing (separation between events). The tick count can wrap around after approximately 49.7 days; applications must take this into account when performing calculations.

If the service provider does not generate the timestamp, for example, if it was created using an earlier version of TAPI, TAPI provides a timestamp at the point closest to the service provider generating the event so that the synthesized timestamp is as accurate as possible.

Requirements

Header tapi.h
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also