Intel 05-2409-003 3.3 Basic Call Model Configuration Options

36 Global Call API for HMP on Windows Programming Guide — August 2006

Call State Models

Call Idle (GCST_IDLE)

This state indicates that the local user has dropped the call. This may be a termination initiated

by the local user or a response to the remote side disconnecting the call. While the call no

longer exists, internal system resources committed to servicing the call are still present. The

user must release these resources, as they are no longer required.

3.3 Basic Call Model Configuration Options

Depending on the specific technology, the following options are available for configuring the

technology call control layer or the application:

Call State

If a state is disabled, the corresponding call state event is also disabled.

Call State Event

Call state transition events are masked so that the events are not generated.

Call Acknowledgement

An acknowledgement is sent to indicate to the remote side that the call has been received but

more information is required to proceed with the call.

Call Proceeding

Call proceeding information is sent to the remote side when an incoming call is received and

all the information required to proceed with the call is available.

Minimum Information

A minimum amount of destination address information, such as DNIS, is collected before the

call is offered to the application.

Some states in the basic call model are optional and can be enabled or disabled selectively. Every

technology or call control library has a default call state model consisting of all the states it can

possibly support from the basic call model. If a state is disabled, the corresponding call state event

will also be disabled. If a state is enabled, the event mask setting still determines which call state

events are sent to the application.

This configuration can be done by issuing the gc_SetConfigData() function with a target_type of

GCTGT_GCLIB_CHAN and a target_ID of a line device, and passing the appropriate set ID and

parameter IDs. The set ID used in this context is GCSET_CALLSTATE_MSK and the relevant

parameter IDs are:

GCACT_ADDMSK

Enable the call states specified in the value in addition to other states already enabled.

GCACT_SUBMSK

Disable all the call states specified in the value.

GCACT_SETMSK

Enable the call states specified in the value and disable other optional states that are already

enabled.