IP Media Gateway (IPML) Demo Guide: 5.2.6 GWCall Class

5.2.6 GWCall Class

The GWCall class' main role is to control all resources related to a call. It contains all the resources needed to establish a call:

PSTNCallControl
IPMediaDevice
IPCallControl

The GWCall class reflects the call state to the other classes.

The GWCall class attributes are described in Table 11. Refer to the source code for method information.

Table 11. GWCall Class Attributes

Name

Access Privilege

Type

Description

m_pIPMediaDevice public IPMediaDevice* The IPMedia device of the call

m_pPSTNCC public PSTNCallControl* PSTN call control object of the call, handling the PSTN call control

m_pIPCC public IPCallControl* IP call control object of the call, handling the IP proprietary call control

m_pLog public Log* Log object of the call

m_currentState private E_StateMachine Current channel state

m_LastDigit private int Points to the last index reached in m_DTMFBuffer

m_DTMFBuffer private char[MAX_DIGITS] Used to store DTMFs to send over the IP. This DTMF "digit map" is used to avoid sending the DTMFs received from the PSTN one by one, which leads to many unnecessary messages sent over the IP. The received DTMFs are stored according to a digit map defined in the CFG file and sent only when the expected digit count is reached. The digit map only defines how many digits should be stored before being sent.

m_NumOfDigits private int Number of digits expected from the PSTN this loop

m_DigitMapNum private int Current digit map to be matched to the digits from the PSTN

m_ChangeCodecFlag private int Binary flag. First bit is "1" if, and only if, IPMEDIA_STOP arrived when changing the codec while in a call. The second bit is set to "1" when the remote side sends IPEV_CODEC_CHANGED.

m_DropFlag private int Binary Flag. First bit is "1" if, and only if, the gc_dropCall( ) function was called to drop the PSTN call. The second but is the same, but for the IP side.

**Table 11. GWCall Class Attributes**
Name	Access Privilege	Type	Description
m_pIPMediaDevice	public	IPMediaDevice*	The IPMedia device of the call
m_pPSTNCC	public	PSTNCallControl*	PSTN call control object of the call, handling the PSTN call control
m_pIPCC	public	IPCallControl*	IP call control object of the call, handling the IP proprietary call control
m_pLog	public	Log*	Log object of the call
m_currentState	private	E_StateMachine	Current channel state
m_LastDigit	private	int	Points to the last index reached in m_DTMFBuffer
m_DTMFBuffer	private	char[MAX_DIGITS]	Used to store DTMFs to send over the IP. This DTMF "digit map" is used to avoid sending the DTMFs received from the PSTN one by one, which leads to many unnecessary messages sent over the IP. The received DTMFs are stored according to a digit map defined in the CFG file and sent only when the expected digit count is reached. The digit map only defines how many digits should be stored before being sent.
m_NumOfDigits	private	int	Number of digits expected from the PSTN this loop
m_DigitMapNum	private	int	Current digit map to be matched to the digits from the PSTN
m_ChangeCodecFlag	private	int	Binary flag. First bit is "1" if, and only if, IPMEDIA_STOP arrived when changing the codec while in a call. The second bit is set to "1" when the remote side sends IPEV_CODEC_CHANGED.
m_DropFlag	private	int	Binary Flag. First bit is "1" if, and only if, the gc_dropCall( ) function was called to drop the PSTN call. The second but is the same, but for the IP side.

Click here to contact Telecom Support Resources