Struct VmoMapping 

pub struct VmoMapping { /* private fields */ }

An active mapping of a Vmo in the root Vmar.

The mapped memory is kept mapped while the VmoMapping object is alive.

Implementations

impl VmoMapping

pub fn map( offset: usize, size: usize, vmo: Vmo, ) -> Result<MmioRegion<VmoMemory>, Status>

Map the specified memory range of the given Vmo in the root Vmar for this process and return an object that maintains the mapping for its lifetime.

Errors:

• Status::OUT_OF_RANGE: if size > isize::MAX.
• Status::OUT_OF_RANGE: if the requested region falls outside of the vmo’s memory.
• An error returned by zx::Vmar::map: if the mapping fails.

pub fn map_with_cache_policy( offset: usize, size: usize, vmo: Vmo, cache_policy: CachePolicy, ) -> Result<MmioRegion<VmoMemory>, Status>

Like VmoMapping::map but specifying a cache_policy.

NOTE: Code targeting a real MMIO mapped region must always use CachePolicy::UnCachedDevice and production code should prefer to use VmoMapping::map. This is exposed exclusively to allow test code to pick a different cache policy when vmo is not in fact backed by an actual MMIO VMO.

Trait Implementations

impl Drop for VmoMapping

Unmaps the memory.

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.