IXAudio2Voice::SetOutputFilterParameters メソッド
このボイスのいずれかの送信のフィルター パラメーターを設定します。
構文
HRESULT SetOutputFilterParameters( IXAudio2Voice *pDestinationVoice, XAUDIO2_FILTER_PARAMETERS *pParameters, UINT32 OperationSet = XAUDIO2_COMMIT_NOW)
パラメーター
- pDestinationVoice
[in] フィルター パラメーターが設定される送信のデスティネーション ボイスへの IXAudio2Voice ポインターです。 - pParameters
[in] フィルターの情報が格納されている XAUDIO2_FILTER_PARAMETERS 構造体へのポインターです。 - OperationSet
[in] この呼び出しを遅延バッチの一部として指定します。詳細については、「XAudio2 操作セット」の概要を参照してください。
戻り値
正常に実行された場合は S_OK を返し、失敗した場合はエラー コードを返します。エラー コードの説明については、「XAudio2 エラー コード」を参照してください。
解説
送信が XAUDIO2_SEND_USEFILTER フラグを使用して作成されていなかった場合、SetOutputFilterParameters は失敗します。このメソッドは、ソース ボイスおよびサブミックス ボイスに属する送信でのみ使用でき、マスター ボイスの送信には影響を与えません。
注意
IXAudio2Voice::GetOutputFilterParameters は、常にこの送信の現在の実際のフィルター パラメーターを返します。ただし、これらのパラメーターは、前回の IXAudio2Voice::SetOutputFilterParameters 呼び出しによって設定されたパラメーターと一致しない場合があります。実際のパラメーターは、IXAudio2Voice::SetOutputFilterParameters 呼び出しの後 (または、IXAudio2Voice::SetOutputFilterParameters が遅延操作 ID を使用して呼び出された場合は、対応する IXAudio2::CommitChanges 呼び出しの後)、次にオーディオ エンジンが実行されたときに初めて変更されます。
要件
ヘッダー: xaudio2.h で宣言されています。