.\" Generated by the Allegro makedoc utility
.TH install_sound 3alleg4 "version 4.4.2" "Allegro" "Allegro manual"
.SH NAME
install_sound \- Initialises the sound module. Allegro game programming library.\&
.SH SYNOPSIS
.B #include <allegro.h>

.sp
.B int install_sound(int digi, int midi, const char *cfg_path);
.SH DESCRIPTION
Initialises the sound module. You should normally pass DIGI_AUTODETECT 
and MIDI_AUTODETECT as the driver parameters to this function, in which 
case Allegro will read hardware settings from the current configuration 
file. This allows the user to select different values with the setup 
utility: see the config section for details. Alternatively, see the 
platform specific documentation for a list of the available drivers. The 
cfg_path parameter is only present for compatibility with previous 
versions of Allegro, and has no effect on anything.
.SH "RETURN VALUE"
Returns zero if the sound is successfully installed, and -1 on failure.
If it fails it will store a description of the problem in allegro_error.

.SH SEE ALSO
.BR remove_sound (3alleg4),
.BR reserve_voices (3alleg4),
.BR detect_digi_driver (3alleg4),
.BR detect_midi_driver (3alleg4),
.BR set_volume (3alleg4),
.BR play_sample (3alleg4),
.BR play_midi (3alleg4),
.BR play_audio_stream (3alleg4),
.BR install_sound_input (3alleg4),
.BR allegro_error (3alleg4),
.BR set_mixer_quality (3alleg4),
.BR exmidi (3alleg4),
.BR exsample (3alleg4),
.BR exsprite (3alleg4),
.BR exstream (3alleg4)