4.1.0.10 LINE_GENERATE

This message is sent to notify the TAPI DLL that the current digit or tone generation has terminated. Note that only one such generation request can be in progress an a given call at any time. This message is also sent when digit or tone generation is canceled.

Sent to

LINEEVENT


Parameters

HTAPILINE htLine
Specifies the TAPI DLL's opaque object handle to the line device.

HTAPICALL htCall
Specifies the TAPI DLL's opaque object handle to the call device.

DWORD dwMsg
The value LINE_GENERATE

DWORD dwParam1
Specifies the reason why digit or tone generation was terminated, of type LINEGENERATETERM. Values are:

LINEGENERATETERM_DONE
The requested number of digits have been generated, or the requested tones have been generated for the requested duration.

LINEGENERATETERM_CANCEL
The digit or tone generation request was canceled by an invervening call to TSPI_lineGenerateTone or TSPI_lineGenerateDigits, or because the call terminated.

DWORD dwParam2
The dwEndToEndID that was specified in the original TSPI_lineGenerateDigits or lineGenerateTone request for which this is the final result.

DWORD dwParam3
Unused.

Comments

Calling either TSPI_lineGenerateDigits or TSPI_lineGenerateTones while 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.

Comparison

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

See Also

Functions: lineGenerateDigits, lineGenerateTone