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)

Allegro                                           version 4.4.3                               play_midi(3alleg4)