Struct AHardwareBufferHandle 

pub struct AHardwareBufferHandle { /* private fields */ }

Available on Android only.

AHardwareBuffer* with refcount-anchored lifetime via AHbInner.

Implementations

impl AHardwareBufferHandle

pub unsafe fn acquire( handle: *mut AHardwareBuffer, ) -> Result<Self, InvalidHandleError>

Wrap an AHardwareBuffer*, taking one new reference via AHardwareBuffer_acquire. Refcount-owning: the reference taken here is released on the last Clone’s drop.

Safety

• handle must point to a live AHardwareBuffer on which the caller currently holds a reference. Use this for borrowed handles — an AImage_getHardwareBuffer result, a MediaCodec output buffer, a gralloc handle owned by someone else — where the reference stays with its original owner.
• Ownership is shared, not transferred. The +1 taken here is released by the last Arc<AHbInner> drop; the caller’s reference is untouched and remains the caller’s to release. Clone bumps only the Arc, never gralloc.
• The caller must not issue the balancing AHardwareBuffer_release for the reference taken here.
• Null is rejected as InvalidHandleError::NullHandle, so it is not a caller obligation.
• No thread affinity — AHardwareBuffer refcounts are atomic and the buffer is meant for cross-process sharing. Concurrent access to the pixels still needs the usual fence or AHardwareBuffer_lock discipline, which this type does not provide.

pub unsafe fn from_acquired( handle: *mut AHardwareBuffer, ) -> Result<Self, InvalidHandleError>

Wrap an AHardwareBuffer* by adopting a reference the caller already holds. No AHardwareBuffer_acquire is issued. Refcount-owning: the adopted reference is released on the last Clone’s drop.

Safety

• handle must point to a live AHardwareBuffer on which the caller holds a reference it has not yet released — one it took itself via AHardwareBuffer_allocate, AHardwareBuffer_acquire, or a recvBuffer/fromHardwareBuffer call that returned an owned reference.
• That reference is transferred here. The caller must never release it: the single balancing AHardwareBuffer_release is issued by the last Arc<AHbInner> drop, so a caller-side release is a double-free of a refcount shared across processes.
• Conversely, passing a borrowed handle under-counts the buffer — Drop will release a reference that was never taken, freeing it out from under its real owner. Use Self::acquire for borrowed handles.
• Null is rejected as InvalidHandleError::NullHandle, so it is not a caller obligation.
• No thread affinity, as for Self::acquire.

pub fn as_ptr(&self) -> *mut AHardwareBuffer

pub fn inner(&self) -> &Arc<AHbInner>

Trait Implementations

impl Clone for AHardwareBufferHandle

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AHardwareBufferHandle

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

Formats the value using the given formatter.