mirror of
https://github.com/status-im/Vulkan-Docs.git
synced 2025-01-31 08:36:26 +00:00
56e0289318
* Update release number to 97.
Public Issues:
* Add a special case to the <<renderpass-compatibility, Render Pass
Compatibility>> rules allowing single-subpass renderpasses to be
compatible even if they have different resolve attachment references
(public issue 835).
* Fix the miss shader binding table record address rule in the
<<shader-binding-table-indexing-rules, Miss Shaders>> section to index
by code:missIndex, not code:sbtOffset (public issue 875).
Internal Issues:
* Add a missing anchor to the elink:VkSamplerCreateFlagBits language
(internal issue 1483).
* Add missing implicit valid usage include for slink:VkHdrMetadataEXT and
corresponding `noautovalidity` attributes in `vk.xml` for the
externally-defined metadata properties (internal issue 1514).
* Remove restrictions on the `mask` parameter of SPIR-V's
code:OpGroupNonUniformXor in the <<spirvenv-module-validation,
Validation Rules within a Module>> appendix (internal merge request
2971).
* Restore `noautovalidity` attribute for
slink:VkPipelineViewportWScalingStateCreateInfoNV::pname:pViewportWScalings
in `vk.xml` (internal merge request 2975).
* Update copyright dates on Khronos-copyrighted files to 2019 (internal
merge request 2980).
New Extensions:
* `VK_KHR_depth_stencil_resolve`
* `VK_EXT_buffer_device_address`
* `VK_EXT_memory_budget`
* `VK_EXT_memory_priority`
* `VK_EXT_validation_features`
105 lines
4.2 KiB
Plaintext
105 lines
4.2 KiB
Plaintext
[open,refpage='VkValidationFeaturesEXT',desc='Specify validation features to enable or disable for a Vulkan instance',type='structs']
|
|
--
|
|
|
|
When creating a Vulkan instance for which you wish to enable or disable
|
|
specific validation features, add a slink:VkValidationFeaturesEXT structure
|
|
to the pname:pNext chain of the slink:VkInstanceCreateInfo structure,
|
|
specifying the features to be enabled or disabled.
|
|
|
|
include::../api/structs/VkValidationFeaturesEXT.txt[]
|
|
|
|
* pname:sType is the type of this structure.
|
|
* pname:pNext is `NULL` or a pointer to an extension-specific structure.
|
|
* pname:enabledValidationFeatureCount is the number of features to enable.
|
|
* pname:pEnabledValidationFeatures is a pointer to an array of
|
|
elink:VkValidationFeatureEnableEXT values specifying the validation
|
|
features to be enabled.
|
|
* pname:disabledValidationFeatureCount is the number of features to
|
|
disable.
|
|
* pname:pDisabledValidationFeatures is a pointer to an array of
|
|
elink:VkValidationFeatureDisableEXT values specifying the validation
|
|
features to be disabled.
|
|
|
|
include::../validity/structs/VkValidationFeaturesEXT.txt[]
|
|
--
|
|
|
|
[open,refpage='VkValidationFeatureEnableEXT',desc='Specify validation features to enable',type='enums']
|
|
--
|
|
|
|
Possible values of elements of the
|
|
slink:VkValidationFeaturesEXT::pname:pEnabledValidationFeatures array,
|
|
specifying validation features to be enabled, are:
|
|
|
|
include::../api/enums/VkValidationFeatureEnableEXT.txt[]
|
|
|
|
* ename:VK_VALIDATION_FEATURE_ENABLE_GPU_ASSISTED_EXT specifies that
|
|
GPU-assisted validation is enabled.
|
|
Activating this feature instruments shader programs to generate
|
|
additional diagnostic data.
|
|
This feature is disabled by default.
|
|
* ename:VK_VALIDATION_FEATURE_ENABLE_GPU_ASSISTED_RESERVE_BINDING_SLOT_EXT
|
|
specifies that the validation layers reserve a descriptor set binding
|
|
slot for their own use.
|
|
The layer reports a value for
|
|
slink:VkPhysicalDeviceLimits::pname:maxBoundDescriptorSets that is one
|
|
less than the value reported by the device.
|
|
If the device supports the binding of only one descriptor set, the
|
|
validation layer does not perform GPU-assisted validation.
|
|
This feature is disabled by default.
|
|
The GPU-assisted validation feature must be enabled in order to use this
|
|
feature.
|
|
|
|
--
|
|
|
|
[open,refpage='VkValidationFeatureDisableEXT',desc='Specify validation features to disable',type='enums']
|
|
--
|
|
|
|
Possible values of elements of the
|
|
slink:VkValidationFeaturesEXT::pname:pDisabledValidationFeatures array,
|
|
specifying validation features to be disabled, are:
|
|
|
|
include::../api/enums/VkValidationFeatureDisableEXT.txt[]
|
|
|
|
* ename:VK_VALIDATION_FEATURE_DISABLE_ALL_EXT specifies that all
|
|
validation checks are disabled.
|
|
* ename:VK_VALIDATION_FEATURE_DISABLE_SHADERS_EXT specifies that shader
|
|
validation is disabled.
|
|
This feature is enabled by default.
|
|
* ename:VK_VALIDATION_FEATURE_DISABLE_THREAD_SAFETY_EXT specifies that
|
|
thread safety validation is disabled.
|
|
This feature is enabled by default.
|
|
* ename:VK_VALIDATION_FEATURE_DISABLE_API_PARAMETERS_EXT specifies that
|
|
stateless parameter validation is disabled.
|
|
This feature is enabled by default.
|
|
* ename:VK_VALIDATION_FEATURE_DISABLE_OBJECT_LIFETIMES_EXT specifies that
|
|
object lifetime validation is disabled.
|
|
This feature is enabled by default.
|
|
* ename:VK_VALIDATION_FEATURE_DISABLE_CORE_CHECKS_EXT specifies that core
|
|
validation checks are disabled.
|
|
This feature is enabled by default.
|
|
If this feature is disabled, the shader validation and GPU-assisted
|
|
validation features are also disabled.
|
|
* ename:VK_VALIDATION_FEATURE_DISABLE_UNIQUE_HANDLES_EXT specifies that
|
|
protection against duplicate non-dispatchable object handles is
|
|
disabled.
|
|
This feature is enabled by default.
|
|
|
|
--
|
|
|
|
[NOTE]
|
|
.Note
|
|
====
|
|
Disabling checks such as parameter validation and object lifetime validation
|
|
prevents the reporting of error conditions that can cause other validation
|
|
checks to behave incorrectly or crash.
|
|
Some validation checks assume that their inputs are already valid and do not
|
|
always revalidate them.
|
|
====
|
|
|
|
[NOTE]
|
|
.Note
|
|
====
|
|
The `<<VK_EXT_validation_features>>` extension subsumes all the
|
|
functionality provided in the `<<VK_EXT_validation_flags>>` extension.
|
|
====
|