Enum
VkPipelineCreationFeedbackFlagBits
Bitmask specifying pipeline or pipeline stage creation feedback
Possible values of the flags member of
VkPipelineCreationFeedback are:
typedef enum VkPipelineCreationFeedbackFlagBits {
VK_PIPELINE_CREATION_FEEDBACK_VALID_BIT = 0x00000001,
VK_PIPELINE_CREATION_FEEDBACK_APPLICATION_PIPELINE_CACHE_HIT_BIT = 0x00000002,
VK_PIPELINE_CREATION_FEEDBACK_BASE_PIPELINE_ACCELERATION_BIT = 0x00000004,
} VkPipelineCreationFeedbackFlagBits;
pub struct PipelineCreationFeedbackFlagBits(u32);
impl PipelineCreationFeedbackFlagBits {
pub const VALID: Self = 0x00000001;
pub const APPLICATION_PIPELINE_CACHE_HIT: Self = 0x00000002;
pub const BASE_PIPELINE_ACCELERATION: Self = 0x00000004;
}
#define VkPipelineCreationFeedbackFlagBitsEXT VkPipelineCreationFeedbackFlagBits
const PipelineCreationFeedbackFlagBitsEXT: _ = vk::PipelineCreationFeedbackFlagBits;
VK_PIPELINE_CREATION_FEEDBACK_VALID_BITspecifies that the feedback information is valid.VK_PIPELINE_CREATION_FEEDBACK_APPLICATION_PIPELINE_CACHE_HIT_BITspecifies that a readily usable pipeline or pipeline stage was found in thepipelineCachespecified by the application in the pipeline creation command.
An implementation should set theVK_PIPELINE_CREATION_FEEDBACK_APPLICATION_PIPELINE_CACHE_HIT_BITbit if it was able to avoid the large majority of pipeline or pipeline stage creation work by using thepipelineCacheparameter of vkCreateGraphicsPipelines, vkCreateRayTracingPipelinesKHR, vkCreateRayTracingPipelinesNV, vkCreateDataGraphPipelinesARM, or vkCreateComputePipelines. When an implementation sets this bit for the entire pipeline, it may leave it unset for any stage.Implementations are encouraged to provide a meaningful signal to applications using this bit. The intention is to communicate to the application that the pipeline or pipeline stage was createdas fast as it getsusing the pipeline cache provided by the application. If an implementation uses an internal cache, it is discouraged from setting this bit as the feedback would be unactionable.VK_PIPELINE_CREATION_FEEDBACK_BASE_PIPELINE_ACCELERATION_BITspecifies that the base pipeline specified by thebasePipelineHandleorbasePipelineIndexmember of theVk*PipelineCreateInfostructure was used to accelerate the creation of the pipeline.
An implementation should set theVK_PIPELINE_CREATION_FEEDBACK_BASE_PIPELINE_ACCELERATION_BITbit if it was able to avoid a significant amount of work by using the base pipeline.Whilesignificant amount of workis subjective, implementations are encouraged to provide a meaningful signal to applications using this bit. For example, a 1% reduction in duration may not warrant setting this bit, while a 50% reduction would.
Parent
VK_VERSION_1_3Type
Enum