Microsoft DirectX 8.0 (Visual Basic)

DirectSoundPrimaryBuffer8.GetPan

左右のオーディオ チャンネルの相対ボリュームを示す変数を取得する。

object.GetPan() As Long

指定項目

object
DirectSoundPrimaryBuffer8 オブジェクトを指定する。

戻り値

左右のスピーカの相対ミキシング率を返す。「注意」を参照すること。

エラー コード

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

DSERR_CONTROLUNAVAIL
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 以外の値はいずれも、一方のチャンネルが最大ボリュームでもう一方のチャンネルが減衰していることを意味する。たとえば、値 -2173 は、左チャンネルは最大ボリュームで、右チャンネルは 21.73 dB 減衰していることを意味する。同様に、パンの値が 870 のとき、左チャンネルは 8.7 dB 減衰しており、右チャンネルは最大ボリュームであることを意味する。

パン コントロールの効果は、ボリューム コントロールに累積される。

参照

DirectSoundPrimaryBuffer8.GetVolumeDirectSoundPrimaryBuffer8.SetPanDirectSoundPrimaryBuffer8.SetVolume