BASS_ChannelSet3DPosition

Sets the 3D position of a sample, stream, or MOD music channel with 3D functionality.

BOOL WINAPI BASS_ChannelSet3DPosition(
    DWORD handle,
    BASS_3DVECTOR *pos,
    BASS_3DVECTOR *orient,
    BASS_3DVECTOR *vel
);

Parameters
handleThe channel handle... a HCHANNEL, HMUSIC, HSTREAM.
posPosition of the sound... NULL = leave current.
orientOrientation of the sound... NULL = leave current.
velVelocity of the sound... NULL = leave current. This is only used to calculate the doppler effect, and has no effect on the sound's position.

Return value
If succesful, then TRUE is returned, else FALSE is returned. Use BASS_ErrorGetCode to get the error code.

Error codes
BASS_ERROR_HANDLEhandle is not a valid channel.
BASS_ERROR_NO3DThe channel does not have 3D functionality... it wasn't created or loaded with the BASS_xxx_3D flag.

Remarks
As with all 3D functions, BASS_Apply3D must be called to apply the changes made.

See also
BASS_Apply3D, BASS_ChannelGet3DPosition, BASS_ChannelSet3DAttributes, BASS_ChannelSetAttributes, BASS_Set3DFactors, BASS_Set3DPosition, BASS_3DVECTOR structure