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

70 lines
3.0 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_SndArcPlayerSetup</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_SndArcPlayerSetup</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">BOOL NNS_SndArcPlayerSetup( NNSSndHeapHandle <var>heap</var> );</code><br></pre></dd>
</dl>
<div class="refsection" lang="ja"><a name="IDA5LWT"></a>
<h2>引数</h2>
<div class="variablelist">
<table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><em><strong><code>heap</code></strong></em></td>
<td>サウンドヒープハンドルです。</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="refsection" lang="ja"><a name="IDAOMWT"></a>
<h2>返り値</h2>
<p>セットアップに成功したかどうかを返します。</p>
</div>
<div class="refsection" lang="ja"><a name="IDAVMWT"></a>
<h2>説明</h2>
<p>
サウンドアーカイブで定義されているプレイヤー設定に基づいて、プレイヤーをセットアップします。
不要ならこの関数を呼ばずに初期設定をそのまま使うこともできますし、この関数を呼んだ後に設定を変更することもできます。
</p>
<p>
あらかじめ、
<tt class="function"><a href="NNS_SndArcInit.html">NNS_SndArcInit</a></tt>関数または、
<tt class="function"><a href="NNS_SndArcInitOnMemory.html">NNS_SndArcInitOnMemory</a></tt>関数で
サウンドアーカイブが初期化されている必要があります。
</p>
<p>
<em><strong><code>heap</code></strong></em>で指定したサウンドヒープから、プレイヤーヒープを作成するためのメモリが確保されます。
プレイヤーヒープを作成しない場合は、NULLを入れます。
指定したヒープから十分なメモリが確保できない場合、関数は失敗します。
</p>
<p>
関数内部では、サウンドアーカイブに格納されているプレイヤー情報に従い、
<tt class="function"><a href="NNS_SndPlayerSetPlayableSeqCount.html">NNS_SndPlayerSetPlayableSeqCount</a></tt>関数及び、
<tt class="function"><a href="NNS_SndPlayerSetAllocatableChannel.html">NNS_SndPlayerSetAllocatableChannel</a></tt>関数及び、
<tt class="function"><a href="NNS_SndPlayerCreateHeap.html">NNS_SndPlayerCreateHeap</a></tt>関数を呼びだしています。
</p>
</div>
<h2>参照</h2>
<p><a href="NNS_SndArcInit.html">NNS_SndArcInit</a>, <a href="NNS_SndArcInitOnMemory.html">NNS_SndArcInitOnMemory</a>, <a href="NNS_SndPlayerSetPlayableSeqCount.html">NNS_SndPlayerSetPlayableSeqCount</a>, <a href="NNS_SndPlayerSetAllocatableChannel.html">NNS_SndPlayerSetAllocatableChannel</a>, <a href="NNS_SndPlayerCreateHeap.html">NNS_SndPlayerCreateHeap</a></p>
<h2>履歴</h2>
<p>2005/01/05 NNS_SndPlayerSetAllocatableChannel呼び出し追加<br>2004/06/01 初版<br></p>
</div>
</body>
</html>