metadb_io_v2 Class Reference

#include <metadb.h>

Inheritance diagram for metadb_io_v2:

List of all members.

Public Types
enum	{ op_flag_no_errors = 1 << 0, op_flag_background = 1 << 1, op_flag_delay_ui = 1 << 2 }
typedef metadb_io_v2	t_interface
typedef metadb_io	t_interface_parent
Public Member Functions
virtual void	load_info_async (metadb_handle_list_cref p_list, t_load_info_type p_type, HWND p_parent_window, t_uint32 p_op_flags, completion_notify_ptr p_notify)=0
virtual void	update_info_async (metadb_handle_list_cref p_list, service_ptr_t< file_info_filter > p_filter, HWND p_parent_window, t_uint32 p_op_flags, completion_notify_ptr p_notify)=0
virtual void	rewrite_info_async (metadb_handle_list_cref p_list, HWND p_parent_window, t_uint32 p_op_flags, completion_notify_ptr p_notify)=0
virtual void	remove_info_async (metadb_handle_list_cref p_list, HWND p_parent_window, t_uint32 p_op_flags, completion_notify_ptr p_notify)=0
virtual metadb_hint_list::ptr	create_hint_list ()=0
	Creates a metadb_hint_list object.
void	update_info_async_simple (metadb_handle_list_cref p_list, const pfc::list_base_const_t< const file_info * > &p_new_info, HWND p_parent_window, t_uint32 p_op_flags, completion_notify_ptr p_notify)
Static Public Attributes
static const GUID	class_guid = { 0x265c4ece, 0xffb2, 0x4299, { 0x91, 0xb5, 0x6c, 0xa6, 0x60, 0x3d, 0xa1, 0x53 } }

---

Detailed Description

Extends metadb_io functionality with nonblocking versions of tag read/write functions, and some other utility features.

Since:

0.9.3

---

Member Typedef Documentation

typedef metadb_io_v2 metadb_io_v2::t_interface

Reimplemented from metadb_io.

Reimplemented in metadb_io_v3.

typedef metadb_io metadb_io_v2::t_interface_parent

Reimplemented from metadb_io.

Reimplemented in metadb_io_v3.

---

Member Enumeration Documentation

anonymous enum

Enumerator:

op_flag_no_errors	By default, when some part of requested operation could not be performed for reasons other than user abort, a popup dialog with description of the problem is spawned. Set this flag to disable error notification.
op_flag_background	Set this flag to make the progress dialog not steal focus on creation.
op_flag_delay_ui	Set this flag to delay the progress dialog becoming visible, so it does not appear at all during short operations. Also implies op_flag_background effect.

---

Member Function Documentation

virtual void metadb_io_v2::load_info_async	(	metadb_handle_list_cref	p_list,
		t_load_info_type	p_type,
		HWND	p_parent_window,
		t_uint32	p_op_flags,
		completion_notify_ptr	p_notify
	)			[pure virtual]

Preloads information from the specified tracks.

Parameters:

	p_list	List of items to process.
	p_op_flags	Can be null, or one or more of op_flag_* enum values combined, altering behaviors of the operation.
	p_notify	Called when the task is completed. Status code is one of t_load_info_state values. Can be null if caller doesn't care.

virtual void metadb_io_v2::update_info_async	(	metadb_handle_list_cref	p_list,
		service_ptr_t< file_info_filter >	p_filter,
		HWND	p_parent_window,
		t_uint32	p_op_flags,
		completion_notify_ptr	p_notify
	)			[pure virtual]

Updates tags of the specified tracks.

Parameters:

	p_list	List of items to process.
	p_op_flags	Can be null, or one or more of op_flag_* enum values combined, altering behaviors of the operation.
	p_notify	Called when the task is completed. Status code is one of t_update_info values. Can be null if caller doesn't care.
	p_filter	Callback handling actual file_info alterations. Typically used to replace entire meta part of file_info, or to alter something else such as ReplayGain while leaving meta intact.

virtual void metadb_io_v2::rewrite_info_async	(	metadb_handle_list_cref	p_list,
		HWND	p_parent_window,
		t_uint32	p_op_flags,
		completion_notify_ptr	p_notify
	)			[pure virtual]

Rewrites tags of the specified tracks; similar to update_info_async() but using last known/cached file_info values rather than values passed by caller.

Parameters:

	p_list	List of items to process.
	p_op_flags	Can be null, or one or more of op_flag_* enum values combined, altering behaviors of the operation.
	p_notify	Called when the task is completed. Status code is one of t_update_info values. Can be null if caller doesn't care.

virtual void metadb_io_v2::remove_info_async	(	metadb_handle_list_cref	p_list,
		HWND	p_parent_window,
		t_uint32	p_op_flags,
		completion_notify_ptr	p_notify
	)			[pure virtual]

Strips all tags / metadata fields from the specified tracks.

Parameters:

	p_list	List of items to process.
	p_op_flags	Can be null, or one or more of op_flag_* enum values combined, altering behaviors of the operation.
	p_notify	Called when the task is completed. Status code is one of t_update_info values. Can be null if caller doesn't care.

virtual metadb_hint_list::ptr metadb_io_v2::create_hint_list

(

)

[pure virtual]

Creates a metadb_hint_list object.

void metadb_io_v2::update_info_async_simple	(	metadb_handle_list_cref	p_list,
		const pfc::list_base_const_t< const file_info * > &	p_new_info,
		HWND	p_parent_window,
		t_uint32	p_op_flags,
		completion_notify_ptr	p_notify
	)

Updates tags of the specified tracks. Helper; uses update_info_async internally.

Parameters:

	p_list	List of items to process.
	p_op_flags	Can be null, or one or more of op_flag_* enum values combined, altering behaviors of the operation.
	p_notify	Called when the task is completed. Status code is one of t_update_info values. Can be null if caller doesn't care.
	p_new_info	New infos to write to specified items.

---

Member Data Documentation

const GUID metadb_io_v2::class_guid = { 0x265c4ece, 0xffb2, 0x4299, { 0x91, 0xb5, 0x6c, 0xa6, 0x60, 0x3d, 0xa1, 0x53 } } [static]

Reimplemented from metadb_io.

Reimplemented in metadb_io_v3.

---

The documentation for this class was generated from the following files:

• foobar2000/SDK/metadb.h
• foobar2000/SDK/guids.cpp