Struct DescriptorChain 

pub struct DescriptorChain { /* private fields */ }

A fully validated, device-agnostic VirtIO descriptor chain.

The common queue layer hands complete, direction-tagged chains to device implementations (block, net, …) so that each device can interpret its own wire layout without leaking protocol specifics into the queue code.

Direction follows the VirtIO convention:

• readable descriptors are device-read (driver-written, not WRITE).
• writable descriptors are device-write (driver-read, WRITE set).

Implementations

impl DescriptorChain

pub fn new(head: u16, descriptors: Vec<VirtQueueDesc>) -> Self

Construct a chain from its head index and ordered descriptors.

pub fn head(&self) -> u16

The head descriptor index (avail-ring entry value).

pub fn descriptors(&self) -> &[VirtQueueDesc]

All descriptors in chain order.

pub fn len(&self) -> usize

Number of descriptors in the chain.

pub fn is_empty(&self) -> bool

Whether the chain is empty.

pub fn readable(&self) -> impl Iterator<Item = &VirtQueueDesc>

Device-readable descriptors (driver-written, no VIRTQ_DESC_F_WRITE).

pub fn writable(&self) -> impl Iterator<Item = &VirtQueueDesc>

Device-writable descriptors (VIRTQ_DESC_F_WRITE set).

pub fn readable_len(&self) -> VirtioResult<usize>

Total bytes across device-readable descriptors, checked against overflow.

pub fn writable_len(&self) -> VirtioResult<usize>

Total bytes across device-writable descriptors, checked against overflow.

Trait Implementations

impl Clone for DescriptorChain

fn clone(&self) -> DescriptorChain

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for DescriptorChain

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

Formats the value using the given formatter.