LINE_MONITORDIGITS

The LINE_MONITORDIGITS message is sent to the LINEEVENT callback function whenever a digit is detected while digit monitoring is in progress. The sending of this message is controlled by the TSPI_lineMonitorDigits function.

LINE_MONITORDIGITS
htLine = (HTAPILINE) hLineDevice;
htCall = (HTAPICALL) hCallDevice;
dwMsg = (DWORD) LINE_MONITORDIGITS;
dwParam1 = (DWORD) chDigit;
dwParam2 = (DWORD) LineDigitMode;
dwParam3 = (DWORD) dwTickCount;
 

Parameters

htLine

The TAPI opaque object handle to the line device.

htCall

The TAPI opaque object handle to the call device.

dwMsg

The value LINE_MONITORDIGITS.

dwParam1

The low-order byte contains the last digit received in ASCII.

dwParam2

Specifies the digit mode that was detected. This parameter can be one of the following LINEDIGITMODE_ constants:

LINEDIGITMODE_PULSE

Detect digits as audible clicks that are the result of rotary pulse sequences. Valid digits for pulse are '0' through '9'.

LINEDIGITMODE_DTMF

Detect digits as DTMF tones. Valid digits for DTMF are '0' through '9', 'A', 'B', 'C', 'D', '*', and '#'.

LINEDIGITMODE_DTMFEND

Detect and provide notification of DTMF down edges. Valid digits for DTMF are '0' through '9', 'A', 'B', 'C', 'D', '*', and '#'.

dwParam3

Service providers shall insert into dwParam3 the "tick count" (number of milliseconds since Windows started), obtained from GetTickCount, at which the specified digit was detected.

Remarks

This message is sent only when digit monitoring is enabled.

See Also

LINEEVENT, TSPI_lineMonitorDigits