https://wiki.hydrogenaud.io/api.php?action=feedcontributions&user=MaB+fr&feedformat=atomHydrogenaudio Knowledgebase - User contributions [en]2024-03-29T06:26:35ZUser contributionsMediaWiki 1.22.7https://wiki.hydrogenaud.io/index.php?title=WMP_Tag_Support_ExtenderWMP Tag Support Extender2007-02-28T02:10:03Z<p>MaB fr: /* Extensibility */</p>
<hr />
<div>{{Software Infobox<br />
| name = Windows Media Player Tag Support Extender<br />
| screenshot = [http://wmptagext.sourceforge.net/screenshots.html Screenshot]<br />
| caption = WMP plug-in extending tag capabilities<br />
| maintainer = MaB_fr <br />
| stable_release = 1.4<br />
| preview_release = none <br />
| operating_system = Windows<br />
| use = WMP plug-in<br />
| license = Public domain + source<br />
| website = [http://http://wmptagext.sourceforge.net/ http://wmptagext.sourceforge.net]<br />
}}<br />
<br />
<br />
'''Windows Media Player Tag Support Extender''' (WMPTSE) is a plug-in to [[Windows Media Player]] to allow more [[tags]] support than the default [[WMA]] + [[ID3]] within the player.<br />
<br />
It supports version 9.x, 10.x and 11.0 of [[Windows Media Player]].<br />
<br />
The current version (1.3) supports [[Vorbis comment]], [[APEv2]] and [[FLAC]] and [[MPEG4]].<br />
<br />
<br />
<br />
==Supported Tag Format==<br />
* [[FLAC]]<br />
* [[APE]]<br />
* [[Vorbis comment]] - READ-ONLY<br />
* [[MPEG4]] - READ-ONLY<br />
<br />
Additional tagging formats may be supported through a plug-in API (known as [[WMPTSE API]])<br />
<br />
<br />
==Supported Filetypes==<br />
* [[FLAC]] - Free Lossless Audio Codec(*.flac)<br />
* [[APE]] - Monkey's Audio (*.ape)<br />
* [[MPC]] - MusePack (*.mpc)<br />
* [[WavPack]] (*.wv)<br />
* [[OptimFROG]] (*.ofr)<br />
* [[Ogg Vorbis]] - Ogg files (*.ogg) - READ-ONLY<br />
* [[AAC]] - Advanced Audio Coding (*.aac) - READ-ONLY<br />
* [[M4A]],[[MP4]] - MPEG4 Audio (*.m4a) - READ-ONLY<br />
<br />
<br />
==Extensibility==<br />
WMPTSE provide options to add tagging based on file extension.<br />
<br />
It allows tagging in files who usually don't support it, such as exotic (but useful) tagging of [[AC3]], [[DTS]] and [[LPCM]] files, or less useful like .txt, JPEG file tagging and more.<br />
<br />
Tag support is pluggable. Each "tag support dll" responds to the [[WMPTSE API]].<br />
<br />
==Guide & Howtos==<br />
<br />
[[WMPTSE - How to change the plug-in properties]]<br />
<br />
[[WMPTSE - How to add support for a filetype]]<br />
<br />
[http://www.losslessaudioblog.com/wmpmce-lossless-guide/ The complete Media Center + WMPTSE guide] (from [http://www.losslessaudioblog.com/ LosslessAudioBlog])<br />
<br />
[[WMPTSE - How to add support for a tag format]]<br />
<br />
==Price==<br />
The sofware is free.<br />
<br />
<br />
==External links==<br />
* [http://wmptagext.sourceforge.net/ WMPTSE homepage]<br />
* [http://wmptagext.sourceforge.net/download.html WMPTSE download page]<br />
* [http://www.hydrogenaudio.org/forums/index.php?s=e03ece01d79f55a3f390268762345f0f&showtopic=38400&st=275 HydrogenAudio thread]<br />
<br />
<br />
[[Category:Software]]<br />
[[Category:Media Players]]</div>MaB frhttps://wiki.hydrogenaud.io/index.php?title=WMP_Tag_Support_ExtenderWMP Tag Support Extender2007-02-18T02:29:57Z<p>MaB fr: </p>
<hr />
<div>{{Software Infobox<br />
| name = Windows Media Player Tag Support Extender<br />
| screenshot = [http://wmptagext.sourceforge.net/screenshots.html Screenshot]<br />
| caption = WMP plug-in extending tag capabilities<br />
| maintainer = MaB_fr <br />
| stable_release = 1.3<br />
| preview_release = none <br />
| operating_system = Windows<br />
| use = WMP plug-in<br />
| license = Public domain + source<br />
| website = [http://http://wmptagext.sourceforge.net/ http://wmptagext.sourceforge.net]<br />
}}<br />
<br />
<br />
'''Windows Media Player Tag Support Extender''' (WMPTSE) is a plug-in to [[Windows Media Player]] to allow more [[tags]] support than the default [[WMA]] + [[ID3]] within the player.<br />
<br />
It supports version 9.x, 10.x and 11.0 of [[Windows Media Player]].<br />
<br />
The current version (1.3) supports [[Vorbis comment]], [[APEv2]] and [[FLAC]] and [[MPEG4]].<br />
<br />
<br />
<br />
==Supported Tag Format==<br />
* [[FLAC]]<br />
* [[APE]]<br />
* [[Vorbis comment]] - READ-ONLY<br />
* [[MPEG4]] - READ-ONLY<br />
<br />
Additional tagging formats may be supported through a plug-in API (known as [[WMPTSE API]])<br />
<br />
<br />
==Supported Filetypes==<br />
* [[FLAC]] - Free Lossless Audio Codec(*.flac)<br />
* [[APE]] - Monkey's Audio (*.ape)<br />
* [[MPC]] - MusePack (*.mpc)<br />
* [[WavPack]] (*.wv)<br />
* [[OptimFROG]] (*.ofr)<br />
* [[Ogg Vorbis]] - Ogg files (*.ogg) - READ-ONLY<br />
* [[AAC]] - Advanced Audio Coding (*.aac) - READ-ONLY<br />
* [[M4A]],[[MP4]] - MPEG4 Audio (*.m4a) - READ-ONLY<br />
<br />
<br />
==Extensibility==<br />
WMPTSE provide options to add tagging based on file extension.<br />
<br />
It allows tagging in files who usually don't support it, such as exotic (but useful) tagging of [[AC3]], [[DTS]] and [[LPCM]] files, or less useful like .txt, JPEG file tagging and more.<br />
<br />
Tag support is pluggable. Each "tag support dll" responding to the [[WMPTSE API]].<br />
<br />
<br />
==Guide & Howtos==<br />
<br />
[[WMPTSE - How to change the plug-in properties]]<br />
<br />
[[WMPTSE - How to add support for a filetype]]<br />
<br />
[http://www.losslessaudioblog.com/wmpmce-lossless-guide/ The complete Media Center + WMPTSE guide] (from [http://www.losslessaudioblog.com/ LosslessAudioBlog])<br />
<br />
[[WMPTSE - How to add support for a tag format]]<br />
<br />
==Price==<br />
The sofware is free.<br />
<br />
<br />
==External links==<br />
* [http://wmptagext.sourceforge.net/ WMPTSE homepage]<br />
* [http://wmptagext.sourceforge.net/download.html WMPTSE download page]<br />
* [http://www.hydrogenaudio.org/forums/index.php?s=e03ece01d79f55a3f390268762345f0f&showtopic=38400&st=275 HydrogenAudio thread]<br />
<br />
<br />
[[Category:Software]]<br />
[[Category:Media Players]]</div>MaB frhttps://wiki.hydrogenaud.io/index.php?title=WMP_Tag_Support_ExtenderWMP Tag Support Extender2006-12-24T13:39:49Z<p>MaB fr: /* Guide & Howtos */</p>
<hr />
<div>{{Software Infobox<br />
| name = Windows Media Player Tag Support Extender<br />
| screenshot = [http://wmptagext.sourceforge.net/screenshots.html Screenshot]<br />
| caption = WMP plug-in extending tag capabilities<br />
| maintainer = MaB_fr <br />
| stable_release = 1.1.1 <br />
| preview_release = none <br />
| operating_system = Windows<br />
| use = WMP plug-in<br />
| license = Public domain + source<br />
| website = [http://http://wmptagext.sourceforge.net/ http://wmptagext.sourceforge.net]<br />
}}<br />
<br />
<br />
'''Windows Media Player Tag Support Extender''' (WMPTSE) is a plug-in to [[Windows Media Player]] to allow more [[tags]] support than the default [[WMA]] + [[ID3]] within the player.<br />
<br />
It supports version 9.x, 10.x and 11.0 of [[Windows Media Player]].<br />
<br />
The current version (1.1.1) supports [[Vorbis comment]], [[APEv2]] and [[FLAC]] and [[MPEG4]].<br />
<br />
<br />
<br />
==Supported Tag Format==<br />
* [[FLAC]]<br />
* [[APE]]<br />
* [[Vorbis comment]] - READ-ONLY<br />
* [[MPEG4]] - READ-ONLY<br />
<br />
Additional tagging formats may be supported through a plug-in API (known as [[WMPTSE API]])<br />
<br />
<br />
==Supported Filetypes==<br />
* [[FLAC]] - Free Lossless Audio Codec(*.flac)<br />
* [[APE]] - Monkey's Audio (*.ape)<br />
* [[MPC]] - MusePack (*.mpc)<br />
* [[WavPack]] (*.wv)<br />
* [[OptimFROG]] (*.ofr)<br />
* [[Ogg Vorbis]] - Ogg files (*.ogg) - READ-ONLY<br />
* [[AAC]] - Advanced Audio Coding (*.aac) - READ-ONLY<br />
* [[M4A]],[[MP4]] - MPEG4 Audio (*.m4a) - READ-ONLY<br />
<br />
<br />
==Extensibility==<br />
WMPTSE provide options to add tagging based on file extension.<br />
<br />
It allows tagging in files who usually don't support it, such as exotic (but useful) tagging of [[AC3]], [[DTS]] and [[LPCM]] files, or less useful like .txt, JPEG file tagging and more.<br />
<br />
Tag support is pluggable. Each "tag support dll" responding to the [[WMPTSE API]].<br />
<br />
<br />
==Guide & Howtos==<br />
<br />
[[WMPTSE - How to change the plug-in properties]]<br />
<br />
[[WMPTSE - How to add support for a filetype]]<br />
<br />
[http://www.losslessaudioblog.com/wmpmce-lossless-guide/ The complete Media Center + WMPTSE guide] (from [http://www.losslessaudioblog.com/ LosslessAudioBlog])<br />
<br />
[[WMPTSE - How to add support for a tag format]]<br />
<br />
==Price==<br />
The sofware is free.<br />
<br />
<br />
==External links==<br />
* [http://wmptagext.sourceforge.net/ WMPTSE homepage]<br />
* [http://wmptagext.sourceforge.net/download.html WMPTSE download page]<br />
* [http://www.hydrogenaudio.org/forums/index.php?s=e03ece01d79f55a3f390268762345f0f&showtopic=38400&st=275 HydrogenAudio thread]<br />
<br />
<br />
[[Category:Software]]<br />
[[Category:Media Players]]</div>MaB frhttps://wiki.hydrogenaud.io/index.php?title=WMP_Tag_Support_ExtenderWMP Tag Support Extender2006-12-24T13:39:18Z<p>MaB fr: /* Guide & Howtos */</p>
<hr />
<div>{{Software Infobox<br />
| name = Windows Media Player Tag Support Extender<br />
| screenshot = [http://wmptagext.sourceforge.net/screenshots.html Screenshot]<br />
| caption = WMP plug-in extending tag capabilities<br />
| maintainer = MaB_fr <br />
| stable_release = 1.1.1 <br />
| preview_release = none <br />
| operating_system = Windows<br />
| use = WMP plug-in<br />
| license = Public domain + source<br />
| website = [http://http://wmptagext.sourceforge.net/ http://wmptagext.sourceforge.net]<br />
}}<br />
<br />
<br />
'''Windows Media Player Tag Support Extender''' (WMPTSE) is a plug-in to [[Windows Media Player]] to allow more [[tags]] support than the default [[WMA]] + [[ID3]] within the player.<br />
<br />
It supports version 9.x, 10.x and 11.0 of [[Windows Media Player]].<br />
<br />
The current version (1.1.1) supports [[Vorbis comment]], [[APEv2]] and [[FLAC]] and [[MPEG4]].<br />
<br />
<br />
<br />
==Supported Tag Format==<br />
* [[FLAC]]<br />
* [[APE]]<br />
* [[Vorbis comment]] - READ-ONLY<br />
* [[MPEG4]] - READ-ONLY<br />
<br />
Additional tagging formats may be supported through a plug-in API (known as [[WMPTSE API]])<br />
<br />
<br />
==Supported Filetypes==<br />
* [[FLAC]] - Free Lossless Audio Codec(*.flac)<br />
* [[APE]] - Monkey's Audio (*.ape)<br />
* [[MPC]] - MusePack (*.mpc)<br />
* [[WavPack]] (*.wv)<br />
* [[OptimFROG]] (*.ofr)<br />
* [[Ogg Vorbis]] - Ogg files (*.ogg) - READ-ONLY<br />
* [[AAC]] - Advanced Audio Coding (*.aac) - READ-ONLY<br />
* [[M4A]],[[MP4]] - MPEG4 Audio (*.m4a) - READ-ONLY<br />
<br />
<br />
==Extensibility==<br />
WMPTSE provide options to add tagging based on file extension.<br />
<br />
It allows tagging in files who usually don't support it, such as exotic (but useful) tagging of [[AC3]], [[DTS]] and [[LPCM]] files, or less useful like .txt, JPEG file tagging and more.<br />
<br />
Tag support is pluggable. Each "tag support dll" responding to the [[WMPTSE API]].<br />
<br />
<br />
==Guide & Howtos==<br />
<br />
[[WMPTSE - How to change the plug-in properties]]<br />
<br />
[[WMPTSE - How to add support for a filetype]]<br />
<br />
[http://www.losslessaudioblog.com/wmpmce-lossless-guide/ The complete Media Center + WMPTSE guide] (from [http://www.losslessaudioblog.com/ LosslessAudioBlog])<br />
<br />
[[WMPTSE - How to add support for a tag format]]<br />
<br />
[[WMPTSE - How to listen audio from DVD and DVDAudio files in Windows Media Player]]<br />
<br />
==Price==<br />
The sofware is free.<br />
<br />
<br />
==External links==<br />
* [http://wmptagext.sourceforge.net/ WMPTSE homepage]<br />
* [http://wmptagext.sourceforge.net/download.html WMPTSE download page]<br />
* [http://www.hydrogenaudio.org/forums/index.php?s=e03ece01d79f55a3f390268762345f0f&showtopic=38400&st=275 HydrogenAudio thread]<br />
<br />
<br />
[[Category:Software]]<br />
[[Category:Media Players]]</div>MaB frhttps://wiki.hydrogenaud.io/index.php?title=WMP_Tag_Support_ExtenderWMP Tag Support Extender2006-12-24T13:38:54Z<p>MaB fr: /* Guide & Howtos */</p>
<hr />
<div>{{Software Infobox<br />
| name = Windows Media Player Tag Support Extender<br />
| screenshot = [http://wmptagext.sourceforge.net/screenshots.html Screenshot]<br />
| caption = WMP plug-in extending tag capabilities<br />
| maintainer = MaB_fr <br />
| stable_release = 1.1.1 <br />
| preview_release = none <br />
| operating_system = Windows<br />
| use = WMP plug-in<br />
| license = Public domain + source<br />
| website = [http://http://wmptagext.sourceforge.net/ http://wmptagext.sourceforge.net]<br />
}}<br />
<br />
<br />
'''Windows Media Player Tag Support Extender''' (WMPTSE) is a plug-in to [[Windows Media Player]] to allow more [[tags]] support than the default [[WMA]] + [[ID3]] within the player.<br />
<br />
It supports version 9.x, 10.x and 11.0 of [[Windows Media Player]].<br />
<br />
The current version (1.1.1) supports [[Vorbis comment]], [[APEv2]] and [[FLAC]] and [[MPEG4]].<br />
<br />
<br />
<br />
==Supported Tag Format==<br />
* [[FLAC]]<br />
* [[APE]]<br />
* [[Vorbis comment]] - READ-ONLY<br />
* [[MPEG4]] - READ-ONLY<br />
<br />
Additional tagging formats may be supported through a plug-in API (known as [[WMPTSE API]])<br />
<br />
<br />
==Supported Filetypes==<br />
* [[FLAC]] - Free Lossless Audio Codec(*.flac)<br />
* [[APE]] - Monkey's Audio (*.ape)<br />
* [[MPC]] - MusePack (*.mpc)<br />
* [[WavPack]] (*.wv)<br />
* [[OptimFROG]] (*.ofr)<br />
* [[Ogg Vorbis]] - Ogg files (*.ogg) - READ-ONLY<br />
* [[AAC]] - Advanced Audio Coding (*.aac) - READ-ONLY<br />
* [[M4A]],[[MP4]] - MPEG4 Audio (*.m4a) - READ-ONLY<br />
<br />
<br />
==Extensibility==<br />
WMPTSE provide options to add tagging based on file extension.<br />
<br />
It allows tagging in files who usually don't support it, such as exotic (but useful) tagging of [[AC3]], [[DTS]] and [[LPCM]] files, or less useful like .txt, JPEG file tagging and more.<br />
<br />
Tag support is pluggable. Each "tag support dll" responding to the [[WMPTSE API]].<br />
<br />
<br />
==Guide & Howtos==<br />
<br />
[[WMPTSE - How to change the plug-in properties]]<br />
<br />
[[WMPTSE - How to add support for a filetype]]<br />
<br />
[http://www.losslessaudioblog.com/wmpmce-lossless-guide/ The complete Media Center + WMPTSE guide] (from [http://www.losslessaudioblog.com/ LosslessAudioBlog])<br />
<br />
[[WMPTSE - How to add support for a tag format]]<br />
<br />
[[WMPTSE - How to listen DVD Audio files from Windows Media Player]]<br />
<br />
==Price==<br />
The sofware is free.<br />
<br />
<br />
==External links==<br />
* [http://wmptagext.sourceforge.net/ WMPTSE homepage]<br />
* [http://wmptagext.sourceforge.net/download.html WMPTSE download page]<br />
* [http://www.hydrogenaudio.org/forums/index.php?s=e03ece01d79f55a3f390268762345f0f&showtopic=38400&st=275 HydrogenAudio thread]<br />
<br />
<br />
[[Category:Software]]<br />
[[Category:Media Players]]</div>MaB frhttps://wiki.hydrogenaud.io/index.php?title=WMP_Tag_Support_ExtenderWMP Tag Support Extender2006-12-24T13:38:40Z<p>MaB fr: /* Guide & Howtos */</p>
<hr />
<div>{{Software Infobox<br />
| name = Windows Media Player Tag Support Extender<br />
| screenshot = [http://wmptagext.sourceforge.net/screenshots.html Screenshot]<br />
| caption = WMP plug-in extending tag capabilities<br />
| maintainer = MaB_fr <br />
| stable_release = 1.1.1 <br />
| preview_release = none <br />
| operating_system = Windows<br />
| use = WMP plug-in<br />
| license = Public domain + source<br />
| website = [http://http://wmptagext.sourceforge.net/ http://wmptagext.sourceforge.net]<br />
}}<br />
<br />
<br />
'''Windows Media Player Tag Support Extender''' (WMPTSE) is a plug-in to [[Windows Media Player]] to allow more [[tags]] support than the default [[WMA]] + [[ID3]] within the player.<br />
<br />
It supports version 9.x, 10.x and 11.0 of [[Windows Media Player]].<br />
<br />
The current version (1.1.1) supports [[Vorbis comment]], [[APEv2]] and [[FLAC]] and [[MPEG4]].<br />
<br />
<br />
<br />
==Supported Tag Format==<br />
* [[FLAC]]<br />
* [[APE]]<br />
* [[Vorbis comment]] - READ-ONLY<br />
* [[MPEG4]] - READ-ONLY<br />
<br />
Additional tagging formats may be supported through a plug-in API (known as [[WMPTSE API]])<br />
<br />
<br />
==Supported Filetypes==<br />
* [[FLAC]] - Free Lossless Audio Codec(*.flac)<br />
* [[APE]] - Monkey's Audio (*.ape)<br />
* [[MPC]] - MusePack (*.mpc)<br />
* [[WavPack]] (*.wv)<br />
* [[OptimFROG]] (*.ofr)<br />
* [[Ogg Vorbis]] - Ogg files (*.ogg) - READ-ONLY<br />
* [[AAC]] - Advanced Audio Coding (*.aac) - READ-ONLY<br />
* [[M4A]],[[MP4]] - MPEG4 Audio (*.m4a) - READ-ONLY<br />
<br />
<br />
==Extensibility==<br />
WMPTSE provide options to add tagging based on file extension.<br />
<br />
It allows tagging in files who usually don't support it, such as exotic (but useful) tagging of [[AC3]], [[DTS]] and [[LPCM]] files, or less useful like .txt, JPEG file tagging and more.<br />
<br />
Tag support is pluggable. Each "tag support dll" responding to the [[WMPTSE API]].<br />
<br />
<br />
==Guide & Howtos==<br />
<br />
[[WMPTSE - How to change the plug-in properties]]<br />
<br />
[[WMPTSE - How to add support for a filetype]]<br />
<br />
[http://www.losslessaudioblog.com/wmpmce-lossless-guide/ The complete Media Center + WMPTSE guide] (from [http://www.losslessaudioblog.com/ LosslessAudioBlog])<br />
<br />
[[WMPTSE - How to add support for a tag format]]<br />
<br />
[[WMPTSE - How to listen DVD Audio files]]<br />
<br />
==Price==<br />
The sofware is free.<br />
<br />
<br />
==External links==<br />
* [http://wmptagext.sourceforge.net/ WMPTSE homepage]<br />
* [http://wmptagext.sourceforge.net/download.html WMPTSE download page]<br />
* [http://www.hydrogenaudio.org/forums/index.php?s=e03ece01d79f55a3f390268762345f0f&showtopic=38400&st=275 HydrogenAudio thread]<br />
<br />
<br />
[[Category:Software]]<br />
[[Category:Media Players]]</div>MaB frhttps://wiki.hydrogenaud.io/index.php?title=WMPTSE_APIWMPTSE API2006-12-16T12:41:47Z<p>MaB fr: /* Definition */</p>
<hr />
<div>The WMPTSE API is the interface between the [[WMPTSE]] plug-in and its "tag support dll".<br />
<br />
A '''tag support dll''' give WMPTSE the ability to add support of a tag format in Windows Media Player. <br />
With the this "tag support dll" properly installed, files tagged with its format are readable inside WMP.<br />
<br />
<br />
==API==<br />
Every WMPTSE API application must export two function (c standard call):<br />
<br />
BOOL Read<font style="color:green"><TagFormat></font>Tag( LPTSTR lpstrFileFullPath, METATAG * pMetaTag )<br />
<br />
BOOL Write<font style="color:green"><TagFormat></font>Tag( LPTSTR lpstrFileFullPath, TAGITEM tagiChangedItem )<br />
<br />
<font style="color:green"><TagFormat></font> will be the name of the corresponding tag format (or tag type) : <br />
APE, Vorbis, MPEG4 for example. <br />
The complete function names will be search by WMPTSE during the load process. <br />
<br />
<br />
The boolean return value is important.<br />
<br />
For the read function, it tells WMPTSE if the "tag support dll" has find the correct tag format structures <br />
(even if they are empty). <br />
If the value is TRUE, WMPTSE will stop searching for compatible tag format for this file (yes, a file can be multi-tagged). <br />
If the value is FALSE, WMPTSE will continue searching in its compatible tag format list.<br />
<br />
For the write function, it tells WMPTSE if the "tag support dll" has correctly write the new value. <br />
If this is true, WMPTSE will continue using this "tag support dll" for this filetype. <br />
If this value is false, WMPTSE may unload the "tag support dll".<br />
<br />
<br />
These function types are defined as FP_TAGREAD (read), FP_TAGWRITE (write) in "WMPTSE.h".<br />
<br />
==Definition==<br />
'''Note''' : All types and definition are declared in WMPTSE.h.<br />
It is simplier for developper to include it at first.<br />
<br />
For reading purpose, we will expose the necessary structure definition here.<br />
<br />
struct stTagItem <br />
{<br />
char * MetaTagWMPKey; /** the MediaLibrary attribute's name */<br />
LPTSTR MetaTagValue; /** the value to set */<br />
};<br />
#define TAGITEM struct stTagItem <br />
typedef struct stTagItem * LPTAGITEM; <br />
<br />
struct stMetaTag<br />
{<br />
UINT uiNbItems; /** number of list tags */<br />
LPTAGITEM tagiItems; /** pointer to array of pointer to tag items */<br />
};<br />
#define METATAG struct stMetaTag<br />
typedef struct stMetaTag * LPMETATAG;<br />
<br />
==Example Source Code==<br />
In this example, we will add support for a weird tag format : the "Sting fan" format.<br />
In fact, every file considered tagged with this format will return "Sting" as Album Artist. <br />
The sign of a true fan :)<br />
<br />
<br />
'''Note''' : We will not create the write function as it is a "read only" tag format.<br />
<br />
<br />
Let's see the documented code :<br />
<br />
/////////////////////////////////////////////////////////////////////////////<br />
//<br />
// StingTagSupport.c : <br />
// Handler for Sting tags support<br />
//<br />
// Copyxxx (\C) 200x - <br />
// <br />
/////////////////////////////////////////////////////////////////////////////<br />
#define STING_TAGSUPPORT_C<br />
#include "StingTagSupport.h"<br />
#undef STING_TAGSUPPORT_C<br />
<br />
<br />
BOOL STINGTAG_API ReadStingTag<br />
( <br />
LPTSTR lpstrFileFullPath, <br />
METATAG * pMetaTag <br />
) <br />
{<br />
UINT uiFilePathSize;<br />
LPSTR lpcFileFullPath;<br />
LPVOID lpvTempPtr;<br />
<br />
//First we get the filepath length before retrieving it<br />
uiFilePathSize = WideCharToMultiByte<br />
(<br />
CP_ACP,<br />
0,<br />
lpstrFileFullPath,<br />
-1,<br />
NULL,<br />
0,<br />
NULL,<br />
NULL<br />
);<br />
//then we alloc on the process Heap the memory<br />
lpcFileFullPath = ( LPSTR ) HeapAlloc<br />
(<br />
GetProcessHeap(), <br />
HEAP_ZERO_MEMORY,<br />
uiFilePathSize<br />
);<br />
//and we retrieve the filepath<br />
WideCharToMultiByte<br />
(<br />
CP_ACP,<br />
0,<br />
lpstrFileFullPath,<br />
-1,<br />
lpcFileFullPath,<br />
uiFilePathSize,<br />
NULL,<br />
NULL<br />
); <br />
<br />
//now, we fill the MetaTag structure with start values<br />
//at start we don't have any Tags..<br />
pMetaTag->uiNbItems = 0;<br />
//at start we need to have a "root" TAGITEM table so we alloc it<br />
pMetaTag->tagiItems = ( LPTAGITEM )HeapAlloc<br />
( <br />
GetProcessHeap(), <br />
HEAP_ZERO_MEMORY, <br />
sizeof( TAGITEM )<br />
);<br />
<br />
//We will handles just Album Artist (it should be enough for an example)<br />
//first we resize our previous TAGITEM table<br />
lpvTempPtr = ( LPTAGITEM )HeapReAlloc<br />
( <br />
GetProcessHeap(), <br />
HEAP_ZERO_MEMORY, <br />
pMetaTag->tagiItems,<br />
sizeof( TAGITEM ) * ( pMetaTag->uiNbItems + 1 )<br />
);<br />
if( lpvTempPtr == NULL )<br />
// we handle a worse case scenario<br />
return FALSE;<br />
<br />
//we replace with the new pointer (if it has changed)<br />
pMetaTag->tagiItems = lpvTempPtr;<br />
<br />
//we alloc the new string to store our tag value<br />
//it will be freed by WMPTSE, so be sure to have it alloced yourself.<br />
//(no static string...)<br />
pMetaTag->tagiItems[ pMetaTag->uiNbItems ].MetaTagValue = HeapAlloc<br />
(<br />
GetProcessHeap(),<br />
HEAP_ZERO_MEMORY,<br />
sizeof( TCHAR ) * ( lstrlen( STING_FAN_ARTIST ) + 1 )<br />
);<br />
//we copy the tag value<br />
lstrcpy( pMetaTag->tagiItems[ pMetaTag->uiNbItems ].MetaTagValue, STING_FAN_ARTIST );<br />
//we give WMPTSE the right tag Key (it must be a WMP_TAG_ string, see WMPTSE.h)<br />
pMetaTag->tagiItems[ pMetaTag->uiNbItems ].MetaTagWMPKey = WMP_TAG_ALBUMARTIST;<br />
//we increase our tagitem number<br />
pMetaTag->uiNbItems++;<br />
<br />
<br />
//all is finished, we can release the filepath string <br />
HeapFree( GetProcessHeap(), 0, lpcFileFullPath );<br />
<br />
return TRUE;<br />
}<br />
<br />
BOOL STINGTAG_API WriteStingTag<br />
( <br />
LPTSTR lpstrFileFullPath, <br />
TAGITEM tagiChangedItem <br />
)<br />
{<br />
return TRUE;<br />
}<br />
<br />
And the nice header to go with it<br />
<br />
/////////////////////////////////////////////////////////////////////////////<br />
//<br />
// StingTagSupport.h : <br />
// Handler header for Sting tags support<br />
//<br />
// Copyxxx (\C) 200x - <br />
// <br />
/////////////////////////////////////////////////////////////////////////////<br />
#ifndef STING_TAG_SUPPORT_H<br />
#define STING_TAG_SUPPORT_H<br />
<br />
<br />
#define WIN32_LEAN_AND_MEAN<br />
#define UNICODE<br />
#include <windows.h><br />
<br />
#include "WMPTSE.h"<br />
<br />
#ifdef STING_TAGSUPPORT_C<br />
<br />
<br />
#define STING_FAN_ARTIST TCHAR( "Sting" )<br />
<br />
<br />
#ifdef _USRDLL<br />
#define STINGTAG_API __declspec( dllexport )<br />
#else<br />
#define STINGTAG_API <br />
#endif<br />
<br />
#else<br />
<br />
#ifdef _USRDLL<br />
#define STINGTAG_API extern __declspec( dllimport )<br />
#elif defined( _EXPORTDLL )<br />
#define STINGTAG_API extern __declspec( dllexport )<br />
#else<br />
#define STINGTAG_API extern<br />
#endif<br />
<br />
#endif <br />
<br />
<br />
//<br />
// TODO : add your exportable function declaration here<br />
//<br />
// WMPTSE TagSupport API<br />
BOOL STINGTAG_API ReadStingTag<br />
( <br />
LPTSTR lpstrFileFullPath, <br />
METATAG * pMetaTag <br />
);<br />
<br />
BOOL STINGTAG_API WriteStingTag<br />
( <br />
LPTSTR lpstrFileFullPath, <br />
TAGITEM tagiChangedItem <br />
);<br />
<br />
<br />
#endif STING_TAG_SUPPORT_H<br />
<br />
==Installation==<br />
To be effective, a "tag support dll" must be correctly installed in WMPTSE.<br />
<br />
You have two choice to install a "tag support dll" :<br />
* use the WMPTSE tag support wizard (see [[WMPTSE - How to add support for a tag format]])<br />
* edit the registry yourself :<br />
<br />
<br />
'''Note''' : In this guide, we will not expose the registry editing for complete file type support in Windows (MIME Types, Media Library Support, etc...). Please refer to Microsoft Windows Media Player documentation for this.<br />
<br />
<br />
On load, [[WMPTSE]] browse the '''HKEY_LOCAL_MACHINE\SOFTWARE\piPOol\WMPTSE''' registry key.<br />
<br />
Each subkey it finds will be consider a <font style="color:green"><TagFormat></font> definition.<br />
<br />
Inside each subkey (or <font style="color:green"><TagFormat></font> definition), WMPTSE browse for file type support.<br />
<br />
Each string in '''HKEY_LOCAL_MACHINE\SOFTWARE\piPOol\WMPTSE\<font style="color:green"><TagFormat></font>''' describe the file type to support (registry string name) and the path to the "tag support dll" to load (registry string value).<br />
<br />
After reading all file types definitions, [[WMPTSE]] loads each "tag support dll" and try to get the '''Read<font style="color:green"><TagFormat></font>Tag''' and '''Write<font style="color:green"><TagFormat></font>Tag''' functions.<br />
<br />
For each dll, If one of those two functions doesn't exist, the dll is considered non-WMPTSE API compatible and is unloaded.<br />
<br />
It those two functions exist, the dll is registered as a "tag support dll" for the registered file type.<br />
<br />
[[Category:Technical]]<br />
[[Category:Software]]</div>MaB frhttps://wiki.hydrogenaud.io/index.php?title=WMPTSE_APIWMPTSE API2006-11-25T15:48:55Z<p>MaB fr: </p>
<hr />
<div>The WMPTSE API is the interface between the [[WMPTSE]] plug-in and its "tag support dll".<br />
<br />
A '''tag support dll''' give WMPTSE the ability to add support of a tag format in Windows Media Player. <br />
With the this "tag support dll" properly installed, files tagged with its format are readable inside WMP.<br />
<br />
<br />
==API==<br />
Every WMPTSE API application must export two function (c standard call):<br />
<br />
BOOL Read<font style="color:green"><TagFormat></font>Tag( LPTSTR lpstrFileFullPath, METATAG * pMetaTag )<br />
<br />
BOOL Write<font style="color:green"><TagFormat></font>Tag( LPTSTR lpstrFileFullPath, TAGITEM tagiChangedItem )<br />
<br />
<font style="color:green"><TagFormat></font> will be the name of the corresponding tag format (or tag type) : <br />
APE, Vorbis, MPEG4 for example. <br />
The complete function names will be search by WMPTSE during the load process. <br />
<br />
<br />
The boolean return value is important.<br />
<br />
For the read function, it tells WMPTSE if the "tag support dll" has find the correct tag format structures <br />
(even if they are empty). <br />
If the value is TRUE, WMPTSE will stop searching for compatible tag format for this file (yes, a file can be multi-tagged). <br />
If the value is FALSE, WMPTSE will continue searching in its compatible tag format list.<br />
<br />
For the write function, it tells WMPTSE if the "tag support dll" has correctly write the new value. <br />
If this is true, WMPTSE will continue using this "tag support dll" for this filetype. <br />
If this value is false, WMPTSE may unload the "tag support dll".<br />
<br />
<br />
These function types are defined as FP_TAGREAD (read), FP_TAGWRITE (write) in "WMPTSE.h".<br />
<br />
==Definition==<br />
'''Note''' : All types and definition are declared in WMPTSE.h.<br />
It is simple for developper to include it at first.<br />
<br />
For reading purpose, we will expose the necessary structure definition here.<br />
<br />
struct stTagItem <br />
{<br />
char * MetaTagWMPKey; /** the MediaLibrary attribute's name */<br />
LPTSTR MetaTagValue; /** the value to set */<br />
};<br />
#define TAGITEM struct stTagItem <br />
typedef struct stTagItem * LPTAGITEM; <br />
<br />
struct stMetaTag<br />
{<br />
UINT uiNbItems; /** number of list tags */<br />
LPTAGITEM tagiItems; /** pointer to array of pointer to tag items */<br />
};<br />
#define METATAG struct stMetaTag<br />
typedef struct stMetaTag * LPMETATAG;<br />
<br />
<br />
==Example Source Code==<br />
In this example, we will add support for a weird tag format : the "Sting fan" format.<br />
In fact, every file considered tagged with this format will return "Sting" as Album Artist. <br />
The sign of a true fan :)<br />
<br />
<br />
'''Note''' : We will not create the write function as it is a "read only" tag format.<br />
<br />
<br />
Let's see the documented code :<br />
<br />
/////////////////////////////////////////////////////////////////////////////<br />
//<br />
// StingTagSupport.c : <br />
// Handler for Sting tags support<br />
//<br />
// Copyxxx (\C) 200x - <br />
// <br />
/////////////////////////////////////////////////////////////////////////////<br />
#define STING_TAGSUPPORT_C<br />
#include "StingTagSupport.h"<br />
#undef STING_TAGSUPPORT_C<br />
<br />
<br />
BOOL STINGTAG_API ReadStingTag<br />
( <br />
LPTSTR lpstrFileFullPath, <br />
METATAG * pMetaTag <br />
) <br />
{<br />
UINT uiFilePathSize;<br />
LPSTR lpcFileFullPath;<br />
LPVOID lpvTempPtr;<br />
<br />
//First we get the filepath length before retrieving it<br />
uiFilePathSize = WideCharToMultiByte<br />
(<br />
CP_ACP,<br />
0,<br />
lpstrFileFullPath,<br />
-1,<br />
NULL,<br />
0,<br />
NULL,<br />
NULL<br />
);<br />
//then we alloc on the process Heap the memory<br />
lpcFileFullPath = ( LPSTR ) HeapAlloc<br />
(<br />
GetProcessHeap(), <br />
HEAP_ZERO_MEMORY,<br />
uiFilePathSize<br />
);<br />
//and we retrieve the filepath<br />
WideCharToMultiByte<br />
(<br />
CP_ACP,<br />
0,<br />
lpstrFileFullPath,<br />
-1,<br />
lpcFileFullPath,<br />
uiFilePathSize,<br />
NULL,<br />
NULL<br />
); <br />
<br />
//now, we fill the MetaTag structure with start values<br />
//at start we don't have any Tags..<br />
pMetaTag->uiNbItems = 0;<br />
//at start we need to have a "root" TAGITEM table so we alloc it<br />
pMetaTag->tagiItems = ( LPTAGITEM )HeapAlloc<br />
( <br />
GetProcessHeap(), <br />
HEAP_ZERO_MEMORY, <br />
sizeof( TAGITEM )<br />
);<br />
<br />
//We will handles just Album Artist (it should be enough for an example)<br />
//first we resize our previous TAGITEM table<br />
lpvTempPtr = ( LPTAGITEM )HeapReAlloc<br />
( <br />
GetProcessHeap(), <br />
HEAP_ZERO_MEMORY, <br />
pMetaTag->tagiItems,<br />
sizeof( TAGITEM ) * ( pMetaTag->uiNbItems + 1 )<br />
);<br />
if( lpvTempPtr == NULL )<br />
// we handle a worse case scenario<br />
return FALSE;<br />
<br />
//we replace with the new pointer (if it has changed)<br />
pMetaTag->tagiItems = lpvTempPtr;<br />
<br />
//we alloc the new string to store our tag value<br />
//it will be freed by WMPTSE, so be sure to have it alloced yourself.<br />
//(no static string...)<br />
pMetaTag->tagiItems[ pMetaTag->uiNbItems ].MetaTagValue = HeapAlloc<br />
(<br />
GetProcessHeap(),<br />
HEAP_ZERO_MEMORY,<br />
sizeof( TCHAR ) * ( lstrlen( STING_FAN_ARTIST ) + 1 )<br />
);<br />
//we copy the tag value<br />
lstrcpy( pMetaTag->tagiItems[ pMetaTag->uiNbItems ].MetaTagValue, STING_FAN_ARTIST );<br />
//we give WMPTSE the right tag Key (it must be a WMP_TAG_ string, see WMPTSE.h)<br />
pMetaTag->tagiItems[ pMetaTag->uiNbItems ].MetaTagWMPKey = WMP_TAG_ALBUMARTIST;<br />
//we increase our tagitem number<br />
pMetaTag->uiNbItems++;<br />
<br />
<br />
//all is finished, we can release the filepath string <br />
HeapFree( GetProcessHeap(), 0, lpcFileFullPath );<br />
<br />
return TRUE;<br />
}<br />
<br />
BOOL STINGTAG_API WriteStingTag<br />
( <br />
LPTSTR lpstrFileFullPath, <br />
TAGITEM tagiChangedItem <br />
)<br />
{<br />
return TRUE;<br />
}<br />
<br />
And the nice header to go with it<br />
<br />
/////////////////////////////////////////////////////////////////////////////<br />
//<br />
// StingTagSupport.h : <br />
// Handler header for Sting tags support<br />
//<br />
// Copyxxx (\C) 200x - <br />
// <br />
/////////////////////////////////////////////////////////////////////////////<br />
#ifndef STING_TAG_SUPPORT_H<br />
#define STING_TAG_SUPPORT_H<br />
<br />
<br />
#define WIN32_LEAN_AND_MEAN<br />
#define UNICODE<br />
#include <windows.h><br />
<br />
#include "WMPTSE.h"<br />
<br />
#ifdef STING_TAGSUPPORT_C<br />
<br />
<br />
#define STING_FAN_ARTIST TCHAR( "Sting" )<br />
<br />
<br />
#ifdef _USRDLL<br />
#define STINGTAG_API __declspec( dllexport )<br />
#else<br />
#define STINGTAG_API <br />
#endif<br />
<br />
#else<br />
<br />
#ifdef _USRDLL<br />
#define STINGTAG_API extern __declspec( dllimport )<br />
#elif defined( _EXPORTDLL )<br />
#define STINGTAG_API extern __declspec( dllexport )<br />
#else<br />
#define STINGTAG_API extern<br />
#endif<br />
<br />
#endif <br />
<br />
<br />
//<br />
// TODO : add your exportable function declaration here<br />
//<br />
// WMPTSE TagSupport API<br />
BOOL STINGTAG_API ReadStingTag<br />
( <br />
LPTSTR lpstrFileFullPath, <br />
METATAG * pMetaTag <br />
);<br />
<br />
BOOL STINGTAG_API WriteStingTag<br />
( <br />
LPTSTR lpstrFileFullPath, <br />
TAGITEM tagiChangedItem <br />
);<br />
<br />
<br />
#endif STING_TAG_SUPPORT_H<br />
<br />
==Installation==<br />
To be effective, a "tag support dll" must be correctly installed in WMPTSE.<br />
<br />
You have two choice to install a "tag support dll" :<br />
* use the WMPTSE tag support wizard (see [[WMPTSE - How to add support for a tag format]])<br />
* edit the registry yourself :<br />
<br />
<br />
'''Note''' : In this guide, we will not expose the registry editing for complete file type support in Windows (MIME Types, Media Library Support, etc...). Please refer to Microsoft Windows Media Player documentation for this.<br />
<br />
<br />
On load, [[WMPTSE]] browse the '''HKEY_LOCAL_MACHINE\SOFTWARE\piPOol\WMPTSE''' registry key.<br />
<br />
Each subkey it finds will be consider a <font style="color:green"><TagFormat></font> definition.<br />
<br />
Inside each subkey (or <font style="color:green"><TagFormat></font> definition), WMPTSE browse for file type support.<br />
<br />
Each string in '''HKEY_LOCAL_MACHINE\SOFTWARE\piPOol\WMPTSE\<font style="color:green"><TagFormat></font>''' describe the file type to support (registry string name) and the path to the "tag support dll" to load (registry string value).<br />
<br />
After reading all file types definitions, [[WMPTSE]] loads each "tag support dll" and try to get the '''Read<font style="color:green"><TagFormat></font>Tag''' and '''Write<font style="color:green"><TagFormat></font>Tag''' functions.<br />
<br />
For each dll, If one of those two functions doesn't exist, the dll is considered non-WMPTSE API compatible and is unloaded.<br />
<br />
It those two functions exist, the dll is registered as a "tag support dll" for the registered file type.<br />
<br />
[[Category:Technical]]<br />
[[Category:Software]]</div>MaB frhttps://wiki.hydrogenaud.io/index.php?title=WMP_Tag_Support_ExtenderWMP Tag Support Extender2006-11-25T15:46:39Z<p>MaB fr: </p>
<hr />
<div>{{Software Infobox<br />
| name = Windows Media Player Tag Support Extender<br />
| screenshot = [http://wmptagext.sourceforge.net/screenshots.html Screenshot]<br />
| caption = WMP plug-in extending tag capabilities<br />
| maintainer = MaB_fr <br />
| stable_release = 1.1.1 <br />
| preview_release = none <br />
| operating_system = Windows<br />
| use = WMP plug-in<br />
| license = Public domain + source<br />
| website = [http://http://wmptagext.sourceforge.net/ http://wmptagext.sourceforge.net]<br />
}}<br />
<br />
<br />
'''Windows Media Player Tag Support Extender''' (WMPTSE) is a plug-in to [[Windows Media Player]] to allow more [[tags]] support than the default [[WMA]] + [[ID3]] within the player.<br />
<br />
It supports version 9.x, 10.x and 11.0 of [[Windows Media Player]].<br />
<br />
The current version (1.1.1) supports [[Vorbis comment]], [[APEv2]] and [[FLAC]] and [[MPEG4]].<br />
<br />
<br />
<br />
==Supported Tag Format==<br />
* [[FLAC]]<br />
* [[APE]]<br />
* [[Vorbis comment]] - READ-ONLY<br />
* [[MPEG4]] - READ-ONLY<br />
<br />
Additional tagging formats may be supported through a plug-in API (known as [[WMPTSE API]])<br />
<br />
<br />
==Supported Filetypes==<br />
* [[FLAC]] - Free Lossless Audio Codec(*.flac)<br />
* [[APE]] - Monkey's Audio (*.ape)<br />
* [[MPC]] - MusePack (*.mpc)<br />
* [[WavPack]] (*.wv)<br />
* [[OptimFROG]] (*.ofr)<br />
* [[Ogg Vorbis]] - Ogg files (*.ogg) - READ-ONLY<br />
* [[AAC]] - Advanced Audio Coding (*.aac) - READ-ONLY<br />
* [[M4A]],[[MP4]] - MPEG4 Audio (*.m4a) - READ-ONLY<br />
<br />
<br />
==Extensibility==<br />
WMPTSE provide options to add tagging based on file extension.<br />
<br />
It allows tagging in files who usually don't support it, such as exotic (but useful) tagging of [[AC3]], [[DTS]] and [[LPCM]] files, or less useful like .txt, JPEG file tagging and more.<br />
<br />
Tag support is pluggable. Each "tag support dll" responding to the [[WMPTSE API]].<br />
<br />
<br />
==Guide & Howtos==<br />
<br />
[[WMPTSE - How to change the plug-in properties]]<br />
<br />
[[WMPTSE - How to add support for a filetype]]<br />
<br />
[http://www.losslessaudioblog.com/wmpmce-lossless-guide/ The complete Media Center + WMPTSE guide] (from [http://www.losslessaudioblog.com/ LosslessAudioBlog])<br />
<br />
[[WMPTSE - How to add support for a tag format]]<br />
<br />
<br />
==Price==<br />
The sofware is free.<br />
<br />
<br />
==External links==<br />
* [http://wmptagext.sourceforge.net/ WMPTSE homepage]<br />
* [http://wmptagext.sourceforge.net/download.html WMPTSE download page]<br />
* [http://www.hydrogenaudio.org/forums/index.php?s=e03ece01d79f55a3f390268762345f0f&showtopic=38400&st=275 HydrogenAudio thread]<br />
<br />
<br />
[[Category:Software]]<br />
[[Category:Media Players]]</div>MaB frhttps://wiki.hydrogenaud.io/index.php?title=WMP_Tag_Support_ExtenderWMP Tag Support Extender2006-11-25T15:45:22Z<p>MaB fr: /* Supported Filetypes */</p>
<hr />
<div>{{Software Infobox<br />
| name = Windows Media Player Tag Support Extender<br />
| screenshot = [http://wmptagext.sourceforge.net/screenshots.html Screenshot]<br />
| caption = WMP plug-in extending tag capabilities<br />
| maintainer = MaB_fr <br />
| stable_release = 1.1.1 <br />
| preview_release = none <br />
| operating_system = Windows<br />
| use = WMP plug-in<br />
| license = Public domain + source<br />
| website = [http://http://wmptagext.sourceforge.net/ http://wmptagext.sourceforge.net]<br />
}}<br />
<br />
<br />
'''Windows Media Player Tag Support Extender''' (WMPTSE) is a plug-in to [[Windows Media Player]] to allow more [[tags]] support than the default [[WMA]] + [[ID3]] within the player.<br />
<br />
It supports version 9.x, 10.x and 11.0 of [[Windows Media Player]].<br />
<br />
The current version (1.1.1) supports [[Vorbis comment]], [[APEv2]] and [[FLAC]] and [[MPEG4]].<br />
<br />
<br />
<br />
==Supported Tag Format==<br />
* [[FLAC]]<br />
* [[APE]]<br />
* [[Vorbis comment]] - READ-ONLY<br />
* [[MPEG4]] - READ-ONLY<br />
<br />
Additional tagging formats may be supported through a plug-in API (known as [[WMPTSE API]])<br />
<br />
==Supported Filetypes==<br />
* [[FLAC]] - Free Lossless Audio Codec(*.flac)<br />
* [[APE]] - Monkey's Audio (*.ape)<br />
* [[MPC]] - MusePack (*.mpc)<br />
* [[WavPack]] (*.wv)<br />
* [[OptimFROG]] (*.ofr)<br />
* [[Ogg Vorbis]] - Ogg files (*.ogg) - READ-ONLY<br />
* [[AAC]] - Advanced Audio Coding (*.aac) - READ-ONLY<br />
* [[M4A]],[[MP4]] - MPEG4 Audio (*.m4a) - READ-ONLY<br />
<br />
==Extensibility==<br />
WMPTSE provide options to add tagging based on file extension.<br />
<br />
It allows tagging in files who usually don't support it, such as exotic (but useful) tagging of [[AC3]], [[DTS]] and [[LPCM]] files, or less useful like .txt, JPEG file tagging and more.<br />
<br />
Tag support is pluggable. Each "tag support dll" responding to the [[WMPTSE API]].<br />
<br />
==Guide & Howtos==<br />
<br />
[[WMPTSE - How to change the plug-in properties]]<br />
<br />
[[WMPTSE - How to add support for a filetype]]<br />
<br />
[http://www.losslessaudioblog.com/wmpmce-lossless-guide/ The complete Media Center + WMPTSE guide] (from [http://www.losslessaudioblog.com/ LosslessAudioBlog])<br />
<br />
[[WMPTSE - How to add support for a tag format]]<br />
<br />
<br />
<br />
==Price==<br />
The sofware is free.<br />
<br />
<br />
==External links==<br />
* [http://wmptagext.sourceforge.net/ WMPTSE homepage]<br />
* [http://wmptagext.sourceforge.net/download.html WMPTSE download page]<br />
* [http://www.hydrogenaudio.org/forums/index.php?s=e03ece01d79f55a3f390268762345f0f&showtopic=38400&st=275 HydrogenAudio thread]<br />
<br />
[[Category:Software]]<br />
[[Category:Media Players]]</div>MaB frhttps://wiki.hydrogenaud.io/index.php?title=WMPTSE_-_How_to_add_support_for_a_tag_formatWMPTSE - How to add support for a tag format2006-11-25T15:43:34Z<p>MaB fr: </p>
<hr />
<div>==Software Needed==<br />
* [http://www.microsoft.com/windows/windowsmedia/default.mspx Windows Media Player >v9.0]<br />
* [[WMPTSE]]<br />
<br />
<br />
<br />
==Installation==<br />
'''Note:''' <br />
* This guide assumes that you have already downloaded and installed Windows Media Player and WMPTSE.<br />
<br />
* This guide pictures are taken from WMP v9.0 but are valid for newer version.<br />
<br />
* In this guide, we will be adding an 'Sting tag format' tagging to our MediaLibrary .pnge files (supposedly png file extension modified).<br />
<br />
<br />
<br />
==Configuration==<br />
<br />
* Launch Windows Media Player.<br />
<br />
* Display the WMPTSE property box (see [[WMPTSE - How to change the plug-in properties]])<br />
<br />
<br />
* Click '''Add Support''' button, the "Add Tag support" propery page is displayed :<br />
<center>[[Image:WMPTSE2_ET1.png]]</center><br />
<br />
<br />
* Push the button '''Add a tagtype'''<br />
<center>[[Image:WMPTSE3_ET1.png]]</center><br />
<br />
<br />
* In the text field, type the tag type name (here, '''Sting''')<br />
<center>[[Image:WMPTSE3_ET2.png]]</center><br />
<br />
<br />
* Push the '''OK''' button to confirm<br />
<center>[[Image:WMPTSE3_ET3.png]]</center><br />
<br />
<br />
* Now, our new 'Sting' format is showed on the tag type list<br />
<center>[[Image:WMPTSE3_ET4.png]]</center><br />
<br />
<br />
* We just have to select it<br />
<center>[[Image:WMPTSE3_ET5.png]]</center><br />
<br />
* And continue with filetype support addition <br />
(see - [[WMPTSE - How to add support for a filetype]] except the tag type is 'Sting' not 'APE')<br />
<br />
<br />
<br />
==Addtional Reading==<br />
* [[WMPTSE]]<br />
* [[WMPTSE - How to change the plug-in properties]]<br />
* [[WMPTSE - How to add support for a filetype]] <br />
<br />
<br />
[[Category:Guides]]<br />
[[Category:WMPTSE Guides]]</div>MaB frhttps://wiki.hydrogenaud.io/index.php?title=WMPTSE_-_How_to_add_support_for_a_tag_formatWMPTSE - How to add support for a tag format2006-11-25T15:42:28Z<p>MaB fr: /* Configuration */</p>
<hr />
<div>==Software Needed==<br />
* [http://www.microsoft.com/windows/windowsmedia/default.mspx Windows Media Player >v9.0]<br />
* [[WMPTSE]]<br />
<br />
<br />
<br />
==Installation==<br />
'''Note:''' <br />
* This guide assumes that you have already downloaded and installed Windows Media Player and WMPTSE.<br />
<br />
* This guide pictures are taken from WMP v9.0 but are valid for newer version.<br />
<br />
* In this guide, we will be adding an 'Sting tag format' tagging to our MediaLibrary .pnge files (supposedly png file extension modified).<br />
<br />
<br />
<br />
==Configuration==<br />
<br />
* Launch Windows Media Player.<br />
<br />
* Display the WMPTSE property box (see [[WMPTSE - How to change the plug-in properties]])<br />
<br />
<br />
* Click '''Add Support''' button, the "Add Tag support" propery page is displayed :<br />
<center>[[Image:WMPTSE2_ET1.png]]</center><br />
<br />
<br />
* Push the button '''Add a tagtype'''<br />
<center>[[Image:WMPTSE3_ET1.png]]</center><br />
<br />
<br />
* In the text field, type the tag type name (here, '''Sting''')<br />
<center>[[Image:WMPTSE3_ET2.png]]</center><br />
<br />
<br />
* Push the '''OK''' button to confirm<br />
<center>[[Image:WMPTSE3_ET3.png]]</center><br />
<br />
<br />
* Now, our new 'Sting' format is showed on the tag type list<br />
<center>[[Image:WMPTSE3_ET4.png]]</center><br />
<br />
<br />
* We just have to select it<br />
<center>[[Image:WMPTSE3_ET5.png]]</center><br />
<br />
* And continue with filetype support addition (see - [[WMPTSE - How to add support for a filetype]])<br />
<br />
==Addtional Reading==<br />
* [[WMPTSE]]<br />
* [[WMPTSE - How to change the plug-in properties]]<br />
<br />
<br />
<br />
[[Category:Guides]]<br />
[[Category:WMPTSE Guides]]</div>MaB frhttps://wiki.hydrogenaud.io/index.php?title=WMPTSE_-_How_to_add_support_for_a_tag_formatWMPTSE - How to add support for a tag format2006-11-25T15:41:40Z<p>MaB fr: /* Configuration */</p>
<hr />
<div>==Software Needed==<br />
* [http://www.microsoft.com/windows/windowsmedia/default.mspx Windows Media Player >v9.0]<br />
* [[WMPTSE]]<br />
<br />
<br />
<br />
==Installation==<br />
'''Note:''' <br />
* This guide assumes that you have already downloaded and installed Windows Media Player and WMPTSE.<br />
<br />
* This guide pictures are taken from WMP v9.0 but are valid for newer version.<br />
<br />
* In this guide, we will be adding an 'Sting tag format' tagging to our MediaLibrary .pnge files (supposedly png file extension modified).<br />
<br />
<br />
<br />
==Configuration==<br />
<br />
* Launch Windows Media Player.<br />
<br />
* Display the WMPTSE property box (see [[WMPTSE - How to change the plug-in properties]])<br />
<br />
<br />
* Click '''Add Support''' button, the "Add Tag support" propery page is displayed :<br />
<center>[[Image:WMPTSE2_ET1.png]]</center><br />
<br />
<br />
* Push the button '''Add a tagtype'''<br />
<center>[[Image:WMPTSE3_ET1.png]]</center><br />
<br />
<br />
* In the text field, type the tag type name (here, '''Sting''')<br />
<center>[[Image:WMPTSE3_ET2.png]]</center><br />
<br />
<br />
* Push the '''OK''' button to confirm<br />
<center>[[Image:WMPTSE3_ET3.png]]</center><br />
<br />
<br />
* Now, our new 'Sting' format is showed on the tag type list<br />
<center>[[Image:WMPTSE3_ET4.png]]</center><br />
<br />
<br />
* We just have to select it<br />
<center>[[Image:WMPTSE3_ET5.png]]</center><br />
<br />
* And continue with filetype support addition (see - )<br />
<br />
==Addtional Reading==<br />
* [[WMPTSE]]<br />
* [[WMPTSE - How to change the plug-in properties]]<br />
<br />
<br />
<br />
[[Category:Guides]]<br />
[[Category:WMPTSE Guides]]</div>MaB frhttps://wiki.hydrogenaud.io/index.php?title=WMPTSE_-_How_to_add_support_for_a_tag_formatWMPTSE - How to add support for a tag format2006-11-25T15:41:00Z<p>MaB fr: </p>
<hr />
<div>==Software Needed==<br />
* [http://www.microsoft.com/windows/windowsmedia/default.mspx Windows Media Player >v9.0]<br />
* [[WMPTSE]]<br />
<br />
<br />
<br />
==Installation==<br />
'''Note:''' <br />
* This guide assumes that you have already downloaded and installed Windows Media Player and WMPTSE.<br />
<br />
* This guide pictures are taken from WMP v9.0 but are valid for newer version.<br />
<br />
* In this guide, we will be adding an 'Sting tag format' tagging to our MediaLibrary .pnge files (supposedly png file extension modified).<br />
<br />
<br />
<br />
==Configuration==<br />
<br />
* Launch Windows Media Player.<br />
<br />
* Display the WMPTSE property box (see [[WMPTSE - How to change the plug-in properties]])<br />
<br />
<br />
* Click '''Add Support''' button, the "Add Tag support" propery page is displayed :<br />
<center>[[Image:WMPTSE2_ET1.png]]</center><br />
<br />
<br />
* Push the button '''Add a tagtype'''<br />
<center>[[Image:WMPTSE3_ET1.png]]</center><br />
<br />
<br />
* In the text field, type the tag type name (here, '''Sting''')<br />
<center>[[Image:WMPTSE2_ET2.png]]</center><br />
<br />
<br />
* Push the '''OK''' button to confirm<br />
<center>[[Image:WMPTSE2_ET3.png]]</center><br />
<br />
<br />
* Now, our new 'Sting' format is showed on the tag type list<br />
<center>[[Image:WMPTSE2_ET4.png]]</center><br />
<br />
<br />
* We just have to select it<br />
<center>[[Image:WMPTSE2_ET5.png]]</center><br />
<br />
* And continue with filetype support addition (see - )<br />
<br />
<br />
<br />
==Addtional Reading==<br />
* [[WMPTSE]]<br />
* [[WMPTSE - How to change the plug-in properties]]<br />
<br />
<br />
<br />
[[Category:Guides]]<br />
[[Category:WMPTSE Guides]]</div>MaB frhttps://wiki.hydrogenaud.io/index.php?title=File:WMPTSE3_ET5.pngFile:WMPTSE3 ET5.png2006-11-25T15:39:45Z<p>MaB fr: WMPTSE, adding support for a filetype with 'Sting' format</p>
<hr />
<div>[[WMPTSE]], adding support for a filetype with 'Sting' format</div>MaB frhttps://wiki.hydrogenaud.io/index.php?title=File:WMPTSE3_ET4.pngFile:WMPTSE3 ET4.png2006-11-25T15:37:54Z<p>MaB fr: WMPTSE, the list of tag format, displaying our new 'Sting' tag type</p>
<hr />
<div>[[WMPTSE]], the list of tag format, displaying our new 'Sting' tag type</div>MaB frhttps://wiki.hydrogenaud.io/index.php?title=File:WMPTSE3_ET3.pngFile:WMPTSE3 ET3.png2006-11-25T15:37:20Z<p>MaB fr: WMPTSE, confirming the new tag type : 'Sting'</p>
<hr />
<div>[[WMPTSE]], confirming the new tag type : 'Sting'</div>MaB frhttps://wiki.hydrogenaud.io/index.php?title=File:WMPTSE3_ET2.pngFile:WMPTSE3 ET2.png2006-11-25T15:36:46Z<p>MaB fr: WMPTSE adding a 'Sting' tag type</p>
<hr />
<div>[[WMPTSE]] adding a 'Sting' tag type</div>MaB frhttps://wiki.hydrogenaud.io/index.php?title=File:WMPTSE3_ET1.pngFile:WMPTSE3 ET1.png2006-11-25T15:36:08Z<p>MaB fr: WMPTSE adding a tag type</p>
<hr />
<div>[[WMPTSE]] adding a tag type</div>MaB frhttps://wiki.hydrogenaud.io/index.php?title=WMPTSE_-_How_to_add_support_for_a_filetypeWMPTSE - How to add support for a filetype2006-11-25T15:25:08Z<p>MaB fr: /* Installation */</p>
<hr />
<div>==Software Needed==<br />
* [http://www.microsoft.com/windows/windowsmedia/default.mspx Windows Media Player >v9.0]<br />
* [[WMPTSE]]<br />
<br />
<br />
<br />
==Installation==<br />
'''Note:''' <br />
* This guide assumes that you have already downloaded and installed Windows Media Player and WMPTSE.<br />
<br />
* This guide pictures are taken from WMP v9.0 but are valid for newer version.<br />
<br />
* In this guide, we will be adding an APEv2 tagging to our MediaLibrary .pnge files (supposedly png file with APE tag at the end).<br />
<br />
The pnge format being a container format, our tag binary data will not be interpreted by the pnge readers, saving us the trouble.<br />
<br />
But <font style="color:red">beware</font> if you add tagging support for non-container file types (.txt, .bin, .dat, etc...), you'll end up with a ''corrupted'' file.<br />
<br />
Because WMP v9 is very restrictive on the filetype you can add in Media Library, we made up the 'pnge' file format. But with WMP10 and WMP11 you should simply tag 'png' files ''to verify''<br />
<br />
==Configuration==<br />
<br />
* Launch Windows Media Player.<br />
<br />
* Display the WMPTSE property box (see [[WMPTSE - How to change the plug-in properties]])<br />
<br />
<br />
* Click '''Add Support''' button, the "Add Tag support" propery page is displayed :<br />
<center>[[Image:WMPTSE2_ET1.png]]</center><br />
<br />
<br />
* Choose the tag type to add in the list (here we choose '''APE''')<br />
<center>[[Image:WMPTSE2_ET2.png]]</center><br />
<br />
<br />
* Type filetype (just the extension) to add support to (here we type '''png''')<br />
<center>[[Image:WMPTSE2_ET3.png]]</center><br />
<br />
<br />
* We want to be sure that WMP will support our filetype, so we click on '''Check support'''<br />
If the filetype is not already supported by the Media Library, WMPTSE ask to confirm adding it<br />
<center>[[Image:WMPTSE2_ET4.png]]</center><br />
<br />
If the filetype is not available for normal user, WMPTSE ask to confirm adding support for normal users <br />
<center>[[Image:WMPTSE2_ET5.png]]</center><br />
<br />
<br />
* After agreeing to reboot WMP, click on the '''...''' button, at the end of the 'Tag Support DLL file path' line<br />
<center>[[Image:WMPTSE2_ET6.png]]</center><br />
<br />
<br />
* Now is an important part, you have to choose the tag support DLL to use. <br />
First, browse the directories where the tag support dll is stored. <br />
<center>[[Image:WMPTSE2_ET7.png]]</center><br />
<br />
Next, choose the right tag support dll and click '''open'''<br />
<center>[[Image:WMPTSE2_ET8.png]]</center><br />
<br />
By default, [[WMPTSE]] is distributed with support for APE (APETagSupport.dll), MPEG4 (MPEG4TagSupport.dll), <br />
FLAC (FLACTagSupport.dll) and Vorbis (VorbisTagSupport.dll).<br />
[[WMPTSE]] will only accept dll which support [[WMPTSE API]]. <br />
More preciselly, by choosing the tag type in the third step of this tutorial, you have fixed the tag support API <br />
function name WMPTSE will search. <br />
WMPTSE will alert you if the dll is not compatible with the tag support you choose.<br />
<br />
<br />
* You're now ready to add support for your new filetype, just click '''Add'''<br />
<center>[[Image:WMPTSE2_ET9.png]]</center><br />
<br />
<br />
* The filetype is displayed in the tag support list on the WMPTSE propery page<br />
<center>[[Image:WMPTSE2_ET10.png]]</center><br />
<br />
==Addtional Reading==<br />
* [[WMPTSE]]<br />
* [[WMPTSE - How to change the plug-in properties]]<br />
<br />
<br />
<br />
[[Category:Guides]]<br />
[[Category:WMPTSE Guides]]</div>MaB frhttps://wiki.hydrogenaud.io/index.php?title=WMPTSE_-_How_to_add_support_for_a_filetypeWMPTSE - How to add support for a filetype2006-11-25T15:24:08Z<p>MaB fr: /* Installation */</p>
<hr />
<div>==Software Needed==<br />
* [http://www.microsoft.com/windows/windowsmedia/default.mspx Windows Media Player >v9.0]<br />
* [[WMPTSE]]<br />
<br />
<br />
<br />
==Installation==<br />
'''Note:''' <br />
* This guide assumes that you have already downloaded and installed Windows Media Player and WMPTSE.<br />
<br />
* This guide pictures are taken from WMP v9.0 but are valid for newer version.<br />
<br />
* In this guide, we will be adding an APEv2 tagging to our MediaLibrary .pnge files (supposedly png file with APE tag at the end).<br />
<br />
The pnge format being a container format, our tag binary data will not be interpreted by the pnge readers, saving us the trouble.<br />
<br />
But <font style="color:red">beware</font> if you add tagging support for non-container file types (.txt, .bin, .dat, etc...), you'll end up with a ''corrupted'' file.<br />
<br />
Because WMP v9 is very restrictive on the filetype you can add in Media Library, we made up the 'pnge' file format. But with WMP10 and WMP11 you should simply tag 'png' files '''to verify'''<br />
<br />
==Configuration==<br />
<br />
* Launch Windows Media Player.<br />
<br />
* Display the WMPTSE property box (see [[WMPTSE - How to change the plug-in properties]])<br />
<br />
<br />
* Click '''Add Support''' button, the "Add Tag support" propery page is displayed :<br />
<center>[[Image:WMPTSE2_ET1.png]]</center><br />
<br />
<br />
* Choose the tag type to add in the list (here we choose '''APE''')<br />
<center>[[Image:WMPTSE2_ET2.png]]</center><br />
<br />
<br />
* Type filetype (just the extension) to add support to (here we type '''png''')<br />
<center>[[Image:WMPTSE2_ET3.png]]</center><br />
<br />
<br />
* We want to be sure that WMP will support our filetype, so we click on '''Check support'''<br />
If the filetype is not already supported by the Media Library, WMPTSE ask to confirm adding it<br />
<center>[[Image:WMPTSE2_ET4.png]]</center><br />
<br />
If the filetype is not available for normal user, WMPTSE ask to confirm adding support for normal users <br />
<center>[[Image:WMPTSE2_ET5.png]]</center><br />
<br />
<br />
* After agreeing to reboot WMP, click on the '''...''' button, at the end of the 'Tag Support DLL file path' line<br />
<center>[[Image:WMPTSE2_ET6.png]]</center><br />
<br />
<br />
* Now is an important part, you have to choose the tag support DLL to use. <br />
First, browse the directories where the tag support dll is stored. <br />
<center>[[Image:WMPTSE2_ET7.png]]</center><br />
<br />
Next, choose the right tag support dll and click '''open'''<br />
<center>[[Image:WMPTSE2_ET8.png]]</center><br />
<br />
By default, [[WMPTSE]] is distributed with support for APE (APETagSupport.dll), MPEG4 (MPEG4TagSupport.dll), <br />
FLAC (FLACTagSupport.dll) and Vorbis (VorbisTagSupport.dll).<br />
[[WMPTSE]] will only accept dll which support [[WMPTSE API]]. <br />
More preciselly, by choosing the tag type in the third step of this tutorial, you have fixed the tag support API <br />
function name WMPTSE will search. <br />
WMPTSE will alert you if the dll is not compatible with the tag support you choose.<br />
<br />
<br />
* You're now ready to add support for your new filetype, just click '''Add'''<br />
<center>[[Image:WMPTSE2_ET9.png]]</center><br />
<br />
<br />
* The filetype is displayed in the tag support list on the WMPTSE propery page<br />
<center>[[Image:WMPTSE2_ET10.png]]</center><br />
<br />
==Addtional Reading==<br />
* [[WMPTSE]]<br />
* [[WMPTSE - How to change the plug-in properties]]<br />
<br />
<br />
<br />
[[Category:Guides]]<br />
[[Category:WMPTSE Guides]]</div>MaB frhttps://wiki.hydrogenaud.io/index.php?title=WMPTSE_-_How_to_add_support_for_a_filetypeWMPTSE - How to add support for a filetype2006-11-25T15:22:13Z<p>MaB fr: /* Installation */</p>
<hr />
<div>==Software Needed==<br />
* [http://www.microsoft.com/windows/windowsmedia/default.mspx Windows Media Player >v9.0]<br />
* [[WMPTSE]]<br />
<br />
<br />
<br />
==Installation==<br />
'''Note:''' <br />
* This guide assumes that you have already downloaded and installed Windows Media Player and WMPTSE.<br />
<br />
* This guide pictures are taken from WMP v9.0 but are valid for newer version.<br />
<br />
* In this guide, we will be adding an APEv2 tagging to our MediaLibrary .pnge files (supposedly png file with APE tag at the end).<br />
<br />
The pnge format being a container format, our tag binary data will not be interpreted by the pnge readers, saving us the trouble.<br />
<br />
But <font style="color:red">beware</font> if you add tagging support for non-container file types (.txt, .bin, .dat, etc...), you'll end up with a ''corrupted'' file.<br />
<br />
==Configuration==<br />
<br />
* Launch Windows Media Player.<br />
<br />
* Display the WMPTSE property box (see [[WMPTSE - How to change the plug-in properties]])<br />
<br />
<br />
* Click '''Add Support''' button, the "Add Tag support" propery page is displayed :<br />
<center>[[Image:WMPTSE2_ET1.png]]</center><br />
<br />
<br />
* Choose the tag type to add in the list (here we choose '''APE''')<br />
<center>[[Image:WMPTSE2_ET2.png]]</center><br />
<br />
<br />
* Type filetype (just the extension) to add support to (here we type '''png''')<br />
<center>[[Image:WMPTSE2_ET3.png]]</center><br />
<br />
<br />
* We want to be sure that WMP will support our filetype, so we click on '''Check support'''<br />
If the filetype is not already supported by the Media Library, WMPTSE ask to confirm adding it<br />
<center>[[Image:WMPTSE2_ET4.png]]</center><br />
<br />
If the filetype is not available for normal user, WMPTSE ask to confirm adding support for normal users <br />
<center>[[Image:WMPTSE2_ET5.png]]</center><br />
<br />
<br />
* After agreeing to reboot WMP, click on the '''...''' button, at the end of the 'Tag Support DLL file path' line<br />
<center>[[Image:WMPTSE2_ET6.png]]</center><br />
<br />
<br />
* Now is an important part, you have to choose the tag support DLL to use. <br />
First, browse the directories where the tag support dll is stored. <br />
<center>[[Image:WMPTSE2_ET7.png]]</center><br />
<br />
Next, choose the right tag support dll and click '''open'''<br />
<center>[[Image:WMPTSE2_ET8.png]]</center><br />
<br />
By default, [[WMPTSE]] is distributed with support for APE (APETagSupport.dll), MPEG4 (MPEG4TagSupport.dll), <br />
FLAC (FLACTagSupport.dll) and Vorbis (VorbisTagSupport.dll).<br />
[[WMPTSE]] will only accept dll which support [[WMPTSE API]]. <br />
More preciselly, by choosing the tag type in the third step of this tutorial, you have fixed the tag support API <br />
function name WMPTSE will search. <br />
WMPTSE will alert you if the dll is not compatible with the tag support you choose.<br />
<br />
<br />
* You're now ready to add support for your new filetype, just click '''Add'''<br />
<center>[[Image:WMPTSE2_ET9.png]]</center><br />
<br />
<br />
* The filetype is displayed in the tag support list on the WMPTSE propery page<br />
<center>[[Image:WMPTSE2_ET10.png]]</center><br />
<br />
==Addtional Reading==<br />
* [[WMPTSE]]<br />
* [[WMPTSE - How to change the plug-in properties]]<br />
<br />
<br />
<br />
[[Category:Guides]]<br />
[[Category:WMPTSE Guides]]</div>MaB frhttps://wiki.hydrogenaud.io/index.php?title=WMPTSE_-_How_to_add_support_for_a_filetypeWMPTSE - How to add support for a filetype2006-11-25T15:20:58Z<p>MaB fr: /* Configuration */</p>
<hr />
<div>==Software Needed==<br />
* [http://www.microsoft.com/windows/windowsmedia/default.mspx Windows Media Player >v9.0]<br />
* [[WMPTSE]]<br />
<br />
<br />
<br />
==Installation==<br />
'''Note:''' <br />
* This guide assumes that you have already downloaded and installed Windows Media Player and WMPTSE.<br />
<br />
* This guide pictures are taken from WMP v9.0 but are valid for newer version.<br />
<br />
* In this guide, we will be adding an APEv2 tagging to our MediaLibrary .png files (why not...?).<br />
<br />
The png format being a container format, our tag binary data will not be interpreted by the png readers, saving us the trouble.<br />
<br />
But <font style="color:red">beware</font> if you add tagging support for non-container file types (.txt, .bin, .dat, etc...), you'll end up with a ''corrupted'' file<br />
<br />
<br />
<br />
==Configuration==<br />
<br />
* Launch Windows Media Player.<br />
<br />
* Display the WMPTSE property box (see [[WMPTSE - How to change the plug-in properties]])<br />
<br />
<br />
* Click '''Add Support''' button, the "Add Tag support" propery page is displayed :<br />
<center>[[Image:WMPTSE2_ET1.png]]</center><br />
<br />
<br />
* Choose the tag type to add in the list (here we choose '''APE''')<br />
<center>[[Image:WMPTSE2_ET2.png]]</center><br />
<br />
<br />
* Type filetype (just the extension) to add support to (here we type '''png''')<br />
<center>[[Image:WMPTSE2_ET3.png]]</center><br />
<br />
<br />
* We want to be sure that WMP will support our filetype, so we click on '''Check support'''<br />
If the filetype is not already supported by the Media Library, WMPTSE ask to confirm adding it<br />
<center>[[Image:WMPTSE2_ET4.png]]</center><br />
<br />
If the filetype is not available for normal user, WMPTSE ask to confirm adding support for normal users <br />
<center>[[Image:WMPTSE2_ET5.png]]</center><br />
<br />
<br />
* After agreeing to reboot WMP, click on the '''...''' button, at the end of the 'Tag Support DLL file path' line<br />
<center>[[Image:WMPTSE2_ET6.png]]</center><br />
<br />
<br />
* Now is an important part, you have to choose the tag support DLL to use. <br />
First, browse the directories where the tag support dll is stored. <br />
<center>[[Image:WMPTSE2_ET7.png]]</center><br />
<br />
Next, choose the right tag support dll and click '''open'''<br />
<center>[[Image:WMPTSE2_ET8.png]]</center><br />
<br />
By default, [[WMPTSE]] is distributed with support for APE (APETagSupport.dll), MPEG4 (MPEG4TagSupport.dll), <br />
FLAC (FLACTagSupport.dll) and Vorbis (VorbisTagSupport.dll).<br />
[[WMPTSE]] will only accept dll which support [[WMPTSE API]]. <br />
More preciselly, by choosing the tag type in the third step of this tutorial, you have fixed the tag support API <br />
function name WMPTSE will search. <br />
WMPTSE will alert you if the dll is not compatible with the tag support you choose.<br />
<br />
<br />
* You're now ready to add support for your new filetype, just click '''Add'''<br />
<center>[[Image:WMPTSE2_ET9.png]]</center><br />
<br />
<br />
* The filetype is displayed in the tag support list on the WMPTSE propery page<br />
<center>[[Image:WMPTSE2_ET10.png]]</center><br />
<br />
==Addtional Reading==<br />
* [[WMPTSE]]<br />
* [[WMPTSE - How to change the plug-in properties]]<br />
<br />
<br />
<br />
[[Category:Guides]]<br />
[[Category:WMPTSE Guides]]</div>MaB frhttps://wiki.hydrogenaud.io/index.php?title=File:WMPTSE2_ET10.pngFile:WMPTSE2 ET10.png2006-11-25T15:20:36Z<p>MaB fr: WMPTSE showing the support for APE tagged 'pnge' files</p>
<hr />
<div>[[WMPTSE]] showing the support for APE tagged 'pnge' files</div>MaB frhttps://wiki.hydrogenaud.io/index.php?title=WMPTSE_-_How_to_add_support_for_a_filetypeWMPTSE - How to add support for a filetype2006-11-25T15:02:29Z<p>MaB fr: /* Configuration */</p>
<hr />
<div>==Software Needed==<br />
* [http://www.microsoft.com/windows/windowsmedia/default.mspx Windows Media Player >v9.0]<br />
* [[WMPTSE]]<br />
<br />
<br />
<br />
==Installation==<br />
'''Note:''' <br />
* This guide assumes that you have already downloaded and installed Windows Media Player and WMPTSE.<br />
<br />
* This guide pictures are taken from WMP v9.0 but are valid for newer version.<br />
<br />
* In this guide, we will be adding an APEv2 tagging to our MediaLibrary .png files (why not...?).<br />
<br />
The png format being a container format, our tag binary data will not be interpreted by the png readers, saving us the trouble.<br />
<br />
But <font style="color:red">beware</font> if you add tagging support for non-container file types (.txt, .bin, .dat, etc...), you'll end up with a ''corrupted'' file<br />
<br />
<br />
<br />
==Configuration==<br />
<br />
* Launch Windows Media Player.<br />
<br />
* Display the WMPTSE property box (see [[WMPTSE - How to change the plug-in properties]])<br />
<br />
<br />
* Click '''Add Support''' button, the "Add Tag support" propery page is displayed :<br />
<center>[[Image:WMPTSE2_ET1.png]]</center><br />
<br />
<br />
* Choose the tag type to add in the list (here we choose '''APE''')<br />
<center>[[Image:WMPTSE2_ET2.png]]</center><br />
<br />
<br />
* Type filetype (just the extension) to add support to (here we type '''png''')<br />
<center>[[Image:WMPTSE2_ET3.png]]</center><br />
<br />
<br />
* We want to be sure that WMP will support our filetype, so we click on '''Check support'''<br />
If the filetype is not already supported by the Media Library, WMPTSE ask to confirm adding it<br />
<center>[[Image:WMPTSE2_ET4.png]]</center><br />
<br />
If the filetype is not available for normal user, WMPTSE ask to confirm adding support for normal users <br />
<center>[[Image:WMPTSE2_ET5.png]]</center><br />
<br />
<br />
* After agreeing to reboot WMP, click on the '''...''' button, at the end of the 'Tag Support DLL file path' line<br />
<center>[[Image:WMPTSE2_ET6.png]]</center><br />
<br />
<br />
* Now is an important part, you have to choose the tag support DLL to use. <br />
First, browse the directories where the tag support dll is stored. <br />
<center>[[Image:WMPTSE2_ET7.png]]</center><br />
<br />
Next, choose the right tag support dll and click '''open'''<br />
<center>[[Image:WMPTSE2_ET8.png]]</center><br />
<br />
By default, [[WMPTSE]] is distributed with support for APE (APETagSupport.dll), MPEG4 (MPEG4TagSupport.dll), <br />
FLAC (FLACTagSupport.dll) and Vorbis (VorbisTagSupport.dll).<br />
[[WMPTSE]] will only accept dll which support [[WMPTSE API]]. <br />
More preciselly, by choosing the tag type in the third step of this tutorial, you have fixed the tag support API <br />
function name WMPTSE will search. <br />
WMPTSE will alert you if the dll is not compatible with the tag support you choose.<br />
<br />
<br />
* You're now ready to add support for your new filetype, just click '''Add'''<br />
<center>[[Image:WMPTSE2_ET9.png]]</center><br />
<br />
==Addtional Reading==<br />
* [[WMPTSE]]<br />
* [[WMPTSE - How to change the plug-in properties]]<br />
<br />
<br />
<br />
[[Category:Guides]]<br />
[[Category:WMPTSE Guides]]</div>MaB frhttps://wiki.hydrogenaud.io/index.php?title=WMPTSE_-_How_to_add_support_for_a_filetypeWMPTSE - How to add support for a filetype2006-11-25T15:02:01Z<p>MaB fr: /* Configuration */</p>
<hr />
<div>==Software Needed==<br />
* [http://www.microsoft.com/windows/windowsmedia/default.mspx Windows Media Player >v9.0]<br />
* [[WMPTSE]]<br />
<br />
<br />
<br />
==Installation==<br />
'''Note:''' <br />
* This guide assumes that you have already downloaded and installed Windows Media Player and WMPTSE.<br />
<br />
* This guide pictures are taken from WMP v9.0 but are valid for newer version.<br />
<br />
* In this guide, we will be adding an APEv2 tagging to our MediaLibrary .png files (why not...?).<br />
<br />
The png format being a container format, our tag binary data will not be interpreted by the png readers, saving us the trouble.<br />
<br />
But <font style="color:red">beware</font> if you add tagging support for non-container file types (.txt, .bin, .dat, etc...), you'll end up with a ''corrupted'' file<br />
<br />
<br />
<br />
==Configuration==<br />
<br />
* Launch Windows Media Player.<br />
<br />
* Display the WMPTSE property box (see [[WMPTSE - How to change the plug-in properties]])<br />
<br />
<br />
* Click '''Add Support''' button, the "Add Tag support" propery page is displayed :<br />
<center>[[Image:WMPTSE2_ET1.png]]</center><br />
<br />
<br />
* Choose the tag type to add in the list (here we choose '''APE''')<br />
<center>[[Image:WMPTSE2_ET2.png]]</center><br />
<br />
<br />
* Type filetype (just the extension) to add support to (here we type '''png''')<br />
<center>[[Image:WMPTSE2_ET3.png]]</center><br />
<br />
<br />
* We want to be sure that WMP will support our filetype, so we click on '''Check support'''<br />
If the filetype is not already supported by the Media Library, WMPTSE ask to confirm adding it<br />
<center>[[Image:WMPTSE2_ET4.png]]</center><br />
<br />
If the filetype is not available for normal user, WMPTSE ask to confirm adding support for normal users <br />
<center>[[Image:WMPTSE2_ET5.png]]</center><br />
<br />
<br />
* After agreeing to reboot WMP, click on the '''...''' button, at the end of the 'Tag Support DLL file path' line<br />
<center>[[Image:WMPTSE2_ET6.png]]</center><br />
<br />
<br />
* Now is an important part, you have to choose the tag support DLL to use. <br />
First, browse the directories where the tag support dll is stored. <br />
<center>[[Image:WMPTSE2_ET7.png]]</center><br />
<br />
Next, choose the right tag support dll and click '''open'''<br />
<center>[[Image:WMPTSE2_ET8.png]]</center><br />
<br />
By default, [[WMPTSE]] is distributed with support for APE (APETagSupport.dll), MPEG4 (MPEG4TagSupport.dll), <br />
FLAC (FLACTagSupport.dll) and Vorbis (VorbisTagSupport.dll).<br />
[[WMPTSE]] will only accept dll which support [[WMPTSE API]]. <br />
More preciselly, by choosing the tag type in the third step of this tutorial, you have fixed the tag support API <br />
function name WMPTSE will search. <br />
WMPTSE will alert you if the dll is not compatible with the tag support you choose.<br />
<br />
<br />
* You're now ready to add support for your new filetype<br />
<center>[[Image:WMPTSE2_ET9.png]]</center><br />
<br />
==Addtional Reading==<br />
* [[WMPTSE]]<br />
* [[WMPTSE - How to change the plug-in properties]]<br />
<br />
<br />
<br />
[[Category:Guides]]<br />
[[Category:WMPTSE Guides]]</div>MaB frhttps://wiki.hydrogenaud.io/index.php?title=File:WMPTSE2_ET9.pngFile:WMPTSE2 ET9.png2006-11-25T15:00:32Z<p>MaB fr: WMPTSE ready to add support for APE tagging in png files</p>
<hr />
<div>[[WMPTSE]] ready to add support for APE tagging in png files</div>MaB frhttps://wiki.hydrogenaud.io/index.php?title=WMPTSE_-_How_to_add_support_for_a_filetypeWMPTSE - How to add support for a filetype2006-11-25T14:59:57Z<p>MaB fr: /* Configuration */</p>
<hr />
<div>==Software Needed==<br />
* [http://www.microsoft.com/windows/windowsmedia/default.mspx Windows Media Player >v9.0]<br />
* [[WMPTSE]]<br />
<br />
<br />
<br />
==Installation==<br />
'''Note:''' <br />
* This guide assumes that you have already downloaded and installed Windows Media Player and WMPTSE.<br />
<br />
* This guide pictures are taken from WMP v9.0 but are valid for newer version.<br />
<br />
* In this guide, we will be adding an APEv2 tagging to our MediaLibrary .png files (why not...?).<br />
<br />
The png format being a container format, our tag binary data will not be interpreted by the png readers, saving us the trouble.<br />
<br />
But <font style="color:red">beware</font> if you add tagging support for non-container file types (.txt, .bin, .dat, etc...), you'll end up with a ''corrupted'' file<br />
<br />
<br />
<br />
==Configuration==<br />
<br />
* Launch Windows Media Player.<br />
<br />
* Display the WMPTSE property box (see [[WMPTSE - How to change the plug-in properties]])<br />
<br />
<br />
* Click '''Add Support''' button, the "Add Tag support" propery page is displayed :<br />
<center>[[Image:WMPTSE2_ET1.png]]</center><br />
<br />
<br />
* Choose the tag type to add in the list (here we choose '''APE''')<br />
<center>[[Image:WMPTSE2_ET2.png]]</center><br />
<br />
<br />
* Type filetype (just the extension) to add support to (here we type '''png''')<br />
<center>[[Image:WMPTSE2_ET3.png]]</center><br />
<br />
<br />
* We want to be sure that WMP will support our filetype, so we click on '''Check support'''<br />
If the filetype is not already supported by the Media Library, WMPTSE ask to confirm adding it<br />
<center>[[Image:WMPTSE2_ET4.png]]</center><br />
<br />
If the filetype is not available for normal user, WMPTSE ask to confirm adding support for normal users <br />
<center>[[Image:WMPTSE2_ET5.png]]</center><br />
<br />
<br />
* After agreeing to reboot WMP, click on the '''...''' button, at the end of the 'Tag Support DLL file path' line<br />
<center>[[Image:WMPTSE2_ET6.png]]</center><br />
<br />
<br />
* Now is an important part, you have to choose the tag support DLL to use. <br />
First, browse the directories where the tag support dll is stored. <br />
<center>[[Image:WMPTSE2_ET7.png]]</center><br />
<br />
Next, choose the right tag support dll.<br />
<center>[[Image:WMPTSE2_ET8.png]]</center><br />
<br />
By default, [[WMPTSE]] is distributed with support for APE (APETagSupport.dll), MPEG4 (MPEG4TagSupport.dll), <br />
FLAC (FLACTagSupport.dll) and Vorbis (VorbisTagSupport.dll).<br />
[[WMPTSE]] will only accept dll which support [[WMPTSE API]]. <br />
More preciselly, by choosing the tag type in the third step of this tutorial, you have fixed the tag support API <br />
function name WMPTSE will search. <br />
WMPTSE will alert you if the dll is not compatible with the tag support you choose.<br />
<br />
==Addtional Reading==<br />
* [[WMPTSE]]<br />
* [[WMPTSE - How to change the plug-in properties]]<br />
<br />
<br />
<br />
[[Category:Guides]]<br />
[[Category:WMPTSE Guides]]</div>MaB frhttps://wiki.hydrogenaud.io/index.php?title=WMPTSE_-_How_to_add_support_for_a_filetypeWMPTSE - How to add support for a filetype2006-11-25T14:58:48Z<p>MaB fr: /* Configuration */</p>
<hr />
<div>==Software Needed==<br />
* [http://www.microsoft.com/windows/windowsmedia/default.mspx Windows Media Player >v9.0]<br />
* [[WMPTSE]]<br />
<br />
<br />
<br />
==Installation==<br />
'''Note:''' <br />
* This guide assumes that you have already downloaded and installed Windows Media Player and WMPTSE.<br />
<br />
* This guide pictures are taken from WMP v9.0 but are valid for newer version.<br />
<br />
* In this guide, we will be adding an APEv2 tagging to our MediaLibrary .png files (why not...?).<br />
<br />
The png format being a container format, our tag binary data will not be interpreted by the png readers, saving us the trouble.<br />
<br />
But <font style="color:red">beware</font> if you add tagging support for non-container file types (.txt, .bin, .dat, etc...), you'll end up with a ''corrupted'' file<br />
<br />
<br />
<br />
==Configuration==<br />
<br />
* Launch Windows Media Player.<br />
<br />
* Display the WMPTSE property box (see [[WMPTSE - How to change the plug-in properties]])<br />
<br />
<br />
* Click '''Add Support''' button, the "Add Tag support" propery page is displayed :<br />
<center>[[Image:WMPTSE2_ET1.png]]</center><br />
<br />
<br />
* Choose the tag type to add in the list (here we choose '''APE''')<br />
<center>[[Image:WMPTSE2_ET2.png]]</center><br />
<br />
<br />
* Type filetype (just the extension) to add support to (here we type '''png''')<br />
<center>[[Image:WMPTSE2_ET3.png]]</center><br />
<br />
<br />
* We want to be sure that WMP will support our filetype, so we click on '''Check support'''<br />
If the filetype is not already supported by the Media Library, WMPTSE ask to confirm adding it<br />
<center>[[Image:WMPTSE2_ET4.png]]</center><br />
<br />
If the filetype is not available for normal user, WMPTSE ask to confirm adding support for normal users <br />
<center>[[Image:WMPTSE2_ET5.png]]</center><br />
<br />
<br />
* After agreeing to reboot WMP, click on the '''...''' button, at the end of the 'Tag Support DLL file path' line<br />
<center>[[Image:WMPTSE2_ET6.png]]</center><br />
<br />
<br />
* Now is an important part, you have to choose the tag support DLL to use. <br />
First, browse the directories where the tag support dll is stored. <br />
<center>[[Image:WMPTSE2_ET7.png]]</center><br />
<br />
Next, choose the right tag support dll.<br />
<center>[[Image:WMPTSE2_ET8.png]]</center><br />
<br />
<br />
By default, [[WMPTSE]] is distributed with support for APE (APETagSupport.dll), MPEG4 (MPEG4TagSupport.dll), FLAC (FLACTagSupport.dll) and Vorbis (VorbisTagSupport.dll).<br />
[[WMPTSE]] will only accept dll which support [[WMPTSE API]]. <br />
More preciselly, by choosing the tag type in the third step of this tutorial, you have fixed the tag support API function name WMPTSE will search. WMPTSE will alert you if the dll is not compatible with the tag support you choose.<br />
<br />
==Addtional Reading==<br />
* [[WMPTSE]]<br />
* [[WMPTSE - How to change the plug-in properties]]<br />
<br />
<br />
<br />
[[Category:Guides]]<br />
[[Category:WMPTSE Guides]]</div>MaB frhttps://wiki.hydrogenaud.io/index.php?title=File:WMPTSE2_ET7.pngFile:WMPTSE2 ET7.png2006-11-25T14:56:40Z<p>MaB fr: WMPTSE tag support dll file browsing</p>
<hr />
<div>[[WMPTSE]] tag support dll file browsing</div>MaB frhttps://wiki.hydrogenaud.io/index.php?title=File:WMPTSE2_ET8.pngFile:WMPTSE2 ET8.png2006-11-25T14:56:00Z<p>MaB fr: </p>
<hr />
<div>[[WMPTSE]] tag support dll file choosing APETagSupport.dll</div>MaB frhttps://wiki.hydrogenaud.io/index.php?title=File:WMPTSE2_ET8.pngFile:WMPTSE2 ET8.png2006-11-25T14:51:24Z<p>MaB fr: WMPTSE tag support dll file browsing</p>
<hr />
<div>[[WMPTSE]] tag support dll file browsing</div>MaB frhttps://wiki.hydrogenaud.io/index.php?title=File:WMPTSE2_ET6.pngFile:WMPTSE2 ET6.png2006-11-25T14:49:31Z<p>MaB fr: WMPTSE Add support page, clicking on the tag support dll file path button</p>
<hr />
<div>[[WMPTSE]] Add support page, clicking on the tag support dll file path button</div>MaB frhttps://wiki.hydrogenaud.io/index.php?title=WMPTSE_-_How_to_add_support_for_a_filetypeWMPTSE - How to add support for a filetype2006-11-25T14:48:18Z<p>MaB fr: /* Configuration */</p>
<hr />
<div>==Software Needed==<br />
* [http://www.microsoft.com/windows/windowsmedia/default.mspx Windows Media Player >v9.0]<br />
* [[WMPTSE]]<br />
<br />
<br />
<br />
==Installation==<br />
'''Note:''' <br />
* This guide assumes that you have already downloaded and installed Windows Media Player and WMPTSE.<br />
<br />
* This guide pictures are taken from WMP v9.0 but are valid for newer version.<br />
<br />
* In this guide, we will be adding an APEv2 tagging to our MediaLibrary .png files (why not...?).<br />
<br />
The png format being a container format, our tag binary data will not be interpreted by the png readers, saving us the trouble.<br />
<br />
But <font style="color:red">beware</font> if you add tagging support for non-container file types (.txt, .bin, .dat, etc...), you'll end up with a ''corrupted'' file<br />
<br />
<br />
<br />
==Configuration==<br />
<br />
* Launch Windows Media Player.<br />
<br />
* Display the WMPTSE property box (see [[WMPTSE - How to change the plug-in properties]])<br />
<br />
* Click '''Add Support''' button, the "Add Tag support" propery page is displayed :<br />
<center>[[Image:WMPTSE2_ET1.png]]</center><br />
<br />
<br />
* Choose the tag type to add in the list (here we choose '''APE''')<br />
<center>[[Image:WMPTSE2_ET2.png]]</center><br />
<br />
<br />
* Type filetype (just the extension) to add support to (here we type '''png''')<br />
<center>[[Image:WMPTSE2_ET3.png]]</center><br />
<br />
<br />
* We want to be sure that WMP will support our filetype, so we click on '''Check support'''<br />
If the filetype is not already supported by the Media Library, WMPTSE ask to confirm adding it<br />
<center>[[Image:WMPTSE2_ET4.png]]</center><br />
<br />
If the filetype is not available for normal user, WMPTSE ask to confirm adding support for normal users <br />
<center>[[Image:WMPTSE2_ET5.png]]</center><br />
<br />
==Addtional Reading==<br />
* [[WMPTSE]]<br />
* [[WMPTSE - How to change the plug-in properties]]<br />
<br />
<br />
<br />
[[Category:Guides]]<br />
[[Category:WMPTSE Guides]]</div>MaB frhttps://wiki.hydrogenaud.io/index.php?title=File:WMPTSE2_ET5.pngFile:WMPTSE2 ET5.png2006-11-25T14:47:58Z<p>MaB fr: WMPTSE asking for a filetype 'user-ownabillity'</p>
<hr />
<div>[[WMPTSE]] asking for a filetype 'user-ownabillity'</div>MaB frhttps://wiki.hydrogenaud.io/index.php?title=WMPTSE_-_How_to_add_support_for_a_filetypeWMPTSE - How to add support for a filetype2006-11-25T14:46:02Z<p>MaB fr: /* Configuration */</p>
<hr />
<div>==Software Needed==<br />
* [http://www.microsoft.com/windows/windowsmedia/default.mspx Windows Media Player >v9.0]<br />
* [[WMPTSE]]<br />
<br />
<br />
<br />
==Installation==<br />
'''Note:''' <br />
* This guide assumes that you have already downloaded and installed Windows Media Player and WMPTSE.<br />
<br />
* This guide pictures are taken from WMP v9.0 but are valid for newer version.<br />
<br />
* In this guide, we will be adding an APEv2 tagging to our MediaLibrary .png files (why not...?).<br />
<br />
The png format being a container format, our tag binary data will not be interpreted by the png readers, saving us the trouble.<br />
<br />
But <font style="color:red">beware</font> if you add tagging support for non-container file types (.txt, .bin, .dat, etc...), you'll end up with a ''corrupted'' file<br />
<br />
<br />
<br />
==Configuration==<br />
<br />
* Launch Windows Media Player.<br />
<br />
* Display the WMPTSE property box (see [[WMPTSE - How to change the plug-in properties]])<br />
<br />
* Click '''Add Support''' button, the "Add Tag support" propery page is displayed :<br />
<center>[[Image:WMPTSE2_ET1.png]]</center><br />
<br />
* Choose the tag type to add in the list (here we choose '''APE''')<br />
<center>[[Image:WMPTSE2_ET2.png]]</center><br />
<br />
* Type filetype (just the extension) to add support to (here we type '''png''')<br />
<center>[[Image:WMPTSE2_ET3.png]]</center><br />
<br />
<br />
* We want to be sure that WMP will support our filetype, so we click on '''Check support'''<br />
If the filetype is not already supported by the Media Library, WMPTSE ask to confirm adding it<br />
<center>[[Image:WMPTSE2_ET4.png]]</center><br />
<br />
==Addtional Reading==<br />
* [[WMPTSE]]<br />
* [[WMPTSE - How to change the plug-in properties]]<br />
<br />
<br />
<br />
[[Category:Guides]]<br />
[[Category:WMPTSE Guides]]</div>MaB frhttps://wiki.hydrogenaud.io/index.php?title=File:WMPTSE2_ET4.pngFile:WMPTSE2 ET4.png2006-11-25T14:43:43Z<p>MaB fr: WMPTSE Asking to confirm Media Library support for a filetype</p>
<hr />
<div>[[WMPTSE]] Asking to confirm Media Library support for a filetype</div>MaB frhttps://wiki.hydrogenaud.io/index.php?title=WMPTSE_-_How_to_add_support_for_a_filetypeWMPTSE - How to add support for a filetype2006-11-25T14:42:33Z<p>MaB fr: /* Configuration */</p>
<hr />
<div>==Software Needed==<br />
* [http://www.microsoft.com/windows/windowsmedia/default.mspx Windows Media Player >v9.0]<br />
* [[WMPTSE]]<br />
<br />
<br />
<br />
==Installation==<br />
'''Note:''' <br />
* This guide assumes that you have already downloaded and installed Windows Media Player and WMPTSE.<br />
<br />
* This guide pictures are taken from WMP v9.0 but are valid for newer version.<br />
<br />
* In this guide, we will be adding an APEv2 tagging to our MediaLibrary .png files (why not...?).<br />
<br />
The png format being a container format, our tag binary data will not be interpreted by the png readers, saving us the trouble.<br />
<br />
But <font style="color:red">beware</font> if you add tagging support for non-container file types (.txt, .bin, .dat, etc...), you'll end up with a ''corrupted'' file<br />
<br />
<br />
<br />
==Configuration==<br />
<br />
* Launch Windows Media Player.<br />
<br />
* Display the WMPTSE property box (see [[WMPTSE - How to change the plug-in properties]])<br />
<br />
* Click '''Add Support''' button, the "Add Tag support" propery page is displayed :<br />
<center>[[Image:WMPTSE2_ET1.png]]</center><br />
<br />
* Choose the tag type to add in the list (here we choose '''APE''')<br />
<center>[[Image:WMPTSE2_ET2.png]]</center><br />
<br />
* Type filetype (just the extension) to add support to (here we type '''png''')<br />
<center>[[Image:WMPTSE2_ET3.png]]</center><br />
<br />
==Addtional Reading==<br />
* [[WMPTSE]]<br />
* [[WMPTSE - How to change the plug-in properties]]<br />
<br />
<br />
<br />
[[Category:Guides]]<br />
[[Category:WMPTSE Guides]]</div>MaB frhttps://wiki.hydrogenaud.io/index.php?title=File:WMPTSE2_ET3.pngFile:WMPTSE2 ET3.png2006-11-25T14:41:22Z<p>MaB fr: WMPTSE Add support page with APE tag support for png filetype</p>
<hr />
<div>[[WMPTSE]] Add support page with APE tag support for png filetype</div>MaB frhttps://wiki.hydrogenaud.io/index.php?title=WMPTSE_-_How_to_add_support_for_a_filetypeWMPTSE - How to add support for a filetype2006-11-25T14:40:31Z<p>MaB fr: /* Configuration */</p>
<hr />
<div>==Software Needed==<br />
* [http://www.microsoft.com/windows/windowsmedia/default.mspx Windows Media Player >v9.0]<br />
* [[WMPTSE]]<br />
<br />
<br />
<br />
==Installation==<br />
'''Note:''' <br />
* This guide assumes that you have already downloaded and installed Windows Media Player and WMPTSE.<br />
<br />
* This guide pictures are taken from WMP v9.0 but are valid for newer version.<br />
<br />
* In this guide, we will be adding an APEv2 tagging to our MediaLibrary .png files (why not...?).<br />
<br />
The png format being a container format, our tag binary data will not be interpreted by the png readers, saving us the trouble.<br />
<br />
But <font style="color:red">beware</font> if you add tagging support for non-container file types (.txt, .bin, .dat, etc...), you'll end up with a ''corrupted'' file<br />
<br />
<br />
<br />
==Configuration==<br />
<br />
* Launch Windows Media Player.<br />
<br />
* Display the WMPTSE property box (see [[WMPTSE - How to change the plug-in properties]])<br />
<br />
* Click '''Add Support''' button, the "Add Tag support" propery page is displayed :<br />
<center>[[Image:WMPTSE2_ET1.png]]</center><br />
<br />
* Choose '''APE''' in the tag type list<br />
<center>[[Image:WMPTSE2_ET2.png]]</center><br />
<br />
==Addtional Reading==<br />
* [[WMPTSE]]<br />
* [[WMPTSE - How to change the plug-in properties]]<br />
<br />
<br />
<br />
[[Category:Guides]]<br />
[[Category:WMPTSE Guides]]</div>MaB frhttps://wiki.hydrogenaud.io/index.php?title=File:WMPTSE2_ET2.pngFile:WMPTSE2 ET2.png2006-11-25T14:39:45Z<p>MaB fr: WMPTSE Add support page with APE tag selected</p>
<hr />
<div>[[WMPTSE]] Add support page with APE tag selected</div>MaB frhttps://wiki.hydrogenaud.io/index.php?title=WMPTSE_-_How_to_add_support_for_a_filetypeWMPTSE - How to add support for a filetype2006-11-25T14:37:31Z<p>MaB fr: /* Configuration */</p>
<hr />
<div>==Software Needed==<br />
* [http://www.microsoft.com/windows/windowsmedia/default.mspx Windows Media Player >v9.0]<br />
* [[WMPTSE]]<br />
<br />
<br />
<br />
==Installation==<br />
'''Note:''' <br />
* This guide assumes that you have already downloaded and installed Windows Media Player and WMPTSE.<br />
<br />
* This guide pictures are taken from WMP v9.0 but are valid for newer version.<br />
<br />
* In this guide, we will be adding an APEv2 tagging to our MediaLibrary .png files (why not...?).<br />
<br />
The png format being a container format, our tag binary data will not be interpreted by the png readers, saving us the trouble.<br />
<br />
But <font style="color:red">beware</font> if you add tagging support for non-container file types (.txt, .bin, .dat, etc...), you'll end up with a ''corrupted'' file<br />
<br />
<br />
<br />
==Configuration==<br />
<br />
* Launch Windows Media Player.<br />
<br />
* Display the WMPTSE property box (see [[WMPTSE - How to change the plug-in properties]])<br />
<br />
* Click '''Add Support''' button, the "Add Tag support" propery page is displayed :<br />
<center>[[Image:WMPTSE2_ET1.png]]</center><br />
<br />
==Addtional Reading==<br />
* [[WMPTSE]]<br />
* [[WMPTSE - How to change the plug-in properties]]<br />
<br />
<br />
<br />
[[Category:Guides]]<br />
[[Category:WMPTSE Guides]]</div>MaB frhttps://wiki.hydrogenaud.io/index.php?title=File:WMPTSE2_ET1.pngFile:WMPTSE2 ET1.png2006-11-25T14:35:58Z<p>MaB fr: WMPTSE Add support page</p>
<hr />
<div>[[WMPTSE]] Add support page</div>MaB frhttps://wiki.hydrogenaud.io/index.php?title=WMPTSE_-_How_to_add_support_for_a_filetypeWMPTSE - How to add support for a filetype2006-11-23T23:18:53Z<p>MaB fr: /* Configuration */</p>
<hr />
<div>==Software Needed==<br />
* [http://www.microsoft.com/windows/windowsmedia/default.mspx Windows Media Player >v9.0]<br />
* [[WMPTSE]]<br />
<br />
<br />
<br />
==Installation==<br />
'''Note:''' <br />
* This guide assumes that you have already downloaded and installed Windows Media Player and WMPTSE.<br />
<br />
* This guide pictures are taken from WMP v9.0 but are valid for newer version.<br />
<br />
* In this guide, we will be adding an APEv2 tagging to our MediaLibrary .png files (why not...?).<br />
<br />
The png format being a container format, our tag binary data will not be interpreted by the png readers, saving us the trouble.<br />
<br />
But <font style="color:red">beware</font> if you add tagging support for non-container file types (.txt, .bin, .dat, etc...), you'll end up with a ''corrupted'' file<br />
<br />
<br />
<br />
==Configuration==<br />
<br />
* Launch Windows Media Player.<br />
<br />
* Display the WMPTSE property box (see [[WMPTSE - How to change the plug-in properties]])<br />
<br />
* Click '''Add Support''' button<br />
''to complete''<br />
<br />
==Addtional Reading==<br />
* [[WMPTSE]]<br />
* [[WMPTSE - How to change the plug-in properties]]<br />
<br />
<br />
<br />
[[Category:Guides]]<br />
[[Category:WMPTSE Guides]]</div>MaB frhttps://wiki.hydrogenaud.io/index.php?title=WMPTSE_APIWMPTSE API2006-11-21T13:53:37Z<p>MaB fr: /* Example Source Code */</p>
<hr />
<div>The WMPTSE API is the interface between the [[WMPTSE]] plug-in and its "tag support dll".<br />
<br />
A '''tag support dll''' give WMPTSE the ability to add support of a tag format in Windows Media Player. <br />
With the this "tag support dll" properly installed, files tagged with its format are readable inside WMP.<br />
<br />
<br />
==API==<br />
Every WMPTSE API application must export two function (c standard call):<br />
<br />
BOOL Read<font style="color:green"><TagFormat></font>Tag( LPTSTR lpstrFileFullPath, METATAG * pMetaTag )<br />
<br />
BOOL Write<font style="color:green"><TagFormat></font>Tag( LPTSTR lpstrFileFullPath, TAGITEM tagiChangedItem )<br />
<br />
<font style="color:green"><TagFormat></font> will be the name of the corresponding tag format (APE, Vorbis, MPEG4 for example). <br />
The complete function names will be search by WMPTSE during the load process. <br />
<br />
<br />
The boolean return value is important.<br />
<br />
For the read function, it tells WMPTSE if the "tag support dll" has find the correct tag format structures (even if they are empty). If the value is TRUE, WMPTSE will stop searching for compatible tag format for this file (yes, a file can be multi-tagged). If the value is FALSE, WMPTSE will continue searching in its compatible tag format list.<br />
<br />
For the write function, it tells WMPTSE if the "tag support dll" has correctly write the new value. If this is true, WMPTSE will continue using this "tag support dll" for this filetype. If this value is false, WMPTSE may unload the "tag support dll".<br />
<br />
<br />
These function types are defined as FP_TAGREAD (read), FP_TAGWRITE (write) in "WMPTSE.h".<br />
<br />
==Definition==<br />
'''Note''' : All types and definition are declared in WMPTSE.h.<br />
It is simple for developper to include it at first.<br />
<br />
For reading purpose, we will expose the necessary structure definition here.<br />
<br />
struct stTagItem <br />
{<br />
char * MetaTagWMPKey; /** the MediaLibrary attribute's name */<br />
LPTSTR MetaTagValue; /** the value to set */<br />
};<br />
#define TAGITEM struct stTagItem <br />
typedef struct stTagItem * LPTAGITEM; <br />
<br />
struct stMetaTag<br />
{<br />
UINT uiNbItems; /** number of list tags */<br />
LPTAGITEM tagiItems; /** pointer to array of pointer to tag items */<br />
};<br />
#define METATAG struct stMetaTag<br />
typedef struct stMetaTag * LPMETATAG;<br />
<br />
<br />
==Example Source Code==<br />
In this example, we will add support for a weird tag format : the "Sting fan" format.<br />
In fact, every file considered tagged with this format will return "Sting" as Album Artist. The sign of a true fan :)<br />
<br />
<br />
'''Note''' : We will not create the write function as it is a "read only" tag format.<br />
<br />
<br />
Let's see the documented code :<br />
<br />
/////////////////////////////////////////////////////////////////////////////<br />
//<br />
// StingTagSupport.c : <br />
// Handler for Sting tags support<br />
//<br />
// Copyxxx (\C) 200x - <br />
// <br />
/////////////////////////////////////////////////////////////////////////////<br />
#define STING_TAGSUPPORT_C<br />
#include "StingTagSupport.h"<br />
#undef STING_TAGSUPPORT_C<br />
<br />
<br />
BOOL STINGTAG_API ReadStingTag<br />
( <br />
LPTSTR lpstrFileFullPath, <br />
METATAG * pMetaTag <br />
) <br />
{<br />
UINT uiFilePathSize;<br />
LPSTR lpcFileFullPath;<br />
LPVOID lpvTempPtr;<br />
<br />
//First we get the filepath length before retrieving it<br />
uiFilePathSize = WideCharToMultiByte<br />
(<br />
CP_ACP,<br />
0,<br />
lpstrFileFullPath,<br />
-1,<br />
NULL,<br />
0,<br />
NULL,<br />
NULL<br />
);<br />
//then we alloc on the process Heap the memory<br />
lpcFileFullPath = ( LPSTR ) HeapAlloc<br />
(<br />
GetProcessHeap(), <br />
HEAP_ZERO_MEMORY,<br />
uiFilePathSize<br />
);<br />
//and we retrieve the filepath<br />
WideCharToMultiByte<br />
(<br />
CP_ACP,<br />
0,<br />
lpstrFileFullPath,<br />
-1,<br />
lpcFileFullPath,<br />
uiFilePathSize,<br />
NULL,<br />
NULL<br />
); <br />
<br />
//now, we fill the MetaTag structure with start values<br />
//at start we don't have any Tags..<br />
pMetaTag->uiNbItems = 0;<br />
//at start we need to have a "root" TAGITEM table so we alloc it<br />
pMetaTag->tagiItems = ( LPTAGITEM )HeapAlloc<br />
( <br />
GetProcessHeap(), <br />
HEAP_ZERO_MEMORY, <br />
sizeof( TAGITEM )<br />
);<br />
<br />
//We will handles just Album Artist (it should be enough for an example)<br />
//first we resize our previous TAGITEM table<br />
lpvTempPtr = ( LPTAGITEM )HeapReAlloc<br />
( <br />
GetProcessHeap(), <br />
HEAP_ZERO_MEMORY, <br />
pMetaTag->tagiItems,<br />
sizeof( TAGITEM ) * ( pMetaTag->uiNbItems + 1 )<br />
);<br />
if( lpvTempPtr == NULL )<br />
// we handle a worse case scenario<br />
return FALSE;<br />
<br />
//we replace with the new pointer (if it has changed)<br />
pMetaTag->tagiItems = lpvTempPtr;<br />
<br />
//we alloc the new string to store our tag value<br />
//it will be freed by WMPTSE, so be sure to have it alloced yourself.<br />
//(no static string...)<br />
pMetaTag->tagiItems[ pMetaTag->uiNbItems ].MetaTagValue = HeapAlloc<br />
(<br />
GetProcessHeap(),<br />
HEAP_ZERO_MEMORY,<br />
sizeof( TCHAR ) * ( lstrlen( STING_FAN_ARTIST ) + 1 )<br />
);<br />
//we copy the tag value<br />
lstrcpy( pMetaTag->tagiItems[ pMetaTag->uiNbItems ].MetaTagValue, STING_FAN_ARTIST );<br />
//we give WMPTSE the right tag Key (it must be a WMP_TAG_ string, see WMPTSE.h)<br />
pMetaTag->tagiItems[ pMetaTag->uiNbItems ].MetaTagWMPKey = WMP_TAG_ALBUMARTIST;<br />
//we increase our tagitem number<br />
pMetaTag->uiNbItems++;<br />
<br />
<br />
//all is finished, we can release the filepath string <br />
HeapFree( GetProcessHeap(), 0, lpcFileFullPath );<br />
<br />
return TRUE;<br />
}<br />
<br />
BOOL STINGTAG_API WriteStingTag<br />
( <br />
LPTSTR lpstrFileFullPath, <br />
TAGITEM tagiChangedItem <br />
)<br />
{<br />
return TRUE;<br />
}<br />
<br />
And the nice header to go with it<br />
<br />
/////////////////////////////////////////////////////////////////////////////<br />
//<br />
// StingTagSupport.h : <br />
// Handler header for Sting tags support<br />
//<br />
// Copyxxx (\C) 200x - <br />
// <br />
/////////////////////////////////////////////////////////////////////////////<br />
#ifndef STING_TAG_SUPPORT_H<br />
#define STING_TAG_SUPPORT_H<br />
<br />
<br />
#define WIN32_LEAN_AND_MEAN<br />
#define UNICODE<br />
#include <windows.h><br />
<br />
#include "WMPTSE.h"<br />
<br />
#ifdef STING_TAGSUPPORT_C<br />
<br />
<br />
#define STING_FAN_ARTIST TCHAR( "Sting" )<br />
<br />
<br />
#ifdef _USRDLL<br />
#define STINGTAG_API __declspec( dllexport )<br />
#else<br />
#define STINGTAG_API <br />
#endif<br />
<br />
#else<br />
<br />
#ifdef _USRDLL<br />
#define STINGTAG_API extern __declspec( dllimport )<br />
#elif defined( _EXPORTDLL )<br />
#define STINGTAG_API extern __declspec( dllexport )<br />
#else<br />
#define STINGTAG_API extern<br />
#endif<br />
<br />
#endif <br />
<br />
<br />
//<br />
// TODO : add your exportable function declaration here<br />
//<br />
// WMPTSE TagSupport API<br />
BOOL STINGTAG_API ReadStingTag<br />
( <br />
LPTSTR lpstrFileFullPath, <br />
METATAG * pMetaTag <br />
);<br />
<br />
BOOL STINGTAG_API WriteStingTag<br />
( <br />
LPTSTR lpstrFileFullPath, <br />
TAGITEM tagiChangedItem <br />
);<br />
<br />
<br />
#endif STING_TAG_SUPPORT_H<br />
<br />
==Installation==<br />
To be effective, a "tag support dll" must be correctly installed in WMPTSE.<br />
<br />
You have two choice to install a "tag support dll" :<br />
* use the WMPTSE tag support wizard (see [[WMPTSE - How to add support for a tag format]])<br />
* edit the registry yourself :<br />
<br />
<br />
'''Note''' : In this guide, we will not expose the registry editing for complete file type support in Windows (MIME Types, Media Library Support, etc...). Please refer to Microsoft Windows Media Player documentation for this.<br />
<br />
<br />
On load, [[WMPTSE]] browse the '''HKEY_LOCAL_MACHINE\SOFTWARE\piPOol\WMPTSE''' registry key.<br />
<br />
Each subkey it finds will be consider a <font style="color:green"><TagFormat></font> definition.<br />
<br />
Inside each subkey (or <font style="color:green"><TagFormat></font> definition), WMPTSE browse for file type support.<br />
<br />
Each string in '''HKEY_LOCAL_MACHINE\SOFTWARE\piPOol\WMPTSE\<font style="color:green"><TagFormat></font>''' describe the file type to support (registry string name) and the path to the "tag support dll" to load (registry string value).<br />
<br />
After reading all file types definitions, [[WMPTSE]] loads each "tag support dll" and try to get the '''Read<font style="color:green"><TagFormat></font>Tag''' and '''Write<font style="color:green"><TagFormat></font>Tag''' functions.<br />
<br />
For each dll, If one of those two functions doesn't exist, the dll is considered non-WMPTSE API compatible and is unloaded.<br />
<br />
It those two functions exist, the dll is registered as a "tag support dll" for the registered file type.<br />
<br />
[[Category:Technical]]<br />
[[Category:Software]]</div>MaB frhttps://wiki.hydrogenaud.io/index.php?title=WMPTSE_APIWMPTSE API2006-11-21T13:52:47Z<p>MaB fr: /* Example Source Code */</p>
<hr />
<div>The WMPTSE API is the interface between the [[WMPTSE]] plug-in and its "tag support dll".<br />
<br />
A '''tag support dll''' give WMPTSE the ability to add support of a tag format in Windows Media Player. <br />
With the this "tag support dll" properly installed, files tagged with its format are readable inside WMP.<br />
<br />
<br />
==API==<br />
Every WMPTSE API application must export two function (c standard call):<br />
<br />
BOOL Read<font style="color:green"><TagFormat></font>Tag( LPTSTR lpstrFileFullPath, METATAG * pMetaTag )<br />
<br />
BOOL Write<font style="color:green"><TagFormat></font>Tag( LPTSTR lpstrFileFullPath, TAGITEM tagiChangedItem )<br />
<br />
<font style="color:green"><TagFormat></font> will be the name of the corresponding tag format (APE, Vorbis, MPEG4 for example). <br />
The complete function names will be search by WMPTSE during the load process. <br />
<br />
<br />
The boolean return value is important.<br />
<br />
For the read function, it tells WMPTSE if the "tag support dll" has find the correct tag format structures (even if they are empty). If the value is TRUE, WMPTSE will stop searching for compatible tag format for this file (yes, a file can be multi-tagged). If the value is FALSE, WMPTSE will continue searching in its compatible tag format list.<br />
<br />
For the write function, it tells WMPTSE if the "tag support dll" has correctly write the new value. If this is true, WMPTSE will continue using this "tag support dll" for this filetype. If this value is false, WMPTSE may unload the "tag support dll".<br />
<br />
<br />
These function types are defined as FP_TAGREAD (read), FP_TAGWRITE (write) in "WMPTSE.h".<br />
<br />
==Definition==<br />
'''Note''' : All types and definition are declared in WMPTSE.h.<br />
It is simple for developper to include it at first.<br />
<br />
For reading purpose, we will expose the necessary structure definition here.<br />
<br />
struct stTagItem <br />
{<br />
char * MetaTagWMPKey; /** the MediaLibrary attribute's name */<br />
LPTSTR MetaTagValue; /** the value to set */<br />
};<br />
#define TAGITEM struct stTagItem <br />
typedef struct stTagItem * LPTAGITEM; <br />
<br />
struct stMetaTag<br />
{<br />
UINT uiNbItems; /** number of list tags */<br />
LPTAGITEM tagiItems; /** pointer to array of pointer to tag items */<br />
};<br />
#define METATAG struct stMetaTag<br />
typedef struct stMetaTag * LPMETATAG;<br />
<br />
<br />
==Example Source Code==<br />
In this example, we will add support for a weird tag format : the "Sting fan" format.<br />
In fact, every file considered tagged with this format will return "Sting" as Album Artist. The sign of a true fan :)<br />
<br />
<br />
'''Note''' : We will not create the write function as it is a "read only" tag format.<br />
<br />
<br />
Let's see the documented code :<br />
<br />
/////////////////////////////////////////////////////////////////////////////<br />
//<br />
// StingTagSupport.c : <br />
// Handler for Sting tags support<br />
//<br />
// Copyxxx (\C) 200x - <br />
// <br />
/////////////////////////////////////////////////////////////////////////////<br />
#define STING_TAGSUPPORT_C<br />
#include "StingTagSupport.h"<br />
#undef STING_TAGSUPPORT_C<br />
<br />
<br />
BOOL STINGTAG_API ReadStingTag<br />
( <br />
LPTSTR lpstrFileFullPath, <br />
METATAG * pMetaTag <br />
) <br />
{<br />
UINT uiFilePathSize;<br />
LPSTR lpcFileFullPath;<br />
LPVOID lpvTempPtr;<br />
<br />
//First we get the filepath length before retrieving it<br />
uiFilePathSize = WideCharToMultiByte<br />
(<br />
CP_ACP,<br />
0,<br />
lpstrFileFullPath,<br />
-1,<br />
NULL,<br />
0,<br />
NULL,<br />
NULL<br />
);<br />
//then we alloc on the process Heap the memory<br />
lpcFileFullPath = ( LPSTR ) HeapAlloc<br />
(<br />
GetProcessHeap(), <br />
HEAP_ZERO_MEMORY,<br />
uiFilePathSize<br />
);<br />
//and we retrieve the filepath<br />
WideCharToMultiByte<br />
(<br />
CP_ACP,<br />
0,<br />
lpstrFileFullPath,<br />
-1,<br />
lpcFileFullPath,<br />
uiFilePathSize,<br />
NULL,<br />
NULL<br />
); <br />
<br />
//now, we fill the MetaTag structure with start values<br />
//at start we don't have any Tags..<br />
pMetaTag->uiNbItems = 0;<br />
//at start we need to have a "root" TAGITEM table so we alloc it<br />
pMetaTag->tagiItems = ( LPTAGITEM )HeapAlloc<br />
( <br />
GetProcessHeap(), <br />
HEAP_ZERO_MEMORY, <br />
sizeof( TAGITEM )<br />
);<br />
<br />
//We will handles just Album Artist (it should be enough for an example)<br />
//first we resize our previous TAGITEM table<br />
lpvTempPtr = ( LPTAGITEM )HeapReAlloc<br />
( <br />
GetProcessHeap(), <br />
HEAP_ZERO_MEMORY, <br />
pMetaTag->tagiItems,<br />
sizeof( TAGITEM ) * ( pMetaTag->uiNbItems + 1 )<br />
);<br />
if( lpvTempPtr == NULL )<br />
// we handle a worse case scenario<br />
return FALSE;<br />
<br />
//we replace with the new pointer (if it has changed)<br />
pMetaTag->tagiItems = lpvTempPtr;<br />
<br />
//we alloc the new string to store our tag value<br />
//it will be freed by WMPTSE, so be sure to have it alloced yourself.<br />
//(no static string...)<br />
pMetaTag->tagiItems[ pMetaTag->uiNbItems ].MetaTagValue = HeapAlloc<br />
(<br />
GetProcessHeap(),<br />
HEAP_ZERO_MEMORY,<br />
sizeof( TCHAR ) * ( lstrlen( STING_FAN_ARTIST ) + 1 )<br />
);<br />
//we copy the tag value<br />
lstrcpy( pMetaTag->tagiItems[ pMetaTag->uiNbItems ].MetaTagValue, STING_FAN_ARTIST );<br />
//we give WMPTSE the right tag Key (it must be a WMP_TAG_ string, see WMPTSE.h)<br />
pMetaTag->tagiItems[ pMetaTag->uiNbItems ].MetaTagWMPKey = WMP_TAG_ALBUMARTIST;<br />
//we increase our tagitem number<br />
pMetaTag->uiNbItems++;<br />
<br />
<br />
//all is finished, we can release the filepath string <br />
HeapFree( GetProcessHeap(), 0, lpcFileFullPath );<br />
<br />
return TRUE;<br />
}<br />
<br />
BOOL STINGTAG_API WriteStingTag<br />
( <br />
LPTSTR lpstrFileFullPath, <br />
TAGITEM tagiChangedItem <br />
)<br />
{<br />
return TRUE;<br />
}<br />
<br />
And the nice header to go with it<br />
<br />
/////////////////////////////////////////////////////////////////////////////<br />
//<br />
// StingTagSupport.h : <br />
// Handler header for Sting tags support<br />
//<br />
// Copyxxx (\C) 200x - <br />
// <br />
/////////////////////////////////////////////////////////////////////////////<br />
#ifndef STING_TAG_SUPPORT_H<br />
#define STING_TAG_SUPPORT_H<br />
<br />
<br />
#define WIN32_LEAN_AND_MEAN<br />
#define UNICODE<br />
#include <windows.h><br />
<br />
#include "WMPTSE.h"<br />
<br />
#ifdef STING_TAGSUPPORT_C<br />
<br />
<br />
#define STING_FAN_ARTIST TCHAR( "Sting" )<br />
<br />
<br />
#ifdef _USRDLL<br />
#define STINGTAG_API __declspec( dllexport )<br />
#else<br />
#define STINGTAG_API <br />
#endif<br />
<br />
#else<br />
<br />
#ifdef _USRDLL<br />
#define STINGTAG_API extern __declspec( dllimport )<br />
#elif defined( _EXPORTDLL )<br />
#define STINGTAG_API extern __declspec( dllexport )<br />
#else<br />
#define STINGTAG_API extern<br />
#endif<br />
<br />
#endif <br />
<br />
<br />
//<br />
// TODO : add your exportable function declaration here<br />
//<br />
// WMPTSE TagSupport API<br />
BOOL STINGTAG_API ReadStingTag<br />
( <br />
LPTSTR lpstrFileFullPath, <br />
METATAG * pMetaTag <br />
);<br />
<br />
BOOL STINGTAG_API WriteStingTag<br />
( <br />
LPTSTR lpstrFileFullPath, <br />
TAGITEM tagiChangedItem <br />
);<br />
<br />
<br />
#endif STING_TAG_SUPPORT_H<br />
<br />
==Installation==<br />
To be effective, a "tag support dll" must be correctly installed in WMPTSE.<br />
<br />
You have two choice to install a "tag support dll" :<br />
* use the WMPTSE tag support wizard (see [[WMPTSE - How to add support for a tag format]])<br />
* edit the registry yourself :<br />
<br />
<br />
'''Note''' : In this guide, we will not expose the registry editing for complete file type support in Windows (MIME Types, Media Library Support, etc...). Please refer to Microsoft Windows Media Player documentation for this.<br />
<br />
<br />
On load, [[WMPTSE]] browse the '''HKEY_LOCAL_MACHINE\SOFTWARE\piPOol\WMPTSE''' registry key.<br />
<br />
Each subkey it finds will be consider a <font style="color:green"><TagFormat></font> definition.<br />
<br />
Inside each subkey (or <font style="color:green"><TagFormat></font> definition), WMPTSE browse for file type support.<br />
<br />
Each string in '''HKEY_LOCAL_MACHINE\SOFTWARE\piPOol\WMPTSE\<font style="color:green"><TagFormat></font>''' describe the file type to support (registry string name) and the path to the "tag support dll" to load (registry string value).<br />
<br />
After reading all file types definitions, [[WMPTSE]] loads each "tag support dll" and try to get the '''Read<font style="color:green"><TagFormat></font>Tag''' and '''Write<font style="color:green"><TagFormat></font>Tag''' functions.<br />
<br />
For each dll, If one of those two functions doesn't exist, the dll is considered non-WMPTSE API compatible and is unloaded.<br />
<br />
It those two functions exist, the dll is registered as a "tag support dll" for the registered file type.<br />
<br />
[[Category:Technical]]<br />
[[Category:Software]]</div>MaB frhttps://wiki.hydrogenaud.io/index.php?title=WMPTSE_APIWMPTSE API2006-11-21T13:51:58Z<p>MaB fr: /* Example Source Code */</p>
<hr />
<div>The WMPTSE API is the interface between the [[WMPTSE]] plug-in and its "tag support dll".<br />
<br />
A '''tag support dll''' give WMPTSE the ability to add support of a tag format in Windows Media Player. <br />
With the this "tag support dll" properly installed, files tagged with its format are readable inside WMP.<br />
<br />
<br />
==API==<br />
Every WMPTSE API application must export two function (c standard call):<br />
<br />
BOOL Read<font style="color:green"><TagFormat></font>Tag( LPTSTR lpstrFileFullPath, METATAG * pMetaTag )<br />
<br />
BOOL Write<font style="color:green"><TagFormat></font>Tag( LPTSTR lpstrFileFullPath, TAGITEM tagiChangedItem )<br />
<br />
<font style="color:green"><TagFormat></font> will be the name of the corresponding tag format (APE, Vorbis, MPEG4 for example). <br />
The complete function names will be search by WMPTSE during the load process. <br />
<br />
<br />
The boolean return value is important.<br />
<br />
For the read function, it tells WMPTSE if the "tag support dll" has find the correct tag format structures (even if they are empty). If the value is TRUE, WMPTSE will stop searching for compatible tag format for this file (yes, a file can be multi-tagged). If the value is FALSE, WMPTSE will continue searching in its compatible tag format list.<br />
<br />
For the write function, it tells WMPTSE if the "tag support dll" has correctly write the new value. If this is true, WMPTSE will continue using this "tag support dll" for this filetype. If this value is false, WMPTSE may unload the "tag support dll".<br />
<br />
<br />
These function types are defined as FP_TAGREAD (read), FP_TAGWRITE (write) in "WMPTSE.h".<br />
<br />
==Definition==<br />
'''Note''' : All types and definition are declared in WMPTSE.h.<br />
It is simple for developper to include it at first.<br />
<br />
For reading purpose, we will expose the necessary structure definition here.<br />
<br />
struct stTagItem <br />
{<br />
char * MetaTagWMPKey; /** the MediaLibrary attribute's name */<br />
LPTSTR MetaTagValue; /** the value to set */<br />
};<br />
#define TAGITEM struct stTagItem <br />
typedef struct stTagItem * LPTAGITEM; <br />
<br />
struct stMetaTag<br />
{<br />
UINT uiNbItems; /** number of list tags */<br />
LPTAGITEM tagiItems; /** pointer to array of pointer to tag items */<br />
};<br />
#define METATAG struct stMetaTag<br />
typedef struct stMetaTag * LPMETATAG;<br />
<br />
<br />
==Example Source Code==<br />
In this example, we will add support for a weird tag format : the "Sting fan" format.<br />
In fact, every file considered tagged with this format will return "Sting" as Album Artist. The sign of a true fan :)<br />
<br />
<br />
'''Note''' : We will not create the write function as it is a "read only" tag format.<br />
<br />
<br />
Let's see the documented code :<br />
<br />
/////////////////////////////////////////////////////////////////////////////<br />
//<br />
// StingTagSupport.c : <br />
// Handler for Sting tags support<br />
//<br />
// Copyxxx (\C) 200x - <br />
// <br />
/////////////////////////////////////////////////////////////////////////////<br />
#define STING_TAGSUPPORT_C<br />
#include "StingTagSupport.h"<br />
#undef STING_TAGSUPPORT_C<br />
<br />
<br />
BOOL STINGTAG_API ReadStingTag<br />
( <br />
LPTSTR lpstrFileFullPath, <br />
METATAG * pMetaTag <br />
) <br />
{<br />
UINT uiFilePathSize;<br />
LPSTR lpcFileFullPath;<br />
LPVOID lpvTempPtr;<br />
<br />
//First we get the filepath length before retrieving it<br />
uiFilePathSize = WideCharToMultiByte<br />
(<br />
CP_ACP,<br />
0,<br />
lpstrFileFullPath,<br />
-1,<br />
NULL,<br />
0,<br />
NULL,<br />
NULL<br />
);<br />
//then we alloc on the process Heap the memory<br />
lpcFileFullPath = ( LPSTR ) HeapAlloc<br />
(<br />
GetProcessHeap(), <br />
HEAP_ZERO_MEMORY,<br />
uiFilePathSize<br />
);<br />
//and we retrieve the filepath<br />
WideCharToMultiByte<br />
(<br />
CP_ACP,<br />
0,<br />
lpstrFileFullPath,<br />
-1,<br />
lpcFileFullPath,<br />
uiFilePathSize,<br />
NULL,<br />
NULL<br />
); <br />
<br />
//now, we fill the MetaTag structure with start values<br />
//at start we don't have any Tags..<br />
pMetaTag->uiNbItems = 0;<br />
//at start we need to have a "root" TAGITEM table so we alloc it<br />
pMetaTag->tagiItems = ( LPTAGITEM )HeapAlloc<br />
( <br />
GetProcessHeap(), <br />
HEAP_ZERO_MEMORY, <br />
sizeof( TAGITEM )<br />
);<br />
<br />
//We will handles just Album Artist (it should be enough for an example)<br />
//first we resize our previous TAGITEM table<br />
lpvTempPtr = ( LPTAGITEM )HeapReAlloc<br />
( <br />
GetProcessHeap(), <br />
HEAP_ZERO_MEMORY, <br />
pMetaTag->tagiItems,<br />
sizeof( TAGITEM ) * ( pMetaTag->uiNbItems + 1 )<br />
);<br />
if( lpvTempPtr == NULL )<br />
// we handle a worse case scenario<br />
return FALSE;<br />
<br />
//we replace with the new pointer (if it has changed)<br />
pMetaTag->tagiItems = lpvTempPtr;<br />
<br />
//we alloc the new string to store our tag value<br />
//it will be freed by WMPTSE, so be sure to have it alloced yourself.<br />
//(no static string...)<br />
pMetaTag->tagiItems[ pMetaTag->uiNbItems ].MetaTagValue = HeapAlloc<br />
(<br />
GetProcessHeap(),<br />
HEAP_ZERO_MEMORY,<br />
sizeof( TCHAR ) * ( lstrlen( STING_FAN_ARTIST ) + 1 )<br />
);<br />
//we copy the tag value<br />
lstrcpy( pMetaTag->tagiItems[ pMetaTag->uiNbItems ].MetaTagValue, STING_FAN_ARTIST );<br />
//we give WMPTSE the right tag Key (it must be a WMP_TAG_ string, see WMPTSE.h)<br />
pMetaTag->tagiItems[ pMetaTag->uiNbItems ].MetaTagWMPKey = WMP_TAG_ALBUMARTIST;<br />
//we increase our tagitem number<br />
pMetaTag->uiNbItems++;<br />
<br />
<br />
//all is finished, we can release the filepath string <br />
HeapFree( GetProcessHeap(), 0, lpcFileFullPath );<br />
<br />
return TRUE;<br />
}<br />
<br />
BOOL STINGTAG_API WriteStingTag<br />
( <br />
LPTSTR lpstrFileFullPath, <br />
TAGITEM tagiChangedItem <br />
)<br />
{<br />
return TRUE;<br />
}<br />
<br />
And the nice header to go with it<br />
<br />
/////////////////////////////////////////////////////////////////////////////<br />
//<br />
// StingTagSupport.h : <br />
// Handler header for Sting tags support<br />
//<br />
// Copyxxx (\C) 200x - <br />
// <br />
/////////////////////////////////////////////////////////////////////////////<br />
#ifndef STING_TAG_SUPPORT_H<br />
#define STING_TAG_SUPPORT_H<br />
<br />
<br />
#define WIN32_LEAN_AND_MEAN<br />
#define UNICODE<br />
#include <windows.h><br />
<br />
#include "WMPTSE.h"<br />
<br />
#ifdef STING_TAGSUPPORT_C<br />
<br />
<br />
#define STING_FAN_ARTIST TCHAR( "Sting" )<br />
<br />
<br />
#ifdef _USRDLL<br />
#define STINGTAG_API __declspec( dllexport )<br />
#else<br />
#define STINGTAG_API <br />
#endif<br />
<br />
#else<br />
<br />
#ifdef _USRDLL<br />
#define STINGTAG_API extern __declspec( dllimport )<br />
#elif defined( _EXPORTDLL )<br />
#define STINGTAG_API extern __declspec( dllexport )<br />
#else<br />
#define STINGTAG_API extern<br />
#endif<br />
<br />
#endif <br />
<br />
<br />
//<br />
// TODO : add your exportable function declaration here<br />
//<br />
// WMPTSE TagSupport API<br />
BOOL STINGTAG_API ReadStingTag<br />
( <br />
LPTSTR lpstrFileFullPath, <br />
METATAG * pMetaTag <br />
);<br />
<br />
BOOL STINGTAG_API WriteStingTag<br />
( <br />
LPTSTR lpstrFileFullPath, <br />
TAGITEM tagiChangedItem <br />
);<br />
<br />
<br />
#endif STING_TAG_SUPPORT_H<br />
<br />
==Installation==<br />
To be effective, a "tag support dll" must be correctly installed in WMPTSE.<br />
<br />
You have two choice to install a "tag support dll" :<br />
* use the WMPTSE tag support wizard (see [[WMPTSE - How to add support for a tag format]])<br />
* edit the registry yourself :<br />
<br />
<br />
'''Note''' : In this guide, we will not expose the registry editing for complete file type support in Windows (MIME Types, Media Library Support, etc...). Please refer to Microsoft Windows Media Player documentation for this.<br />
<br />
<br />
On load, [[WMPTSE]] browse the '''HKEY_LOCAL_MACHINE\SOFTWARE\piPOol\WMPTSE''' registry key.<br />
<br />
Each subkey it finds will be consider a <font style="color:green"><TagFormat></font> definition.<br />
<br />
Inside each subkey (or <font style="color:green"><TagFormat></font> definition), WMPTSE browse for file type support.<br />
<br />
Each string in '''HKEY_LOCAL_MACHINE\SOFTWARE\piPOol\WMPTSE\<font style="color:green"><TagFormat></font>''' describe the file type to support (registry string name) and the path to the "tag support dll" to load (registry string value).<br />
<br />
After reading all file types definitions, [[WMPTSE]] loads each "tag support dll" and try to get the '''Read<font style="color:green"><TagFormat></font>Tag''' and '''Write<font style="color:green"><TagFormat></font>Tag''' functions.<br />
<br />
For each dll, If one of those two functions doesn't exist, the dll is considered non-WMPTSE API compatible and is unloaded.<br />
<br />
It those two functions exist, the dll is registered as a "tag support dll" for the registered file type.<br />
<br />
[[Category:Technical]]<br />
[[Category:Software]]</div>MaB frhttps://wiki.hydrogenaud.io/index.php?title=WMPTSE_APIWMPTSE API2006-11-21T13:50:41Z<p>MaB fr: /* Example Source Code */</p>
<hr />
<div>The WMPTSE API is the interface between the [[WMPTSE]] plug-in and its "tag support dll".<br />
<br />
A '''tag support dll''' give WMPTSE the ability to add support of a tag format in Windows Media Player. <br />
With the this "tag support dll" properly installed, files tagged with its format are readable inside WMP.<br />
<br />
<br />
==API==<br />
Every WMPTSE API application must export two function (c standard call):<br />
<br />
BOOL Read<font style="color:green"><TagFormat></font>Tag( LPTSTR lpstrFileFullPath, METATAG * pMetaTag )<br />
<br />
BOOL Write<font style="color:green"><TagFormat></font>Tag( LPTSTR lpstrFileFullPath, TAGITEM tagiChangedItem )<br />
<br />
<font style="color:green"><TagFormat></font> will be the name of the corresponding tag format (APE, Vorbis, MPEG4 for example). <br />
The complete function names will be search by WMPTSE during the load process. <br />
<br />
<br />
The boolean return value is important.<br />
<br />
For the read function, it tells WMPTSE if the "tag support dll" has find the correct tag format structures (even if they are empty). If the value is TRUE, WMPTSE will stop searching for compatible tag format for this file (yes, a file can be multi-tagged). If the value is FALSE, WMPTSE will continue searching in its compatible tag format list.<br />
<br />
For the write function, it tells WMPTSE if the "tag support dll" has correctly write the new value. If this is true, WMPTSE will continue using this "tag support dll" for this filetype. If this value is false, WMPTSE may unload the "tag support dll".<br />
<br />
<br />
These function types are defined as FP_TAGREAD (read), FP_TAGWRITE (write) in "WMPTSE.h".<br />
<br />
==Definition==<br />
'''Note''' : All types and definition are declared in WMPTSE.h.<br />
It is simple for developper to include it at first.<br />
<br />
For reading purpose, we will expose the necessary structure definition here.<br />
<br />
struct stTagItem <br />
{<br />
char * MetaTagWMPKey; /** the MediaLibrary attribute's name */<br />
LPTSTR MetaTagValue; /** the value to set */<br />
};<br />
#define TAGITEM struct stTagItem <br />
typedef struct stTagItem * LPTAGITEM; <br />
<br />
struct stMetaTag<br />
{<br />
UINT uiNbItems; /** number of list tags */<br />
LPTAGITEM tagiItems; /** pointer to array of pointer to tag items */<br />
};<br />
#define METATAG struct stMetaTag<br />
typedef struct stMetaTag * LPMETATAG;<br />
<br />
<br />
==Example Source Code==<br />
In this example, we will add support for a weird tag format : the "Sting fan" format.<br />
In fact, every file considered tagged with this format will return "Sting" as Album Artist. The sign of a true fan :)<br />
<br />
<br />
'''Note''' : We will not create the write function as it is a "read only" tag format.<br />
<br />
<br />
Let's see the documented code :<br />
<br />
/////////////////////////////////////////////////////////////////////////////<br />
//<br />
// StingTagSupport.c : <br />
// Handler for Sting tags support<br />
//<br />
// Copyxxx (\C) 200x - <br />
// <br />
/////////////////////////////////////////////////////////////////////////////<br />
#define STING_TAGSUPPORT_C<br />
#include "StingTagSupport.h"<br />
#undef STING_TAGSUPPORT_C<br />
<br />
<br />
BOOL STINGTAG_API ReadStingTag<br />
( <br />
LPTSTR lpstrFileFullPath, <br />
METATAG * pMetaTag <br />
) <br />
{<br />
UINT uiFilePathSize;<br />
LPSTR lpcFileFullPath;<br />
LPVOID lpvTempPtr;<br />
<br />
//First we get the filepath length before retrieving it<br />
uiFilePathSize = WideCharToMultiByte<br />
(<br />
CP_ACP,<br />
0,<br />
lpstrFileFullPath,<br />
-1,<br />
NULL,<br />
0,<br />
NULL,<br />
NULL<br />
);<br />
//then we alloc on the process Heap the memory<br />
lpcFileFullPath = ( LPSTR ) HeapAlloc<br />
(<br />
GetProcessHeap(), <br />
HEAP_ZERO_MEMORY,<br />
uiFilePathSize<br />
);<br />
//and we retrieve the filepath<br />
WideCharToMultiByte<br />
(<br />
CP_ACP,<br />
0,<br />
lpstrFileFullPath,<br />
-1,<br />
lpcFileFullPath,<br />
uiFilePathSize,<br />
NULL,<br />
NULL<br />
); <br />
<br />
//now, we fill the MetaTag structure with start values<br />
//at start we don't have any Tags..<br />
pMetaTag->uiNbItems = 0;<br />
//at start we need to have a "root" TAGITEM table so we alloc it<br />
pMetaTag->tagiItems = ( LPTAGITEM )HeapAlloc<br />
( <br />
GetProcessHeap(), <br />
HEAP_ZERO_MEMORY, <br />
sizeof( TAGITEM )<br />
);<br />
<br />
//We will handles just Album Artist (it should be enough for an example)<br />
//first we resize our previous TAGITEM table<br />
lpvTempPtr = ( LPTAGITEM )HeapReAlloc<br />
( <br />
GetProcessHeap(), <br />
HEAP_ZERO_MEMORY, <br />
pMetaTag->tagiItems,<br />
sizeof( TAGITEM ) * ( pMetaTag->uiNbItems + 1 )<br />
);<br />
if( lpvTempPtr == NULL )<br />
// we handle a worse case scenario<br />
return FALSE;<br />
<br />
//we replace with the new pointer (if it has changed)<br />
pMetaTag->tagiItems = lpvTempPtr;<br />
<br />
//we alloc the new string to store our tag value<br />
//it will be freed by WMPTSE, so be sure to have it alloced yourself.<br />
//(no static string...)<br />
pMetaTag->tagiItems[ pMetaTag->uiNbItems ].MetaTagValue = HeapAlloc<br />
(<br />
GetProcessHeap(),<br />
HEAP_ZERO_MEMORY,<br />
sizeof( TCHAR ) * ( lstrlen( STING_FAN_ARTIST ) + 1 )<br />
);<br />
//we copy the tag value<br />
lstrcpy( pMetaTag->tagiItems[ pMetaTag->uiNbItems ].MetaTagValue, STING_FAN_ARTIST );<br />
//we give WMPTSE the right tag Key (it must be a WMP_TAG_ string, see WMPTSE.h)<br />
pMetaTag->tagiItems[ pMetaTag->uiNbItems ].MetaTagWMPKey = WMP_TAG_ALBUMARTIST;<br />
//we increase our tagitem number<br />
pMetaTag->uiNbItems++;<br />
<br />
<br />
//all is finished, we can release the filepath string <br />
HeapFree( GetProcessHeap(), 0, lpcFileFullPath );<br />
<br />
return TRUE;<br />
}<br />
<br />
BOOL STINGTAG_API WriteStingTag<br />
( <br />
LPTSTR lpstrFileFullPath, <br />
TAGITEM tagiChangedItem <br />
)<br />
{<br />
return TRUE;<br />
}<br />
<br />
And the nice header to go with it<br />
<br />
#ifndef STING_TAG_SUPPORT_H<br />
#define STING_TAG_SUPPORT_H<br />
<br />
<br />
#define WIN32_LEAN_AND_MEAN<br />
#define UNICODE<br />
#include <windows.h><br />
<br />
#include "WMPTSE.h"<br />
<br />
#ifdef STING_TAGSUPPORT_C<br />
<br />
<br />
#define STING_FAN_ARTIST TCHAR( "Sting" )<br />
<br />
<br />
#ifdef _USRDLL<br />
#define STINGTAG_API __declspec( dllexport )<br />
#else<br />
#define STINGTAG_API <br />
#endif<br />
<br />
#else<br />
<br />
#ifdef _USRDLL<br />
#define STINGTAG_API extern __declspec( dllimport )<br />
#elif defined( _EXPORTDLL )<br />
#define STINGTAG_API extern __declspec( dllexport )<br />
#else<br />
#define STINGTAG_API extern<br />
#endif<br />
<br />
#endif <br />
<br />
<br />
//<br />
// TODO : add your exportable function declaration here<br />
//<br />
// WMPTSE TagSupport API<br />
BOOL STINGTAG_API ReadStingTag<br />
( <br />
LPTSTR lpstrFileFullPath, <br />
METATAG * pMetaTag <br />
);<br />
<br />
BOOL STINGTAG_API WriteStingTag<br />
( <br />
LPTSTR lpstrFileFullPath, <br />
TAGITEM tagiChangedItem <br />
);<br />
<br />
<br />
#endif STING_TAG_SUPPORT_H<br />
<br />
==Installation==<br />
To be effective, a "tag support dll" must be correctly installed in WMPTSE.<br />
<br />
You have two choice to install a "tag support dll" :<br />
* use the WMPTSE tag support wizard (see [[WMPTSE - How to add support for a tag format]])<br />
* edit the registry yourself :<br />
<br />
<br />
'''Note''' : In this guide, we will not expose the registry editing for complete file type support in Windows (MIME Types, Media Library Support, etc...). Please refer to Microsoft Windows Media Player documentation for this.<br />
<br />
<br />
On load, [[WMPTSE]] browse the '''HKEY_LOCAL_MACHINE\SOFTWARE\piPOol\WMPTSE''' registry key.<br />
<br />
Each subkey it finds will be consider a <font style="color:green"><TagFormat></font> definition.<br />
<br />
Inside each subkey (or <font style="color:green"><TagFormat></font> definition), WMPTSE browse for file type support.<br />
<br />
Each string in '''HKEY_LOCAL_MACHINE\SOFTWARE\piPOol\WMPTSE\<font style="color:green"><TagFormat></font>''' describe the file type to support (registry string name) and the path to the "tag support dll" to load (registry string value).<br />
<br />
After reading all file types definitions, [[WMPTSE]] loads each "tag support dll" and try to get the '''Read<font style="color:green"><TagFormat></font>Tag''' and '''Write<font style="color:green"><TagFormat></font>Tag''' functions.<br />
<br />
For each dll, If one of those two functions doesn't exist, the dll is considered non-WMPTSE API compatible and is unloaded.<br />
<br />
It those two functions exist, the dll is registered as a "tag support dll" for the registered file type.<br />
<br />
[[Category:Technical]]<br />
[[Category:Software]]</div>MaB frhttps://wiki.hydrogenaud.io/index.php?title=WMPTSE_APIWMPTSE API2006-11-21T13:49:29Z<p>MaB fr: /* Example Source Code */</p>
<hr />
<div>The WMPTSE API is the interface between the [[WMPTSE]] plug-in and its "tag support dll".<br />
<br />
A '''tag support dll''' give WMPTSE the ability to add support of a tag format in Windows Media Player. <br />
With the this "tag support dll" properly installed, files tagged with its format are readable inside WMP.<br />
<br />
<br />
==API==<br />
Every WMPTSE API application must export two function (c standard call):<br />
<br />
BOOL Read<font style="color:green"><TagFormat></font>Tag( LPTSTR lpstrFileFullPath, METATAG * pMetaTag )<br />
<br />
BOOL Write<font style="color:green"><TagFormat></font>Tag( LPTSTR lpstrFileFullPath, TAGITEM tagiChangedItem )<br />
<br />
<font style="color:green"><TagFormat></font> will be the name of the corresponding tag format (APE, Vorbis, MPEG4 for example). <br />
The complete function names will be search by WMPTSE during the load process. <br />
<br />
<br />
The boolean return value is important.<br />
<br />
For the read function, it tells WMPTSE if the "tag support dll" has find the correct tag format structures (even if they are empty). If the value is TRUE, WMPTSE will stop searching for compatible tag format for this file (yes, a file can be multi-tagged). If the value is FALSE, WMPTSE will continue searching in its compatible tag format list.<br />
<br />
For the write function, it tells WMPTSE if the "tag support dll" has correctly write the new value. If this is true, WMPTSE will continue using this "tag support dll" for this filetype. If this value is false, WMPTSE may unload the "tag support dll".<br />
<br />
<br />
These function types are defined as FP_TAGREAD (read), FP_TAGWRITE (write) in "WMPTSE.h".<br />
<br />
==Definition==<br />
'''Note''' : All types and definition are declared in WMPTSE.h.<br />
It is simple for developper to include it at first.<br />
<br />
For reading purpose, we will expose the necessary structure definition here.<br />
<br />
struct stTagItem <br />
{<br />
char * MetaTagWMPKey; /** the MediaLibrary attribute's name */<br />
LPTSTR MetaTagValue; /** the value to set */<br />
};<br />
#define TAGITEM struct stTagItem <br />
typedef struct stTagItem * LPTAGITEM; <br />
<br />
struct stMetaTag<br />
{<br />
UINT uiNbItems; /** number of list tags */<br />
LPTAGITEM tagiItems; /** pointer to array of pointer to tag items */<br />
};<br />
#define METATAG struct stMetaTag<br />
typedef struct stMetaTag * LPMETATAG;<br />
<br />
<br />
==Example Source Code==<br />
In this example, we will add support for a weird tag format : the "Sting fan" format.<br />
In fact, every file considered tagged with this format will return "Sting" as Album Artist. The sign of a true fan :)<br />
<br />
<br />
'''Note''' : We will not create the write function as it is a "read only" tag format.<br />
<br />
<br />
Let's see the documented code :<br />
<br />
/////////////////////////////////////////////////////////////////////////////<br />
//<br />
// StingTagSupport.c : <br />
// Handler for Sting tags support<br />
//<br />
// Copyxxx (\C) 200x - <br />
// <br />
/////////////////////////////////////////////////////////////////////////////<br />
#define STING_TAGSUPPORT_C<br />
#include "StingTagSupport.h"<br />
#undef STING_TAGSUPPORT_C<br />
<br />
<br />
#define STING_FAN_ARTIST TCHAR( "Sting" )<br />
<br />
<br />
BOOL STINGTAG_API ReadStingTag<br />
( <br />
LPTSTR lpstrFileFullPath, <br />
METATAG * pMetaTag <br />
) <br />
{<br />
UINT uiFilePathSize;<br />
LPSTR lpcFileFullPath;<br />
LPVOID lpvTempPtr;<br />
<br />
//First we get the filepath length before retrieving it<br />
uiFilePathSize = WideCharToMultiByte<br />
(<br />
CP_ACP,<br />
0,<br />
lpstrFileFullPath,<br />
-1,<br />
NULL,<br />
0,<br />
NULL,<br />
NULL<br />
);<br />
//then we alloc on the process Heap the memory<br />
lpcFileFullPath = ( LPSTR ) HeapAlloc<br />
(<br />
GetProcessHeap(), <br />
HEAP_ZERO_MEMORY,<br />
uiFilePathSize<br />
);<br />
//and we retrieve the filepath<br />
WideCharToMultiByte<br />
(<br />
CP_ACP,<br />
0,<br />
lpstrFileFullPath,<br />
-1,<br />
lpcFileFullPath,<br />
uiFilePathSize,<br />
NULL,<br />
NULL<br />
); <br />
<br />
//now, we fill the MetaTag structure with start values<br />
//at start we don't have any Tags..<br />
pMetaTag->uiNbItems = 0;<br />
//at start we need to have a "root" TAGITEM table so we alloc it<br />
pMetaTag->tagiItems = ( LPTAGITEM )HeapAlloc<br />
( <br />
GetProcessHeap(), <br />
HEAP_ZERO_MEMORY, <br />
sizeof( TAGITEM )<br />
);<br />
<br />
//We will handles just Album Artist (it should be enough for an example)<br />
//first we resize our previous TAGITEM table<br />
lpvTempPtr = ( LPTAGITEM )HeapReAlloc<br />
( <br />
GetProcessHeap(), <br />
HEAP_ZERO_MEMORY, <br />
pMetaTag->tagiItems,<br />
sizeof( TAGITEM ) * ( pMetaTag->uiNbItems + 1 )<br />
);<br />
if( lpvTempPtr == NULL )<br />
// we handle a worse case scenario<br />
return FALSE;<br />
<br />
//we replace with the new pointer (if it has changed)<br />
pMetaTag->tagiItems = lpvTempPtr;<br />
<br />
//we alloc the new string to store our tag value<br />
//it will be freed by WMPTSE, so be sure to have it alloced yourself.<br />
//(no static string...)<br />
pMetaTag->tagiItems[ pMetaTag->uiNbItems ].MetaTagValue = HeapAlloc<br />
(<br />
GetProcessHeap(),<br />
HEAP_ZERO_MEMORY,<br />
sizeof( TCHAR ) * ( lstrlen( STING_FAN_ARTIST ) + 1 )<br />
);<br />
//we copy the tag value<br />
lstrcpy( pMetaTag->tagiItems[ pMetaTag->uiNbItems ].MetaTagValue, STING_FAN_ARTIST );<br />
//we give WMPTSE the right tag Key (it must be a WMP_TAG_ string, see WMPTSE.h)<br />
pMetaTag->tagiItems[ pMetaTag->uiNbItems ].MetaTagWMPKey = WMP_TAG_ALBUMARTIST;<br />
//we increase our tagitem number<br />
pMetaTag->uiNbItems++;<br />
<br />
<br />
//all is finished, we can release the filepath string <br />
HeapFree( GetProcessHeap(), 0, lpcFileFullPath );<br />
<br />
return TRUE;<br />
}<br />
<br />
BOOL STINGTAG_API WriteStingTag<br />
( <br />
LPTSTR lpstrFileFullPath, <br />
TAGITEM tagiChangedItem <br />
)<br />
{<br />
return TRUE;<br />
}<br />
<br />
And the nice header to go with it<br />
<br />
#ifndef STING_TAG_SUPPORT_H<br />
#define STING_TAG_SUPPORT_H<br />
<br />
<br />
#define WIN32_LEAN_AND_MEAN<br />
#define UNICODE<br />
#include <windows.h><br />
<br />
#include "WMPTSE.h"<br />
<br />
#ifdef STING_TAGSUPPORT_C<br />
<br />
#ifdef _USRDLL<br />
#define STINGTAG_API __declspec( dllexport )<br />
#else<br />
#define STINGTAG_API <br />
#endif<br />
<br />
#else<br />
<br />
#ifdef _USRDLL<br />
#define STINGTAG_API extern __declspec( dllimport )<br />
#elif defined( _EXPORTDLL )<br />
#define STINGTAG_API extern __declspec( dllexport )<br />
#else<br />
#define STINGTAG_API extern<br />
#endif<br />
<br />
#endif <br />
<br />
<br />
//<br />
// TODO : add your exportable function declaration here<br />
//<br />
// WMPTSE TagSupport API<br />
BOOL STINGTAG_API ReadStingTag<br />
( <br />
LPTSTR lpstrFileFullPath, <br />
METATAG * pMetaTag <br />
);<br />
<br />
BOOL STINGTAG_API WriteStingTag<br />
( <br />
LPTSTR lpstrFileFullPath, <br />
TAGITEM tagiChangedItem <br />
);<br />
<br />
<br />
#endif STING_TAG_SUPPORT_H<br />
<br />
==Installation==<br />
To be effective, a "tag support dll" must be correctly installed in WMPTSE.<br />
<br />
You have two choice to install a "tag support dll" :<br />
* use the WMPTSE tag support wizard (see [[WMPTSE - How to add support for a tag format]])<br />
* edit the registry yourself :<br />
<br />
<br />
'''Note''' : In this guide, we will not expose the registry editing for complete file type support in Windows (MIME Types, Media Library Support, etc...). Please refer to Microsoft Windows Media Player documentation for this.<br />
<br />
<br />
On load, [[WMPTSE]] browse the '''HKEY_LOCAL_MACHINE\SOFTWARE\piPOol\WMPTSE''' registry key.<br />
<br />
Each subkey it finds will be consider a <font style="color:green"><TagFormat></font> definition.<br />
<br />
Inside each subkey (or <font style="color:green"><TagFormat></font> definition), WMPTSE browse for file type support.<br />
<br />
Each string in '''HKEY_LOCAL_MACHINE\SOFTWARE\piPOol\WMPTSE\<font style="color:green"><TagFormat></font>''' describe the file type to support (registry string name) and the path to the "tag support dll" to load (registry string value).<br />
<br />
After reading all file types definitions, [[WMPTSE]] loads each "tag support dll" and try to get the '''Read<font style="color:green"><TagFormat></font>Tag''' and '''Write<font style="color:green"><TagFormat></font>Tag''' functions.<br />
<br />
For each dll, If one of those two functions doesn't exist, the dll is considered non-WMPTSE API compatible and is unloaded.<br />
<br />
It those two functions exist, the dll is registered as a "tag support dll" for the registered file type.<br />
<br />
[[Category:Technical]]<br />
[[Category:Software]]</div>MaB frhttps://wiki.hydrogenaud.io/index.php?title=WMPTSE_APIWMPTSE API2006-11-21T13:44:29Z<p>MaB fr: /* Example Source Code */</p>
<hr />
<div>The WMPTSE API is the interface between the [[WMPTSE]] plug-in and its "tag support dll".<br />
<br />
A '''tag support dll''' give WMPTSE the ability to add support of a tag format in Windows Media Player. <br />
With the this "tag support dll" properly installed, files tagged with its format are readable inside WMP.<br />
<br />
<br />
==API==<br />
Every WMPTSE API application must export two function (c standard call):<br />
<br />
BOOL Read<font style="color:green"><TagFormat></font>Tag( LPTSTR lpstrFileFullPath, METATAG * pMetaTag )<br />
<br />
BOOL Write<font style="color:green"><TagFormat></font>Tag( LPTSTR lpstrFileFullPath, TAGITEM tagiChangedItem )<br />
<br />
<font style="color:green"><TagFormat></font> will be the name of the corresponding tag format (APE, Vorbis, MPEG4 for example). <br />
The complete function names will be search by WMPTSE during the load process. <br />
<br />
<br />
The boolean return value is important.<br />
<br />
For the read function, it tells WMPTSE if the "tag support dll" has find the correct tag format structures (even if they are empty). If the value is TRUE, WMPTSE will stop searching for compatible tag format for this file (yes, a file can be multi-tagged). If the value is FALSE, WMPTSE will continue searching in its compatible tag format list.<br />
<br />
For the write function, it tells WMPTSE if the "tag support dll" has correctly write the new value. If this is true, WMPTSE will continue using this "tag support dll" for this filetype. If this value is false, WMPTSE may unload the "tag support dll".<br />
<br />
<br />
These function types are defined as FP_TAGREAD (read), FP_TAGWRITE (write) in "WMPTSE.h".<br />
<br />
==Definition==<br />
'''Note''' : All types and definition are declared in WMPTSE.h.<br />
It is simple for developper to include it at first.<br />
<br />
For reading purpose, we will expose the necessary structure definition here.<br />
<br />
struct stTagItem <br />
{<br />
char * MetaTagWMPKey; /** the MediaLibrary attribute's name */<br />
LPTSTR MetaTagValue; /** the value to set */<br />
};<br />
#define TAGITEM struct stTagItem <br />
typedef struct stTagItem * LPTAGITEM; <br />
<br />
struct stMetaTag<br />
{<br />
UINT uiNbItems; /** number of list tags */<br />
LPTAGITEM tagiItems; /** pointer to array of pointer to tag items */<br />
};<br />
#define METATAG struct stMetaTag<br />
typedef struct stMetaTag * LPMETATAG;<br />
<br />
<br />
==Example Source Code==<br />
In this example, we will add support for a weird tag format : the "Sting fan" format.<br />
In fact, every file considered tagged with this format will return "Sting" as Album Artist. The sign of a true fan :)<br />
<br />
<br />
'''Note''' : We will not create the write function as it is a "read only" tag format.<br />
<br />
<br />
Let's see the documented code :<br />
<br />
/////////////////////////////////////////////////////////////////////////////<br />
//<br />
// StingTagSupport.c : <br />
// Handler for Sting tags support<br />
//<br />
// Copyxxx (\C) 200x - <br />
// <br />
/////////////////////////////////////////////////////////////////////////////<br />
#define STING_TAGSUPPORT_C<br />
#include "StingTagSupport.h"<br />
#undef STING_TAGSUPPORT_C<br />
<br />
<br />
#define STING_FAN_ARTIST TCHAR( "Sting" )<br />
<br />
<br />
BOOL FLACTAG_API ReadStingTag<br />
( <br />
LPTSTR lpstrFileFullPath, <br />
METATAG * pMetaTag <br />
) <br />
{<br />
UINT uiFilePathSize;<br />
LPSTR lpcFileFullPath;<br />
LPVOID lpvTempPtr;<br />
<br />
//First we get the filepath length before retrieving it<br />
uiFilePathSize = WideCharToMultiByte<br />
(<br />
CP_ACP,<br />
0,<br />
lpstrFileFullPath,<br />
-1,<br />
NULL,<br />
0,<br />
NULL,<br />
NULL<br />
);<br />
//then we alloc on the process Heap the memory<br />
lpcFileFullPath = ( LPSTR ) HeapAlloc<br />
(<br />
GetProcessHeap(), <br />
HEAP_ZERO_MEMORY,<br />
uiFilePathSize<br />
);<br />
//and we retrieve the filepath<br />
WideCharToMultiByte<br />
(<br />
CP_ACP,<br />
0,<br />
lpstrFileFullPath,<br />
-1,<br />
lpcFileFullPath,<br />
uiFilePathSize,<br />
NULL,<br />
NULL<br />
); <br />
<br />
//now, we fill the MetaTag structure with start values<br />
//at start we don't have any Tags..<br />
pMetaTag->uiNbItems = 0;<br />
//at start we need to have a "root" TAGITEM table so we alloc it<br />
pMetaTag->tagiItems = ( LPTAGITEM )HeapAlloc<br />
( <br />
GetProcessHeap(), <br />
HEAP_ZERO_MEMORY, <br />
sizeof( TAGITEM )<br />
);<br />
<br />
//We will handles just Album Artist (it should be enough for an example)<br />
//first we resize our previous TAGITEM table<br />
lpvTempPtr = ( LPTAGITEM )HeapReAlloc<br />
( <br />
GetProcessHeap(), <br />
HEAP_ZERO_MEMORY, <br />
pMetaTag->tagiItems,<br />
sizeof( TAGITEM ) * ( pMetaTag->uiNbItems + 1 )<br />
);<br />
if( lpvTempPtr == NULL )<br />
// we handle a worse case scenario<br />
return FALSE;<br />
<br />
//we replace with the new pointer (if it has changed)<br />
pMetaTag->tagiItems = lpvTempPtr;<br />
<br />
//we alloc the new string to store our tag value<br />
//it will be freed by WMPTSE, so be sure to have it alloced yourself.<br />
//(no static string...)<br />
pMetaTag->tagiItems[ pMetaTag->uiNbItems ].MetaTagValue = HeapAlloc<br />
(<br />
GetProcessHeap(),<br />
HEAP_ZERO_MEMORY,<br />
sizeof( TCHAR ) * ( lstrlen( STING_FAN_ARTIST ) + 1 )<br />
);<br />
//we copy the tag value<br />
lstrcpy( pMetaTag->tagiItems[ pMetaTag->uiNbItems ].MetaTagValue, STING_FAN_ARTIST );<br />
//we give WMPTSE the right tag Key (it must be a WMP_TAG_ string, see WMPTSE.h)<br />
pMetaTag->tagiItems[ pMetaTag->uiNbItems ].MetaTagWMPKey = WMP_TAG_ALBUMARTIST;<br />
//we increase our tagitem number<br />
pMetaTag->uiNbItems++;<br />
<br />
<br />
//all is finished, we can release the filepath string <br />
HeapFree( GetProcessHeap(), 0, lpcFileFullPath );<br />
<br />
return TRUE;<br />
}<br />
<br />
BOOL FLACTAG_API WriteFLACTag<br />
( <br />
LPTSTR lpstrFileFullPath, <br />
TAGITEM tagiChangedItem <br />
)<br />
{<br />
return TRUE;<br />
}<br />
<br />
==Installation==<br />
To be effective, a "tag support dll" must be correctly installed in WMPTSE.<br />
<br />
You have two choice to install a "tag support dll" :<br />
* use the WMPTSE tag support wizard (see [[WMPTSE - How to add support for a tag format]])<br />
* edit the registry yourself :<br />
<br />
<br />
'''Note''' : In this guide, we will not expose the registry editing for complete file type support in Windows (MIME Types, Media Library Support, etc...). Please refer to Microsoft Windows Media Player documentation for this.<br />
<br />
<br />
On load, [[WMPTSE]] browse the '''HKEY_LOCAL_MACHINE\SOFTWARE\piPOol\WMPTSE''' registry key.<br />
<br />
Each subkey it finds will be consider a <font style="color:green"><TagFormat></font> definition.<br />
<br />
Inside each subkey (or <font style="color:green"><TagFormat></font> definition), WMPTSE browse for file type support.<br />
<br />
Each string in '''HKEY_LOCAL_MACHINE\SOFTWARE\piPOol\WMPTSE\<font style="color:green"><TagFormat></font>''' describe the file type to support (registry string name) and the path to the "tag support dll" to load (registry string value).<br />
<br />
After reading all file types definitions, [[WMPTSE]] loads each "tag support dll" and try to get the '''Read<font style="color:green"><TagFormat></font>Tag''' and '''Write<font style="color:green"><TagFormat></font>Tag''' functions.<br />
<br />
For each dll, If one of those two functions doesn't exist, the dll is considered non-WMPTSE API compatible and is unloaded.<br />
<br />
It those two functions exist, the dll is registered as a "tag support dll" for the registered file type.<br />
<br />
[[Category:Technical]]<br />
[[Category:Software]]</div>MaB frhttps://wiki.hydrogenaud.io/index.php?title=WMPTSE_APIWMPTSE API2006-11-21T13:42:11Z<p>MaB fr: /* Example Source Code */</p>
<hr />
<div>The WMPTSE API is the interface between the [[WMPTSE]] plug-in and its "tag support dll".<br />
<br />
A '''tag support dll''' give WMPTSE the ability to add support of a tag format in Windows Media Player. <br />
With the this "tag support dll" properly installed, files tagged with its format are readable inside WMP.<br />
<br />
<br />
==API==<br />
Every WMPTSE API application must export two function (c standard call):<br />
<br />
BOOL Read<font style="color:green"><TagFormat></font>Tag( LPTSTR lpstrFileFullPath, METATAG * pMetaTag )<br />
<br />
BOOL Write<font style="color:green"><TagFormat></font>Tag( LPTSTR lpstrFileFullPath, TAGITEM tagiChangedItem )<br />
<br />
<font style="color:green"><TagFormat></font> will be the name of the corresponding tag format (APE, Vorbis, MPEG4 for example). <br />
The complete function names will be search by WMPTSE during the load process. <br />
<br />
<br />
The boolean return value is important.<br />
<br />
For the read function, it tells WMPTSE if the "tag support dll" has find the correct tag format structures (even if they are empty). If the value is TRUE, WMPTSE will stop searching for compatible tag format for this file (yes, a file can be multi-tagged). If the value is FALSE, WMPTSE will continue searching in its compatible tag format list.<br />
<br />
For the write function, it tells WMPTSE if the "tag support dll" has correctly write the new value. If this is true, WMPTSE will continue using this "tag support dll" for this filetype. If this value is false, WMPTSE may unload the "tag support dll".<br />
<br />
<br />
These function types are defined as FP_TAGREAD (read), FP_TAGWRITE (write) in "WMPTSE.h".<br />
<br />
==Definition==<br />
'''Note''' : All types and definition are declared in WMPTSE.h.<br />
It is simple for developper to include it at first.<br />
<br />
For reading purpose, we will expose the necessary structure definition here.<br />
<br />
struct stTagItem <br />
{<br />
char * MetaTagWMPKey; /** the MediaLibrary attribute's name */<br />
LPTSTR MetaTagValue; /** the value to set */<br />
};<br />
#define TAGITEM struct stTagItem <br />
typedef struct stTagItem * LPTAGITEM; <br />
<br />
struct stMetaTag<br />
{<br />
UINT uiNbItems; /** number of list tags */<br />
LPTAGITEM tagiItems; /** pointer to array of pointer to tag items */<br />
};<br />
#define METATAG struct stMetaTag<br />
typedef struct stMetaTag * LPMETATAG;<br />
<br />
<br />
==Example Source Code==<br />
In this example, we will add support for a weird tag format : the "Sting fan" format.<br />
In fact, every file considered tagged with this format will return "Sting" for every Tag Key. The sign of a true fan :)<br />
<br />
<br />
'''Note''' : We will not create the write function as it is a "read only" tag format.<br />
<br />
<br />
Let's see the documented code :<br />
<br />
/////////////////////////////////////////////////////////////////////////////<br />
//<br />
// StingTagSupport.c : <br />
// Handler for Sting tags support<br />
//<br />
// Copyxxx (\C) 200x - <br />
// <br />
/////////////////////////////////////////////////////////////////////////////<br />
#define STING_TAGSUPPORT_C<br />
#include "StingTagSupport.h"<br />
#undef STING_TAGSUPPORT_C<br />
<br />
<br />
#define STING_FAN_ARTIST TCHAR( "Sting" )<br />
<br />
<br />
BOOL FLACTAG_API ReadStingTag<br />
( <br />
LPTSTR lpstrFileFullPath, <br />
METATAG * pMetaTag <br />
) <br />
{<br />
UINT uiFilePathSize;<br />
LPSTR lpcFileFullPath;<br />
LPVOID lpvTempPtr;<br />
<br />
//First we get the filepath length before retrieving it<br />
uiFilePathSize = WideCharToMultiByte<br />
(<br />
CP_ACP,<br />
0,<br />
lpstrFileFullPath,<br />
-1,<br />
NULL,<br />
0,<br />
NULL,<br />
NULL<br />
);<br />
//then we alloc on the process Heap the memory<br />
lpcFileFullPath = ( LPSTR ) HeapAlloc<br />
(<br />
GetProcessHeap(), <br />
HEAP_ZERO_MEMORY,<br />
uiFilePathSize<br />
);<br />
//and we retrieve the filepath<br />
WideCharToMultiByte<br />
(<br />
CP_ACP,<br />
0,<br />
lpstrFileFullPath,<br />
-1,<br />
lpcFileFullPath,<br />
uiFilePathSize,<br />
NULL,<br />
NULL<br />
); <br />
<br />
//now, we fill the MetaTag structure with start values<br />
//at start we don't have any Tags..<br />
pMetaTag->uiNbItems = 0;<br />
//at start we need to have a "root" TAGITEM table so we alloc it<br />
pMetaTag->tagiItems = ( LPTAGITEM )HeapAlloc<br />
( <br />
GetProcessHeap(), <br />
HEAP_ZERO_MEMORY, <br />
sizeof( TAGITEM )<br />
);<br />
<br />
//We will handles just Album Artist (it should be enough for an example)<br />
//first we resize our previous TAGITEM table<br />
lpvTempPtr = ( LPTAGITEM )HeapReAlloc<br />
( <br />
GetProcessHeap(), <br />
HEAP_ZERO_MEMORY, <br />
pMetaTag->tagiItems,<br />
sizeof( TAGITEM ) * ( pMetaTag->uiNbItems + 1 )<br />
);<br />
if( lpvTempPtr == NULL )<br />
// we handle a worse case scenario<br />
return FALSE;<br />
<br />
//we replace with the new pointer (if it has changed)<br />
pMetaTag->tagiItems = lpvTempPtr;<br />
<br />
//we alloc the new string to store our tag value<br />
//it will be freed by WMPTSE, so be sure to have it alloced yourself.<br />
//(no static string...)<br />
pMetaTag->tagiItems[ pMetaTag->uiNbItems ].MetaTagValue = HeapAlloc<br />
(<br />
GetProcessHeap(),<br />
HEAP_ZERO_MEMORY,<br />
sizeof( TCHAR ) * ( lstrlen( STING_FAN_ARTIST ) + 1 )<br />
);<br />
//we copy the tag value<br />
lstrcpy( pMetaTag->tagiItems[ pMetaTag->uiNbItems ].MetaTagValue, STING_FAN_ARTIST );<br />
//we give WMPTSE the right tag Key (it must be a WMP_TAG_ string, see WMPTSE.h)<br />
pMetaTag->tagiItems[ pMetaTag->uiNbItems ].MetaTagWMPKey = WMP_TAG_ALBUMARTIST;<br />
//we increase our tagitem number<br />
pMetaTag->uiNbItems++;<br />
<br />
<br />
//all is finished, we can release the filepath string <br />
HeapFree( GetProcessHeap(), 0, lpcFileFullPath );<br />
<br />
return TRUE;<br />
}<br />
<br />
BOOL FLACTAG_API WriteFLACTag<br />
( <br />
LPTSTR lpstrFileFullPath, <br />
TAGITEM tagiChangedItem <br />
)<br />
{<br />
return TRUE;<br />
}<br />
<br />
==Installation==<br />
To be effective, a "tag support dll" must be correctly installed in WMPTSE.<br />
<br />
You have two choice to install a "tag support dll" :<br />
* use the WMPTSE tag support wizard (see [[WMPTSE - How to add support for a tag format]])<br />
* edit the registry yourself :<br />
<br />
<br />
'''Note''' : In this guide, we will not expose the registry editing for complete file type support in Windows (MIME Types, Media Library Support, etc...). Please refer to Microsoft Windows Media Player documentation for this.<br />
<br />
<br />
On load, [[WMPTSE]] browse the '''HKEY_LOCAL_MACHINE\SOFTWARE\piPOol\WMPTSE''' registry key.<br />
<br />
Each subkey it finds will be consider a <font style="color:green"><TagFormat></font> definition.<br />
<br />
Inside each subkey (or <font style="color:green"><TagFormat></font> definition), WMPTSE browse for file type support.<br />
<br />
Each string in '''HKEY_LOCAL_MACHINE\SOFTWARE\piPOol\WMPTSE\<font style="color:green"><TagFormat></font>''' describe the file type to support (registry string name) and the path to the "tag support dll" to load (registry string value).<br />
<br />
After reading all file types definitions, [[WMPTSE]] loads each "tag support dll" and try to get the '''Read<font style="color:green"><TagFormat></font>Tag''' and '''Write<font style="color:green"><TagFormat></font>Tag''' functions.<br />
<br />
For each dll, If one of those two functions doesn't exist, the dll is considered non-WMPTSE API compatible and is unloaded.<br />
<br />
It those two functions exist, the dll is registered as a "tag support dll" for the registered file type.<br />
<br />
[[Category:Technical]]<br />
[[Category:Software]]</div>MaB fr