Intel 05-1832-002 User Manual

440

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 

 and 

, and the caller ID function 

 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. 

Non-numeric characters (punctuation, space, dash) may be included in the number string. The 
string may not be suitable for dialing without modification.

int dx_wtcallid (chdev, nrings, timeout, bufferp)

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

0 success
-1 error return code

srllib.h
dxxxlib.h

Caller ID

synchronous

Springware 

chdev 

specifies the valid channel device handle obtained when the channel was 
opened using 

nrings 

specifies the number of rings to wait before answering

Valid values: 

≥ 1 (Note: Minimum 2 for CLASS and ACLIP)