WMPTSE API - Revision history

MaB fr: /* Definition */

2006-12-16T12:41:47Z

Definition

← Older revision		Revision as of 12:41, 16 December 2006
Line 33:		Line 33:
	==Definition==		==Definition==
	'''Note''' : All types and definition are declared in WMPTSE.h.		'''Note''' : All types and definition are declared in WMPTSE.h.
	It is ~~simple~~ for developper to include it at first.		It is simplier for developper to include it at first.

	For reading purpose, we will expose the necessary structure definition here.		For reading purpose, we will expose the necessary structure definition here.
Line 52:		Line 52:
	#define METATAG struct stMetaTag		#define METATAG struct stMetaTag
	typedef struct stMetaTag * LPMETATAG;		typedef struct stMetaTag * LPMETATAG;


	==Example Source Code==		==Example Source Code==

MaB fr at 15:48, 25 November 2006

2006-11-25T15:48:55Z

← Older revision		Revision as of 15:48, 25 November 2006
Line 12:		Line 12:
	BOOL Write<font style="color:green"><TagFormat></font>Tag( LPTSTR lpstrFileFullPath, TAGITEM tagiChangedItem )		BOOL Write<font style="color:green"><TagFormat></font>Tag( LPTSTR lpstrFileFullPath, TAGITEM tagiChangedItem )

	<font style="color:green"><TagFormat></font> will be the name of the corresponding tag format (APE, Vorbis, MPEG4 for example).		<font style="color:green"><TagFormat></font> will be the name of the corresponding tag format (or tag type) :
			APE, Vorbis, MPEG4 for example.
	The complete function names will be search by WMPTSE during the load process.		The complete function names will be search by WMPTSE during the load process.

Line 18:		Line 19:
	The boolean return value is important.		The boolean return value is important.

	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.		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.

	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".		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".


Line 50:		Line 56:
	==Example Source Code==		==Example Source Code==
	In this example, we will add support for a weird tag format : the "Sting fan" format.		In this example, we will add support for a weird tag format : the "Sting fan" format.
	In fact, every file considered tagged with this format will return "Sting" as Album Artist. The sign of a true fan :)		In fact, every file considered tagged with this format will return "Sting" as Album Artist.
			The sign of a true fan :)

MaB fr: /* Example Source Code */

2006-11-21T13:53:37Z

Example Source Code

← Older revision		Revision as of 13:53, 21 November 2006
Line 199:		Line 199:

	#ifdef _USRDLL		#ifdef _USRDLL
	#define STINGTAG_API __declspec( dllexport )		#define STINGTAG_API __declspec( dllexport )
	#else		#else
	#define STINGTAG_API		#define STINGTAG_API
	#endif		#endif

Line 207:		Line 207:

	#ifdef _USRDLL		#ifdef _USRDLL
	#define STINGTAG_API extern __declspec( dllimport )		#define STINGTAG_API extern __declspec( dllimport )
	#elif defined( _EXPORTDLL )		#elif defined( _EXPORTDLL )
	#define STINGTAG_API extern __declspec( dllexport )		#define STINGTAG_API extern __declspec( dllexport )
	#else		#else
	#define STINGTAG_API extern		#define STINGTAG_API extern
	#endif		#endif

MaB fr: /* Example Source Code */

2006-11-21T13:52:47Z

Example Source Code

← Older revision		Revision as of 13:52, 21 November 2006
Line 222:		Line 222:
	// WMPTSE TagSupport API		// WMPTSE TagSupport API
	BOOL STINGTAG_API ReadStingTag		BOOL STINGTAG_API ReadStingTag
	(		(
	LPTSTR lpstrFileFullPath,		LPTSTR lpstrFileFullPath,
	METATAG * pMetaTag		METATAG * pMetaTag
	);		);

	BOOL STINGTAG_API WriteStingTag		BOOL STINGTAG_API WriteStingTag
	(		(
	LPTSTR lpstrFileFullPath,		LPTSTR lpstrFileFullPath,
	TAGITEM tagiChangedItem		TAGITEM tagiChangedItem
	);		);

MaB fr: /* Example Source Code */

2006-11-21T13:51:58Z

Example Source Code

← Older revision		Revision as of 13:51, 21 November 2006
Line 174:		Line 174:
	And the nice header to go with it		And the nice header to go with it

			/////////////////////////////////////////////////////////////////////////////
			//
			// StingTagSupport.h :
			// Handler header for Sting tags support
			//
			// Copyxxx (\C) 200x -
			//
			/////////////////////////////////////////////////////////////////////////////
	#ifndef STING_TAG_SUPPORT_H		#ifndef STING_TAG_SUPPORT_H
	#define STING_TAG_SUPPORT_H		#define STING_TAG_SUPPORT_H
Line 190:		Line 198:


	#ifdef _USRDLL		#ifdef _USRDLL
	#define STINGTAG_API __declspec( dllexport )		#define STINGTAG_API __declspec( dllexport )
	#else		#else

MaB fr: /* Example Source Code */

2006-11-21T13:50:41Z

Example Source Code

← Older revision		Revision as of 13:50, 21 November 2006
Line 69:		Line 69:
	#include "StingTagSupport.h"		#include "StingTagSupport.h"
	#undef STING_TAGSUPPORT_C		#undef STING_TAGSUPPORT_C


	~~#define STING_FAN_ARTIST TCHAR( "Sting" )~~


Line 189:		Line 186:
	#ifdef STING_TAGSUPPORT_C		#ifdef STING_TAGSUPPORT_C

	#ifdef _USRDLL
			#define STING_FAN_ARTIST TCHAR( "Sting" )


			#ifdef _USRDLL
	#define STINGTAG_API __declspec( dllexport )		#define STINGTAG_API __declspec( dllexport )
	#else		#else

MaB fr: /* Example Source Code */

2006-11-21T13:49:29Z

Example Source Code

@@ Line 74: / Line 74: @@
-  BOOL FLACTAG_API			ReadStingTag
+  BOOL STINGTAG_API			ReadStingTag
+  (
   	LPTSTR					lpstrFileFullPath,
@@ Line 166: / Line 166: @@
+  }
-  BOOL FLACTAG_API			WriteFLACTag
+  BOOL STINGTAG_API			WriteStingTag
+  (
   	LPTSTR					lpstrFileFullPath,
@@ Line 174: / Line 174: @@
   	return TRUE;
+  }
 ==Installation==

MaB fr: /* Example Source Code */

2006-11-21T13:44:29Z

Example Source Code

← Older revision		Revision as of 13:44, 21 November 2006
Line 50:		Line 50:
	==Example Source Code==		==Example Source Code==
	In this example, we will add support for a weird tag format : the "Sting fan" format.		In this example, we will add support for a weird tag format : the "Sting fan" format.
	In fact, every file considered tagged with this format will return "Sting" ~~for every Tag Key~~. The sign of a true fan :)		In fact, every file considered tagged with this format will return "Sting" as Album Artist. The sign of a true fan :)

MaB fr: /* Example Source Code */

2006-11-21T13:42:11Z

Example Source Code

← Older revision		Revision as of 13:42, 21 November 2006
Line 80:		Line 80:
	)		)
	{		{
	UINT uiFilePathSize;		UINT uiFilePathSize;
	LPSTR lpcFileFullPath;		LPSTR lpcFileFullPath;
	LPVOID lpvTempPtr;		LPVOID lpvTempPtr;

MaB fr: /* Example Source Code */

2006-11-21T13:41:40Z

Example Source Code

← Older revision		Revision as of 13:41, 21 November 2006
Line 66:		Line 66:
	//		//
	/////////////////////////////////////////////////////////////////////////////		/////////////////////////////////////////////////////////////////////////////
	#define STING_TAGSUPPORT_C		#define STING_TAGSUPPORT_C
	#include "StingTagSupport.h"		#include "StingTagSupport.h"
	#undef STING_TAGSUPPORT_C		#undef STING_TAGSUPPORT_C
Line 74:		Line 74:


	BOOL FLACTAG_API ~~ReadFLACTag~~		BOOL FLACTAG_API ReadStingTag
	(		(
	LPTSTR lpstrFileFullPath,		LPTSTR lpstrFileFullPath,
	METATAG * pMetaTag		METATAG * pMetaTag
	)		)
	{		{
	UINT uiFilePathSize;		UINT uiFilePathSize;
	LPSTR lpcFileFullPath;		LPSTR lpcFileFullPath;
	LPVOID lpvTempPtr;		LPVOID lpvTempPtr;

Line 163:		Line 163:
	HeapFree( GetProcessHeap(), 0, lpcFileFullPath );		HeapFree( GetProcessHeap(), 0, lpcFileFullPath );

			return TRUE;
			}

			BOOL FLACTAG_API WriteFLACTag
			(
			LPTSTR lpstrFileFullPath,
			TAGITEM tagiChangedItem
			)
			{
	return TRUE;		return TRUE;
	}		}