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_SetChannelTimer</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_SetChannelTimer <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_SetChannelTimer( u32 <var>chBitMask</var>, int <var>timer</var> );</code><br></pre></dd> 18</dl> 19<div class="refsection" lang="ja"><a name="IDA4MWT"></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>chBitMask</code></strong></em></td> 28<td>The channel bit mask. It specifies which channels to control.</td> 29</tr> 30<tr> 31<td><em><strong><code>timer</code></strong></em></td> 32<td>The timer. Takes a value between 0x10 and 0xffff.</td> 33</tr> 34</tbody> 35</table> 36</div> 37 38 </div> 39<div class="refsection" lang="ja"><a name="IDAUNWT"></a> 40 <h2>Return Values</h2> 41 42 <p>None.</p> 43 </div> 44<div class="refsection" lang="ja"><a name="IDA1NWT"></a> 45 <h2>Description</h2> 46 <p> 47Changes the channel timer. 48</p> 49 <p> 50The 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. 51</p> 52 <p> 53<code>timer</code> specifies the number of clock ticks for outputting one sample. The number of ticks per second is approximately 16.757 MHz with <code>SND_TIMER_CLOCK</code>. Thus, if you want to play the waveform data without changing the pitch, and the sampling rate is <em><strong><code>rate</code></strong></em> Hz, then you calculate <em><strong><code>timer</code></strong></em> as follows: 54</p> 55<pre class="programlisting"><em><strong><code>timer</code></strong></em> = <span class="symbol">SND_TIMER_CLOCK</span> / <em><strong><code>rate</code></strong></em></pre> 56 <p> 57 58</p> 59 <div class="note"> 60<h3 class="title">Note</h3> 61<p> 62This 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. 63</p> 64<p> 65If 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. 66</p> 67</div> 68 </div> 69<h2>See Also</h2> 70<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> 71<h2>Revision History</h2> 72<p> 732005/02/17 Added a note about ARM7 command processing. <br>2004/07/20 Initial version. 74</p> 75</div> 76<hr><p>CONFIDENTIAL</p></body> 77</html> 78
