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 <revolution.h> 18#include <revolution/mix.h> 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