1install_sound(3) Allegro manual install_sound(3)
2
3
4
6 install_sound - Initialises the sound module. Allegro game programming
7 library.
8
10 #include <allegro.h>
11
12
13 int install_sound(int digi, int midi, const char *cfg_path);
14
16 Initialises the sound module. You should normally pass DIGI_AUTODETECT
17 and MIDI_AUTODETECT as the driver parameters to this function, in which
18 case Allegro will read hardware settings from the current configuration
19 file. This allows the user to select different values with the setup
20 utility: see the config section for details. Alternatively, see the
21 platform specific documentation for a list of the available drivers.
22 The cfg_path parameter is only present for compatibility with previous
23 versions of Allegro, and has no effect on anything.
24
26 Returns zero if the sound is successfully installed, and -1 on failure.
27 If it fails it will store a description of the problem in alle‐
28 gro_error.
29
30
32 remove_sound(3), reserve_voices(3), detect_digi_driver(3),
33 detect_midi_driver(3), set_volume(3), play_sample(3), play_midi(3),
34 play_audio_stream(3), install_sound_input(3), allegro_error(3),
35 set_mixer_quality(3), exmidi(3), exsample(3), exsprite(3), exstream(3)
36
37
38
39Allegro version 4.2.3 install_sound(3)