Struct MtlCommandBufferRef 

pub struct MtlCommandBufferRef { /* private fields */ }

id<MTLCommandBuffer> borrowed by ExternalQueue::MetalCommandBuffer. Recording into the same command buffer from multiple threads is undefined, and nothing here prevents it — the borrow is shared and the newtype is Copy, so confining recording to one thread is the caller’s obligation.

Implementations

impl MtlCommandBufferRef

pub unsafe fn try_from_raw(ptr: *mut c_void) -> Result<Self, InvalidHandleError>

Wrap a raw id<MTLCommandBuffer> in the typed newtype, rejecting null.

This is a borrow, not a transfer of ownership. The newtype is Copy and stores nothing but the pointer’s bit-pattern — no Arc, no keep-alive, no Drop. It never retains, releases, destroys or closes the underlying object, so its lifetime stays entirely the caller’s (or the caller’s own producer’s) to manage.

Safety

• ptr must be a live id<MTLCommandBuffer> — that exact API kind, not merely a non-null pointer. The only check performed is the null rejection below; the value is otherwise stored verbatim and later handed to the bridge dispatcher, which calls into the owning API through it.
• The referenced object must stay alive, and must not be destroyed, for as long as this value or any Copy of it exists — in particular for the whole of every crate::ExternalQueue (or sync-target) borrow that names it. Because Copy duplicates the pointer with no refcount bump, destroying the object while a copy survives is a use-after-free the borrow checker cannot see. Callers anchor this with the Arc<…> (or equivalent) they already hold on the producer side.
• The object must tolerate use from a thread other than the one that created it, and concurrent use from several: MtlCommandBufferRef is Send + Sync, so a copy may be moved to and shared with the interop worker threads. Where the API forbids that — recording into one id<MTLCommandBuffer> from two threads, or a GL context that is current on exactly one thread — the caller must confine the value itself; nothing here enforces it.
• ptr may be null: that is reported as InvalidHandleError::NullPointer rather than being undefined behaviour, so a null check is not part of the caller’s obligation.

pub fn as_raw(&self) -> *mut c_void

Trait Implementations

impl Clone for MtlCommandBufferRef

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for MtlCommandBufferRef

impl Debug for MtlCommandBufferRef

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

Formats the value using the given formatter.

impl Send for MtlCommandBufferRef

impl Sync for MtlCommandBufferRef