C Specification
To begin a render pass instance, call:
// Provided by VK_VERSION_1_0
void vkCmdBeginRenderPass(
VkCommandBuffer commandBuffer,
const VkRenderPassBeginInfo* pRenderPassBegin,
VkSubpassContents contents);
Parameters
-
commandBufferis the command buffer in which to record the command. -
pRenderPassBeginis a pointer to a VkRenderPassBeginInfo structure specifying the render pass to begin an instance of, and the framebuffer the instance uses. -
contentsis a VkSubpassContents value specifying how the commands in the first subpass will be provided.
Description
After beginning a render pass instance, the command buffer is ready to record the commands for the first subpass of that render pass.
-
VUID-vkCmdBeginRenderPass-initialLayout-00895
If any of theinitialLayoutorfinalLayoutmember of theVkAttachmentDescriptionstructures or thelayoutmember of theVkAttachmentReferencestructures specified when creating the render pass specified in therenderPassmember ofpRenderPassBeginisVK_IMAGE_LAYOUT_COLOR_ATTACHMENT_OPTIMALthen the corresponding attachment image view of the framebuffer specified in theframebuffermember ofpRenderPassBeginmust have been created with ausagevalue includingVK_IMAGE_USAGE_COLOR_ATTACHMENT_BIT -
VUID-vkCmdBeginRenderPass-initialLayout-01758
If any of theinitialLayoutorfinalLayoutmember of theVkAttachmentDescriptionstructures or thelayoutmember of theVkAttachmentReferencestructures specified when creating the render pass specified in therenderPassmember ofpRenderPassBeginisVK_IMAGE_LAYOUT_DEPTH_READ_ONLY_STENCIL_ATTACHMENT_OPTIMAL,VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_STENCIL_READ_ONLY_OPTIMAL,VK_IMAGE_LAYOUT_DEPTH_STENCIL_ATTACHMENT_OPTIMAL, orVK_IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMALthen the corresponding attachment image view of the framebuffer specified in theframebuffermember ofpRenderPassBeginmust have been created with ausagevalue includingVK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT -
VUID-vkCmdBeginRenderPass-initialLayout-02842
If any of theinitialLayoutorfinalLayoutmember of theVkAttachmentDescriptionstructures or thelayoutmember of theVkAttachmentReferencestructures specified when creating the render pass specified in therenderPassmember ofpRenderPassBeginisVK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_OPTIMAL, orVK_IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL,VK_IMAGE_LAYOUT_STENCIL_ATTACHMENT_OPTIMAL, orVK_IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMALthen the corresponding attachment image view of the framebuffer specified in theframebuffermember ofpRenderPassBeginmust have been created with ausagevalue includingVK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT -
VUID-vkCmdBeginRenderPass-stencilInitialLayout-02843
If any of thestencilInitialLayoutorstencilFinalLayoutmember of theVkAttachmentDescriptionStencilLayoutstructures or thestencilLayoutmember of theVkAttachmentReferenceStencilLayoutstructures specified when creating the render pass specified in therenderPassmember ofpRenderPassBeginisVK_IMAGE_LAYOUT_STENCIL_ATTACHMENT_OPTIMAL, orVK_IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMALthen the corresponding attachment image view of the framebuffer specified in theframebuffermember ofpRenderPassBeginmust have been created with ausagevalue includingVK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT -
VUID-vkCmdBeginRenderPass-initialLayout-00897
If any of theinitialLayoutorfinalLayoutmember of theVkAttachmentDescriptionstructures or thelayoutmember of theVkAttachmentReferencestructures specified when creating the render pass specified in therenderPassmember ofpRenderPassBeginisVK_IMAGE_LAYOUT_SHADER_READ_ONLY_OPTIMALthen the corresponding attachment image view of the framebuffer specified in theframebuffermember ofpRenderPassBeginmust have been created with ausagevalue includingVK_IMAGE_USAGE_SAMPLED_BITorVK_IMAGE_USAGE_INPUT_ATTACHMENT_BIT -
VUID-vkCmdBeginRenderPass-initialLayout-00898
If any of theinitialLayoutorfinalLayoutmember of theVkAttachmentDescriptionstructures or thelayoutmember of theVkAttachmentReferencestructures specified when creating the render pass specified in therenderPassmember ofpRenderPassBeginisVK_IMAGE_LAYOUT_TRANSFER_SRC_OPTIMALthen the corresponding attachment image view of the framebuffer specified in theframebuffermember ofpRenderPassBeginmust have been created with ausagevalue includingVK_IMAGE_USAGE_TRANSFER_SRC_BIT -
VUID-vkCmdBeginRenderPass-initialLayout-00899
If any of theinitialLayoutorfinalLayoutmember of theVkAttachmentDescriptionstructures or thelayoutmember of theVkAttachmentReferencestructures specified when creating the render pass specified in therenderPassmember ofpRenderPassBeginisVK_IMAGE_LAYOUT_TRANSFER_DST_OPTIMALthen the corresponding attachment image view of the framebuffer specified in theframebuffermember ofpRenderPassBeginmust have been created with ausagevalue includingVK_IMAGE_USAGE_TRANSFER_DST_BIT -
VUID-vkCmdBeginRenderPass-initialLayout-00900
If any of theinitialLayoutmembers of theVkAttachmentDescriptionstructures specified when creating the render pass specified in therenderPassmember ofpRenderPassBeginis notVK_IMAGE_LAYOUT_UNDEFINED, then each suchinitialLayoutmust be equal to the current layout of the corresponding attachment image subresource of the framebuffer specified in theframebuffermember ofpRenderPassBegin -
VUID-vkCmdBeginRenderPass-srcStageMask-00901
ThesrcStageMaskanddstStageMaskmembers of any element of thepDependenciesmember of VkRenderPassCreateInfo used to createrenderPassmust be supported by the capabilities of the queue family identified by thequeueFamilyIndexmember of the VkCommandPoolCreateInfo used to create the command pool whichcommandBufferwas allocated from -
VUID-vkCmdBeginRenderPass-framebuffer-02532
For any attachment inframebufferthat is used byrenderPassand is bound to memory locations that are also bound to another attachment used byrenderPass, and if at least one of those uses causes either attachment to be written to, both attachments must have had theVK_ATTACHMENT_DESCRIPTION_MAY_ALIAS_BITset -
VUID-vkCmdBeginRenderPass-pAttachments-04102
Each element of thepAttachmentsofframebufferthat is referenced by any element of thepInputAttachmentsof any element ofpSubpassesofrenderPassmust have image view format features containing at leastVK_FORMAT_FEATURE_COLOR_ATTACHMENT_BITorVK_FORMAT_FEATURE_DEPTH_STENCIL_ATTACHMENT_BIT -
VUID-vkCmdBeginRenderPass-pAttachments-04103
Each element of thepAttachmentsofframebufferthat is referenced by any element of thepColorAttachmentsof any element ofpSubpassesofrenderPassmust have image view format features containingVK_FORMAT_FEATURE_COLOR_ATTACHMENT_BIT -
VUID-vkCmdBeginRenderPass-pAttachments-04104
Each element of thepAttachmentsofframebufferthat is referenced by any element of thepResolveAttachmentsof any element ofpSubpassesofrenderPassmust have image view format features containingVK_FORMAT_FEATURE_COLOR_ATTACHMENT_BIT -
VUID-vkCmdBeginRenderPass-pAttachments-04105
Each element of thepAttachmentsofframebufferthat is referenced by any element of thepDepthStencilAttachmentof any element ofpSubpassesofrenderPassmust have image view format features containingVK_FORMAT_FEATURE_DEPTH_STENCIL_ATTACHMENT_BIT
-
VUID-vkCmdBeginRenderPass-commandBuffer-parameter
commandBuffermust be a valid VkCommandBuffer handle -
VUID-vkCmdBeginRenderPass-pRenderPassBegin-parameter
pRenderPassBeginmust be a valid pointer to a valid VkRenderPassBeginInfo structure -
VUID-vkCmdBeginRenderPass-contents-parameter
contentsmust be a valid VkSubpassContents value -
VUID-vkCmdBeginRenderPass-commandBuffer-recording
commandBuffermust be in the recording state -
VUID-vkCmdBeginRenderPass-commandBuffer-cmdpool
TheVkCommandPoolthatcommandBufferwas allocated from must support graphics operations -
VUID-vkCmdBeginRenderPass-renderpass
This command must only be called outside of a render pass instance -
VUID-vkCmdBeginRenderPass-bufferlevel
commandBuffermust be a primaryVkCommandBuffer
-
Host access to
commandBuffermust be externally synchronized -
Host access to the
VkCommandPoolthatcommandBufferwas allocated from must be externally synchronized
| Command Buffer Levels | Render Pass Scope | Supported Queue Types | Pipeline Type |
|---|---|---|---|
Primary |
Outside |
Graphics |
Graphics |
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.