Public API Reference

csutil/threading/win32_thread.h

/*
  Copyright (C) 2006 by Marten Svanfeldt

  This library is free software; you can redistribute it and/or
  modify it under the terms of the GNU Lesser General Public
  License as published by the Free Software Foundation; either
  version 2 of the License, or (at your option) any later version.

  This library is distributed in the hope that it will be useful,
  but WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  Library General Public License for more details.

  You should have received a copy of the GNU Library General Public
  License along with this library; if not, write to the Free
  Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
*/

#ifndef __CS_CSUTIL_THREADING_WIN32_THREAD_H__
#define __CS_CSUTIL_THREADING_WIN32_THREAD_H__

#include "csutil/sysfunc.h"

#include "csutil/threading/barrier.h"

#if !defined(CS_PLATFORM_WIN32)
#error "This file is only for Windows and requires you to include csysdefs.h before"
#else

namespace CS
{
namespace Threading
{

  enum ThreadPriority;
  class Runnable;

namespace Implementation
{
  class ThreadLocalBase;

  // Thread base-class for win32
  class CS_CRYSTALSPACE_EXPORT ThreadBase : public CS::Utility::AtomicRefCount
  {
  public:
    ThreadBase (Runnable* runnable);

    ~ThreadBase ();

    void Start ();

    void Stop ();

    bool IsRunning () const;

    bool SetPriority (ThreadPriority prio);
    
    void Wait () const;

    static void Yield ()
    {
      csSleep (0);
    }

    static CS::Threading::ThreadID GetThreadID ();

    ThreadPriority GetPriority () const
    {
      return priority;
    }

  protected:
    friend class ThreadLocalBase;
    
    // TLS cleanup stuff
    static void RegisterTlsInstance (ThreadLocalBase* tls);
    static void UnregisterTlsInstance (ThreadLocalBase* tls);
    static void CleanupAllTlsInstances ();
  private:
    csRef<Runnable> runnable;

    mutable void* threadHandle;
    uint threadId;

    int32 isRunning;
    ThreadPriority priority;
    Barrier startupBarrier;

    static unsigned int __stdcall proxyFunc (void* param);
  };


}
}
}

#endif // !defined(CS_PLATFORM_WIN32)

#endif // __CS_CSUTIL_THREADING_WIN32_THREAD_H__

---