15821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Copyright (c) 2012 The Chromium Authors. All rights reserved. 25821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Use of this source code is governed by a BSD-style license that can be 35821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// found in the LICENSE file. 45821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 55821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#ifndef PPAPI_UTILITY_THREADING_SIMPLE_THREAD_H_ 65821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define PPAPI_UTILITY_THREADING_SIMPLE_THREAD_H_ 75821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 85821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#ifdef WIN32 95821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include <windows.h> 105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#else 115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include <pthread.h> 125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#endif 135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "ppapi/cpp/instance_handle.h" 152a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)#include "ppapi/cpp/message_loop.h" 165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)namespace pp { 185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// This class is a simple wrapper around a pthread/Windows thread that creates 205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// and runs a PPAPI message loop on that thread. 215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class SimpleThread { 225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) public: 235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#ifdef WIN32 245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) typedef HANDLE ThreadHandle; 255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#else 265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) typedef pthread_t ThreadHandle; 275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#endif 285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 292a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) typedef void (*ThreadFunc)(MessageLoop&, void* user_data); 305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) explicit SimpleThread(const InstanceHandle& instance); 322a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) explicit SimpleThread(const InstanceHandle& instance, size_t stacksize); 335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ~SimpleThread(); 345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Starts a thread and runs a message loop in it. If you need control over 365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // how the message loop is run, use StartWithFunction. Returns true on 375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // success, false if the thread is already running or couldn't be started. 385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool Start(); 395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Posts a quit message to the message loop and blocks until the thread 415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // exits. Returns true on success. If the thread is not running, returns 425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // false. 435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool Join(); 445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Normally you can just use Start() to start a thread, and then post work to 465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // it. In some cases you will want control over the message. If ThreadFunc 475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // is NULL, this acts the same as Start(). 485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool StartWithFunction(ThreadFunc func, void* user_data); 495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 502a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) MessageLoop& message_loop() { return message_loop_; } 515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ThreadHandle thread() const { return thread_; } 525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) private: 545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) InstanceHandle instance_; 552a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) MessageLoop message_loop_; 562a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) const size_t stacksize_; 575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ThreadHandle thread_; 585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Disallow (not implemented). 605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) SimpleThread(const SimpleThread&); 612a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) SimpleThread(const SimpleThread&, size_t stacksize); 625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) SimpleThread& operator=(const SimpleThread&); 635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} // namespace pp 665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#endif // PPAPI_UTILITY_THREADING_SIMPLE_THREAD_H_ 685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 69