libZPlay documentation (Win32)
IndexReferenceHome
PreviousUpNext
libZPlayCpp::zplay_LoadID3 Function

Load ID3 data from current stream. (ANSI version)

C++
__stdcall __declspec(dllimport) int zplay_LoadID3(ZPLAY_HANDLE handle, TID3Version nId3Version, TID3Info * pId3Info);
Parameters 
Description 
ZPLAY_HANDLE handle 
ZPLAY handle. Get this handle with zplay_CreateZPlay
TID3Version nId3Version 
ID3 version.
Note: This value is only used for sfMp3 stream format. For all other stream formats this parameter is ignored. 
TID3Info * pId3Info 
Pointer to TID3Info structure receiving ID3 data. User must allocate memory for this structure. 
Return Values 
Description 
All OK. 
Error. To get error message read here

Check supported formats for info tag support. Some formats can support some sort of "Info tags", but not all. 

libZPlay library implements "ID3 tag" interface to different info tags (VORBIS comment, RIFF Info, ...). So, you can retrieve ID3 informations from different streams (mp3, ogg, flac, wav) because library will convert "format specific tag" to ID3 tag info. 

Note: If you juste need ID3 data from file, use LoadFileID3 or zplay_LoadFileID3

Load ID3 info from current stream. 

ZPlay C++ Class interface  

TId3Info id3_info;
if(instance->LoadID3(id3Version2, &id3_info))
{
  printf("Title:   %s\n", id3_info.Title);
  printf("Artist:  %s\n", id3_info.Artist);
  printf("Album:   %s\n", id3_info.Album);
  printf("Year:    %s\n", id3_info.Year);
  printf("Comment: %s\n", id3_info.Comment);
  printf("Genre:   %s\n", id3_info.Genre);
  printf("Track:   %s\n", id3_info.TrackNum);
}

 

C Style interface

TId3Info id3_info;
if(zplay_LoadID3(instance, id3Version2, &id3_info))
{
  printf("Title:   %s\n", id3_info.Title);
  printf("Artist:  %s\n", id3_info.Artist);
  printf("Album:   %s\n", id3_info.Album);
  printf("Year:    %s\n", id3_info.Year);
  printf("Comment: %s\n", id3_info.Comment);
  printf("Genre:   %s\n", id3_info.Genre);
  printf("Track:   %s\n", id3_info.TrackNum);
}
Copyright (c) 2010. Zoran Cindori - All rights reserved.

Web: http://libzplay.sourceforge.net/

Email: zcindori@inet.hr