al_reserve_samples(1) Allegro 5 API


#include <allegro5/allegro_audio.h>
bool al_reserve_samples(int reserve_samples)


Reserves a number of sample instances, attaching them to the default mixer. If no default mixer is set when this function is called, then it will create one and attach it to the default voice. If no default voice has been set, it, too, will be created.

This diagram illustrates the structures that are set up:

                                      sample instance 1
                                    / sample instance 2
default voice <-- default mixer <---         .
                                    \        .
                                      sample instance N

Returns true on success, false on error. al_install_audio(3alleg5) must have been called first.