VkCommandBufferSubmitInfo
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
isNULL
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. AdeviceMask
of0
is equivalent to setting all bits corresponding to valid devices in the group to1
.
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 struct in the pNext
chain must be unique
VUID-VkCommandBufferSubmitInfo-commandBuffer-parameter
commandBuffer
must be a valid VkCommandBuffer handle