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>UpdateWaveBuffer</title>
8  </head>
9  <body>
10    <h1><CODE><a href="../../../../nn/Overview.html">nn</a>::<a href="../../../../nn/snd/Overview.html">snd</a>::<a href="../../../../nn/snd/CTR/Overview.html">CTR</a>::<a href="../../../../nn/snd/CTR/Voice/Overview.html">Voice</a>::UpdateWaveBuffer</CODE> Member Function</h1>
11    <h2>Syntax</h2>
12    <div class="section">
13      <pre class="definition">
14void UpdateWaveBuffer(
15     <a href="../../../../nn/snd/CTR/WaveBuffer/Overview.html">WaveBuffer</a> * pBuffer
16);
17</pre>
18    </div>
19    <h2>Arguments</h2>
20    <div class="section">
21      <table class="arguments">
22        <thead>
23          <tr>
24            <td width="15" />
25            <th>Name</th>
26            <td>Description</td>
27          </tr>
28        </thead>
29        <tr>
30          <td>in</td>
31          <th>pBuffer</th>
32          <td>Pointer to a buffer information structure.</td>
33        </tr> </table>
34    </div>
35    <h2>Return Values</h2>
36    <div class="section">
37                None.
38               </div>
39    <h2>Description</h2>
40    <div class="section">
41      <p>This updates buffer information appended to a voice.</p><p>
42        You must call this function immediately after updating the specified <CODE>WaveBuffer</CODE> information (<B>Note:</B> The parameters may be updated even if this function is not called). The only variables that can be modified are <CODE>sampleLength</CODE> and <CODE>loopFlag</CODE>. Behavior is not guaranteed if any other parameters are modified.
43      </p><p>
44        This function will have no effect if a pointer to a <CODE>WaveBuffer</CODE> that has not been appended is specified in the parameter. The actual update takes place when <CODE><a href="../../../../nn/snd/CTR/SendParameterToDsp.html">nn::snd::CTR::SendParameterToDsp</a></CODE> is called. For this reason, the <CODE>WaveBuffer</CODE> pointer specified in the parameter still may not be updated even if it has been appended (e.g., if the state of the <CODE>WaveBuffer</CODE> before the update is <CODE>nn::snd::CTR::WaveBuffer::STATUS_DONE</CODE>).
45      </p><p>
46        Note the following when modifying <CODE>sampleLength</CODE>.
47        <ul><li>
48            As described above, the update takes place when <CODE><a href="../../../../nn/snd/CTR/SendParameterToDsp.html">nn::snd::CTR::SendParameterToDsp</a></CODE> is called. Thus, even if <CODE>sampleLength</CODE> is smaller than the current value, it is possible that the latter portion of the buffer (the region after the new value) will be referenced immediately after this function is called.
49          </li><li>
50            If the newly specified <CODE>sampleLength</CODE> value is smaller than the current playback position, playback will stop immediately, or a buffer jump will be performed.
51          </li></ul></p></div>
52    <h2>Revision History</h2>
53    <div class="section">
54      <dl class="history">
55        <dt>2010/06/06</dt>
56        <dd>Initial version.<br />
57        </dd>
58      </dl>
59    </div>
60  <hr><p>CONFIDENTIAL</p></body>
61</html>