1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
2<html xml:lang="en-US" lang="en-US" xmlns="http://www.w3.org/1999/xhtml">
3  <head>
4    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
5    <meta http-equiv="Content-Style-Type" content="text/css" />
6    <link rel="stylesheet" href="../../../css/manpage.css" type="text/css" />
7    <title>GetSoundThreadTickCount</title>
8  </head>
9  <body>
10    <h1><CODE><a href="../../../nw/Overview.html">nw</a>::<a href="../../../nw/snd/Overview.html">snd</a>::<a href="../../../nw/snd/SoundSystem/Overview.html">SoundSystem</a>::GetSoundThreadTickCount</CODE> Member Function</h1>
11    <h2>Syntax</h2>
12    <div class="section">
13      <pre class="definition">#include &lt;nw/snd/snd_SoundSystem.h&gt;
14
15static void GetSoundThreadTickCount(
16     nn::os::Tick & tick,
17     int & count
18);
19</pre>
20    </div>
21    <h2>Arguments</h2>
22    <div class="section">
23      <table class="arguments">
24        <thead>
25          <tr>
26            <td width="15" />
27            <th>Name</th>
28            <td>Description</td>
29          </tr>
30        </thead>
31        <tr>
32          <td>out</td>
33          <th>tick</th>
34          <td>Cumulative processing time within the sound thread.</td>
35        </tr>
36        <tr>
37          <td>out</td>
38          <th>count</th>
39          <td>Number of sound thread operations.</td>
40        </tr> </table>
41    </div>
42    <h2>Return Values</h2>
43    <div class="section">
44                None.
45               </div>
46    <h2>Description</h2>
47    <div class="section">
48      <p>Gets the cumulative processing time of and the number of operations that occurred within the sound thread process.</p><p>Sound thread operations are run periodically (every 5 ms; or to be more precise, every <a href="../../../nw/snd/SoundSystem/SOUND_THREAD_INTERVAL_USEC.html"><CODE>SOUND_THREAD_INTERVAL_USEC</CODE></a> microseconds). As a result, if this function is called 60 times a second (once every 16.67 ms or so), the operation count will be between three and four. The cumulative processing time is the time spent on sound thread operations for those three or four operations.</p><p>The time required for processing is calculated as the difference between the beginning and end time of the sound thread. Note that as a result, if the CPU switches to another thread while a sound thread is running, the processing time that is returned will include the time spent running the other thread.</p><p>The processing time includes the time spent running <CODE>nn::snd::WaitForDspSync</CODE> and <CODE>nn::snd::SendParameterToDsp</CODE> in addition to the time spent processing the NW4C sound library hierarchy.</p><p>The <a href="../../../nw/snd/SoundSystem/ClearSoundThreadTickCount.html">ClearSoundThreadTickCount</a> function can clear the cumulative processing time and the operation count to zero.</p></div>
49    <h2>See Also</h2>
50    <div class="section">
51      <p class="reference"><a href="../../../nw/snd/SoundSystem/ClearSoundThreadTickCount.html"><CODE>ClearSoundThreadTickCount</CODE></a><br /><a href="../../../nw/snd/SoundSystem/SOUND_THREAD_INTERVAL_USEC.html"><CODE>SOUND_THREAD_INTERVAL_USEC</CODE></a><br /> </p>
52    </div>
53    <h2>Revision History</h2>
54    <div class="section">
55      <dl class="history">
56        <dt>2010/12/10</dt>
57        <dd>Deleted description of PC version.<br />
58        </dd>
59        <dt>2010/05/08</dt>
60        <dd>Eliminated the <CODE>GetSoundThreadProcessTick</CODE> function, and added this function.
61        </dd>
62      </dl>
63    </div>
64  <hr><p>CONFIDENTIAL</p></body>
65</html>