FMUSIC_SetRowCallback

Sets a user callback to occur on every row divisible by the rowstep parameter, played from a MOD, S3M, XM or IT file.

signed char F_API FMUSIC_SetRowCallback(
FMUSIC_MODULE *mod,
FMUSIC_CALLBACK callback,
int rowstep
);

Parameters

mod	The module or song to set the callback for.
callback	The callback function you supply to get called.
rowstep	Call the callback every multiple of this number of rows.

Return Value

On success, TRUE is returned.
On failure, FALSE is returned.

Remarks

It is important to note that this callback will be called from directly WITHIN the
mixer / music update thread, therefore it is imperative that whatever you do from this
callback be extremely efficient. If the routine takes too long then breakups in the sound
will occur, or it will basically stop mixing until you return from the function.
This sort of function is usually best for just setting a flag, or do some simple variable
manipulation, and then exiting, letting your main thread do what it needs to based on these
flags or variables.
------------
This callback is LATENCY adjusted, so that the callback happens when you HEAR the sound, not when it is mixed, for accurate synchronization.
Use FSOUND_INIT_DONTLATENCYADJUST if you want it to be called back at mix time, which is useful if you want to control the music interactively.
------------
Note : This function is not supported with the MIDI format.
___________________
Supported on the following platforms : Win32, WinCE, Linux, Macintosh, XBox, PlayStation 2, GameCube

[API function]