IXAudio2Voice：：EnableEffect 方法 (xaudio2.h)
在語音的效果鏈結中啟用指定位置的效果。
語法
\\HRESULT EnableEffect(
[in] UINT32 EffectIndex,
[in] UINT32 OperationSet
);
參數
[in] EffectIndex
以零起始的語音效果鏈結中效果的索引。
[in] OperationSet
將此呼叫識別為延遲批次的一部分。 如需詳細資訊，請參閱 XAudio2 作業集 概觀。
傳回值
如果成功，則傳回S_OK;否則為錯誤碼。 如需錯誤碼的描述，請參閱 XAudio2 錯誤 碼。
備註
當您在裝載它的語音執行時啟用效果時，請小心。 如果效果大幅變更音訊的音調或音量，這類動作可能會導致問題。
指定 XAudio2 語音效果鏈結中的效果必須取用並產生該語音處理取樣率的音訊。 他們可以變更的音訊格式唯一層面是通道計數。 例如，殘響效果可以將 mono 資料轉換成 5.1。 用戶端可以使用 XAUDIO2_EFFECT_DESCRIPTOR 結構的 OutputChannels 欄位來指定想要產生每個效果的通道數目。 效果鏈結中的每個效果都必須產生一些通道，讓下一個效果可以取用。 對 IXAudio2Voice：：EnableEffect或IXAudio2Voice：:D isableEffect的任何呼叫都會使效果鏈結停止滿足這些需求將會失敗。
當您從 XAudio2 回呼呼叫時，EnableEffect會立即生效，而OperationSet為XAUDIO2_COMMIT_NOW。
平臺需求
Windows 10 (XAudio2.9) ;Windows 8，Windows Phone 8 (XAudio 2.8) ;DirectX SDK (XAudio 2.7)規格需求
| 目標平台 | Windows |
| 標頭 | xaudio2.h |