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 |