layers/gpu/spirv/inject_function_pass.h

/* Copyright (c) 2024 LunarG, Inc.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
#pragma once

#include "pass.h"

namespace gpuav {
namespace spirv {

// A type of common pass that will inject a function call and link it up later.
// We assume through other means (such as robustness) we won't crash on bad values and go
//     PassFunction(original_value)
//     value = original_value;
class InjectFunctionPass : public Pass {
  public:
    bool Run();

  protected:
    InjectFunctionPass(Module& module);

    // Each pass decides if the instruction should needs to have its function check injected
    virtual bool RequiresInstrumentation(const Function& function, const Instruction& inst) = 0;
    // A callback from the function injection logic.
    // Each pass creates a OpFunctionCall and returns its result id.
    // If |inst_it| is not null, it will update it to instruction post OpFunctionCall
    virtual uint32_t CreateFunctionCall(BasicBlock& block, InstructionIt* inst_it, const InjectionData& injection_data) = 0;
};

}  // namespace spirv
}  // namespace gpuav