Changeset 30614 in vbox for trunk/src/VBox/HostServices/GuestControl

Timestamp:

Jul 5, 2010 12:57:34 PM (15 years ago)

Author:

vboxsync

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

63341

Message:

Comments.

File:

• trunk/src/VBox/HostServices/GuestControl/service.cpp (modified) (4 diffs)

trunk/src/VBox/HostServices/GuestControl/service.cpp

@@ -718 +718 @@
         switch (eFunction)
         {
-            /* The guest asks the host for the next messsage to process. */
+            /* 
+             * The guest asks the host for the next messsage to process. 
+             */
             case GUEST_GET_HOST_MSG:
                 LogFlowFunc(("GUEST_GET_HOST_MSG\n"));
@@ -724 +726 @@
                 break;
 
+            /*
+             * The guest wants to shut down and asks us (this service) to cancel
+             * all blocking pending waits (VINF_HGCM_ASYNC_EXECUTE) so that the
+             * guest can gracefully shut down.
+             */
             case GUEST_CANCEL_PENDING_WAITS:
                 LogFlowFunc(("GUEST_CANCEL_PENDING_WAITS\n"));
@@ -729 +736 @@
                 break;
 
-            /* The guest notifies the host that some output at stdout/stderr is available. */
+            /*
+             * The guest notifies the host that some output at stdout/stderr is available. 
+             */
             case GUEST_EXEC_SEND_OUTPUT:
                 LogFlowFunc(("GUEST_EXEC_SEND_OUTPUT\n"));
@@ -735 +744 @@
                 break;
 
-            /* The guest notifies the host of the current client status. */
+            /* 
+             * The guest notifies the host of the current client status. 
+             */
             case GUEST_EXEC_SEND_STATUS:
                 LogFlowFunc(("SEND_STATUS\n"));