Struct RegistrationGuard

pub struct RegistrationGuard<'a, T: Driver> { /* private fields */ }

A guard proving the DRM device is registered and the parent bus device is bound.

The guard dereferences to Device<T, Registered>, providing access to the DRM device with the guarantee that the parent bus device is bound for the entire duration of the critical section.

Internally this is backed by a drm_dev_enter() / drm_dev_exit() SRCU critical section.

Invariants

• idx is the SRCU read lock index returned by a successful drm_dev_enter() call.
• The parent bus device of dev is bound for the lifetime of this guard.

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

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 RegistrationGuard<'_, T>

type Target = Device<T, Registered>

The resulting type after dereferencing.

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

Dereferences the value.

impl<T: Driver> Drop for RegistrationGuard<'_, T>

fn drop(&mut self)

Executes the destructor for this type.