Miles Sound System SDK 7.2a

AIL_create_wave_synthesizer

The function AIL_create_wave_synthesizer creates a "virtual wave synthesizer" by associating an XMIDI driver with a digital audio driver and a library file containing digital audio samples assigned to various MIDI patches.

HWAVESYNTH AIL_create_wave_synthesizer(
  HDIGDRIVER dig,
  HMDIDRIVER mdi,
  void const * wave_lib,
  S32 polyphony
);

In Parameters

dig: specifies the digital audio driver to play sampled MIDI instruments or sound effects.
mdi: specifies the XMIDI music driver to trigger the playback of sampled MIDI instruments or sound effects.
wave_lib: points to a memory-resident wave library file created with the WAVELIB program.
polyphony: specifies the number of digital sample handles to reserve for use with the virtual wave synthesizer.

Returns

A handle to the newly created virtual wave synthesizer, or NULL if insufficient memory was available.

Discussion

Note that this function is now obsolete. Applications should migrate to the DLS functions as soon as possible.

The wave library file created by WAVELIB contains a collection of digital audio samples, together with information assigning each sample an XMIDI patch bank number and a MIDI Program Change or rhythm-channel key number. The entire wave library file must be resident in memory (and VMM page-locked) during playback of sequences which make use of digital audio triggers. Refer to the current version of the example wave library list file WAVEDEMO.TXT to learn about the parameters which may be associated with wave samples.

Only one wave synthesizer instance may be associated with each XMIDI or digital audio driver. Example files that use this function: MIDIECHO.C, XDIGPLAY.C

Group: XMIDI Services
Related Sections: WAVELIB - Wave Synthesizer Librarian
Related Functions: AIL_destroy_wave_synthesizer
Related Basic Types: HDIGDRIVER, HMDIDRIVER, HWAVESYNTH, MILES_PREFERENCES, S32, void const *