Enum TimingRequest 

pub enum TimingRequest {
    None,
    Resolved,
    Deferred,
}

What an observer asks be done with each launch’s measurement.

Declared once, by timing: the launch path has to know where a measurement will go before it takes one.

It must not change while an observation is installed. A launch bracketed under one answer and delivered under another loses a measurement that has already been paid for. An observer that measures only part of a run keeps that region in its own state, rather than changing its answer here.

Variants

None

Don’t time launches. The default, because timing is not free.

Resolved

Time each launch and read its measurement back, delivering the length to timed.

Reading blocks the issuing thread until the kernel has run, so kernels run one at a time and their sum is not the pass’s device time. Right for each kernel’s own cost, wrong for measuring a pipeline.

Deferred

Time each launch and hand its measurement over unread, to profiled.

Nothing waits, so the kernels around it keep running back to back and the observer reads them once the pass is over. Right for measuring where a pass spends its time.

Only while the profiling logger is off. A measurement is read once, and past ExecutionOnly the logger needs it too, so the launch path reads it there and delivers a length to timed instead — which runs the kernels one at a time. An observer whose figures only mean something on a pipelined pass should say so when timings arrive that way.

Trait Implementations

impl Clone for TimingRequest

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for TimingRequest

impl Debug for TimingRequest

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

Formats the value using the given formatter.

impl Default for TimingRequest

fn default() -> Self

Returns the “default value” for a type.

impl Eq for TimingRequest

impl PartialEq for TimingRequest

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for TimingRequest