Struct Virtqueue 

pub struct Virtqueue { /* private fields */ }

A VirtIO virtqueue

This structure manages the split virtqueue format as described in VirtIO spec section 2.6 (Split Virtqueues).

Implementations

impl Virtqueue

pub unsafe fn new(queue_size: u16) -> Result<Self, &'static str>

Create a new virtqueue with the specified size

Safety

The caller must ensure that the allocated memory is properly mapped and accessible.

pub fn desc_area(&self) -> u64

Get the physical address of the descriptor table

pub fn avail_area(&self) -> u64

Get the physical address of the available ring

pub fn used_area(&self) -> u64

Get the physical address of the used ring

pub fn size(&self) -> u16

Get the queue size

pub fn alloc_descriptor(&mut self) -> Option<u16>

Allocate a descriptor chain

Returns the head descriptor index

pub fn free_descriptor(&mut self, head: u16)

Free a descriptor chain

Walks the chain following NEXT flags and frees all descriptors

pub fn add_buffer( &mut self, buffers: &[(u64, u32, bool)], ) -> Result<u16, &'static str>

Add a buffer to the virtqueue

Returns the descriptor index (token) that can be used to track completion

Arguments

• buffers: A list of (physical_address, length, is_write_only)

pub fn has_used(&self) -> bool

Check if there are any used buffers

pub fn get_used(&mut self) -> Option<(u16, u32)>

Get the next used buffer

Returns (descriptor_index, length_written)

pub fn should_notify(&self) -> bool

Notify the device (should write to queue_notify register)

Trait Implementations

impl Send for Virtqueue