共用方式為

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

另請參閱

IXAudio2Voice

XAPO 概觀