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_StopTimer</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_StopTimer <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 <nitro/snd.h></code></pre></dd> 17<dd><pre class="funcprototype"><code class="funcprototype">void SND_StopTimer( 18 u32 <var>chBitMask</var>, 19 u32 <var>capBitMask</var>, 20 u32 <var>alarmBitMask</var>, 21 u32 <var>flags</var> );</code><br></pre></dd> 22</dl> 23<div class="refsection" lang="ja"><a name="IDAGNWT"></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>chBitMask</code></strong></em></td> 32<td>The channel bit mask. It specifies which channels to control.</td> 33</tr> 34<tr> 35<td><em><strong><code>capBitMask</code></strong></em></td> 36<td>The capture bit mask. It specifies which captures to control.</td> 37</tr> 38<tr> 39<td><em><strong><code>alarmBitMask</code></strong></em></td> 40<td>The alarm bit mask. It specifies which Sound alarms to control.</td> 41</tr> 42<tr> 43<td><em><strong><code>flags</code></strong></em></td> 44<td>Option flags.</td> 45</tr> 46</tbody> 47</table> 48</div> 49 50 </div> 51<div class="refsection" lang="ja"><a name="IDAKOWT"></a> 52 <h2>Return Values</h2> 53 54 <p>None.</p> 55 </div> 56<div class="refsection" lang="ja"><a name="IDAROWT"></a> 57 <h2>Description</h2> 58 <p> 59Stops timers. 60</p> 61 <p> 62By specifying numerous channels, captures and alarms all at once, you can stop them all with the same timing. The order is: channel -> capture -> alarm. 63</p> 64 <p> 65The channel bit mask <code>chBitMask</code> specifies which channels to control. The channels are represented in order, with the lowest bit representing channel 0. Only channels whose representative bits are standing are controlled. 66</p> 67 <p> 68The capture bit mask <code>capBitMask</code> specifies which captures to control. <code>SND_CAPTURE_0</code> would be ( 1 << <code>SND_CAPTURE_0</code> ), while <code>SND_CAPTURE_1</code> would be ( 1 << <code>SND_CAPTURE_1</code> ). Enter with a logical OR to specify both. 69</p> 70 <p> 71The Sound alarm bit mask <code>alarmBitMask</code> specifies which Sound alarms to control. The alarms are represented in order, with the lowest bit representing alarm 0. Only alarms whose representative bits are standing are controlled. 72</p> 73 <p> 74<code>flags</code> can take the value 0 or <code>SND_COMMAND_CHANNEL_HOLD</code>. When <code>flags</code> is set to <code>SND_COMMAND_CHANNEL_HOLD</code>, the final sample values continue to be output even after the channels stop. When <code>flags</code> is set to 0, the output level drops to 0 when the channels stop. 75</p> 76 <div class="note"> 77<h3 class="title">Note</h3> 78<p> 79This 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. 80</p> 81<p> 82If 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. 83</p> 84</div> 85 </div> 86<h2>See Also</h2> 87<p><code><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> 88<h2>Revision History</h2> 89<p> 902005/02/17 Added a note about ARM7 command processing. <br>2004/07/20 Initial version. 91</p> 92</div> 93<hr><p>CONFIDENTIAL</p></body> 94</html> 95