--- name: "install_sound" section: "3alleg" platform: "linux" package: "liballegro-doc" version: "2:4.2.2-2.2" release: "Debian 6.0 (Squeeze)" platforms: ["linux"] url: "https://new.carta.tech/install_sound" --- # install\_sound(3alleg) Initialises the sound module. Allegro game programming library. ## NAME install\_sound - Initialises the sound module. Allegro game programming library. ## SYNOPSIS **#include \** **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 allegro\_error. ## SEE ALSO [**remove\_sound**(3alleg)](/remove_sound/3alleg.md), [**reserve\_voices**(3alleg)](/reserve_voices/3alleg.md), [**detect\_digi\_driver**(3alleg)](/detect_digi_driver/3alleg.md), [**detect\_midi\_driver**(3alleg)](/detect_midi_driver/3alleg.md), [**set\_volume**(3alleg)](/set_volume/3alleg.md), [**play\_sample**(3alleg)](/play_sample/3alleg.md), [**play\_midi**(3alleg)](/play_midi/3alleg.md), [**play\_audio\_stream**(3alleg)](/play_audio_stream/3alleg.md), [**install\_sound\_input**(3alleg)](/install_sound_input/3alleg.md), [**allegro\_error**(3alleg)](/allegro_error/3alleg.md), [**set\_mixer\_quality**(3alleg)](/set_mixer_quality/3alleg.md), [**exmidi**(3alleg)](/exmidi/3alleg.md), [**exsample**(3alleg)](/exsample/3alleg.md), [**exsprite**(3alleg)](/exsprite/3alleg.md), [**exstream**(3alleg)](/exstream/3alleg.md)