BASS_Encode_FLAC_NewStream
Starts a new bitstream in an Ogg FLAC encoder's output.
BOOL BASS_Encode_FLAC_NewStream(
DWORD handle,
char *options,
DWORD flags
);
Parameters
| handle | The encoder handle.
|
| options | The new bitstream's options. The same options as with BASS_Encode_FLAC_Start and BASS_Encode_FLAC_StartFile are available here.
|
| flags | A combination of these flags.
| BASS_ENCODE_FLAC_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.
|
|
Return value
If successful, TRUE is returned, else FALSE is returned. Use BASS_ErrorGetCode to get the error code.
Error codes
| BASS_ERROR_HANDLE | handle is not valid.
|
| BASS_ERROR_NOTAVAIL | New bitstreams are only available when Ogg FLAC mode is enabled ("--ogg" option).
|
| 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!
|
Remarks
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. Unless the BASS_ENCODE_FLAC_RESET flag is specified, the new bitstream's default padding setting will be 0 (not 8192).
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).
See also
BASS_Encode_FLAC_Start