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.

Note: When using DM3 boards, since the gc_GetCallInfo( ) function does not queue information, it is recommended to use the gc_GetSigInfo( ) function.

The IE_BLK data structure should be used to retrieve unprocessed IEs. See Section 5.1, IE_BLK.

Note: For 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 Section 5.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 Appendix D, "DPNSS IEs and Message Types" and Appendix E, "DPNSS Call Scenarios" for more information.

Note: When using DM3 boards, ISDN billing information (AOC) cannot be retrieved using the gc_GetCallInfo( ) function. Use the gc_GetSigInfo(U_IES) function instead. U_IES retrieves all public IEs (as defined by Telenetworks).

Click here to contact Telecom Support Resources