BASS_CONFIG_UPDATETHREADS config option


The number of threads to use for updating playback buffers.

BASS_SetConfig(
    BASS_CONFIG_UPDATETHREADS,
    DWORD threads
);

Parameters

threadsThe number of threads to use... 0 = disable automatic updating.

Remarks

The number of update threads determines how many HSTREAM/HMUSIC channel playback buffers can be updated in parallel; each thread can process one channel at a time. The default is to use a single thread, but additional threads can be used to take advantage of multiple CPU cores. There is generally nothing much to be gained by creating more threads than there are CPU cores, but one benefit of using multiple threads even with a single CPU core is that a slowly updating channel need not delay the updating of other channels.

When automatic updating is disabled (threads = 0), BASS_Update or BASS_ChannelUpdate should be used instead.

The number of update threads can be changed at any time, including during playback.

Platform-specific

The number of update threads is limited to 1 on the Windows CE platform.

See also

BASS_ChannelUpdate, BASS_GetConfig, BASS_SetConfig, BASS_Update, BASS_CONFIG_BUFFER, BASS_CONFIG_UPDATEPERIOD