4.1.0.15 LINE_NEWCALL

This message is sent whenever a new incoming call arrives on a line that the TAPI DLL has open. This must be the first message sent regarding that call. The TAPI DLL writes the htCall opaque handle to the location passed by the Service Provider as dwParam2. This gives the Service Provider the htCall value to be used in subsequent messages.

Sent to

LINEEVENT


Parameters

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

HTAPICALL htCall
Unused

DWORD dwMsg
The value LINE_NEWCALL

DWORD dwParam1
Specifies the Service Provider's opaque handle for the call, of type HDRVCALL. The TAPI DLL will pass this value as the hdCall parameter to identify the call in subsequent procedures it invokes to operate on the call.

DWORD dwParam2
A pointer of type LPHTAPICALL pointing to a HTAPICALL. The TAPI DLL writes the TAPI DLL's opaque handle for the call to the indicated location. The Service Provider must save this value and pass it as the htCall parameter to identify the call in subsequent events it reports for the call.

DWORD dwParam3
Unused

Comments

The Service Provider should send the LINE_CALLSTATE message as the next message for this call. The LINE_NEWCALL event is unusual in the sense that it also passes a value back to the Service Provider.

Comparison

There is no directly corresponding message at the TAPI level. This message is used at the TSPI level to uniquely and unambiguously introduce a new incoming call to the TAPI DLL and retrieve the TAPI DLL's opaque identifier for the call.

See Also

Messages: LINE_CALLSTATE