2.14. gc_GetSigInfo( )

The gc_GetSigInfo( ) function gets the signaling information from the incoming ISDN message. To use the gc_GetSigInfo( ) function for a channel, the application needs to specify the size of the queue (circular buffer, maintained internally by the call control library) by calling the gc_SetParm( ) function and setting the RECEIVE_INFO_BUF to the desired size. Failure to set the size of RECEIVE_INFO_BUF will result in an error.

Note: The gc_GetCallInfo( ) function can also be used to get the Information Elements (IE) from an incoming ISDN message. However, when using gc_GetCallInfo( ), there is only one buffer to store message information. Since it is possible to get several ISDN messages before the application has the chance to process them, it is recommended to use the gc_GetSigInfo( ) function to retrieve and store multiple messages.

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 the Appendix D, "DPNSS IEs and Message Types" and Appendix E, "DPNSS Call Scenarios".

Click here to contact Telecom Support Resources