Provided by: liballegro-doc_4.2.2-3_all bug

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)