Using ML from a General Purpose plug-in

[saivert]

Syntax of ML API:
SendMessage(g_hwndML, WM_ML_IPC, param, ML_IPC_*);

Include stuff and Set up some vars:

code:


  #include "ml.h"

  HWND g_hwndML;

  int config_useml=0;

First we need to get the handle to media library from within our general purpose plugin:

code:


  /* Register the "LibraryGetWnd" custom message */

  long libhwndipc = (LONG)SendMessage(plugin.hwndParent,

    WM_WA_IPC, WPARAM("LibraryGetWnd"),

    IPC_REGISTER_WINAMP_IPCMESSAGE);



  /* Now send the message and get the HWND */

  g_hwndML = (HWND)SendMessage(plugin.hwndParent,

    WM_WA_IPC, -1, LPARAM(libhwndipc));



  /* Enable use of Media Library if Media Library

     is available */

  if (g_hwndML) config_useml=1;

Then we set up a winampMediaLibraryPlugin struct:

code:


  winampMediaLibraryPlugin ml_plugin =

  {

	MLHDR_VER,

		"Your funky ML plug-in title",

		ml_init,

		ml_quit,

		ml_PluginMessageProc,

		0, // Must be 0 !!

		0, // Must be 0 !!

		0, // Must be 0 !!

  };

Then set up some empty functions. Since ML doesn't call these functions when you inject a plug-in during run-time
we define them as empty ones. You can put code here and call them yourself if you need to.

code:


  int ml_init() { return 0; }

  void ml_quit() { return; }

Then it is time for the PluginMessageProc thing:

code:


int PluginMessageProc(int message_type,

  int param1, int param2, int param3) {



// check for any global messages here

  if (message_type >= ML_MSG_TREE_BEGIN &&

      message_type <= ML_MSG_TREE_END)

  {

    if (param1 != myParam) return 0;

    // local messages for a tree item

		

    switch (message_type) {

      case ML_MSG_TREE_ONCREATEVIEW:

      {

      /* When we get the ML_MSG_TREE_ONCREATEVIEW message

      we are supposed to create our dialog which is

      hosted in ML and return it's window handle.

      Media Library will then do

      DestroyWindow(hwnd_ourdialog);

      when you click on another view

	inside Media Library.

      At least that's what I think.  */



      return (int)CreateDialog(plugin.hDllInstance,

      MAKEINTRESOURCE(IDD_VIEW_EX),

      (HWND)0, dlgproc);

	}

      case ML_MSG_TREE_ONCLICK:

        return onTreeItemClick(param1,param2,(HWND)param3);

    }

  }

  else if (message_type == ML_MSG_CONFIG)

  {

    config((HWND)param1);

    return 1;

  }

  return 0;

}

Here is the onTreeItemClick function:

code:


int onTreeItemClick(int param, int action,

  HWND hwndParent) // if param is not yours, return 0

{

  // Here you just display a menu when people

  // right-click tree-view item.

  if (action == ML_ACTION_RCLICK) 

  {

    POINT p;

    GetCursorPos(&p);

    int r=TrackPopupMenu(any_valid_menu_handle_here,

      TPM_RETURNCMD|TPM_RIGHTBUTTON|

      TPM_LEFTBUTTON|TPM_NONOTIFY,

      p.x,p.y,0,hwndParent,NULL);

    switch (r)

    {

      case ID_ABOUT:

        DialogBox(plugin.hDllInstance,

        MAKEINTRESOURCE(IDD_ABOUT),

        hwndParent,

        about_dlgproc);

        break;

      case ID_CONFIG:

        config(hwndParent);

       break;

    }

  }

  return 1;

}

Now for the finale. Inject our ML plug-in:

code:


  SendMessage(g_hwndML, WM_ML_IPC,

    (WPARAM)&ml_plugin, ML_IPC_ADD_PLUGIN);

To remove our plug-in again (e.g in your quit function) do this:

code:


  SendMessage(g_hwndML, WM_ML_IPC, (WPARAM)&ml_plugin,

    ML_IPC_REMOVE_PLUGIN);