DEATH: Created page with "Category:Foobar2000 Development == Tracking foobar2000 lifetime events: global callbacks == Multiple service classes presented by the SDK allow your component to receive ..."

2022-06-21T20:04:10Z

Created page with "Category:Foobar2000 Development == Tracking foobar2000 lifetime events: global callbacks == Multiple service classes presented by the SDK allow your component to receive ..."

New page

[[Category:Foobar2000 Development]]
== Tracking foobar2000 lifetime events: global callbacks ==

Multiple service classes presented by the SDK allow your component to receive notifications about various events.
We'll refer to these classes as global callbacks.

Essential examples of global callbacks:
* <code>initquit</code> - notification about app startup and shutdown.
* <code>init_stage_callback</code> - more detailed notification about app startup and shutdown.
* <code>file_operation_callback</code> - tracking file move/copy/delete operations.
* <code>library_callback</code> - tracking Media Library content changes.
* <code>metadb_io_callback</code> - tracking tag read / write operations altering cached/displayed media information.
* <code>play_callback</code> - tracking playback related events.
* <code>playback_statistics_collector</code> - collecting information about played tracks.
* <code>playlist_callback</code>, <code>playlist_callback_single</code> - tracking playlist changes (the latter tracks only active playlist changes).
* <code>playback_queue_callback</code> - tracking playback queue changes.
* <code>titleformat_config_callback</code> - tracking changes of title formatting configuration.
* <code>ui_drop_item_callback</code> - filtering items dropped into the UI.
All of global callbacks operate only within main app thread, allowing easy cooperation with your user interface - for an example, you perform playlist view window repainting directly from your <code>playlist_callback</code> implementation.

== Global callback recursion issues ==

There are restrictions on things that are legal to call from within global callbacks. For an example, you can't modify a playlist from inside a playlist callback, because there are other registered callbacks tracking playlist changes that haven't been notified about the change being currently processed yet.

You must not enter modal message loops from inside global callbacks, as those allow any unrelated code (queued messages, user input, etc.) to be executed, without being aware that a global callback is being processed. Certain global API methods such as <code>metadb_io::load_info_multi</code> or <code>threaded_process::run_modal</code> enter modal loops when called. Use <code>main_thread_callback</code> service to avoid this problem and delay execution of problematic code.

You should also avoid firing a cross-thread <code>SendMessage()</code> inside global callbacks as well as performing any operations that dispatch global callbacks when handling a message that was sent through a cross-thread <code>SendMessage()</code>. Doing so may result in rare unwanted recursions - <code>SendMessage()</code> call will block the calling thread and immediately process any incoming cross-thread <code>SendMessage()</code> messages. If you're handling a cross-thread <code>SendMessage()</code> and need to perform such operation, delay it using <code>PostMessage()</code> or main_thread_callback.

Foobar2000:Development:Global Callbacks - Revision history

DEATH: Created page with "Category:Foobar2000 Development == Tracking foobar2000 lifetime events: global callbacks == Multiple service classes presented by the SDK allow your component to receive ..."