Microsoft DirectX 8.0 (C++)

IDirectSoundBuffer8::GetVolume

バッファのボリュームを取得する。

HRESULT GetVolume(
  LPLONG plVolume 
);

パラメータ

plVolume
減衰を 100 分の 1 デシベルの単位で受け取る変数のアドレス。「注意」を参照すること。

戻り値

成功した場合は DS_OK を返す。

失敗した場合は、次のいずれかのエラー値を返す。

DSERR_CONTROLUNAVAIL
DSERR_INVALIDPARAM
DSERR_PRIOLEVELNEEDED

注意

戻り値の範囲は、DSBVOLUME_MAX から DSBVOLUME_MIN である。これらの値は、それぞれ 0 および -10,000 と定義されている。値 DSBVOLUME_MAX は、サウンド本来の未調整のボリュームを表す。値 DSBVOLUME_MIN は、オーディオのボリュームが 100 dB 減衰していることを表すが、これは実際的には無音を意味する。

動作環境

  ヘッダー : dsound.h で宣言。

参照

IDirectSoundBuffer8::SetVolume