Platform SDK: DirectX

DirectSoundBuffer.SetPan

DirectSoundBuffer.SetPan メソッドは、左右のチャンネルの相対ボリュームを設定する。

object.SetPan(pan As Long)

パラメータ

object
DirectSoundBuffer オブジェクトを表すオブジェクト式。
pan
左右のチャンネルの相対ボリューム。

エラー コード

失敗すればエラーが発生し、Err.Number に次のいずれかのエラー コードが設定される。

DSERR_CONTROLUNAVAIL
DSERR_GENERIC
DSERR_INVALIDPARAM
DSERR_PRIOLEVELNEEDED

注意

戻り値は DSBPAN_LEFT (-10,000) から DSBPAN_RIGHT (10,000) の範囲で、100 分の 1 デシベル (dB) 単位である。値 DSBPAN_LEFT は右チャンネルが 100 dB 減衰していることを意味する。値 DSBPAN_RIGHT は左チャンネルが 100 dB 減衰していることを意味する。中立値は DSBPAN_CENTER (0) であり、両方のチャンネルが最大ボリュームであることを意味する (0 dB の減衰)。

DSBPAN_CENTER 以外の値はどれも、一方が最大ボリュームでもう一方が減衰していることを意味する。たとえば、値が -2,173 のとき、左チャンネルは最大ボリュームで、右チャンネルは 21.73 dB 減衰していることを意味する。同様にパンの値が 870 のとき、左チャンネルは 8.7 dB 減衰しており、右チャンネルは最大ボリュームであることを意味する。

パン コントロールのエフェクトーム コントロールに累積される。

参照

DirectSoundBuffer.GetPanDirectSoundBuffer.SetVolume