TwlIPL_commit-99/add-ins/TwlSystem/man/ja_JP/snd/NNS_SndHeapCreate.html

65 lines
2.2 KiB
HTML
Executable File

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"><html>
<head>
<META http-equiv="Content-Type" content="text/html; charset=Shift_JIS">
<title>NNS_SndHeapCreate</title>
<link rel="stylesheet" href="../css/nitro.css" type="text/css">
<meta name="generator" content="DocBook XSL Stylesheets V1.65.1">
</head>
<body>
<div class="refentry" lang="ja"><a name="IDAKKWT"></a><div class="titlepage">
<div></div>
<div></div>
</div>
<h1>NNS_SndHeapCreate</h1>
<h2>構文</h2>
<dl>
<dd><pre class="funcsynopsisinfo"><code>#include &lt;nnsys/snd.h&gt;</code></pre></dd>
<dd><pre class="funcprototype"><code class="funcprototype">NNSSndHeapHandle NNS_SndHeapCreate( void* <var>startAddress</var>, u32 <var>size</var> );</code><br></pre></dd>
</dl>
<div class="refsection" lang="ja"><a name="IDADMWT"></a>
<h2>引数</h2>
<div class="variablelist">
<table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><em><strong><code>startAddress</code></strong></em></td>
<td>ヒープとして使うメモリ領域の先頭アドレスです。</td>
</tr>
<tr>
<td><em><strong><code>size</code></strong></em></td>
<td>ヒープとして使うメモリ領域のサイズです。</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="refsection" lang="ja"><a name="IDAZMWT"></a>
<h2>返り値</h2>
<p>作成したヒープのハンドルを返します。作成に失敗すると、<span class="symbol">NNS_SND_HEAP_INVALID_HANDLE</span>を返します。</p>
</div>
<div class="refsection" lang="ja"><a name="IDADNWT"></a>
<h2>説明</h2>
<p>
サウンドヒープを作成します。
</p>
<p>
メモリ領域のサイズ<em><strong><code>size</code></strong></em>が十分に無いと、関数は失敗します。
また、ヒープの管理領域が必要なため、作成されたヒープのサイズは、<em><strong><code>size</code></strong></em>よりも小さくなります。
</p>
<p>
この関数に渡したメモリ領域を再利用するためには、
<tt class="function"><a href="NNS_SndHeapDestroy.html">NNS_SndHeapDestroy</a></tt>関数で、
ヒープを破壊する必要があります。
</p>
</div>
<h2>参照</h2>
<p><a href="NNS_SndHeapDestroy.html">NNS_SndHeapDestroy</a></p>
<h2>履歴</h2>
<p>2004/10/04 メモリ領域の再利用に関する説明追加<br>2004/06/01 初版<br></p>
</div>
</body>
</html>