Platform SDK: DirectX

DirectSound3DListener.SetVelocity

The DirectSound3DListener.SetVelocity method sets the listener's velocity.

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

Parameters

object
Object expression that resolves to a DirectSound3DListener object.
x, y, and z
Values that represent the coordinates of the listener's velocity 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

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 DirectSound3DListener.SetPosition method.

See Also

DirectSound3DListener.GetVelocity