install_sound man page

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


#include <allegro.h>

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


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(3), reserve_voices(3), detect_digi_driver(3), detect_midi_driver(3), set_volume(3), play_sample(3), play_midi(3), play_audio_stream(3), install_sound_input(3), allegro_error(3), set_mixer_quality(3), exmidi(3), exsample(3), exsprite(3), exstream(3)

Referenced By

allegro_error(3), detect_digi_driver(3), detect_midi_driver(3), exmidi(3), exsample(3), exsprite(3), exstream(3), install_sound_input(3), load_ibk(3), load_midi_patches(3), midi_out(3), play_audio_stream(3), play_midi(3), play_sample(3), remove_sound(3), reserve_voices(3), set_hardware_volume(3), set_volume(3), set_volume_per_voice(3).

version 4.4.2 Allegro manual