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 内容

関連項目

IDirectSoundBuffer8