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