#include <revolution.h> #include <revolution/mix.h> void MIXInitSpecifyMem(void* mem);
| mem | User-allocated mixer memory area. |
|---|
None.
MIXInitSpecifyMem expands the MIXInit function to allow specification of the library memory area.
To control a voice, the mixer needs the MIXChannel and MIXRmtChannel structures for each voice. Mixer library defines the count AX_MAX_VOICES structures using static.
When MIXInit function is used for mixer initialization, the above MIXChannel and MIXRmtChannel structures defined in the library are used to control voices.
Alternatively, if this function is used in place of MIXInit, the MIXChannel and MIXRmtChannel structures allocated to the area specified with mem 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.
Use this function if you wish to make the maximum voice count of the AX library smaller than AX_MAX_VOICES, or to allocate the MIXChannel and MIXRmtChannel structures to a memory of choice between MEM1 and MEM2.
To obtain the size of the memory area specified with mem, use the MIXGetMemorySize macro.
The AX library initialization has to be completed before this function is called. This function needs to be called before any other mixer function.
2006/10/23 Initial version.
CONFIDENTIAL