Symbian^3 Application Developer Library >

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 TInt AcceptUnattendedTransfer ()
IMPORT_C TInt AddConferenceMember ()
TInt AddMember ( TInt )
void AddMemberL ( TInt )
IMPORT_C TInt AnswerCall ()
IMPORT_C TInt BuildConference ()
IMPORT_C MPECallOwner & CallOwner ()
IMPORT_C TInt CallTerminatedError (const TInt )
IMPORT_C void CancelDtmfPlay ()
TBool ConnectedCalls ()
IMPORT_C void ContinueDtmfSending ()
void CreateCallDataArraysL ()
void CreateConferenceCallL ( CPESingleCall &, CPESingleCall &)
TInt DefineDivertBsc ( CCCECallParameters::TCCELineType , CPESingleCall *)
IMPORT_C TInt DialCall (const TPEPhoneNumber &, TInt &)
IMPORT_C void DialEmergencyCall (const TPEPhoneNumber &)
IMPORT_C TInt DialMultimedia (const TPEPhoneNumber &, TInt &)
IMPORT_C TInt DoUnattendedTransfer (const TDesC &)
IMPORT_C TInt DropMember ( TInt )
IMPORT_C TInt ForwardCallToAddress ( TInt )
TInt GetCallControlCaps ( TPECallControlCaps &, TInt )
IMPORT_C TInt GetCallDuration ( TTimeIntervalSeconds &, TInt )
IMPORT_C TInt GetCallIdByState ( TPEState )
IMPORT_C TInt GetCallInfo ( RMobileCall::TMobileCallInfoV3 &, TInt )
IMPORT_C TPEState GetCallState ( TInt )
IMPORT_C TInt GetCallTerminatedDiagnostics ( TName &)
TInt GetConferenceCallCaps ( TUint32 &)
TInt GetConferenceMemberNameAndId ( TName &, TInt &)
IMPORT_C TBool GetLifeTime ( TDes8 &)
IMPORT_C TInt GetMissedCall ( TBool &, TInt )
IMPORT_C TInt GetNumberOfCalls ()
TInt GetNumberOfParticipants ( TInt &)
IMPORT_C TInt GoOneToOne ( TInt )
void HandleAutoResume ()
void HandleInternalMessage ( TInt )
IMPORT_C TInt HangUp ( TInt , TPEHangUpOptions )
IMPORT_C TInt HoldCall ()
void InitConferenceCall ( MCCEConferenceCall &)
void InitVideoCall ( MCCECall &)
void InitVoiceCall ( MCCECall &)
void InitialiseConferenceCallInfo ( MCCECall &, MCCECall &)
IMPORT_C TBool IsCallInState ( TPEState )
TBool IsDialAllowed ( TBool )
TBool IsSecureCall (const TInt )
IMPORT_C CPECallHandling * NewL (MPEPhoneModelInternal &, CCCE &, MCCEDtmfInterface &)
CPESingleCall * OpenNewCallL (const TPEPhoneNumber &)
IMPORT_C TInt RejectCall ()
IMPORT_C TInt RejectUnattendedTransfer ()
IMPORT_C TInt ReleaseAll ()
IMPORT_C TInt ReleaseConference ()
IMPORT_C TInt ReplaceActive ()
IMPORT_C TInt ResumeCall ()
TBool SecureSpecified (const TInt )
IMPORT_C TInt SendDtmf (const TPEDtmfString &)
void SendErrorMessage (const TInt , const TInt )
void SendErrorMessage (const TInt )
void SendMessage (const MEngineMonitor::TPEMessagesFromPhoneEngine , const TInt )
void SendMessage (const MEngineMonitor::TPEMessagesFromPhoneEngine , const TName &)
void SendMessage (const MEngineMonitor::TPEMessagesFromPhoneEngine )
IMPORT_C void SetActiveLine ()
void SetCallParams ( TInt )
IMPORT_C TInt SetDynamicHscsdParams ( TInt , TInt )
IMPORT_C TInt StartDtmfTone (const TChar &)
IMPORT_C void StartUp ()
IMPORT_C void StopDtmfSending ()
IMPORT_C TInt StopDtmfTone ()
IMPORT_C TInt SwapCalls ()
IMPORT_C TInt TerminateAllConnections ()
IMPORT_C TInt TransferCalls ()
IMPORT_C TInt UpdatePhoneIdentity ( MEngineMonitor::TPEMessagesFromPhoneEngine )
void UpdateSaSetting ()
CPESingleCall * VoiceCallDataByState ( TPEState , TInt &)
Protected Member Functions
CPECallHandling (MPEPhoneModelInternal &, CCCE &, MCCEDtmfInterface &)
void ConstructL ()
Private Member Functions
TInt ReleaseCallObject (const TInt )
void SetCallOrigin (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 TInt AcceptUnattendedTransfer ( )
Accepts unattended transfer request.
Since
Series 60 v5.1

AddConferenceMember()

IMPORT_C TInt AddConferenceMember ( )

Add conference member.

AddMember(TInt)

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

Parameters

TInt aCallId

AddMemberL(TInt)

void AddMemberL ( TInt aCallId )
Adds one member to the conference call
Since
Series60_4.0

Parameters

TInt aCallId

AnswerCall()

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

BuildConference()

IMPORT_C TInt BuildConference ( )

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 TInt CallTerminatedError ( const TInt aCallId )
Returns call terminated error
Since
Series60_4.0

Parameters

const TInt aCallId

CancelDtmfPlay()

IMPORT_C void CancelDtmfPlay ( )

Cancels Dtmf string sending.

ConnectedCalls()

TBool ConnectedCalls ( )

Tells if there is any connected calls.

ConstructL()

void ConstructL ( ) [protected]

By default Symbian 2nd phase constructor is private.

ContinueDtmfSending()

IMPORT_C void ContinueDtmfSending ( )

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

CreateCallDataArraysL()

void CreateCallDataArraysL ( )
Creates CPECallData objects
Since
Series60_4.0

CreateConferenceCallL(CPESingleCall &, CPESingleCall &)

void CreateConferenceCallL ( CPESingleCall & aCall1,
CPESingleCall & aCall2
)

Create conference call

Parameters

CPESingleCall & aCall1
CPESingleCall & aCall2

DefineDivertBsc(CCCECallParameters::TCCELineType, CPESingleCall *)

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

Parameters

CCCECallParameters::TCCELineType aLineType used line type
CPESingleCall * call reference to call object

DialCall(const TPEPhoneNumber &, TInt &)

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

Parameters

const TPEPhoneNumber & aNumber The telephone number to be called.
TInt & aCallId Identification number of the call.

DialEmergencyCall(const TPEPhoneNumber &)

IMPORT_C void DialEmergencyCall ( 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 TInt DialMultimedia ( const TPEPhoneNumber & aNumber,
TInt & aCallId
)
Creates dialing request to the Multimode ETel.
Since
Series60_4.0

Parameters

const TPEPhoneNumber & aNumber The telephone number to be called.
TInt & aCallId Identification number of the call.

DoUnattendedTransfer(const TDesC &)

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

Parameters

const TDesC & aTransferTarget Address of the transfer target

DropMember(TInt)

IMPORT_C TInt DropMember ( TInt aCallId )
Drops one member from the conference call
Since
Series60_4.0

Parameters

TInt aCallId

ForwardCallToAddress(TInt)

IMPORT_C TInt ForwardCallToAddress ( TInt aIndex )
Starts call forwarding.
Since
Series60_5.1

Parameters

TInt aIndex A array index for a selected address.

GetCallControlCaps(TPECallControlCaps &, TInt)

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

Parameters

TPECallControlCaps & aCallControlCaps
TInt aCallId

GetCallDuration(TTimeIntervalSeconds &, TInt)

IMPORT_C TInt GetCallDuration ( TTimeIntervalSeconds & aDuration,
TInt aCallId
)
Returns call duration time.
Since
Series60_4.0

Parameters

TTimeIntervalSeconds & aDuration Call duration.
TInt aCallId Identification number of the call.

GetCallIdByState(TPEState)

IMPORT_C TInt GetCallIdByState ( TPEState aState ) const
Determines if there is a call in given state.
Since
Series60_4.0

Parameters

TPEState aState Call state search key.

GetCallInfo(RMobileCall::TMobileCallInfoV3 &, TInt)

IMPORT_C TInt GetCallInfo ( RMobileCall::TMobileCallInfoV3 & aCallInfo,
TInt aCallId
)
Returns information of the call.
Since
Series60_4.0

Parameters

RMobileCall::TMobileCallInfoV3 & aCallInfo Current call information.
TInt aCallId Identification number of the call.

GetCallState(TInt)

IMPORT_C TPEState GetCallState ( TInt aCallId )
Returns state of the call.
Since
Series60_4.0

Parameters

TInt aCallId

GetCallTerminatedDiagnostics(TName &)

IMPORT_C TInt GetCallTerminatedDiagnostics ( 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 TBool GetLifeTime ( 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 & aLifeTimeInfo Life time information

GetMissedCall(TBool &, TInt)

IMPORT_C TInt GetMissedCall ( TBool & aMissedCall,
TInt aCallId
)
Returns the missed voice call indicator.
Since
Series60_4.0

Parameters

TBool & aMissedCall
TInt aCallId

GetNumberOfCalls()

IMPORT_C TInt GetNumberOfCalls ( )
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 & aCount It is variable, where number of participants is returned

GoOneToOne(TInt)

IMPORT_C TInt GoOneToOne ( TInt aCallId )
Splits one member from the conference call.
Since
Series60_4.0

Parameters

TInt aCallId

HandleAutoResume()

void HandleAutoResume ( )

Handle auto resume.

HandleInternalMessage(TInt)

void HandleInternalMessage ( TInt aMessage )

Reroutes call messages.

Parameters

TInt aMessage specifies the event that has taken place

HangUp(TInt, TPEHangUpOptions)

IMPORT_C TInt HangUp ( TInt aCallId,
TPEHangUpOptions aAutoResumeOption
)
Returns remote alerting tone status (is it played by network or not).
Since
Series60_4.0
Since
Series60_4.0

Parameters

TInt aCallId Identification number of the call to be rejected.
TPEHangUpOptions aAutoResumeOption if options for autoresume.

HoldCall()

IMPORT_C TInt HoldCall ( )

Makes hold request for the connected call

InitConferenceCall(MCCEConferenceCall &)

void InitConferenceCall ( MCCEConferenceCall & aConference )

MPECallInitialiser::InitConferenceCall

Parameters

MCCEConferenceCall & aConference

InitVideoCall(MCCECall &)

void InitVideoCall ( MCCECall & aNewCall )

MPECallInitialiser::InitVideoCall

Parameters

MCCECall & aNewCall

InitVoiceCall(MCCECall &)

void InitVoiceCall ( MCCECall & aNewCall )

MPECallInitialiser::InitVoiceCall

Parameters

MCCECall & aNewCall

InitialiseConferenceCallInfo(MCCECall &, MCCECall &)

void InitialiseConferenceCallInfo ( MCCECall & aCall1,
MCCECall & aCall2
)

Initialise conference call info.

Parameters

MCCECall & aCall1
MCCECall & aCall2

IsCallInState(TPEState)

IMPORT_C TBool IsCallInState ( TPEState aState ) const
Determines if there is a call in given state.
Since
Series60_4.0

Parameters

TPEState aState Call state search key.

IsDialAllowed(TBool)

TBool IsDialAllowed ( TBool aMultimediaDial )

Check if dial allowed

Parameters

TBool aMultimediaDial

IsSecureCall(const TInt)

TBool IsSecureCall ( const TInt aCallId ) 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 TInt RejectCall ( )

Makes reject request to the Multimode ETel

RejectUnattendedTransfer()

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

ReleaseAll()

IMPORT_C TInt ReleaseAll ( )

Makes HangUp requests for all call to the Multimode ETel.

ReleaseCallObject(const TInt)

TInt ReleaseCallObject ( const TInt aCallId ) [private]

Delete's call object and reset's datastore.

Parameters

const TInt aCallId

ReleaseConference()

IMPORT_C TInt ReleaseConference ( )

Makes HangUp requests for conference call.

ReplaceActive()

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

ResumeCall()

IMPORT_C TInt ResumeCall ( )

Makes resume request for the held call

SecureSpecified(const TInt)

TBool SecureSpecified ( const TInt aCallId ) const

Get call's secure specified status.

Parameters

const TInt aCallId

SendDtmf(const TPEDtmfString &)

IMPORT_C TInt SendDtmf ( const TPEDtmfString & aDtmfString )

Sends dtmf string.

Parameters

const TPEDtmfString & aDtmfString String to be sent.

SendErrorMessage(const TInt, const TInt)

void SendErrorMessage ( const TInt aCallId,
const TInt aErrorCode
)

Reroutes error message to Phone Engine, usable by call objects

Parameters

const TInt aCallId Identification number of the call.
const TInt aErrorCode

SendErrorMessage(const TInt)

void SendErrorMessage ( const TInt aErrorCode )

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

Parameters

const TInt aErrorCode

SendMessage(const MEngineMonitor::TPEMessagesFromPhoneEngine, const TInt)

void SendMessage ( const MEngineMonitor::TPEMessagesFromPhoneEngine aMessage,
const TInt aCallId
)

Reroutes messages to Phone Engine, usable by call objects

Parameters

const MEngineMonitor::TPEMessagesFromPhoneEngine aMessage Message id.
const TInt aCallId Identification number of the call.

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

void SendMessage ( const MEngineMonitor::TPEMessagesFromPhoneEngine aMessage,
const TName & aName
)

Reroutes call messages

Parameters

const MEngineMonitor::TPEMessagesFromPhoneEngine aMessage The message code of the message
const TName & aName Name of call fill be maped to call id

SendMessage(const MEngineMonitor::TPEMessagesFromPhoneEngine)

void SendMessage ( const MEngineMonitor::TPEMessagesFromPhoneEngine aMessage )

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

Parameters

const MEngineMonitor::TPEMessagesFromPhoneEngine aMessage The message code of the message

SetActiveLine()

IMPORT_C void SetActiveLine ( )

Sets active line

SetCallOrigin(const TInt, const MCCECall &)

void SetCallOrigin ( const TInt aCallId,
const MCCECall & aCall
) const [private]

Set call origin to datastore.

Parameters

const TInt aCallId
const MCCECall & aCall reference to call object

SetCallParams(TInt)

void SetCallParams ( TInt aCallId )

SetCallParams.

Parameters

TInt aCallId

SetDynamicHscsdParams(TInt, TInt)

IMPORT_C TInt SetDynamicHscsdParams ( TInt aRxSlots,
TInt aCallId
)

Set Dynamic Hscsd parameters.

Parameters

TInt aRxSlots
TInt aCallId

StartDtmfTone(const TChar &)

IMPORT_C TInt StartDtmfTone ( const TChar & aTone )

Sends dtmf tone

Parameters

const TChar & aTone Tone to be sent.

StartUp()

IMPORT_C void StartUp ( )

Starts monitoring incoming calls for voice and data call.

StopDtmfSending()

IMPORT_C void StopDtmfSending ( )

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 TInt StopDtmfTone ( )

Stops sending dtmf tone.

SwapCalls()

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

TerminateAllConnections()

IMPORT_C TInt TerminateAllConnections ( )

Terminate all connection request.

TransferCalls()

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

UpdateColpNumber(TInt, const MCCECall &)

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

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

Parameters

TInt aCallId
const MCCECall & aCall reference to call object

UpdatePhoneIdentity(MEngineMonitor::TPEMessagesFromPhoneEngine)

IMPORT_C TInt UpdatePhoneIdentity ( MEngineMonitor::TPEMessagesFromPhoneEngine aMessage )

Asks phone identity parameters from the mmetel.

Parameters

MEngineMonitor::TPEMessagesFromPhoneEngine aMessage Reply message to the phone application.

UpdateSaSetting()

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

VoiceCallDataByState(TPEState, TInt &)

CPESingleCall * VoiceCallDataByState ( TPEState aState,
TInt & aIndex
) const

Returns voice call object by state.

Parameters

TPEState aState Call state search key.
TInt & aIndex Index 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]

Copyright ©2010 Nokia Corporation and/or its subsidiary(-ies).
All rights reserved. Unless otherwise stated, these materials are provided under the terms of the Eclipse Public License v1.0.