Intel 05-1832-002 IP Phone User Manual


 
Voice API for Windows Operating Systems Library Reference — November 2003 173
clear all digits in the firmware digit buffer — dx_clrdigbuf( )
dx_clrdigbuf( )
clear all digits in the firmware digit buffer
!
!!
! Description
The dx_clrdigbuf( ) function clears all digits in the firmware digit buffer of the channel specified
by chdev.
!
!!
! Cautions
The function will fail and return -1 if the channel device handle is invalid or the channel is busy.
!
!!
! Errors
If the function returns -1, use the Standard Runtime Library (SRL) Standard Attribute function
ATDV_LASTERR( ) to obtain the error code or use ATDV_ERRMSGP( ) to obtain a descriptive
error message. One of the following error codes may be returned:
EDX_BADPARM
Invalid parameter
EDX_SYSTEM
Error from operating system; use dx_fileerrno( ) to obtain error value
!
!!
! Example
See the Example code in the function descriptions for dx_getdig( ), dx_play( ), and dx_rec( ) for
more examples of how to use dx_clrdigbuf( ).
#include <srllib.h>
#include <dxxxlib.h>
#include <windows.h>
Name: int dx_clrdigbuf(chdev)
Inputs: int chdev
valid channel device handle
Returns: 0 if success
-1 if failure
Includes: srllib.h
dxxxlib.h
Category: Configuration
Mode: synchronous
Platform: DM3, Springware
Parameter Description
chdev specifies the valid channel device handle obtained when the channel was opened
using dx_open( )