Changeset 45415 in vbox for trunk/include/VBox/HostServices/GuestControlSvc.h

Timestamp:

Apr 8, 2013 9:40:42 PM (12 years ago)

Author:

vboxsync

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

84843

Message:

GuestCtrl: Implemented using (public) VirtualBox events instead of own callback mechanisms. Bugfixes for testcases (still work in progress).

File:

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

trunk/include/VBox/HostServices/GuestControlSvc.h

@@ -63 +63 @@
 /** Gets the session ID out of a context ID. */
 #define VBOX_GUESTCTRL_CONTEXTID_GET_SESSION(uContextID) \
-    ((uContextID) >> 27)
+    (((uContextID) >> 27) & 0x1f)
 /** Gets the process ID out of a context ID. */
 #define VBOX_GUESTCTRL_CONTEXTID_GET_OBJECT(uContextID) \
@@ -308 +308 @@
     GUEST_MSG_FILTER = 4,
     /**
+     * Skips the current assigned message returned by GUEST_MSG_WAIT.
+     * Needed for telling the host service to not keep stale
+     * host commands in the queue.
+     */
+    GUEST_MSG_SKIP = 5,
+    /**
      * Guest reports back a guest session status.
      */
@@ -414 +420 @@
 /**
  * Asks the guest control host service to set a command
- * filter for this client. The filter itself will affect
- * the context ID bound to a command.
+ * filter for this client. This filter will then only
+ * deliver messages to the client which match the
+ * wanted context ID (ranges).
  */
 typedef struct HGCMMsgCmdSetFilter
@@ -429 +436 @@
 
 /**
+ * Asks the guest control host service to skip the
+ * currently assigned host command returned by
+ * VbglR3GuestCtrlMsgWaitFor().
+ */
+typedef struct HGCMMsgCmdSkip
+{
+    VBoxGuestHGCMCallInfo hdr;
+
+} HGCMMsgCmdSkip;
+
+/**
  * Asks the guest control host service to cancel all pending (outstanding)
- * waits which were not processed yet.  This is handy for a graceful shutdown.
+ * waits which were not processed yet. This is handy for a graceful shutdown.
  */
 typedef struct HGCMMsgCancelPendingWaits