Symbian^3 Product Developer Library >

CSecondaryThread Class Reference

class CSecondaryThread : public CActive

CSecondaryThread - An active object who's sole purpose is to start the second thread and keep it alive.

Inherits from

Public Member Functions
~CSecondaryThread()
voidDoCancel()
CSecondaryThread *NewL(MLogArrayAccess &, TBool)
TInt RunError(TInt)
voidRunL()
voidSignalRequestSemaphore()
Private Member Functions
CSecondaryThread(MLogArrayAccess &, TBool)
voidConstructL()
voidStartSecondaryThreadL(TBool)
Inherited Functions
CActive::CActive(TInt)
CActive::Cancel()
CActive::Deque()
CActive::Extension_(TUint,TAny *&,TAny *)
CActive::IsActive()const
CActive::IsAdded()const
CActive::Priority()const
CActive::SetActive()
CActive::SetPriority(TInt)
CActive::~CActive()
CBase::CBase()
CBase::Delete(CBase *)
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()
Inherited Enumerations
CActive:TPriority
Private Attributes
MLogArrayAccess &iArrayAccess
TBool iFlushingOn
RThread iSecondaryThread
CShutDownMessage *iShutDownMessage
Inherited Attributes
CActive::iStatus

Constructor & Destructor Documentation

CSecondaryThread(MLogArrayAccess &, TBool)

CSecondaryThread(MLogArrayAccess &aArrayAccess,
TBoolaFlushOn
)[private]

Parameters

MLogArrayAccess & aArrayAccess
TBool aFlushOn

~CSecondaryThread()

~CSecondaryThread()

Member Functions Documentation

ConstructL()

voidConstructL()[private]

Contructs and kicks off the secondary thread, while also issuing a request to be informed if the thread dies, which will run the active object

DoCancel()

voidDoCancel()[virtual]
Appends a special shutdown message into the log array. When this reaches the head and is run, it shuts down the second thread.
Note:

Logs onto second thread and waits for it to finish.

NewL(MLogArrayAccess &, TBool)

CSecondaryThread *NewL(MLogArrayAccess &aArrayAccess,
TBoolaFlushOn
)[static]

Parameters

MLogArrayAccess & aArrayAccess
TBool aFlushOn

RunError(TInt)

TInt RunError(TIntaError)[virtual]

Parameters

TInt aError

RunL()

voidRunL()[virtual]
Runs when second thread dies, and simply restarts it again.
Note:

On death a thread-death message is placed in the queue so that a user is aware this happened.

StartSecondaryThread issues a request to be informed of thread death, so starts active object again.

SignalRequestSemaphore()

voidSignalRequestSemaphore()[inline]

Increment the semaphore count to match the number of msgs in the queue.

We need to signal to the slave thread that we now have work for it. We could have added a semaphore to do this, but there is already one in the second thread that isn't being used: the request semaphore. So, instead we will use that since it is also faster. But the code looks a bit back-to-front since we are calling "RequestComplete" when we are making the request. We also have to pass in a dummy status object since in normal practice this would be part of the request completion process.

StartSecondaryThreadL(TBool)

voidStartSecondaryThreadL(TBoolaRestarting)[private]

Start the second/consumer/slave thread and issue a request to be told when it dies.

Parameters

TBool aRestarting

Member Data Documentation

MLogArrayAccess & iArrayAccess

MLogArrayAccess &iArrayAccess[private]

TBool iFlushingOn

TBool iFlushingOn[private]

RThread iSecondaryThread

RThread iSecondaryThread[private]

CShutDownMessage * iShutDownMessage

CShutDownMessage *iShutDownMessage[private]

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.