Filter
Top Products
440 Voice API for Windows Operating Systems Library Reference — November 2003
dx_wtcallid( ) — wait for rings and report caller ID
dx_wtcallid( )
wait for rings and report caller ID
!
!!
! Description
The dx_wtcallid( ) function is a convenience function that waits for rings and reports caller ID, if
available. Using this function is equivalent to using the voice functions dx_setevtmsk( ) and
dx_getevt( ), and the caller ID function dx_gtcallid( ) to return the caller’s Directory Number
(DN).
On successful completion, a NULL-terminated string containing the caller’s phone number is
placed in the buffer pointed to by bufferp.
Note: Non-numeric characters (punctuation, space, dash) may be included in the number string. The
string may not be suitable for dialing without modification.
Name: int dx_wtcallid (chdev, nrings, timeout, bufferp)
Inputs: int chdev
• valid channel device handle
int nrings
• number of rings to wait
short timeout
• time to wait for rings (in seconds)
unsigned char *bufferp
• pointer to where to return the caller ID information
Returns: 0 success
-1 error return code
Includes: srllib.h
dxxxlib.h
Category: Caller ID
Mode: synchronous
Platform: Springware
Parameter Description
chdev specifies the valid channel device handle obtained when the channel was
opened using dx_open( )
nrings specifies the number of rings to wait before answering
Valid values:
• ≥ 1 (Note: Minimum 2 for CLASS and ACLIP)