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