3985f0151a
* Added a way to notify a Module that it's been attached to a ProcessThread. The benefit of this is to give the module a way to wake up the thread when it needs work to happen on the worker thread, immediately. Today, module instances are typically registered with a process thread outside the control of the modules themselves. I.e. they typically don't know about the process thread they're attached to. * Improve ProcessThread's WakeUp algorithm to not call TimeUntilNextProcess when a WakeUp call is requested. This is an optimization for the above case which avoids the module having to acquire a lock or do an interlocked operation before calling WakeUp(), which would ensure the module's TimeUntilNextProcess() implementation would return 0. BUG=2822 R=stefan@webrtc.org Review URL: https://webrtc-codereview.appspot.com/39239004 Cr-Commit-Position: refs/heads/master@{#8527} git-svn-id: http://webrtc.googlecode.com/svn/trunk@8527 4adac7df-926f-26a2-2b94-8c16560cd09d
51 lines
1.7 KiB
C++
51 lines
1.7 KiB
C++
/*
|
|
* Copyright (c) 2011 The WebRTC project authors. All Rights Reserved.
|
|
*
|
|
* Use of this source code is governed by a BSD-style license
|
|
* that can be found in the LICENSE file in the root of the source
|
|
* tree. An additional intellectual property rights grant can be found
|
|
* in the file PATENTS. All contributing project authors may
|
|
* be found in the AUTHORS file in the root of the source tree.
|
|
*/
|
|
|
|
#ifndef WEBRTC_MODULES_UTILITY_INTERFACE_PROCESS_THREAD_H_
|
|
#define WEBRTC_MODULES_UTILITY_INTERFACE_PROCESS_THREAD_H_
|
|
|
|
#include "webrtc/typedefs.h"
|
|
#include "webrtc/base/scoped_ptr.h"
|
|
|
|
namespace webrtc {
|
|
class Module;
|
|
|
|
class ProcessThread {
|
|
public:
|
|
virtual ~ProcessThread();
|
|
|
|
static rtc::scoped_ptr<ProcessThread> Create();
|
|
|
|
// Starts the worker thread. Must be called from the construction thread.
|
|
virtual void Start() = 0;
|
|
|
|
// Stops the worker thread. Must be called from the construction thread.
|
|
virtual void Stop() = 0;
|
|
|
|
// Wakes the thread up to give a module a chance to do processing right
|
|
// away. This causes the worker thread to wake up and requery the specified
|
|
// module for when it should be called back. (Typically the module should
|
|
// return 0 from TimeUntilNextProcess on the worker thread at that point).
|
|
// Can be called on any thread.
|
|
virtual void WakeUp(Module* module) = 0;
|
|
|
|
// Adds a module that will start to receive callbacks on the worker thread.
|
|
// Can be called from any thread.
|
|
virtual void RegisterModule(Module* module) = 0;
|
|
|
|
// Removes a previously registered module.
|
|
// Can be called from any thread.
|
|
virtual void DeRegisterModule(Module* module) = 0;
|
|
};
|
|
|
|
} // namespace webrtc
|
|
|
|
#endif // WEBRTC_MODULES_UTILITY_INTERFACE_PROCESS_THREAD_H_
|