Provided by: allegro4-doc_4.4.2-7_all bug

NAME

       allocate_voice  -  Allocates  a  sound  card  voice for a sample. Allegro game programming
       library.

SYNOPSIS

       #include <allegro.h>

       int allocate_voice(const SAMPLE *spl);

DESCRIPTION

       Allocates a sound card voice and prepares it for playing the specified sample, setting  up
       sensible  default parameters (maximum volume, centre pan, no change of pitch, no looping).
       When you are finished with the voice you must free it  by  calling  deallocate_voice()  or
       release_voice().   Allegro can manage up to 256 simultaneous voices, but that limit may be
       lower due to hardware reasons.

RETURN VALUE

       Returns the voice number, or -1 if no voices are available.

SEE ALSO

       deallocate_voice(3alleg4),       reallocate_voice(3alleg4),        release_voice(3alleg4),
       load_sample(3alleg4)