BASS_ALAC_StreamCreateFile
Creates a sample stream from an ALAC file.
HSTREAM BASS_ALAC_StreamCreateFile( BOOL mem, void *file, QWORD offset, QWORD length, DWORD flags );
Parameters
mem | TRUE = stream the file from memory. | ||||||||||||||||||||
file | Filename (mem = FALSE) or a memory location (mem = TRUE). | ||||||||||||||||||||
offset | File offset to begin streaming from (only used if mem = FALSE). | ||||||||||||||||||||
length | Data length... 0 = use all data up to the end of the file (if mem = FALSE). | ||||||||||||||||||||
flags | A combination of these flags.
|
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 | Only decoding channels (BASS_STREAM_DECODE) are allowed when using the "no sound" device. The BASS_STREAM_AUTOFREE flag is also unavailable to decoding channels. |
BASS_ERROR_ILLPARAM | The length must be specified 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_FORMAT | The sample format is not supported by the device/drivers. If the stream is more than stereo or the BASS_SAMPLE_FLOAT flag is used, it could be that they are not supported. |
BASS_ERROR_SPEAKER | The specified SPEAKER flags are invalid. The device/drivers do not support them, they are attempting to assign a stereo stream to a mono speaker or 3D functionality is enabled. |
BASS_ERROR_MEM | There is insufficient memory. |
BASS_ERROR_NO3D | Could not initialize 3D support. |
BASS_ERROR_UNKNOWN | Some other mystery problem! |
Remarks
All ALAC sample resolutions from 16 to 32-bit are supported, but the output will be restricted to 16-bit unless the BASS_SAMPLE_FLOAT flag is used. The file's original resolution is available from BASS_ChannelGetInfo, as is the sample rate and channel count. The playback length is available from BASS_ChannelGetLength. ALAC files can have MP4 tags, which can be retrieved by using BASS_TAG_MP4 with BASS_ChannelGetTags.To stream a file from the internet, use BASS_ALAC_StreamCreateURL. To stream from other locations, see BASS_ALAC_StreamCreateFileUser.
Platform-specific
Away from Windows, all mixing is done in software (by BASS), so the BASS_SAMPLE_SOFTWARE flag is unnecessary. The BASS_SAMPLE_FX flag is also ignored.Example
Create a stream from an ALAC file.HSTREAM stream=BASS_ALAC_StreamCreateFile(FALSE, "alacfile.m4a", 0, 0, 0);
See also
BASS_ALAC_StreamCreateFileUser, BASS_ALAC_StreamCreateURLBASS_ChannelGetInfo, BASS_ChannelGetLength, BASS_ChannelGetTags, BASS_ChannelPlay, BASS_ChannelSetAttribute, BASS_ChannelSetDSP, BASS_ChannelSetFX, BASS_ChannelSetLink, BASS_StreamFree, BASS_StreamGetFilePosition