Starts a new bitstream in an Ogg Vorbis encoder's output.
|handle||The encoder handle.
|options||The new bitstream's options. The same options as with BASS_Encode_OGG_Start and BASS_Encode_OGG_StartFile are available here.
|flags||A combination of these flags.|
|BASS_ENCODE_OGG_RESET||Reset all settings to defaults before processing the new options, else start with the encoder's current settings. Metadata/tag settings are always reset.
|BASS_UNICODE||options is in UTF-16 form. Otherwise it should be UTF-8.
If successful, TRUE is returned, else FALSE is returned. Use BASS_ErrorGetCode to get the error code.
|BASS_ERROR_HANDLE||handle is not valid.
|BASS_ERROR_ILLPARAM||options contains an invalid setting.
|BASS_ERROR_FILEOPEN||A "--picture" option file could not be opened.
|BASS_ERROR_FILEFORM||A "--picture" option file has an invalid format. It needs to be JPEG, PNG, or GIF.
|BASS_ERROR_MEM||There is insufficient memory.
|BASS_ERROR_UNKNOWN||Some other mystery problem!
This function ends the encoder's current bitstream and starts a new one with the specified settings. This is mainly useful for metadata changes when streaming, eg. with BASS_Encode_ServerInit. Starting a new bitstream involves writing new headers, which can be quite large (usually around 4KB), so new bitstreams should not be used too frequently to avoid excessive overhead.
Tags/comments should be in UTF-8 form. This function will take care of that when the BASS_UNICODE flag is used, but otherwise you will need to make sure that any tags included in options are UTF-8 (not ISO-8859-1/etc).