Struct Medium 

pub struct Medium<T = File> { /* private fields */ }

An opened VHDX medium.

Obtain via Medium::open followed by OpenOptions::finish, or via Medium::create followed by CreateOptions::finish.

Implementations

impl<T> Medium<T>

pub fn get_ref(&self) -> InnerRef<'_, T>

Borrow the caller-provided underlying medium.

Panics

Panics if the internal medium lock is poisoned.

pub fn get_mut(&mut self) -> &mut T

Mutably borrow the caller-provided underlying medium.

Warning

Direct mutation can invalidate cached header, BAT, metadata, log, and validator views. Prefer the crate’s structured APIs for VHDX data-plane and metadata operations.

Panics

Panics if the internal medium lock is poisoned.

pub fn into_inner(self) -> T

Consume this VHDX wrapper and return the underlying medium.

pub fn create(inner: T) -> CreateOptions<T>

Begin creating a new VHDX on a caller-provided medium.

pub fn open(inner: T) -> OpenOptions<T, ReadOnly>

Begin opening an existing VHDX medium (read-only by default).

Returns an options builder for chaining configuration. Call finish to complete the open operation.

impl<T> Medium<T>

where T: Read + Seek,

pub fn io(&mut self) -> Result<IO<'_, T>>

Return a new IO handle for sector-level reads and writes.

Errors

Returns an error if VHDX metadata needed to construct the I/O view is invalid.

impl<T> Medium<T>

where T: Read + Seek,

pub fn sections(&self) -> Result<Sections<'_, T>>

Return a Sections container for this file.

Errors

Returns an error if the header section cannot be loaded or parsed.

pub fn validator(&mut self) -> Result<SpecValidator>

Return a new SpecValidator for structural validation.

The validator owns an Arc<[u8]> snapshot from the file’s validator_buf cache. The snapshot contains all region data assembled at their correct file offsets and uses the file’s strict mode setting.

Panics

Panics if file metadata/header buffers are internally inconsistent.

Errors

Returns an error if the VHDX structure cannot be loaded for validation.

Trait Implementations

impl<T> Debug for Medium<T>

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

Formats the value using the given formatter.

impl<T> ParentMedium for Medium<T>

where T: Read + Seek,

fn data_write_guid(&mut self) -> Result<Guid>

Parent Data Write GUID used for differencing linkage validation.

fn logical_sector_size(&mut self) -> Result<u32>

Parent logical sector size in bytes.

fn read_sector(&mut self, sector: u64, buf: &mut [u8]) -> Result<()>

Read one effective parent sector into buf.