Function Prototype

vkDestroyRenderPass

Destroy a render pass object

To destroy a render pass, call:

void vkDestroyRenderPass(
    VkDevice device,
    VkRenderPass renderPass,
    const VkAllocationCallbacks* pAllocator);
  • device is the logical device that destroys the render pass.
  • renderPass is the handle of the render pass to destroy.
  • pAllocator controls host memory allocation as described in the Memory Allocation chapter.

Valid Usage

VUID-vkDestroyRenderPass-renderPass-00873

All submitted commands that refer to renderPass must have completed execution

VUID-vkDestroyRenderPass-renderPass-00874

If VkAllocationCallbacks were provided when renderPass was created, a compatible set of callbacks must be provided here

VUID-vkDestroyRenderPass-renderPass-00875

If no VkAllocationCallbacks were provided when renderPass was created, pAllocator must be NULL

Valid Usage (Implicit)

VUID-vkDestroyRenderPass-renderPass-parameter

If renderPass is not VK_NULL_HANDLE, renderPass must be a valid VkRenderPass handle

VUID-vkDestroyRenderPass-pAllocator-parameter

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

VUID-vkDestroyRenderPass-renderPass-parent

If renderPass is a valid handle, it must have been created, allocated, or retrieved from device

Host Synchronization

  • Host access to renderPass must be externally synchronized ::