BASS_Split_StreamReset

Resets a splitter stream or all splitter streams of a source.

BOOL BASS_Split_StreamReset(
    DWORD handle
);

Parameters

handleThe splitter or source handle.

Return value

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

Error codes

BASS_ERROR_HANDLEhandle is neither a splitter stream or source.

Remarks

This function resets the splitter stream's buffer state, so that the next sample data that it receives will be from the source's current position. If the stream has ended, that is reset too, so that it can be played again. Unless called from within a mixtime sync callback, the stream's playback buffer (if it has one) is also flushed.

BASS_Split_StreamResetEx can be used to set a splitter stream's buffer position so that it receives a certain amount of old data first.

Example

Set a splitter source's position to 1000000 and reset its splitters so they immediately receive data from the new position.
BASS_ChannelSetPosition(source, 1000000, BASS_POS_BYTE); // set the source's position
BASS_Split_StreamReset(source); // reset its splitters

See also

BASS_Split_StreamCreate, BASS_Split_StreamResetEx