Dialogic® Global Call API Library Reference

gc_MakeCall( ) — make an outgoing call
Parameter Description
numberstr called party’s telephone number (must be terminated with “\0”).
Maximum length is 32 digits.
makecallp points to the GC_MAKECALL_BLK structure; see
GC_MAKECALL_BLK, on page 441 for details. The
GC_MAKECALL_BLK structure lists the parameters used to make an
outbound call. Assigning a NULL to the makecallp parameter indicates
that the default values should be used for the call.
timeout time interval (in seconds) during which the call must be established, or the
function will return with a time-out error. This parameter is ignored when
set to 0. Not all call control libraries support this argument in
asynchronous mode. (For Dialogic ® DM3 boards, timeout is supported in
both the synchronous and asynchronous modes.)
See the appropriate Global Call Technology Guide for technologyspecific
information.
mode set to EV_ASYNC for asynchronous execution or to EV_SYNC for
synchronous execution
In the asynchronous mode, if the function is successfully initiated but connection is not achieved
(no GCEV_CONNECTED event returned), then the application must issue gc_DropCall( ) and
gc_ReleaseCallEx( ) functions to terminate the call completely.
In the synchronous mode, if the *crnp is zero, the call state is Null. A Null state indicates that the
call was fully terminated and that another gc_MakeCall( ) function can be issued. For non-zero
*crnp values, the application must issue gc_DropCall( ) and gc_ReleaseCallEx( ) functions to
terminate the call completely before issuing another gc_MakeCall( ) function.
The GCEV_ALERTING event (enabled by default) notifies the application that the call has
reached its destination but is not yet connected to the called party. When this event is received, the
call state changes to Alerting. In the Alerting state, the reception of a GCEV_CONNECTED event
(or, if in synchronous mode, the successful completion of the function) causes a transition to the
Connected state thus indicating a complete call connection.
The GCEV_CALLSTATUS event informs the application that a time-out or a no answer (call
control library dependent) condition occurred. This event does not cause any state change. Not all
call control libraries generate this event (for example, the ISDN library).
If glare handling is not specified in the protocol, the inbound call prevails when glare occurs.
Table 9 lists error conditions, associated event/return values, and the result/error value returned. For
all errors, the following apply:
Asynchronous: When an error condition is encountered, an event value such as
GCEV_TASKFAIL, GCEV_CALLSTATUS, or GCEV_DISCONNECTED is returned. Issue
a gc_ResultValue( ) function to retrieve the reason or result code for the event and then issue a
gc_ResultMsg( ) function to retrieve the ASCII message describing the error condition. When
an error condition occurs in asynchronous mode, you must issue the gc_DropCall( ) and
gc_ReleaseCallEx( ) functions before you can initiate your next call.
230 Dialogic ® Global Call API Library Reference — January 2008
Dialogic Corporation