]>
Commit | Line | Data |
---|---|---|
1 | /* | |
2 | * Copyright (C) 2007, 2008 Apple Inc. All rights reserved. | |
3 | * Copyright (C) 2007 Justin Haygood (jhaygood@reaktix.com) | |
4 | * | |
5 | * Redistribution and use in source and binary forms, with or without | |
6 | * modification, are permitted provided that the following conditions | |
7 | * are met: | |
8 | * | |
9 | * 1. Redistributions of source code must retain the above copyright | |
10 | * notice, this list of conditions and the following disclaimer. | |
11 | * 2. Redistributions in binary form must reproduce the above copyright | |
12 | * notice, this list of conditions and the following disclaimer in the | |
13 | * documentation and/or other materials provided with the distribution. | |
14 | * 3. Neither the name of Apple Computer, Inc. ("Apple") nor the names of | |
15 | * its contributors may be used to endorse or promote products derived | |
16 | * from this software without specific prior written permission. | |
17 | * | |
18 | * THIS SOFTWARE IS PROVIDED BY APPLE AND ITS CONTRIBUTORS "AS IS" AND ANY | |
19 | * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED | |
20 | * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE | |
21 | * DISCLAIMED. IN NO EVENT SHALL APPLE OR ITS CONTRIBUTORS BE LIABLE FOR ANY | |
22 | * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES | |
23 | * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; | |
24 | * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND | |
25 | * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT | |
26 | * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF | |
27 | * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | |
28 | */ | |
29 | ||
30 | #ifndef MainThread_h | |
31 | #define MainThread_h | |
32 | ||
33 | namespace WTF { | |
34 | ||
35 | class Mutex; | |
36 | ||
37 | typedef void MainThreadFunction(void*); | |
38 | ||
39 | void callOnMainThread(MainThreadFunction*, void* context); | |
40 | ||
41 | // Blocks the thread until the call finishes on the main thread. Misusing this can easily cause deadlocks. | |
42 | void callOnMainThreadAndWait(MainThreadFunction*, void* context); | |
43 | ||
44 | void setMainThreadCallbacksPaused(bool paused); | |
45 | ||
46 | // Must be called from the main thread (Darwin is an exception to this rule). | |
47 | void initializeMainThread(); | |
48 | ||
49 | // These functions are internal to the callOnMainThread implementation. | |
50 | void initializeMainThreadPlatform(); | |
51 | void scheduleDispatchFunctionsOnMainThread(); | |
52 | Mutex& mainThreadFunctionQueueMutex(); | |
53 | void dispatchFunctionsFromMainThread(); | |
54 | ||
55 | } // namespace WTF | |
56 | ||
57 | using WTF::callOnMainThread; | |
58 | using WTF::callOnMainThreadAndWait; | |
59 | using WTF::setMainThreadCallbacksPaused; | |
60 | ||
61 | #endif // MainThread_h |