Symbian^3 Application 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 void GetAirTimeDuration ( TTimeIntervalSeconds &, TTimeIntervalSeconds &)
IMPORT_C TBool GetCSInfo ( CSInfo &)
IMPORT_C TBool GetLifeTime ( 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 void SetObserver ( MCCEObserver &, MCCESsObserver &)
IMPORT_C void TerminateAllButRingingAndQueuedCalls ()
IMPORT_C void TerminateAllCalls ()
IMPORT_C TInt TerminateCall ( TName &)
IMPORT_C void TerminateCall ( TInt &, TName &)
Private Member Functions
CCCE ()
void ConstructL ( 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 & aObserver Reference to observer interface implementation

ConstructL(MCCEObserver *)

void ConstructL ( 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 & aObserver Reference 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 & aObserver Reference to observer interface

GetAirTimeDuration(TTimeIntervalSeconds &, TTimeIntervalSeconds &)

IMPORT_C void GetAirTimeDuration ( TTimeIntervalSeconds & aCSDuration,
TTimeIntervalSeconds & aPSDuration
)

Retrieves the current airtime duration of the calls

Since
S60 3.2

Parameters

TTimeIntervalSeconds & aCSDuration Airtime duration of all CS calls.
TTimeIntervalSeconds & aPSDuration Airtime duration of the PS calls.

GetCSInfo(CSInfo &)

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

Parameters

CSInfo & aCSInfo CS specific information from cs-plugin.

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, 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 & aLifeTimeInfo Life 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 & aCallObserver Observer 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 & aObserver Reference 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 & aObserver Reference 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 & aAddress Address / number to call
const CCCECallParameters & aCallParameters Call parameter struct containing call information such as Service-Id, call typeand line type.
const MCCECallObserver & aCallObserver Observer for the created call.

SetObserver(MCCEObserver &, MCCESsObserver &)

IMPORT_C void SetObserver ( 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 & aObserver Reference to CCCE observer
MCCESsObserver & aSsObserver Reference to supplementary services observer.

TerminateAllButRingingAndQueuedCalls()

IMPORT_C void TerminateAllButRingingAndQueuedCalls ( )
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 void TerminateAllCalls ( )

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

Since
S60 3.2

TerminateCall(TName &)

IMPORT_C TInt TerminateCall ( 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 & aCallName call name

TerminateCall(TInt &, TName &)

IMPORT_C void TerminateCall ( 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 & aState Request State
TName & aCallName call 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.