Retrieves the header tags from a channel, if they are available.
NOTE: This method evaluates the header as a series/array of null-terminated Ansi strings.
Might be used e.g. with: RIFF_INFO, ICY and HTTP.
Namespace: Un4seen.Bass
Assembly: Bass.Net (in Bass.Net.dll) Version: 2.4.17.5
Syntax
Parameters
- handle
- Type: SystemInt32
The stream's handle. - format
- Type: Un4seen.BassBASSTag
The type of tags/headers wanted... one of the following (see BASSTag):Other tags may be supported by Add-Ons, see the documentation (ASNI only).BASS_TAG_HTTP HTTP headers, only available when streaming from a HTTP server. A pointer to a series of null-terminated strings is returned, the final string ending with a double null. BASS_TAG_ICY ICY (Shoutcast) tags. A pointer to a series of null-terminated strings is returned, the final string ending with a double null. BASS_TAG_RIFF_INFO RIFF/WAVE 'INFO' tags. A pointer to a series of null-terminated ANSI strings is returned, the final string ending with a double null. The tags are in the form of 'XXXX=text', where 'XXXX' is the chunk ID.
Return Value
Type: Stringor an array of strings. Each array element will represent one tag, e.g. "TITLE=this is a title"
Remarks
In addition you might also use the BassTags class, which provides extended TAG reading support.
ERROR CODE | Description |
---|---|
BASS_ERROR_HANDLE | handle is not valid. |
BASS_ERROR_NOTAVAIL | The requested tags are not available. |
See Also