1
    2
    3
    4
    5
    6
    7
    8
    9
   10
   11
   12
   13
   14
   15
   16
   17
   18
   19
   20
   21
   22
   23
   24
   25
   26
   27
   28
   29
   30
   31
   32
   33
   34
   35
   36
   37
   38
   39
   40
   41
   42
   43
   44
   45
   46
   47
   48
   49
   50
   51
   52
   53
   54
   55
   56
   57
   58
   59
   60
   61
   62
   63
   64
   65
   66
   67
   68
   69
   70
   71
   72
   73
   74
   75
   76
   77
   78

gpu / command_buffer / service / blocking_sequence_runner.h [blame]

// Copyright 2024 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef GPU_COMMAND_BUFFER_SERVICE_BLOCKING_SEQUENCE_RUNNER_H_
#define GPU_COMMAND_BUFFER_SERVICE_BLOCKING_SEQUENCE_RUNNER_H_

#include <vector>

#include "base/memory/raw_ptr.h"
#include "base/synchronization/lock.h"
#include "base/thread_annotations.h"
#include "base/time/time.h"
#include "gpu/command_buffer/common/sync_token.h"
#include "gpu/command_buffer/service/sequence_id.h"
#include "gpu/command_buffer/service/task_graph.h"
#include "gpu/gpu_export.h"

namespace gpu {

class Scheduler;

// BlockingSequenceRunner owns a TaskGraph::Sequence and supports running
// its tasks blockingly.
class GPU_EXPORT BlockingSequenceRunner {
 public:
  explicit BlockingSequenceRunner(Scheduler* scheduler) LOCKS_EXCLUDED(lock());

  BlockingSequenceRunner(const BlockingSequenceRunner&) = delete;
  BlockingSequenceRunner& operator=(const BlockingSequenceRunner&) = delete;

  ~BlockingSequenceRunner() LOCKS_EXCLUDED(lock());

  SequenceId GetSequenceId() const;

  bool HasTasks() const LOCKS_EXCLUDED(lock());

  uint32_t AddTask(TaskCallback task_calback,
                   std::vector<SyncToken> wait_fences,
                   const SyncToken& release,
                   ReportingCallback report_callback = {})
      LOCKS_EXCLUDED(lock());

  uint32_t AddTask(base::OnceClosure task_closure,
                   std::vector<SyncToken> wait_fences,
                   const SyncToken& release,
                   ReportingCallback report_callback = {})
      LOCKS_EXCLUDED(lock());

  [[nodiscard]] ScopedSyncPointClientState CreateSyncPointClientState(
      CommandBufferNamespace namespace_id,
      CommandBufferId command_buffer_id) LOCKS_EXCLUDED(lock());

  // Runs tasks in the sequence blockingly until the sequence is empty.
  void RunAllTasks() LOCKS_EXCLUDED(lock());

 private:
  class Sequence : public TaskGraph::Sequence {
   public:
    explicit Sequence(Scheduler* scheduler);

    void RunAllTasks() EXCLUSIVE_LOCKS_REQUIRED(lock());

   private:
    const raw_ptr<Scheduler> scheduler_ = nullptr;
  };

  base::Lock& lock() const LOCK_RETURNED(task_graph_->lock()) {
    return task_graph_->lock();
  }

  const raw_ptr<TaskGraph> task_graph_ = nullptr;
  raw_ptr<Sequence> sequence_ = nullptr;
};

}  // namespace gpu

#endif  // GPU_COMMAND_BUFFER_SERVICE_BLOCKING_SEQUENCE_RUNNER_H_