| Microsoft DirectX 8.1 (Visual Basic) |
The DSEFFECTDESC type describes an effect associated with a buffer.
Syntax
Type DSEFFECTDESC
guidDSFXClass As String
lFlags As Long
End Type
Members
guidDSFXClass
String that specifies the class identifier of the effect. You can use one of the following aliases for a standard effect, or a GUID.
DSFX_STANDARD_CHORUS
DSFX_STANDARD_COMPRESSOR
DSFX_STANDARD_DISTORTION
DSFX_STANDARD_ECHO
DSFX_STANDARD_FLANGER
DSFX_STANDARD_GARGLE
DSFX_STANDARD_I3DL2REVERB
DSFX_STANDARD_PARAMEQ
DSFX_STANDARD_WAVES_REVERB
lFlags
Flags that specify buffer creation options. Can be 0 or one of the following values from the CONST_DSOUNDFX enumeration.
| Value | Description |
| DSFX_LOCHARDWARE | Effect must be in hardware. If the effect is not available in hardware, DirectSoundSecondaryBuffer8.SetFX raises an error. Because DirectX 8.1 does not support hardware acceleration of effects, this flag should not be used. |
| DSFX_LOCSOFTWARE | Effect must be in software, even if the hardware supports acceleration of guidDSFXClass. If the effect is not available in software, SetFX raises an error. In DirectX 8.1, all effects are in software regardless of whether this flag is set. |
Remarks
If lFlags is zero, the effect is placed in hardware if possible. If the hardware does not support the effect, software is used. If the effect is not available at all, the call to SetFX raises an error.
An effect of class DSFX_STANDARD_WAVES_REVERB can be set only on a buffer that has a 16-bit audio format.
See Also