ROomMonitorSession Class Reference

class ROomMonitorSession : public RSessionBase

Inherits from

Public Member Functions
IMPORT_C void CancelRequestFreeMemory ()
IMPORT_C TInt Connect ()
IMPORT_C TInt RequestFreeMemory ( TInt )
IMPORT_C void RequestFreeMemory ( TInt , TRequestStatus &)
IMPORT_C TInt RequestOptionalRam ( TInt , TInt , TInt , TInt &)
IMPORT_C void RequestOptionalRam ( TInt , TInt , TInt , TRequestStatus &)
IMPORT_C void SetOomPriority ( TOomPriority )
IMPORT_C void ThisAppIsNotExiting ( TInt )
Inherited Functions
RHandleBase::Attributes()const
RHandleBase::BTraceId()const
RHandleBase::Close()
RHandleBase::DoExtendedClose()
RHandleBase::Duplicate(const RThread &,TOwnerType)
RHandleBase::FullName()const
RHandleBase::FullName(TDes &)const
RHandleBase::Handle()const
RHandleBase::HandleInfo(THandleInfo *)
RHandleBase::Name()const
RHandleBase::NotifyDestruction(TRequestStatus &)
RHandleBase::Open(const TFindHandleBase &,TOwnerType)
RHandleBase::OpenByName(const TDesC &,TOwnerType,TInt)
RHandleBase::RHandleBase()
RHandleBase::RHandleBase(TInt)
RHandleBase::SetHandle(TInt)
RHandleBase::SetHandleNC(TInt)
RSessionBase::CreateSession(RServer2,const TVersion &)
RSessionBase::CreateSession(RServer2,const TVersion &,TInt)
RSessionBase::CreateSession(RServer2,const TVersion &,TInt,TIpcSessionType,const TSecurityPolicy *,TRequestStatus *)
RSessionBase::CreateSession(const TDesC &,const TVersion &)
RSessionBase::CreateSession(const TDesC &,const TVersion &,TInt)
RSessionBase::CreateSession(const TDesC &,const TVersion &,TInt,TIpcSessionType,const TSecurityPolicy *,TRequestStatus *)
RSessionBase::CreateSession(const TDesC &,const TVersion &,TInt,TRequestStatus *)
RSessionBase::Open(RMessagePtr2,TInt,TOwnerType)
RSessionBase::Open(RMessagePtr2,TInt,const TSecurityPolicy &,TOwnerType)
RSessionBase::Open(TInt,TOwnerType)
RSessionBase::Open(TInt,const TSecurityPolicy &,TOwnerType)
RSessionBase::Send(TInt)const
RSessionBase::Send(TInt,const TIpcArgs &)const
RSessionBase::SendReceive(TInt)const
RSessionBase::SendReceive(TInt,TRequestStatus &)const
RSessionBase::SendReceive(TInt,const TIpcArgs &)const
RSessionBase::SendReceive(TInt,const TIpcArgs &,TRequestStatus &)const
RSessionBase::SetReturnedHandle(TInt)
RSessionBase::SetReturnedHandle(TInt,RHandleBase &)
RSessionBase::SetReturnedHandle(TInt,const TSecurityPolicy &)
RSessionBase::ShareAuto()
RSessionBase::ShareProtected()
Public Member Enumerations
enum TOomPriority { EOomPriorityNormal  = 0, EOomPriorityHigh , EOomPriorityBusy }
Inherited Enumerations
RHandleBase:TAttributes
RSessionBase:TAttachMode
Inherited Attributes
RHandleBase::iHandle

Member Functions Documentation

CancelRequestFreeMemory()

IMPORT_C void CancelRequestFreeMemory ( )

Cancels the asynchronous request for free memory.

Connect()

IMPORT_C TInt Connect ( )

Connects a new session. Sessions must be connected before any other APIs can be used. When the client has finished using a session, Close() must be called.

RequestFreeMemory(TInt)

IMPORT_C TInt RequestFreeMemory ( TInt aBytesRequested )

Request that the OOM monitor attempts to free some memory. This function may take several seconds to execute, depending on the memory state. It will not return until the attempt to recover memory has completed.

Parameters

TInt aBytesRequested The number of bytes of free memory that the client requests.

RequestFreeMemory(TInt, TRequestStatus &)

IMPORT_C void RequestFreeMemory ( TInt aBytesRequested,
TRequestStatus & aStatus
)

Request that the OOM monitor attempts to free some memory. This is an asynchronous version of the request for free memory.

Parameters

TInt aBytesRequested The number of bytes of free memory that the client requests.
TRequestStatus & aStatus will be completed when the attempt to recover memory has finished. This may take several seconds, depending on the memory state. On completion, aStatus will be set to KErrNone if the request memory is free. KErrNoMemory if that amount of memory could not be recovered. Other error codes may also be set.

RequestOptionalRam(TInt, TInt, TInt, TInt &)

IMPORT_C TInt RequestOptionalRam ( TInt aBytesRequested,
TInt aMinimumBytesNeeded,
TInt aPluginId,
TInt & aBytesAvailable
)

Request that the OOM monitor attempts to free some memory for an optional allocation. The passed in plugin ID is used to determine the priority for this allocation. Lower priority OOM actions may be executed to free enough RAM for this allocation. This function may take several seconds to execute, depending on the memory state. It will not return until the attempt to recover memory has completed.

Parameters

TInt aBytesRequested The number of bytes of free memory that the client requests.
TInt aMinimumBytesNeeded
TInt aPluginId The ID of the plugin that may delete the allocation in event of low memory.
TInt & aBytesAvailable

RequestOptionalRam(TInt, TInt, TInt, TRequestStatus &)

IMPORT_C void RequestOptionalRam ( TInt aBytesRequested,
TInt aMinimumBytesNeeded,
TInt aPluginId,
TRequestStatus & aStatus
)

Request that the OOM monitor attempts to free some memory for an optional allocation. The passed in plugin ID is used to determine the priority for this allocation. Lower priority OOM actions may be executed to free enough RAM for this allocation. This function may take several seconds to execute, depending on the memory state. It will not return until the attempt to recover memory has completed.

Parameters

TInt aBytesRequested The number of bytes of free memory that the client requests.
TInt aMinimumBytesNeeded
TInt aPluginId The ID of the plugin that may delete the allocation in event of low memory.
TRequestStatus & aStatus The TRequestStatus (completes with the number of bytes freed (aStatus >= 0) or an error (aStatus <= 0))

SetOomPriority(TOomPriority)

IMPORT_C void SetOomPriority ( TOomPriority aPriority )

Notify the OOM monitor that this application has the specified priority

Parameters

TOomPriority aPriority the priority of the application

ThisAppIsNotExiting(TInt)

IMPORT_C void ThisAppIsNotExiting ( TInt aWgId )

Notify the OOM monitor that this application is not responding to the EEikCmdExit request to exit the application. This function is used by the Avkon framework's app shutter.

Parameters

TInt aWgId the window group identifier of the app that is not exiting.

Member Enumerations Documentation

Enum TOomPriority

Defines the application priorities of OOM monitor.

Enumerators

EOomPriorityNormal = 0

Application can be closed if needed.

EOomPriorityHigh

Application should not be closed if possible.

EOomPriorityBusy

Application is busy and should not be closed.