Copyright © 2001-2018 MultiMedia Soft

SetEAXEffectPresets method

Previous pageReturn to chapter overviewNext page

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.

 

 

Important note about EAX effects availability

 

EAX effects are only supported up to Windows XP and have been deprecated starting from Windows Vista and higher versions due to the lack of hardware mixing.

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.

 

 

See the How to apply special effects to a playing sound section for further details.

 

 

Syntax

 

[Visual Basic]

control.SetEAXEffectPresets (

nIndex as Integer,

nEffect as enumEaxEffects

) as enumErrorCodes


 

[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.