(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 a protocol-specific CT Access call acceptance parameter structure. Specify NULL to use the default values. See the protocol-specific documentation for details.
Return Values
Events
Details
- This function accepts an incoming call without answering or rejecting it, allowing 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, 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:
- 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
Want to send us feedback on our documentation? Email: Tech_Pubs@nmss.com
Copyright © 2000, Natural MicroSystems, Inc. All rights
reserved.