| Microsoft DirectX 8.1 (Visual Basic) |
The SetVolume method changes the sound volume of the buffer.
Syntax
object.SetVolume(volume As Long)
Parts
object
Resolves to a DirectSoundPrimaryBuffer8 object.
volume
Volume requested for this sound buffer.
Error Codes
If the method fails, an error is raised and Err.Number may be set to one of the following error values.
| DSERR_CONTROLUNAVAIL |
| DSERR_GENERIC |
| DSERR_INVALIDPARAM |
| DSERR_PRIOLEVELNEEDED |
Remarks
The volume is specified in hundredths of decibels (dB) of attenuation. Allowable values are between DSBVOLUME_MAX (no attenuation) and DSBVOLUME_MIN (silence). 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.
See Also