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
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
|
/*****************************************************************************
* *
* PrimeSense PSCommon Library *
* Copyright (C) 2012 PrimeSense Ltd. *
* *
* This file is part of PSCommon. *
* *
* Licensed under the Apache License, Version 2.0 (the "License"); *
* you may not use this file except in compliance with the License. *
* You may obtain a copy of the License at *
* *
* http://www.apache.org/licenses/LICENSE-2.0 *
* *
* Unless required by applicable law or agreed to in writing, software *
* distributed under the License is distributed on an "AS IS" BASIS, *
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. *
* See the License for the specific language governing permissions and *
* limitations under the License. *
* *
*****************************************************************************/
//---------------------------------------------------------------------------
// Includes
//---------------------------------------------------------------------------
#include <XnOS.h>
#include <XnLog.h>
#include "XnWin32Internal.h"
//---------------------------------------------------------------------------
// Code
//---------------------------------------------------------------------------
XN_C_API XnStatus xnOSCreateMutex(XN_MUTEX_HANDLE* pMutexHandle)
{
return (xnOSCreateNamedMutex(pMutexHandle, NULL));
}
XN_C_API XnStatus xnOSCreateNamedMutex(XN_MUTEX_HANDLE* pMutexHandle, const XnChar* cpMutexName)
{
return xnOSCreateNamedMutexEx(pMutexHandle, cpMutexName, FALSE);
}
XN_C_API XnStatus XN_C_DECL xnOSCreateNamedMutexEx(XN_MUTEX_HANDLE* pMutexHandle, const XnChar* cpMutexName, XnBool bAllowOtherUsers)
{
// Local function variables
XnStatus nRetVal = XN_STATUS_OK;
// Validate the input/output pointers (to make sure none of them is NULL)
XN_VALIDATE_INPUT_PTR(pMutexHandle);
XnChar strMutexOSName[MAX_PATH];
XnChar* pMutexOSName = NULL;
SECURITY_ATTRIBUTES* pSecurityAttributes = NULL;
if (cpMutexName != NULL)
{
nRetVal = xnWin32CreateKernelObjectName(strMutexOSName, MAX_PATH, cpMutexName, bAllowOtherUsers);
if (nRetVal != XN_STATUS_OK)
{
return XN_STATUS_OS_MUTEX_CREATION_FAILED;
}
pMutexOSName = strMutexOSName;
nRetVal = xnWin32GetSecurityAttributes(bAllowOtherUsers, &pSecurityAttributes);
if (nRetVal != XN_STATUS_OK)
{
return XN_STATUS_OS_MUTEX_CREATION_FAILED;
}
}
// Create a named mutex via the OS
*pMutexHandle = CreateMutex(pSecurityAttributes, FALSE, pMutexOSName);
// Make sure it succeeded (return value is not null)
if (*pMutexHandle == NULL)
{
XN_LOG_WARNING_RETURN(XN_STATUS_OS_MUTEX_CREATION_FAILED, XN_MASK_OS, "Failed to create mutex (%d).", GetLastError());
}
// All is good...
return (XN_STATUS_OK);
}
XN_C_API XnStatus xnOSCloseMutex(XN_MUTEX_HANDLE* pMutexHandle)
{
// Local function variables
XnBool bRetVal = FALSE;
// Validate the input/output pointers (to make sure none of them is NULL)
XN_VALIDATE_INPUT_PTR(pMutexHandle);
// Make sure the actual mutex handle isn't NULL
XN_RET_IF_NULL(*pMutexHandle, XN_STATUS_OS_INVALID_MUTEX);
xnOSUnLockMutex(*pMutexHandle);
// Close the mutex via the OS
bRetVal = CloseHandle(*pMutexHandle);
// Make sure it succeeded (return value is true)
if (bRetVal != TRUE)
{
return (XN_STATUS_OS_MUTEX_CLOSE_FAILED);
}
// Null the output mutex
*pMutexHandle = NULL;
// All is good...
return (XN_STATUS_OK);
}
XN_C_API XnStatus xnOSLockMutex(const XN_MUTEX_HANDLE MutexHandle, XnUInt32 nMilliseconds)
{
// Local function variables
XnInt32 nRetVal = 0;
// Make sure the actual mutex handle isn't NULL
XN_RET_IF_NULL(MutexHandle, XN_STATUS_OS_INVALID_MUTEX);
// Wait for mutex to lock for a period of time (can be infinite)
nRetVal = WaitForSingleObject(MutexHandle, nMilliseconds);
// Check the return value (WAIT_OBJECT_0 is OK)
if (nRetVal != WAIT_OBJECT_0)
{
// Handle the timeout failure
if (nRetVal == WAIT_TIMEOUT)
{
return (XN_STATUS_OS_MUTEX_TIMEOUT);
}
else if (nRetVal == WAIT_ABANDONED)
{
xnLogWarning(XN_MASK_OS, "The mutex was abandoned (poor thing)");
//No return! We now own the mutex so we can continue normally.
}
else
{
return (XN_STATUS_OS_MUTEX_LOCK_FAILED);
}
}
// All is good...
return (XN_STATUS_OK);
}
XN_C_API XnStatus xnOSUnLockMutex(const XN_MUTEX_HANDLE MutexHandle)
{
// Local function variables
XnBool bRetVal = FALSE;
// Make sure the actual mutex handle isn't NULL
XN_RET_IF_NULL(MutexHandle, XN_STATUS_OS_INVALID_MUTEX);
// Release the mutex via the OS
bRetVal = ReleaseMutex(MutexHandle);
// Make sure it succeeded (return value is true)
if (bRetVal != TRUE)
{
return (XN_STATUS_OS_MUTEX_UNLOCK_FAILED);
}
// All is good...
return (XN_STATUS_OK);
}
|
