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 で宣言されています。