Dialogic® Global Call API Library Reference

gc_ResetLineDev( ) — reset the line device state and disconnect calls
Cautions
Errors
When a time slot (for example, dtiB1T1) is opened, it is put in the out-of-service state,
blocking all incoming calls on that time slot. The application must issue a gc_WaitCall( ) to
accept incoming calls or a gc_MakeCall( ) to make outgoing calls. When
gc_ResetLineDev( ) is issued, it puts the time slot in the out-of-service state, disconnecting
any existing calls and blocking any further incoming calls.
Any synchronous call issued on this time slot—for example, gc_WaitCall( )—is aborted. The
gc_ResetLineDev( ) function does not terminate a synchronous call issued in a different
process.
The gc_ResetLineDev( ) function should be used when the application has lost control of the
line due to a protocol error. It should not be used to switch between states, such as to simplify
the call control process. In general, calling gc_ResetLineDev( ) from the Idle state is an
acceptable practice, but using gc_ResetLineDev( ) in some call states can lead to other
unnecessary protocol errors.
After successful completion of this function, the application must issue a new gc_WaitCall( )
function to return the channel to the Idle state to be ready to receive the next call on the
channel.
Do not call any Global Call function until after the GCEV_RESETLINEDEV event is received
for this line. Likewise, ignore any other events until after the GCEV_RESETLINEDEV event
is received.
If this function returns