Microsoft DirectX 8.1 (Visual Basic)

DirectSoundSecondaryBuffer8.SetVolume

The SetVolume method sets the sound volume.

Syntax

object.SetVolume(volume As Long)

Parts

object

Resolves to a DirectSoundSecondaryBuffer8 object.

volume

Attenuation of the volume, in hundredths of a decibel. See Remarks.

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 value of volume must be in the range from DSBVOLUME_MAX through DSBVOLUME_MIN. These constants 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