1<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"><html>
2<head>
3<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
4<title>SND_PrepareSeq</title>
5<link rel="stylesheet" href="../css/nitro.css" type="text/css">
6<meta name="generator" content="DocBook XSL Stylesheets V1.65.1">
7</head>
8<body>
9<div class="refentry" lang="ja"><a name="IDAFLWT"></a><div class="titlepage">
10<div></div>
11<div></div>
12</div>
13<h1>SND_PrepareSeq <IMG src="../image/NTR.gif" width="24" height="12" border="0" align=middle><IMG src="../image/TWL.gif" width="24" height="12" border="0" align=middle></h1>
14<h2>Syntax</h2>
15<dl>
16<dd><pre class="funcsynopsisinfo"><code>#include &lt;nitro/snd.h&gt;</code></pre></dd>
17<dd><pre class="funcprototype"><code class="funcprototype">void SND_PrepareSeq(
18        int <var>playerNo</var>,
19        const void* <var>base</var>,
20        u32 <var>offset</var>,
21        const SNDBankData* <var>bank</var> );</code><br></pre></dd>
22</dl>
23<div class="refsection" lang="ja"><a name="IDA3MWT"></a>
24      <h2>Arguments</h2>
25
26      <div class="variablelist">
27<table border="0">
28<col align="left" valign="top">
29<tbody>
30<tr>
31<td><em><strong><code>playerNo</code></strong></em></td>
32<td>The player number. Takes a value between 0 and 15.</td>
33</tr>
34<tr>
35<td><em><strong><code>base</code></strong></em></td>
36<td>The base address of the sequence data.</td>
37</tr>
38<tr>
39<td><em><strong><code>offset</code></strong></em></td>
40<td>The start position offset for the sequence data.</td>
41</tr>
42<tr>
43<td><em><strong><code>bank</code></strong></em></td>
44<td>This is the bank data pointer.</td>
45</tr>
46</tbody>
47</table>
48</div>
49    </div>
50<div class="refsection" lang="ja"><a name="IDABOWT"></a>
51      <h2>Return Values</h2>
52
53      <p>None.</p>
54    </div>
55<div class="refsection" lang="ja"><a name="IDAIOWT"></a>
56      <h2>Description</h2>
57      <p>
58Prepares the sequence for playback.
59</p>
60      <p>
61Prepares the sequence for playback on the player indicated by <code><strong><em>playerNo</em></strong></code>. Any sequence that is already being played on that player will be forcibly stopped.
62</p>
63      <p>
64Sequence data is processed from the offset position (<code><strong><em>offset</em></strong></code>) from the base address (<code><strong><em>base</em></strong></code>).
65</p>
66      <p>
67For bank, <em><strong><code>bank</code></strong></em>, specify the bank which the sequence uses for sound generation. The <tt class="function"><a href="SND_AssignWaveArc.html">SND_AssignWaveArc</a></tt> function must be used to combine the waveform archive with the <SPAN class="argument">bank</SPAN> in advance.
68</p>
69      <p>
70Call the <tt class="function"><a href="SND_StartPreparedSeq.html">SND_StartPreparedSeq</a></tt> function to play a sequence that has been prepared for playback.
71</p>
72      <div class="note">
73<h3 class="title">Note</h3>
74<p>
75This function is an ARM7 reserved function. After this function is called, its processing will occur only after the command is issued with the <tt class="function"><a href="SND_FlushCommand.html">SND_FlushCommand</a></tt> function.
76</p>
77<p>
78If program execution must be synchronized with process completion, first use the <tt class="function"><a href="SND_GetCurrentCommandTag.html">SND_GetCurrentCommandTag</a></tt> function to obtain the command tag immediately after calling this function. Then, after the command is issued, use the command tag and call either the <tt class="function"><a href="SND_IsFinishedCommandTag.html">SND_IsFinishedCommandTag</a></tt> or <tt class="function"><a href="SND_WaitForCommandProc.html">SND_WaitForCommandProc</a></tt> function to confirm that processing has finished or to wait for it to complete.
79</p>
80</div>
81    </div>
82<h2>See Also</h2>
83<p><code><a href="SND_AssignWaveArc.html">SND_AssignWaveArc</a>, <a href="SND_StartPreparedSeq.html">SND_StartPreparedSeq</a>, <a href="SND_FlushCommand.html">SND_FlushCommand</a>, <a href="SND_GetCurrentCommandTag.html">SND_GetCurrentCommandTag</a>, <a href="SND_IsFinishedCommandTag.html">SND_IsFinishedCommandTag</a>, <a href="SND_WaitForCommandProc.html">SND_WaitForCommandProc</a></code></p>
84<h2>Revision History</h2>
85<p>2005/04/14 Initial version.</p>
86</div>
87<hr><p>CONFIDENTIAL</p></body>
88</html>
89