Microsoft DirectX 8.1 (Visual Basic)

DirectSound3DBuffer8.SetPosition

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

Syntax

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

Parts

object

Resolves to a DirectSound3DBuffer8 object.

x, y, z

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

applyFlag

Value that specifies when the setting should be applied. 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

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