(Page 3 of 15 in this chapter) Version

briAnswerCall

Description

Answers an incoming call.

Prototype

DWORD briAnswerCall ( CTAHD ctahd,
unsigned ringcount )
ctahd CTA context handle returned by ctaCreateContext.
ringcount The number of rings before answering. Must be set to zero (0).

Return Values

SUCCESS
BRIERR_INVALID_CALL_STATE
CTAERR_BAD_ARGUMENTringcount is different than zero (0).
CTAERR_DRIVER_SEND_FAILED
CTAERR_INVALID_CTAHD
CTAERR_INVALID_STATE

Events

BRIEVN_ANSWERING_CALLGenerated when the BRI service enters the answering state in response to briAnswerCall.
BRIEVN_CALL_CONNECTEDGenerated after BRIEVN_ANSWERING_CALL. The call control state changes to BRI_CC_STATE_CONNECTED.
BRIEVN_CALL_DISCONNECTEDGenerated if the remote party hangs up during call establishment or if the application does not respond within 8 seconds. The call control state changes to BRI_CC_STATE_DISCONNECTED. Refer to Appendix C for the applicable values you could get with this event.
BRIEVN_STATUS_UPDATEGenerated when some asynchronous information regarding the call (UUI information) has arrived. The event value field contains the information type.

Details

After the BRIEVN_INCOMING_CALL event is delivered, the application must invoke either briAcceptCall, briAnswerCall, or briRejectCall. briAnswerCall answers an incoming call immediately.
ringcount must be set to zero (0) because there is no support for inband ring back generation. For more information about ring back generation, refer to briAcceptCall.
Refer to Chapter 4 for a detailed explanation of call control.

See Also

briAcceptCall, briRejectCall, briReleaseCall, briStartProtocol

Example

Refer to the briPlaceCall example.

(Page 3 of 15 in this chapter) Version

tech_support@nmss.com

Copyright © 1999, Natural MicroSystems, Inc. All rights reserved.