Struct VulkanDeviceHandle 

pub struct VulkanDeviceHandle { /* private fields */ }

Owns one native handle.

A Vulkan instance, device, and queue that the library creates and owns.

See mln_vulkan_device in the C API reference.

Implementations

impl VulkanDeviceHandle

pub fn id(&self) -> u64

Returns the native handle value.

impl VulkanDeviceHandle

pub fn create( options: Option<&VulkanDeviceOptions<'_>>, ) -> Result<VulkanDeviceHandle>

Creates a Vulkan instance, device, and graphics queue for render sessions.

Attach sessions with the context from VulkanDeviceHandle::get_context(), in place of a device of your own. Without device_uuid or device_luid, it prefers a discrete GPU. The device enables the external memory and semaphore extensions that the GPU offers.

See mln_vulkan_device_create in the C API reference.

Errors

• Status::Unsupported when supported_render_backend_mask() lacks RenderBackendFlag::VULKAN, or when presentation is true and the Vulkan loader or the GPU can’t present.
• Status::NotFound when no GPU matches device_uuid and device_luid.
• Status::NativeError when there is no Vulkan loader, no GPU has a graphics queue, or Vulkan can’t create the instance or the device.

pub fn get_context(&self) -> Result<VulkanDeviceContextResult>

Gets the context to attach render sessions to the device with.

Pass it as the context of MapHandle::attach_vulkan_surface() or MapHandle::attach_vulkan_borrowed_texture(). The sessions on the device share its graphics queue. To submit to the queue yourself, set RenderSessionAttachOptions::queue_lock on each session.

See mln_vulkan_device_get_context in the C API reference.

pub fn release(self) -> Result<(), ReleaseError<Self>>

Releases a Vulkan device.

Render sessions that attached with the device’s context keep using it until they detach or their release finishes.

See mln_vulkan_device_release in the C API reference.

Trait Implementations

impl Debug for VulkanDeviceHandle

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

Formats the value using the given formatter.