linux man page for allocate_voice

allocate_voice(3alleg4) 					  Allegro manual					   allocate_voice(3alleg4)

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, cen-
       tre 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)

Allegro 							   version 4.4.2					   allocate_voice(3alleg4)