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>MIXInitSpecifyMem</title>
7<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
8<META http-equiv="Content-Style-Type" content="text/css">
9</head>
10
11<body>
12
13<h1 align="left">MIXInitSpecifyMem</h1>
14
15<h2>Syntax</h2>
16<dl><dd><pre class="construction">
17#include &lt;revolution.h&gt;
18#include &lt;revolution/mix.h&gt;
19
20void MIXInitSpecifyMem(void* mem);
21</pre></dd></dl>
22
23<h2>Arguments</h2>
24<TABLE class="arguments" border="1" >
25  <tr>
26<th>mem</th>
27<td>User-allocated mixer memory area.</td>
28  </tr>
29</table>
30
31<h2>Return Values</h2>
32<p>None.</p>
33
34<h2>Description</h2>
35<p><code>MIXInitSpecifyMem</code> expands the <a href="MIXInit.html"><code>MIXInit</code></a> function to allow specification of the library memory area.</p>
36
37<p>To control a voice, the mixer needs the <code>MIXChannel</code> and <code>MIXRmtChannel</code> structures for each voice. Mixer library defines the count <code>AX_MAX_VOICES</code> structures using <code>static</code>.</p>
38
39<p>When <a href="MIXInit.html"><code>MIXInit</code></a> function is used for mixer initialization, the above <code>MIXChannel</code> and <code>MIXRmtChannel</code> structures defined in the library are used to control voices.</p>
40
41<p>Alternatively, if this function is used in place of <a href="MIXInit.html"><code>MIXInit</code></a>, the <code>MIXChannel</code> and <code>MIXRmtChannel</code> structures allocated to the area specified with <SPAN class="argument">mem</SPAN> are used for control. Here, the linkers for both structures defined within the library will not link, so unnecessary structures will not consume additional memory.</p>
42
43<p>Use this function if you wish to make the maximum voice count of the AX library smaller than <code>AX_MAX_VOICES</code>, or to allocate the <code>MIXChannel</code> and <code>MIXRmtChannel</code> structures to a memory of choice between MEM1 and MEM2.</p>
44
45<p>To obtain the size of the memory area specified with <SPAN class="argument">mem</SPAN>, use the <a href="MIXGetMemorySize.html"><code>MIXGetMemorySize</code></a> macro.</p>
46
47<p>The AX library initialization has to be completed before this function is called. This function needs to be called before any other mixer function.</p>
48
49<h2>See Also</h2>
50<p class="reference">
51<a href="MIXInit.html">MIXInit</a>,
52<a href="MIXGetMemorySize.html">MIXGetMemorySize</a>
53</p>
54
55<h2>Revision History</h2>
56<P>
572006/10/23 Initial version.<br>
58</P>
59
60<hr><p>CONFIDENTIAL</p></body>
61</html>
62