Changeset 52596 in vbox for trunk/include

Timestamp:

Sep 4, 2014 4:45:50 PM (10 years ago)

Author:

vboxsync

svn:sync-xref-src-repo-rev:

95871

Message:

Storage/VD + Main/ExtPackManager+VirtualBox+SystemProperties: restructure previous change to fit better into the extpack design (using existing hooks) by using two new extpack helper functions

File:

• trunk/include/VBox/ExtPack/ExtPack.h (modified) (4 diffs)

trunk/include/VBox/ExtPack/ExtPack.h

@@ -4 +4 @@
 
 /*
- * Copyright (C) 2010-2013 Oracle Corporation
+ * Copyright (C) 2010-2014 Oracle Corporation
  *
  * This file is part of VirtualBox Open Source Edition (OSE), as
@@ -150 +150 @@
     DECLR3CALLBACKMEMBER(VBOXEXTPACKCTX, pfnGetContext,(PCVBOXEXTPACKHLP pHlp));
 
+    /**
+     * Loads a HGCM service provided by an extension pack.
+     *
+     * @returns VBox status code.
+     * @param   pHlp            Pointer to this helper structure.
+     * @param   pConsole        Pointer to the VM's console object.
+     * @param   pszServiceLibrary Name of the library file containing the
+     *                          service implementation, without extension.
+     * @param   pszServiceName  Name of HGCM service.
+     */
     DECLR3CALLBACKMEMBER(int, pfnLoadHGCMService,(PCVBOXEXTPACKHLP pHlp, VBOXEXTPACK_IF_CS(IConsole) *pConsole,
                                                   const char *pszServiceLibrary, const char *pszServiceName));
+
+    /**
+     * Loads a VD plugin provided by an extension pack.
+     *
+     * This makes sense only in the context of the per-user service (VBoxSVC).
+     *
+     * @returns VBox status code.
+     * @param   pHlp            Pointer to this helper structure.
+     * @param   pVirtualBox     Pointer to the VirtualBox object.
+     * @param   pszPluginLibrary Name of the library file containing the plugin
+     *                          implementation, without extension.
+     */
+    DECLR3CALLBACKMEMBER(int, pfnLoadVDPlugin,(PCVBOXEXTPACKHLP pHlp, VBOXEXTPACK_IF_CS(IVirtualBox) *pVirtualBox,
+                                               const char *pszPluginLibrary));
+
+    /**
+     * Unloads a VD plugin provided by an extension pack.
+     *
+     * This makes sense only in the context of the per-user service (VBoxSVC).
+     *
+     * @returns VBox status code.
+     * @param   pHlp            Pointer to this helper structure.
+     * @param   pVirtualBox     Pointer to the VirtualBox object.
+     * @param   pszPluginLibrary Name of the library file containing the plugin
+     *                          implementation, without extension.
+     */
+    DECLR3CALLBACKMEMBER(int, pfnUnloadVDPlugin,(PCVBOXEXTPACKHLP pHlp, VBOXEXTPACK_IF_CS(IVirtualBox) *pVirtualBox,
+                                                 const char *pszPluginLibrary));
 
     DECLR3CALLBACKMEMBER(int, pfnReserved1,(PCVBOXEXTPACKHLP pHlp)); /**< Reserved for minor structure revisions. */
@@ -159 +197 @@
     DECLR3CALLBACKMEMBER(int, pfnReserved5,(PCVBOXEXTPACKHLP pHlp)); /**< Reserved for minor structure revisions. */
     DECLR3CALLBACKMEMBER(int, pfnReserved6,(PCVBOXEXTPACKHLP pHlp)); /**< Reserved for minor structure revisions. */
-    DECLR3CALLBACKMEMBER(int, pfnReserved7,(PCVBOXEXTPACKHLP pHlp)); /**< Reserved for minor structure revisions. */
-    DECLR3CALLBACKMEMBER(int, pfnReserved8,(PCVBOXEXTPACKHLP pHlp)); /**< Reserved for minor structure revisions. */
 
     /** End of structure marker (VBOXEXTPACKHLP_VERSION). */
@@ -166 +202 @@
 } VBOXEXTPACKHLP;
 /** Current version of the VBOXEXTPACKHLP structure.  */
-#define VBOXEXTPACKHLP_VERSION          RT_MAKE_U32(1, 1)
+#define VBOXEXTPACKHLP_VERSION          RT_MAKE_U32(2, 1)