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_FlushCommand</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_FlushCommand <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_FlushCommand( u32 <var>flags</var> );</code><br></pre></dd>
18</dl>
19<div class="refsection" lang="ja"><a name="IDAIMWT"></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>flags</code></strong></em></td>
28<td>The flags</td>
29</tr>
30</tbody>
31</table>
32</div>
33
34    </div>
35<div class="refsection" lang="ja"><a name="IDAXMWT"></a>
36      <h2>Return Values</h2>
37
38      <p><code>TRUE</code> if command flush has succeeded. <code>FALSE</code> if it has failed.</p>
39    </div>
40<div class="refsection" lang="ja"><a name="IDA4MWT"></a>
41      <h2>Description</h2>
42      <p>
43This function issues reserved commands. ARM7 commands are not processed by the ARM7 until this function is called.
44</p>
45      <p>
46<code>SND_COMMAND_BLOCK</code> or <code>SND_COMMAND_NOBLOCK</code> can be specified in <em><strong><code>flags</code></strong></em>. When <code>SND_COMMAND_BLOCK</code> is specified, a block inside the function persists until the command issues successfully. When <code>SND_COMMAND_NOBLOCK</code> is specified, then <code>FALSE</code> is returned if the command fails to be issued.
47</p>
48      <p>
49<code>SND_COMMAND_IMMEDIATE</code> can also be by specified for the <strong><em><code>flags</code></em></strong> flag by including it with a logical OR operation. When <code>SND_COMMAND_IMMEDIATE</code> is specified, the issued command is processed immediately when the command issues successfully. When it is not specified, the command is processed when the next sound frame starts.
50</p>
51      <div class="note">
52<h3 class="title">Note</h3>
53<p>
54If there are no reserved commands, this function immediately returns <code>TRUE</code>, but note that there is no command process response.
55</p>
56</div>
57    </div>
58<h2>See Also</h2>
59<p>None.</p>
60<h2>Revision History</h2>
61<p>2005/03/01 Added the <code>SND_COMMAND_IMMEDIATE</code> flag<br /> 2005/02/17  Changed &quot;flush&quot; to &quot;issue&quot; in <strong>Description</strong><br /> 2004/07/20 Initial version</p>
62</div>
63<hr><p>CONFIDENTIAL</p></body>
64</html>
65