Intel 05-1832-002 User Manual

262

retrieve a caller ID message

!

!

!

! Description

The dx_gtextcallid( ) function returns the requested caller ID message by specifying the Message 
Type ID. The application can issue this function as many times as required to get the desired caller 
ID messages (such as date and time, calling line subscriber name, reason why caller ID is not 
available). 

The format and content of the caller ID messages are based on published telecommunication 
standards. The actual formatting and content of the data returned depend on the implementation 
and level of service provided by the originating and destination Central Offices.  

For CLASS and ACLIP, do not use Multiple Data Message Type IDs with caller ID information in 
Single Data Message format.

int dx_gtextcallid (chdev, infotype, bufferp)

int chdev

channel device handle

int infotype

message type ID

unsigned char *bufferp

pointer to where to return the requested caller ID message

0 success
-1 error return code

srllib.h
dxxxlib.h

Caller ID

synchronous

Springware

chdev 

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

 

infotype 

the Message Type ID for the specific caller ID information to receive. Message 
Type IDs for CLASS, ACLIP, JCLIP and CLIP are listed on the following 
pages. See 

, on page 264, 

page 266, and 

bufferp 

pointer to buffer where the requested caller ID message is to be stored. All 
returns are NULL terminated.