debian 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)