BASS_ChannelSetAttribute

Sets the value of a channel's attribute.

BOOL BASS_ChannelSetAttribute(
    DWORD handle,
    DWORD attrib,
    float value
);

Parameters

handle

The channel handle... a HCHANNEL, HMUSIC, HSTREAM, or HRECORD.

attrib

The attribute to set the value of... one of the following.

BASS_ATTRIB_BUFFER	Playback buffering length. (HMUSIC/HSTREAM only)
BASS_ATTRIB_FREQ	Sample rate.
BASS_ATTRIB_GRANULE	Processing granularity. (HMUSIC/HSTREAM/HRECORD)
BASS_ATTRIB_MUSIC_AMPLIFY	Amplification level. (HMUSIC)
BASS_ATTRIB_MUSIC_BPM	BPM. (HMUSIC)
BASS_ATTRIB_MUSIC_PANSEP	Pan separation level. (HMUSIC)
BASS_ATTRIB_MUSIC_PSCALER	Position scaler. (HMUSIC)
BASS_ATTRIB_MUSIC_SPEED	Speed. (HMUSIC)
BASS_ATTRIB_MUSIC_VOL_CHAN	A channel volume level. (HMUSIC)
BASS_ATTRIB_MUSIC_VOL_GLOBAL	Global volume level. (HMUSIC)
BASS_ATTRIB_MUSIC_VOL_INST	An instrument/sample volume level. (HMUSIC)
BASS_ATTRIB_NET_RESUME	Buffer level to resume stalled playback. (HSTREAM)
BASS_ATTRIB_NORAMP	Playback ramping.
BASS_ATTRIB_PAN	Panning/balance position.
BASS_ATTRIB_PUSH_LIMIT	Push stream buffer limit.
BASS_ATTRIB_SRC	Sample rate conversion quality.
BASS_ATTRIB_TAIL	Length extension. (HMUSIC/HSTREAM)
BASS_ATTRIB_VOL	Volume level.
BASS_ATTRIB_VOLDSP	DSP chain volume level. (HMUSIC/HSTREAM/HRECORD)
BASS_ATTRIB_VOLDSP_PRIORITY	DSP chain volume priority. (HMUSIC/HSTREAM/HRECORD)

other attributes may be supported by add-ons, see the documentation.

value

The new attribute value. See the attribute's documentation for details on the possible values.

Return value

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

Error codes

BASS_ERROR_HANDLE	handle is not a valid channel.
BASS_ERROR_ILLTYPE	attrib is not valid.
BASS_ERROR_ILLPARAM	value is not valid. See the attribute's documentation for the valid range of values.

some attributes may have additional error codes, see the documentation.

Remarks

The actual attribute value may not be exactly the same as requested, due to precision differences. For example, an attribute might only allow whole number values. BASS_ChannelGetAttribute can be used to confirm what the value is.

BASS_ChannelSetAttribute

Parameters

Return value

Error codes

Remarks

See also