(Page 4 of 80 in this chapter)

adiAnswerCall

Description

Answers an incoming call.

Prototype

DWORD adiAnswerCall( CTAHD ctahd,
unsigned ringcount )
ctahd Context handle returned by adiOpenPort.
ringcount Indicates the number of rings before answering.

Return Values

SUCCESS
ADIERR_INVALID_CALL_STATE
CTAERR_INVALID_CTAHD
CTAERR_INVALID_STATE

Events

ADIEVN_ANSWERING_CALLGenerated when AG Access enters the Answering state in response to adiAnswerCall.
ADIEVN_CALL_CONNECTEDGenerated after the ringcount has elapsed, with the value field set to ADI_CON_ON_ANSWER. The call control state changes to ADI_CC_STATE_CONNECTED.
ADIEVN_CALL_DISCONNECTEDGenerated if the remote party hangs up before the ringcount elapses. The call control state changes to ADI_CC_STATE_DISCONNECTED.The event value field is set to one of the following:
ADI_DIS_SIGNALThe out-of-band signaling bits indicate remote disconnect (not possible under loop start protocol).
ADI_DIS_REMOTE_ABANDONEDThe incoming ring signal stopped before ringcount rings (possible only under loop start protocol).
ADIEVN_REJECTING_CALLGenerated when AG Access automatically rejects a call when the application fails to invoke either adiAnswerCall or adiRejectCall within the period specified in the protocol's waitforPCtime parameter. Refer to the AG Access Developer's Manual for a detailed explanation of call control.

Details

After the ADIEVN_INCOMING_CALL event is delivered, the application must invoke either adiAnswerCall or adiRejectCall. adiAnswerCall answers an incoming call after the specified number of rings. ringcount specifies the total number of rings permitted before the application takes action.
The ringcount action performed by adiAnswerCall is protocol-specific. For example, in the loop start protocol, ringcount indicates the number of rings to be detected before answering. In the DID protocol, ringcount indicates the number of rings played to the caller before answering.
adiAnswerCall may be invoked multiple times as long as the specified context's call control state is ADI_CC_STATE_INCOMING or ADI_CC_STATE_ANSWERING. The ringcount supplied with the most recent invocation of adiAnswerCall overrides any previous value.
For example, if adiAnswerCall is invoked with a ringcount of 100000, the line will ring for what seems forever, until the remote party disconnects. If adiAnswerCall is invoked subsequently with a ringcount of 5, the line will be answered if the total ring count since the incoming call arrived is greater than or equal to 5. A zero ringcount forces an immediate answer.
Note: This function is not available when using the NOCC protocol.

See Also

adiStartProtocol, adiRejectCall, adiReleaseCall

Example

See adiPlaceCall example.

(Page 4 of 80 in this chapter)

Tech_Support@nmss.com

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