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(3alleg4), load_midi(3alleg4), play_looped_midi(3alleg4), stop_midi(3alleg4),
       midi_pause(3alleg4),     midi_seek(3alleg4),     midi_pos(3alleg4),    midi_time(3alleg4),
       midi_msg_callback(3alleg4), exmidi(3alleg4)