Miles Sound System SDK 7.2a

AIL_MIDI_handle_release

The function AIL_MIDI_handle_release temporarily releases the hardware MIDI handle (the HMIDIOUT handle or the QuickTime MIDI handle) back to the system.

S32 AIL_MIDI_handle_release(
  HMDIDRIVER mdi
);

In Parameters

mdi: indicates the driver to release to the system.

Returns

Non-zero on success. Zero if the mdi parameter is null or invalid.

Discussion

This function is usually used with the AIL_MIDI_handle_release function in the WM_ACTIVATEAPP message processing code to allow other applications to play MIDI music.

This function will automatically pause any sequences that are currently playing. These sequences will then be automatically restarted when AIL_MIDI_handle_reacquire is called.

Under MacOS 9, this function must not be invoked from an interrupt-based callback function.

This function is not supported under DOS.

Example files that use this function: DEMO.C

Group: XMIDI Services
Related Functions: AIL_MIDI_handle_reacquire, AIL_MIDI_handle_release
Related Basic Types: HMDIDRIVER, MILES_SEQUENCE_STATUS, S32