Miles Sound System SDK 7.2a

AIL_register_trigger_callback

The function AIL_register_trigger_callback registers an application function to be called whenever an XMIDI Callback Trigger controller (119) is encountered in a playing XMIDI sequence.

AILTRIGGERCB AIL_register_trigger_callback(
  HSEQUENCE S,
  AILTRIGGERCB callback
);

In Parameters

S: indicates the sequence with which the Callback Trigger function handler is to be associated.
callback: should be set to the address of an application function prototyped as an AILTRIGGERCB callback.

Returns

The address of the previously-installed Callback Trigger function handler.

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.

Group: XMIDI Services
Related Sections: XMIDI Callback Trigger (119)
Related Functions: AILTRIGGERCB, AIL_init_sequence, AIL_register_beat_callback, AIL_register_event_callback, AIL_register_prefix_callback, AIL_register_sequence_callback, AIL_register_timbre_callback
Related Basic Types: HSEQUENCE
Related FAQs: What's the deal with callbacks - are they threads, interrupts, system timers, or what?