ATDX_LINEST( )

Description | Cautions | Example | Errors

Name:	long ATDX_LINEST(chdev)
Inputs:	int chdev	valid Dialogic channel device handle
Returns:	current line status of channel if successful AT_FAILURE if error
Includes:	srllib.h dxxxlib.h
Category:	Extended Attribute

Description

The ATDX_LINEST( ) function returns the current activity on the channel specified in chdev. The information is returned in a bitmap.

The function parameter is defined as follows:

Parameter	Description
chdev	specifies the valid channel device handle obtained when the channel was opened using dx_open( ).

Possible return values are the following:

RLS_SILENCE	Silence on the line
RLS_DTMF	DTMFsignal present
RLS_LCSENSE	Loop current not present
RLS_RING	Ring not present
RLS_HOOK	Channel is on-hook
RLS_RINGBK	Audible ringback detected

Cautions

None.

Example

#include <srllib.h>  
#include <dxxxlib.h>  
#include <windows.h>  
   
main()  
{  
   int chdev;  
   long linest;  
   
   /* Open the channel device */  
   if ((chdev = dx_open("dxxxB1C1",NULL)) == -1) {  
     /* Process error */  
   }  
   
   /* Examine line status bitmap of the channel. Perform application-specific  
    * action  
    */  
   if((linest = ATDX_LINEST(chdev)) == AT_FAILURE) {  
     /* Process error */  
   }  
   
   if(linest & RLS_LCSENSE) {  
     /* No loop current */  
   }  
   .  
   .  
}

Errors

This function will fail and return AT_FAILURE if an invalid channel device handle is specified in chdev.

Click here to contact Dialogic Customer Engineering