Miles Sound System SDK 7.2a

AIL_open_XMIDI_driver

The function AIL_open_XMIDI_driver opens an driver handle to play XMIDI data files through.

HMDIDRIVER AIL_open_XMIDI_driver(
  U32 flags
);

In Parameters

flags: 0 or one of the MILES_OPEN_XMIDI_FLAGS constants.

Returns

If successful, this function returns a non-zero handle to an XMIDI driver. If the driver failed to open, then 0 is returned (use AIL_last_error for the cause).

Discussion

This function will open an XMIDI driver on any of the Miles platforms.

Under Win32 and Win64, MSS can use a NULL MIDI driver for the Miles software synthesizer, or it can open the hardware midiOut drivers.

Under MacOS, MSS can use a NULL MIDI driver for the Miles software synthesizer, or it can open the QuickTime software synthesize (which is somewhat limited compared to the Miles synth).

Under DOS, MSS will call AIL_install_MDI_INI to load a real-mode DOS driver.

Example files that use this function: DEMO.C

Group: XMIDI Services
Related Functions: AIL_close_XMIDI_driver, AIL_install_MDI_INI, AIL_install_MDI_driver_file, AIL_last_error, AIL_midiOutOpen, AIL_quick_handles
Related Basic Types: HMDIDRIVER, MILES_OPEN_XMIDI_FLAGS, U32
Related FAQs: How do I initialize the Miles Sound System for use?