64 lines
1.9 KiB
C++
64 lines
1.9 KiB
C++
//---------------------------------------------------------------------------//
|
|
// Copyright (c) 2013-2015 Kyle Lutz <kyle.r.lutz@gmail.com>
|
|
//
|
|
// Distributed under the Boost Software License, Version 1.0
|
|
// See accompanying file LICENSE_1_0.txt or copy at
|
|
// http://www.boost.org/LICENSE_1_0.txt
|
|
//
|
|
// See http://boostorg.github.com/compute for more information.
|
|
//---------------------------------------------------------------------------//
|
|
|
|
#ifndef BOOST_COMPUTE_ASYNC_WAIT_GUARD_HPP
|
|
#define BOOST_COMPUTE_ASYNC_WAIT_GUARD_HPP
|
|
|
|
#include <boost/noncopyable.hpp>
|
|
|
|
namespace boost {
|
|
namespace compute {
|
|
|
|
/// \class wait_guard
|
|
/// \brief A guard object for synchronizing an operation on the device
|
|
///
|
|
/// The wait_guard class stores a waitable object representing an operation
|
|
/// on a compute device (e.g. \ref event, \ref future "future<T>") and calls
|
|
/// its \c wait() method when the guard object goes out of scope.
|
|
///
|
|
/// This is useful for ensuring that an OpenCL operation completes before
|
|
/// leaving the current scope and cleaning up any resources.
|
|
///
|
|
/// For example:
|
|
/// \code
|
|
/// // enqueue a compute kernel for execution
|
|
/// event e = queue.enqueue_nd_range_kernel(...);
|
|
///
|
|
/// // call e.wait() upon exiting the current scope
|
|
/// wait_guard<event> guard(e);
|
|
/// \endcode
|
|
///
|
|
/// \ref wait_list, wait_for_all()
|
|
template<class Waitable>
|
|
class wait_guard : boost::noncopyable
|
|
{
|
|
public:
|
|
/// Creates a new wait_guard object for \p waitable.
|
|
wait_guard(const Waitable &waitable)
|
|
: m_waitable(waitable)
|
|
{
|
|
}
|
|
|
|
/// Destroys the wait_guard object. The default implementation will call
|
|
/// \c wait() on the stored waitable object.
|
|
~wait_guard()
|
|
{
|
|
m_waitable.wait();
|
|
}
|
|
|
|
private:
|
|
Waitable m_waitable;
|
|
};
|
|
|
|
} // end compute namespace
|
|
} // end boost namespace
|
|
|
|
#endif // BOOST_COMPUTE_ASYNC_WAIT_GUARD_HPP
|