Changeset 42461 in vbox for trunk/include/VBox/HostServices

Timestamp:

Jul 30, 2012 9:28:12 PM (13 years ago)

Author:

vboxsync

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

79600

Message:

Guest Control 2.0: Update.

File:

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

trunk/include/VBox/HostServices/GuestControlSvc.h

@@ -44 +44 @@
 /**
  * Process status when executed in the guest.
- * Note: Has to match Main's ExecuteProcessStatus_*!
  */
 enum eProcessStatus
@@ -250 +249 @@
      * new data on stdout/stderr, process terminated etc.
      */
-    HOST_EXEC_GET_OUTPUT = 102
+    HOST_EXEC_GET_OUTPUT = 102,
+
+    /*
+     * Guest control 2.0 commands start in the 2xx number space.
+     */
+
+    /**
+     * Waits for a certain event to happen. This can be an input, output
+     * or status event.
+     */
+    HOST_EXEC_WAIT_FOR = 210
 };
 
@@ -278 +287 @@
     /*
      * Process execution.
+     * The 1xx commands are legacy guest control commands and
+     * will be replaced by newer commands in the future.
      */
 
@@ -291 +302 @@
      * Guests sends an input status notification to the host.
      */
-    GUEST_EXEC_SEND_INPUT_STATUS = 102
+    GUEST_EXEC_SEND_INPUT_STATUS = 102,
+
+    /*
+     * Guest control 2.0 commands start in the 2xx number space.
+     */
+
+    /**
+     * Guest notifies the host about some I/O event. This can be
+     * a stdout, stderr or a stdin event. The actual event only tells
+     * how many data is available / can be sent without actually
+     * transmitting the data.
+     */
+    GUEST_EXEC_IO_NOTIFY = 210,
 };
 
@@ -332 +355 @@
     /** The command to execute on the guest. */
     HGCMFunctionParameter cmd;
-    /** Execution flags (see IGuest::ExecuteProcessFlag_*). */
+    /** Execution flags (see IGuest::ProcessCreateFlag_*). */
     HGCMFunctionParameter flags;
     /** Number of arguments. */
@@ -351 +374 @@
      *  overall lifetime of the process or how long it
      *  can take to bring the process up and running -
-     *  (depends on the IGuest::ExecuteProcessFlag_*). */
+     *  (depends on the IGuest::ProcessCreateFlag_*). */
     HGCMFunctionParameter timeout;
 
@@ -434 +457 @@
 } VBoxGuestCtrlHGCMMsgExecStatusIn;
 
+/**
+ * Reports back the currente I/O status of a guest process.
+ */
+typedef struct VBoxGuestCtrlHGCMMsgExecIONotify
+{
+    VBoxGuestHGCMCallInfo hdr;
+    /** Context ID. */
+    HGCMFunctionParameter context;
+    /** Data written. */
+    HGCMFunctionParameter written;
+
+} VBoxGuestCtrlHGCMMsgExecIONotify;
+
 #pragma pack ()