Changeset 13376 in vbox for trunk/include/VBox

Timestamp:

Oct 17, 2008 2:20:28 PM (16 years ago)

Author:

vboxsync

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

38102

Message:

HostServices/GuestProperties: use an HGCM service extension instead of the callback type I added

File:

• trunk/include/VBox/HostServices/GuestPropertySvc.h (modified) (2 diffs)

trunk/include/VBox/HostServices/GuestPropertySvc.h

@@ -206 +206 @@
      * The parameter format matches that of ENUM_PROPS.
      */
-    ENUM_PROPS_HOST = 6,
-    /**
-     * Register a callback with the service which will be called when a
-     * property is modified.  The callback is a function returning void and
-     * taking a pointer to a HOSTCALLBACKDATA structure.
-     */
-    REGISTER_CALLBACK = 7
-};
-
-typedef struct _HOSTCALLBACKDATA
-{
-    /** Callback structure header */
-    VBOXHGCMCALLBACKHDR hdr;
-    /** The name of the property that was changed */
-    const char *pcszName;
-    /** The new property value, or NULL if the property was deleted */
-    const char *pcszValue;
-    /** The timestamp of the modification */
-    uint64_t u64Timestamp;
-    /** The flags field of the modified property */
-    const char *pcszFlags;
-} HOSTCALLBACKDATA, *PHOSTCALLBACKDATA;
+    ENUM_PROPS_HOST = 6
+};
 
 /**
@@ -248 +228 @@
 
 /**
+ * Data structure to pass to the service extension callback.  We use this to
+ * notify the host of changes to properties.
+ */
+typedef struct _HOSTCALLBACKDATA
+{
+    /** Magic number to identify the structure */
+    uint32_t u32Magic;
+    /** The name of the property that was changed */
+    const char *pcszName;
+    /** The new property value, or NULL if the property was deleted */
+    const char *pcszValue;
+    /** The timestamp of the modification */
+    uint64_t u64Timestamp;
+    /** The flags field of the modified property */
+    const char *pcszFlags;
+} HOSTCALLBACKDATA, *PHOSTCALLBACKDATA;
+
+enum
+{
+    /** Magic number for sanity checking the HOSTCALLBACKDATA structure */
+    HOSTCALLBACKMAGIC = 0x69c87a78
+};
+
+/**
  * HGCM parameter structures.  Packing is explicitly defined as this is a wire format.
  */