Struct OutputRing 

pub struct OutputRing {
    pub slot_bytes: usize,
    pub alloc_dims: (u32, u32),
    pub metrics: RingMetrics,
    /* private fields */
}

Fixed-size ring of pre-allocated device buffers for inference output.

Fields

slot_bytes: usize

Size of each slot in bytes (3 × out_w × out_h × sizeof(f32)).

alloc_dims: (u32, u32)

Input dimensions (width, height) used to allocate the current slots.

metrics: RingMetrics

Atomic counters tracking reuse, contention, and first-use events.

Implementations

impl OutputRing

pub fn new( ctx: &GpuContext, in_w: u32, in_h: u32, scale: u32, count: usize, min_slots: usize, ) -> Result<Self>

Allocate count output buffers.

min_slots is the enforced minimum (downstream_capacity + 2). Returns error if count < min_slots.

pub fn acquire(&mut self) -> Result<Arc<CudaSlice<u8>>>

Acquire the next ring slot for writing.

Serialization invariant

Asserts Arc::strong_count == 1 before returning. If downstream still holds a reference, returns error and increments contention counter.

pub fn needs_realloc(&self, in_w: u32, in_h: u32) -> bool

Return true if the current slot dimensions differ from (in_w, in_h).

pub fn reallocate( &mut self, ctx: &GpuContext, in_w: u32, in_h: u32, scale: u32, ) -> Result<()>

Reallocate all slots. All must have strong_count == 1.

pub fn len(&self) -> usize

Total number of slots.

pub fn is_empty(&self) -> bool

Return true if the ring has no slots (should not happen in normal operation).