次の方法で共有


IXAudio2Voice::SetFilterParameters メソッド

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

構文

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

パラメーター

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

戻り値

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

解説 

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

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

注意

IXAudio2Voice::GetFilterParameters は、常にこのボイスの現在の実際のフィルター パラメーターを返します。ただし、これらのパラメーターは、前回の IXAudio2Voice::SetFilterParameters 呼び出しによって設定されたパラメーターと一致しない場合があります。実際のパラメーターは、IXAudio2Voice::SetFilterParameters 呼び出しの後 (または、IXAudio2Voice::SetFilterParameters が遅延操作 ID を使用して呼び出された場合は、対応する IXAudio2::CommitChanges 呼び出しの後)、次にオーディオ エンジンが実行されたときに初めて変更されます。

要件

ヘッダー: xaudio2.h で宣言されています。

関連項目

IXAudio2Voice