Struct MegakernelResidentBatchScratch 

pub struct MegakernelResidentBatchScratch { /* private fields */ }

Reusable host scratch for batched resident-handle megakernel dispatch.

This scratch owns the transient resource rows submitted to the backend and the nested host readback buffers returned by batched dispatch. Reusing one value across repeated batches avoids rebuilding Vec<[Resource; 4]>, Vec<Vec<Vec<u8>>>, and per-output byte slots in many-small-launch loops.

Implementations

impl MegakernelResidentBatchScratch

pub fn new() -> Self

Create empty resident-batch scratch.

pub fn with_capacity( batch_count: usize, output_slots_per_batch: usize, ) -> Result<Self, PipelineError>

Preallocate scratch for a known hot batch shape.

Errors

Returns PipelineError::Backend when OOM prevents reserving the requested capacity. Callers must handle the error; the old infallible wrapper that silently returned empty scratch on failure has been removed.

pub fn batches(&self) -> &[OutputBuffers]

Retained decoded output batches from the most recent dispatch.

pub fn batches_mut(&mut self) -> &mut Vec<OutputBuffers>

Mutable retained output batches for callers that want to drain or decode in place after dispatch.

pub fn clear(&mut self)

Clear logical scratch contents while retaining allocations.

pub fn resource_capacity(&self) -> usize

Current retained resource-row capacity.

pub fn batch_capacity(&self) -> usize

Current retained batch-row capacity.

Trait Implementations

impl Debug for MegakernelResidentBatchScratch

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

Formats the value using the given formatter.

impl Default for MegakernelResidentBatchScratch

fn default() -> MegakernelResidentBatchScratch

Returns the “default value” for a type.