2.20. gc_ReqANI( )

When using DM3 boards, the gc_ReqANI( ) function is not supported.

When using Springware boards, The gc_ReqANI( ) function requests the ANI information (caller ID) from ANI-on-demand networks. The ANI is usually included in the ISDN setup message. However, if the caller ID does not exist and the network provides AT&T ANI-on-demand service, the driver automatically requests the caller ID from the network if this feature is enabled.

If the ANI information is always available, use the gc_GetANI( ) function, instead of the gc_ReqANI( ) function, for a faster return.

Note: The gc_ReqANI( ) function is used exclusively for the AT&T ANI-on-demand service.

The gc_ReqANI( ) function can operate as either a multitasking or non-multitasking function. It is a multitasking function when the caller number is offered upon request and the network provides this type of service (such as AT&T's ANI-on-demand service). The gc_ReqANI( ) function is a non-multitasking function when the calling party number is received or when the network does not offer an ANI-on-demand service. Thus, if ANI is already available, the function returns immediately because it does not have to instruct the interface device to query the switch.

In EV_ASYNC mode, the function will always return an event. In EV_SYNC mode, the function will return automatically with the ANI if one is available. Otherwise, the function will wait for completion of the ANI-on-demand request.

Click here to contact Telecom Support Resources