Struct ClContext 

pub struct ClContext { /* private fields */ }

OpenCL cl_context borrowed for an OpenCL sync-target dispatch. The platform/device parentage is rederived inside the bridge via clGetContextInfo.

Implementations

impl ClContext

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

Wrap a raw cl_context 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 cl_context — 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: ClContext 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 ClContext

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 ClContext

impl Debug for ClContext

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

Formats the value using the given formatter.

impl Send for ClContext

impl Sync for ClContext