camerauis/cameraapp/generic/inc/CamMemoryMonitor.h
author Pat Downey <patd@symbian.org>
Wed, 01 Sep 2010 12:30:54 +0100
branchRCL_3
changeset 24 bac7acad7cb3
parent 0 1ddebce53859
permissions -rw-r--r--
Revert incorrect RCL_3 drop: Revision: 201033 Kit: 201035

/*
* 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:  Class that monitors free memory and attempts to free it if necessary
*
*/

#ifndef CAMMEMORYMONITOR_H
#define CAMMEMORYMONITOR_H

#include <e32base.h>
#include <oommonitorsession.h>


class CCamAppController;
class CCamAppUi;

/**
 * Class that monitors free memory and attempts to free it if necessary
 *
 */
class CCamMemoryMonitor : public CActive
{

public:

    static CCamMemoryMonitor* NewL( CCamAppUi* aAppUi, CCamAppController* aController );

    virtual ~CCamMemoryMonitor();

    /**
     * Start monitoring free memory. If available memory drop below given limit,
     * requests memory from OomManager.
     *
     * @param aLimit Monitored memory limit
     * @param aRequestAmount Amount of memory to be requested if below aLimit
     */
    void StartMonitoring( TInt aLimit, TInt aRequestAmount );

    /**
     * Start monitoring free memory. Uses default or previously given
     * values for limit and request amount
     */
    void StartMonitoring();

    /**
     * Stop monitoring free memory.
     *
     */
    void StopMonitoring();

    /**
     * Checks for free memory and requests more if below given limit.
     *
     * @param aLimit Memory limit to be checked
     * @param aRequestAmount Amount of memory to be requested if below aLimit
     * @param aShowNote If ETrue, note will be shown during memory request
     */
    TInt CheckAndRequestMemoryL( TInt aLimit, TInt aRequestAmount, TBool aShowNote );

    /**
     * Checks for free memory and requests more if below given limit. Uses
     * default values for limit and request amount.
     *
     * @param aShowNote If ETrue, note will be shown during memory request
     */
    TInt CheckAndRequestMemoryL( TBool aShowNote );



    void RunL();
    void DoCancel();

private:
    CCamMemoryMonitor( CCamAppUi* aAppUi, CCamAppController* aController );
    void ConstructL();

    static TInt MemoryCheck( TAny* aPtr );

    void CheckMemory();
private:
    // data

    TInt iLimit;
    TInt iRequestAmount;

    CCamAppUi* iAppUi;
    CCamAppController* iController;
    CPeriodic* iMemoryCheckTimer;
    ROomMonitorSession iOomMonitor;
};

#endif /* CCAMMEMORYMONITOR_H_ */