FSOUND_Stream_SetSubStream

Seeks a stream to the substream inside a multi-stream FSB bank file, specified by its index.

signed char F_API FSOUND_Stream_SetSubStream(
FSOUND_STREAM *stream,
int index
);

Parameters

stream	Handle to the stream to have its position set.
index	The index of the stream within the FSB file.

Return Value

On success, TRUE is returned.
On failure, FALSE is returned.

Remarks

A stream will stop if this function is called, as it needs to seek and flush the buffer.
Indicies for this function are generated as user friendly constants when compiling the FSB bank, and are available in the relevant generated header file.
--------------
If the stream has been opened with FSOUND_NONBLOCKING, this function will ALWAYS succeed, but puts the stream back into a non-ready state. You then have to poll after calling this to make sure the stream is ready.
You can either do this by calling FSOUND_Stream_Play repeatedly/once a frame until it is succeeds, or FSOUND_Stream_GetOpenState.
___________________
Supported on the following platforms : Win32, WinCE, Linux, Macintosh, XBox, PlayStation 2, GameCube

[API function]