midi_seek
Section: Allegro manual (3)
Updated: version 4.2.2
Index
Return to Main Contents
NAME
midi_seek - Seeks to the given midi_pos in the current MIDI file. Allegro game programming library.
SYNOPSIS
#include <allegro.h>
int midi_seek(int target);
DESCRIPTION
Seeks to the given midi_pos in the current MIDI file. If the target is
earlier in the file than the current midi_pos it seeks from the
beginning; otherwise it seeks from the current position.
RETURN VALUE
Returns zero if it could successfully seek to the requested position.
Otherwise, a return value of 1 means it stopped playing, and midi_pos is
set to the negative length of the MIDI file (so you can use this function
to determine the length of a MIDI file). A return value of 2 means the
MIDI file looped back to the start.
SEE ALSO
play_midi(3),
midi_pos(3)