Dialogic 05-0867-005 Table Top Game User Manual


 
retrieves the state of a call cc_CallState( )
63
Name:
int cc_CallState(crn, state_buf)
Inputs:
CRN crn
call reference number
int* state_buf
pointer to requested state number
Returns:
0 on success
< 0 on failure
Includes:
cclib.h
Category:
System tools
Mode:
synchronous
Technology:
BRI/2; BRI/SC; PRI (all protocols)
!
! !
!
Description
The cc_CallState( ) function retrieves the state of a call associated with a
particular call reference number (CRN). The call state, which is stored in the
firmware, changes only when a valid message is sent or received during a given
state. For more on call states, see Section 3.3. ISDN Call Control States.
Parameter Description
crn:
The call reference number. Each call needs a CRN.
state_buf:
The pointer to the location where the state value is returned. The
supported states are as follows:
CCST_ACCEPTED - An inbound call was accepted; the call
is in the Accepted state.
CCST_ALERTING - The call is waiting for the destination
party to answer; the call is in the alerting state (call alerted sent
or received)
CCST_CONNECTED - An inbound or outbound call was
connected; the call is in the Connected state.
CCST_DIALING - An outbound call request was received; the
call is in the Dialing state.
CCST_DISCONNECTED - The call was disconnected from
the network; the call is in the Disconnected state.
CCST_IDLE - The call is not active; the call is in the Idle
state.