LWJGL 3.3.3 · org.lwjgl.vulkan.VkImageMemoryBarrier2

Structure specifying an image memory barrier.

Description

This structure defines a memory dependency limited to an image subresource range, and can define a queue family transfer operation and image layout transition for that subresource range.

The first synchronization scope and access scope described by this structure include only operations and memory accesses specified by srcStageMask and srcAccessMask.

The second synchronization scope and access scope described by this structure include only operations and memory accesses specified by dstStageMask and dstAccessMask.

Both access scopes are limited to only memory accesses to image in the subresource range defined by subresourceRange.

If image was created with SHARING_MODE_EXCLUSIVE, and srcQueueFamilyIndex is not equal to dstQueueFamilyIndex, this memory barrier defines a queue family transfer operation. When executed on a queue in the family identified by srcQueueFamilyIndex, this barrier defines a queue family release operation for the specified image subresource range, and the second synchronization and access scopes do not synchronize operations on that queue. When executed on a queue in the family identified by dstQueueFamilyIndex, this barrier defines a queue family acquire operation for the specified image subresource range, and the first synchronization and access scopes do not synchronize operations on that queue.

A queue family transfer operation is also defined if the values are not equal, and either is one of the special queue family values reserved for external memory ownership transfers, as described in Queue Family Ownership Transfer. A queue family release operation is defined when dstQueueFamilyIndex is one of those values, and a queue family acquire operation is defined when srcQueueFamilyIndex is one of those values.

If oldLayout is not equal to newLayout, then the memory barrier defines an image layout transition for the specified image subresource range. If this memory barrier defines a queue family transfer operation, the layout transition is only executed once between the queues.

Note

When the old and new layout are equal, the layout values are ignored - data is preserved no matter what values are specified, or what layout the image is currently in.

If image has a multi-planar format and the image is disjoint, then including IMAGE_ASPECT_COLOR_BIT in the aspectMask member of subresourceRange is equivalent to including IMAGE_ASPECT_PLANE_0_BIT, IMAGE_ASPECT_PLANE_1_BIT, and (for three-plane formats only) IMAGE_ASPECT_PLANE_2_BIT.

Valid Usage

If the geometryShader feature is not enabled, srcStageMask must not contain PIPELINE_STAGE_2_GEOMETRY_SHADER_BIT
If the tessellationShader feature is not enabled, srcStageMask must not contain PIPELINE_STAGE_2_TESSELLATION_CONTROL_SHADER_BIT or PIPELINE_STAGE_2_TESSELLATION_EVALUATION_SHADER_BIT
If the conditionalRendering feature is not enabled, srcStageMask must not contain PIPELINE_STAGE_2_CONDITIONAL_RENDERING_BIT_EXT
If the fragmentDensityMap feature is not enabled, srcStageMask must not contain PIPELINE_STAGE_2_FRAGMENT_DENSITY_PROCESS_BIT_EXT
If the transformFeedback feature is not enabled, srcStageMask must not contain PIPELINE_STAGE_2_TRANSFORM_FEEDBACK_BIT_EXT
If the meshShader feature is not enabled, srcStageMask must not contain PIPELINE_STAGE_2_MESH_SHADER_BIT_EXT
If the taskShader feature is not enabled, srcStageMask must not contain PIPELINE_STAGE_2_TASK_SHADER_BIT_EXT
If neither the shadingRateImage or attachmentFragmentShadingRate are enabled, srcStageMask must not contain PIPELINE_STAGE_2_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR
If the subpassShading feature is not enabled, srcStageMask must not contain PIPELINE_STAGE_2_SUBPASS_SHADER_BIT_HUAWEI
If the invocationMask feature is not enabled, srcStageMask must not contain PIPELINE_STAGE_2_INVOCATION_MASK_BIT_HUAWEI
If neither the VK_NV_ray_tracing extension or rayTracingPipeline feature are enabled, srcStageMask must not contain PIPELINE_STAGE_2_RAY_TRACING_SHADER_BIT_KHR

If srcAccessMask includes ACCESS_2_INDIRECT_COMMAND_READ_BIT, srcStageMask must include PIPELINE_STAGE_2_DRAW_INDIRECT_BIT, PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_BUILD_BIT_KHR, PIPELINE_STAGE_2_ALL_GRAPHICS_BIT, or PIPELINE_STAGE_2_ALL_COMMANDS_BIT
If srcAccessMask includes ACCESS_2_INDEX_READ_BIT, srcStageMask must include PIPELINE_STAGE_2_INDEX_INPUT_BIT, PIPELINE_STAGE_2_VERTEX_INPUT_BIT, PIPELINE_STAGE_2_ALL_GRAPHICS_BIT, or PIPELINE_STAGE_2_ALL_COMMANDS_BIT
If srcAccessMask includes ACCESS_2_VERTEX_ATTRIBUTE_READ_BIT, srcStageMask must include PIPELINE_STAGE_2_VERTEX_ATTRIBUTE_INPUT_BIT, PIPELINE_STAGE_2_VERTEX_INPUT_BIT, PIPELINE_STAGE_2_ALL_GRAPHICS_BIT, or PIPELINE_STAGE_2_ALL_COMMANDS_BIT
If srcAccessMask includes ACCESS_2_INPUT_ATTACHMENT_READ_BIT, srcStageMask must include PIPELINE_STAGE_2_FRAGMENT_SHADER_BIT, PIPELINE_STAGE_2_SUBPASS_SHADER_BIT_HUAWEI, PIPELINE_STAGE_2_ALL_GRAPHICS_BIT, or PIPELINE_STAGE_2_ALL_COMMANDS_BIT
If srcAccessMask includes ACCESS_2_UNIFORM_READ_BIT, srcStageMask must include PIPELINE_STAGE_2_ALL_GRAPHICS_BIT, PIPELINE_STAGE_2_ALL_COMMANDS_BIT, or one of the VK_PIPELINE_STAGE_*_SHADER_BIT stages
If srcAccessMask includes ACCESS_2_SHADER_SAMPLED_READ_BIT, srcStageMask must include PIPELINE_STAGE_2_ALL_GRAPHICS_BIT, PIPELINE_STAGE_2_ALL_COMMANDS_BIT, or one of the VK_PIPELINE_STAGE_*_SHADER_BIT stages
If srcAccessMask includes ACCESS_2_SHADER_STORAGE_READ_BIT, srcStageMask must include PIPELINE_STAGE_2_ALL_GRAPHICS_BIT, PIPELINE_STAGE_2_ALL_COMMANDS_BIT, or one of the VK_PIPELINE_STAGE_*_SHADER_BIT stages
If srcAccessMask includes ACCESS_2_SHADER_STORAGE_WRITE_BIT, srcStageMask must include PIPELINE_STAGE_2_ALL_GRAPHICS_BIT, PIPELINE_STAGE_2_ALL_COMMANDS_BIT, or one of the VK_PIPELINE_STAGE_*_SHADER_BIT stages
If srcAccessMask includes ACCESS_2_SHADER_READ_BIT, srcStageMask must include PIPELINE_STAGE_2_ALL_GRAPHICS_BIT, PIPELINE_STAGE_2_ALL_COMMANDS_BIT, PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_BUILD_BIT_KHR, PIPELINE_STAGE_2_MICROMAP_BUILD_BIT_EXT, or one of the VK_PIPELINE_STAGE_*_SHADER_BIT stages
If srcAccessMask includes ACCESS_2_SHADER_WRITE_BIT, srcStageMask must include PIPELINE_STAGE_2_ALL_GRAPHICS_BIT, PIPELINE_STAGE_2_ALL_COMMANDS_BIT, or one of the VK_PIPELINE_STAGE_*_SHADER_BIT stages
If srcAccessMask includes ACCESS_2_COLOR_ATTACHMENT_READ_BIT, srcStageMask must include PIPELINE_STAGE_2_COLOR_ATTACHMENT_OUTPUT_BIT PIPELINE_STAGE_2_ALL_GRAPHICS_BIT, or PIPELINE_STAGE_2_ALL_COMMANDS_BIT
If srcAccessMask includes ACCESS_2_COLOR_ATTACHMENT_WRITE_BIT, srcStageMask must include PIPELINE_STAGE_2_COLOR_ATTACHMENT_OUTPUT_BIT PIPELINE_STAGE_2_ALL_GRAPHICS_BIT, or PIPELINE_STAGE_2_ALL_COMMANDS_BIT
If srcAccessMask includes ACCESS_2_DEPTH_STENCIL_ATTACHMENT_READ_BIT, srcStageMask must include PIPELINE_STAGE_2_EARLY_FRAGMENT_TESTS_BIT, PIPELINE_STAGE_2_LATE_FRAGMENT_TESTS_BIT, PIPELINE_STAGE_2_ALL_GRAPHICS_BIT, or PIPELINE_STAGE_2_ALL_COMMANDS_BIT
If srcAccessMask includes ACCESS_2_DEPTH_STENCIL_ATTACHMENT_WRITE_BIT, srcStageMask must include PIPELINE_STAGE_2_EARLY_FRAGMENT_TESTS_BIT, PIPELINE_STAGE_2_LATE_FRAGMENT_TESTS_BIT, PIPELINE_STAGE_2_ALL_GRAPHICS_BIT, or PIPELINE_STAGE_2_ALL_COMMANDS_BIT
If srcAccessMask includes ACCESS_2_TRANSFER_READ_BIT, srcStageMask must include PIPELINE_STAGE_2_COPY_BIT, PIPELINE_STAGE_2_BLIT_BIT, PIPELINE_STAGE_2_RESOLVE_BIT, PIPELINE_STAGE_2_ALL_TRANSFER_BIT, PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_BUILD_BIT_KHR, PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_COPY_BIT_KHR, or PIPELINE_STAGE_2_ALL_COMMANDS_BIT
If srcAccessMask includes ACCESS_2_TRANSFER_WRITE_BIT, srcStageMask must include PIPELINE_STAGE_2_COPY_BIT, PIPELINE_STAGE_2_BLIT_BIT, PIPELINE_STAGE_2_RESOLVE_BIT, PIPELINE_STAGE_2_CLEAR_BIT, PIPELINE_STAGE_2_ALL_TRANSFER_BIT, PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_BUILD_BIT_KHR, PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_COPY_BIT_KHR, or PIPELINE_STAGE_2_ALL_COMMANDS_BIT
If srcAccessMask includes ACCESS_2_HOST_READ_BIT, srcStageMask must include PIPELINE_STAGE_2_HOST_BIT
If srcAccessMask includes ACCESS_2_HOST_WRITE_BIT, srcStageMask must include PIPELINE_STAGE_2_HOST_BIT
If srcAccessMask includes ACCESS_2_CONDITIONAL_RENDERING_READ_BIT_EXT, srcStageMask must include PIPELINE_STAGE_2_CONDITIONAL_RENDERING_BIT_EXT, PIPELINE_STAGE_2_ALL_GRAPHICS_BIT, or PIPELINE_STAGE_2_ALL_COMMANDS_BIT
If srcAccessMask includes ACCESS_2_FRAGMENT_DENSITY_MAP_READ_BIT_EXT, srcStageMask must include PIPELINE_STAGE_2_FRAGMENT_DENSITY_PROCESS_BIT_EXT, PIPELINE_STAGE_2_ALL_GRAPHICS_BIT, or PIPELINE_STAGE_2_ALL_COMMANDS_BIT
If srcAccessMask includes ACCESS_2_TRANSFORM_FEEDBACK_WRITE_BIT_EXT, srcStageMask must include PIPELINE_STAGE_2_TRANSFORM_FEEDBACK_BIT_EXT, PIPELINE_STAGE_2_ALL_GRAPHICS_BIT, or PIPELINE_STAGE_2_ALL_COMMANDS_BIT
If srcAccessMask includes ACCESS_2_TRANSFORM_FEEDBACK_COUNTER_READ_BIT_EXT, srcStageMask must include PIPELINE_STAGE_2_DRAW_INDIRECT_BIT, PIPELINE_STAGE_2_TRANSFORM_FEEDBACK_BIT_EXT, PIPELINE_STAGE_2_ALL_GRAPHICS_BIT, or PIPELINE_STAGE_2_ALL_COMMANDS_BIT
If srcAccessMask includes ACCESS_2_TRANSFORM_FEEDBACK_COUNTER_WRITE_BIT_EXT, srcStageMask must include PIPELINE_STAGE_2_TRANSFORM_FEEDBACK_BIT_EXT, PIPELINE_STAGE_2_ALL_GRAPHICS_BIT, or PIPELINE_STAGE_2_ALL_COMMANDS_BIT
If srcAccessMask includes ACCESS_2_SHADING_RATE_IMAGE_READ_BIT_NV, srcStageMask must include PIPELINE_STAGE_2_SHADING_RATE_IMAGE_BIT_NV, PIPELINE_STAGE_2_ALL_GRAPHICS_BIT, or PIPELINE_STAGE_2_ALL_COMMANDS_BIT
If srcAccessMask includes ACCESS_2_INVOCATION_MASK_READ_BIT_HUAWEI, srcStageMask must include PIPELINE_STAGE_2_INVOCATION_MASK_BIT_HUAWEI
If srcAccessMask includes ACCESS_2_COMMAND_PREPROCESS_READ_BIT_NV, srcStageMask must include PIPELINE_STAGE_2_COMMAND_PREPROCESS_BIT_NV or PIPELINE_STAGE_2_ALL_COMMANDS_BIT
If srcAccessMask includes ACCESS_2_COMMAND_PREPROCESS_WRITE_BIT_NV, srcStageMask must include PIPELINE_STAGE_2_COMMAND_PREPROCESS_BIT_NV or PIPELINE_STAGE_2_ALL_COMMANDS_BIT
If srcAccessMask includes ACCESS_2_COLOR_ATTACHMENT_READ_NONCOHERENT_BIT_EXT, srcStageMask must include PIPELINE_STAGE_2_COLOR_ATTACHMENT_OUTPUT_BIT PIPELINE_STAGE_2_ALL_GRAPHICS_BIT, or PIPELINE_STAGE_2_ALL_COMMANDS_BIT
If srcAccessMask includes ACCESS_2_ACCELERATION_STRUCTURE_READ_BIT_KHR, srcStageMask must include PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_BUILD_BIT_KHR, PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_COPY_BIT_KHR, PIPELINE_STAGE_2_ALL_COMMANDS_BIT, or one of the VK_PIPELINE_STAGE_*_SHADER_BIT stages
If srcAccessMask includes ACCESS_2_ACCELERATION_STRUCTURE_WRITE_BIT_KHR, srcStageMask must include PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_COPY_BIT_KHR, PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_BUILD_BIT_KHR or PIPELINE_STAGE_2_ALL_COMMANDS_BIT
If the rayQuery feature is not enabled and srcAccessMask includes ACCESS_2_ACCELERATION_STRUCTURE_READ_BIT_KHR, srcStageMask must not include any of the VK_PIPELINE_STAGE_*_SHADER_BIT stages except PIPELINE_STAGE_2_RAY_TRACING_SHADER_BIT_KHR
If srcAccessMask includes ACCESS_2_SHADER_BINDING_TABLE_READ_BIT_KHR, srcStageMask must include PIPELINE_STAGE_2_ALL_COMMANDS_BIT or PIPELINE_STAGE_2_RAY_TRACING_SHADER_BIT_KHR
If srcAccessMask includes ACCESS_2_VIDEO_DECODE_READ_BIT_KHR, srcStageMask must include PIPELINE_STAGE_2_VIDEO_DECODE_BIT_KHR
If srcAccessMask includes ACCESS_2_VIDEO_DECODE_WRITE_BIT_KHR, srcStageMask must include PIPELINE_STAGE_2_VIDEO_DECODE_BIT_KHR
If srcAccessMask includes ACCESS_2_VIDEO_ENCODE_READ_BIT_KHR, srcStageMask must include PIPELINE_STAGE_2_VIDEO_ENCODE_BIT_KHR
If srcAccessMask includes ACCESS_2_VIDEO_ENCODE_WRITE_BIT_KHR, srcStageMask must include PIPELINE_STAGE_2_VIDEO_ENCODE_BIT_KHR
If srcAccessMask includes ACCESS_2_OPTICAL_FLOW_READ_BIT_NV, srcStageMask must include PIPELINE_STAGE_2_OPTICAL_FLOW_BIT_NV
If srcAccessMask includes ACCESS_2_OPTICAL_FLOW_WRITE_BIT_NV, srcStageMask must include PIPELINE_STAGE_2_OPTICAL_FLOW_BIT_NV
If srcAccessMask includes ACCESS_2_MICROMAP_WRITE_BIT_EXT, srcStageMask must include PIPELINE_STAGE_2_MICROMAP_BUILD_BIT_EXT
If srcAccessMask includes ACCESS_2_MICROMAP_READ_BIT_EXT, srcStageMask must include PIPELINE_STAGE_2_MICROMAP_BUILD_BIT_EXT or PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_BUILD_BIT_KHR
If srcAccessMask includes ACCESS_2_DESCRIPTOR_BUFFER_READ_BIT_EXT, srcStageMask must include PIPELINE_STAGE_2_ALL_GRAPHICS_BIT, PIPELINE_STAGE_2_ALL_COMMANDS_BIT, or one of VK_PIPELINE_STAGE_*_SHADER_BIT stages

If the geometryShader feature is not enabled, dstStageMask must not contain PIPELINE_STAGE_2_GEOMETRY_SHADER_BIT
If the tessellationShader feature is not enabled, dstStageMask must not contain PIPELINE_STAGE_2_TESSELLATION_CONTROL_SHADER_BIT or PIPELINE_STAGE_2_TESSELLATION_EVALUATION_SHADER_BIT
If the conditionalRendering feature is not enabled, dstStageMask must not contain PIPELINE_STAGE_2_CONDITIONAL_RENDERING_BIT_EXT
If the fragmentDensityMap feature is not enabled, dstStageMask must not contain PIPELINE_STAGE_2_FRAGMENT_DENSITY_PROCESS_BIT_EXT
If the transformFeedback feature is not enabled, dstStageMask must not contain PIPELINE_STAGE_2_TRANSFORM_FEEDBACK_BIT_EXT
If the meshShader feature is not enabled, dstStageMask must not contain PIPELINE_STAGE_2_MESH_SHADER_BIT_EXT
If the taskShader feature is not enabled, dstStageMask must not contain PIPELINE_STAGE_2_TASK_SHADER_BIT_EXT
If neither the shadingRateImage or attachmentFragmentShadingRate are enabled, dstStageMask must not contain PIPELINE_STAGE_2_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR
If the subpassShading feature is not enabled, dstStageMask must not contain PIPELINE_STAGE_2_SUBPASS_SHADER_BIT_HUAWEI
If the invocationMask feature is not enabled, dstStageMask must not contain PIPELINE_STAGE_2_INVOCATION_MASK_BIT_HUAWEI
If neither the VK_NV_ray_tracing extension or rayTracingPipeline feature are enabled, dstStageMask must not contain PIPELINE_STAGE_2_RAY_TRACING_SHADER_BIT_KHR

If dstAccessMask includes ACCESS_2_INDIRECT_COMMAND_READ_BIT, dstStageMask must include PIPELINE_STAGE_2_DRAW_INDIRECT_BIT, PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_BUILD_BIT_KHR, PIPELINE_STAGE_2_ALL_GRAPHICS_BIT, or PIPELINE_STAGE_2_ALL_COMMANDS_BIT
If dstAccessMask includes ACCESS_2_INDEX_READ_BIT, dstStageMask must include PIPELINE_STAGE_2_INDEX_INPUT_BIT, PIPELINE_STAGE_2_VERTEX_INPUT_BIT, PIPELINE_STAGE_2_ALL_GRAPHICS_BIT, or PIPELINE_STAGE_2_ALL_COMMANDS_BIT
If dstAccessMask includes ACCESS_2_VERTEX_ATTRIBUTE_READ_BIT, dstStageMask must include PIPELINE_STAGE_2_VERTEX_ATTRIBUTE_INPUT_BIT, PIPELINE_STAGE_2_VERTEX_INPUT_BIT, PIPELINE_STAGE_2_ALL_GRAPHICS_BIT, or PIPELINE_STAGE_2_ALL_COMMANDS_BIT
If dstAccessMask includes ACCESS_2_INPUT_ATTACHMENT_READ_BIT, dstStageMask must include PIPELINE_STAGE_2_FRAGMENT_SHADER_BIT, PIPELINE_STAGE_2_SUBPASS_SHADER_BIT_HUAWEI, PIPELINE_STAGE_2_ALL_GRAPHICS_BIT, or PIPELINE_STAGE_2_ALL_COMMANDS_BIT
If dstAccessMask includes ACCESS_2_UNIFORM_READ_BIT, dstStageMask must include PIPELINE_STAGE_2_ALL_GRAPHICS_BIT, PIPELINE_STAGE_2_ALL_COMMANDS_BIT, or one of the VK_PIPELINE_STAGE_*_SHADER_BIT stages
If dstAccessMask includes ACCESS_2_SHADER_SAMPLED_READ_BIT, dstStageMask must include PIPELINE_STAGE_2_ALL_GRAPHICS_BIT, PIPELINE_STAGE_2_ALL_COMMANDS_BIT, or one of the VK_PIPELINE_STAGE_*_SHADER_BIT stages
If dstAccessMask includes ACCESS_2_SHADER_STORAGE_READ_BIT, dstStageMask must include PIPELINE_STAGE_2_ALL_GRAPHICS_BIT, PIPELINE_STAGE_2_ALL_COMMANDS_BIT, or one of the VK_PIPELINE_STAGE_*_SHADER_BIT stages
If dstAccessMask includes ACCESS_2_SHADER_STORAGE_WRITE_BIT, dstStageMask must include PIPELINE_STAGE_2_ALL_GRAPHICS_BIT, PIPELINE_STAGE_2_ALL_COMMANDS_BIT, or one of the VK_PIPELINE_STAGE_*_SHADER_BIT stages
If dstAccessMask includes ACCESS_2_SHADER_READ_BIT, dstStageMask must include PIPELINE_STAGE_2_ALL_GRAPHICS_BIT, PIPELINE_STAGE_2_ALL_COMMANDS_BIT, PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_BUILD_BIT_KHR, PIPELINE_STAGE_2_MICROMAP_BUILD_BIT_EXT, or one of the VK_PIPELINE_STAGE_*_SHADER_BIT stages
If dstAccessMask includes ACCESS_2_SHADER_WRITE_BIT, dstStageMask must include PIPELINE_STAGE_2_ALL_GRAPHICS_BIT, PIPELINE_STAGE_2_ALL_COMMANDS_BIT, or one of the VK_PIPELINE_STAGE_*_SHADER_BIT stages
If dstAccessMask includes ACCESS_2_COLOR_ATTACHMENT_READ_BIT, dstStageMask must include PIPELINE_STAGE_2_COLOR_ATTACHMENT_OUTPUT_BIT PIPELINE_STAGE_2_ALL_GRAPHICS_BIT, or PIPELINE_STAGE_2_ALL_COMMANDS_BIT
If dstAccessMask includes ACCESS_2_COLOR_ATTACHMENT_WRITE_BIT, dstStageMask must include PIPELINE_STAGE_2_COLOR_ATTACHMENT_OUTPUT_BIT PIPELINE_STAGE_2_ALL_GRAPHICS_BIT, or PIPELINE_STAGE_2_ALL_COMMANDS_BIT
If dstAccessMask includes ACCESS_2_DEPTH_STENCIL_ATTACHMENT_READ_BIT, dstStageMask must include PIPELINE_STAGE_2_EARLY_FRAGMENT_TESTS_BIT, PIPELINE_STAGE_2_LATE_FRAGMENT_TESTS_BIT, PIPELINE_STAGE_2_ALL_GRAPHICS_BIT, or PIPELINE_STAGE_2_ALL_COMMANDS_BIT
If dstAccessMask includes ACCESS_2_DEPTH_STENCIL_ATTACHMENT_WRITE_BIT, dstStageMask must include PIPELINE_STAGE_2_EARLY_FRAGMENT_TESTS_BIT, PIPELINE_STAGE_2_LATE_FRAGMENT_TESTS_BIT, PIPELINE_STAGE_2_ALL_GRAPHICS_BIT, or PIPELINE_STAGE_2_ALL_COMMANDS_BIT
If dstAccessMask includes ACCESS_2_TRANSFER_READ_BIT, dstStageMask must include PIPELINE_STAGE_2_COPY_BIT, PIPELINE_STAGE_2_BLIT_BIT, PIPELINE_STAGE_2_RESOLVE_BIT, PIPELINE_STAGE_2_ALL_TRANSFER_BIT, PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_BUILD_BIT_KHR, PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_COPY_BIT_KHR, or PIPELINE_STAGE_2_ALL_COMMANDS_BIT
If dstAccessMask includes ACCESS_2_TRANSFER_WRITE_BIT, dstStageMask must include PIPELINE_STAGE_2_COPY_BIT, PIPELINE_STAGE_2_BLIT_BIT, PIPELINE_STAGE_2_RESOLVE_BIT, PIPELINE_STAGE_2_CLEAR_BIT, PIPELINE_STAGE_2_ALL_TRANSFER_BIT, PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_BUILD_BIT_KHR, PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_COPY_BIT_KHR, or PIPELINE_STAGE_2_ALL_COMMANDS_BIT
If dstAccessMask includes ACCESS_2_HOST_READ_BIT, dstStageMask must include PIPELINE_STAGE_2_HOST_BIT
If dstAccessMask includes ACCESS_2_HOST_WRITE_BIT, dstStageMask must include PIPELINE_STAGE_2_HOST_BIT
If dstAccessMask includes ACCESS_2_CONDITIONAL_RENDERING_READ_BIT_EXT, dstStageMask must include PIPELINE_STAGE_2_CONDITIONAL_RENDERING_BIT_EXT, PIPELINE_STAGE_2_ALL_GRAPHICS_BIT, or PIPELINE_STAGE_2_ALL_COMMANDS_BIT
If dstAccessMask includes ACCESS_2_FRAGMENT_DENSITY_MAP_READ_BIT_EXT, dstStageMask must include PIPELINE_STAGE_2_FRAGMENT_DENSITY_PROCESS_BIT_EXT, PIPELINE_STAGE_2_ALL_GRAPHICS_BIT, or PIPELINE_STAGE_2_ALL_COMMANDS_BIT
If dstAccessMask includes ACCESS_2_TRANSFORM_FEEDBACK_WRITE_BIT_EXT, dstStageMask must include PIPELINE_STAGE_2_TRANSFORM_FEEDBACK_BIT_EXT, PIPELINE_STAGE_2_ALL_GRAPHICS_BIT, or PIPELINE_STAGE_2_ALL_COMMANDS_BIT
If dstAccessMask includes ACCESS_2_TRANSFORM_FEEDBACK_COUNTER_READ_BIT_EXT, dstStageMask must include PIPELINE_STAGE_2_DRAW_INDIRECT_BIT, PIPELINE_STAGE_2_TRANSFORM_FEEDBACK_BIT_EXT, PIPELINE_STAGE_2_ALL_GRAPHICS_BIT, or PIPELINE_STAGE_2_ALL_COMMANDS_BIT
If dstAccessMask includes ACCESS_2_TRANSFORM_FEEDBACK_COUNTER_WRITE_BIT_EXT, dstStageMask must include PIPELINE_STAGE_2_TRANSFORM_FEEDBACK_BIT_EXT, PIPELINE_STAGE_2_ALL_GRAPHICS_BIT, or PIPELINE_STAGE_2_ALL_COMMANDS_BIT
If dstAccessMask includes ACCESS_2_SHADING_RATE_IMAGE_READ_BIT_NV, dstStageMask must include PIPELINE_STAGE_2_SHADING_RATE_IMAGE_BIT_NV, PIPELINE_STAGE_2_ALL_GRAPHICS_BIT, or PIPELINE_STAGE_2_ALL_COMMANDS_BIT
If dstAccessMask includes ACCESS_2_INVOCATION_MASK_READ_BIT_HUAWEI, dstStageMask must include PIPELINE_STAGE_2_INVOCATION_MASK_BIT_HUAWEI
If dstAccessMask includes ACCESS_2_COMMAND_PREPROCESS_READ_BIT_NV, dstStageMask must include PIPELINE_STAGE_2_COMMAND_PREPROCESS_BIT_NV or PIPELINE_STAGE_2_ALL_COMMANDS_BIT
If dstAccessMask includes ACCESS_2_COMMAND_PREPROCESS_WRITE_BIT_NV, dstStageMask must include PIPELINE_STAGE_2_COMMAND_PREPROCESS_BIT_NV or PIPELINE_STAGE_2_ALL_COMMANDS_BIT
If dstAccessMask includes ACCESS_2_COLOR_ATTACHMENT_READ_NONCOHERENT_BIT_EXT, dstStageMask must include PIPELINE_STAGE_2_COLOR_ATTACHMENT_OUTPUT_BIT PIPELINE_STAGE_2_ALL_GRAPHICS_BIT, or PIPELINE_STAGE_2_ALL_COMMANDS_BIT
If dstAccessMask includes ACCESS_2_ACCELERATION_STRUCTURE_READ_BIT_KHR, dstStageMask must include PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_BUILD_BIT_KHR, PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_COPY_BIT_KHR, PIPELINE_STAGE_2_ALL_COMMANDS_BIT, or one of the VK_PIPELINE_STAGE_*_SHADER_BIT stages
If dstAccessMask includes ACCESS_2_ACCELERATION_STRUCTURE_WRITE_BIT_KHR, dstStageMask must include PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_COPY_BIT_KHR, PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_BUILD_BIT_KHR or PIPELINE_STAGE_2_ALL_COMMANDS_BIT
If the rayQuery feature is not enabled and dstAccessMask includes ACCESS_2_ACCELERATION_STRUCTURE_READ_BIT_KHR, dstStageMask must not include any of the VK_PIPELINE_STAGE_*_SHADER_BIT stages except PIPELINE_STAGE_2_RAY_TRACING_SHADER_BIT_KHR
If dstAccessMask includes ACCESS_2_SHADER_BINDING_TABLE_READ_BIT_KHR, dstStageMask must include PIPELINE_STAGE_2_ALL_COMMANDS_BIT or PIPELINE_STAGE_2_RAY_TRACING_SHADER_BIT_KHR
If dstAccessMask includes ACCESS_2_VIDEO_DECODE_READ_BIT_KHR, dstStageMask must include PIPELINE_STAGE_2_VIDEO_DECODE_BIT_KHR
If dstAccessMask includes ACCESS_2_VIDEO_DECODE_WRITE_BIT_KHR, dstStageMask must include PIPELINE_STAGE_2_VIDEO_DECODE_BIT_KHR
If dstAccessMask includes ACCESS_2_VIDEO_ENCODE_READ_BIT_KHR, dstStageMask must include PIPELINE_STAGE_2_VIDEO_ENCODE_BIT_KHR
If dstAccessMask includes ACCESS_2_VIDEO_ENCODE_WRITE_BIT_KHR, dstStageMask must include PIPELINE_STAGE_2_VIDEO_ENCODE_BIT_KHR
If dstAccessMask includes ACCESS_2_OPTICAL_FLOW_READ_BIT_NV, dstStageMask must include PIPELINE_STAGE_2_OPTICAL_FLOW_BIT_NV
If dstAccessMask includes ACCESS_2_OPTICAL_FLOW_WRITE_BIT_NV, dstStageMask must include PIPELINE_STAGE_2_OPTICAL_FLOW_BIT_NV
If dstAccessMask includes ACCESS_2_MICROMAP_WRITE_BIT_EXT, dstStageMask must include PIPELINE_STAGE_2_MICROMAP_BUILD_BIT_EXT
If dstAccessMask includes ACCESS_2_MICROMAP_READ_BIT_EXT, dstStageMask must include PIPELINE_STAGE_2_MICROMAP_BUILD_BIT_EXT or PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_BUILD_BIT_KHR
If dstAccessMask includes ACCESS_2_DESCRIPTOR_BUFFER_READ_BIT_EXT, dstStageMask must include PIPELINE_STAGE_2_ALL_GRAPHICS_BIT, PIPELINE_STAGE_2_ALL_COMMANDS_BIT, or one of VK_PIPELINE_STAGE_*_SHADER_BIT stages

If srcQueueFamilyIndex and dstQueueFamilyIndex define a queue family ownership transfer or oldLayout and newLayout define an image layout transition, and oldLayout or newLayout is IMAGE_LAYOUT_COLOR_ATTACHMENT_OPTIMAL then image must have been created with IMAGE_USAGE_COLOR_ATTACHMENT_BIT
If srcQueueFamilyIndex and dstQueueFamilyIndex define a queue family ownership transfer or oldLayout and newLayout define an image layout transition, and oldLayout or newLayout is IMAGE_LAYOUT_DEPTH_STENCIL_ATTACHMENT_OPTIMAL then image must have been created with IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT
If srcQueueFamilyIndex and dstQueueFamilyIndex define a queue family ownership transfer or oldLayout and newLayout define an image layout transition, and oldLayout or newLayout is IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL then image must have been created with IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT
If srcQueueFamilyIndex and dstQueueFamilyIndex define a queue family ownership transfer or oldLayout and newLayout define an image layout transition, and oldLayout or newLayout is IMAGE_LAYOUT_SHADER_READ_ONLY_OPTIMAL then image must have been created with IMAGE_USAGE_SAMPLED_BIT or IMAGE_USAGE_INPUT_ATTACHMENT_BIT
If srcQueueFamilyIndex and dstQueueFamilyIndex define a queue family ownership transfer or oldLayout and newLayout define an image layout transition, and oldLayout or newLayout is IMAGE_LAYOUT_TRANSFER_SRC_OPTIMAL then image must have been created with IMAGE_USAGE_TRANSFER_SRC_BIT
If srcQueueFamilyIndex and dstQueueFamilyIndex define a queue family ownership transfer or oldLayout and newLayout define an image layout transition, and oldLayout or newLayout is IMAGE_LAYOUT_TRANSFER_DST_OPTIMAL then image must have been created with IMAGE_USAGE_TRANSFER_DST_BIT
If srcQueueFamilyIndex and dstQueueFamilyIndex define a queue family ownership transfer or oldLayout and newLayout define an image layout transition, oldLayout must be IMAGE_LAYOUT_UNDEFINED or the current layout of the image subresources affected by the barrier
If srcQueueFamilyIndex and dstQueueFamilyIndex define a queue family ownership transfer or oldLayout and newLayout define an image layout transition, newLayout must not be IMAGE_LAYOUT_UNDEFINED or IMAGE_LAYOUT_PREINITIALIZED
If srcQueueFamilyIndex and dstQueueFamilyIndex define a queue family ownership transfer or oldLayout and newLayout define an image layout transition, and oldLayout or newLayout is IMAGE_LAYOUT_DEPTH_READ_ONLY_STENCIL_ATTACHMENT_OPTIMAL then image must have been created with IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT
If srcQueueFamilyIndex and dstQueueFamilyIndex define a queue family ownership transfer or oldLayout and newLayout define an image layout transition, and oldLayout or newLayout is IMAGE_LAYOUT_DEPTH_ATTACHMENT_STENCIL_READ_ONLY_OPTIMAL then image must have been created with IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT
If srcQueueFamilyIndex and dstQueueFamilyIndex define a queue family ownership transfer or oldLayout and newLayout define an image layout transition, and oldLayout or newLayout is IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL then image must have been created with at least one of IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT, IMAGE_USAGE_SAMPLED_BIT, or IMAGE_USAGE_INPUT_ATTACHMENT_BIT
If srcQueueFamilyIndex and dstQueueFamilyIndex define a queue family ownership transfer or oldLayout and newLayout define an image layout transition, and oldLayout or newLayout is IMAGE_LAYOUT_DEPTH_ATTACHMENT_OPTIMAL then image must have been created with IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT set
If srcQueueFamilyIndex and dstQueueFamilyIndex define a queue family ownership transfer or oldLayout and newLayout define an image layout transition, and oldLayout or newLayout is IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL then image must have been created with at least one of IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT, IMAGE_USAGE_SAMPLED_BIT, or IMAGE_USAGE_INPUT_ATTACHMENT_BIT
If srcQueueFamilyIndex and dstQueueFamilyIndex define a queue family ownership transfer or oldLayout and newLayout define an image layout transition, and oldLayout or newLayout is IMAGE_LAYOUT_STENCIL_ATTACHMENT_OPTIMAL then image must have been created with IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT set
If the synchronization2 feature is not enabled, oldLayout must not be IMAGE_LAYOUT_ATTACHMENT_OPTIMAL_KHR or IMAGE_LAYOUT_READ_ONLY_OPTIMAL_KHR
If the synchronization2 feature is not enabled, newLayout must not be IMAGE_LAYOUT_ATTACHMENT_OPTIMAL_KHR or IMAGE_LAYOUT_READ_ONLY_OPTIMAL_KHR
If srcQueueFamilyIndex and dstQueueFamilyIndex define a queue family ownership transfer or oldLayout and newLayout define an image layout transition, and oldLayout or newLayout is IMAGE_LAYOUT_ATTACHMENT_OPTIMAL, image must have been created with IMAGE_USAGE_COLOR_ATTACHMENT_BIT or IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT
If srcQueueFamilyIndex and dstQueueFamilyIndex define a queue family ownership transfer or oldLayout and newLayout define an image layout transition, and oldLayout or newLayout is IMAGE_LAYOUT_READ_ONLY_OPTIMAL, image must have been created with at least one of IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT, IMAGE_USAGE_SAMPLED_BIT, or IMAGE_USAGE_INPUT_ATTACHMENT_BIT
If srcQueueFamilyIndex and dstQueueFamilyIndex define a queue family ownership transfer or oldLayout and newLayout define an image layout transition, and oldLayout or newLayout is IMAGE_LAYOUT_FRAGMENT_SHADING_RATE_ATTACHMENT_OPTIMAL_KHR then image must have been created with IMAGE_USAGE_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR set
If image was created with a sharing mode of SHARING_MODE_EXCLUSIVE, and srcQueueFamilyIndex and dstQueueFamilyIndex are not equal, srcQueueFamilyIndex must be QUEUE_FAMILY_EXTERNAL, QUEUE_FAMILY_FOREIGN_EXT, or a valid queue family
If image was created with a sharing mode of SHARING_MODE_EXCLUSIVE, and srcQueueFamilyIndex and dstQueueFamilyIndex are not equal, dstQueueFamilyIndex must be QUEUE_FAMILY_EXTERNAL, QUEUE_FAMILY_FOREIGN_EXT, or a valid queue family
If srcQueueFamilyIndex is not equal to dstQueueFamilyIndex, at least one of srcQueueFamilyIndex or dstQueueFamilyIndex must not be QUEUE_FAMILY_EXTERNAL or QUEUE_FAMILY_FOREIGN_EXT
If the VK_KHR_external_memory extension is not enabled, and the value of VkApplicationInfo::apiVersion used to create the VkInstance is not greater than or equal to Version 1.1, srcQueueFamilyIndex must not be QUEUE_FAMILY_EXTERNAL
If the VK_KHR_external_memory extension is not enabled, and the value of VkApplicationInfo::apiVersion used to create the VkInstance is not greater than or equal to Version 1.1, dstQueueFamilyIndex must not be QUEUE_FAMILY_EXTERNAL
If the VK_EXT_queue_family_foreign extension is not enabled srcQueueFamilyIndex must not be QUEUE_FAMILY_FOREIGN_EXT
If the VK_EXT_queue_family_foreign extension is not enabled dstQueueFamilyIndex must not be QUEUE_FAMILY_FOREIGN_EXT
If srcQueueFamilyIndex and dstQueueFamilyIndex define a queue family ownership transfer or oldLayout and newLayout define an image layout transition, and oldLayout or newLayout is IMAGE_LAYOUT_VIDEO_DECODE_SRC_KHR then image must have been created with IMAGE_USAGE_VIDEO_DECODE_SRC_BIT_KHR
If srcQueueFamilyIndex and dstQueueFamilyIndex define a queue family ownership transfer or oldLayout and newLayout define an image layout transition, and oldLayout or newLayout is IMAGE_LAYOUT_VIDEO_DECODE_DST_KHR then image must have been created with IMAGE_USAGE_VIDEO_DECODE_DST_BIT_KHR
If srcQueueFamilyIndex and dstQueueFamilyIndex define a queue family ownership transfer or oldLayout and newLayout define an image layout transition, and oldLayout or newLayout is IMAGE_LAYOUT_VIDEO_DECODE_DPB_KHR then image must have been created with IMAGE_USAGE_VIDEO_DECODE_DPB_BIT_KHR
If srcQueueFamilyIndex and dstQueueFamilyIndex define a queue family ownership transfer or oldLayout and newLayout define an image layout transition, and oldLayout or newLayout is IMAGE_LAYOUT_VIDEO_ENCODE_SRC_KHR then image must have been created with IMAGE_USAGE_VIDEO_ENCODE_SRC_BIT_KHR
If srcQueueFamilyIndex and dstQueueFamilyIndex define a queue family ownership transfer or oldLayout and newLayout define an image layout transition, and oldLayout or newLayout is IMAGE_LAYOUT_VIDEO_ENCODE_DST_KHR then image must have been created with IMAGE_USAGE_VIDEO_ENCODE_DST_BIT_KHR
If srcQueueFamilyIndex and dstQueueFamilyIndex define a queue family ownership transfer or oldLayout and newLayout define an image layout transition, and oldLayout or newLayout is IMAGE_LAYOUT_VIDEO_ENCODE_DPB_KHR then image must have been created with IMAGE_USAGE_VIDEO_ENCODE_DPB_BIT_KHR
If srcQueueFamilyIndex and dstQueueFamilyIndex define a queue family ownership transfer or oldLayout and newLayout define an image layout transition, and oldLayout or newLayout is IMAGE_LAYOUT_ATTACHMENT_FEEDBACK_LOOP_OPTIMAL_EXT then image must have been created with either the IMAGE_USAGE_COLOR_ATTACHMENT_BIT or IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT usage bits, and the IMAGE_USAGE_INPUT_ATTACHMENT_BIT or IMAGE_USAGE_SAMPLED_BIT usage bits, and the IMAGE_USAGE_ATTACHMENT_FEEDBACK_LOOP_BIT_EXT usage bit
If the attachmentFeedbackLoopLayout feature is not enabled, newLayout must not be IMAGE_LAYOUT_ATTACHMENT_FEEDBACK_LOOP_OPTIMAL_EXT

subresourceRange.baseMipLevel must be less than the mipLevels specified in VkImageCreateInfo when image was created
If subresourceRange.levelCount is not REMAINING_MIP_LEVELS, subresourceRange.baseMipLevel + subresourceRange.levelCount must be less than or equal to the mipLevels specified in VkImageCreateInfo when image was created
subresourceRange.baseArrayLayer must be less than the arrayLayers specified in VkImageCreateInfo when image was created
If subresourceRange.layerCount is not REMAINING_ARRAY_LAYERS, subresourceRange.baseArrayLayer + subresourceRange.layerCount must be less than or equal to the arrayLayers specified in VkImageCreateInfo when image was created
If image is non-sparse then it must be bound completely and contiguously to a single VkDeviceMemory object
If image has a color format that is single-plane, then the aspectMask member of subresourceRange must be IMAGE_ASPECT_COLOR_BIT
If image has a color format and is not disjoint, then the aspectMask member of subresourceRange must be IMAGE_ASPECT_COLOR_BIT
If image has a multi-planar format and the image is disjoint, then the aspectMask member of subresourceRange must include at least one multi-planar aspect mask bit or IMAGE_ASPECT_COLOR_BIT
If image has a depth/stencil format with both depth and stencil and the separateDepthStencilLayouts feature is enabled, then the aspectMask member of subresourceRange must include either or both IMAGE_ASPECT_DEPTH_BIT and IMAGE_ASPECT_STENCIL_BIT
If image has a depth/stencil format with both depth and stencil and the separateDepthStencilLayouts feature is not enabled, then the aspectMask member of subresourceRange must include both IMAGE_ASPECT_DEPTH_BIT and IMAGE_ASPECT_STENCIL_BIT
If the aspectMask member of subresourceRange includes IMAGE_ASPECT_DEPTH_BIT, oldLayout and newLayout must not be one of IMAGE_LAYOUT_STENCIL_ATTACHMENT_OPTIMAL or IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL
If the aspectMask member of subresourceRange includes IMAGE_ASPECT_STENCIL_BIT, oldLayout and newLayout must not be one of IMAGE_LAYOUT_DEPTH_ATTACHMENT_OPTIMAL or IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL
If either srcStageMask or dstStageMask includes PIPELINE_STAGE_2_HOST_BIT, srcQueueFamilyIndex and dstQueueFamilyIndex must be equal
If srcStageMask includes PIPELINE_STAGE_2_HOST_BIT, and srcQueueFamilyIndex and dstQueueFamilyIndex define a queue family ownership transfer or oldLayout and newLayout define an image layout transition, oldLayout must be one of IMAGE_LAYOUT_PREINITIALIZED, IMAGE_LAYOUT_UNDEFINED, or IMAGE_LAYOUT_GENERAL

Valid Usage (Implicit)

sType must be STRUCTURE_TYPE_IMAGE_MEMORY_BARRIER_2
Each pNext member of any structure (including this one) in the pNext chain must be either NULL or a pointer to a valid instance of VkExternalMemoryAcquireUnmodifiedEXT or VkSampleLocationsInfoEXT
The sType value of each struct in the pNext chain must be unique
srcStageMask must be a valid combination of VkPipelineStageFlagBits2 values
srcAccessMask must be a valid combination of VkAccessFlagBits2 values
dstStageMask must be a valid combination of VkPipelineStageFlagBits2 values
dstAccessMask must be a valid combination of VkAccessFlagBits2 values
oldLayout must be a valid VkImageLayout value
newLayout must be a valid VkImageLayout value
image must be a valid VkImage handle
subresourceRange must be a valid VkImageSubresourceRange structure

Layout


struct VkImageMemoryBarrier2 {
    VkStructureType sType;
    void const * pNext;
    VkPipelineStageFlags2 srcStageMask;
    VkAccessFlags2 srcAccessMask;
    VkPipelineStageFlags2 dstStageMask;
    VkAccessFlags2 dstAccessMask;
    VkImageLayout oldLayout;
    VkImageLayout newLayout;
    uint32_t srcQueueFamilyIndex;
    uint32_t dstQueueFamilyIndex;
    VkImage image;
    VkImageSubresourceRange subresourceRange;
}

Modifier and Type	Field and Description
public static final int	ALIGNOF The struct alignment in bytes.
public static final int	DSTACCESSMASK The struct member offsets.
public static final int	DSTQUEUEFAMILYINDEX The struct member offsets.
public static final int	DSTSTAGEMASK The struct member offsets.
public static final int	IMAGE The struct member offsets.
public static final int	NEWLAYOUT The struct member offsets.
public static final int	OLDLAYOUT The struct member offsets.
public static final int	PNEXT The struct member offsets.
public static final int	SIZEOF The struct size in bytes.
public static final int	SRCACCESSMASK The struct member offsets.
public static final int	SRCQUEUEFAMILYINDEX The struct member offsets.
public static final int	SRCSTAGEMASK The struct member offsets.
public static final int	STYPE The struct member offsets.
public static final int	SUBRESOURCERANGE The struct member offsets.

Access	Constructor and Description
protected	VkImageMemoryBarrier2(long address, ByteBuffer container)
public	VkImageMemoryBarrier2(ByteBuffer container) Creates a `VkImageMemoryBarrier2` instance at the current position of the specified `ByteBuffer` container.

Modifier and Type	Method and Description
public static VkImageMemoryBarrier2	calloc() Returns a new `VkImageMemoryBarrier2` instance allocated with `memCalloc`.
public static VkImageMemoryBarrier2.Buffer	calloc(int the buffer capacity capacity) Returns a new `VkImageMemoryBarrier2.Buffer` instance allocated with `memCalloc`.
public static VkImageMemoryBarrier2	calloc(MemoryStack the stack from which to allocate stack) Returns a new `VkImageMemoryBarrier2` instance allocated on the specified `MemoryStack` and initializes all its bits to zero.
public static VkImageMemoryBarrier2.Buffer	calloc(int the buffer capacity capacity, MemoryStack the stack from which to allocate stack) Returns a new `VkImageMemoryBarrier2.Buffer` instance allocated on the specified `MemoryStack` and initializes all its bits to zero.
protected VkImageMemoryBarrier2	create(long the struct memory address address, ByteBuffer an optional container buffer, to be referenced strongly by the struct instance. container) Implements abstract org.lwjgl.system.Struct.create. Similar to `the constructor`, but returns the exact type of the `Struct` subclass.
public static VkImageMemoryBarrier2	create() Returns a new `VkImageMemoryBarrier2` instance allocated with `BufferUtils`.
public static VkImageMemoryBarrier2	create(long address) Returns a new `VkImageMemoryBarrier2` instance for the specified memory address.
public static VkImageMemoryBarrier2.Buffer	create(int the buffer capacity capacity) Returns a new `VkImageMemoryBarrier2.Buffer` instance allocated with `BufferUtils`.
public static VkImageMemoryBarrier2.Buffer	create(long the memory address address, int the buffer capacity capacity) Create a `VkImageMemoryBarrier2.Buffer` instance at the specified memory.
public static VkImageMemoryBarrier2	createSafe(long address) Like `create`, but returns `null` if `address` is `NULL`.
public static VkImageMemoryBarrier2.Buffer	createSafe(long address, int capacity) Like `create`, but returns `null` if `address` is `NULL`.
public long	dstAccessMask() a `VkAccessFlags2` mask of access flags to be included in the second access scope.
public VkImageMemoryBarrier2	dstAccessMask(long value) Sets the specified value to the `dstAccessMask` field.
public int	dstQueueFamilyIndex() the destination queue family for a queue family ownership transfer.
public VkImageMemoryBarrier2	dstQueueFamilyIndex(int value) Sets the specified value to the `dstQueueFamilyIndex` field.
public long	dstStageMask() a `VkPipelineStageFlags2` mask of pipeline stages to be included in the second synchronization scope.
public VkImageMemoryBarrier2	dstStageMask(long value) Sets the specified value to the `dstStageMask` field.
public long	image() a handle to the image affected by this barrier.
public VkImageMemoryBarrier2	image(long value) Sets the specified value to the `image` field.
public static VkImageMemoryBarrier2	malloc() Returns a new `VkImageMemoryBarrier2` instance allocated with `memAlloc`.
public static VkImageMemoryBarrier2.Buffer	malloc(int the buffer capacity capacity) Returns a new `VkImageMemoryBarrier2.Buffer` instance allocated with `memAlloc`.
public static VkImageMemoryBarrier2	malloc(MemoryStack the stack from which to allocate stack) Returns a new `VkImageMemoryBarrier2` instance allocated on the specified `MemoryStack`.
public static VkImageMemoryBarrier2.Buffer	malloc(int the buffer capacity capacity, MemoryStack the stack from which to allocate stack) Returns a new `VkImageMemoryBarrier2.Buffer` instance allocated on the specified `MemoryStack`.
public static long	ndstAccessMask(long struct) Unsafe version of `dstAccessMask`.
public static void	ndstAccessMask(long struct, long value) Unsafe version of `dstAccessMask`.
public static int	ndstQueueFamilyIndex(long struct) Unsafe version of `dstQueueFamilyIndex`.
public static void	ndstQueueFamilyIndex(long struct, int value) Unsafe version of `dstQueueFamilyIndex`.
public static long	ndstStageMask(long struct) Unsafe version of `dstStageMask`.
public static void	ndstStageMask(long struct, long value) Unsafe version of `dstStageMask`.
public int	newLayout() the new layout in an image layout transition.
public VkImageMemoryBarrier2	newLayout(int value) Sets the specified value to the `newLayout` field.
public static long	nimage(long struct) Unsafe version of `image`.
public static void	nimage(long struct, long value) Unsafe version of `image`.
public static int	nnewLayout(long struct) Unsafe version of `newLayout`.
public static void	nnewLayout(long struct, int value) Unsafe version of `newLayout`.
public static int	noldLayout(long struct) Unsafe version of `oldLayout`.
public static void	noldLayout(long struct, int value) Unsafe version of `oldLayout`.
public static long	npNext(long struct) Unsafe version of `pNext`.
public static void	npNext(long struct, long value) Unsafe version of `pNext`.
public static long	nsrcAccessMask(long struct) Unsafe version of `srcAccessMask`.
public static void	nsrcAccessMask(long struct, long value) Unsafe version of `srcAccessMask`.
public static int	nsrcQueueFamilyIndex(long struct) Unsafe version of `srcQueueFamilyIndex`.
public static void	nsrcQueueFamilyIndex(long struct, int value) Unsafe version of `srcQueueFamilyIndex`.
public static long	nsrcStageMask(long struct) Unsafe version of `srcStageMask`.
public static void	nsrcStageMask(long struct, long value) Unsafe version of `srcStageMask`.
public static int	nsType(long struct) Unsafe version of `sType`.
public static void	nsType(long struct, int value) Unsafe version of `sType`.
public static VkImageSubresourceRange	nsubresourceRange(long struct) Unsafe version of `subresourceRange`.
public static void	nsubresourceRange(long struct, VkImageSubresourceRange value) Unsafe version of `subresourceRange`.
public int	oldLayout() the old layout in an image layout transition.
public VkImageMemoryBarrier2	oldLayout(int value) Sets the specified value to the `oldLayout` field.
public long	pNext() `NULL` or a pointer to a structure extending this structure.
public VkImageMemoryBarrier2	pNext(long value) Sets the specified value to the `pNext` field.
public VkImageMemoryBarrier2	pNext(VkExternalMemoryAcquireUnmodifiedEXT value) Prepends the specified `VkExternalMemoryAcquireUnmodifiedEXT` value to the `pNext` chain.
public VkImageMemoryBarrier2	pNext(VkSampleLocationsInfoEXT value) Prepends the specified `VkSampleLocationsInfoEXT` value to the `pNext` chain.
public VkImageMemoryBarrier2	set(int sType, long pNext, long srcStageMask, long srcAccessMask, long dstStageMask, long dstAccessMask, int oldLayout, int newLayout, int srcQueueFamilyIndex, int dstQueueFamilyIndex, long image, VkImageSubresourceRange subresourceRange) Initializes this struct with the specified values.
public VkImageMemoryBarrier2	Returns: this struct set(VkImageMemoryBarrier2 the source struct src) Copies the specified struct data to this struct.
public int	sizeof() Implements abstract org.lwjgl.system.Struct.sizeof. Returns `sizeof(struct)`.
public long	srcAccessMask() a `VkAccessFlags2` mask of access flags to be included in the first access scope.
public VkImageMemoryBarrier2	srcAccessMask(long value) Sets the specified value to the `srcAccessMask` field.
public int	srcQueueFamilyIndex() the source queue family for a queue family ownership transfer.
public VkImageMemoryBarrier2	srcQueueFamilyIndex(int value) Sets the specified value to the `srcQueueFamilyIndex` field.
public long	srcStageMask() a `VkPipelineStageFlags2` mask of pipeline stages to be included in the first synchronization scope.
public VkImageMemoryBarrier2	srcStageMask(long value) Sets the specified value to the `srcStageMask` field.
public int	sType() a `VkStructureType` value identifying this structure.
public VkImageMemoryBarrier2	sType(int value) Sets the specified value to the `sType` field.
public VkImageMemoryBarrier2	sType$Default() Sets the `STRUCTURE_TYPE_IMAGE_MEMORY_BARRIER_2` value to the `sType` field.
public VkImageSubresourceRange	subresourceRange() describes the image subresource range within `image` that is affected by this barrier.
public VkImageMemoryBarrier2	subresourceRange(VkImageSubresourceRange value) Copies the specified `VkImageSubresourceRange` to the `subresourceRange` field.
public VkImageMemoryBarrier2	subresourceRange(Consumer<VkImageSubresourceRange> consumer) Passes the `subresourceRange` field to the specified `Consumer`.

public Class VkImageMemoryBarrier2

Description

Note

Valid Usage

Valid Usage (Implicit)

See Also

Layout

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary