共用方式為

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

另請參閱

IXAudio2Voice

XAPO 概觀