Struct QueueFamilyOwnershipTransfer 

pub struct QueueFamilyOwnershipTransfer {
    pub src: QueueFamily,
    pub dst: QueueFamily,
}

A queue family ownership transfer to perform as part of a TextureBarrier.

This is only honored by the Vulkan backend; every other backend ignores it. It exists so that textures imported from external memory (for example via VK_KHR_external_memory) can have their backing image transferred between wgpu’s queue family and a queue family outside of wgpu’s control when the image is acquired for use and released afterwards.

src becomes VkImageMemoryBarrier::srcQueueFamilyIndex and dst becomes VkImageMemoryBarrier::dstQueueFamilyIndex. To acquire an externally owned image, set src to QueueFamily::External or QueueFamily::Foreign and dst to QueueFamily::Explicit with wgpu’s own family, obtained from vulkan::Device::queue_family_index. To release it again, swap the two.

A queue family ownership transfer requires a matching barrier to be recorded on both queues; wgpu-hal only records the barrier on its own queue, so the owner of the other queue is responsible for recording the complementary one.

Fields

src: QueueFamily

The queue family that currently owns the image (srcQueueFamilyIndex).

dst: QueueFamily

The queue family that should own the image afterwards (dstQueueFamilyIndex).

Trait Implementations

impl Clone for QueueFamilyOwnershipTransfer

fn clone(&self) -> QueueFamilyOwnershipTransfer

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for QueueFamilyOwnershipTransfer

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

Formats the value using the given formatter.

impl PartialEq for QueueFamilyOwnershipTransfer

fn eq(&self, other: &QueueFamilyOwnershipTransfer) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for QueueFamilyOwnershipTransfer

impl Eq for QueueFamilyOwnershipTransfer

impl StructuralPartialEq for QueueFamilyOwnershipTransfer