2.9. gc_GetCallInfo( )

The gc_GetCallInfo( ) function gets the Information Elements (IE) from the incoming ISDN message. Note that every incoming ISDN message generates an event. This function must be used immediately after the event is received if the application wants the call information. The library does not queue the call information.

When writing an application, use the gc_GetCallInfo( ) function to set up buffers that will allow the application to store and retrieve multiple messages.

The IE_BLK data structure should be used to retrieve unprocessed IEs. See Section4.1, IE_BLK.

Note: For the Network Specific Facility (NSF) parameter and the UUI (User-to-User Information) parameter, these messages are held until retrieved by the gc_GetCallInfo( ) function. For all other message types, the current message is overwritten when a new message is received from the network.

The User-to-User Information (UUI) data returned is application dependent. The user information return format for UUI is defined in the USRINFO_ELEM data structure, see Section4.4, USRINFO_ELEM. Use the USRINFO_ELEM structure to retrieve the UUI. Ensure that the size of the information buffer is large enough to hold the UUI string.

When using the DPNSS protocol, see the GlobalCall DPNSS ISDN Protocol Reference for protocol-related call scenarios, IEs and message types.

Click here to contact Dialogic Customer Engineering