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_GetNextInstData</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="IDAKKWT"></a><div class="titlepage">
10<div></div>
11<div></div>
12</div>
13<h1>SND_GetNextInstData <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">BOOL SND_GetNextInstData(
18        const SNDBankData* <var>bank</var>,
19        <a href="SNDInstData.html">SNDInstData</a>* <var>inst</var>,
20        SNDInstPos* <var>pos</var> );</code><br></pre></dd>
21</dl>
22<div class="refsection" lang="ja"><a name="IDA4LWT"></a>
23      <h2>Arguments</h2>
24
25      <div class="variablelist">
26<table border="0">
27<col align="left" valign="top">
28<tbody>
29<tr>
30<td><em><strong><code>bank</code></strong></em></td>
31<td>This is the bank data pointer.</td>
32</tr>
33<tr>
34<td><em><strong><code>inst</code></strong></em></td>
35<td>This is the pointer to the structure that stores the obtained instrument data.</td>
36</tr>
37<tr>
38<td><em><strong><code>pos</code></strong></em></td>
39<td>This is the instrument data positional information.</td>
40</tr>
41</tbody>
42</table>
43</div>
44
45    </div>
46<div class="refsection" lang="ja"><a name="IDA1MWT"></a>
47      <h2>Return Values</h2>
48
49      <p>Returns TRUE if the instrument data is successfully obtained. Returns FALSE if the next instrument data does not exist.</p>
50    </div>
51<div class="refsection" lang="ja"><a name="IDACNWT"></a>
52      <h2>Description</h2>
53      <p>
54Gets the instrument data in the bank data in order.
55</p>
56      <p>
57If the instrument data is successfully obtained, this function writes <code><a href="SNDInstData.html">SNDInstData</a></code>-type instrument data to the memory region designated with <em><strong><code>inst</code></strong></em>. Furthermore, <em><strong><code>pos</code></strong></em>, which indicates the instrument data positional information, is updated so that it indicates the position of the next instrument data.
58</p>
59      <p>
60When first calling this function, you must pass the instrument data's position, obtained with the <tt class="function"><a href="SND_GetFirstInstDataPos.html">SND_GetFirstInstDataPos</a></tt> function, to <SPAN class="argument">pos</SPAN>.
61</p>
62
63
64      <pre class="programlisting">
65    SNDInstPos pos = SND_GetFirstInstDataPos( bank );
66    SNDInstData inst;
67
68    while( SND_GetNextInstData( bank, &amp;inst, &amp;pos ) ) {
69        // Process to perform for the instrument
70    }
71</pre>
72    </div>
73<h2>See Also</h2>
74<p><code><a href="SNDInstData.html">SNDInstData</a></code>, <code><a href="SND_GetFirstInstDataPos.html">SND_GetFirstInstDataPos</a></code></p>
75<h2>Revision History</h2>
76<p>2005/01/20 Initial version.</p>
77</div>
78<hr><p>CONFIDENTIAL</p></body>
79</html>
80