(Page 2 of 23 in this chapter) Version

nccAcceptCall

Description

Accepts an incoming call without answering or rejecting it.

Prototype

DWORD nccAcceptCall ( NCC_CALLHD callhd,
unsigned mode,
void *acceptparms)
callhd Call handle returned via NCCEVN_SEIZURE_DETECTED.
mode Mode to accept an incoming call:
NCC_ACCEPT_PLAY_SILENT
NCC_ACCEPT_PLAY_RING
NCC_ACCEPT_USER_AUDIO
acceptparms Pointer to protocol-specific CT Access call acceptance parameter structure. Specify NULL to use default values. See protocol-specific documentation for details.

Return Values

SUCCESS
CTAERR_BAD_ARGUMENT
mode is invalid.
CTAERR_INVALID_HANDLE
The call handle is not valid. It may have been released.
CTAERR_INVALID_STATE
Line is not in the appropriate state to invoke this function.
NCCERR_INVALID_CALL_STATE
Call is not in the appropriate state to invoke this function.
NCCERR_NOT_CAPABLE
Returned when the protocol does not support the Accepting call state. The application can determine if the protocol supports this state by examining the NCC_CAP_ACCEPT_CALL bit in the capabilitymask returned by nccQueryCapability.
Also returned if mode is NCC_ACCEPT_PLAY_RING or NCC_ACCEPT_USER_AUDIO, and the protocol does not support the media capability. The application can determine if the protocol supports this capability by examining the NCC_CAP_MEDIA_IN_SETUP bit in the capabilitymask returned by nccQueryCapability.

Events

NCCEVN_ACCEPTING_CALL
The function has completed successfully and the call has entered the Accepting call state.
NCCEVN_CALL_DISCONNECTED
The remote party has disconnected. The call enters the Disconnected call state.

Details

This function accepts an incoming call without answering or rejecting it. This allows the application to perform media functions (such as playing a voice file) before connecting (or rejecting) an inbound call.
Not all protocols support this function and the Accepting state. The application can determine if the protocol supports this state by examining the NCC_CAP_ACCEPT_CALL bit in the capabilitymask returned by nccQueryCapability.
If the remote party disconnects while the application accepts the call, then the application receives NCCEVN_CALL_DISCONNECTED. In this case, no NCCEVN_ACCEPTING_CALL event is delivered to the application.
Three different modes can be specified to accept an incoming call. Valid modes are: Mode Description NCC_ACCEPT_PLAY_SILENT Do not play anything. NCC_ACCEPT_PLAY_RING Play a ring tone. NCC_ACCEPT_USER_AUDIO User will supply audio.
NCC_ACCEPT_PLAY_RING and NCC_ACCEPT_USER_AUDIO are not supported by all protocols. The application can determine if the protocol supports this capability by examining the NCC_CAP_MEDIA_IN_SETUP bit in the capabilitymask returned by nccQueryCapability. NCC_ACCEPT_PLAY_SILENT is the default accept mode supported by all protocols.

See Also

nccAnswerCall, nccRejectCall

(Page 2 of 23 in this chapter) Version

tech_support@nmss.com

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