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.