Intel 05-1832-002 IP Phone User Manual


 
442 Voice API for Windows Operating Systems Library Reference — November 2003
dx_wtcallid( ) — wait for rings and report caller ID
EDX_CLIDBLK
Caller ID is blocked or private or withheld
(other information may be available using dx_gtextcallid( ))
EDX_CLIDINFO
Caller ID information not sent, sub-message(s) requested not available or caller ID
information invalid
EDX_CLIDOOA
Caller ID is out of area
(other information may be available using dx_gtextcallid( ))
EDX_SYSTEM
Error from operating system; use dx_fileerrno( ) to obtain error value
EDX_TIMEOUT
Time out limit is reached
!
!!
! Example
/*$ dx_wtcallid( ) example $*/
#include <srllib.h>
#include <dxxxlib.h>
unsigned char buffer[21]; /* char buffer */
int rc; /* value returned by function */
int chdev; /* channel descriptor */
unsigned short parmval; /* Parameter value */
/* open channel */
if ((chdev = dx_open("dxxxB1C1", NULL) == -1) {
/* process error *.
}
/* Enable Caller ID */
parmval = DX_CALLIDENABLE;
if (dx_setparm(chdev, DXCH_CALLID, (void *)&parmval) == -1) {
/* process error */
}
/* sit and wait for two rings on this channel - no timeout */
if (
dx_wtcallid(chdev,2,-1,buffer)
== -1) {
printf("Error waiting for ring (with Caller ID): 0x%x\n",
ATDV_LASTERR(chdev));
/* process error */
}
printf("Caller ID = %s\n", buffer);
!
!!
! See Also
dx_gtcallid( )
dx_setevtmsk( )
dx_getevt( )