VulkanHub
Structures

VkDependencyInfo

Structure specifying dependency information for a synchronization command

The VkDependencyInfo structure is defined as:

typedef struct VkDependencyInfo {
    VkStructureType sType;
    const void* pNext;
    VkDependencyFlags dependencyFlags;
    uint32_t memoryBarrierCount;
    const VkMemoryBarrier2* pMemoryBarriers;
    uint32_t bufferMemoryBarrierCount;
    const VkBufferMemoryBarrier2* pBufferMemoryBarriers;
    uint32_t imageMemoryBarrierCount;
    const VkImageMemoryBarrier2* pImageMemoryBarriers;
} VkDependencyInfo;

typedef VkDependencyInfo VkDependencyInfoKHR;
  • sType is a VkStructureType value identifying this structure.
  • pNext is NULL or a pointer to a structure extending this structure.
  • dependencyFlags is a bitmask of VkDependencyFlagBits specifying how execution and memory dependencies are formed.
  • memoryBarrierCount is the length of the pMemoryBarriers array.
  • pMemoryBarriers is a pointer to an array of VkMemoryBarrier2 structures defining memory dependencies between any memory accesses.
  • bufferMemoryBarrierCount is the length of the pBufferMemoryBarriers array.
  • pBufferMemoryBarriers is a pointer to an array of VkBufferMemoryBarrier2 structures defining memory dependencies between buffer ranges.
  • imageMemoryBarrierCount is the length of the pImageMemoryBarriers array.
  • pImageMemoryBarriers is a pointer to an array of VkImageMemoryBarrier2 structures defining memory dependencies between image subresources.

This structure defines a set of memory dependencies, as well as queue family ownership transfer operations and image layout transitions.

Each member of pMemoryBarriers, pBufferMemoryBarriers, and pImageMemoryBarriers defines a separate memory dependency.

Valid Usage

VUID-VkDependencyInfo-pMemoryBarriers-10605

For each element of pMemoryBarriers, the sType value of each structure in the pNext chain must be unique

VUID-VkDependencyInfo-pMemoryBarriers-10606

For each element of pMemoryBarriers, pNext must be either NULL or a pointer to a valid instance of VkMemoryBarrierAccessFlags3KHR

VUID-VkDependencyInfo-pNext-09754

If a VkTensorDependencyInfoARM structure is included in the pNext chain, a VkTensorMemoryBarrierARM structure must not be included in the pNext chain

Valid Usage (Implicit)

VUID-VkDependencyInfo-sType-sType

sType must be VK_STRUCTURE_TYPE_DEPENDENCY_INFO

VUID-VkDependencyInfo-pNext-pNext

Each pNext member of any structure (including this one) in the pNext chain must be either NULL or a pointer to a valid instance of VkMemoryRangeBarriersInfoKHR, VkTensorDependencyInfoARM, or VkTensorMemoryBarrierARM

VUID-VkDependencyInfo-sType-unique

The sType value of each structure in the pNext chain must be unique

VUID-VkDependencyInfo-dependencyFlags-parameter

dependencyFlags must be a valid combination of VkDependencyFlagBits values

VUID-VkDependencyInfo-pMemoryBarriers-parameter

If memoryBarrierCount is not 0, pMemoryBarriers must be a valid pointer to an array of memoryBarrierCount valid VkMemoryBarrier2 structures

VUID-VkDependencyInfo-pBufferMemoryBarriers-parameter

If bufferMemoryBarrierCount is not 0, pBufferMemoryBarriers must be a valid pointer to an array of bufferMemoryBarrierCount valid VkBufferMemoryBarrier2 structures

VUID-VkDependencyInfo-pImageMemoryBarriers-parameter

If imageMemoryBarrierCount is not 0, pImageMemoryBarriers must be a valid pointer to an array of imageMemoryBarrierCount valid VkImageMemoryBarrier2 structures