BASS_HLS_StreamCreateFile
Creates a sample stream from a local HLS playlist.
HSTREAM BASS_HLS_StreamCreateFile(
DWORD filetype,
void *file,
QWORD offset,
QWORD length,
DWORD flags
);
Parameters
| filetype | One of the following.
| BASS_FILE_NAME | file is a filename. This is the default if none is specified.
| | BASS_FILE_MEM | file points to a memory block, which will be read from directly, so it needs to stay valid for the lifetime of the stream.
| | BASS_FILE_MEMCOPY | file points to a memory block, which will be copied, so it does not need to stay valid beyond this function call. This requires BASS 2.4.18 or above.
| | BASS_FILE_HANDLE | file is a file handle (HANDLE) on Windows or a file descriptor (int) on other platforms, and should be seekable. It will be duplicated, so the original can be closed whenever wanted but it should not be used to access the file while the stream is. This requires BASS 2.4.18 or above.
|
|
| file | The file as described by filetype.
|
| offset | File offset to begin reading from.
|
| length | Maximum read length... 0 = to the end of the file.
|
| flags | A combination of these flags.
| BASS_SAMPLE_FLOAT | Use 32-bit floating-point sample data. See Floating-point channels for info.
| | BASS_SAMPLE_3D | Enable 3D functionality. The stream must be mono. The SPEAKER flags cannot be used together with this flag.
| | BASS_STREAM_AUTOFREE | Automatically free the stream when playback ends.
| | BASS_STREAM_DECODE | Decode the sample data, without playing it. Use BASS_ChannelGetData to retrieve decoded sample data. The BASS_SAMPLE_3D, BASS_STREAM_AUTOFREE and SPEAKER flags cannot be used together with this flag.
| | BASS_SPEAKER_xxx | Speaker assignment flags. These flags have no effect when the stream is more than stereo.
| | BASS_UNICODE | file is in UTF-16 form. Otherwise it is ANSI on Windows and UTF-8 on other platforms. This flag is ignored when file is not a filename.
|
|
Return value
If successful, the new stream's handle is returned, else 0 is returned. Use BASS_ErrorGetCode to get the error code.
Error codes
| BASS_ERROR_INIT | BASS_Init has not been successfully called.
|
| BASS_ERROR_NOTAVAIL | The BASS_STREAM_AUTOFREE flag cannot be combined with the BASS_STREAM_DECODE flag.
|
| BASS_ERROR_ILLPARAM | filetype and/or length is invalid. length cannot be 0 when streaming from memory.
|
| BASS_ERROR_FILEOPEN | The file could not be opened.
|
| BASS_ERROR_FILEFORM | The file's format is not recognised/supported.
|
| BASS_ERROR_NOTAUDIO | The file does not contain audio.
|
| BASS_ERROR_FORMAT | The sample format is not supported.
|
| BASS_ERROR_SPEAKER | The specified SPEAKER flags are invalid.
|
| BASS_ERROR_MEM | There is insufficient memory.
|
| BASS_ERROR_NO3D | Could not initialize 3D support.
|
| BASS_ERROR_UNKNOWN | Some other mystery problem!
|
Remarks
This is a local file version of the BASS_HLS_StreamCreateURL function. If the media segments are local files then the full path to the media (or master) playlist should be given in file.
See also
BASS_HLS_StreamCreateURL, BASS_CONFIG_HLS_BANDWIDTH, BASS_CONFIG_HLS_DELAY
BASS_ChannelGetInfo, BASS_ChannelGetTags, BASS_ChannelPlay, BASS_ChannelSetAttribute, BASS_ChannelSetDSP, BASS_ChannelSetFX, BASS_StreamFree