IXAudio2Voice::SetFilterParameters
ボイスのフィルター パラメーターを設定します。
HRESULT
SetFilterParameters(
const XAUDIO2_FILTER_PARAMETERS *pParameters,
UINT32 OperationSet = XAUDIO2_COMMIT_NOW
);
パラメータ
- pParameters
フィルターの情報が格納されている XAUDIO2_FILTER_PARAMETERS 構造体へのポインターです。 - OperationSet
この呼び出しを遅延バッチの一部として指定します。詳細については、「XAudio2 操作セット」の概要を参照してください。
戻り値
正常に実行された場合は S_OK を返し、失敗した場合はエラー コードを返します。エラー コードの説明については、「XAudio2 エラー コード」を参照してください。
解説
ボイスが XAUDIO2_VOICE_USEFILTER フラグで作成されていなかった場合、SetFilterParameters は失敗します。
このメソッドは、ソース ボイスおよびサブミックス ボイスでのみ使用でき、マスター ボイスでは無効です。
注 IXAudio2Voice::SetFilterParameters への呼び出しを使用してフィルター パラメーターを変更した直後に IXAudio2Voice::GetFilterParameters を呼び出した場合は、古いパラメーターが返されることがあります。これは、パラメーターが非同期的に設定されるためです。変更は、次にオーディオ エンジンを実行したときにのみ反映されます。
要件
ヘッダー: Xaudio2.h 宣言