Changeset 25618 in vbox for trunk/include

Timestamp:

Jan 2, 2010 12:00:33 PM (15 years ago)

Author:

vboxsync

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

56309

Message:

IPRT,pdmcritsect: More lock validator hacking.

File:

• trunk/include/iprt/lockvalidator.h (modified) (6 diffs)

trunk/include/iprt/lockvalidator.h

@@ -434 +434 @@
 
 /**
- * Do deadlock detection before blocking on exclusive access to a lock.
- *
- * @retval  VINF_SUCCESS
+ * Do deadlock detection before blocking on exclusive access to a lock and
+ * change the thread state.
+ *
+ * @retval  VINF_SUCCESS - thread is in the specified sleep state.
  * @retval  VERR_SEM_LV_DEADLOCK if blocking would deadlock.  Gone thru the
  *          motions.
@@ -450 +451 @@
  * @param   pSrcPos             The source position of the lock operation.
  * @param   fRecursiveOk        Whether it's ok to recurse.
+ * @param   enmSleepState       The sleep state to enter on successful return.
  */
 RTDECL(int) RTLockValidatorRecExclCheckBlocking(PRTLOCKVALRECEXCL pRec, RTTHREAD hThreadSelf,
-                                                PCRTLOCKVALSRCPOS pSrcPos, bool fRecursiveOk);
+                                                PCRTLOCKVALSRCPOS pSrcPos, bool fRecursiveOk,
+                                                RTTHREADSTATE enmSleepState);
 
 /**
@@ -463 +466 @@
  * @param   pSrcPos             The source position of the lock operation.
  * @param   fRecursiveOk        Whether it's ok to recurse.
+ * @param   enmSleepState       The sleep state to enter on successful return.
  */
 RTDECL(int) RTLockValidatorRecExclCheckOrderAndBlocking(PRTLOCKVALRECEXCL pRec, RTTHREAD hThreadSelf,
-                                                        PCRTLOCKVALSRCPOS pSrcPos, bool fRecursiveOk);
+                                                        PCRTLOCKVALSRCPOS pSrcPos, bool fRecursiveOk,
+                                                        RTTHREADSTATE enmSleepState);
 
 /**
@@ -509 +514 @@
 
 /**
- * Do deadlock detection before blocking on shared access to a lock.
- *
- * @retval  VINF_SUCCESS
+ * Do deadlock detection before blocking on shared access to a lock and change
+ * the thread state.
+ *
+ * @retval  VINF_SUCCESS - thread is in the specified sleep state.
  * @retval  VERR_SEM_LV_DEADLOCK if blocking would deadlock.  Gone thru the
  *          motions.
@@ -525 +531 @@
  * @param   pSrcPos             The source position of the lock operation.
  * @param   fRecursiveOk        Whether it's ok to recurse.
+ * @param   enmSleepState       The sleep state to enter on successful return.
  */
 RTDECL(int) RTLockValidatorRecSharedCheckBlocking(PRTLOCKVALRECSHRD pRec, RTTHREAD hThreadSelf,
-                                                  PCRTLOCKVALSRCPOS pSrcPos, bool fRecursiveOk);
+                                                  PCRTLOCKVALSRCPOS pSrcPos, bool fRecursiveOk,
+                                                  RTTHREADSTATE enmSleepState);
 
 /**
@@ -540 +548 @@
  */
 RTDECL(int) RTLockValidatorRecSharedCheckOrderAndBlocking(PRTLOCKVALRECSHRD pRec, RTTHREAD hThreadSelf,
-                                                          PCRTLOCKVALSRCPOS pSrcPos, bool fRecursiveOk);
+                                                          PCRTLOCKVALSRCPOS pSrcPos, bool fRecursiveOk,
+                                                          RTTHREADSTATE enmSleepState);
 
 /**