Miles Sound System SDK 7.2a

MILES_OPEN_DIGITAL_FLAGS

The basic type MILES_OPEN_DIGITAL_FLAGS specifies open flags for the AIL_open_digital_driver function.

Fundamental Values

 Value  Description
 0 Under Win32 and Win64, the default flag of zero tells Miles to try DirectSound first, and then try waveOut if DirectSound fails (or is using emulation mode).

Under MacOS, the default flag simply opens Sound Manager.

Under DOS, the default flag simply opens the DOS driver specified in the DIG.INI file.
 AIL_OPEN_DIGITAL_FORCE_PREFERENCE Under Win32 and Win64, this flag tells AIL_open_digital_driver to obey the DIG_USE_WAVEOUT preference instead of trying DirectSound first and then waveOut automatically.

Under DOS, this causes the sound format parameters to AIL_open_digital_driver to be ignored and the DIG_HARDWARE_SAMPLE_RATE, DIG_USE_STEREO, and DIG_USE_16_BITS preferences are used to setup the driver.
 AIL_OPEN_DIGITAL_NEED_HW_3D On original Xbox, this flag says to open the digital driver with hardware 3D support. Functions such as AIL_set_sample_3D_position and AIL_set_sample_3D_distances will be hardware-accelerated for better performance, but stereo samples and streams are not supported. Voice availability is also limited to a maximum of 64.
 AIL_OPEN_DIGITAL_NEED_FULL_3D On original Xbox, this optional flag is added to the other flags to force the use of the larger HRTF filter tables. The full HRTF tables are about 60K larger.
 AIL_OPEN_DIGITAL_NEED_LIGHT_3D On original Xbox, this optional flag is added to the other flags to force the use of the smaller HRTF filter tables. The light HRTF tables are about 60K smaller.
 AIL_OPEN_DIGITAL_NEED_HW_REVERB On original Xbox, this optional flag is added to the other flags to specify that you require I3DL2 reverb in your application. Hardware reverb may be enabled even if you don't use AIL_OPEN_DIGITAL_NEED_HW_3D. Miles doesn't support software reverb on the Xbox, so if you want environmental reverb effects, this flag is mandatory. Note that even though the reverb algorithm is implemented in DSP hardware, there is a slight cost in memory usage and latency associated with turning it on.
 AIL_OPEN_DIGITAL_USE_IOP_CORE0 On PS2, this optional flag specifies that MSS should send its output to IOP core 0, rather than the default IOP core 1 destination. Most applications will not need to use this flag. (When a DTS 4.0 or DTS 5.1 configuration is opened, core 0 is selected automatically, and this flag has no effect.) Be sure to review the discussion of the RAD_IOP layer in the PS2 support-services section before using this flag.


Group: Digital Audio Services
Related Functions: AIL_open_digital_driver, AIL_set_sample_3D_distances, AIL_set_sample_3D_position
Related Basic Types: MILES_PREFERENCES

For technical support, e-mail Miles3@radgametools.com
© Copyright 1991-2007 RAD Game Tools, Inc. All Rights Reserved.