227 lines
6.8 KiB
C
227 lines
6.8 KiB
C
|
#pragma once
|
|||
|
|
/****************************************************************************
|
|||
|
|
Copyright (c) 2006, Radon Labs GmbH
|
|||
|
|
Copyright (c) 2011-2013,WebJet Business Division,CYOU
|
|||
|
|
|
|||
|
|
http://www.genesis-3d.com.cn
|
|||
|
|
|
|||
|
|
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|||
|
|
of this software and associated documentation files (the "Software"), to deal
|
|||
|
|
in the Software without restriction, including without limitation the rights
|
|||
|
|
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|||
|
|
copies of the Software, and to permit persons to whom the Software is
|
|||
|
|
furnished to do so, subject to the following conditions:
|
|||
|
|
|
|||
|
|
The above copyright notice and this permission notice shall be included in
|
|||
|
|
all copies or substantial portions of the Software.
|
|||
|
|
|
|||
|
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|||
|
|
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|||
|
|
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|||
|
|
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|||
|
|
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|||
|
|
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
|||
|
|
THE SOFTWARE.
|
|||
|
|
****************************************************************************/
|
|||
|
|
|
|||
|
|
#include "core/refcounted.h"
|
|||
|
|
#include "threading/win360/win360event.h"
|
|||
|
|
#include "threading/threadid.h"
|
|||
|
|
#include "threading/ThreadRuntimeInfo.h"
|
|||
|
|
#include "system/cpu.h"
|
|||
|
|
#include "util/localstringatomtable.h"
|
|||
|
|
|
|||
|
|
//------------------------------------------------------------------------------
|
|||
|
|
namespace Win360
|
|||
|
|
{
|
|||
|
|
class Win360Thread : public Core::RefCounted
|
|||
|
|
{
|
|||
|
|
__DeclareClass(Win360Thread);
|
|||
|
|
public:
|
|||
|
|
/// thread priorities
|
|||
|
|
enum Priority
|
|||
|
|
{
|
|||
|
|
Low,
|
|||
|
|
Normal,
|
|||
|
|
High,
|
|||
|
|
};
|
|||
|
|
|
|||
|
|
/// constructor
|
|||
|
|
Win360Thread();
|
|||
|
|
/// destructor
|
|||
|
|
virtual ~Win360Thread();
|
|||
|
|
/// set the thread priority
|
|||
|
|
void SetPriority(Priority p);
|
|||
|
|
/// get the thread priority
|
|||
|
|
Priority GetPriority() const;
|
|||
|
|
/// set cpu core on which the thread should be running
|
|||
|
|
void SetCoreId(System::Cpu::CoreId coreId);
|
|||
|
|
/// get the cpu core on which the thread should be running
|
|||
|
|
System::Cpu::CoreId GetCoreId() const;
|
|||
|
|
/// set stack size in bytes (default is 4 KByte)
|
|||
|
|
void SetStackSize(SizeT s);
|
|||
|
|
/// get stack size
|
|||
|
|
SizeT GetStackSize() const;
|
|||
|
|
/// set thread name
|
|||
|
|
void SetName(const Util::String& n);
|
|||
|
|
/// get thread name
|
|||
|
|
const Util::String& GetName() const;
|
|||
|
|
|
|||
|
|
/// start executing the thread code, returns when thread has actually started
|
|||
|
|
void Start();
|
|||
|
|
/// request threading code to stop, returns when thread has actually finished
|
|||
|
|
void Stop();
|
|||
|
|
/// return true if thread has been started
|
|||
|
|
bool IsRunning() const;
|
|||
|
|
|
|||
|
|
/// yield the thread (gives up current time slice)
|
|||
|
|
static void YieldThread();
|
|||
|
|
|
|||
|
|
/// <20><><EFBFBD><EFBFBD><EFBFBD>̶߳<DFB3><CCB6><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ʱ<EFBFBD><CAB1><EFBFBD><EFBFBD>,ÿ<><C3BF><EFBFBD>߳<EFBFBD>ֻ<EFBFBD><D6BB><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>һ<EFBFBD>Ρ<EFBFBD><CEA1><EFBFBD><EFBFBD>̱߳<DFB3><CCB1><EFBFBD><EFBFBD>ڹ<EFBFBD><DAB9><EFBFBD><EFBFBD>̺߳ʹ<CCBA><CDB4><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>֮ǰ<D6AE><C7B0><EFBFBD>á<EFBFBD><C3A1><EFBFBD><EFBFBD><EFBFBD><EFBFBD>̱߳<DFB3><CCB1><EFBFBD><EFBFBD>ڸո<DAB8><D5B8><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ʹ<EFBFBD><CDB4><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>֮ǰ<D6AE><C7B0><EFBFBD>á<EFBFBD>
|
|||
|
|
static void SetupMyThreadRunTime( const char* threadName );
|
|||
|
|
|
|||
|
|
/// <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>߳<EFBFBD><DFB3><EFBFBD><EFBFBD><EFBFBD>ʱ<EFBFBD><CAB1><EFBFBD><EFBFBD>.<2E><><EFBFBD>̱߳<DFB3><CCB1><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
|
|||
|
|
static void DestoryThreadRunTime( bool isMainThread = false );
|
|||
|
|
|
|||
|
|
/// obtain name of thread from within thread context
|
|||
|
|
static const char* GetMyThreadName();
|
|||
|
|
/// get the thread ID of this thread
|
|||
|
|
static Threading::ThreadId GetMyThreadId();
|
|||
|
|
|
|||
|
|
#if NEBULA3_DEBUG
|
|||
|
|
struct ThreadDebugInfo
|
|||
|
|
{
|
|||
|
|
Util::String threadName;
|
|||
|
|
Win360Thread::Priority threadPriority;
|
|||
|
|
System::Cpu::CoreId threadCoreId;
|
|||
|
|
SizeT threadStackSize;
|
|||
|
|
};
|
|||
|
|
/// query thread stats (debug mode only)
|
|||
|
|
static Util::Array<ThreadDebugInfo> GetRunningThreadDebugInfos();
|
|||
|
|
#endif
|
|||
|
|
|
|||
|
|
protected:
|
|||
|
|
/// override this method if your thread loop needs a wakeup call before stopping
|
|||
|
|
virtual void EmitWakeupSignal();
|
|||
|
|
/// this method runs in the thread context
|
|||
|
|
virtual void DoWork();
|
|||
|
|
/// check if stop is requested, call from DoWork() to see if the thread proc should quit
|
|||
|
|
bool ThreadStopRequested() const;
|
|||
|
|
|
|||
|
|
private:
|
|||
|
|
/// internal thread proc helper function
|
|||
|
|
static DWORD WINAPI ThreadProc(LPVOID self);
|
|||
|
|
|
|||
|
|
HANDLE threadHandle;
|
|||
|
|
Win360Event threadStartedEvent;
|
|||
|
|
Win360Event stopRequestEvent;
|
|||
|
|
Priority priority;
|
|||
|
|
SizeT stackSize;
|
|||
|
|
Util::String name;
|
|||
|
|
System::Cpu::CoreId coreId;
|
|||
|
|
|
|||
|
|
#if NEBULA3_DEBUG
|
|||
|
|
static Threading::CriticalSection criticalSection;
|
|||
|
|
static Util::List<Win360Thread*> ThreadList;
|
|||
|
|
Util::List<Win360Thread*>::Iterator threadListIterator;
|
|||
|
|
#endif
|
|||
|
|
};
|
|||
|
|
|
|||
|
|
//------------------------------------------------------------------------------
|
|||
|
|
/**
|
|||
|
|
*/
|
|||
|
|
inline void
|
|||
|
|
Win360Thread::SetPriority(Priority p)
|
|||
|
|
{
|
|||
|
|
this->priority = p;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
//------------------------------------------------------------------------------
|
|||
|
|
/**
|
|||
|
|
*/
|
|||
|
|
inline Win360Thread::Priority
|
|||
|
|
Win360Thread::GetPriority() const
|
|||
|
|
{
|
|||
|
|
return this->priority;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
//------------------------------------------------------------------------------
|
|||
|
|
/**
|
|||
|
|
*/
|
|||
|
|
inline void
|
|||
|
|
Win360Thread::SetStackSize(SizeT s)
|
|||
|
|
{
|
|||
|
|
this->stackSize = s;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
//------------------------------------------------------------------------------
|
|||
|
|
/**
|
|||
|
|
*/
|
|||
|
|
inline SizeT
|
|||
|
|
Win360Thread::GetStackSize() const
|
|||
|
|
{
|
|||
|
|
return this->stackSize;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
//------------------------------------------------------------------------------
|
|||
|
|
/**
|
|||
|
|
If the derived DoWork() method is running in a loop it must regularly
|
|||
|
|
check if the process wants the thread to terminate by calling
|
|||
|
|
ThreadStopRequested() and simply return if the result is true. This
|
|||
|
|
will cause the thread to shut down.
|
|||
|
|
*/
|
|||
|
|
inline bool
|
|||
|
|
Win360Thread::ThreadStopRequested() const
|
|||
|
|
{
|
|||
|
|
return this->stopRequestEvent.Peek();
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
//------------------------------------------------------------------------------
|
|||
|
|
/**
|
|||
|
|
Set the thread's name. To obtain the current thread's name from anywhere
|
|||
|
|
in the thread's execution context, call the static method
|
|||
|
|
Thread::GetMyThreadName().
|
|||
|
|
*/
|
|||
|
|
inline void
|
|||
|
|
Win360Thread::SetName(const Util::String& n)
|
|||
|
|
{
|
|||
|
|
n_assert(n.IsValid());
|
|||
|
|
this->name = n;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
//------------------------------------------------------------------------------
|
|||
|
|
/**
|
|||
|
|
Get the thread's name. This is the vanilla method which
|
|||
|
|
returns the name member. To obtain the current thread's name from anywhere
|
|||
|
|
in the thread's execution context, call the static method
|
|||
|
|
Thread::GetMyThreadName().
|
|||
|
|
*/
|
|||
|
|
inline const Util::String&
|
|||
|
|
Win360Thread::GetName() const
|
|||
|
|
{
|
|||
|
|
return this->name;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
//------------------------------------------------------------------------------
|
|||
|
|
/**
|
|||
|
|
*/
|
|||
|
|
inline void
|
|||
|
|
Win360Thread::SetCoreId(System::Cpu::CoreId id)
|
|||
|
|
{
|
|||
|
|
this->coreId = id;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
//------------------------------------------------------------------------------
|
|||
|
|
/**
|
|||
|
|
*/
|
|||
|
|
inline System::Cpu::CoreId
|
|||
|
|
Win360Thread::GetCoreId() const
|
|||
|
|
{
|
|||
|
|
return this->coreId;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
//------------------------------------------------------------------------
|
|||
|
|
|
|||
|
|
}; // namespace Win360
|
|||
|
|
//------------------------------------------------------------------------------
|