VkRenderPassAttachmentBeginInfo(3)

Name

VkRenderPassAttachmentBeginInfo - Structure specifying images to be used as framebuffer attachments

C Specification

The VkRenderPassAttachmentBeginInfo structure is defined as:

This functionality is deprecated by Vulkan Version 1.4. See Deprecated Functionality for more information.

// Provided by VK_VERSION_1_2
typedef struct VkRenderPassAttachmentBeginInfo {
    VkStructureType       sType;
    const void*           pNext;
    uint32_t              attachmentCount;
    const VkImageView*    pAttachments;
} VkRenderPassAttachmentBeginInfo;

or the equivalent

// Provided by VK_KHR_imageless_framebuffer
typedef VkRenderPassAttachmentBeginInfo VkRenderPassAttachmentBeginInfoKHR;

Members

sType is a VkStructureType value identifying this structure.
pNext is NULL or a pointer to a structure extending this structure.
attachmentCount is the number of attachments.
pAttachments is a pointer to an array of VkImageView handles, each of which will be used as the corresponding attachment in the render pass instance.

Description

Valid Usage

VUID-VkRenderPassAttachmentBeginInfo-pAttachments-03218
Each element of pAttachments must only specify a single mip level
VUID-VkRenderPassAttachmentBeginInfo-pAttachments-03219
Each element of pAttachments must have been created with the identity swizzle
VUID-VkRenderPassAttachmentBeginInfo-pAttachments-04114
Each element of pAttachments must have been created with VkImageViewCreateInfo::viewType not equal to VK_IMAGE_VIEW_TYPE_3D
VUID-VkRenderPassAttachmentBeginInfo-pAttachments-07010
If multisampled-render-to-single-sampled is enabled for any subpass, all element of pAttachments which have a sample count equal to VK_SAMPLE_COUNT_1_BIT must have a format that supports the sample count specified in VkMultisampledRenderToSingleSampledInfoEXT::rasterizationSamples

Valid Usage (Implicit)

VUID-VkRenderPassAttachmentBeginInfo-sType-sType
sType must be VK_STRUCTURE_TYPE_RENDER_PASS_ATTACHMENT_BEGIN_INFO
VUID-VkRenderPassAttachmentBeginInfo-pAttachments-parameter
If attachmentCount is not 0, pAttachments must be a valid pointer to an array of attachmentCount valid VkImageView handles

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.