------------------------Engl-------------------------------------
Retrieves tags/headers from a channel.

char *BASS_ChannelGetTags(
    DWORD handle,
    DWORD tags
); 


Parameters
handle The channel handle... a HMUSIC or HSTREAM. 
tags The tags/headers wanted... one of the following.
BASS_TAG_ID3 ID3v1 tags. A pointer to a 128 byte block is returned. See http://www.id3.org/ID3v1 for details of the block's structure.  
BASS_TAG_ID3V2 ID3v2 tags. A pointer to a variable length block is returned. ID3v2 tags are supported at both the start and end of the file. See http://www.id3.org/ for details of the block's structure.  
BASS_TAG_LYRICS3 Lyrics3v2 tag. A single string is returned, containing the Lyrics3v2 information. See http://www.id3.org/Lyrics3v2 for details of its format.  
BASS_TAG_OGG OGG comments. A pointer to a series of null-terminated UTF-8 strings is returned, the final string ending with a double null.  
BASS_TAG_VENDOR OGG encoder. A single UTF-8 string is returned.  
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_META Shoutcast metadata. A single string is returned, containing the current stream title and url (usually omitted). The format of the string is: StreamTitle='xxx';StreamUrl='xxx';  
BASS_TAG_RIFF_INFO RIFF/WAVE "INFO" tags. A pointer to a series of null-terminated 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..  
BASS_TAG_MUSIC_NAME MOD music title.  
BASS_TAG_MUSIC_MESSAGE MOD message text.  
BASS_TAG_MUSIC_INST
+ instrument number (0=first) MOD instrument name. Only available with formats that have instruments, eg. IT and XM (and MO3).  
BASS_TAG_MUSIC_SAMPLE
+ sample number (0=first) MOD sample name.  
other tags may be supported by add-ons, see the documentation.  
 


Return value
If successful, the requested tags are returned, else NULL is returned. Use BASS_ErrorGetCode to get the error code.

Error codes
BASS_ERROR_HANDLE handle is not valid. 
BASS_ERROR_NOTAVAIL The requested tags are not available. 


Remarks
ID3v1 tags are located at the end of the file, so when streaming a file with ID3v1 tags from the internet, the tags will not be available until the download is complete. A BASS_SYNC_DOWNLOAD sync can be set via BASS_ChannelSetSync, to be informed of when the download is complete. A BASS_SYNC_META sync can be used to be informed of new Shoutcast metadata, and a BASS_SYNC_OGG_CHANGE sync for when a new logical bitstream begins in a chained OGG stream, which generally brings new OGG tags.

Example
List an OGG stream's comments.

char *comments=BASS_ChannelGetTags(channel, BASS_TAG_OGG); // get a pointer to the 1st comment
if (comments)
    while (*comments) {
        printf("%s\n", comments); // display the comment
        comments+=strlen(comments)+1; // move on to next comment
    }
 


List a MOD music's samples.

char *text;
int n=0;
while (text=BASS_ChannelGetTags(channel, BASS_TAG_MUSIC_SAMPLE+n)) {
    printf("sample %d = %s\n", n+1, text); // display the sample text
    n++; // move on to next sample
}
 


See also
BASS_ChannelSetSync

-------------- -----------------------------------

  /   . 

Char * BASS_ChannelGetTags ( 
     DWORD , 
     DWORD  
); 


 
   ... HMUSIC  HSTREAM. 
  /   ...    . 
BASS_TAG_ID3 ID3v1 .    128  . . http://www.id3.org/ID3v1      . 
BASS_TAG_ID3V2  ID3v2.      . ID3v2,       . . http://www.id3.org/      . 
BASS_TAG_LYRICS3 Lyrics3v2 .   ,  Lyrics3v2 . . http://www.id3.org/Lyrics3v2      . 
BASS_TAG_OGG OGG .      UTF-8  ,     NULL. 
BASS_TAG_VENDOR OGG Encoder.   UTF-8 . 
BASS_TAG_HTTP HTTP ,       HTTP.       ,     NULL. 
BASS_TAG_ICY ICY (Shoutcast) .       ,     NULL. 
BASS_TAG_META Shoutcast .   ,     URL  ( ).  : StreamTitle = 'XXX'; StreamUrl = 'XXX'; 
BASS_TAG_RIFF_INFO RIFF / WAVE "INFO" .       ,     NULL.    "XXXX = ",  "XXXX"   ID .. 
BASS_TAG_MUSIC_NAME MOD  . 
BASS_TAG_MUSIC_MESSAGE MOD  . 
BASS_TAG_MUSIC_INST 
+   (0 = ) MOD  .    ,   , .   XM ( MO3). 
BASS_TAG_MUSIC_SAMPLE 
+   (0 = ) MOD  . 
      .  . 
  


  
     ,   NULL.  BASS_ErrorGetCode,    . 

  
BASS_ERROR_HANDLE   . 
BASS_ERROR_NOTAVAIL    . 


 
 ID3v1    ,       ID3v1   ,       . Sync BASS_SYNC_DOWNLOAD     BASS_ChannelSetSync,    ,    . Sync BASS_SYNC_META          Shoutcast,  BASS_SYNC_OGG_CHANGE  ,    Bitstream     OGG,     , OGG. 

 
  OGG . 

Char *  = BASS_ChannelGetTags (, BASS_TAG_OGG) / /    1-  
 () 
     While (* ) ( 
          ( "%  \ ", ); / /   
          + = StrLen () 1 / /     
     ) 
  


 MOD  . 

Char * ; 
 = 0; 
While (Text = BASS_ChannelGetTags (, BASS_TAG_MUSIC_SAMPLE + N)) ( 
      ( "Sample% D =%  \ ", N 1, ); / /    
     N + +; / /     
) 
  


.  
BASS_ChannelSetSync 