Struct VkInstance 

pub struct VkInstance { /* private fields */ }

VkInstance borrowed for a Vulkan sync-target dispatch. Required even for device-level work because ash resolves device fn pointers through vkGetDeviceProcAddr, which is itself an instance-level command (vkGetInstanceProcAddr(NULL, ...) returns NULL).

Implementations

impl VkInstance

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

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

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 VkInstance

impl Debug for VkInstance

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

Formats the value using the given formatter.

impl Send for VkInstance

impl Sync for VkInstance