VkCommandBufferSubmitInfo(3)

Name

VkCommandBufferSubmitInfo - Structure specifying a command buffer submission

C Specification

The VkCommandBufferSubmitInfo structure is defined as:

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

// Provided by VK_KHR_synchronization2
// Equivalent to VkCommandBufferSubmitInfo
typedef VkCommandBufferSubmitInfo VkCommandBufferSubmitInfoKHR;

Members

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.

Description

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::stripeSemaphoreInfoCount must 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 structure in the pNext chain must be unique
VUID-VkCommandBufferSubmitInfo-commandBuffer-parameter
commandBuffer must be a valid VkCommandBuffer handle

Document Notes

For more information, see the Vulkan Specification.

This page is extracted from the Vulkan Specification. Fixes and changes should be made to the Specification, not directly.