Class VkDeviceGroupRenderPassBeginInfo

  • All Implemented Interfaces:
    java.lang.AutoCloseable, NativeResource, Pointer
    Direct Known Subclasses:
    VkDeviceGroupRenderPassBeginInfoKHR

    public class VkDeviceGroupRenderPassBeginInfo
    extends Struct
    implements NativeResource
    Set the initial device mask and render areas for a render pass instance.
    Description

    The deviceMask serves several purposes. It is an upper bound on the set of physical devices that can be used during the render pass instance, and the initial device mask when the render pass instance begins. Render pass attachment load, store, and resolve operations only apply to physical devices included in the device mask. Subpass dependencies only apply to the physical devices in the device mask.

    If deviceRenderAreaCount is not zero, then the elements of pDeviceRenderAreas override the value of VkRenderPassBeginInfo::renderArea, and provide a render area specific to each physical device. These render areas serve the same purpose as VkRenderPassBeginInfo::renderArea, including controlling the region of attachments that are cleared by ATTACHMENT_LOAD_OP_CLEAR and that are resolved into resolve attachments.

    If this structure is not present, the render pass instance's device mask is the value of VkDeviceGroupCommandBufferBeginInfo::deviceMask. If this structure is not present or if deviceRenderAreaCount is zero, VkRenderPassBeginInfo::renderArea is used for all physical devices.

    Valid Usage
    • deviceMask must be a valid device mask value
    • deviceMask must not be zero
    • deviceMask must be a subset of the command buffer’s initial device mask
    • deviceRenderAreaCount must either be zero or equal to the number of physical devices in the logical device.
    Valid Usage (Implicit)
    See Also

    VkRect2D

    Member documentation

    • sType – the type of this structure.
    • pNextNULL or a pointer to an extension-specific structure.
    • deviceMask – the device mask for the render pass instance.
    • deviceRenderAreaCount – the number of elements in the pDeviceRenderAreas array.
    • pDeviceRenderAreas – an array of structures of type VkRect2D defining the render area for each physical device.

    Layout

    
     struct VkDeviceGroupRenderPassBeginInfo {
         VkStructureType sType;
         void const * pNext;
         uint32_t deviceMask;
         uint32_t deviceRenderAreaCount;
         VkRect2D const * pDeviceRenderAreas;
     }