Struct VirtioMemoryRange 

pub struct VirtioMemoryRange { /* private fields */ }

Describes a memory region accessible by a virtio device.

The memory region is contiguous in the PCI device’s physical address space. If no IOMMU is involved, the PCI device’s physical address space is the same as the CPU physical address space visible to the guest (virtualized) OS.

Each instance describes a memory region that is submitted (owned by the device) or is about to be submitted (owned by the device). Device ownership is conceptually equivalent to a Rust mutable reference covering the entire memory range. Here are two immediate implications:

1. No Rust references may point into a range described by an instance.
2. The memory ranges described by any two instances must not overlap.

Implementations

impl VirtioMemoryRange

pub unsafe fn new( start_physical_address: u64, size: NonZero<u32>, device_access: VirtioMemoryRangeAccess, ) -> VirtioMemoryRange

Describes a memory range that will be submitted to a virtio device.

Safety

start_physical_address and size must identify a valid range of memory that is contiguous in the PCI virtio device’s physical address space. The newly created instance must be treated like a mutable Rust reference covering the entire memory range.

pub fn start_physical_address(&self) -> u64

Points to the first byte in the memory region.

Uses the PCI device’s physical addressable space.

pub fn size(&self) -> NonZero<u32>

The number of bytes that make up the contiguous region.

pub fn device_access(&self) -> VirtioMemoryRangeAccess

Constrains a device’s accesses to the memory range.

Trait Implementations

impl Debug for VirtioMemoryRange

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

Formats the value using the given formatter.