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 |