Dialogic 05-0867-005 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.
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:
supported states are as follows:
•
CCST_ACCEPTED - An inbound call was accepted; the call
is in the Accepted state.
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)
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.
connected; the call is in the Connected state.
•
CCST_DIALING - An outbound call request was received; the
call is in the Dialing state.
call is in the Dialing state.
•
CCST_DISCONNECTED - The call was disconnected from
the network; the call is in the Disconnected state.
the network; the call is in the Disconnected state.
•
CCST_IDLE - The call is not active; the call is in the Idle
state.
state.