Symbian^3 Product Developer Library >

CCCE Class Reference

class CCCE : public CBase

Converged Call Engine

The purpose of the Converged Call Engine (CCE) subsystem is to map the call management requests between the Phone Engine and Call Provider plug-ins, which can implement the requests using some specific signaling protocol, such as SIP.

cce.dll
Since
S60 v3.2

Inherits from

Public Member Functions
~CCCE()
IMPORT_C MCCEConferenceCall &ConferenceCallL(const MCCEConferenceCallObserver &)
IMPORT_C MCCEDtmfInterface &DtmfInterfaceL(const MCCEDtmfObserver &)
IMPORT_C MCCEExtensionInterface &ExtensionInterfaceL(const MCCEExtensionObserver &)
IMPORT_C voidGetAirTimeDuration(TTimeIntervalSeconds &, TTimeIntervalSeconds &)
IMPORT_C TBoolGetCSInfo(CSInfo &)
IMPORT_C TBoolGetLifeTime(TDes8 &)
IMPORT_C MCCECall &InitializeEmergencyCall(const MCCECallObserver &)
IMPORT_C CCCE *NewL()
IMPORT_C CCCE *NewL(MCCEObserver &)
IMPORT_C CCCE *NewLC()
IMPORT_C CCCE *NewLC(MCCEObserver &)
IMPORT_C MCCECall &OpenNewCallL(const TDesC &, const CCCECallParameters &, const MCCECallObserver &)
IMPORT_C voidSetObserver(MCCEObserver &, MCCESsObserver &)
IMPORT_C voidTerminateAllButRingingAndQueuedCalls()
IMPORT_C voidTerminateAllCalls()
IMPORT_C TIntTerminateCall(TName &)
IMPORT_C voidTerminateCall(TInt &, TName &)
Private Member Functions
CCCE()
voidConstructL(MCCEObserver *)
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()
Private Attributes
CCCECallContainer *iCallContainer
CCCEObserverAsynchroniser *iObserver

Constructor & Destructor Documentation

CCCE()

CCCE()[private]

constructor

~CCCE()

~CCCE()[virtual]

Destructor

Since
S60 3.2

Member Functions Documentation

ConferenceCallL(const MCCEConferenceCallObserver &)

IMPORT_C MCCEConferenceCall &ConferenceCallL(const MCCEConferenceCallObserver &aObserver)

Gets conference call interface.

Since
S60 3.2
leave
KErrNotReady temporarily cannot create the call.
leave
System wide error code if unsuccesful

Parameters

const MCCEConferenceCallObserver & aObserverReference to observer interface implementation

ConstructL(MCCEObserver *)

voidConstructL(MCCEObserver *aObserver)[private]

Parameters

MCCEObserver * aObserver

DtmfInterfaceL(const MCCEDtmfObserver &)

IMPORT_C MCCEDtmfInterface &DtmfInterfaceL(const MCCEDtmfObserver &aObserver)

Gets interface for Dtmf handling

Since
S60 3.2
leave
KErrNotReady temporarily cannot return the interface.
leave
System wide error code if unsuccesful

Parameters

const MCCEDtmfObserver & aObserverReference to observer interface

ExtensionInterfaceL(const MCCEExtensionObserver &)

IMPORT_C MCCEExtensionInterface &ExtensionInterfaceL(const MCCEExtensionObserver &aObserver)

Gets extension interface

Since
S60 3.2
leave
KErrNotReady temporarily cannot return the interface.
leave
System wide error code if unsuccesful

Parameters

const MCCEExtensionObserver & aObserverReference to observer interface

GetAirTimeDuration(TTimeIntervalSeconds &, TTimeIntervalSeconds &)

IMPORT_C voidGetAirTimeDuration(TTimeIntervalSeconds &aCSDuration,
TTimeIntervalSeconds &aPSDuration
)

Retrieves the current airtime duration of the calls

Since
S60 3.2

Parameters

TTimeIntervalSeconds & aCSDurationAirtime duration of all CS calls.
TTimeIntervalSeconds & aPSDurationAirtime duration of the PS calls.

GetCSInfo(CSInfo &)

IMPORT_C TBoolGetCSInfo(CSInfo &aCSInfo)
This method gets cs specific information from cs-plugin. This is used only CS,
Since
S60 3.2

Parameters

CSInfo & aCSInfoCS specific information from cs-plugin.

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, from the manufacturing date until the call to this method. Calling this method does not reset any data. Forwarded to CS plugin.
Since
S60 3.2

Parameters

TDes8 & aLifeTimeInfoLife time information

InitializeEmergencyCall(const MCCECallObserver &)

IMPORT_C MCCECall &InitializeEmergencyCall(const MCCECallObserver &aCallObserver)

Opens and initializes the emergency call session. Emergency call instance is created when creating CCCE instance.

Since
S60 3.2
Pre-condition
Initialize has been called and observer has been set

Parameters

const MCCECallObserver & aCallObserverObserver handle.

NewL()

IMPORT_C CCCE *NewL()[static]
Creates an instance of the CCCE component.
leave
If creating fails system error code
Since
S60 3.2

NewL(MCCEObserver &)

IMPORT_C CCCE *NewL(MCCEObserver &aObserver)[static]
Creates an instance of the CCCE component.
leave
If creating fails system error code
Since
S60 3.2

Parameters

MCCEObserver & aObserverReference to CCCE observer

NewLC()

IMPORT_C CCCE *NewLC()[static]
Creates an instance of the CCCE component.
leave
If creating fails system error code
Since
S60 3.2

NewLC(MCCEObserver &)

IMPORT_C CCCE *NewLC(MCCEObserver &aObserver)[static]
Creates an instance of the CCCE component.
leave
If creating fails system error code
Since
S60 3.2

Parameters

MCCEObserver & aObserverReference to CCCE observer

OpenNewCallL(const TDesC &, const CCCECallParameters &, const MCCECallObserver &)

IMPORT_C MCCECall &OpenNewCallL(const TDesC &aAddress,
const CCCECallParameters &aCallParameters,
const MCCECallObserver &aCallObserver
)

Opens new call.

Since
S60 3.2
Pre-condition
Initialize has been called and observer has been set
leave
KErrAlreadyExists - call already exists
leave
KErrNotReady - temporarily not able to create the requested call.
leave
KErrNoMemory - memory error
leave
KErrNotSupported - call not supported
leave
KErrArgument - illegal recipient address or service id
leave
Other general system error

Parameters

const TDesC & aAddressAddress / number to call
const CCCECallParameters & aCallParametersCall parameter struct containing call information such as Service-Id, call typeand line type.
const MCCECallObserver & aCallObserverObserver for the created call.

SetObserver(MCCEObserver &, MCCESsObserver &)

IMPORT_C voidSetObserver(MCCEObserver &aObserver,
MCCESsObserver &aSsObserver
)
Sets observer for CCCE. Repleaces any existing observer set. Called right after creating CCCE object.
Since
S60 3.2

Parameters

MCCEObserver & aObserverReference to CCCE observer
MCCESsObserver & aSsObserverReference to supplementary services observer.

TerminateAllButRingingAndQueuedCalls()

IMPORT_C voidTerminateAllButRingingAndQueuedCalls()
Terminates all the existing but calls in Ringing or Queued state. Results are returned via each call observer.
Since
S60 3.2

TerminateAllCalls()

IMPORT_C voidTerminateAllCalls()

Terminates all the existing calls on the phone. Results are returned via each call observer.

Since
S60 3.2

TerminateCall(TName &)

IMPORT_C TIntTerminateCall(TName &aCallName)
Terminates a call synchronously. For OG PE. To be deprecated later on. NOT SUPPORTED at the moment
Since
S60 3.2

Parameters

TName & aCallNamecall name

TerminateCall(TInt &, TName &)

IMPORT_C voidTerminateCall(TInt &aState,
TName &aCallName
)
Terminates a call synchronously. For OG PE. To be deprecated later on. NOT SUPPORTED at the moment, changed to TInt -> TRequestStatus is removed
Since
S60 3.2

Parameters

TInt & aStateRequest State
TName & aCallNamecall name

Member Data Documentation

CCCECallContainer * iCallContainer

CCCECallContainer *iCallContainer[private]

Call container

CCCEObserverAsynchroniser * iObserver

CCCEObserverAsynchroniser *iObserver[private]

observer pointer

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.