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_ReadInstData</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_ReadInstData <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_ReadInstData(
18        const SNDBankData* <var>bank</var>,
19        int <var>prgNo</var>,
20        int <var>key</var>,
21        <a href="SNDInstData.html">SNDInstData</a>* <var>inst</var> );</code><br></pre></dd>
22</dl>
23<div class="refsection" lang="ja"><a name="IDACMWT"></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><font face="Courier New">bank</font></strong></em></td>
32<td>This is the bank data pointer.</td>
33</tr>
34<tr>
35<td><em><strong><font face="Courier New">prgNo</font></strong></em></td>
36<td>The program number.</td>
37</tr>
38<tr>
39<td><em><strong><font face="Courier New">key</font></strong></em></td>
40<td>The key number.</td>
41</tr>
42<tr>
43<td><em><strong><font face="Courier New">inst</font></strong></em></td>
44<td>The pointer to the structure where the instrument data are stored when read.</td>
45</tr>
46</tbody>
47</table>
48</div>
49
50    </div>
51<div class="refsection" lang="ja"><a name="IDAGNWT"></a>
52      <h2>Return Values</h2>
53
54      <p>
55TRUE if the read succeeds. FALSE if it fails.<br>If TRUE is returned, the correct information has been stored in <code>inst</code>.
56</p>
57    </div>
58<div class="refsection" lang="ja"><a name="IDAQNWT"></a>
59      <h2>Description</h2>
60      <p>
61Reads the instrument data from the specified <code>bank</code> and loads it into the <code><a href="SNDInstData.html">SNDInstData</a></code> structure.
62</p>
63      <p>
64The function fails if an invalid program number is specified for <code>prgNo</code>.
65</p>
66      <p>
67If the program number specified for <code>prgNo</code> specifies a drum set or a key split, then the instrument data corresponding to the key number <code>key</code> gets read. If the the program number represents a normal instrument, then <code>key</code> is ignored.
68</p>
69    </div>
70<h2>See Also</h2>
71<p><a href="SNDInstData.html">SNDInstData</a></p>
72<h2>Revision History</h2>
73<p>2004/07/20 Initial version.</p>
74</div>
75<hr><p>CONFIDENTIAL</p></body>
76</html>
77