Filter
Top Products
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 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.
!
!!
! Cautions
Clear the DX_CAP structure 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.
!
!!
! 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 DX_CAP, on page 496.