Changeset 42354 in vbox for trunk/src/VBox/Main/include/GuestCtrlImplPrivate.h

Timestamp:

Jul 24, 2012 12:13:00 PM (12 years ago)

Author:

vboxsync

Message:

Guest Control 2.0: Update.

File:

• trunk/src/VBox/Main/include/GuestCtrlImplPrivate.h (modified) (3 diffs)

trunk/src/VBox/Main/include/GuestCtrlImplPrivate.h

@@ -19 +19 @@
 #define ____H_GUESTIMPLPRIVATE
 
+#include <iprt/asm.h>
 #include <iprt/semaphore.h>
 
@@ -67 +68 @@
 
 /**
- * Generic class for a all guest control callbacks.
- */
-class GuestCtrlCallback
-{
-public:
-
+ * Generic class for a all guest control callbacks/events.
+ */
+class GuestCtrlEvent
+{
+public:
+
+    GuestCtrlEvent(void);
+
+    virtual ~GuestCtrlEvent(void);
+
+    /** @todo Copy/comparison operator? */
+
+public:
+
+    int Cancel(void);
+
+    bool Canceled(void);
+
+    virtual void Destroy(void);
+
+    int Init(void);
+
+    virtual int Signal(int rc = VINF_SUCCESS);
+
+    int GetResultCode(void) { return mRC; }
+
+    int Wait(ULONG uTimeoutMS);
+
+protected:
+
+    /** Was the callback canceled? */
+    bool                        fCanceled;
+    /** Did the callback complete? */
+    bool                        fCompleted;
+    /** The event semaphore for triggering
+     *  the actual event. */
+    RTSEMEVENT                  hEventSem;
+    /** The waiting mutex. */
+    RTSEMMUTEX                  hEventMutex;
+    /** Overall result code. */
+    int                         mRC;
+};
+
+/*
+ * Class representing a guest control callback.
+ */
+class GuestCtrlCallback : public GuestCtrlEvent
+{
+public:
     GuestCtrlCallback(void);
 
@@ -79 +123 @@
     virtual ~GuestCtrlCallback(void);
 
-    /** @todo Copy/comparison operator? */
-
-public:
-
-    int Cancel(void);
-
-    bool Canceled(void);
+public:
+
+    void Destroy(void);
 
     int Init(eVBoxGuestCtrlCallbackType enmType);
 
-    void Destroy(void);
-
-    int Signal(int rc = VINF_SUCCESS, const Utf8Str &strMsg = "");
-
-    Utf8Str GetMessage(void) { return mMessage; }
-
-    int GetResultCode(void) { return mRC; }
-
-    eVBoxGuestCtrlCallbackType GetType(void) { return mType; }
-
-    int Wait(ULONG uTimeoutMS);
-
-protected:
-
+    eVBoxGuestCtrlCallbackType GetCallbackType(void) { return mType; }
+
+protected:
+
+    /** Pointer to user-supplied data. */
+    void                       *pvData;
+    /** Size of user-supplied data. */
+    size_t                      cbData;
     /** The callback type. */
     eVBoxGuestCtrlCallbackType  mType;
     /** Callback flags. */
     uint32_t                    uFlags;
-    /** Was the callback canceled? */
-    bool                        fCanceled;
-    /** Did the callback complete? */
-    bool                        fCompleted;
-    /** Pointer to user-supplied data. */
-    void                       *pvData;
-    /** Size of user-supplied data. */
-    size_t                      cbData;
-    /** The event semaphore triggering the*/
-    RTSEMEVENT                  hEventSem;
-    /** Overall result code. */
+};
+typedef std::map < uint32_t, GuestCtrlCallback* > GuestCtrlCallbacks;
+
+struct GuestProcessWaitResult
+{
+    /** The wait result when returning from the wait call. */
+    ProcessWaitResult_T         mResult;
     int                         mRC;
-    /** Error / information message to the
-     *  result code. */
-    Utf8Str                     mMessage;
-};
-typedef std::map < uint32_t, GuestCtrlCallback* > GuestCtrlCallbacks;
+};
+
+/*
+ * Class representing a guest control process event.
+ */
+class GuestProcessEvent : public GuestCtrlEvent
+{
+public:
+    GuestProcessEvent(void);
+
+    GuestProcessEvent(uint32_t uWaitFlags);
+
+    virtual ~GuestProcessEvent(void);
+
+public:
+
+    void Destroy(void);
+
+    int Init(uint32_t uWaitFlags);
+
+    uint32_t GetWaitFlags(void) { return ASMAtomicReadU32(&mWaitFlags); }
+
+    GuestProcessWaitResult GetResult(void) { return mWaitResult; }
+
+    int Signal(ProcessWaitResult enmResult, int rc = VINF_SUCCESS);
+
+protected:
+
+    /** The waiting flag(s). The specifies what to
+     *  wait for. */
+    uint32_t                    mWaitFlags;
+    /** Structure containing the overall result. */
+    GuestProcessWaitResult      mWaitResult;
+};
 
 /**