Struct ArcMutexChipsetDeviceBuilder

pub struct ArcMutexChipsetDeviceBuilder<S, T> { /* private fields */ }

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

Implementations

impl<S, T> ArcMutexChipsetDeviceBuilder<S, T>

where T: ChipsetDevice, S: ChipsetServices + ArcMutexChipsetServicesFinalize<T>,

pub fn new( name: Arc<str>, new_device_services: impl FnOnce(Weak<CloseableMutex<dyn ChipsetDevice>>, Arc<str>) -> S, ) -> ArcMutexChipsetDeviceBuilder<S, T>

Create a new ArcMutexChipsetDeviceBuilder

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 with_external_pci(self) -> Self

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

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

where F: FnOnce(&mut S) -> 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: AsyncFnOnce(&mut S) -> T,

Just like add, except async.

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

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

Just like add, except fallible.

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

where F: AsyncFnOnce(&mut S) -> Result<T, E>, E: Into<Box<dyn Error + Send + Sync + 'static>>,

Just like try_add, except async.