Creates a sample stream from a WMA file or URL, optionally with a username and password to authenticate.
| 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), 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.
| | BASS_FILE_ISTREAM | file is an IStream object.
|
|
| 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_SAMPLE_LOOP | Loop the file. This flag can be toggled at any time using BASS_ChannelFlags.
| | 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_ASYNCFILE | Read the file asynchronously. When enabled, the file is read and buffered in parallel with the decoding, to reduce the chances of the decoder being affected by I/O delays. This can be particularly useful with slow storage media and/or low latency output. The size of the file buffer is determined by the BASS_CONFIG_ASYNCFILE_BUFFER config option. This flag only applies when the BASS_CONFIG_WMA_BASSFILE config option is enabled, and is ignored when streaming from memory.
| | BASS_UNICODE | file, user and pass are in UTF-16 form. Otherwise they are ANSI.
|
|
| user | Username to use in connecting to the server... if either this or pass is NULL, then no username/password is sent to the server.
|
| pass | Password to use in connecting to the server.
|
| BASS_ERROR_WMA | The Windows Media modules (v9 or above) are not installed.
|
| 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 | One or more of the parameters are invalid.
|
| BASS_ERROR_PROTOCOL | The protocol in file is not supported.
|
| BASS_ERROR_TIMEOUT | The server did not respond to the request within the timeout period, as set with the BASS_CONFIG_NET_TIMEOUT config option.
|
| 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, or it also contains video and videos are disabled.
|
| BASS_ERROR_CODEC | The file uses a codec that is not available/supported.
|
| 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_WMA_DENIED | Access was denied. Check the user and pass.
|
| BASS_ERROR_WMA_LICENSE | The WMA file cannot be played because it is protected.
|
| BASS_ERROR_UNKNOWN | Some other mystery problem!
|