dx_clrcap( )

Description | Cautions | Example | Errors | See Also

Name:	void dx_clrcap(capp)
Inputs:	DX_CAP *capp	pointer to Call Analysis Parameter Structure
Returns:	None
Includes:	srllib.h dxxxlib.h
Category:	Structure Clearance

Description

The dx_clrcap( ) function clears all fields in a DX_CAP structure by setting them to zero. dx_clrcap( ) is a VOID function that returns no value. It is provided as a convenient way of clearing a DX_CAP structure.

Parameter	Description
capp	points to the DX_CAP structure. Refer to the DX_CAP structure in the chapter on Data Structures for details.

Cautions

The DX_CAP structure should be cleared and using dx_clrcap( ) before the structure is used as an argument in a dx_dial( ) function call. This will prevent parameters from being set unintentionally.

Example

#include <srllib.h>  
#include <dxxxlib.h>  
#include <windows.h>  
   
main()  
{  
   DX_CAP cap;  
   int chdev;  
   
   /* open the channel using dx_open */  
   if ((chdev = dx_open("dxxxB1C1",NULL)) == -1) {  
     /* process error */  
   }  
   .  
   .  
   /* set call analysis parameters before doing call analysis */  
   dx_clrcap(&cap);  
   cap.ca_nbrdna = 5;  /* 5 rings before no answer */  
   .  
   .  
   /* continue with call analysis */  
   .  
   .  
}

Errors

None.

See Also

• dx_dial( )
• DX_CAP structure
• Call Analysis (Voice Software Reference: Voice Features Guide)

Click here to contact Dialogic Customer Engineering