2.16. gc_MakeCall( )

The gc_MakeCall( ) function enables the application to make an outgoing call on the specified line device. When this function is issued asynchronously, a CRN will be assigned and returned immediately if the function is successful. All subsequent communications between the application and the GlobalCall library regarding that call will use the CRN as a reference. If this function is issued synchronously, the CRN will be available at the successful completion of the function.

The GCEV_CONNECTED event returned after calling the gc_MakeCall( ) function indicates that a Connect message was received from the network.

The timeout parameter is supported only in the synchronous mode for ISDN applications. If the timeout value specified expires before the remote end answers the call, then the gc_MakeCall( ) function returns -1. The GlobalCall error value is set to EGC_TIMEOUT. Setting the timeout parameter to 0 causes this parameter to be ignored.

When using the asynchronous mode, the timeout parameter is ignored. The gc_MakeCall( ) function will get a GCEV_DISCONNECTED event if the remote end does not answer before the protocol dependent timer expires.

ISDN provides the flexibility of selecting network services on any B channel. This service selection is contained in the ISDN call setup message which may vary from network to network. The following paragraphs describe making an ISDN call from a D/xxxSC board and using the MAKECALL_BLK data structure in the gc_MakeCall( ) function.

Click here to contact Dialogic Customer Engineering