NAME
play_midi - Starts playing the specified MIDI file. Allegro game
programming library.
SYNOPSIS
#include <allegro.h>
int play_midi(MIDI *midi, int loop);
DESCRIPTION
Starts playing the specified MIDI file, first stopping whatever music
was previously playing. If the loop flag is set to non-zero, the data
will be repeated until replaced with something else, otherwise it will
stop at the end of the file. Passing a NULL pointer will stop whatever
music is currently playing.
RETURN VALUE
Returns non-zero if an error occurs (this may happen if a patch-caching
wavetable driver is unable to load the required samples, or at least it
might in the future when somebody writes some patch-caching wavetable
drivers :-)
SEE ALSO
install_sound(3alleg), load_midi(3alleg), play_looped_midi(3alleg),
stop_midi(3alleg), midi_pause(3alleg), midi_seek(3alleg),
midi_pos(3alleg), midi_time(3alleg), midi_msg_callback(3alleg),
exmidi(3alleg)