BASS_DSD_StreamCreateURL
Creates a sample stream from an DSD file on the internet, optionally receiving the downloaded data in a callback.
HSTREAM BASS_DSD_StreamCreateURL(
char *url,
DWORD offset,
DWORD flags,
DOWNLOADPROC *proc,
void *user,
DWORD freq
);
Parameters
| url | URL of the file to stream. Should begin with "http://" or "https://" or "ftp://".
|
| offset | File position to start streaming from. This is ignored by some servers, specifically when the file length is unknown.
|
| flags | A combination of these flags.
| BASS_SAMPLE_FLOAT | Use 32-bit floating-point sample data. See Floating-point channels for info. Otherwise the sample data will be 16-bit.
| | 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. This flag is ignored when streaming in blocks (BASS_STREAM_BLOCK).
| | BASS_STREAM_RESTRATE | Restrict the download rate of the file, according to the BASS_CONFIG_NET_RESTRATE config setting. If this flag is not used then the file will be downloaded as quickly as possible.
| | BASS_STREAM_BLOCK | Only keep a block of the downloaded file in memory, determined by the BASS_CONFIG_NET_BUFFER config setting, rather than the whole file. This uses a lot less memory than otherwise, but it is not possible to seek or loop the stream. This flag will be applied automatically when the file length is unknown or over 2GB.
| | BASS_STREAM_STATUS | Pass status info (HTTP/ICY tags) from the server to the DOWNLOADPROC callback during connection. This can be useful to determine the reason for a failure.
| | 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_DSD_DOP | Produce DSD-over-PCM data with 0x05/0xFA markers. DSD-over-PCM data is 24-bit, so the BASS_SAMPLE_FLOAT flag is required.
| | BASS_DSD_DOP_AA | Produce DSD-over-PCM data with 0xAA markers. DSD-over-PCM data is 24-bit, so the BASS_SAMPLE_FLOAT flag is required.
| | BASS_DSD_RAW | Produce raw DSD data instead of PCM. The DSD data is in blocks of 8 bits (1 byte) per-channel with the MSB being first/oldest. DSD data is not playable by BASS, so the BASS_STREAM_DECODE flag is required.
| | BASS_SPEAKER_xxx | Speaker assignment flags. These flags have no effect when the stream is more than stereo.
| | BASS_UNICODE | url is in UTF-16 form. Otherwise it is ANSI on Windows or Windows CE, and UTF-8 on other platforms.
|
|
| proc | Callback function to receive the file as it is downloaded... NULL = no callback.
|
| user | User instance data to pass to the callback function.
|
| freq | Sample rate to convert the DSD data to PCM at... 0 = use the BASS_CONFIG_DSD_FREQ config setting. The rate will be rounded up (or down if there are none higher) to the nearest valid rate; the valid rates are 1/8, 1/16, 1/32, etc of the DSD rate down to a minimum of 44100 Hz. This parameter is ignored when the BASS_DSD_DOP or BASS_DSD_DOP_AA or BASS_DSD_RAW flag is specified.
|
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_NONET | No internet connection could be opened.
|
| BASS_ERROR_ILLPARAM | url is not a valid URL.
|
| BASS_ERROR_PROTOCOL | The protocol in url is not supported.
|
| BASS_ERROR_SSL | SSL/HTTPS support is not available. See BASS_CONFIG_LIBSSL.
|
| 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_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
The BASS_DSD_StreamCreateFile remarks also apply to this function, as do the general BASS_StreamCreateURL remarks.
See also
BASS_DSD_StreamCreateFile, BASS_DSD_StreamCreateFileUser
BASS_ChannelGetInfo, BASS_ChannelGetLength, BASS_ChannelGetTags, BASS_ChannelPlay, BASS_ChannelSetAttribute, BASS_ChannelSetDSP, BASS_ChannelSetFX, BASS_StreamFree, BASS_StreamGetFilePosition, DOWNLOADPROC callback, BASS_CONFIG_NET_AGENT, BASS_CONFIG_NET_BUFFER, BASS_CONFIG_NET_PREBUF, BASS_CONFIG_NET_PROXY, BASS_CONFIG_NET_TIMEOUT