Miles Sound System SDK 7.2a

AIL_set_redist_directory

The function AIL_set_redist_directory sets the location of your application's Miles directory.

char * AIL_set_redist_directory(
  char const * directory
);

In Parameters

directory

Returns

The new directory path.

Discussion

Under Windows, this directory should contain the Miles ASI and FLT providers. Under MacOS, this directory should contain the Miles shared libraries. Under DOS, this directory should contain the sound drivers (*.DIG, *.MDI).

Miles always first loads the ASI and FLT providers from the directory containing MSS32.DLL. After the default directory is searched, then the redistribution directory is scanned.

Normally, the redistribution directory is relative to the location of the Miles library file, so if you are using a relative path - make sure it is relative to the location of the Miles library. You can tell Miles to use a redistribution directory relative to the current directory when AIL_startup is called by placing a "*" in front of the redistribution directory ("*redist" instead of "redist", for example).

You must call AIL_set_redist_directory to set your application's Miles directory before calling AIL_startup or AIL_quick_startup.

On MacOS under Classic and Carbon CFM, you use ":" separated directory names (like ":redist:classic"). On Carbon Mach-O, you just use normal Unix style pathnames (like "redist/macho").

Group: Digital Filter Services, System Services
Related Functions: AIL_init_sequence, AIL_install_DIG_INI, AIL_install_DIG_driver_file, AIL_install_DIG_driver_image, AIL_install_MDI_INI, AIL_install_MDI_driver_file, AIL_install_MDI_driver_image, AIL_install_timbre, AIL_quick_startup, AIL_set_GTL_filename_prefix, AIL_set_named_sample_file, AIL_set_redist_directory, AIL_startup
Related Basic Types: char, char *, char const *
Related FAQs: How do I initialize the Miles Sound System for use?, How do I use a Unicode path on Windows?, I can't get Miles to play an MP3, XMA, or Ogg Vorbis file - what's going on?