#include <revolution.h>
#include <revolution/mix.h>void MIXInitSpecifyMem(void* mem);mem |
User allocated mixer memory. |
None.
The MIXInitSpecifyMem function expands the MIXInit function to allow specification of library memory area.
The mixer needs MIXChannel and MIXRmtChannel structures for each voice to control 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 function, the structures MIXChannel and MIXRmtChannel allocated to the mem specified area are used for the control. Here, the linkers for both structures defined within the library will not link, so unnecessary structures will not consume extra memory.
Use this function if you wish to make the maximum voice count of the AX library smaller than AX_MAX_VOICES or wish to allocate MIXChannel and MIXRmtChannel structures to a memory of choice between MEM1 and MEM2.
The size of the memory area specified by the argument mem may be obtained through the MIXGetMemorySize macro.
The AX library initialization needs to be completed before this function is called. Also, this function needs to be called before any other mixer API.
2006/10/23 Initial version.
CONFIDENTIAL