Changeset 12324 in vbox for trunk/include

Timestamp:

Sep 10, 2008 5:18:38 AM (17 years ago)

Author:

vboxsync

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

36345

Message:

PDMThread: New API PDMR3ThreadSleep. Fixed a per thread event sem leak.

File:

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

trunk/include/VBox/pdmthread.h

@@ -35 +35 @@
 #ifdef IN_RING3
 # include <iprt/thread.h>
-#endif 
+#endif
 
 __BEGIN_DECLS
@@ -286 +286 @@
 /**
  * Creates a PDM thread for internal use in the VM.
- * 
- * @returns VBox status code.
- * @param   pVM         The VM handle. 
+ *
+ * @returns VBox status code.
+ * @param   pVM         The VM handle.
  * @param   ppThread    Where to store the thread 'handle'.
  * @param   pvUser      The user argument to the thread function.
@@ -303 +303 @@
 /**
  * Creates a PDM thread for VM use by some external party.
- * 
- * @returns VBox status code.
- * @param   pVM         The VM handle. 
+ *
+ * @returns VBox status code.
+ * @param   pVM         The VM handle.
  * @param   ppThread    Where to store the thread 'handle'.
  * @param   pvUser      The user argument to the thread function.
@@ -360 +360 @@
 
 /**
+ * Called by the PDM thread instead of RTThreadSleep.
+ *
+ * The difference is that the sleep will be interrupted on state change. The
+ * thread must be in the running state, otherwise it will return immediately.
+ *
+ * @returns VBox status code.
+ * @retval  VINF_SUCCESS on success or state change.
+ * @retval  VERR_INTERRUPTED on signal or APC.
+ *
+ * @param   pThread     The PDM thread.
+ * @param   cMillies    The number of milliseconds to sleep.
+ */
+PDMR3DECL(int) PDMR3ThreadSleep(PPDMTHREAD pThread, unsigned cMillies);
+
+/**
  * Suspends the thread.
  *