IXAudio2Voice::SetFilterParameters

  • [アーティクル]

ボイスのフィルター パラメーターを設定します。

HRESULT 
SetFilterParameters(
  const XAUDIO2_FILTER_PARAMETERS *pParameters,
  UINT32 OperationSet = XAUDIO2_COMMIT_NOW
);

パラメータ

  • pParameters
    フィルターの情報が格納されている XAUDIO2_FILTER_PARAMETERS 構造体へのポインターです。
  • OperationSet
    この呼び出しを遅延バッチの一部として指定します。詳細については、「XAudio2 操作セット」の概要を参照してください。

戻り値

正常に実行された場合は S_OK を返し、失敗した場合はエラー コードを返します。エラー コードの説明については、「XAudio2 エラー コード」を参照してください。

解説　

ボイスが XAUDIO2_VOICE_USEFILTER フラグで作成されていなかった場合、SetFilterParameters は失敗します。

このメソッドは、ソース ボイスおよびサブミックス ボイスでのみ使用でき、マスター ボイスでは無効です。

注    IXAudio2Voice::SetFilterParameters への呼び出しを使用してフィルター パラメーターを変更した直後に IXAudio2Voice::GetFilterParameters を呼び出した場合は、古いパラメーターが返されることがあります。これは、パラメーターが非同期的に設定されるためです。変更は、次にオーディオ エンジンを実行したときにのみ反映されます。

要件

ヘッダー: Xaudio2.h 宣言

関連項目

IXAudio2Voice