<?xml version="1.0" encoding="utf-8"?>

<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->

<!-- This component and the accompanying materials are made available under the terms of the License 

"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: 

-->

<!DOCTYPE task

  PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">

<task id="GUID-217C992B-AC56-42A7-9920-DEC891D233A5" xml:lang="en"><title>Allowing

Optional RAM Allocation</title><shortdesc>This section describes how an application can request from OOM

Monitor for optional RAM allocation.</shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody>

<context id="GUID-8D7EAD4C-3F9D-457C-8162-37FC14E748A6">       <p>An application

can allocate RAM optionally by calling the <xref href="GUID-02D1911A-D2E5-3D28-9B05-75DA0A75DE73.dita#GUID-02D1911A-D2E5-3D28-9B05-75DA0A75DE73/GUID-BE322080-5193-3D8E-9425-C6BEA920ED2E"><apiname>ROomMonitorSession::RequestFreeMemory()</apiname></xref> method.

For more information on optional RAM, refer to <xref href="GUID-7D727FC9-EF32-49FD-B72E-E1E00315206E.dita">Optional

RAM Allocation</xref>.</p><p>An application can release the optional RAM allocation

as soon as it is not needed anymore. An application can also keep the optional

RAM allocation until OOM Monitor requests to release it.</p> 

   </context>

<steps id="GUID-4DD07DEC-6017-4237-BE46-1D69E5FBD744-GENID-1-8-1-10-1-1-8-1-5-1-6-1-7-1-3-2">

<step id="GUID-83631E4F-71D0-4FD2-8FD6-46689AAFA761-GENID-1-8-1-10-1-1-8-1-5-1-6-1-7-1-3-2-1"><cmd>Create an OOM Monitor

session.</cmd>

<info><codeblock xml:space="preserve">ROomMonitorSession ioomMonitorSession;

CleanUpClosePushL(ioomMonitorSession);

User::LeaveIfError(ioomMonitorSession.Connect());

</codeblock></info>

</step>

<step id="GUID-83631E4F-71D0-4FD2-8FD6-46689AAFA761-GENID-1-8-1-10-1-1-8-1-5-1-6-1-7-1-3-2-2"><cmd>Request for optional

RAM.</cmd>

<info><codeblock xml:space="preserve">iOomMonitorSession.RequestOptionalRam(aBytesRequested,aMinimumBytesNeeded,aPluginId,aBytesAvailable);

</codeblock><p/></info>

</step>

<step id="GUID-5B3E8176-528F-45E7-B1CE-57ADCFAB5C6C-GENID-1-8-1-10-1-1-8-1-5-1-6-1-7-1-3-2-3"><cmd>Close the session.</cmd>

<info><codeblock xml:space="preserve">iOomMonitorSession.Close();

</codeblock></info>

</step>

</steps>

</taskbody><related-links>

<link href="GUID-DB6F586B-932A-4BDC-BA48-79C7D3FD9931.dita"><linktext>OOM Monitor

Plug-in</linktext></link>

<link href="GUID-39A8FBC9-5FD6-4F92-B71E-5C5438ECFD46.dita"><linktext>OOM Monitor

Overview</linktext></link>

<link href="GUID-88752800-83BD-4845-80A0-6B65D8D81924.dita"><linktext>OOM Monitor

Reference</linktext></link>

</related-links></task>