Struct BootVirtqueue 

struct BootVirtqueue {
    vring_phys: u64,
    vring_virt: u64,
    queue_size: u16,
    avail_idx: u16,
    last_used_idx: u16,
}

Minimal boot-time virtqueue with a static vring allocation.

Legacy MMIO layout requires the vring to occupy physically-contiguous pages with the three sections page-aligned: ┌─ Page 0: descriptor table (page-aligned) ├─ Page 1: available ring (page-aligned) └─ Page 2: used ring (tail, may share page 3)

Fields

vring_phys: u64

Physical address of the vring base (written to QueuePFN >> 12).

vring_virt: u64

Virtual (HHDM) address of the vring base.

queue_size: u16

Queue size.

avail_idx: u16

Next available index.

last_used_idx: u16

Last observed used index.

Implementations

impl BootVirtqueue

unsafe fn init(device_base: u64, queue_size: u16) -> Result<Self, &'static str>

Allocate and initialise a boot-time virtqueue.

Safety

device_base must be a valid MMIO VirtIO device address.

unsafe fn read_block( &mut self, device_base: u64, lba: u64, bounce_phys: u64, bounce_virt: u64, buf: &mut [u8], ) -> Result<(), ()>

Submit a single-block read request and busy-poll for completion.

Uses a 3-descriptor chain: header (device-read) | data (device-write) | status (device-write).

Safety

device_base must be a valid MMIO VirtIO device address.

Trait Implementations

impl Drop for BootVirtqueue

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.