Struct VpciBus

pub struct VpciBus { /* private fields */ }

A VPCI bus, which can be used to enumerate PCI devices to a guest over vmbus.

Note that this implementation only allows a single device per bus currently. In practice, this is the only used and well-tested configuration in Hyper-V.

Implementations

impl VpciBus

pub async fn new( driver_source: &VmTaskDriverSource, instance_id: Guid, device: Arc<CloseableMutex<dyn ChipsetDevice>>, register_mmio: &mut dyn RegisterMmioIntercept, vmbus: &dyn ParentBus, msi_controller: Arc<dyn VpciInterruptMapper>, ) -> Result<Self, CreateBusError>

Creates a new VPCI bus.

Trait Implementations

impl ChangeDeviceState for VpciBus

fn start(&mut self)

Starts a device, allowing it to interact with the guest asynchronously.

async fn stop(&mut self)

Stops a device’s asynchronous work.

async fn reset(&mut self)

Resets the device state to its initial state, for a fresh boot.

impl ChipsetDevice for VpciBus

fn supports_mmio(&mut self) -> Option<&mut dyn MmioIntercept>

Optionally returns a trait object to send MMIO port intercepts to.

fn supports_pio(&mut self) -> Option<&mut (dyn PortIoIntercept + 'static)>

Optionally returns a trait object to send IO port intercepts to.

fn supports_pci(&mut self) -> Option<&mut (dyn PciConfigSpace + 'static)>

Optionally returns a trait object to send PCI config space accesses to.

fn supports_poll_device(&mut self) -> Option<&mut dyn PollDevice>

Optionally returns a trait object to send poll requests to.

fn supports_line_interrupt_target( &mut self, ) -> Option<&mut dyn LineInterruptTarget>

Optionally returns a trait object to send interrupt line changes to.

fn supports_handle_eoi(&mut self) -> Option<&mut dyn HandleEoi>

Optionally returns a trait object to send EOI requests to.

fn supports_acknowledge_pic_interrupt( &mut self, ) -> Option<&mut dyn AcknowledgePicInterrupt>

Optionally returns a trait object with which to acknowledge PIC interrupts.

impl InspectMut for VpciBus

fn inspect_mut(&mut self, req: Request<'_>)

Inspects the object.

impl MmioIntercept for VpciBus

fn mmio_read(&mut self, addr: u64, data: &mut [u8]) -> IoResult

Dispatch an MMIO read to the device with the given address.

fn mmio_write(&mut self, addr: u64, data: &[u8]) -> IoResult

Dispatch an MMIO write to the device with the given address.

fn get_static_regions(&mut self) -> &[(&str, RangeInclusive<u64>)]

Report a set of static static mmio regions (region_name, gpa_range) that cannot be remapped at runtime and are always registered.

impl SaveRestore for VpciBus

type SavedState = NoSavedState

The concrete saved state type.

fn save(&mut self) -> Result<Self::SavedState, SaveError>

Saves the object’s state.

fn restore( &mut self, NoSavedState: Self::SavedState, ) -> Result<(), RestoreError>

Restores the object’s state.