Retrieves the playback length of a channel.
QWORD BASS_ChannelGetLength( DWORD handle, DWORD mode );
|handle||The channel handle... a HCHANNEL, HMUSIC, HSTREAM. HSAMPLE handles may also be used.|
|mode||How to retrieve the length. One of the following.|
Return valueIf successful, then the channel's length is returned, else -1 is returned. Use BASS_ErrorGetCode to get the error code.
|BASS_ERROR_HANDLE||handle is not valid.|
|BASS_ERROR_NOTAVAIL||The requested length is not available.|
RemarksThe exact length of a stream will be returned once the whole file has been streamed, but until then it is not always possible to 100% accurately estimate the length. The length is always exact for MP3/MP2/MP1 files when the BASS_STREAM_PRESCAN flag is used in the BASS_StreamCreateFile call, otherwise it is an (usually accurate) estimation based on the file size. The length returned for OGG files will usually be exact (assuming the file is not corrupt), but when streaming from the internet (or "buffered" user file), it can be a very rough estimation until the whole file has been downloaded. It will also be an estimate for chained OGG files that are not pre-scanned.
Unless an OGG file contains a single bitstream, the number of bitstreams it contains will only be available if it was pre-scanned at the stream's creation.
Retrieving the byte length of a MOD music requires that the BASS_MUSIC_PRESCAN flag was used in the BASS_MusicLoad call.
ExampleGet the duration (in seconds) of a channel.
QWORD len=BASS_ChannelGetLength(channel, BASS_POS_BYTE); // the length in bytes double time=BASS_ChannelBytes2Seconds(channel, len); // the length in seconds