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 to the LINEEVENTcallback function to notify TAPI that the current digit or tone generation has terminated. Note that only one such generation request can be in progress on a given call at any time. This message is also sent when digit or tone generation is canceled.

Syntax 

LINE_GENERATE

htLine = (HTAPILINE) 
hLineDevice;

htCall = (HTAPICALL) 
hCallDevice;

dwMsg = (DWORD) LINE_GENERATE;

dwParam1 = (DWORD) 
LineGenerateTerminate;

dwParam2 = (DWORD) 
dwEndToEndID;

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_GENERATE.

dwParam1

Specifies the reason why digit or tone generation was terminated, and can be one of the LINEGENERATETERM_ constants.

dwParam2

The dwEndToEndIDparameter that was specified in the original TSPI_lineGenerateTonerequest for which this is the final result.

dwParam3

Service providers insert into dwParam3the tick count (the number of milliseconds since Windows started), obtained from GetTickCount, at which the digit or tone generation completed.

Remarks

Calling either TSPI_lineGenerateDigitsor TSPI_lineGenerateTonewhile digit or tone generation is in progress cancels the current digit or tone generation request and starts a new request and also results in the service provider sending this message.

The corresponding message at the TAPI level does not include an end-to-end identifier. End-to-end marking is only done at the TSPI level.

Requirements

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

See Also