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

  • [アーティクル]

音声の全体的な音量レベルを設定します。

構文

\\HRESULT SetVolume(
  [in] float  Volume,
  [in] UINT32 OperationSet
);

パラメーター

[in] Volume

使用する全体的なボリューム レベル。 ボリューム レベルの詳細については、「解説」を参照してください。

[in] OperationSet

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

戻り値

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

注釈

SetVolume は、音声のマスター入力ボリューム レベルを制御します。 マスター ボリューム レベルは、音声の種類に応じて異なる時間に適用されます。 サブミックスとマスタリング音声の場合、音声の組み込みのフィルターおよびエフェクト チェーンが適用される直前にボリューム レベルが適用されます。 ソース ボイスの場合、音声のフィルターとエフェクト チェーンが適用された後にマスター ボリューム レベルが適用されます。

ボリューム レベルは、-XAUDIO2_MAX_VOLUME_LEVEL と XAUDIO2_MAX_VOLUME_LEVEL (-2²⁴ ~ 2²⁴) の間の浮動小数点振幅乗数で表され、最大ゲインは 144.5 dB です。 ボリューム レベルが 1.0 の場合は、減衰またはゲインがないことを意味し、0 は無音を意味します。 負のレベルを使用して、オーディオの位相を反転できます。 ボリュームコントロールの詳細については、「 XAudio2 Volume and Pitch Control 」を参照してください。

注IXAudio2Voice::GetVolume は、 IXAudio2Voice::SetVolume によって最後に設定されたボリュームを常に返します。 ただし、実際には有効ではない可能性があります。これは、IXAudio2Voice::SetVolume 呼び出しの後 (または、IXAudio2Voice::SetVolume が遅延操作 ID で呼び出された場合は、対応する IXAudio2::CommitChanges 呼び出しの後) にオーディオ エンジンが次回実行されたときにのみ有効になります。
 

プラットフォームの要件

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

要件

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

こちらもご覧ください

方法: 音声ボリュームを変更する

方法: サブミックス ボイスの使用

IXAudio2Voice