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