Struct VirtioBlkDriver

pub struct VirtioBlkDriver {
    mmio_base: u64,
    transport: VirtioTransport,
    features: u64,
    info: BlockDeviceInfo,
    queue: VirtqueueState,
    in_flight: [InFlightRequest; 32],
    next_desc_set: u16,
    headers_cpu: *mut VirtioBlkReqHeader,
    status_cpu: *mut u8,
}

VirtIO block device driver.

Fields

mmio_base: u64

MMIO base address (legacy) or common_cfg (PCI Modern)

transport: VirtioTransport

Transport handle for device operations

features: u64

Negotiated features

info: BlockDeviceInfo

Device info

queue: VirtqueueState

Virtqueue state

in_flight: [InFlightRequest; 32]

In-flight requests

next_desc_set: u16

Next free descriptor set (each request uses 3)

headers_cpu: *mut VirtioBlkReqHeader

Headers CPU pointer

status_cpu: *mut u8

Status CPU pointer

Implementations

impl VirtioBlkDriver

pub unsafe fn new( mmio_base: u64, config: VirtioBlkConfig, ) -> Result<Self, VirtioBlkInitError>

Create and initialize VirtIO-blk driver.

Safety

• mmio_base must be valid VirtIO-blk MMIO address
• config must contain valid physical addresses

pub unsafe fn new_with_transport( transport: VirtioTransport, config: VirtioBlkConfig, _tsc_freq: u64, ) -> Result<Self, VirtioBlkInitError>

Create and initialize VirtIO-blk driver using transport abstraction.

This supports both MMIO (legacy) and PCI Modern transports.

Safety

• Transport addresses must be valid
• config must contain valid physical addresses

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

Allocate a descriptor set (3 consecutive descriptors).

fn header_phys(&self, slot_idx: usize) -> u64

Get header physical address for a descriptor set.

fn status_phys(&self, slot_idx: usize) -> u64

Get status physical address for a descriptor set.

fn read_status(&self, slot_idx: usize) -> u8

Read status byte for a slot.

Trait Implementations

impl BlockDriver for VirtioBlkDriver

fn info(&self) -> BlockDeviceInfo

Get device information.

fn can_submit(&self) -> bool

Check if device can accept a new request.

fn submit_read( &mut self, sector: u64, buffer_phys: u64, num_sectors: u32, request_id: u32, ) -> Result<(), BlockError>

Submit a read request.

fn submit_write( &mut self, sector: u64, buffer_phys: u64, num_sectors: u32, request_id: u32, ) -> Result<(), BlockError>

Submit a write request.

fn poll_completion(&mut self) -> Option<BlockCompletion>

Poll for completed requests.

fn notify(&mut self)

Notify device that requests are pending.

fn flush(&mut self) -> Result<(), BlockError>

Flush any pending writes (if supported).

impl BlockDriverInit for VirtioBlkDriver

type Error = VirtioBlkInitError

Error type for initialization failures.

type Config = VirtioBlkConfig

Configuration type.

fn supported_vendors() -> &'static [u16]

PCI vendor IDs this driver supports.

fn supported_devices() -> &'static [u16]

PCI device IDs this driver supports.

unsafe fn create( mmio_base: u64, config: Self::Config, ) -> Result<Self, Self::Error>

Create driver from MMIO base and configuration.

fn supports_device(vendor: u16, device: u16) -> bool

Check if driver supports a PCI device.

impl Send for VirtioBlkDriver