1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<html>
3
4<head>
5<LINK rel="stylesheet" type="text/css" href="../../CSS/revolution.css">
6<title>AXSetMasterVolume</title>
7<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
8<META name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 6.5.0.0 for Windows">
9<META http-equiv="Content-Style-Type" content="text/css">
10</head>
11
12<body>
13
14<h1 align="left">AXSetMasterVolume</h1>
15
16<h2>C Specification</h2>
17
18<BLOCKQUOTE>
19<pre><code>#include &lt;revolution.h&gt;
20
21void AXSetMasterVolume(u16 volume);</code></pre>
22</BLOCKQUOTE>
23
24<h2>Arguments</h2>
25
26<table border="1" cellpadding="3" cellspacing="0.1">
27  <tr>
28<td width="120" bgcolor="#ffffe8"><em><strong><code>volume</code></strong></em></td>
29    <td width="520">Master volume value.</td>
30  </tr>
31</table>
32
33<h2>Return Values</h2>
34
35<p>
36None.
37</p>
38
39<H2>Description</H2>
40
41<p>The function <code>AXSetMasterVolume</code> configures the AX master volume. The volume is a 16-bit fixed point number (where the high-order bit represents the integer part and 15 bits the fractional part), and the selectable range is between 0x0000 (= 0.0) and 0x8000 (= 1.0). The default value is 0x8000 (= 1.0).</p>
42
43<p>The master volume value is applied to each sample immediately before sample data synthesized by DSP is output to main memory.</p>
44
45<p>If a value very different from the current value is set to the master volume (e.g., 0x8000 -&gt; 0x0000), it may result in generation of noise. Change the master volume gradually in appropriately timed steps within the application.</p>
46
47<p><strong><B>Note: </B>Master volume is not applied to Wii Remote speaker data.</strong></code>
48
49<H2>See Also</H2>
50
51<p>
52<code><a href="AXGetMasterVolume.html">AXGetMasterVolume</a></code>
53</p>
54
55<H2>Revision History</H2>
56
57<p>2006/10/23 Initial version.</p>
58
59<hr>
60<P>CONFIDENTIAL</p>
61</BODY>
62</HTML>