LibreOffice
LibreOffice 24.2 SDK C/C++ API Reference
threadpool.h
Go to the documentation of this file.
1 /* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
2 /*
3  * This file is part of the LibreOffice project.
4  *
5  * This Source Code Form is subject to the terms of the Mozilla Public
6  * License, v. 2.0. If a copy of the MPL was not distributed with this
7  * file, You can obtain one at http://mozilla.org/MPL/2.0/.
8  *
9  * This file incorporates work covered by the following license notice:
10  *
11  * Licensed to the Apache Software Foundation (ASF) under one or more
12  * contributor license agreements. See the NOTICE file distributed
13  * with this work for additional information regarding copyright
14  * ownership. The ASF licenses this file to you under the Apache
15  * License, Version 2.0 (the "License"); you may not use this file
16  * except in compliance with the License. You may obtain a copy of
17  * the License at http://www.apache.org/licenses/LICENSE-2.0 .
18  */
19 
20 /*
21  * This file is part of LibreOffice published API.
22  */
23 
24 #ifndef INCLUDED_UNO_THREADPOOL_H
25 #define INCLUDED_UNO_THREADPOOL_H
26 
27 #include "cppu/cppudllapi.h"
28 #include "sal/types.h"
29 
30 #ifdef __cplusplus
31 extern "C" {
32 #endif
33 
34 /***
35  * Thread identifier administration.
36  ***/
53 
54 
65 CPPU_DLLPUBLIC void SAL_CALL uno_getIdOfCurrentThread( sal_Sequence **ppThreadId )
67 
68 
75 
76 
77 struct _uno_ThreadPool;
78 typedef struct _uno_ThreadPool * uno_ThreadPool;
79 
86 
87 
99 CPPU_DLLPUBLIC void SAL_CALL
101 
111 CPPU_DLLPUBLIC void SAL_CALL
112 uno_threadpool_enter( uno_ThreadPool hPool , void **ppJob )
114 
120 CPPU_DLLPUBLIC void SAL_CALL
122 
153 CPPU_DLLPUBLIC void SAL_CALL
155  uno_ThreadPool hPool,
156  sal_Sequence *pThreadId,
157  void *pJob,
158  void ( SAL_CALL * doRequest ) ( void *pThreadSpecificData ),
159  sal_Bool bIsOneway ) SAL_THROW_EXTERN_C();
160 
172 CPPU_DLLPUBLIC void SAL_CALL
174 
175 
185 CPPU_DLLPUBLIC void SAL_CALL
187 
188 #ifdef __cplusplus
189 }
190 #endif
191 
192 #endif // INCLUDED_UNO_THREADPOOL_H
193 
194 /* vim:set shiftwidth=4 softtabstop=4 expandtab: */
CPPU_DLLPUBLIC uno_ThreadPool uno_threadpool_create() SAL_THROW_EXTERN_C()
Creates a threadpool handle.
#define SAL_THROW_EXTERN_C()
Nothrow specification for C functions.
Definition: types.h:334
CPPU_DLLPUBLIC void uno_threadpool_destroy(uno_ThreadPool hPool) SAL_THROW_EXTERN_C()
Releases the previously with uno_threadpool_create() created handle.
CPPU_DLLPUBLIC sal_Bool uno_bindIdToCurrentThread(sal_Sequence *pThreadId) SAL_THROW_EXTERN_C()
Establishes an association between the current thread and the given thread identifier.
CPPU_DLLPUBLIC void uno_releaseIdFromCurrentThread() SAL_THROW_EXTERN_C()
If the internal refcount drops to zero, the association between threadId and thread is broken...
This is the binary specification of a SAL sequence.
Definition: types.h:303
struct _uno_ThreadPool * uno_ThreadPool
Definition: threadpool.h:78
CPPU_DLLPUBLIC void uno_threadpool_attach(uno_ThreadPool hPool) SAL_THROW_EXTERN_C()
Makes the current thread known to the threadpool.
#define CPPU_DLLPUBLIC
Definition: cppudllapi.h:13
CPPU_DLLPUBLIC void uno_threadpool_detach(uno_ThreadPool hPool) SAL_THROW_EXTERN_C()
Detaches the current thread from the threadpool.
unsigned char sal_Bool
Definition: types.h:38
CPPU_DLLPUBLIC void uno_threadpool_putJob(uno_ThreadPool hPool, sal_Sequence *pThreadId, void *pJob, void(*doRequest)(void *pThreadSpecificData), sal_Bool bIsOneway) SAL_THROW_EXTERN_C()
Puts a job into the pool.
CPPU_DLLPUBLIC void uno_threadpool_dispose(uno_ThreadPool hPool) SAL_THROW_EXTERN_C()
All threads, that are waiting on the hPool handle, are forced out of the pool.
CPPU_DLLPUBLIC void uno_getIdOfCurrentThread(sal_Sequence **ppThreadId) SAL_THROW_EXTERN_C()
Get the identifier of the current thread.
CPPU_DLLPUBLIC void uno_threadpool_enter(uno_ThreadPool hPool, void **ppJob) SAL_THROW_EXTERN_C()
This method is called to wait for a reply of a previously sent request.