次の方法で共有


IXAudio2Voice::GetEffectParameters

ボイスのエフェクト チェーンにおける、特定のエフェクトの現在のエフェクト固有パラメーターを返します。

HRESULT 
GetEffectParameters(
  UINT32 EffectIndex,
  void *pParameters,
  UINT32 ParametersByteSize
);

パラメータ

  • EffectIndex
    ボイスのエフェクト チェーン内のエフェクトの、0 から始まるインデックス。
  • pParameters
    エフェクト固有のパラメーターの現在の値を返します。
  • ParametersByteSize
    pParameters 配列のサイズ (バイト単位) です。

戻り値

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

エフェクトで汎用パラメーター制御インターフェイスがサポートされていない場合は、失敗して E_NOTIMPL が返されます。

解説 

IXAudio2Voice::SetEffectParameters 関数への呼び出しを使用してエフェクト パラメーターを変更した直後に GetEffectParameters を呼び出した場合は、古いパラメーターが返されることがあります。これは、パラメーターが非同期的に設定されるためです。変更は、次にオーディオ エンジンを実行したとき、または遅延操作セット ID が使用された場合はそれ以降に反映されます。

要件

ヘッダー: Xaudio2.h 宣言

関連項目

IXAudio2Voice, IXAPOParameters::GetParameters, XAPO の概要