Provided by: allegro5-doc_5.0.11-2_all 

NAME
al_attach_sample_instance_to_voice - Allegro 5 API
SYNOPSIS
#include <allegro5/allegro_audio.h>
bool al_attach_sample_instance_to_voice(ALLEGRO_SAMPLE_INSTANCE *spl,
ALLEGRO_VOICE *voice)
DESCRIPTION
Attaches a sample to a voice, and allows it to play. The sample's volume and loop mode will be ignored,
and it must have the same frequency and depth (including signed-ness) as the voice. This function may
fail if the selected driver doesn't support preloading sample data.
At this time, we don't recommend attaching samples directly to voices. Use a mixer in between.
Returns true on success, false on failure.
SEE ALSO
al_detach_voice(3alleg5)
al_attach_sample_instance... Allegro reference manual()