summaryrefslogtreecommitdiffstats
path: root/src/OSSupport/CriticalSection.h
blob: 236a7d203b2d2b9ddd1b77271ff53479f64e7548 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81

#pragma once
#include <mutex>
#include <thread>





class cCriticalSection
{
public:
	void Lock(void);
	void Unlock(void);
	
	// IsLocked / IsLockedByCurrentThread are only used in ASSERT statements, but because of the changes with ASSERT they must always be defined
	// The fake versions (in Release) will not effect the program in any way
	#ifdef _DEBUG
		cCriticalSection(void);
		bool IsLocked(void);
		bool IsLockedByCurrentThread(void);
	#else
		bool IsLocked(void) { return false; }
		bool IsLockedByCurrentThread(void) { return false; }
	#endif  // _DEBUG
	
private:

	#ifdef _DEBUG
	int           m_IsLocked;  // Number of times this CS is locked
	std::thread::id m_OwningThreadID;
	#endif  // _DEBUG
	
	std::recursive_mutex m_Mutex;
} ALIGN_8;




/** RAII for cCriticalSection - locks the CS on creation, unlocks on destruction */
class cCSLock
{
	cCriticalSection * m_CS;

	// Unlike a cCriticalSection, this object should be used from a single thread, therefore access to m_IsLocked is not threadsafe
	// In Windows, it is an error to call cCriticalSection::Unlock() multiple times if the lock is not held,
	// therefore we need to check this value whether we are locked or not.
	bool m_IsLocked;
	
public:
	cCSLock(cCriticalSection * a_CS);
	cCSLock(cCriticalSection & a_CS);
	~cCSLock();
	
	// Temporarily unlock or re-lock:
	void Lock(void);
	void Unlock(void);

private:
	DISALLOW_COPY_AND_ASSIGN(cCSLock);
} ;





/** Temporary RAII unlock for a cCSLock. Useful for unlock-wait-relock scenarios */
class cCSUnlock
{
	cCSLock & m_Lock;
public:
	cCSUnlock(cCSLock & a_Lock);
	~cCSUnlock();
	
private:
	DISALLOW_COPY_AND_ASSIGN(cCSUnlock);
} ;