LINE_REQUEST message

The TAPI LINE_REQUEST message is sent to report the arrival of a new request from another application.

            

Parameters

hDevice

Not used.

dwCallbackInstance

The registration instance of the application specified on lineRegisterRequestRecipient.

dwParam1

The request mode of the newly pending request. This parameter uses the LINEREQUESTMODE_ constants.

dwParam2

The conditions for this parameter are, if dwParam1 is set to LINEREQUESTMODE_DROP, dwParam2 contains the hWnd of the application requesting the drop. Otherwise, dwParam2 is unused.

dwParam3

If dwParam1 is set to LINEREQUESTMODE_DROP, the low-order word of dwParam3 contains the wRequestID as specified by the application that requested the drop. Otherwise, dwParam3 is unused.

Return value

No return value.

Remarks

The LINE_REQUEST message is sent to the highest priority application that has registered for the corresponding request mode. This message indicates the arrival of an Assisted Telephony request of the specified request mode. If dwParam1 is LINEREQUESTMODE_MAKECALL, the application can invoke lineGetRequest using the corresponding request mode to receive the request. If dwParam1 is LINEREQUESTMODE_DROP, the message contains all of the data the request recipient requires to perform the request.

Requirements

Requirement Value
TAPI version
Requires TAPI 2.0 or later
Header
Tapi.h

See also

lineGetRequest

lineRegisterRequestRecipient

tapiRequestMakeCall