BASS.NET API for the Un4seen BASS Audio Library

BassBASS_ChannelGetTagsArrayNullTermAnsi Method

BASS.NET API for the Un4seen BASS Audio Library
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
Copy
public static string[] BASS_ChannelGetTagsArrayNullTermAnsi(
	int handle,
	BASSTag format
)

Parameters

handle
Type: SystemInt32
The stream's handle.
format
Type: Un4seen.BassBASSTag
The type of tags/headers wanted... one of the following (see BASSTag):
BASS_TAG_HTTPHTTP 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_ICYICY (Shoutcast) tags. A pointer to a series of null-terminated strings is returned, the final string ending with a double null.
BASS_TAG_RIFF_INFORIFF/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.
Other tags may be supported by Add-Ons, see the documentation (ASNI only).

Return Value

Type: String
or an array of strings. Each array element will represent one tag, e.g. "TITLE=this is a title"
Remarks
Only available when streaming a file containing tags/headers which are defined as a series of null-terminated ASNI strings! So make sure to use this method only with appropriate formats!

In addition you might also use the BassTags class, which provides extended TAG reading support.

ERROR CODEDescription
BASS_ERROR_HANDLEhandle is not valid.
BASS_ERROR_NOTAVAILThe requested tags are not available.

See Also

Reference

Bass Class
Un4seen.Bass Namespace