Struct Event 

pub struct Event { /* private fields */ }

A CUDA event for timing and synchronisation.

Events are lightweight markers that can be recorded into a Stream. They support two primary use-cases:

1. Timing — measure elapsed GPU time between two recorded events via Event::elapsed_time.
2. Synchronisation — make one stream wait for work recorded in another stream via Stream::wait_event.

Implementations

impl Event

pub fn new() -> CudaResult<Self>

Creates a new event with CU_EVENT_DEFAULT flags.

Default events record timing data. Use Event::with_flags to create events with different characteristics (e.g. disable timing for lower overhead).

Errors

Returns a CudaError if the driver call fails.

pub fn with_flags(flags: u32) -> CudaResult<Self>

Creates a new event with the specified flags.

Common flag values (from crate::ffi):

Constant	Value	Description
CU_EVENT_DEFAULT	0	Default (records timing)
CU_EVENT_BLOCKING_SYNC	1	Use blocking synchronisation
CU_EVENT_DISABLE_TIMING	2	Disable timing (lower overhead)
CU_EVENT_INTERPROCESS	4	Usable across processes

Flags can be combined with bitwise OR.

Errors

Returns a CudaError if the flags are invalid or the driver call otherwise fails.

pub fn record(&self, stream: &Stream) -> CudaResult<()>

Records this event on the given stream.

The event captures the point in the stream’s command queue at which it was recorded. Subsequent calls to Event::synchronize or Event::elapsed_time reference this recorded point.

Errors

Returns a CudaError if the stream or event handle is invalid.

pub fn query(&self) -> CudaResult<bool>

Queries whether this event has completed.

Returns Ok(true) if the event (and all preceding work in its stream) has completed, Ok(false) if it is still pending.

Errors

Returns a CudaError if the event was not recorded or an unexpected driver error occurs (errors other than NotReady).

pub fn synchronize(&self) -> CudaResult<()>

Blocks the calling thread until this event has been recorded and all preceding work in its stream has completed.

Errors

Returns a CudaError if the event was not recorded or the driver reports an error.

pub fn elapsed_time(start: &Event, end: &Event) -> CudaResult<f32>

Computes the elapsed time in milliseconds between two recorded events.

Both start and end must have been previously recorded on a stream, and end must have completed (e.g. via Event::synchronize).

Errors

Returns a CudaError if either event has not been recorded, or if timing data is not available (e.g. the events were created with CU_EVENT_DISABLE_TIMING).

pub fn raw(&self) -> CUevent

Returns the raw CUevent handle.

Safety (caller)

The caller must not destroy or otherwise invalidate the handle while this Event is still alive.

Trait Implementations

impl Drop for Event

fn drop(&mut self)

Executes the destructor for this type.

impl Send for Event