Function Prototype

vkCreateRenderPass2

Create a new render pass object

To create a render pass, call:

VkResult vkCreateRenderPass2KHR(
    VkDevice device,
    const VkRenderPassCreateInfo2* pCreateInfo,
    const VkAllocationCallbacks* pAllocator,
    VkRenderPass* pRenderPass);
  • device is the logical device that creates the render pass.
  • pCreateInfo is a pointer to a VkRenderPassCreateInfo2 structure describing the parameters of the render pass.
  • pAllocator controls host memory allocation as described in the Memory Allocation chapter.
  • pRenderPass is a pointer to a VkRenderPass handle in which the resulting render pass object is returned.

This command is functionally identical to vkCreateRenderPass, but includes extensible sub-structures that include sType and pNext parameters, allowing them to be more easily extended.

Valid Usage

VUID-vkCreateRenderPass2-device-10001

device must support at least one queue family with the VK_QUEUE_GRAPHICS_BIT capability

Valid Usage (Implicit)

VUID-vkCreateRenderPass2-pCreateInfo-parameter

pCreateInfo must be a valid pointer to a valid VkRenderPassCreateInfo2 structure

VUID-vkCreateRenderPass2-pAllocator-parameter

If pAllocator is not NULL, pAllocator must be a valid pointer to a valid VkAllocationCallbacks structure

VUID-vkCreateRenderPass2-pRenderPass-parameter

pRenderPass must be a valid pointer to a VkRenderPass handle