Struct DriverChain 

pub struct DriverChain { /* private fields */ }

Driver-owned descriptor chain and buffers.

Construction allocates metadata proportional only to the caller-provided descriptor vector. Queue publication, completion, and reset do not allocate or copy payload bytes.

Implementations

impl DriverChain

pub fn direct(descriptors: Vec<Descriptor>) -> Result<Self, ChainBuildError>

Construct a valid direct chain linked in vector order.

pub fn raw( descriptors: Vec<Descriptor>, head: u16, ) -> Result<Self, ChainBuildError>

Construct a raw descriptor table for deterministic malformed-chain injection.

next values are local indices in descriptors. Structural errors are retained and later exposed by SplitDeviceChain::io when the chain is injected into a queue.

pub fn descriptor_count(&self) -> u16

Number of descriptor-table entries owned by this chain.

pub fn validation(&self) -> Result<ChainLayout, MalformedChain>

Validate descriptor topology independently of a queue’s configured chain limit.

pub fn read_descriptor( &self, index: u16, offset: u64, target: &mut [u8], ) -> Result<(), ByteAccessError>

Read bytes from one local descriptor after the queue returns ownership.

pub fn write_descriptor( &self, index: u16, offset: u64, source: &[u8], ) -> Result<(), ByteAccessError>

Write bytes into one local descriptor while the driver owns the chain.

Trait Implementations

impl Debug for DriverChain

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

Formats the value using the given formatter.

impl DriverChainBuffer for DriverChain

type Error = ByteAccessError

Concrete transport byte-access failure.

fn device_readable_len(&self) -> u64

Total bytes readable by the device.

fn device_writable_len(&self) -> u64

Total bytes writable by the device.

fn write_device_readable( &mut self, offset: u64, source: &[u8], ) -> Result<(), Self::Error>

Write an exact logical range into the device-readable side.

fn read_device_writable( &self, offset: u64, target: &mut [u8], ) -> Result<(), Self::Error>

Read an exact logical range from the device-writable side after completion.