CPECallHandling Class Reference

class CPECallHandling : public CBase

CPECallHandling Handles voice call related events from phone engine.

callhandling.lib
Since
Series60_4.0

Inherits from

Public Member Functions
~CPECallHandling()
IMPORT_C TIntAcceptUnattendedTransfer()
IMPORT_C TIntAddConferenceMember()
TInt AddMember(TInt)
voidAddMemberL(TInt)
IMPORT_C TIntAnswerCall()
IMPORT_C TIntBuildConference()
IMPORT_C MPECallOwner &CallOwner()
IMPORT_C TIntCallTerminatedError(const TInt)
IMPORT_C voidCancelDtmfPlay()
TBool ConnectedCalls()
IMPORT_C voidContinueDtmfSending()
voidCreateCallDataArraysL()
voidCreateConferenceCallL(CPESingleCall &, CPESingleCall &)
TInt DefineDivertBsc(CCCECallParameters::TCCELineType, CPESingleCall *)
IMPORT_C TIntDialCall(const TPEPhoneNumber &, TInt &)
IMPORT_C voidDialEmergencyCall(const TPEPhoneNumber &)
IMPORT_C TIntDialMultimedia(const TPEPhoneNumber &, TInt &)
IMPORT_C TIntDoUnattendedTransfer(const TDesC &)
IMPORT_C TIntDropMember(TInt)
IMPORT_C TIntForwardCallToAddress(TInt)
TInt GetCallControlCaps(TPECallControlCaps &, TInt)
IMPORT_C TIntGetCallDuration(TTimeIntervalSeconds &, TInt)
IMPORT_C TIntGetCallIdByState(TPEState)
IMPORT_C TIntGetCallInfo(RMobileCall::TMobileCallInfoV3 &, TInt)
IMPORT_C TPEStateGetCallState(TInt)
IMPORT_C TIntGetCallTerminatedDiagnostics(TName &)
TInt GetConferenceCallCaps(TUint32 &)
TInt GetConferenceMemberNameAndId(TName &, TInt &)
IMPORT_C TBoolGetLifeTime(TDes8 &)
IMPORT_C TIntGetMissedCall(TBool &, TInt)
IMPORT_C TIntGetNumberOfCalls()
TInt GetNumberOfParticipants(TInt &)
IMPORT_C TIntGoOneToOne(TInt)
voidHandleAutoResume()
voidHandleInternalMessage(TInt)
IMPORT_C TIntHangUp(TInt, TPEHangUpOptions)
IMPORT_C TIntHoldCall()
voidInitConferenceCall(MCCEConferenceCall &)
voidInitVideoCall(MCCECall &)
voidInitVoiceCall(MCCECall &)
voidInitialiseConferenceCallInfo(MCCECall &, MCCECall &)
IMPORT_C TBoolIsCallInState(TPEState)
TBool IsDialAllowed(TBool)
TBool IsSecureCall(const TInt)
IMPORT_C CPECallHandling *NewL(MPEPhoneModelInternal &, CCCE &, MCCEDtmfInterface &)
CPESingleCall *OpenNewCallL(const TPEPhoneNumber &)
IMPORT_C TIntRejectCall()
IMPORT_C TIntRejectUnattendedTransfer()
IMPORT_C TIntReleaseAll()
IMPORT_C TIntReleaseConference()
IMPORT_C TIntReplaceActive()
IMPORT_C TIntResumeCall()
TBool SecureSpecified(const TInt)
IMPORT_C TIntSendDtmf(const TPEDtmfString &)
voidSendErrorMessage(const TInt, const TInt)
voidSendErrorMessage(const TInt)
voidSendMessage(const MEngineMonitor::TPEMessagesFromPhoneEngine, const TInt)
voidSendMessage(const MEngineMonitor::TPEMessagesFromPhoneEngine, const TName &)
voidSendMessage(const MEngineMonitor::TPEMessagesFromPhoneEngine)
IMPORT_C voidSetActiveLine()
voidSetCallParams(TInt)
IMPORT_C TIntSetDynamicHscsdParams(TInt, TInt)
IMPORT_C TIntStartDtmfTone(const TChar &)
IMPORT_C voidStartUp()
IMPORT_C voidStopDtmfSending()
IMPORT_C TIntStopDtmfTone()
IMPORT_C TIntSwapCalls()
IMPORT_C TIntTerminateAllConnections()
IMPORT_C TIntTransferCalls()
IMPORT_C TIntUpdatePhoneIdentity(MEngineMonitor::TPEMessagesFromPhoneEngine)
voidUpdateSaSetting()
CPESingleCall *VoiceCallDataByState(TPEState, TInt &)
Protected Member Functions
CPECallHandling(MPEPhoneModelInternal &, CCCE &, MCCEDtmfInterface &)
voidConstructL()
Private Member Functions
TInt ReleaseCallObject(const TInt)
voidSetCallOrigin(const TInt, const MCCECall &)
TBool UpdateColpNumber(TInt, const MCCECall &)
Inherited Functions
CBase::CBase()
CBase::Delete(CBase *)
CBase::Extension_(TUint,TAny *&,TAny *)
CBase::operator new(TUint)
CBase::operator new(TUint,TAny *)
CBase::operator new(TUint,TLeave)
CBase::operator new(TUint,TLeave,TUint)
CBase::operator new(TUint,TUint)
CBase::~CBase()
Protected Attributes
CCCECallParameters::TCCELineType iActiveLine
CPECCEObserver *iCCEObserver
CPECallArrayOwner *iCallArrayOwner
CCCECallParameters *iCallOpenParams
CPEConferenceCall *iConferenceCall
CCCE &iConvergedCallEngine
TBool iDialRequest
CPEDtmfHandling *iDtmfHandling
MCCEDtmfInterface &iDtmfInterface
TPEPhoneNumber iEmergencyNumber
TInt iErrorCode
MPEPhoneModelInternal &iModel
CPsetSAObserver *iPsetSAObserver
TBool iReplaceActive
CRepository *iRepository
CPESupplementaryServicesMonitor *iSupplementaryServicesMonitor
CPESystemCallState *iSystemCallState
CPEVideoCallHandling *iVideoCallHandling

Constructor & Destructor Documentation

CPECallHandling(MPEPhoneModelInternal &, CCCE &, MCCEDtmfInterface &)

CPECallHandling(MPEPhoneModelInternal &aModel,
CCCE &aConvergedCallEngine,
MCCEDtmfInterface &aDtmfInterface
)[protected]

C++ default constructor.

Parameters

MPEPhoneModelInternal & aModel
CCCE & aConvergedCallEngine
MCCEDtmfInterface & aDtmfInterface

~CPECallHandling()

IMPORT_C~CPECallHandling()[virtual]

Destructor.

Member Functions Documentation

AcceptUnattendedTransfer()

IMPORT_C TIntAcceptUnattendedTransfer()
Accepts unattended transfer request.
Since
Series 60 v5.1

AddConferenceMember()

IMPORT_C TIntAddConferenceMember()

Add conference member.

AddMember(TInt)

TInt AddMember(TIntaCallId)
Adds one member to the conference call ( TRAPPED METHOD )
Since
Series60_4.0

Parameters

TInt aCallId

AddMemberL(TInt)

voidAddMemberL(TIntaCallId)
Adds one member to the conference call
Since
Series60_4.0

Parameters

TInt aCallId

AnswerCall()

IMPORT_C TIntAnswerCall()
Makes answer request to the Multimode ETel.
Since
Series60_4.0

BuildConference()

IMPORT_C TIntBuildConference()

Makes transfer request to the Multimode ETel

CallOwner()

IMPORT_C MPECallOwner &CallOwner()const
This method gets the reference to MPECallOwner object.
Since
Series60_4.0

CallTerminatedError(const TInt)

IMPORT_C TIntCallTerminatedError(const TIntaCallId)
Returns call terminated error
Since
Series60_4.0

Parameters

const TInt aCallId

CancelDtmfPlay()

IMPORT_C voidCancelDtmfPlay()

Cancels Dtmf string sending.

ConnectedCalls()

TBool ConnectedCalls()

Tells if there is any connected calls.

ConstructL()

voidConstructL()[protected]

By default Symbian 2nd phase constructor is private.

ContinueDtmfSending()

IMPORT_C voidContinueDtmfSending()

Allows a client to continue dtmf string sending when it was stopped by use of 'w' char in the string.

CreateCallDataArraysL()

voidCreateCallDataArraysL()
Creates CPECallData objects
Since
Series60_4.0

CreateConferenceCallL(CPESingleCall &, CPESingleCall &)

voidCreateConferenceCallL(CPESingleCall &aCall1,
CPESingleCall &aCall2
)

Create conference call

Parameters

CPESingleCall & aCall1
CPESingleCall & aCall2

DefineDivertBsc(CCCECallParameters::TCCELineType, CPESingleCall *)

TInt DefineDivertBsc(CCCECallParameters::TCCELineTypeaLineType,
CPESingleCall *call
)
Defines basic service code for divert notification.
Since
Series60_4.0

Parameters

CCCECallParameters::TCCELineType aLineTypeused line type
CPESingleCall * callreference to call object

DialCall(const TPEPhoneNumber &, TInt &)

IMPORT_C TIntDialCall(const TPEPhoneNumber &aNumber,
TInt &aCallId
)
Creates dialing request to the Multimode ETel.
Since
Series60_4.0

Parameters

const TPEPhoneNumber & aNumberThe telephone number to be called.
TInt & aCallIdIdentification number of the call.

DialEmergencyCall(const TPEPhoneNumber &)

IMPORT_C voidDialEmergencyCall(const TPEPhoneNumber &aEmergencyNumber)
Creates emergency call request to the Multimode ETel
Since
Series60_4.0

Parameters

const TPEPhoneNumber & aEmergencyNumber

DialMultimedia(const TPEPhoneNumber &, TInt &)

IMPORT_C TIntDialMultimedia(const TPEPhoneNumber &aNumber,
TInt &aCallId
)
Creates dialing request to the Multimode ETel.
Since
Series60_4.0

Parameters

const TPEPhoneNumber & aNumberThe telephone number to be called.
TInt & aCallIdIdentification number of the call.

DoUnattendedTransfer(const TDesC &)

IMPORT_C TIntDoUnattendedTransfer(const TDesC &aTransferTarget)
Does unattended transfer to the connected VoIP call
Since
Series60_5.1

Parameters

const TDesC & aTransferTargetAddress of the transfer target

DropMember(TInt)

IMPORT_C TIntDropMember(TIntaCallId)
Drops one member from the conference call
Since
Series60_4.0

Parameters

TInt aCallId

ForwardCallToAddress(TInt)

IMPORT_C TIntForwardCallToAddress(TIntaIndex)
Starts call forwarding.
Since
Series60_5.1

Parameters

TInt aIndexA array index for a selected address.

GetCallControlCaps(TPECallControlCaps &, TInt)

TInt GetCallControlCaps(TPECallControlCaps &aCallControlCaps,
TIntaCallId
)
Get call control caps
Since
Series60_4.0

Parameters

TPECallControlCaps & aCallControlCaps
TInt aCallId

GetCallDuration(TTimeIntervalSeconds &, TInt)

IMPORT_C TIntGetCallDuration(TTimeIntervalSeconds &aDuration,
TIntaCallId
)
Returns call duration time.
Since
Series60_4.0

Parameters

TTimeIntervalSeconds & aDurationCall duration.
TInt aCallIdIdentification number of the call.

GetCallIdByState(TPEState)

IMPORT_C TIntGetCallIdByState(TPEStateaState)const
Determines if there is a call in given state.
Since
Series60_4.0

Parameters

TPEState aStateCall state search key.

GetCallInfo(RMobileCall::TMobileCallInfoV3 &, TInt)

IMPORT_C TIntGetCallInfo(RMobileCall::TMobileCallInfoV3 &aCallInfo,
TIntaCallId
)
Returns information of the call.
Since
Series60_4.0

Parameters

RMobileCall::TMobileCallInfoV3 & aCallInfoCurrent call information.
TInt aCallIdIdentification number of the call.

GetCallState(TInt)

IMPORT_C TPEStateGetCallState(TIntaCallId)
Returns state of the call.
Since
Series60_4.0

Parameters

TInt aCallId

GetCallTerminatedDiagnostics(TName &)

IMPORT_C TIntGetCallTerminatedDiagnostics(TName &aCallName)const
Returns call terminated diagnostics of a call Info is valid only for Idle call
Since
Series60_4.0

Parameters

TName & aCallName

GetConferenceCallCaps(TUint32 &)

TInt GetConferenceCallCaps(TUint32 &aCaps)
Returns Conference capabilities
Since
Series60_4.0

Parameters

TUint32 & aCaps

GetConferenceMemberNameAndId(TName &, TInt &)

TInt GetConferenceMemberNameAndId(TName &aCallName,
TInt &aMemberCallId
)
Returns added or removed members TName information and CallId
Since
Series60_4.0

Parameters

TName & aCallName
TInt & aMemberCallId

GetLifeTime(TDes8 &)

IMPORT_C TBoolGetLifeTime(TDes8 &aLifeTimeInfo)

This method gets the lifetime of the MS. The lifetime information includes the manufacturing date of the MS and the total amount of airtime use.

Parameters

TDes8 & aLifeTimeInfoLife time information

GetMissedCall(TBool &, TInt)

IMPORT_C TIntGetMissedCall(TBool &aMissedCall,
TIntaCallId
)
Returns the missed voice call indicator.
Since
Series60_4.0

Parameters

TBool & aMissedCall
TInt aCallId

GetNumberOfCalls()

IMPORT_C TIntGetNumberOfCalls()
Returns number of non-idle calls
Since
Series60_4.0

GetNumberOfParticipants(TInt &)

TInt GetNumberOfParticipants(TInt &aCount)
Returns number of conference members
Since
Series60_4.0

Parameters

TInt & aCountIt is variable, where number of participants is returned

GoOneToOne(TInt)

IMPORT_C TIntGoOneToOne(TIntaCallId)
Splits one member from the conference call.
Since
Series60_4.0

Parameters

TInt aCallId

HandleAutoResume()

voidHandleAutoResume()

Handle auto resume.

HandleInternalMessage(TInt)

voidHandleInternalMessage(TIntaMessage)

Reroutes call messages.

Parameters

TInt aMessagespecifies the event that has taken place

HangUp(TInt, TPEHangUpOptions)

IMPORT_C TIntHangUp(TIntaCallId,
TPEHangUpOptionsaAutoResumeOption
)
Returns remote alerting tone status (is it played by network or not).
Since
Series60_4.0
Since
Series60_4.0

Parameters

TInt aCallIdIdentification number of the call to be rejected.
TPEHangUpOptions aAutoResumeOptionif options for autoresume.

HoldCall()

IMPORT_C TIntHoldCall()

Makes hold request for the connected call

InitConferenceCall(MCCEConferenceCall &)

voidInitConferenceCall(MCCEConferenceCall &aConference)

MPECallInitialiser::InitConferenceCall

Parameters

MCCEConferenceCall & aConference

InitVideoCall(MCCECall &)

voidInitVideoCall(MCCECall &aNewCall)

MPECallInitialiser::InitVideoCall

Parameters

MCCECall & aNewCall

InitVoiceCall(MCCECall &)

voidInitVoiceCall(MCCECall &aNewCall)

MPECallInitialiser::InitVoiceCall

Parameters

MCCECall & aNewCall

InitialiseConferenceCallInfo(MCCECall &, MCCECall &)

voidInitialiseConferenceCallInfo(MCCECall &aCall1,
MCCECall &aCall2
)

Initialise conference call info.

Parameters

MCCECall & aCall1
MCCECall & aCall2

IsCallInState(TPEState)

IMPORT_C TBoolIsCallInState(TPEStateaState)const
Determines if there is a call in given state.
Since
Series60_4.0

Parameters

TPEState aStateCall state search key.

IsDialAllowed(TBool)

TBool IsDialAllowed(TBoolaMultimediaDial)

Check if dial allowed

Parameters

TBool aMultimediaDial

IsSecureCall(const TInt)

TBool IsSecureCall(const TIntaCallId)const

Get call's secure status.

Parameters

const TInt aCallId

NewL(MPEPhoneModelInternal &, CCCE &, MCCEDtmfInterface &)

IMPORT_C CPECallHandling *NewL(MPEPhoneModelInternal &aModel,
CCCE &aConvergedCallEngine,
MCCEDtmfInterface &aDtmfInterface
)[static]

Two-phased constructor.

Parameters

MPEPhoneModelInternal & aModel
CCCE & aConvergedCallEngine
MCCEDtmfInterface & aDtmfInterface

OpenNewCallL(const TPEPhoneNumber &)

CPESingleCall *OpenNewCallL(const TPEPhoneNumber &aNumber)

Create new CPESingleCall object to CPECallArrayOwner and open new MCCECall ojcte to CCE.

Parameters

const TPEPhoneNumber & aNumber

RejectCall()

IMPORT_C TIntRejectCall()

Makes reject request to the Multimode ETel

RejectUnattendedTransfer()

IMPORT_C TIntRejectUnattendedTransfer()
Rejects unattended transfer request.
Since
Series 60 v5.1

ReleaseAll()

IMPORT_C TIntReleaseAll()

Makes HangUp requests for all call to the Multimode ETel.

ReleaseCallObject(const TInt)

TInt ReleaseCallObject(const TIntaCallId)[private]

Delete's call object and reset's datastore.

Parameters

const TInt aCallId

ReleaseConference()

IMPORT_C TIntReleaseConference()

Makes HangUp requests for conference call.

ReplaceActive()

IMPORT_C TIntReplaceActive()
Replace active call with waiting call.
Since
Series60_5.0

ResumeCall()

IMPORT_C TIntResumeCall()

Makes resume request for the held call

SecureSpecified(const TInt)

TBool SecureSpecified(const TIntaCallId)const

Get call's secure specified status.

Parameters

const TInt aCallId

SendDtmf(const TPEDtmfString &)

IMPORT_C TIntSendDtmf(const TPEDtmfString &aDtmfString)

Sends dtmf string.

Parameters

const TPEDtmfString & aDtmfStringString to be sent.

SendErrorMessage(const TInt, const TInt)

voidSendErrorMessage(const TIntaCallId,
const TIntaErrorCode
)

Reroutes error message to Phone Engine, usable by call objects

Parameters

const TInt aCallIdIdentification number of the call.
const TInt aErrorCode

SendErrorMessage(const TInt)

voidSendErrorMessage(const TIntaErrorCode)

Reroutes error messages to Phone Engine, usable by other than call objects

Parameters

const TInt aErrorCode

SendMessage(const MEngineMonitor::TPEMessagesFromPhoneEngine, const TInt)

voidSendMessage(const MEngineMonitor::TPEMessagesFromPhoneEngineaMessage,
const TIntaCallId
)

Reroutes messages to Phone Engine, usable by call objects

Parameters

const MEngineMonitor::TPEMessagesFromPhoneEngine aMessageMessage id.
const TInt aCallIdIdentification number of the call.

SendMessage(const MEngineMonitor::TPEMessagesFromPhoneEngine, const TName &)

voidSendMessage(const MEngineMonitor::TPEMessagesFromPhoneEngineaMessage,
const TName &aName
)

Reroutes call messages

Parameters

const MEngineMonitor::TPEMessagesFromPhoneEngine aMessageThe message code of the message
const TName & aNameName of call fill be maped to call id

SendMessage(const MEngineMonitor::TPEMessagesFromPhoneEngine)

voidSendMessage(const MEngineMonitor::TPEMessagesFromPhoneEngineaMessage)

Reroutes messages to Phone Engine, usable by other than call objects

Parameters

const MEngineMonitor::TPEMessagesFromPhoneEngine aMessageThe message code of the message

SetActiveLine()

IMPORT_C voidSetActiveLine()

Sets active line

SetCallOrigin(const TInt, const MCCECall &)

voidSetCallOrigin(const TIntaCallId,
const MCCECall &aCall
)const [private]

Set call origin to datastore.

Parameters

const TInt aCallId
const MCCECall & aCallreference to call object

SetCallParams(TInt)

voidSetCallParams(TIntaCallId)

SetCallParams.

Parameters

TInt aCallId

SetDynamicHscsdParams(TInt, TInt)

IMPORT_C TIntSetDynamicHscsdParams(TIntaRxSlots,
TIntaCallId
)

Set Dynamic Hscsd parameters.

Parameters

TInt aRxSlots
TInt aCallId

StartDtmfTone(const TChar &)

IMPORT_C TIntStartDtmfTone(const TChar &aTone)

Sends dtmf tone

Parameters

const TChar & aToneTone to be sent.

StartUp()

IMPORT_C voidStartUp()

Starts monitoring incoming calls for voice and data call.

StopDtmfSending()

IMPORT_C voidStopDtmfSending()

Allows a client to cancel the sending of a dtmf string when it was stopped by use of 'w' char in the string.

StopDtmfTone()

IMPORT_C TIntStopDtmfTone()

Stops sending dtmf tone.

SwapCalls()

IMPORT_C TIntSwapCalls()
Swaps connected and held calls
Since
Series60_4.0

TerminateAllConnections()

IMPORT_C TIntTerminateAllConnections()

Terminate all connection request.

TransferCalls()

IMPORT_C TIntTransferCalls()
Makes transfer request to the Multimode ETel
Since
Series60_4.0

UpdateColpNumber(TInt, const MCCECall &)

TBool UpdateColpNumber(TIntaCallId,
const MCCECall &aCall
)const [private]

Set COLP number to datastore if remote party number is different from dialled number.

Parameters

TInt aCallId
const MCCECall & aCallreference to call object

UpdatePhoneIdentity(MEngineMonitor::TPEMessagesFromPhoneEngine)

IMPORT_C TIntUpdatePhoneIdentity(MEngineMonitor::TPEMessagesFromPhoneEngineaMessage)

Asks phone identity parameters from the mmetel.

Parameters

MEngineMonitor::TPEMessagesFromPhoneEngine aMessageReply message to the phone application.

UpdateSaSetting()

voidUpdateSaSetting()
Update System Agent setting for call forward.
Since
Series60_4.0

VoiceCallDataByState(TPEState, TInt &)

CPESingleCall *VoiceCallDataByState(TPEStateaState,
TInt &aIndex
)const

Returns voice call object by state.

Parameters

TPEState aStateCall state search key.
TInt & aIndexIndex of the found call object (-1 is not found).

Member Data Documentation

CCCECallParameters::TCCELineType iActiveLine

CCCECallParameters::TCCELineType iActiveLine[protected]

CPECCEObserver * iCCEObserver

CPECCEObserver *iCCEObserver[protected]

CCE observer.

CPECallArrayOwner * iCallArrayOwner

CPECallArrayOwner *iCallArrayOwner[protected]

CCCECallParameters * iCallOpenParams

CCCECallParameters *iCallOpenParams[protected]

CPEConferenceCall * iConferenceCall

CPEConferenceCall *iConferenceCall[protected]

CCCE & iConvergedCallEngine

CCCE &iConvergedCallEngine[protected]

TBool iDialRequest

TBool iDialRequest[protected]

CPEDtmfHandling * iDtmfHandling

CPEDtmfHandling *iDtmfHandling[protected]

MCCEDtmfInterface & iDtmfInterface

MCCEDtmfInterface &iDtmfInterface[protected]

TPEPhoneNumber iEmergencyNumber

TPEPhoneNumber iEmergencyNumber[protected]

TInt iErrorCode

TInt iErrorCode[protected]

MPEPhoneModelInternal & iModel

MPEPhoneModelInternal &iModel[protected]

CPsetSAObserver * iPsetSAObserver

CPsetSAObserver *iPsetSAObserver[protected]

TBool iReplaceActive

TBool iReplaceActive[protected]

CRepository * iRepository

CRepository *iRepository[protected]

CPESupplementaryServicesMonitor * iSupplementaryServicesMonitor

CPESupplementaryServicesMonitor *iSupplementaryServicesMonitor[protected]

CPESystemCallState * iSystemCallState

CPESystemCallState *iSystemCallState[protected]

CPEVideoCallHandling * iVideoCallHandling

CPEVideoCallHandling *iVideoCallHandling[protected]