IDirectSoundBuffer8::GetVolume

The GetVolume method retrieves the attenuation of the sound.

HRESULT GetVolume(
  LPLONG plVolume
);

Parameters

plVolume

Address of a variable that receives the attenuation, in hundredths of a decibel.

Return Values

If the method succeeds, the return value is DS_OK. If the method fails, the return value may be one of the following error values:

Remarks

The return value is between DSBVOLUME_MAX and DSBVOLUME_MIN. These values are defined as 0 and ?10,000, respectively. The value DSBVOLUME_MAX represents the original, unadjusted volume of the sound. The value DSBVOLUME_MIN indicates an audio volume attenuated by 100 dB, which, for practical purposes, is silence.

Requirements

Header: Declared in Dsound.h.

Import Library: Use Dsound3d.dll.

See Also

IDirectSoundBuffer8