Struct VmiSessionPauseGuard 

pub struct VmiSessionPauseGuard<'a, Os>
where
    Os: VmiOs,
    Os::Driver: VmiQueryRegisters + VmiVmControl,
{ /* private fields */ }

A guard that pauses the virtual machine and snapshots the boot CPU registers on creation, then resumes the VM on drop.

Unlike VmiPauseGuard, this guard carries enough register context to build a VmiState via state, so callers can introspect the paused guest without separately querying registers.

Implementations

impl<'a, Os> VmiSessionPauseGuard<'a, Os>

where Os: VmiOs, Os::Driver: VmiQueryRegisters + VmiVmControl,

pub fn new(session: &'a VmiSession<'a, Os>) -> Result<Self, VmiError>

Creates a new pause guard.

pub fn session(&self) -> &VmiSession<'a, Os>

Returns the VMI session.

pub fn registers(&self) -> &<Os::Architecture as Architecture>::Registers

Returns the boot CPU (VcpuId(0)) registers captured when the guard was created.

pub fn state(&self) -> VmiState<'_, Os>

Returns the state captured when the guard was created, bound to the boot CPU (VcpuId(0)) registers.

Trait Implementations

impl<Os> Drop for VmiSessionPauseGuard<'_, Os>

where Os: VmiOs, Os::Driver: VmiQueryRegisters + VmiVmControl,

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.