IDirectSoundBuffer8::SetPan
SetPan メソッドは、左右のチャンネルの相対ボリュームを設定します。
HRESULT
SetPan(
LONG lPan
);
パラメータ
- lPan
左右のチャンネルの相対ボリュームです。
戻り値
成功した場合は、DS_OK を返します。失敗した場合は、次のいずれかのエラー値を返します。
リターン コード |
DSERR_CONTROLUNAVAIL |
DSERR_GENERIC |
DSERR_INVALIDPARAM |
DSERR_PRIOLEVELNEEDED |
解説
戻り値は 1/100 デシベル (dB) 単位で測定され、範囲は DSBPAN_LEFT から DSBPAN_RIGHT までです。これらの値は、Dsound.h 内ではそれぞれ -10,000 および 10,000 と定義されています。値 DSBPAN_LEFT は、右チャンネルが 100 dB 減衰し、実質的に無音であることを意味します。値 DSBPAN_RIGHT は、左チャンネルが無音であることを意味します。DSBPAN_CENTER は中立値で、0 と定義されており、両方のチャンネルが最大ボリュームであることを意味します。一方のチャンネルが減衰するとき、もう一方のチャンネルは最大ボリュームのままです。
パン コントロールの効果は、ボリューム コントロールに累積されます。
要件
ヘッダー: DSound.h 宣言
ライブラリ: Dsound3d.dll 内容