xref: /aosp_15_r20/external/deqp/framework/delibs/dethread/deThread.h (revision 35238bce31c2a825756842865a792f8cf7f89930)
1 #ifndef _DETHREAD_H
2 #define _DETHREAD_H
3 /*-------------------------------------------------------------------------
4  * drawElements Thread Library
5  * ---------------------------
6  *
7  * Copyright 2014 The Android Open Source Project
8  *
9  * Licensed under the Apache License, Version 2.0 (the "License");
10  * you may not use this file except in compliance with the License.
11  * You may obtain a copy of the License at
12  *
13  *      http://www.apache.org/licenses/LICENSE-2.0
14  *
15  * Unless required by applicable law or agreed to in writing, software
16  * distributed under the License is distributed on an "AS IS" BASIS,
17  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
18  * See the License for the specific language governing permissions and
19  * limitations under the License.
20  *
21  *//*!
22  * \file
23  * \brief Thread management.
24  *//*--------------------------------------------------------------------*/
25 
26 #include "deDefs.h"
27 
28 DE_BEGIN_EXTERN_C
29 
30 /* Basic types associated with threads. */
31 typedef uintptr_t deThread;
32 typedef void (*deThreadFunc)(void *arg);
33 
34 /*--------------------------------------------------------------------*//*!
35  * \brief Thread scheduling priority.
36  *//*--------------------------------------------------------------------*/
37 typedef enum deThreadPriority_e
38 {
39     DE_THREADPRIORITY_LOWEST = 0,
40     DE_THREADPRIORITY_LOW,
41     DE_THREADPRIORITY_NORMAL,
42     DE_THREADPRIORITY_HIGH,
43     DE_THREADPRIORITY_HIGHEST,
44 
45     DE_THREADPRIORITY_LAST
46 } deThreadPriority;
47 
48 /*--------------------------------------------------------------------*//*!
49  * \brief Thread attributes.
50  *//*--------------------------------------------------------------------*/
51 typedef struct deThreadAttributes_s
52 {
53     deThreadPriority priority;
54 } deThreadAttributes;
55 
56 void deSleep(uint32_t milliseconds);
57 void deYield(void);
58 
59 deThread deThread_create(deThreadFunc func, void *arg, const deThreadAttributes *attributes);
60 bool deThread_join(deThread thread);
61 void deThread_destroy(deThread thread);
62 
63 uint32_t deGetNumTotalPhysicalCores(void);
64 uint32_t deGetNumTotalLogicalCores(void);
65 uint32_t deGetNumAvailableLogicalCores(void);
66 
67 DE_END_EXTERN_C
68 
69 #endif /* _DETHREAD_H */
70