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_ReadDriverInfo</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_ReadDriverInfo <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_ReadDriverInfo( struct SNDDriverInfo* <var>info</var> );</code><br></pre></dd>
18</dl>
19<div class="refsection" lang="ja"><a name="IDARMWT"></a>
20      <h2>Arguments</h2>
21
22      <div class="variablelist">
23<table border="0">
24<col align="left" valign="top">
25<tbody>
26<tr>
27<td><em><strong><code>info</code></strong></em></td>
28<td>Pointer to the driver information structure to store the read information</td>
29</tr>
30</tbody>
31</table>
32</div>
33
34    </div>
35<div class="refsection" lang="ja"><a name="IDAANWT"></a>
36      <h2>Return Values</h2>
37
38      <p>None.</p>
39    </div>
40<div class="refsection" lang="ja"><a name="IDAHNWT"></a>
41      <h2>Description</h2>
42      <p>
43Reads the sound driver information.
44</p>
45      <p>
46The information that was read is stored in <strong><em><code>info</code></em></strong>, the sound driver structure. Once the read completes, call the <tt class="function"><a href="SND_ReadChannelInfo.html">SND_ReadChannelInfo</a></tt>, <tt class="function"><a href="SND_ReadPlayerInfo.html">SND_ReadPlayerInfo</a></tt>, and <tt class="function"><a href="SND_ReadTrackInfo.html">SND_ReadTrackInfo</a></tt> functions to extract the necessary information from the sound driver information structure.
47</p>
48      <div class="note">
49<h3 class="title">Note</h3>
50<p>
51Note that information that was read is written directly to memory. Accordingly, when data remains in the cache, you must delete it with <tt class="function"><a href="../os/cache/DC_InvalidateRange.html">DC_InvalidateRange</a></tt> or a similar function before referencing the information.
52</p>
53<p>
54The memory region indicated by the pointer passed to the argument cannot be deleted until the process on ARM7 completes.
55        </p>
56<p>
57This function is an ARM7 command scheduling 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.
58</p>
59<p>
60If 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.
61</p>
62</div>
63    </div>
64<h2>See Also</h2>
65<p><code><a href="SND_ReadChannelInfo.html">SND_ReadChannelInfo</a>, <a href="SND_ReadPlayerInfo.html">SND_ReadPlayerInfo</a>, <a href="SND_ReadTrackInfo.html">SND_ReadTrackInfo</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>
66<h2>Revision History</h2>
67<p>2005/02/17 Initial version.</p>
68</div>
69<hr><p>CONFIDENTIAL</p></body>
70</html>
71