IXAudio2Voice::SetFilterParameters メソッド (xaudio2.h)
音声のフィルター パラメーターを設定します。
構文
\\HRESULT SetFilterParameters(
[in] const XAUDIO2_FILTER_PARAMETERS *pParameters,
[in] UINT32 OperationSet
);
パラメーター
[in] pParameters
フィルター情報を含む XAUDIO2_FILTER_PARAMETERS 構造体へのポインター。
[in] OperationSet
この呼び出しを遅延バッチの一部として識別します。 詳細については、「 XAudio2 操作セット の概要」を参照してください。
戻り値
成功した場合はS_OKを返し、それ以外の場合はエラー コードを返します。 エラー コードの説明については、「 XAudio2 エラー コード 」を参照してください。
注釈
音声が XAUDIO2_VOICE_USEFILTER フラグで作成されていない場合、SetFilterParameters は失敗します。
この方法は、ソースとサブミックスの音声でのみ使用でき、音声のマスタリングには影響しません。
注IXAudio2Voice::GetFilterParameters は常に、この音声の実際の現在のフィルター パラメーターを返します。 ただし、これらは、最新の IXAudio2Voice::SetFilterParameters 呼び出しによって設定されたパラメーターと一致しない場合があります。実際のパラメーターは、IXAudio2Voice::SetFilterParameters 呼び出しの後 (または、IXAudio2Voice::SetFilterParameters が遅延操作 ID で呼び出された場合は、対応する IXAudio2::CommitChanges 呼び出しの後) の後にオーディオ エンジンが次回実行されたときにのみ変更されます。
プラットフォームの要件
Windows 10 (XAudio2.9);Windows 8、Windows Phone 8 (XAudio 2.8);DirectX SDK (XAudio 2.7)要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | Windows |
| ヘッダー | xaudio2.h |