1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
2<html xml:lang="en-US" lang="en-US" xmlns="http://www.w3.org/1999/xhtml">
3  <head>
4    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
5    <meta http-equiv="Content-Style-Type" content="text/css" />
6    <link rel="stylesheet" href="../../css/manpage.css" type="text/css" />
7<title>SetDeviceMemorySize</title>
8  </head>
9  <body>
10<h1><CODE><a href="../../nn/Overview.html">nn</a>::<a href="../../nn/os/Overview.html">os</a>::SetDeviceMemorySize</CODE> Function</h1>
11<h2>Syntax</h2>
12    <div class="section">
13      <pre class="definition">#include &lt;nn/os.h&gt;
14
15<a href="../../nn/Result/Overview.html">Result</a> SetDeviceMemorySize(
16     size_t size
17);
18</pre>
19    </div>
20<h2>Parameters</h2>
21    <div class="section">
22      <table class="arguments">
23        <thead>
24          <tr>
25            <td width="15" />
26<th>Name</th>
27<td>Description</td>
28          </tr>
29        </thead>
30        <tr>
31<td>in</td>
32<th><CODE>size</CODE></th>
33<td>Specifies the new device memory size. The <SPAN class="argument">size</SPAN> argument must be a multiple of <CODE>4096</CODE>. It is possible to reset a different size of device memory, but when doing so both the size before changing and the size after changing must be multiples of <CODE>1048576</CODE> (1 MB).</td>
34        </tr> </table>
35    </div>
36<h2>Return Values</h2>
37<div class="section">Returns the result of the operation. </div>
38<h2>Description</h2>
39    <div class="section">
40<p>Changes the size of the device memory.</p><p>
41Changes the size of the device memory. Device memory is not yet allocated immediately after the application has started, so here you specify the necessary size of memory and newly allocate the region.
42            </p><p>
43When reconfiguring the memory, if the size of the region will be smaller after the change, the unneeded portion is deallocated from the end of the region and the rest of the contents (from the start of the memory region for the full reconfigured size) are retained. If the memory size is enlarged by the reconfiguration, a new region is added to the end of the existing allocated region. (In this case, the memory sizes before and after the change must both be a multiple of 1MB.)
44            </p><p>
45If <CODE>0</CODE> is specified for the size,  the entire memory region is released. If the region is released and then reallocated, the contents of the region are not guaranteed.
46            </p><p>
47If you specify a size of memory that does not adhere to the designated multiple, <CODE>nn::os::ResultMisalignedSize</CODE> will return.
48            </p></div>
49<h2>Revision History</h2>
50    <div class="section">
51      <dl class="history">
52        <dt>2011/06/22</dt>
53<dd>Added <B>Description</B>.
54        </dd>
55        <dt>2010/06/14</dt>
56<dd>Initial version.<br />
57        </dd>
58      </dl>
59    </div>
60  <hr><p>CONFIDENTIAL</p></body>
61</html>
62