DirectSound3DBuffer.SetPosition

The DirectSound3DBuffer.SetPosition method sets the sound buffer's position, in distance units.

object.SetPosition(x As Single, _
    y As Single, _
    z As Single, _
    applyFlag As CONST_DS3DAPPLYFLAGS)

Parameters

object

Object expression that resolves to a DirectSound3DBuffer object.

x, y, and z

Values that represent the coordinates of the position vector. DirectSound may adjust these values to prevent floating-point overflow.

applyFlag

Value that indicates when the setting should be applied. This value must be one of the constants of the CONST_DS3DAPPLYFLAGS enumeration.

Error Codes

If the method fails, an error is raised and Err.Number may be set to DSERR_INVALIDPARAM.

Remarks

Passing values greater than 10 or less than -10 may attenuate the sound beyond the threshold of audibility.

By default, distance units are meters, but you can change the units by using the DirectSound3DListener.SetDistanceFactor method.