// Copyright 2014 Citra Emulator Project // Licensed under GPLv2 or any later version // Refer to the license.txt file included. #pragma once #include #include #include "core/hle/kernel/object.h" namespace Kernel { class KernelCore; class Thread; /// Class that represents a Kernel object that a thread can be waiting on class WaitObject : public Object { public: explicit WaitObject(KernelCore& kernel); ~WaitObject() override; /** * Check if the specified thread should wait until the object is available * @param thread The thread about which we're deciding. * @return True if the current thread should wait due to this object being unavailable */ virtual bool ShouldWait(Thread* thread) const = 0; /// Acquire/lock the object for the specified thread if it is available virtual void Acquire(Thread* thread) = 0; /** * Add a thread to wait on this object * @param thread Pointer to thread to add */ void AddWaitingThread(SharedPtr thread); /** * Removes a thread from waiting on this object (e.g. if it was resumed already) * @param thread Pointer to thread to remove */ void RemoveWaitingThread(Thread* thread); /** * Wake up all threads waiting on this object that can be awoken, in priority order, * and set the synchronization result and output of the thread. */ void WakeupAllWaitingThreads(); /** * Wakes up a single thread waiting on this object. * @param thread Thread that is waiting on this object to wakeup. */ void WakeupWaitingThread(SharedPtr thread); /// Obtains the highest priority thread that is ready to run from this object's waiting list. SharedPtr GetHighestPriorityReadyThread(); /// Get a const reference to the waiting threads list for debug use const std::vector>& GetWaitingThreads() const; private: /// Threads waiting for this object to become available std::vector> waiting_threads; }; // Specialization of DynamicObjectCast for WaitObjects template <> inline SharedPtr DynamicObjectCast(SharedPtr object) { if (object != nullptr && object->IsWaitable()) { return boost::static_pointer_cast(object); } return nullptr; } } // namespace Kernel