Miles Sound System SDK 7.2a

AIL_register_beat_callback

The function AIL_register_beat_callback registers an application function to be called each time the relative beat count changes in any sequence played with the given driver.

AILBEATCB AIL_register_beat_callback(
  HMDIDRIVER mdi,
  AILBEATCB callback
);

In Parameters

mdi: indicates the driver whose beat transitions are to result in calls to the callback function.
callback: should be set to the address of an application function prototyped as an AILBEATCB callback.

Returns

The address of the previously-installed beat callback function.

Discussion

Most MSS functions can be safely invoked from within callback functions. Exceptions include driver-installation or driver-shutdown functions and any other functions which may perform DOS or BIOS calls, such as AIL_init_sequence. These exceptions are noted in the descriptions of the functions involved. If in doubt about whether a particular action may safely be performed from within a callback function, contact RAD Game Tools for assistance.

This function may be useful in interactive MIDI applications which need to perform certain actions based on beat transitions in sequences.

The beat/measure counts reported to the callback function are analogous to those provided by AIL_sequence_position. Refer to this function before using AIL_register_beat_callback!

Group: XMIDI Services
Related Functions: AILBEATCB, AIL_init_sequence, AIL_register_beat_callback, AIL_register_event_callback, AIL_register_prefix_callback, AIL_register_sequence_callback, AIL_register_timbre_callback, AIL_register_trigger_callback, AIL_sequence_position
Related Basic Types: HMDIDRIVER
Related FAQs: What's the deal with callbacks - are they threads, interrupts, system timers, or what?