ec_unlisten( )

---

Cautions | Example | Errors | See Also

Name:	int ec_unlisten(chDev)
Inputs:	int chDev	valid channel device handle
Returns:	0 for success -1 for failure
Includes:	srllib.h dxxxlib.h eclib.h
Category:	routing
Mode:	synchronous

Description

The ec_unlisten( ) function changes the echo-reference signal set by ec_listen( ) back to the default reference (that is, the same channel as the play).

Parameter	Description
chDev	The channel device handle obtained when the CSP-capable device is opened using dx_open( ).

Cautions

• This function fails if you specify an invalid channel device handle.

Example

#include <windows.h>  /* include in Windows applications only; exclude in Linux */
#include <stdio.h>
#include <srllib.h>
#include <dxxxlib.h>
#include <eclib.h>
#include <errno.h>    /* include in Linux applications only; exclude in Windows */ 
main()
{
   int chdev;                 /* voice channel device handle */
   /* Open board 1 channel 1 device */
   if ((chdev = dx_open("dxxxB1C1", 0)) == -1) {
       printf("Cannot open channel dxxxB1C1." );
       exit(1);
   }
   /* Disconnect receive of board 1 channel 1 from all SCbus time slots */
   if (ec_unlisten(chdev) == -1) {
       printf("Error message = %s", ATDV_ERRMSGP(chdev));
       exit(1);
   }
} 

Errors

If the function returns -1, use ATDV_LASTERR( ) to return the error code and ATDV_ERRMSGP( ) to return a descriptive error message.

One of the following error codes may be returned:

Error code	Reason
EDX_BADDEV	Device handle is NULL or invalid.
EDX_BADPARM	Time slot pointer information is NULL or invalid.
EEC_UNSUPPORTED	Device handle is valid but device does not support CSP.

See Also

• ag_listen( )
• dt_listen( )
• dx_listen( )

Click here to contact Dialogic Customer Engineering