Changeset 70 for trunk/src/helpers/threads.c

Timestamp:

May 20, 2001, 5:38:55 PM (24 years ago)

Author:

umoeller

Message:

misc updates

File:

• trunk/src/helpers/threads.c (modified) (8 diffs)

trunk/src/helpers/threads.c

@@ -130 +130 @@
     if (pti)
     {
-        if (pti->pfRunning)
-            // set "running" flag
-            *(pti->pfRunning) = TRUE;
-
         if (pti->flFlags & THRF_WAIT)
             // "Wait" flag set: thrCreate is then
@@ -174 +170 @@
         }
 
-        // for non-transient threads: set exit flags
+        // set exit flags
         // V0.9.7 (2000-12-20) [umoeller]
         pti->fExitComplete = TRUE;
         pti->tid = NULLHANDLE;
 
-        if (pti->pfRunning)
+        if (pti->ptidRunning)
             // clear "running" flag
-            *(pti->pfRunning) = FALSE;
+            *(pti->ptidRunning) = 0;
 
         // (2000-12-18) [lafaix] clean up pti if thread is transient.
@@ -213 +209 @@
  *      The thread's ptiMyself is then a pointer to the
  *      THREADINFO structure passed to this function.
- *      ulData may be obtained like this:
+ *      In your thread function, ulData may be obtained like this:
  *
  +          ULONG ulData = ptiMyself->ulData;
  *
- *      The THREADINFO structure passed to this function must
- *      be accessible all the time while the thread is running
- *      because the thr* functions will use it for maintenance.
- *
- *      This function does NOT check whether a thread is
- *      already running in *pti. Do not use the same THREADINFO
- *      for several threads.
- *
- *      If you do not want to manage the structure yourself,
- *      you can pass the THRF_TRANSIENT flag (see below).
- *
- *      thrCreate does not call your thread func directly,
+ *      thrCreate does not start your thread func directly,
  *      but only through the thr_fntGeneric wrapper to
  *      provide additional functionality. As a consequence,
@@ -235 +220 @@
  *      (cleanup) in thr_fntGeneric. Instead, just fall out of
  *      your thread function, or return().
+ *
+ *      The THREADINFO structure passed to this function must
+ *      be accessible all the time while the thread is running
+ *      because the thr* functions will use it for maintenance.
+ *      This function does NOT check whether a thread is
+ *      already running in *pti. Do not use the same THREADINFO
+ *      for several threads.
+ *
+ *      If you do not want to manage the structure yourself,
+ *      you can pass the THRF_TRANSIENT flag (see below).
+ *
+ *      ptidRunning is an optional parameter and can be NULL.
+ *      If non-null, it must point to a ULONG which will contain
+ *      the thread's TID while the thread is still running.
+ *      Once the thread exits, the ULONG will automatically
+ *      be set to zero; this is useful for a quick check whether
+ *      the thread is currently busy.
+ *
+ *      Note: ptidRunning is only reliable if you set the
+ *      THRF_WAIT or THRF_WAIT_EXPLICIT flags.
  *
  *      flFlags can be any combination of the following:
@@ -252 +257 @@
  *
  *      -- THRF_WAIT_EXPLICIT: like THRF_WAIT, but in this case,
- *         your thread function must post THREADINFO.hevRunning
+ *         your thread function _must_ post THREADINFO.hevRunning
  *         yourself (thr_fntGeneric will not automatically
  *         post it). Useful for waiting until your own thread
@@ -282 +287 @@
  *@@changed V0.9.9 (2001-03-07) [umoeller]: added pcszThreadName
  *@@changed V0.9.9 (2001-03-14) [umoeller]: added THRF_WAIT_EXPLICIT
+ *@@changed V0.9.12 (2001-05-20) [umoeller]: changed pfRunning to ptidRunning
  */
 
 ULONG thrCreate(PTHREADINFO pti,     // out: THREADINFO data
                 PTHREADFUNC pfn,     // in: _Optlink thread function
-                PBOOL pfRunning,     // out: variable set to TRUE while thread is running;
+                PULONG ptidRunning,  // out: variable set to TID while thread is running;
                                      // ptr can be NULL
                 const char *pcszThreadName, // in: thread name (for identification)
@@ -307 +313 @@
         pti->cbStruct = sizeof(THREADINFO);
         pti->pThreadFunc = (PVOID)pfn;
-        pti->pfRunning = pfRunning;
+        pti->ptidRunning = ptidRunning;
         pti->pcszThreadName = pcszThreadName; // V0.9.9 (2001-03-07) [umoeller]
         pti->flFlags = flFlags;
@@ -336 +342 @@
                                     pti);   // parameter passed to thread
             ulrc = pti->tid;
+
+            if (pti->ptidRunning)
+                // set "running" flag // V0.9.12 (2001-05-20) [umoeller]
+                *(pti->ptidRunning) = pti->tid;
 
             if (ulrc)