Struct ResidentHandle 

pub struct ResidentHandle { /* private fields */ }

A resident buffer handle that names both the buffer and the backend instance that owns it.

Carrying the owner is what makes presenting a foreign handle a refusal at the API boundary rather than a silent resolve against unrelated device memory, so a caller can hold a handle across instances without having to remember a check.

Implementations

impl ResidentHandle

pub fn owner(self) -> ResidentOwner

Backend instance that allocated this buffer.

pub fn id(self) -> u64

Buffer id within its owner’s namespace.

Only meaningful together with ResidentHandle::owner; use ResidentOwner::resolve to obtain it for a lookup.

Trait Implementations

impl Clone for ResidentHandle

fn clone(&self) -> ResidentHandle

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for ResidentHandle

impl Debug for ResidentHandle

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for ResidentHandle

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Prints the owning instance alongside the id, never the id alone.

A bare id is precisely the identifier that was unsafe to trust: two live instances each have a buffer 3, so a log line or error naming only 3 cannot be acted on.

impl Eq for ResidentHandle

impl From<ResidentHandle> for Resource

fn from(handle: ResidentHandle) -> Self

Converts to this type from the input type.

impl Hash for ResidentHandle

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for ResidentHandle

fn eq(&self, other: &ResidentHandle) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for ResidentHandle