diff -r 000000000000 -r 4e1aa6a622a0 sysstatemgmt/systemstatemgr/cmd/inc/cmdmultiplewait.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/sysstatemgmt/systemstatemgr/cmd/inc/cmdmultiplewait.h Tue Feb 02 00:53:00 2010 +0200 @@ -0,0 +1,123 @@ +// Copyright (c) 2007-2009 Nokia Corporation and/or its subsidiary(-ies). +// All rights reserved. +// This component and the accompanying materials are made available +// under the terms of "Eclipse Public License v1.0" +// which accompanies this distribution, and is available +// at the URL "http://www.eclipse.org/legal/epl-v10.html". +// +// Initial Contributors: +// Nokia Corporation - initial contribution. +// +// Contributors: +// +// Description: +// + +#ifndef __CMDMULTIPLEWAIT_H__ +#define __CMDMULTIPLEWAIT_H__ + +#include "ssmcommandbase.h" + +class RReadStream; +class TSsmCommandParameters; + +/** +A command object responsible for checking that all deferred commands in the list preceding +this multiple wait command have finished. +Commandlist must be externalized and internalized in order to populate the deferred list +of MULTIPLE_WAIT command. + +@internalComponent +@released +*/ +NONSHARABLE_CLASS(CCmdMultipleWait) : public CSsmCommandBase + { +public: + static CCmdMultipleWait* NewL(RReadStream& aReadStream, TArray& aDeferredCommands); + static CCmdMultipleWait* NewL(TInt32 aTimeout); + static CCmdMultipleWait* NewL(TSsmCommandParameters& aCommandParameters); +#ifdef SYMBIAN_SSM_FLEXIBLE_MERGE + static CCmdMultipleWait* NewL(TInt32 aTimeout,const TUint16 aPriority); +#endif + //Must be used only by CLE to reconstruct the command + static CCmdMultipleWait* NewLC(const CCmdMultipleWait& aCmdMultipleWait, TArray& aDeferredCommands); + ~CCmdMultipleWait(); + + // from MSsmCommand + void Execute(TRequestStatus& aStatus); + void Release(); + void ExecuteCancel(); + TSsmCommandType Type() const; + void ExternalizeL(RWriteStream& aWriteStream) const; + + void HandleTimeoutCallback(); + inline TInt32 Timeout() const {return iTimeout;} + +private: + enum TStates + { + EStateCheckCompletionStatus = 0, + EStateTakeAction, + EStateTimerExpired + }; + + //CTOR's + CCmdMultipleWait(); + CCmdMultipleWait(TInt32 aTimeout); +#ifdef SYMBIAN_SSM_FLEXIBLE_MERGE + CCmdMultipleWait(TInt32 aTimeout, const TUint16 aPriority); +#endif + + //ConstructL's + void ConstructL(TArray& aDeferredCommands, RReadStream& aReadStream); + void ConstructL(TSsmCommandParameters& aCommandParameters); + void ConstructL(); + void ConstructL(const CCmdMultipleWait& aCmdMultipleWait, TArray& aDeferredCommands); + //helper functions + void CheckCompletion(); + void TakeProperAction(); + void MoveToNextState(TStates aNextState); + void InternalizeL(RReadStream& aReadStream); + void Cleanup(); + static TInt MaxSupportedVersion(); + + //AO to handle multiple wait timeout + class CMultipleWaitTimer : public CTimer + { + public: + static CMultipleWaitTimer* NewL(CCmdMultipleWait& aMultipleWaitCmd); + ~CMultipleWaitTimer(); + void StartTimer(TInt32 aTimeout); + + protected: + // from CActive + void RunL(); + + private: + void ConstructL(); + CMultipleWaitTimer(CCmdMultipleWait& aMultipleWaitCmd); + + private: + CCmdMultipleWait& iMultipleWaitCmd; + }; + +protected: + // from CActive + void RunL(); + void DoCancel(); + TInt RunError(TInt aError); + +private: + RPointerArray iDeferredCommands; + TInt32 iTimeout; + CMultipleWaitTimer* iMultipleWaitTimer; + + // data members for maintaining internal state of multiple wait + // index of the current deferred command + TInt iCommandIndex; + // internal state maintained by MULTIPLE_WAIT command + TStates iInternalState; + TInt iCommandError; + }; + +#endif // __CMDMULTIPLEWAIT_H__