Struct UnregisteredDevice

pub struct UnregisteredDevice<T: Driver>(/* private fields */);

A Device which is known at compile-time to be unregistered with userspace.

This type allows performing operations which are only safe to do before userspace registration, and can be used to create a Registration once the driver is ready to register the device with userspace.

Since DRM device initialization must be single-threaded, this object is not thread-safe.

Invariants

The device in self.0 is guaranteed to be a newly created Device that has not yet been registered with userspace until this type is dropped.

Implementations

impl<T: Driver> UnregisteredDevice<T>

pub fn new( dev: &T::ParentDevice<Bound>, data: impl PinInit<T::Data, Error>, ) -> Result<Self>

Create a new UnregisteredDevice for a drm::Driver.

This can be used to create a Registration.

Methods from Deref<Target = Device<T, Normal>>

pub fn registration_guard(&self) -> Option<RegistrationGuard<'_, T>>

Guard against the parent bus device being unbound.

Returns a RegistrationGuard if the device has not been unplugged, None otherwise.

While RegistrationGuard is held the parent device is guaranteed to be bound.

pub fn registration_data_with<R, F>(&self, f: F) -> R

where F: for<'a> FnOnce(&'a T::RegistrationData<'a>) -> R,

Access the registration data through a closure, with the lifetime tied to the closure scope.

The data is owned by Registration and is guaranteed to remain valid as long as the device is registered, since Registration’s drop calls drm_dev_unplug() which waits for all drm_dev_enter() critical sections to complete.

Trait Implementations

impl<T: Driver> Deref for UnregisteredDevice<T>

type Target = Device<T>

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.