SetEAXEffectPresets method
Remarks
Applies a certain EAX effect to the given output device using the default reverb presets.
EAX effects can be applied only if the
IsEAXAvailable method returns TRUE and has effect only on sounds loaded through the
LoadSoundForEAX method.
The current EAX effect, if any, and its reverb parameters can be retrieved through a call to the
GetEAXEffect method.
Note that, although some sound card driver will tell you that it supports EAX, this doesn't guarantees that its EAX implementation quality will be the same available for Creative sound cards.
Syntax
|
[Visual Basic]
control.SetEAXEffectPresets (
nIndex as Integer,
|
|
[C++]
short control.SetEAXEffectPresets (
short nIndex,
long nEffect
);
|
|
Parameter
|
Description
|
|
|
|
|
nIndex
|
Number representing the zero-based index of the output device that will be affected by EAX settings
|
|
nEffect
|
Numeric value that determines the effect to apply.
Supported values are the following:
|
Mnemonic value
|
Value
|
Meaning
|
|
EAX_NONE
|
-1
|
Removes any previous EAX effect
|
|
EAX_GENERIC
|
0
|
Generic
|
|
EAX_PADDEDCELL
|
1
|
Padded cell
|
|
EAX_ROOM
|
2
|
Room
|
|
EAX_BATHROOM
|
3
|
Bathroom
|
|
EAX_LIVINGROOM
|
4
|
Living room
|
|
EAX_STONEROOM
|
5
|
Stone room
|
|
EAX_AUDITORIUM
|
6
|
Auditorium
|
|
EAX_CONCERTHALL
|
7
|
Concert hall
|
|
EAX_CAVE
|
8
|
Cave
|
|
EAX_ARENA
|
9
|
Arena
|
|
EAX_HANGAR
|
10
|
Hangar
|
|
EAX_CARPETEDHALLWAY
|
11
|
Carpeted hallway
|
|
EAX_HALLWAY
|
12
|
Hallway
|
|
EAX_STONECORRIDOR
|
13
|
Stone corridor
|
|
EAX_ALLEY
|
14
|
Alley
|
|
EAX_FOREST
|
15
|
Forest
|
|
EAX_CITY
|
16
|
City
|
|
EAX_MOUNTAINS
|
17
|
Mountains
|
|
EAX_QUARRY
|
18
|
Quarry
|
|
EAX_PLAIN
|
19
|
Plain
|
|
EAX_PARKINGLOT
|
20
|
Parking lot
|
|
EAX_SEWERPIPE
|
21
|
Sewer pipe
|
|
EAX_UNDERWATER
|
22
|
Underwater
|
|
EAX_DRUGGED
|
23
|
Drugged
|
|
EAX_DIZZY
|
24
|
Dizzy
|
|
EAX_DIZZY
|
25
|
Psychotic
|
|
Return value
|
Value
|
Meaning
|
|
|
|
|
Negative value
|
An error occurred (see the LastError property for further error details) |
|
enumErrorCodes.ERR_NOERROR (0)
|
The method call was successful.
|
