Changeset 10652 in vbox for trunk/include/VBox

Timestamp:

Jul 15, 2008 12:36:13 PM (17 years ago)

Author:

vboxsync

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

33362

Message:

hgcm: added a callback parameter type (for host use only)

File:

• trunk/include/VBox/hgcmsvc.h (modified) (3 diffs)

trunk/include/VBox/hgcmsvc.h

@@ -58 +58 @@
  * 3.2->3.3 Because pfnDisconnectClient helper was added
  * 3.3->4.1 Because the pvService entry and parameter was added
+ * 4.1->4.2 Because the VBOX_HGCM_SVC_PARM_CALLBACK paramteter type was added
  */
 #define VBOX_HGCM_SVC_VERSION_MAJOR (0x0004)
-#define VBOX_HGCM_SVC_VERSION_MINOR (0x0001)
+#define VBOX_HGCM_SVC_VERSION_MINOR (0x0002)
 #define VBOX_HGCM_SVC_VERSION ((VBOX_HGCM_SVC_VERSION_MAJOR << 16) + VBOX_HGCM_SVC_VERSION_MINOR)
 
@@ -82 +83 @@
 typedef VBOXHGCMSVCHELPERS *PVBOXHGCMSVCHELPERS;
 
-
-#define VBOX_HGCM_SVC_PARM_INVALID (0U)
-#define VBOX_HGCM_SVC_PARM_32BIT (1U)
-#define VBOX_HGCM_SVC_PARM_64BIT (2U)
-#define VBOX_HGCM_SVC_PARM_PTR   (3U)
+/**
+ * Callback type for HGCM services which can send notification messages.
+ * Intended for use on the host side.
+ */
+typedef DECLCALLBACK(void) FNVBOXHGCMCALLBACK(void *pvParm);
+typedef FNVBOXHGCMCALLBACK *PFNVBOXHGCMCALLBACK;
+
+#define VBOX_HGCM_SVC_PARM_INVALID  (0U)
+#define VBOX_HGCM_SVC_PARM_32BIT    (1U)
+#define VBOX_HGCM_SVC_PARM_64BIT    (2U)
+#define VBOX_HGCM_SVC_PARM_PTR      (3U)
+#define VBOX_HGCM_SVC_PARM_CALLBACK (4U)
 
 typedef struct VBOXHGCMSVCPARM
@@ -102 +110 @@
             void *addr;
         } pointer;
+        struct
+        {
+            PFNVBOXHGCMCALLBACK pFunction;
+            void *pvData;
+        } callback;
     } u;
 } VBOXHGCMSVCPARM;