You've already forked llvm-project
mirror of
https://github.com/AdaCore/llvm-project.git
synced 2026-02-12 13:52:35 -08:00
7c6edf4a05
Add info queries for queues and events. `olGetQueueInfo` only supports getting the associated device. We were already tracking this so we can implement this for free. We will likely add other queries to it in the future (whether the queue is empty, what flags it was created with, etc) `olGetEventInfo` only supports getting the associated queue. This is another thing we were already storing in the handle. We'll be able to add other queries in future (the event type, status, etc)
80 lines
2.7 KiB
TableGen
80 lines
2.7 KiB
TableGen
//===-- Event.td - Event definitions for Offload -----------*- tablegen -*-===//
|
|
//
|
|
// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
|
|
// See https://llvm.org/LICENSE.txt for license information.
|
|
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
//
|
|
// This file contains Offload API definitions related to the event handle
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
def : Function {
|
|
let name = "olDestroyEvent";
|
|
let desc = "Destroy the event and free all underlying resources.";
|
|
let details = [];
|
|
let params = [
|
|
Param<"ol_event_handle_t", "Event", "handle of the event", PARAM_IN>
|
|
];
|
|
let returns = [];
|
|
}
|
|
|
|
def : Function {
|
|
let name = "olWaitEvent";
|
|
let desc = "Wait for the event to be complete.";
|
|
let details = [];
|
|
let params = [
|
|
Param<"ol_event_handle_t", "Event", "handle of the event", PARAM_IN>
|
|
];
|
|
let returns = [];
|
|
}
|
|
|
|
def : Enum {
|
|
let name = "ol_event_info_t";
|
|
let desc = "Supported event info.";
|
|
let is_typed = 1;
|
|
let etors = [
|
|
TaggedEtor<"QUEUE", "ol_queue_handle_t", "The handle of the queue associated with the device.">
|
|
];
|
|
}
|
|
|
|
def : Function {
|
|
let name = "olGetEventInfo";
|
|
let desc = "Queries the given property of the event.";
|
|
let details = [
|
|
"`olGetEventInfoSize` can be used to query the storage size "
|
|
"required for the given query."
|
|
];
|
|
let params = [
|
|
Param<"ol_event_handle_t", "Event", "handle of the event", PARAM_IN>,
|
|
Param<"ol_event_info_t", "PropName", "type of the info to retrieve", PARAM_IN>,
|
|
Param<"size_t", "PropSize", "the number of bytes pointed to by PropValue.", PARAM_IN>,
|
|
TypeTaggedParam<"void*", "PropValue", "array of bytes holding the info. "
|
|
"If PropSize is not equal to or greater to the real number of bytes needed to return the info "
|
|
"then the OL_ERRC_INVALID_SIZE error is returned and PropValue is not used.", PARAM_OUT,
|
|
TypeInfo<"PropName" , "PropSize">>
|
|
];
|
|
let returns = [
|
|
Return<"OL_ERRC_INVALID_SIZE", [
|
|
"`PropSize == 0`",
|
|
"If `PropSize` is less than the real number of bytes needed to return the info."
|
|
]>,
|
|
Return<"OL_ERRC_INVALID_EVENT">
|
|
];
|
|
}
|
|
|
|
def : Function {
|
|
let name = "olGetEventInfoSize";
|
|
let desc = "Returns the storage size of the given event query.";
|
|
let details = [];
|
|
let params = [
|
|
Param<"ol_event_handle_t", "Event", "handle of the event", PARAM_IN>,
|
|
Param<"ol_event_info_t", "PropName", "type of the info to query", PARAM_IN>,
|
|
Param<"size_t*", "PropSizeRet", "pointer to the number of bytes required to store the query", PARAM_OUT>
|
|
];
|
|
let returns = [
|
|
Return<"OL_ERRC_INVALID_EVENT">
|
|
];
|
|
}
|