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>SetBuffer</title>
8  </head>
9  <body>
10<h1><CODE><a href="../../../nn/Overview.html">nn</a>::<a href="../../../nn/mic/Overview.html">mic</a>::<a href="../../../nn/mic/CTR/Overview.html">CTR</a>::SetBuffer</CODE> Function</h1>
11<h2>Syntax</h2>
12    <div class="section">
13      <pre class="definition">
14<a href="../../../nn/Result/Overview.html">Result</a> SetBuffer(
15     void * address,
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>address</CODE></th>
33<td>Specifies the starting address of the memory block.</td>
34        </tr>
35        <tr>
36<td>in</td>
37<th>size</th>
38<td>Specifies the size of the memory region.</td>
39        </tr> </table>
40    </div>
41<h2>Return Values</h2>
42<div class="section">Returns the result of the operation. <br />
43      <table class="arguments">
44        <thead>
45          <tr>
46<th>Value</th>
47<td>Description</td>
48          </tr>
49        </thead>
50        <tr>
51<th><CODE>Result::IsSuccess</CODE></th>
52<td>Process succeeded.</td>
53        </tr>
54        <tr>
55<th><CODE>ResultAlreadyInitialized</CODE></th>
56<td>A memory region has already been set.</td>
57        </tr>
58        <tr>
59<th><CODE>ResultMisalignedSize</CODE></th>
60<td>The specified memory region size is not 4096-byte aligned.</td>
61        </tr>
62        <tr>
63<th><CODE>ResultMisalignedAddress</CODE></th>
64<td>The specified memory region address is not 4096-byte aligned.</td>
65        </tr>
66        <tr>
67<th><CODE>ResultInvalidHandle</CODE></th>
68<td>The specified memory region is invalid.</td>
69        </tr>
70        <tr>
71<th><CODE>ResultInvalidSize</CODE></th>
72<td>The specified size is 0, which is invalid.</td>
73        </tr>
74      </table> </div>
75<h2>Description</h2>
76    <div class="section">
77<p>Sets the memory region in which to store the sampling results.</p><p>Set the memory that was obtained by the application. Device memory cannot be used.</p><p>This function cannot be called multiple times. To call this function more than once, you must first call the <a href="../../../nn/mic/CTR/ResetBuffer.html"><CODE>nn::mic::CTR::ResetBuffer</CODE></a> function.</p><p>The size of the memory region you specify must be aligned to 4096 bytes. The last four bytes of the specified memory region are used by the mic library for administrative purposes. Do not overwrite the last four bytes of this region. The size of the buffer in which the actual sampling results are saved is the size obtained using <a href="../../../nn/mic/CTR/GetSamplingBufferSize.html"><CODE>nn::mic::CTR::GetSamplingBufferSize</CODE></a>.</p><!-- write here --></div>
78<h2>Revision History</h2>
79    <div class="section">
80      <dl class="history">
81        <dt>2011/03/08</dt>
82<dd>Revised <B>Description</B>.<br />
83        </dd>
84        <dt>2010/12/18</dt>
85<dd>Revised the description of the return values.
86        </dd>
87        <dt>2010/06/23</dt>
88<dd>Initial version.<br />
89        </dd>
90      </dl>
91    </div>
92  <hr><p>CONFIDENTIAL</p></body>
93</html>
94