IXAudio2Voice：:D isableEffect 方法 (xaudio2.h)
停用語音效果鏈結中指定位置的效果。
語法
\\HRESULT DisableEffect(
[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 的任何呼叫都會使效果鏈結停止滿足這些需求將會失敗。
停用效果會立即從處理圖形中移除。 不會播放效果中的任何擱置音訊，例如殘響尾。 請小心停用裝載其執行之語音時的效果。 如果效果大幅變更音訊的音調或音量，這可能會導致可聽見的成品。
DisableEffect 會在從具有 OperationSet 的 OperationSet XAUDIO2_COMMIT_NOW從 XAudio2 回呼呼叫時立即生效。
平臺需求
Windows 10 (XAudio2.9) ;Windows 8，Windows Phone 8 (XAudio 2.8) ;DirectX SDK (XAudio 2.7)規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Windows |
| 標頭 | xaudio2.h |