install_sound(3alleg4)						  Allegro manual					    install_sound(3alleg4)

NAME

       install_sound - Initialises the sound module. Allegro game programming library.

SYNOPSIS

       #include <allegro.h>

       int install_sound(int digi, int midi, const char *cfg_path);

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.

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  alle-
       gro_error.

SEE ALSO

       remove_sound(3alleg4),  reserve_voices(3alleg4),  detect_digi_driver(3alleg4),  detect_midi_driver(3alleg4), set_volume(3alleg4), play_sam-
       ple(3alleg4),  play_midi(3alleg4),  play_audio_stream(3alleg4),	 install_sound_input(3alleg4),	 allegro_error(3alleg4),   set_mixer_qual-
       ity(3alleg4), exmidi(3alleg4), exsample(3alleg4), exsprite(3alleg4), exstream(3alleg4)

Allegro 							   version 4.4.2					    install_sound(3alleg4)