Microsoft DirectX 8.1 (Visual Basic)

DirectSound3DListener8.SetVelocity

The SetVelocity method sets the listener's velocity.

Syntax

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

Parts

object

Resolves to a DirectSound3DListener8 object.

x, y, z

Values that specify the coordinates of the listener's velocity 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

The default velocity is (0,0,0).

Velocity is used only for Doppler effects. It does not move the listener. To change the listener's position, use the DirectSound3DListener8.SetPosition method.

See Also