TAPI_REPLY

This message is sent to an application's window specified as hWnd in tapiRequestMediaCall to notify the application about state changes in the call. The message is sent in response to both a tapiRequestMediaCall and a tapiRequestDrop request.

Parameters

WPARAM wParam
Specifies the Request ID originally specified by the application. This identifies the call to which this message applies.

LPARAM lParam
Specifies the success or failure indication, or call state. Values are:

TAPIERR_CONNECTED
The call has reached the connected state, and the media stream on the call can be activated.

TAPIERR_DROPPED
The call has become disconnected and the media stream on the call ceases to exist. The disconnection may be due to a local drop or a remote drop.


TAPIERR_DEVICECLASSUNAVAIL
The specified device class is not supported.

TAPIERR_DEVICEIDUNAVAIL
The specified device class is available, but the specified device ID is not supported.

TAPIERR_DEVICEINUSE
The device on which the call can be made is currently in use by either the user or by another application. The app should try again later.

TAPIERR_DESTBUSY
The call was placed, but the destination was busy. The app should try again later.

TAPIERR_DESTNOANSWER
The call was placed, but the destination didn't answer within some reasonable number of rings. The app should try again later.


TAPIERR_DESTUNAVAIL
The call was placed but could not be completed as dialed; e.g., destination number is out of service. The app should not try again.

TAPIERR_REQUESTCANCELED
The request was canceled, for example by the user selecting a cancel command at the recipient app.

TAPIERR_UNKNOWNWINDOWHANDLE
At the time the request was received, there were no calls being managed by the recipient application on behalf of the application associated with the specified hWnd. The call to be dropped cannot be identified. This error can only occur in response to a tapiRequestDrop request.

TAPIERR_UNKNOWNREQUESTID
At the time the request was received, there was no call being managed by the recipient application on behalf of the application associated with the specified hWnd that is assigned wRequestID. The call to be dropped cannot be identified. This error can only occur in response to a tapiRequestDrop request.

TAPIERR_REQUESTFAILED
The request failed for unspecified reasons.

Comments

This message is sent directly from the request recipient application to the window of the simple telephony application. It informs the application about status changes for the call connection, or the reason why a connection cannot be established. A media stream can only exist after a CONNECTED indication is received.

See Also

Functions: tapiRequestMediaCall, tapiRequestDrop