SYNInitSpecifyMem

C Specification

#include <revolution.h>
#include <revolution/syn.h>
void SYNInitSpecifyMem(void* mem);

Arguments

mem User allocated synthesizer memory.

Return Values

None.

Description

The SYNInitSpecifyMem function expands the SYNInit function to allow specification of library memory area.

The synthesizer needs a SYNVOICE structure for each voice to control voice. The synthesizer library defines the count AX_MAX_VOICES of SYNVOICE structures using static.

If the SYNInit function is used for the synthesizer initialization, the above SYNVOICE structures defined in the library are used for controlling voices.

Alternately, if this function is used in place of SYNInit function, the SYNVOICE structures allocated to the mem specified area are used for the control. Here, the SYNVOICE structures defined within the library will not be linked, so unnecessary SYNVOICE structures will not consume extra memory.

Use this function if you want to make the maximum voice count of the AX library smaller than AX_MAX_VOICES or you want to allocate SYNVOICE 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 SYNGetMemorySize macro.

The AX library initialization needs to be completed before this function is called. Also, this function needs to be called before any other synthesizer function.

See Also

SYNInit, SYNGetMemorySize

Revision History

2006/10/23 Initial version.


CONFIDENTIAL