IDirectSoundBuffer::SetVolume
This method changes the volume of a sound buffer.
HRESULT SetVolume(
LONG lVolume
);
Parameters
- lVolume
New volume requested for this sound buffer.
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:
DSERR_CONTROLUNAVAIL |
DSERR_GENERIC |
DSERR_INVALIDPARAM |
DSERR_PRIOLEVELNEEDED |
Remarks
The volume is specified in hundredths of decibels (dB). Allowable values are between DSBVOLUME_MAX (no attenuation) and DSBVOLUME_MIN (silence). These values are currently defined in Dsound.h as 0 and -10,000 respectively. The value DSBVOLUME_MAX represents the original, unadjusted volume of the stream. The value DSBVOLUME_MIN indicates an audio volume attenuated by 100 dB, which, for all practical purposes, is silence. Currently DirectSound does not support amplification.
Requirements
OS Versions: Windows CE 2.12 and later. Version 2.12 requires DXPAK 1.0 or later.
Header: Dsound.h.
Link Library: Dsound.lib.
See Also
IDirectSoundBuffer | IDirectSoundBuffer::GetPan | IDirectSoundBuffer::GetVolume | IDirectSoundBuffer::SetPan
Last updated on Thursday, April 08, 2004
© 1992-2003 Microsoft Corporation. All rights reserved.