blob: 49e93fc922f990aeab152c009d41b7797e8470aa (
plain)
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
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
|
/*******************************************************************************
* $Copyright ST-Ericsson 2011 $
******************************************************************************/
/*
* @addtogroup critical_section
* @{
*/
/*******************************************************************************
* Includes
******************************************************************************/
#include <windows.h>
#include "r_critical_section.h"
/*******************************************************************************
* File scope types, constants and variables
******************************************************************************/
/*******************************************************************************
* Declaration of internal functions
******************************************************************************/
/*******************************************************************************
* Definition of external functions
******************************************************************************/
/**
* Perform initialization of Critical Section.
*
* Creates a critical section object and returns pointer to it for later usage
* when it is needed to enter and leave the critical part of the code,
* and destroy the critical section object when not used anymore.
*
* @retval Pointer to initialized critical section object if initialization was
* successful, otherwise NULL.
*/
CriticalSection_t Do_CriticalSection_Create(void)
{
CRITICAL_SECTION* cs = (CRITICAL_SECTION*)malloc(sizeof(CRITICAL_SECTION));
if (NULL != cs) {
InitializeCriticalSection(cs);
}
return (CriticalSection_t)cs;
}
/**
* Free resources used for Critical Section object.
*
* Free all resources and destroy the critical section object given as parameter
* to the function.
*
* @param [in] CriticalSectionObject Pointer to pointer at the object to be destroyed.
*
* @retval None.
*/
void Do_CriticalSection_Destroy(CriticalSection_t *CriticalSectionObject)
{
CRITICAL_SECTION** cs = (CRITICAL_SECTION**)CriticalSectionObject;
if (NULL != *cs) {
DeleteCriticalSection(*cs);
free(*cs);
*cs = NULL;
}
}
/**
* Enter to the Critical Section code.
*
* Take ownership over critical section object and execute the part of the code
* covered by the Critical Section object passed as parameter to the function.
*
* @param [in] CriticalSectionObject Pointer to the object used to exclusively
* lock some critical part of the code.
*
* @retval TRUE if Critical Section code entered successfully, otherwise FALSE.
*/
boolean Do_CriticalSection_Enter(CriticalSection_t CriticalSectionObject)
{
CRITICAL_SECTION* cs = (CRITICAL_SECTION*)CriticalSectionObject;
if (NULL != cs) {
EnterCriticalSection(cs);
}
return TRUE;
}
/**
* Leave the Critical Section code.
*
* Release the Critical Section object when finished execution to allow someone
* else to execute the code covered by the Critical Section object passed as
* parameter to the function.
*
* @param [in] CriticalSectionObject Pointer to the object used to exclusively
* lock some critical part of the code.
*
* @retval None.
*/
void Do_CriticalSection_Leave(CriticalSection_t CriticalSectionObject)
{
CRITICAL_SECTION* cs = (CRITICAL_SECTION*)CriticalSectionObject;
if (NULL != cs) {
LeaveCriticalSection(cs);
}
}
/*******************************************************************************
* Definition of internal functions
******************************************************************************/
/* @} */
|
