Struct VAccelAdapter 

pub struct VAccelAdapter<A> { /* private fields */ }

Adapter seam from a concrete backend to the portable accelerator contract.

Implementations

impl<A> VAccelAdapter<A>

pub fn new(inner: A) -> Self

Create a new adapter around a concrete backend.

pub fn backend(&self) -> &A

Borrow the wrapped backend to reach provider-specific metrics.

pub fn backend_mut(&mut self) -> &mut A

Borrow the wrapped backend mutably.

pub fn into_inner(self) -> A

Consume the adapter and return the underlying backend.

pub fn direct_binding_admissions(&self) -> u64

Number of observed accepted binding admissions.

This counter is a first-order signal for backends that do not expose their native direct-bindings counters yet.

pub fn explicit_transfer_bytes(&self) -> u64

Total bytes passed through explicit host transfers.

This includes bytes requested by explicit write_buffer and read_buffer calls.

pub fn reset_submission_path_metrics(&self)

Reset adapter-level metrics collected during the current integration window.

Trait Implementations

impl<A: Accelerator> Accelerator for VAccelAdapter<A>

type Context = <A as Accelerator>::Context

Owned context handle. It may be a native value and need not be boxed, cloneable, or thread safe.

type Buffer = <A as Accelerator>::Buffer

Owned handle for the exact allocation described by its accompanying [BufferInfo].

type Program = <A as Accelerator>::Program

Owned resident-program handle with no borrow of its source artifact.

type Queue = <A as Accelerator>::Queue

Owned accelerator execution-queue handle.

type Event = <A as Accelerator>::Event

Owned submission and completion token with no borrow of the submitted binding slice.

fn device_info(&self) -> Result<DeviceInfo, BackendError>

Return immutable identity, capability, and limit metadata.

fn create_context( &self, desc: ContextDesc, ) -> Result<Self::Context, BackendError>

Create one context from prevalidated intent.

fn destroy_context( &self, context: Self::Context, ) -> Result<(), ReleaseFailure<Self::Context>>

Destroy an empty context.

fn allocate_buffer( &self, context: &Self::Context, desc: BufferDesc, ) -> Result<AllocatedBuffer<Self::Buffer>, BackendError>

Allocate one exact provider-owned buffer backing.

fn write_buffer( &self, buffer: &mut Self::Buffer, offset: u64, data: &dyn ByteSource, ) -> Result<(), BackendError>

Perform one explicit host-to-buffer transfer.

fn read_buffer( &self, buffer: &Self::Buffer, offset: u64, data: &mut dyn ByteSink, ) -> Result<(), BackendError>

Perform one explicit buffer-to-host transfer.

fn free_buffer( &self, buffer: Self::Buffer, ) -> Result<(), ReleaseFailure<Self::Buffer>>

Release an unreferenced buffer and its exact backing allocation.

fn load_program( &self, context: &Self::Context, artifact: ArtifactRef<'_>, ) -> Result<Self::Program, BackendError>

Create a resident program from an opaque, possibly segmented artifact.

fn unload_program( &self, program: Self::Program, ) -> Result<(), ReleaseFailure<Self::Program>>

Release an unreferenced resident program.

fn create_queue( &self, context: &Self::Context, desc: QueueDesc, ) -> Result<Self::Queue, BackendError>

Create one accelerator execution queue.

fn destroy_queue( &self, queue: Self::Queue, ) -> Result<(), ReleaseFailure<Self::Queue>>

Release an unreferenced execution queue.

fn submit( &self, queue: &Self::Queue, program: &Self::Program, bindings: &[BindingRef<'_, Self::Buffer>], timeout: Timeout, ) -> Result<Self::Event, SubmitFailure<Self::Event>>

Attempt to admit one program execution and return its event.

fn poll_event(&self, event: &Self::Event) -> Result<EventState, BackendError>

Observe event state without blocking or driving an executor.

fn cancel_event(&self, event: &Self::Event) -> Result<(), BackendError>

Attempt to make a pending event terminal as [EventState::Cancelled].

fn destroy_event( &self, event: Self::Event, ) -> Result<(), ReleaseFailure<Self::Event>>

Release one terminal event and its provider invocation state.

impl<A: Debug> Debug for VAccelAdapter<A>

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

Formats the value using the given formatter.