Structures

VkCommandBufferSubmitInfo

Structure specifying a command buffer submission

The VkCommandBufferSubmitInfo structure is defined as:

typedef struct VkCommandBufferSubmitInfo {
    VkStructureType sType;
    const void* pNext;
    VkCommandBuffer commandBuffer;
    uint32_t deviceMask;
} VkCommandBufferSubmitInfo;

or the equivalent

typedef VkCommandBufferSubmitInfo VkCommandBufferSubmitInfoKHR;
  • sType is a VkStructureType value identifying this structure.
  • pNext is NULL or a pointer to a structure extending this structure.
  • commandBuffer is a VkCommandBuffer to be submitted for execution.
  • deviceMask is a bitmask indicating which devices in a device group execute the command buffer. A deviceMask of 0 is equivalent to setting all bits corresponding to valid devices in the group to 1.

Valid Usage

VUID-VkCommandBufferSubmitInfo-commandBuffer-03890

commandBuffer must not have been allocated with VK_COMMAND_BUFFER_LEVEL_SECONDARY

VUID-VkCommandBufferSubmitInfo-deviceMask-03891

If deviceMask is not 0, it must be a valid device mask

VUID-VkCommandBufferSubmitInfo-commandBuffer-09445

If any render pass instance in commandBuffer was recorded with a VkRenderPassStripeBeginInfoARM structure in its pNext chain and did not specify the VK_RENDERING_RESUMING_BIT flag, a VkRenderPassStripeSubmitInfoARM must be included in the pNext chain

VUID-VkCommandBufferSubmitInfo-pNext-09446

If a VkRenderPassStripeSubmitInfoARM is included in the pNext chain, the value of VkRenderPassStripeSubmitInfoARM::stripeSemaphoreInfoCountmust be equal to the sum of the VkRenderPassStripeBeginInfoARM::stripeInfoCount parameters provided to render pass instances recorded in commandBuffer that did not specify the VK_RENDERING_RESUMING_BIT flag

Valid Usage (Implicit)

VUID-VkCommandBufferSubmitInfo-sType-sType

sType must be VK_STRUCTURE_TYPE_COMMAND_BUFFER_SUBMIT_INFO

VUID-VkCommandBufferSubmitInfo-pNext-pNext

pNext must be NULL or a pointer to a valid instance of VkRenderPassStripeSubmitInfoARM

VUID-VkCommandBufferSubmitInfo-sType-unique

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