Changeset 50265 in vbox for trunk/include

Timestamp:

Jan 29, 2014 11:12:44 AM (11 years ago)

Author:

vboxsync

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

91898

Message:

DnD: First working implementation for Windows guest->host support; still work in progress. As for now only pure text data can be dragged over.

File:

• trunk/include/VBox/HostServices/DragAndDropSvc.h (modified) (6 diffs)

trunk/include/VBox/HostServices/DragAndDropSvc.h

@@ -4 +4 @@
 
 /*
- * Copyright (C) 2011-2013 Oracle Corporation
+ * Copyright (C) 2011-2014 Oracle Corporation
  *
  * This file is part of VirtualBox Open Source Edition (OSE), as
@@ -61 +61 @@
 /**
  * The service functions which are callable by host.
+ * Note: When adding new functions to this table, make sure that the actual ID
+ *       does *not* overlap with the eGuestFn enumeration below!
  */
 enum eHostFn
@@ -82 +84 @@
 
     /* G->H */
-    HOST_DND_GH_REQ_PENDING            = 300,
+    /** The host asks the guest whether a DnD operation
+     *  is in progress when the mouse leaves the guest window. */
+    HOST_DND_GH_REQ_PENDING            = 600,
+    /** The host informs the guest that a DnD drop operation
+     *  has been started and that the host wants the data in
+     *  a specific mime-type. */
     HOST_DND_GH_EVT_DROPPED
 };
@@ -88 +95 @@
 /**
  * The service functions which are called by guest.
+ * Note: When adding new functions to this table, make sure that the actual ID
+ *       does *not* overlap with the eGuestFn enumeration above!
  */
 enum eGuestFn
 {
     /**
-     * Guest waits for a new message the host wants to process on the guest side.
-     * This is a blocking call and can be deferred.
+     * Guest waits for a new message the host wants to process
+     * on the guest side. This can be a blocking call.
      */
     GUEST_DND_GET_NEXT_HOST_MSG        = 300,
@@ -103 +112 @@
 
     /* G->H */
+    /**
+     * The guests acknowledges that it currently has a drag'n drop
+     * operation in progress on the guest, which eventually could be
+     * dragged over to the host.
+     */
     GUEST_DND_GH_ACK_PENDING           = 500,
     GUEST_DND_GH_SND_DATA,
@@ -416 +430 @@
     void     *pvData;
     uint32_t  cbData;
-    uint32_t  cbAllSize;
+    uint32_t  cbAllSize; /** @todo Why is this transmitted every time? */
 } VBOXDNDCBSNDDATADATA;
 typedef VBOXDNDCBSNDDATADATA *PVBOXDNDCBSNDDATADATA;