IXAudio2Voice::SetOutputFilterParameters メソッド (xaudio2.h)

この音声の送信の 1 つにフィルター パラメーターを設定します。

構文

\\HRESULT SetOutputFilterParameters(
  [in] IXAudio2Voice                   *pDestinationVoice,
  [in] const XAUDIO2_FILTER_PARAMETERS *pParameters,
  [in] UINT32                          OperationSet
);

パラメーター

[in] pDestinationVoice

フィルター パラメーターが設定される送信の宛先音声への IXAudio2Voice ポインター。

[in] pParameters

フィルター情報を含む XAUDIO2_FILTER_PARAMETERS 構造体へのポインター。

[in] OperationSet

この呼び出しを遅延バッチの一部として識別します。 詳細については、「 XAudio2 操作セット の概要」を参照してください。

戻り値

成功した場合はS_OKを返し、それ以外の場合はエラー コードを返します。 エラー コードの説明については、「 XAudio2 エラー コード 」を参照してください。

解説

送信が XAUDIO2_SEND_USEFILTER フラグで作成されていない場合、SetOutputFilterParameters は失敗します。 このメソッドは、ソースとサブミックスの音声に属する送信でのみ使用でき、マスタリング音声の送信には影響しません。

注IXAudio2Voice::GetOutputFilterParameters は常に、この送信の実際の現在のフィルター パラメーターを返します。 ただし、これらは、最新の IXAudio2Voice::SetOutputFilterParameters 呼び出しによって設定されたパラメーターと一致しない場合があります。実際のパラメーターは、IXAudio2Voice::SetOutputFilterParameters 呼び出しの後 (または、IXAudio2Voice::SetOutputFilterParameters が遅延操作 ID で呼び出された場合は、対応する IXAudio2::CommitChanges 呼び出しの後) にオーディオ エンジンが次回実行されたときにのみ変更されます。

 

プラットフォームの要件

Windows 10 (XAudio2.9);Windows 8、Windows Phone 8 (XAudio 2.8);DirectX SDK (XAudio 2.7)

要件

対象プラットフォーム	Windows
ヘッダー	xaudio2.h

関連項目

IXAudio2Voice