int32 AllocAmplitude( int32 Amplitude )
AllocAmplitude() is a voluntary function that checks available system amplitude and allocates the requested amplitude (or less, if the amount requested is not available) to the calling task. It then marks that amplitude unavailable to other tasks making this call. When the task finishes using the amplitude, it should call FreeAmplitude() to make the amplitude available to other tasks. Note that this function is voluntary and doesn't restrict the amplitude actually used by a task; the only way it works is for all audio tasks to use this function. This call is necessary, because the output of the DSP is limited by the signed 16-bit precision of the digital-to-analog converter (DAC). If you add together signals whose amplitude exceeds the limit of 0x7FFF, the result will "wrap around," causing a horrendous noise. Rather than dictate a restriction on use of the DSP, we assume that programmers/composers will restrict themselves using whatever scheme they choose. It is necessary, however, to tell other tasks how much of the DSP precision you plan to use. You can allocate some or all of the amplitude for your task and then give it back when done.
FreeAmplitude()