1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<html>
3
4<head>
5<title>AXInitEx</title>
6<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
7<META name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 6.5.0.0 for Windows">
8<META http-equiv="Content-Style-Type" content="text/css">
9<LINK rel="stylesheet" type="text/css" href="../../CSS/revolution.css">
10</head>
11
12<body>
13
14<h1 align="left">AXInitEx</h1>
15
16<h2>Syntax</h2>
17<dl><dd><pre class="construction">
18#include &lt;revolution/ax.h&gt;
19
20void AXInitEx(u32 outputBufferMode);
21</pre></dd></dl>
22
23<h2>Arguments</h2>
24<TABLE class="arguments" border="1" >
25  <tr>
26      <TH>outputBufferMode</TH>
27      <TD>
28      <TABLE class="arguments" border="1" >
29        <tr>
30<th>TRUE</th>
31<td>Chooses triple-buffer.</td>
32        </tr>
33        <tr>
34<th>FALSE</th>
35<td>Chooses double-buffer.</td>
36        </tr>
37      </table>
38    </TD>
39  </tr>
40</TABLE>
41
42<h2>Return Values</h2>
43<P>None.</P>
44
45<h2>Description</h2>
46<p>If <CODE>TRUE</CODE> is specified for the <SPAN class="argument">outputBufferMode</SPAN> argument, a triple-buffer structure is used for the output buffer. If <CODE>FALSE</CODE> is specified, a double-buffer structure is used for the output buffer. When triple-buffer is selected, it can prevent pop noises caused by a heavy DSP load. If a double-buffer structure is used, delays in sound output will be shorter than those seen with a triple buffer structure. With a triple-buffer structure, sound latency is increased by 3 milliseconds relative to a double-buffer structure.</p>
47
48<p>To initialize AX, this function or the <A href="AXInit.html"><code>AXInit</code></A> function must be called. If the <A href="AXInit.html"><code>AXInit</code></A> function is called, the double-buffer structure will be used.</p>
49
50<p><B>Note: This function calls the <code>AIRegisterDMACallback</code> function internally. Because of this, any AI DMA interrupt callback set using the <code>AIRegisterDMACallback</code> function before this function was called will be overwritten by the AX callback. If you are using an original AI DMA interrupt callback, be sure to set it using <code>AIRegisterDMACallback</code> only after calling this function.</B></p>
51
52<h2>See Also</h2>
53<P>
54<a href="AXInit.html"><CODE>AXInit</CODE></a><BR> <a href="../../ai/DMA/AIRegisterDMACallback.html"><CODE>AIRegisterDMACallback</CODE></a>
55</P>
56
57<H2>Revision History</H2>
58<P>
592008/12/26 Added a note about the AI DMA interrupt callback.<br>2006/10/24 Revised latency.<BR>2006/03/01 Initial version.
60</P>
61
62<hr><p>CONFIDENTIAL</p></body>
63</html>