Struct DescriptorChain 

pub struct DescriptorChain { /* private fields */ }

Iterator over the descriptors in a single chain (head + linked descriptors via NEXT).

Implementations

impl DescriptorChain

pub fn head_index(&self) -> u16

Index of the head descriptor — pass to Queue::push_used when completing the chain.

pub fn next_descriptor<M: GuestMemory + ?Sized>( &mut self, mem: &M, ) -> Result<Option<Descriptor>, QueueError>

Read the next descriptor in the chain, if any.

Returns Ok(None) when the chain is fully traversed.

Errors

• QueueError::DescriptorOutOfRange if next exceeds queue_size.
• QueueError::ChainTooLong if the chain length exceeds queue_size (cycle protection).
• QueueError::Memory for any descriptor table read failure.

pub fn collect<M: GuestMemory + ?Sized>( self, mem: &M, ) -> Result<Vec<Descriptor>, QueueError>

Drain the chain into a Vec<Descriptor>. Convenience for short chains where the caller wants to pre-collect.

Errors

Same as Self::next_descriptor.

Trait Implementations

impl Debug for DescriptorChain

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

Formats the value using the given formatter.