VkPhysicalDevicePipelineRobustnessFeaturesEXT - Structure describing whether an implementation supports robustness requests on a per-pipeline stage granularity

Members

This structure describes the following feature:

Description

Note

Enabling pipelineRobustness may, on some platforms, incur a minor performance cost when robustBufferAccess is disabled, even for pipelines which do not make use of any robustness features. If robustness is not needed, pipelineRobustness should not be enabled by an application.

If the PhysicalDevicePipelineRobustnessFeaturesEXT structure is included in the pNext chain of the PhysicalDeviceFeatures2 structure passed to getPhysicalDeviceFeatures2, it is filled in to indicate whether each corresponding feature is supported. PhysicalDevicePipelineRobustnessFeaturesEXT can also be used in the pNext chain of DeviceCreateInfo to selectively enable these features.

Valid Usage (Implicit)

See Also

VK_EXT_pipeline_robustness, Bool32, StructureType

VkPipelineRobustnessCreateInfoEXT - Structure controlling the robustness of a newly created pipeline shader stage

Description

Resources bound as DESCRIPTOR_TYPE_MUTABLE_EXT will have the robustness behavior that covers its active descriptor type.

The scope of the effect of PipelineRobustnessCreateInfoEXT depends on which structure’s pNext chain it is included in.

• GraphicsPipelineCreateInfo, RayTracingPipelineCreateInfoKHR, ComputePipelineCreateInfo: The robustness behavior described by PipelineRobustnessCreateInfoEXT applies to all accesses through this pipeline
• PipelineShaderStageCreateInfo: The robustness behavior described by PipelineRobustnessCreateInfoEXT applies to all accesses emanating from the shader code of this shader stage

If PipelineRobustnessCreateInfoEXT is specified for both a pipeline and a pipeline stage, the PipelineRobustnessCreateInfoEXT specified for the pipeline stage will take precedence.

When PipelineRobustnessCreateInfoEXT is specified for a pipeline, it only affects the subset of the pipeline that is specified by the create info, as opposed to subsets linked from pipeline libraries. For GraphicsPipelineCreateInfo, that subset is specified by GraphicsPipelineLibraryCreateInfoEXT::flags. For RayTracingPipelineCreateInfoKHR, that subset is specified by the specific stages in RayTracingPipelineCreateInfoKHR::pStages.

Valid Usage

• If the pipelineRobustness feature is not enabled, storageBuffers must be PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_DEVICE_DEFAULT_EXT

• If the pipelineRobustness feature is not enabled, uniformBuffers must be PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_DEVICE_DEFAULT_EXT
• If the pipelineRobustness feature is not enabled, vertexInputs must be PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_DEVICE_DEFAULT_EXT
• If the pipelineRobustness feature is not enabled, images must be PIPELINE_ROBUSTNESS_IMAGE_BEHAVIOR_DEVICE_DEFAULT_EXT
• If the robustImageAccess feature is not supported, images must not be PIPELINE_ROBUSTNESS_IMAGE_BEHAVIOR_ROBUST_IMAGE_ACCESS_EXT
• If the robustBufferAccess2 feature is not supported, storageBuffers must not be PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXT
• If the robustBufferAccess2 feature is not supported, uniformBuffers must not be PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXT
• If the robustBufferAccess2 feature is not supported, vertexInputs must not be PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXT
• If the robustImageAccess2 feature is not supported, images must not be PIPELINE_ROBUSTNESS_IMAGE_BEHAVIOR_ROBUST_IMAGE_ACCESS_2_EXT

Valid Usage (Implicit)

• sType must be STRUCTURE_TYPE_PIPELINE_ROBUSTNESS_CREATE_INFO_EXT

• storageBuffers must be a valid PipelineRobustnessBufferBehaviorEXT value
• uniformBuffers must be a valid PipelineRobustnessBufferBehaviorEXT value
• vertexInputs must be a valid PipelineRobustnessBufferBehaviorEXT value
• images must be a valid PipelineRobustnessImageBehaviorEXT value

See Also

VK_EXT_pipeline_robustness, PipelineRobustnessBufferBehaviorEXT, PipelineRobustnessImageBehaviorEXT, StructureType

VkPhysicalDevicePipelineRobustnessPropertiesEXT - Structure describing the default robustness behavior of a physical device

Description

Some implementations of Vulkan may be able to guarantee that certain types of accesses are always performed with robustness even when the Vulkan API’s robustness features are not explicitly enabled.

Even when an implementation reports that accesses to a given resource type are robust by default, it remains invalid to make an out of bounds access without requesting the appropriate robustness feature.

If the PhysicalDevicePipelineRobustnessPropertiesEXT structure is included in the pNext chain of the PhysicalDeviceProperties2 structure passed to getPhysicalDeviceProperties2, it is filled in with each corresponding implementation-dependent property.

Valid Usage (Implicit)

See Also

VK_EXT_pipeline_robustness, PipelineRobustnessBufferBehaviorEXT, PipelineRobustnessImageBehaviorEXT, StructureType

VkPipelineRobustnessBufferBehaviorEXT - Enum controlling the robustness of buffer accesses in a pipeline stage

See Also

VK_EXT_pipeline_robustness, PhysicalDevicePipelineRobustnessPropertiesEXT, PipelineRobustnessCreateInfoEXT

VkPipelineRobustnessImageBehaviorEXT - Enum controlling the robustness of image accesses in a pipeline stage

See Also

VK_EXT_pipeline_robustness, PhysicalDevicePipelineRobustnessPropertiesEXT, PipelineRobustnessCreateInfoEXT