Retrieves the header tags from a channel, if they are available.
NOTE: This method evaluates the header as a series/array of null-terminated UTF-8 strings.
Might be used e.g. with: APE, MP4, OGG and WMA - if UTF-8!
Namespace: Un4seen.Bass
Assembly: Bass.Net (in Bass.Net.dll) Version: 2.4.17.5
Syntax
Parameters
- handle
- Type: SystemInt32
The channel handle...a HMUSIC or HSTREAM. - 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 - only UTF-8!BASS_TAG_OGG OGG tags, only available when streaming an OGG file. A pointer to a series of null-terminated UTF-8 strings is returned, the final string ending with a double null. BASS_TAG_VENDOR Vendor encoder tag. A single UTF-8 string is returned. BASS_TAG_WMA WMA tags : array of null-terminated UTF-8 strings. BASS_TAG_WMA_META WMA mid-stream tag : A single UTF-8 string is returned. BASS_TAG_WMA_CODEC WMA codec tag : Two UTF-8 strings are returned. BASS_TAG_APE APE tags. A pointer to a series of null-terminated UTF-8 strings is returned, the final string ending with a double null. Each string is in the form of "key=value", or "key=value1/value2/..." if there are multiple values. BASS_TAG_MP4 MP4 tags. A pointer to a series of null-terminated UTF-8 strings is returned, the final string ending with a double null. BASS_TAG_MF Media Foundation metadata. A pointer to a series of null-terminated UTF-8 strings is returned, the final string ending with a double null.
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