2.23. gc_ResetLineDev( )

The gc_ResetLineDev( ) function resets the channel to an Idle state. When this function is called, the following activities take place on the specified B channel in the order listed:

1. The active call is disconnected and all new incoming calls are blocked.
2. The CRN and all call information are cleared.
3. When the function returns, the channel will be blocked from accepting incoming calls. The application must issue a gc_WaitCall( ) function to accept a new call.

Caution

If a synchronous application issues the gc_ResetLineDev( ) function immediately after the gc_OpenEx( ) function, all the events pending on that line device are lost. The application should wait for the GCEV_UNBLOCKED event before calling the gc_ResetLineDev( ) function and wait for the GCEV_RESETLINEDEV event before calling any function.

In addition to being used after the recovery of trunk error or alarm conditions, or to reset the channel to Null state, this function may be used prior to using the gc_Close( ) function when the application needs to exit for programming.

Note: For synchronous applications, the application must use another process to send the signal to the process controlling the line device to be disconnected. Then the controlling process can invoke the gc_ResetLineDev( ) function and reset the line device.

When an error occurs and the gc_ResetLineDev( ) function fails, the termination event GCEV_RESTARTFAIL is returned.

Click here to contact Telecom Support Resources