Enum CompletionHandle

Source

pub enum CompletionHandle {
    Ready,
    Pending(Box<dyn Completion>),
}

Expand description

A node’s completion signal, returned by execute_compiled. Step E Phase A1 foundation: today every dispatch is synchronous, so this is always CompletionHandle::Ready (the work finished before the call returned) and callers wait it immediately — byte-identical to the prior Result<()>. Phases A2/A3 add an async GPU path that returns CompletionHandle::Pending carrying a device fence/event the executor defers the wait on.

#[must_use]: dropping a Pending handle without waiting would leak un-awaited async work (harmless for today’s Ready, a correctness bug once A2/A3 land) — callers must wait it or thread it to the executor.

Variants§

§

Ready

The work finished synchronously before execute_compiled returned — wait is a no-op.

§

Pending(Box<dyn Completion>)

The work was enqueued asynchronously; wait blocks until the carried device signal fires. (No producers until A2/A3.)

CompletionHandle

Enum CompletionHandle Copy item path

Variants§

Ready

Pending(Box<dyn Completion>)

Implementations§

impl CompletionHandle

pub fn wait(self) -> Result<()>

Auto Trait Implementations§

impl !RefUnwindSafe for CompletionHandle

impl !Sync for CompletionHandle

impl !UnwindSafe for CompletionHandle

impl Freeze for CompletionHandle

impl Send for CompletionHandle

impl Unpin for CompletionHandle

impl UnsafeUnpin for CompletionHandle

Blanket Implementations§

impl<T> Any for Twhere T: 'static + ?Sized,

fn type_id(&self) -> TypeId

impl<T> Borrow<T> for Twhere T: ?Sized,

fn borrow(&self) -> &T

impl<T> BorrowMut<T> for Twhere T: ?Sized,

fn borrow_mut(&mut self) -> &mut T

impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DTwhere ST: ?Sized, DT: ?Sized,

impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DTwhere ST: ?Sized, DT: ?Sized,

impl<T> From<T> for T

fn from(t: T) -> T

impl<T> Instrument for T

fn instrument(self, span: Span) -> Instrumented<Self> ⓘ

fn in_current_span(self) -> Instrumented<Self> ⓘ

impl<T, U> Into<U> for Twhere U: From<T>,

fn into(self) -> U

impl<T> IntoEither for T

fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘwhere F: FnOnce(&Self) -> bool,

impl<T> Pointable for T

const ALIGN: usize

type Init = T

unsafe fn init(init: <T as Pointable>::Init) -> usize

unsafe fn deref<'a>(ptr: usize) -> &'a T

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

unsafe fn drop(ptr: usize)

impl<T> Read<Exclusive, BecauseExclusive> for Twhere T: ?Sized,

impl<T, U> TryFrom<U> for Twhere U: Into<T>,

type Error = !

fn try_from(value: U) -> Result<T, !>

impl<T, U> TryInto<U> for Twhere U: TryFrom<T>,

type Error = <U as TryFrom<T>>::Error

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

impl<V, T> VZip<V> for Twhere V: MultiLane<T>,

fn vzip(self) -> V

impl<T> WithSubscriber for T

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> ⓘwhere S: Into<Dispatch>,

fn with_current_subscriber(self) -> WithDispatch<Self> ⓘ

Enum CompletionHandle

impl<T> Any for T
where T: 'static + ?Sized,

impl<T> Borrow<T> for T
where T: ?Sized,

impl<T> BorrowMut<T> for T
where T: ?Sized,

impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
where ST: ?Sized, DT: ?Sized,

impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
where ST: ?Sized, DT: ?Sized,

impl<T, U> Into<U> for T
where U: From<T>,

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
where F: FnOnce(&Self) -> bool,

impl<T> Read<Exclusive, BecauseExclusive> for T
where T: ?Sized,

impl<T, U> TryFrom<U> for T
where U: Into<T>,

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> ⓘ
where S: Into<Dispatch>,