Miles Sound System SDK 7.2a

AIL_MIDI_handle_reacquire

The function AIL_MIDI_handle_reacquire attempts to reacquire the hardware MIDI handle (the HMIDIOUT handle or the QuickTime MIDI handle) from the system.

S32 AIL_MIDI_handle_reacquire(
  HMDIDRIVER mdi
);

In Parameters

mdi: indicates the driver to try to reacquire.

Returns

Non-zero on success. Zero if the MIDI handle was still in use by the system.

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 restart any sequences that were playing when AIL_MIDI_handle_release was called.

Important!! Note that this function can fail if the digital handle is still in use, and that there is a slight delay from when a digital handle is freed to when that handle becomes available again. So, if you place this call in your WM_ACTIVATEAPP message handling code, you will have to retry the reacquire periodically if the call fails. See Demo.C for an example.

Under MacOS 9 and Win16, 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_release
Related Basic Types: HMDIDRIVER, S32