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

Timestamp:

May 25, 2010 1:30:45 PM (15 years ago)

Author:

vboxsync

Message:

Guest Control: More stable when client is crashing/aborting in an unusual way.

File:

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

trunk/include/VBox/HostServices/GuestControlSvc.h

@@ -74 +74 @@
     /** Context ID to identify callback data. */
     uint32_t u32ContextID;
-} HOSTCCALLBACKHEADER, *PHOSTCCALLBACKHEADER;
+} CALLBACKHEADER, *PCALLBACKHEADER;
 
 /**
@@ -80 +80 @@
  * notify the host of changes to properties.
  */
-typedef struct _VBoxGuestCtrlExecCallbackData
+typedef struct _VBoxGuestCtrlCallbackDataExecStatus
 {
     /** Callback data header. */
-    HOSTCCALLBACKHEADER hdr;
+    CALLBACKHEADER hdr;
     /** The process ID (PID). */
     uint32_t u32PID;
@@ -94 +94 @@
     /** Size of optional data buffer (not used atm). */
     uint32_t cbData;
-} HOSTEXECCALLBACKDATA, *PHOSTEXECCALLBACKDATA;
-
-typedef struct _VBoxGuestCtrlExecOutCallbackData
+} CALLBACKDATAEXECSTATUS, *PCALLBACKDATAEXECSTATUS;
+
+typedef struct _VBoxGuestCtrlCallbackDataExecOut
 {
     /** Callback data header. */
-    HOSTCCALLBACKHEADER hdr;
+    CALLBACKHEADER hdr;
     /** The process ID (PID). */
     uint32_t u32PID;
@@ -110 +110 @@
     /** Size of optional data buffer. */
     uint32_t cbData;
-} HOSTEXECOUTCALLBACKDATA, *PHOSTEXECOUTCALLBACKDATA;
+} CALLBACKDATAEXECOUT, *PCALLBACKDATAEXECOUT;
+
+typedef struct _VBoxGuestCtrlCallbackDataClientDisconnected
+{
+    /** Callback data header. */
+    CALLBACKHEADER hdr;
+} CALLBACKDATACLIENTDISCONNECTED, *PCALLBACKDATACLIENTDISCONNECTED;
 
 enum
 {
-    /** Magic number for sanity checking the HOSTEXECCALLBACKDATA structure. */
-    HOSTEXECCALLBACKDATAMAGIC = 0x26011982,
-    /** Magic number for sanity checking the HOSTEXECOUTCALLBACKDATA structure. */
-    HOSTEXECOUTCALLBACKDATAMAGIC = 0x11061949
+    /** Magic number for sanity checking the CALLBACKDATACLIENTDISCONNECTED structure. */
+    CALLBACKDATAMAGICCLIENTDISCONNECTED = 0x08041984,
+    /** Magic number for sanity checking the CALLBACKDATAEXECSTATUS structure. */
+    CALLBACKDATAMAGICEXECSTATUS = 0x26011982,
+    /** Magic number for sanity checking the CALLBACKDATAEXECOUT structure. */
+    CALLBACKDATAMAGICEXECOUT = 0x11061949
 };
 
@@ -160 +168 @@
     GUEST_GET_HOST_MSG = 1,
     /**
-     * Guest asks the host to cancel all pending waits the guest waits on.
+     * Guest asks the host to cancel all pending waits the guest itself waits on.
      * This becomes necessary when the guest wants to quit but still waits for
      * commands from the host.
      */
     GUEST_CANCEL_PENDING_WAITS = 2,
+    /**
+     * Guest disconnected (terminated normally or due to a crash HGCM
+     * detected when calling service::clientDisconnect(). 
+     */
+    GUEST_DISCONNECTED = 3,
     /**
      * TODO