UID | title | description | helpviewer_keywords | old-location | tech.root | ms.assetid | ms.date | ms.keywords | req.header | req.include-header | req.target-type | req.target-min-winverclnt | req.target-min-winversvr | req.kmdf-ver | req.umdf-ver | req.ddi-compliance | req.unicode-ansi | req.idl | req.max-support | req.namespace | req.assembly | req.type-library | req.lib | req.dll | req.irql | targetos | req.typenames | req.redist | ms.custom | f1_keywords | dev_langs | topic_type | api_type | api_location | api_name | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
NF:xaudio2.IXAudio2Voice.EnableEffect |
IXAudio2Voice::EnableEffect (xaudio2.h) |
Enables the effect at a given position in the effect chain of the voice. |
|
xaudio2\ixaudio2voice_interface_enableeffect.htm |
xaudio2 |
M:Microsoft.directx_sdk.ixaudio2voice.IXAudio2Voice.EnableEffect(UINT32,UINT32) |
12/05/2018 |
EnableEffect, EnableEffect method [XAudio2 Audio Mixing APIs], EnableEffect method [XAudio2 Audio Mixing APIs],IXAudio2Voice interface, IXAudio2Voice interface [XAudio2 Audio Mixing APIs],EnableEffect method, IXAudio2Voice.EnableEffect, IXAudio2Voice::EnableEffect, xaudio2.ixaudio2voice_interface_enableeffect, xaudio2/IXAudio2Voice::EnableEffect |
xaudio2.h |
Windows |
Windows |
19H1 |
|
|
|
|
|
|
Enables the effect at a given position in the effect chain of the voice.
Zero-based index of an effect in the effect chain of the voice.
TBD
Identifies this call as part of a deferred batch. See the XAudio2 Operation Sets overview for more information.
Returns S_OK if successful; otherwise, an error code. See XAudio2 Error Codes for descriptions of error codes.
Be careful when you enable an effect while the voice that hosts it is running. Such an action can result in a problem if the effect significantly changes the audio's pitch or volume.
The effects in a given XAudio2 voice's effect chain must consume and produce audio at that voice's processing sample rate. The only aspect of the audio format they can change is the channel count. For example a reverb effect can convert mono data to 5.1. The client can use the XAUDIO2_EFFECT_DESCRIPTOR structure's OutputChannels field to specify the number of channels it wants each effect to produce. Each effect in an effect chain must produce a number of channels that the next effect can consume. Any calls to IXAudio2Voice::EnableEffect or IXAudio2Voice::DisableEffect that would make the effect chain stop fulfilling these requirements will fail.
EnableEffect takes effect immediately when you call it from an XAudio2 callback with an OperationSet of XAUDIO2_COMMIT_NOW.
Windows 10 (XAudio2.9); Windows 8, Windows Phone 8 (XAudio 2.8); DirectX SDK (XAudio 2.7)