Intel 05-1832-002 User Manual

Page of 564
Voice API for Windows Operating Systems Library Reference — November 2003
171
clear all fields in a DX_CAP structure — dx_clrcap( )
dx_clrcap( )
clear all fields in a DX_CAP structure
!
!
!
Description
The dx_clrcap( ) function clears all fields in a 
 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. 
!
!
!
Cautions
Clear the 
 structure using dx_clrcap( ) before the structure is used as an argument in a 
 function call. This will prevent parameters from being set unintentionally.
!
!
!
Errors
None.
!
!
!
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 progress analysis parameters before doing call progress analysis */
   dx_clrcap(&cap);
Name:
void dx_clrcap(capp)
Inputs:
DX_CAP *capp 
pointer to call progress analysis parameter data structure
Returns:
none
Includes:
srllib.h
dxxxlib.h
Category:
Structure Clearance
Mode:
synchronous 
Platform:
DM3, Springware 
Parameter
Description
capp 
pointer to call progress analysis parameter data structure, DX_CAP. For more 
information on this structure, see