Struct ocl_core::types::abs::Event

#[repr(C)]
pub struct Event(/* private fields */);

cl_event

Implementations

impl Event

pub fn null() -> Event

For passage directly to an ‘event creation’ function (such as enqueue…).

pub fn user<C: ClContextPtr>(context: C) -> OclCoreResult<Event>

Creates and returns a new ‘user’ event.

User events are events which are meant to have their completion status set from the host side (that means you).

pub unsafe fn from_raw_create_ptr(ptr: cl_event) -> Event

Only call this when passing the original newly created pointer directly from clCreate.... Do not use this to clone or copy.

pub unsafe fn from_raw_copied_ptr(ptr: cl_event) -> OclCoreResult<Event>

Only use when cloning or copying from a pre-existing and valid cl_event.

pub fn set_complete(&self) -> OclCoreResult<()>

Sets this user created event to CommandExecutionStatus::Complete.

Will return an error if this event is not a ‘user’ event (created with ::user()).

pub fn is_complete(&self) -> OclCoreResult<bool>

Queries the command status associated with this event and returns true if it is complete, false if incomplete or upon error.

This is the fastest possible way to determine event status.

pub fn wait_for(&self) -> OclCoreResult<()>

Causes the command queue to wait until this event is complete before returning.

pub fn is_null(&self) -> bool

Returns whether or not this event is associated with a command or is a user event.

pub fn is_valid(&self) -> bool

[FIXME]: ADD VALIDITY CHECK BY CALLING ‘_INFO’ OR SOMETHING: NULL CHECK IS NOT ENOUGH

This still leads to crazy segfaults when non-event pointers (random whatever addresses) are passed. Need better check.

pub unsafe fn set_callback( &self, callback_receiver: EventCallbackFn, user_data_ptr: *mut c_void ) -> OclCoreResult<()>

Sets a callback function, callback_receiver, to trigger upon completion of this event with an optional pointer to user data.

The callback function must have a signature matching: extern "C" fn (ffi::cl_event, i32, *mut libc::c_void)

Safety

user_data must be guaranteed to still exist if and when callback_receiver is ever called.

TODO: Create a safer type wrapper for callback_receiver (using an Arc?, etc.) within ocl.

pub fn context(&self) -> OclCoreResult<Context>

Returns the Context associated with this event.

pub unsafe fn as_ptr_ref(&self) -> &cl_event

Returns an immutable reference to a pointer, do not deref and store it unless you will manage its associated reference count carefully.

Warning

DO NOT store this pointer.

DO NOT send this pointer across threads unless you are incrementing the reference count before sending and decrementing after sending.

Use ::into_raw for these purposes. Thank you.

pub unsafe fn as_ptr_mut(&mut self) -> &mut cl_event

Returns a mutable reference to a pointer, do not deref then modify or store it unless you will manage its associated reference count carefully.

Warning

DO NOT store this pointer.

DO NOT send this pointer across threads unless you are incrementing the reference count before sending and decrementing after sending.

Use ::into_raw for these purposes. Thank you.

pub fn into_raw(self) -> cl_event

Consumes the Event, returning the wrapped cl_event pointer.

To avoid a memory leak the pointer must be converted back to an Event using Event::from_raw.

pub unsafe fn from_raw(ptr: cl_event) -> Event

Constructs an Event from a raw cl_event pointer.

The raw pointer must have been previously returned by a call to a Event::into_raw.

Trait Implementations

impl AsRef<Event> for Event

fn as_ref(&self) -> &Event

Converts this type into a shared reference of the (usually inferred) input type.

impl<'e> ClEventPtrRef<'e> for Event

unsafe fn as_ptr_ref(&'e self) -> &'e cl_event

impl<'a> ClNullEventPtr for &'a mut Event

fn alloc_new(&mut self) -> *mut cl_event

unsafe fn clone_from<E: AsRef<Event>>(&mut self, ev: E)

impl<'a> ClWaitListPtr for &'a Event

unsafe fn as_ptr_ptr(&self) -> *const cl_event

Returns a pointer to the first pointer in this list.

fn count(&self) -> u32

Returns the number of items in this wait list.

impl ClWaitListPtr for Event

unsafe fn as_ptr_ptr(&self) -> *const cl_event

Returns a pointer to the first pointer in this list.

fn count(&self) -> u32

Returns the number of items in this wait list.

impl Clone for Event

fn clone(&self) -> Event

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Event

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Drop for Event

fn drop(&mut self)

Executes the destructor for this type.

impl Hash for Event

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for Event

fn eq(&self, other: &Event) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for Event

impl Send for Event

impl StructuralEq for Event

impl StructuralPartialEq for Event

impl Sync for Event