Struct vmotherboard::ArcMutexChipsetDeviceBuilder

pub struct ArcMutexChipsetDeviceBuilder<'a, 'b, T> { /* private fields */ }

A builder to streamline the construction of Arc + CloseableMutex wrapped ChipsetDevice instances.

Implementations

impl<'a, 'b, T> ArcMutexChipsetDeviceBuilder<'a, 'b, T>

where T: VmmChipsetDevice,

pub fn new( name: Arc<str>, new_device_services: impl FnOnce(Weak<CloseableMutex<T>>, Arc<str>) -> ArcMutexChipsetServices<'a, 'b>, ) -> Self

Create a new ArcMutexChipsetDeviceBuilder

pub fn omit_saved_state(self) -> Self

Omit device saved state. Be careful when using this! Currently only used for MissingDev!

pub fn with_pci_addr(self, bus: u8, device: u8, function: u8) -> Self

For PCI devices: place the device at the following PCI address

pub fn on_pci_bus(self, id: BusIdPci) -> Self

For PCI devices: place the device on the specific bus

pub fn with_external_pci(self) -> Self

For PCI devices: do not register the device with any PCI bus. This is used when the device is hooked up to a bus (such as a VPCI bus) outside of the vmotherboard infrastructure.

pub fn add<F>(self, f: F) -> Result<Arc<CloseableMutex<T>>, AddDeviceError>

where F: FnOnce(&mut ArcMutexChipsetServices<'a, 'b>) -> T,

Construct a new device.

If the device can fail during initialization, use try_add instead.

Includes some basic validation that returns an error if a device attempts to use a service without also implementing the service’s corresponding ChipsetDevice::supports_ method.

pub async fn add_async<F, Fut>( self, f: F, ) -> Result<Arc<CloseableMutex<T>>, AddDeviceError>

where F: for<'c> FnOnce(&'c mut ArcMutexChipsetServices<'a, 'b>) -> Fut, Fut: Future<Output = T>,

Just like add, except async.

pub fn try_add<F, E>( self, f: F, ) -> Result<Arc<CloseableMutex<T>>, AddDeviceError>

where F: FnOnce(&mut ArcMutexChipsetServices<'a, 'b>) -> Result<T, E>, E: Into<Box<dyn Error + Send + Sync + 'static>>,

Just like add, except fallible.

pub async fn try_add_async<F, Fut, E>( self, f: F, ) -> Result<Arc<CloseableMutex<T>>, AddDeviceError>

where F: for<'c> FnOnce(&'c mut ArcMutexChipsetServices<'a, 'b>) -> Fut, Fut: Future<Output = Result<T, E>>, E: Into<Box<dyn Error + Send + Sync + 'static>>,

Just like try_add, except async.

pub fn services(&mut self) -> &mut ArcMutexChipsetServices<'a, 'b>

Get a mutable reference to the device’s services.