mirror of
https://github.com/ZDoom/zdoom-macos-deps.git
synced 2024-11-29 23:22:35 +00:00
54012 lines
No EOL
4.4 MiB
54012 lines
No EOL
4.4 MiB
{
|
|
"version info": {
|
|
"schema version": 2,
|
|
"api version": "1.3.224",
|
|
"comment": "from git branch: github-main commit: 5ca346bf39db36ff06e24686f0a815754c5f7c16",
|
|
"date": "2022-08-04 08:27:10Z"
|
|
},
|
|
"validation": {
|
|
"vkGetInstanceProcAddr": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkGetInstanceProcAddr-instance-parameter",
|
|
"text": " If <code>instance</code> is not <code>NULL</code>, <code>instance</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkInstance\">VkInstance</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetInstanceProcAddr-pName-parameter",
|
|
"text": " <code>pName</code> <strong class=\"purple\">must</strong> be a null-terminated UTF-8 string"
|
|
}
|
|
]
|
|
},
|
|
"vkGetDeviceProcAddr": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkGetDeviceProcAddr-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDeviceProcAddr-pName-parameter",
|
|
"text": " <code>pName</code> <strong class=\"purple\">must</strong> be a null-terminated UTF-8 string"
|
|
}
|
|
]
|
|
},
|
|
"vkEnumerateInstanceVersion": {
|
|
"(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-vkEnumerateInstanceVersion-pApiVersion-parameter",
|
|
"text": " <code>pApiVersion</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>uint32_t</code> value"
|
|
}
|
|
]
|
|
},
|
|
"vkCreateInstance": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCreateInstance-ppEnabledExtensionNames-01388",
|
|
"text": " All <a href=\"#extendingvulkan-extensions-extensiondependencies\">required extensions</a> for each extension in the <a href=\"#VkInstanceCreateInfo\">VkInstanceCreateInfo</a>::<code>ppEnabledExtensionNames</code> list <strong class=\"purple\">must</strong> also be present in that list"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateInstance-pCreateInfo-parameter",
|
|
"text": " <code>pCreateInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkInstanceCreateInfo\">VkInstanceCreateInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateInstance-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateInstance-pInstance-parameter",
|
|
"text": " <code>pInstance</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkInstance\">VkInstance</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkInstanceCreateInfo": {
|
|
"(VK_EXT_debug_report,VK_EXT_debug_utils,VK_KHR_portability_enumeration)+(VK_EXT_debug_report)": [
|
|
{
|
|
"vuid": "VUID-VkInstanceCreateInfo-pNext-04925",
|
|
"text": " If the <code>pNext</code> chain of <code>VkInstanceCreateInfo</code> includes a <code>VkDebugReportCallbackCreateInfoEXT</code> structure, the list of enabled extensions in <code>ppEnabledExtensionNames</code> <strong class=\"purple\">must</strong> contain <code><a href=\"#VK_EXT_debug_report\">VK_EXT_debug_report</a></code>"
|
|
}
|
|
],
|
|
"(VK_EXT_debug_report,VK_EXT_debug_utils,VK_KHR_portability_enumeration)+(VK_EXT_debug_utils)": [
|
|
{
|
|
"vuid": "VUID-VkInstanceCreateInfo-pNext-04926",
|
|
"text": " If the <code>pNext</code> chain of <code>VkInstanceCreateInfo</code> includes a <code>VkDebugUtilsMessengerCreateInfoEXT</code> structure, the list of enabled extensions in <code>ppEnabledExtensionNames</code> <strong class=\"purple\">must</strong> contain <code><a href=\"#VK_EXT_debug_utils\">VK_EXT_debug_utils</a></code>"
|
|
}
|
|
],
|
|
"(VK_EXT_debug_report,VK_EXT_debug_utils,VK_KHR_portability_enumeration)+(VK_EXT_metal_objects)": [
|
|
{
|
|
"vuid": "VUID-VkInstanceCreateInfo-pNext-06779",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkExportMetalObjectCreateInfoEXT\">VkExportMetalObjectCreateInfoEXT</a> structure, its <code>exportObjectType</code> member <strong class=\"purple\">must</strong> be either <code>VK_EXPORT_METAL_OBJECT_TYPE_METAL_DEVICE_BIT_EXT</code> or <code>VK_EXPORT_METAL_OBJECT_TYPE_METAL_COMMAND_QUEUE_BIT_EXT</code>."
|
|
}
|
|
],
|
|
"(VK_EXT_debug_report,VK_EXT_debug_utils,VK_KHR_portability_enumeration)+(VK_KHR_portability_enumeration)": [
|
|
{
|
|
"vuid": "VUID-VkInstanceCreateInfo-flags-06559",
|
|
"text": " If <code>flags</code> has the <code>VK_INSTANCE_CREATE_ENUMERATE_PORTABILITY_BIT_KHR</code> bit set, the list of enabled extensions in <code>ppEnabledExtensionNames</code> <strong class=\"purple\">must</strong> contain <code><a href=\"#VK_KHR_portability_enumeration\">VK_KHR_portability_enumeration</a></code>"
|
|
}
|
|
],
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkInstanceCreateInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_INSTANCE_CREATE_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkInstanceCreateInfo-pNext-pNext",
|
|
"text": " Each <code>pNext</code> member of any structure (including this one) in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be either <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkDebugReportCallbackCreateInfoEXT\">VkDebugReportCallbackCreateInfoEXT</a>, <a href=\"#VkDebugUtilsMessengerCreateInfoEXT\">VkDebugUtilsMessengerCreateInfoEXT</a>, <a href=\"#VkExportMetalObjectCreateInfoEXT\">VkExportMetalObjectCreateInfoEXT</a>, <a href=\"#VkValidationFeaturesEXT\">VkValidationFeaturesEXT</a>, or <a href=\"#VkValidationFlagsEXT\">VkValidationFlagsEXT</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkInstanceCreateInfo-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique, with the exception of structures of type <a href=\"#VkDebugUtilsMessengerCreateInfoEXT\">VkDebugUtilsMessengerCreateInfoEXT</a> or <a href=\"#VkExportMetalObjectCreateInfoEXT\">VkExportMetalObjectCreateInfoEXT</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkInstanceCreateInfo-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkInstanceCreateFlagBits\">VkInstanceCreateFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkInstanceCreateInfo-pApplicationInfo-parameter",
|
|
"text": " If <code>pApplicationInfo</code> is not <code>NULL</code>, <code>pApplicationInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkApplicationInfo\">VkApplicationInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkInstanceCreateInfo-ppEnabledLayerNames-parameter",
|
|
"text": " If <code>enabledLayerCount</code> is not <code>0</code>, <code>ppEnabledLayerNames</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>enabledLayerCount</code> null-terminated UTF-8 strings"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkInstanceCreateInfo-ppEnabledExtensionNames-parameter",
|
|
"text": " If <code>enabledExtensionCount</code> is not <code>0</code>, <code>ppEnabledExtensionNames</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>enabledExtensionCount</code> null-terminated UTF-8 strings"
|
|
}
|
|
]
|
|
},
|
|
"VkValidationFlagsEXT": {
|
|
"(VK_EXT_validation_flags)": [
|
|
{
|
|
"vuid": "VUID-VkValidationFlagsEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_VALIDATION_FLAGS_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkValidationFlagsEXT-pDisabledValidationChecks-parameter",
|
|
"text": " <code>pDisabledValidationChecks</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>disabledValidationCheckCount</code> valid <a href=\"#VkValidationCheckEXT\">VkValidationCheckEXT</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkValidationFlagsEXT-disabledValidationCheckCount-arraylength",
|
|
"text": " <code>disabledValidationCheckCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkValidationFeaturesEXT": {
|
|
"(VK_EXT_validation_features)": [
|
|
{
|
|
"vuid": "VUID-VkValidationFeaturesEXT-pEnabledValidationFeatures-02967",
|
|
"text": " If the <code>pEnabledValidationFeatures</code> array contains <code>VK_VALIDATION_FEATURE_ENABLE_GPU_ASSISTED_RESERVE_BINDING_SLOT_EXT</code>, then it <strong class=\"purple\">must</strong> also contain <code>VK_VALIDATION_FEATURE_ENABLE_GPU_ASSISTED_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkValidationFeaturesEXT-pEnabledValidationFeatures-02968",
|
|
"text": " If the <code>pEnabledValidationFeatures</code> array contains <code>VK_VALIDATION_FEATURE_ENABLE_DEBUG_PRINTF_EXT</code>, then it <strong class=\"purple\">must</strong> not contain <code>VK_VALIDATION_FEATURE_ENABLE_GPU_ASSISTED_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkValidationFeaturesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_VALIDATION_FEATURES_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkValidationFeaturesEXT-pEnabledValidationFeatures-parameter",
|
|
"text": " If <code>enabledValidationFeatureCount</code> is not <code>0</code>, <code>pEnabledValidationFeatures</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>enabledValidationFeatureCount</code> valid <a href=\"#VkValidationFeatureEnableEXT\">VkValidationFeatureEnableEXT</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkValidationFeaturesEXT-pDisabledValidationFeatures-parameter",
|
|
"text": " If <code>disabledValidationFeatureCount</code> is not <code>0</code>, <code>pDisabledValidationFeatures</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>disabledValidationFeatureCount</code> valid <a href=\"#VkValidationFeatureDisableEXT\">VkValidationFeatureDisableEXT</a> values"
|
|
}
|
|
]
|
|
},
|
|
"VkApplicationInfo": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkApplicationInfo-apiVersion-04010",
|
|
"text": " If <code>apiVersion</code> is not <code>0</code>, then it <strong class=\"purple\">must</strong> be greater than or equal to <a href=\"#VK_API_VERSION_1_0\">VK_API_VERSION_1_0</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkApplicationInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_APPLICATION_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkApplicationInfo-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkApplicationInfo-pApplicationName-parameter",
|
|
"text": " If <code>pApplicationName</code> is not <code>NULL</code>, <code>pApplicationName</code> <strong class=\"purple\">must</strong> be a null-terminated UTF-8 string"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkApplicationInfo-pEngineName-parameter",
|
|
"text": " If <code>pEngineName</code> is not <code>NULL</code>, <code>pEngineName</code> <strong class=\"purple\">must</strong> be a null-terminated UTF-8 string"
|
|
}
|
|
]
|
|
},
|
|
"vkDestroyInstance": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkDestroyInstance-instance-00629",
|
|
"text": " All child objects created using <code>instance</code> <strong class=\"purple\">must</strong> have been destroyed prior to destroying <code>instance</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyInstance-instance-00630",
|
|
"text": " If <code>VkAllocationCallbacks</code> were provided when <code>instance</code> was created, a compatible set of callbacks <strong class=\"purple\">must</strong> be provided here"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyInstance-instance-00631",
|
|
"text": " If no <code>VkAllocationCallbacks</code> were provided when <code>instance</code> was created, <code>pAllocator</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyInstance-instance-parameter",
|
|
"text": " If <code>instance</code> is not <code>NULL</code>, <code>instance</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkInstance\">VkInstance</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyInstance-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"vkEnumeratePhysicalDevices": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkEnumeratePhysicalDevices-instance-parameter",
|
|
"text": " <code>instance</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkInstance\">VkInstance</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkEnumeratePhysicalDevices-pPhysicalDeviceCount-parameter",
|
|
"text": " <code>pPhysicalDeviceCount</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>uint32_t</code> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkEnumeratePhysicalDevices-pPhysicalDevices-parameter",
|
|
"text": " If the value referenced by <code>pPhysicalDeviceCount</code> is not <code>0</code>, and <code>pPhysicalDevices</code> is not <code>NULL</code>, <code>pPhysicalDevices</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>pPhysicalDeviceCount</code> <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handles"
|
|
}
|
|
]
|
|
},
|
|
"vkGetPhysicalDeviceProperties": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceProperties-physicalDevice-parameter",
|
|
"text": " <code>physicalDevice</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceProperties-pProperties-parameter",
|
|
"text": " <code>pProperties</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkPhysicalDeviceProperties\">VkPhysicalDeviceProperties</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"vkGetPhysicalDeviceProperties2": {
|
|
"(VK_VERSION_1_1,VK_KHR_get_physical_device_properties2)": [
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceProperties2-physicalDevice-parameter",
|
|
"text": " <code>physicalDevice</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceProperties2-pProperties-parameter",
|
|
"text": " <code>pProperties</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkPhysicalDeviceProperties2\">VkPhysicalDeviceProperties2</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceProperties2": {
|
|
"(VK_VERSION_1_1,VK_KHR_get_physical_device_properties2)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceProperties2-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_PROPERTIES_2</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceProperties2-pNext-pNext",
|
|
"text": " Each <code>pNext</code> member of any structure (including this one) in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be either <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkPhysicalDeviceAccelerationStructurePropertiesKHR\">VkPhysicalDeviceAccelerationStructurePropertiesKHR</a>, <a href=\"#VkPhysicalDeviceBlendOperationAdvancedPropertiesEXT\">VkPhysicalDeviceBlendOperationAdvancedPropertiesEXT</a>, <a href=\"#VkPhysicalDeviceConservativeRasterizationPropertiesEXT\">VkPhysicalDeviceConservativeRasterizationPropertiesEXT</a>, <a href=\"#VkPhysicalDeviceCooperativeMatrixPropertiesNV\">VkPhysicalDeviceCooperativeMatrixPropertiesNV</a>, <a href=\"#VkPhysicalDeviceCustomBorderColorPropertiesEXT\">VkPhysicalDeviceCustomBorderColorPropertiesEXT</a>, <a href=\"#VkPhysicalDeviceDepthStencilResolveProperties\">VkPhysicalDeviceDepthStencilResolveProperties</a>, <a href=\"#VkPhysicalDeviceDescriptorIndexingProperties\">VkPhysicalDeviceDescriptorIndexingProperties</a>, <a href=\"#VkPhysicalDeviceDeviceGeneratedCommandsPropertiesNV\">VkPhysicalDeviceDeviceGeneratedCommandsPropertiesNV</a>, <a href=\"#VkPhysicalDeviceDiscardRectanglePropertiesEXT\">VkPhysicalDeviceDiscardRectanglePropertiesEXT</a>, <a href=\"#VkPhysicalDeviceDriverProperties\">VkPhysicalDeviceDriverProperties</a>, <a href=\"#VkPhysicalDeviceDrmPropertiesEXT\">VkPhysicalDeviceDrmPropertiesEXT</a>, <a href=\"#VkPhysicalDeviceExternalMemoryHostPropertiesEXT\">VkPhysicalDeviceExternalMemoryHostPropertiesEXT</a>, <a href=\"#VkPhysicalDeviceFloatControlsProperties\">VkPhysicalDeviceFloatControlsProperties</a>, <a href=\"#VkPhysicalDeviceFragmentDensityMap2PropertiesEXT\">VkPhysicalDeviceFragmentDensityMap2PropertiesEXT</a>, <a href=\"#VkPhysicalDeviceFragmentDensityMapOffsetPropertiesQCOM\">VkPhysicalDeviceFragmentDensityMapOffsetPropertiesQCOM</a>, <a href=\"#VkPhysicalDeviceFragmentDensityMapPropertiesEXT\">VkPhysicalDeviceFragmentDensityMapPropertiesEXT</a>, <a href=\"#VkPhysicalDeviceFragmentShaderBarycentricPropertiesKHR\">VkPhysicalDeviceFragmentShaderBarycentricPropertiesKHR</a>, <a href=\"#VkPhysicalDeviceFragmentShadingRateEnumsPropertiesNV\">VkPhysicalDeviceFragmentShadingRateEnumsPropertiesNV</a>, <a href=\"#VkPhysicalDeviceFragmentShadingRatePropertiesKHR\">VkPhysicalDeviceFragmentShadingRatePropertiesKHR</a>, <a href=\"#VkPhysicalDeviceGraphicsPipelineLibraryPropertiesEXT\">VkPhysicalDeviceGraphicsPipelineLibraryPropertiesEXT</a>, <a href=\"#VkPhysicalDeviceIDProperties\">VkPhysicalDeviceIDProperties</a>, <a href=\"#VkPhysicalDeviceImageProcessingPropertiesQCOM\">VkPhysicalDeviceImageProcessingPropertiesQCOM</a>, <a href=\"#VkPhysicalDeviceInlineUniformBlockProperties\">VkPhysicalDeviceInlineUniformBlockProperties</a>, <a href=\"#VkPhysicalDeviceLineRasterizationPropertiesEXT\">VkPhysicalDeviceLineRasterizationPropertiesEXT</a>, <a href=\"#VkPhysicalDeviceMaintenance3Properties\">VkPhysicalDeviceMaintenance3Properties</a>, <a href=\"#VkPhysicalDeviceMaintenance4Properties\">VkPhysicalDeviceMaintenance4Properties</a>, <a href=\"#VkPhysicalDeviceMeshShaderPropertiesNV\">VkPhysicalDeviceMeshShaderPropertiesNV</a>, <a href=\"#VkPhysicalDeviceMultiDrawPropertiesEXT\">VkPhysicalDeviceMultiDrawPropertiesEXT</a>, <a href=\"#VkPhysicalDeviceMultiviewPerViewAttributesPropertiesNVX\">VkPhysicalDeviceMultiviewPerViewAttributesPropertiesNVX</a>, <a href=\"#VkPhysicalDeviceMultiviewProperties\">VkPhysicalDeviceMultiviewProperties</a>, <a href=\"#VkPhysicalDevicePCIBusInfoPropertiesEXT\">VkPhysicalDevicePCIBusInfoPropertiesEXT</a>, <a href=\"#VkPhysicalDevicePerformanceQueryPropertiesKHR\">VkPhysicalDevicePerformanceQueryPropertiesKHR</a>, <a href=\"#VkPhysicalDevicePipelineRobustnessPropertiesEXT\">VkPhysicalDevicePipelineRobustnessPropertiesEXT</a>, <a href=\"#VkPhysicalDevicePointClippingProperties\">VkPhysicalDevicePointClippingProperties</a>, <a href=\"#VkPhysicalDevicePortabilitySubsetPropertiesKHR\">VkPhysicalDevicePortabilitySubsetPropertiesKHR</a>, <a href=\"#VkPhysicalDeviceProtectedMemoryProperties\">VkPhysicalDeviceProtectedMemoryProperties</a>, <a href=\"#VkPhysicalDeviceProvokingVertexPropertiesEXT\">VkPhysicalDeviceProvokingVertexPropertiesEXT</a>, <a href=\"#VkPhysicalDevicePushDescriptorPropertiesKHR\">VkPhysicalDevicePushDescriptorPropertiesKHR</a>, <a href=\"#VkPhysicalDeviceRayTracingPipelinePropertiesKHR\">VkPhysicalDeviceRayTracingPipelinePropertiesKHR</a>, <a href=\"#VkPhysicalDeviceRayTracingPropertiesNV\">VkPhysicalDeviceRayTracingPropertiesNV</a>, <a href=\"#VkPhysicalDeviceRobustness2PropertiesEXT\">VkPhysicalDeviceRobustness2PropertiesEXT</a>, <a href=\"#VkPhysicalDeviceSampleLocationsPropertiesEXT\">VkPhysicalDeviceSampleLocationsPropertiesEXT</a>, <a href=\"#VkPhysicalDeviceSamplerFilterMinmaxProperties\">VkPhysicalDeviceSamplerFilterMinmaxProperties</a>, <a href=\"#VkPhysicalDeviceShaderCoreProperties2AMD\">VkPhysicalDeviceShaderCoreProperties2AMD</a>, <a href=\"#VkPhysicalDeviceShaderCorePropertiesAMD\">VkPhysicalDeviceShaderCorePropertiesAMD</a>, <a href=\"#VkPhysicalDeviceShaderIntegerDotProductProperties\">VkPhysicalDeviceShaderIntegerDotProductProperties</a>, <a href=\"#VkPhysicalDeviceShaderModuleIdentifierPropertiesEXT\">VkPhysicalDeviceShaderModuleIdentifierPropertiesEXT</a>, <a href=\"#VkPhysicalDeviceShaderSMBuiltinsPropertiesNV\">VkPhysicalDeviceShaderSMBuiltinsPropertiesNV</a>, <a href=\"#VkPhysicalDeviceShadingRateImagePropertiesNV\">VkPhysicalDeviceShadingRateImagePropertiesNV</a>, <a href=\"#VkPhysicalDeviceSubgroupProperties\">VkPhysicalDeviceSubgroupProperties</a>, <a href=\"#VkPhysicalDeviceSubgroupSizeControlProperties\">VkPhysicalDeviceSubgroupSizeControlProperties</a>, <a href=\"#VkPhysicalDeviceSubpassShadingPropertiesHUAWEI\">VkPhysicalDeviceSubpassShadingPropertiesHUAWEI</a>, <a href=\"#VkPhysicalDeviceTexelBufferAlignmentProperties\">VkPhysicalDeviceTexelBufferAlignmentProperties</a>, <a href=\"#VkPhysicalDeviceTimelineSemaphoreProperties\">VkPhysicalDeviceTimelineSemaphoreProperties</a>, <a href=\"#VkPhysicalDeviceTransformFeedbackPropertiesEXT\">VkPhysicalDeviceTransformFeedbackPropertiesEXT</a>, <a href=\"#VkPhysicalDeviceVertexAttributeDivisorPropertiesEXT\">VkPhysicalDeviceVertexAttributeDivisorPropertiesEXT</a>, <a href=\"#VkPhysicalDeviceVulkan11Properties\">VkPhysicalDeviceVulkan11Properties</a>, <a href=\"#VkPhysicalDeviceVulkan12Properties\">VkPhysicalDeviceVulkan12Properties</a>, or <a href=\"#VkPhysicalDeviceVulkan13Properties\">VkPhysicalDeviceVulkan13Properties</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceProperties2-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceVulkan11Properties": {
|
|
"(VK_VERSION_1_1,VK_KHR_get_physical_device_properties2)+(VK_VERSION_1_2)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceVulkan11Properties-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_VULKAN_1_1_PROPERTIES</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceVulkan12Properties": {
|
|
"(VK_VERSION_1_1,VK_KHR_get_physical_device_properties2)+(VK_VERSION_1_2)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceVulkan12Properties-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_VULKAN_1_2_PROPERTIES</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceVulkan13Properties": {
|
|
"(VK_VERSION_1_1,VK_KHR_get_physical_device_properties2)+(VK_VERSION_1_3)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceVulkan13Properties-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_VULKAN_1_3_PROPERTIES</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceIDProperties": {
|
|
"(VK_VERSION_1_1,VK_KHR_get_physical_device_properties2)+(VK_VERSION_1_1,VK_KHR_external_memory_capabilities,VK_KHR_external_semaphore_capabilities,VK_KHR_external_fence_capabilities)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceIDProperties-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_ID_PROPERTIES</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceDriverProperties": {
|
|
"(VK_VERSION_1_1,VK_KHR_get_physical_device_properties2)+(VK_VERSION_1_2,VK_KHR_driver_properties)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceDriverProperties-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_DRIVER_PROPERTIES</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDevicePCIBusInfoPropertiesEXT": {
|
|
"(VK_VERSION_1_1,VK_KHR_get_physical_device_properties2)+(VK_EXT_pci_bus_info)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDevicePCIBusInfoPropertiesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_PCI_BUS_INFO_PROPERTIES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceDrmPropertiesEXT": {
|
|
"(VK_VERSION_1_1,VK_KHR_get_physical_device_properties2)+(VK_EXT_physical_device_drm)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceDrmPropertiesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_DRM_PROPERTIES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceShaderIntegerDotProductProperties": {
|
|
"(VK_VERSION_1_3,VK_KHR_shader_integer_dot_product)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceShaderIntegerDotProductProperties-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_SHADER_INTEGER_DOT_PRODUCT_PROPERTIES</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceImageProcessingPropertiesQCOM": {
|
|
"(VK_QCOM_image_processing)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceImageProcessingPropertiesQCOM-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_IMAGE_PROCESSING_PROPERTIES_QCOM</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetPhysicalDeviceQueueFamilyProperties": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceQueueFamilyProperties-physicalDevice-parameter",
|
|
"text": " <code>physicalDevice</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceQueueFamilyProperties-pQueueFamilyPropertyCount-parameter",
|
|
"text": " <code>pQueueFamilyPropertyCount</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>uint32_t</code> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceQueueFamilyProperties-pQueueFamilyProperties-parameter",
|
|
"text": " If the value referenced by <code>pQueueFamilyPropertyCount</code> is not <code>0</code>, and <code>pQueueFamilyProperties</code> is not <code>NULL</code>, <code>pQueueFamilyProperties</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>pQueueFamilyPropertyCount</code> <a href=\"#VkQueueFamilyProperties\">VkQueueFamilyProperties</a> structures"
|
|
}
|
|
]
|
|
},
|
|
"vkGetPhysicalDeviceQueueFamilyProperties2": {
|
|
"(VK_VERSION_1_1,VK_KHR_get_physical_device_properties2)": [
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceQueueFamilyProperties2-physicalDevice-parameter",
|
|
"text": " <code>physicalDevice</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceQueueFamilyProperties2-pQueueFamilyPropertyCount-parameter",
|
|
"text": " <code>pQueueFamilyPropertyCount</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>uint32_t</code> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceQueueFamilyProperties2-pQueueFamilyProperties-parameter",
|
|
"text": " If the value referenced by <code>pQueueFamilyPropertyCount</code> is not <code>0</code>, and <code>pQueueFamilyProperties</code> is not <code>NULL</code>, <code>pQueueFamilyProperties</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>pQueueFamilyPropertyCount</code> <a href=\"#VkQueueFamilyProperties2\">VkQueueFamilyProperties2</a> structures"
|
|
}
|
|
]
|
|
},
|
|
"VkQueueFamilyProperties2": {
|
|
"(VK_VERSION_1_1,VK_KHR_get_physical_device_properties2)": [
|
|
{
|
|
"vuid": "VUID-VkQueueFamilyProperties2-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_QUEUE_FAMILY_PROPERTIES_2</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkQueueFamilyProperties2-pNext-pNext",
|
|
"text": " Each <code>pNext</code> member of any structure (including this one) in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be either <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkQueueFamilyCheckpointProperties2NV\">VkQueueFamilyCheckpointProperties2NV</a>, <a href=\"#VkQueueFamilyCheckpointPropertiesNV\">VkQueueFamilyCheckpointPropertiesNV</a>, <a href=\"#VkQueueFamilyGlobalPriorityPropertiesKHR\">VkQueueFamilyGlobalPriorityPropertiesKHR</a>, <a href=\"#VkQueueFamilyQueryResultStatusProperties2KHR\">VkQueueFamilyQueryResultStatusProperties2KHR</a>, or <a href=\"#VkVideoQueueFamilyProperties2KHR\">VkVideoQueueFamilyProperties2KHR</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkQueueFamilyProperties2-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
}
|
|
]
|
|
},
|
|
"VkQueueFamilyGlobalPriorityPropertiesKHR": {
|
|
"(VK_VERSION_1_1,VK_KHR_get_physical_device_properties2)+(VK_EXT_global_priority_query,VK_KHR_global_priority)": [
|
|
{
|
|
"vuid": "VUID-VkQueueFamilyGlobalPriorityPropertiesKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_QUEUE_FAMILY_GLOBAL_PRIORITY_PROPERTIES_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkQueueFamilyGlobalPriorityPropertiesKHR-priorities-parameter",
|
|
"text": " Any given element of <code>priorities</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkQueueGlobalPriorityKHR\">VkQueueGlobalPriorityKHR</a> value"
|
|
}
|
|
]
|
|
},
|
|
"VkQueueFamilyCheckpointProperties2NV": {
|
|
"(VK_VERSION_1_1,VK_KHR_get_physical_device_properties2)+(VK_NV_device_diagnostic_checkpoints)+(VK_VERSION_1_3,VK_KHR_synchronization2)": [
|
|
{
|
|
"vuid": "VUID-VkQueueFamilyCheckpointProperties2NV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_QUEUE_FAMILY_CHECKPOINT_PROPERTIES_2_NV</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkQueueFamilyCheckpointPropertiesNV": {
|
|
"(VK_VERSION_1_1,VK_KHR_get_physical_device_properties2)+(VK_NV_device_diagnostic_checkpoints)": [
|
|
{
|
|
"vuid": "VUID-VkQueueFamilyCheckpointPropertiesNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_QUEUE_FAMILY_CHECKPOINT_PROPERTIES_NV</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkEnumeratePhysicalDeviceQueueFamilyPerformanceQueryCountersKHR": {
|
|
"(VK_KHR_performance_query)": [
|
|
{
|
|
"vuid": "VUID-vkEnumeratePhysicalDeviceQueueFamilyPerformanceQueryCountersKHR-physicalDevice-parameter",
|
|
"text": " <code>physicalDevice</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkEnumeratePhysicalDeviceQueueFamilyPerformanceQueryCountersKHR-pCounterCount-parameter",
|
|
"text": " <code>pCounterCount</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>uint32_t</code> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkEnumeratePhysicalDeviceQueueFamilyPerformanceQueryCountersKHR-pCounters-parameter",
|
|
"text": " If the value referenced by <code>pCounterCount</code> is not <code>0</code>, and <code>pCounters</code> is not <code>NULL</code>, <code>pCounters</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>pCounterCount</code> <a href=\"#VkPerformanceCounterKHR\">VkPerformanceCounterKHR</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkEnumeratePhysicalDeviceQueueFamilyPerformanceQueryCountersKHR-pCounterDescriptions-parameter",
|
|
"text": " If the value referenced by <code>pCounterCount</code> is not <code>0</code>, and <code>pCounterDescriptions</code> is not <code>NULL</code>, <code>pCounterDescriptions</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>pCounterCount</code> <a href=\"#VkPerformanceCounterDescriptionKHR\">VkPerformanceCounterDescriptionKHR</a> structures"
|
|
}
|
|
]
|
|
},
|
|
"VkPerformanceCounterKHR": {
|
|
"(VK_KHR_performance_query)": [
|
|
{
|
|
"vuid": "VUID-VkPerformanceCounterKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PERFORMANCE_COUNTER_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPerformanceCounterKHR-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPerformanceCounterDescriptionKHR": {
|
|
"(VK_KHR_performance_query)": [
|
|
{
|
|
"vuid": "VUID-VkPerformanceCounterDescriptionKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PERFORMANCE_COUNTER_DESCRIPTION_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPerformanceCounterDescriptionKHR-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkEnumeratePhysicalDeviceGroups": {
|
|
"(VK_VERSION_1_1,VK_KHR_device_group_creation)": [
|
|
{
|
|
"vuid": "VUID-vkEnumeratePhysicalDeviceGroups-instance-parameter",
|
|
"text": " <code>instance</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkInstance\">VkInstance</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkEnumeratePhysicalDeviceGroups-pPhysicalDeviceGroupCount-parameter",
|
|
"text": " <code>pPhysicalDeviceGroupCount</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>uint32_t</code> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkEnumeratePhysicalDeviceGroups-pPhysicalDeviceGroupProperties-parameter",
|
|
"text": " If the value referenced by <code>pPhysicalDeviceGroupCount</code> is not <code>0</code>, and <code>pPhysicalDeviceGroupProperties</code> is not <code>NULL</code>, <code>pPhysicalDeviceGroupProperties</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>pPhysicalDeviceGroupCount</code> <a href=\"#VkPhysicalDeviceGroupProperties\">VkPhysicalDeviceGroupProperties</a> structures"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceGroupProperties": {
|
|
"(VK_VERSION_1_1,VK_KHR_device_group_creation)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceGroupProperties-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_GROUP_PROPERTIES</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceGroupProperties-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCreateDevice": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCreateDevice-ppEnabledExtensionNames-01387",
|
|
"text": " All <a href=\"#extendingvulkan-extensions-extensiondependencies\">required device extensions</a> for each extension in the <a href=\"#VkDeviceCreateInfo\">VkDeviceCreateInfo</a>::<code>ppEnabledExtensionNames</code> list <strong class=\"purple\">must</strong> also be present in that list"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateDevice-physicalDevice-parameter",
|
|
"text": " <code>physicalDevice</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateDevice-pCreateInfo-parameter",
|
|
"text": " <code>pCreateInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkDeviceCreateInfo\">VkDeviceCreateInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateDevice-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateDevice-pDevice-parameter",
|
|
"text": " <code>pDevice</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkDeviceCreateInfo": {
|
|
"!(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-VkDeviceCreateInfo-queueFamilyIndex-00372",
|
|
"text": " The <code>queueFamilyIndex</code> member of each element of <code>pQueueCreateInfos</code> <strong class=\"purple\">must</strong> be unique within <code>pQueueCreateInfos</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-VkDeviceCreateInfo-queueFamilyIndex-02802",
|
|
"text": " The <code>queueFamilyIndex</code> member of each element of <code>pQueueCreateInfos</code> <strong class=\"purple\">must</strong> be unique within <code>pQueueCreateInfos</code>, except that two members can share the same <code>queueFamilyIndex</code> if one describes protected-capable queues and one describes queues that are not protected-capable"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceCreateInfo-pQueueCreateInfos-06755",
|
|
"text": " If multiple elements of <code>pQueueCreateInfos</code> share the same <code>queueFamilyIndex</code>, the sum of their <code>queueCount</code> members <strong class=\"purple\">must</strong> be less than or equal to the <code>queueCount</code> member of the <code>VkQueueFamilyProperties</code> structure, as returned by <code>vkGetPhysicalDeviceQueueFamilyProperties</code> in the <code>pQueueFamilyProperties</code>[queueFamilyIndex]"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1)+(VK_KHR_global_priority,VK_EXT_global_priority)": [
|
|
{
|
|
"vuid": "VUID-VkDeviceCreateInfo-pQueueCreateInfos-06654",
|
|
"text": " If multiple elements of <code>pQueueCreateInfos</code> share the same <code>queueFamilyIndex</code>, then all of such elements <strong class=\"purple\">must</strong> have the same global priority level, which <strong class=\"purple\">can</strong> be specified explicitly by the including a <a href=\"#VkDeviceQueueGlobalPriorityCreateInfoKHR\">VkDeviceQueueGlobalPriorityCreateInfoKHR</a> structure in the <code>pNext</code> chain, or by the implicit default value"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_get_physical_device_properties2)": [
|
|
{
|
|
"vuid": "VUID-VkDeviceCreateInfo-pNext-00373",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkPhysicalDeviceFeatures2\">VkPhysicalDeviceFeatures2</a> structure, then <code>pEnabledFeatures</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
}
|
|
],
|
|
"(VK_AMD_negative_viewport_height)+(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-VkDeviceCreateInfo-ppEnabledExtensionNames-01840",
|
|
"text": " <code>ppEnabledExtensionNames</code> <strong class=\"purple\">must</strong> not contain <code><a href=\"#VK_AMD_negative_viewport_height\">VK_AMD_negative_viewport_height</a></code>"
|
|
}
|
|
],
|
|
"(VK_AMD_negative_viewport_height)+!(VK_VERSION_1_1)+(VK_KHR_maintenance1)": [
|
|
{
|
|
"vuid": "VUID-VkDeviceCreateInfo-ppEnabledExtensionNames-00374",
|
|
"text": " <code>ppEnabledExtensionNames</code> <strong class=\"purple\">must</strong> not contain both <code><a href=\"#VK_KHR_maintenance1\">VK_KHR_maintenance1</a></code> and <code><a href=\"#VK_AMD_negative_viewport_height\">VK_AMD_negative_viewport_height</a></code>"
|
|
}
|
|
],
|
|
"(VK_EXT_buffer_device_address+VK_KHR_buffer_device_address)": [
|
|
{
|
|
"vuid": "VUID-VkDeviceCreateInfo-ppEnabledExtensionNames-03328",
|
|
"text": " <code>ppEnabledExtensionNames</code> <strong class=\"purple\">must</strong> not contain both <code><a href=\"#VK_KHR_buffer_device_address\">VK_KHR_buffer_device_address</a></code> and <code><a href=\"#VK_EXT_buffer_device_address\">VK_EXT_buffer_device_address</a></code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2)+(VK_EXT_buffer_device_address)": [
|
|
{
|
|
"vuid": "VUID-VkDeviceCreateInfo-pNext-04748",
|
|
"text": " if the <code>pNext</code> chain includes a <a href=\"#VkPhysicalDeviceVulkan12Features\">VkPhysicalDeviceVulkan12Features</a> structure and <a href=\"#VkPhysicalDeviceVulkan12Features\">VkPhysicalDeviceVulkan12Features</a>::<code>bufferDeviceAddress</code> is <code>VK_TRUE</code>, <code>ppEnabledExtensionNames</code> <strong class=\"purple\">must</strong> not contain <code><a href=\"#VK_EXT_buffer_device_address\">VK_EXT_buffer_device_address</a></code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2)": [
|
|
{
|
|
"vuid": "VUID-VkDeviceCreateInfo-pNext-02829",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkPhysicalDeviceVulkan11Features\">VkPhysicalDeviceVulkan11Features</a> structure, then it <strong class=\"purple\">must</strong> not include a <a href=\"#VkPhysicalDevice16BitStorageFeatures\">VkPhysicalDevice16BitStorageFeatures</a>, <a href=\"#VkPhysicalDeviceMultiviewFeatures\">VkPhysicalDeviceMultiviewFeatures</a>, <a href=\"#VkPhysicalDeviceVariablePointersFeatures\">VkPhysicalDeviceVariablePointersFeatures</a>, <a href=\"#VkPhysicalDeviceProtectedMemoryFeatures\">VkPhysicalDeviceProtectedMemoryFeatures</a>, <a href=\"#VkPhysicalDeviceSamplerYcbcrConversionFeatures\">VkPhysicalDeviceSamplerYcbcrConversionFeatures</a>, or <a href=\"#VkPhysicalDeviceShaderDrawParametersFeatures\">VkPhysicalDeviceShaderDrawParametersFeatures</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceCreateInfo-pNext-02830",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkPhysicalDeviceVulkan12Features\">VkPhysicalDeviceVulkan12Features</a> structure, then it <strong class=\"purple\">must</strong> not include a <a href=\"#VkPhysicalDevice8BitStorageFeatures\">VkPhysicalDevice8BitStorageFeatures</a>, <a href=\"#VkPhysicalDeviceShaderAtomicInt64Features\">VkPhysicalDeviceShaderAtomicInt64Features</a>, <a href=\"#VkPhysicalDeviceShaderFloat16Int8Features\">VkPhysicalDeviceShaderFloat16Int8Features</a>, <a href=\"#VkPhysicalDeviceDescriptorIndexingFeatures\">VkPhysicalDeviceDescriptorIndexingFeatures</a>, <a href=\"#VkPhysicalDeviceScalarBlockLayoutFeatures\">VkPhysicalDeviceScalarBlockLayoutFeatures</a>, <a href=\"#VkPhysicalDeviceImagelessFramebufferFeatures\">VkPhysicalDeviceImagelessFramebufferFeatures</a>, <a href=\"#VkPhysicalDeviceUniformBufferStandardLayoutFeatures\">VkPhysicalDeviceUniformBufferStandardLayoutFeatures</a>, <a href=\"#VkPhysicalDeviceShaderSubgroupExtendedTypesFeatures\">VkPhysicalDeviceShaderSubgroupExtendedTypesFeatures</a>, <a href=\"#VkPhysicalDeviceSeparateDepthStencilLayoutsFeatures\">VkPhysicalDeviceSeparateDepthStencilLayoutsFeatures</a>, <a href=\"#VkPhysicalDeviceHostQueryResetFeatures\">VkPhysicalDeviceHostQueryResetFeatures</a>, <a href=\"#VkPhysicalDeviceTimelineSemaphoreFeatures\">VkPhysicalDeviceTimelineSemaphoreFeatures</a>, <a href=\"#VkPhysicalDeviceBufferDeviceAddressFeatures\">VkPhysicalDeviceBufferDeviceAddressFeatures</a>, or <a href=\"#VkPhysicalDeviceVulkanMemoryModelFeatures\">VkPhysicalDeviceVulkanMemoryModelFeatures</a> structure"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2)+(VK_KHR_shader_draw_parameters)": [
|
|
{
|
|
"vuid": "VUID-VkDeviceCreateInfo-ppEnabledExtensionNames-04476",
|
|
"text": " If <code>ppEnabledExtensionNames</code> contains <code>\"VK_KHR_shader_draw_parameters\"</code> and the <code>pNext</code> chain includes a <a href=\"#VkPhysicalDeviceVulkan11Features\">VkPhysicalDeviceVulkan11Features</a> structure, then <code>VkPhysicalDeviceVulkan11Features</code>::<code>shaderDrawParameters</code> <strong class=\"purple\">must</strong> be <code>VK_TRUE</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2)+(VK_KHR_draw_indirect_count)": [
|
|
{
|
|
"vuid": "VUID-VkDeviceCreateInfo-ppEnabledExtensionNames-02831",
|
|
"text": " If <code>ppEnabledExtensionNames</code> contains <code>\"VK_KHR_draw_indirect_count\"</code> and the <code>pNext</code> chain includes a <a href=\"#VkPhysicalDeviceVulkan12Features\">VkPhysicalDeviceVulkan12Features</a> structure, then <code>VkPhysicalDeviceVulkan12Features</code>::<code>drawIndirectCount</code> <strong class=\"purple\">must</strong> be <code>VK_TRUE</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2)+(VK_KHR_sampler_mirror_clamp_to_edge)": [
|
|
{
|
|
"vuid": "VUID-VkDeviceCreateInfo-ppEnabledExtensionNames-02832",
|
|
"text": " If <code>ppEnabledExtensionNames</code> contains <code>\"VK_KHR_sampler_mirror_clamp_to_edge\"</code> and the <code>pNext</code> chain includes a <a href=\"#VkPhysicalDeviceVulkan12Features\">VkPhysicalDeviceVulkan12Features</a> structure, then <code>VkPhysicalDeviceVulkan12Features</code>::<code>samplerMirrorClampToEdge</code> <strong class=\"purple\">must</strong> be <code>VK_TRUE</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2)+(VK_EXT_descriptor_indexing)": [
|
|
{
|
|
"vuid": "VUID-VkDeviceCreateInfo-ppEnabledExtensionNames-02833",
|
|
"text": " If <code>ppEnabledExtensionNames</code> contains <code>\"VK_EXT_descriptor_indexing\"</code> and the <code>pNext</code> chain includes a <a href=\"#VkPhysicalDeviceVulkan12Features\">VkPhysicalDeviceVulkan12Features</a> structure, then <code>VkPhysicalDeviceVulkan12Features</code>::<code>descriptorIndexing</code> <strong class=\"purple\">must</strong> be <code>VK_TRUE</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2)+(VK_EXT_sampler_filter_minmax)": [
|
|
{
|
|
"vuid": "VUID-VkDeviceCreateInfo-ppEnabledExtensionNames-02834",
|
|
"text": " If <code>ppEnabledExtensionNames</code> contains <code>\"VK_EXT_sampler_filter_minmax\"</code> and the <code>pNext</code> chain includes a <a href=\"#VkPhysicalDeviceVulkan12Features\">VkPhysicalDeviceVulkan12Features</a> structure, then <code>VkPhysicalDeviceVulkan12Features</code>::<code>samplerFilterMinmax</code> <strong class=\"purple\">must</strong> be <code>VK_TRUE</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2)+(VK_EXT_shader_viewport_index_layer)": [
|
|
{
|
|
"vuid": "VUID-VkDeviceCreateInfo-ppEnabledExtensionNames-02835",
|
|
"text": " If <code>ppEnabledExtensionNames</code> contains <code>\"VK_EXT_shader_viewport_index_layer\"</code> and the <code>pNext</code> chain includes a <a href=\"#VkPhysicalDeviceVulkan12Features\">VkPhysicalDeviceVulkan12Features</a> structure, then <code>VkPhysicalDeviceVulkan12Features</code>::<code>shaderOutputViewportIndex</code> and <code>VkPhysicalDeviceVulkan12Features</code>::<code>shaderOutputLayer</code> <strong class=\"purple\">must</strong> both be <code>VK_TRUE</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3)": [
|
|
{
|
|
"vuid": "VUID-VkDeviceCreateInfo-pNext-06532",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkPhysicalDeviceVulkan13Features\">VkPhysicalDeviceVulkan13Features</a> structure, then it <strong class=\"purple\">must</strong> not include a <a href=\"#VkPhysicalDeviceDynamicRenderingFeatures\">VkPhysicalDeviceDynamicRenderingFeatures</a>, <a href=\"#VkPhysicalDeviceImageRobustnessFeatures\">VkPhysicalDeviceImageRobustnessFeatures</a>, <a href=\"#VkPhysicalDeviceInlineUniformBlockFeatures\">VkPhysicalDeviceInlineUniformBlockFeatures</a>, <a href=\"#VkPhysicalDeviceMaintenance4Features\">VkPhysicalDeviceMaintenance4Features</a>, <a href=\"#VkPhysicalDevicePipelineCreationCacheControlFeatures\">VkPhysicalDevicePipelineCreationCacheControlFeatures</a>, <a href=\"#VkPhysicalDevicePrivateDataFeatures\">VkPhysicalDevicePrivateDataFeatures</a>, <a href=\"#VkPhysicalDeviceShaderDemoteToHelperInvocationFeatures\">VkPhysicalDeviceShaderDemoteToHelperInvocationFeatures</a>, <a href=\"#VkPhysicalDeviceShaderIntegerDotProductFeatures\">VkPhysicalDeviceShaderIntegerDotProductFeatures</a>, <a href=\"#VkPhysicalDeviceShaderTerminateInvocationFeatures\">VkPhysicalDeviceShaderTerminateInvocationFeatures</a>, <a href=\"#VkPhysicalDeviceSubgroupSizeControlFeatures\">VkPhysicalDeviceSubgroupSizeControlFeatures</a>, <a href=\"#VkPhysicalDeviceSynchronization2Features\">VkPhysicalDeviceSynchronization2Features</a>, <a href=\"#VkPhysicalDeviceTextureCompressionASTCHDRFeatures\">VkPhysicalDeviceTextureCompressionASTCHDRFeatures</a>, or <a href=\"#VkPhysicalDeviceZeroInitializeWorkgroupMemoryFeatures\">VkPhysicalDeviceZeroInitializeWorkgroupMemoryFeatures</a> structure"
|
|
}
|
|
],
|
|
"(VK_KHR_portability_subset)": [
|
|
{
|
|
"vuid": "VUID-VkDeviceCreateInfo-pProperties-04451",
|
|
"text": " If the <code><a href=\"#VK_KHR_portability_subset\">VK_KHR_portability_subset</a></code> extension is included in <code>pProperties</code> of <a href=\"#vkEnumerateDeviceExtensionProperties\">vkEnumerateDeviceExtensionProperties</a>, <code>ppEnabledExtensionNames</code> <strong class=\"purple\">must</strong> include <code>\"VK_KHR_portability_subset\"</code>"
|
|
}
|
|
],
|
|
"(VK_KHR_fragment_shading_rate,VK_NV_shading_rate_image)": [
|
|
{
|
|
"vuid": "VUID-VkDeviceCreateInfo-shadingRateImage-04478",
|
|
"text": " If the <a href=\"#features-shadingRateImage\"><code>shadingRateImage</code></a> feature is enabled, the <a href=\"#features-pipelineFragmentShadingRate\"><code>pipelineFragmentShadingRate</code></a> feature <strong class=\"purple\">must</strong> not be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceCreateInfo-shadingRateImage-04479",
|
|
"text": " If the <a href=\"#features-shadingRateImage\"><code>shadingRateImage</code></a> feature is enabled, the <a href=\"#features-primitiveFragmentShadingRate\"><code>primitiveFragmentShadingRate</code></a> feature <strong class=\"purple\">must</strong> not be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceCreateInfo-shadingRateImage-04480",
|
|
"text": " If the <a href=\"#features-shadingRateImage\"><code>shadingRateImage</code></a> feature is enabled, the <a href=\"#features-attachmentFragmentShadingRate\"><code>attachmentFragmentShadingRate</code></a> feature <strong class=\"purple\">must</strong> not be enabled"
|
|
}
|
|
],
|
|
"(VK_KHR_fragment_shading_rate,VK_EXT_fragment_density_map)": [
|
|
{
|
|
"vuid": "VUID-VkDeviceCreateInfo-fragmentDensityMap-04481",
|
|
"text": " If the <a href=\"#features-fragmentDensityMap\"><code>fragmentDensityMap</code></a> feature is enabled, the <a href=\"#features-pipelineFragmentShadingRate\"><code>pipelineFragmentShadingRate</code></a> feature <strong class=\"purple\">must</strong> not be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceCreateInfo-fragmentDensityMap-04482",
|
|
"text": " If the <a href=\"#features-fragmentDensityMap\"><code>fragmentDensityMap</code></a> feature is enabled, the <a href=\"#features-primitiveFragmentShadingRate\"><code>primitiveFragmentShadingRate</code></a> feature <strong class=\"purple\">must</strong> not be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceCreateInfo-fragmentDensityMap-04483",
|
|
"text": " If the <a href=\"#features-fragmentDensityMap\"><code>fragmentDensityMap</code></a> feature is enabled, the <a href=\"#features-attachmentFragmentShadingRate\"><code>attachmentFragmentShadingRate</code></a> feature <strong class=\"purple\">must</strong> not be enabled"
|
|
}
|
|
],
|
|
"(VK_EXT_shader_image_atomic_int64)": [
|
|
{
|
|
"vuid": "VUID-VkDeviceCreateInfo-None-04896",
|
|
"text": " If <a href=\"#features-sparseImageInt64Atomics\"><code>sparseImageInt64Atomics</code></a> is enabled, <a href=\"#features-shaderImageInt64Atomics\"><code>shaderImageInt64Atomics</code></a> <strong class=\"purple\">must</strong> be enabled"
|
|
}
|
|
],
|
|
"(VK_EXT_shader_atomic_float)": [
|
|
{
|
|
"vuid": "VUID-VkDeviceCreateInfo-None-04897",
|
|
"text": " If <a href=\"#features-sparseImageFloat32Atomics\"><code>sparseImageFloat32Atomics</code></a> is enabled, <a href=\"#features-shaderImageFloat32Atomics\"><code>shaderImageFloat32Atomics</code></a> <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceCreateInfo-None-04898",
|
|
"text": " If <a href=\"#features-sparseImageFloat32AtomicAdd\"><code>sparseImageFloat32AtomicAdd</code></a> is enabled, <a href=\"#features-shaderImageFloat32AtomicAdd\"><code>shaderImageFloat32AtomicAdd</code></a> <strong class=\"purple\">must</strong> be enabled"
|
|
}
|
|
],
|
|
"(VK_EXT_shader_atomic_float2)": [
|
|
{
|
|
"vuid": "VUID-VkDeviceCreateInfo-sparseImageFloat32AtomicMinMax-04975",
|
|
"text": " If <a href=\"#features-sparseImageFloat32AtomicMinMax\"><code>sparseImageFloat32AtomicMinMax</code></a> is enabled, <a href=\"#features-shaderImageFloat32AtomicMinMax\"><code>shaderImageFloat32AtomicMinMax</code></a> <strong class=\"purple\">must</strong> be enabled"
|
|
}
|
|
],
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkDeviceCreateInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_DEVICE_CREATE_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceCreateInfo-pNext-pNext",
|
|
"text": " Each <code>pNext</code> member of any structure (including this one) in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be either <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkDeviceDeviceMemoryReportCreateInfoEXT\">VkDeviceDeviceMemoryReportCreateInfoEXT</a>, <a href=\"#VkDeviceDiagnosticsConfigCreateInfoNV\">VkDeviceDiagnosticsConfigCreateInfoNV</a>, <a href=\"#VkDeviceGroupDeviceCreateInfo\">VkDeviceGroupDeviceCreateInfo</a>, <a href=\"#VkDeviceMemoryOverallocationCreateInfoAMD\">VkDeviceMemoryOverallocationCreateInfoAMD</a>, <a href=\"#VkDevicePrivateDataCreateInfo\">VkDevicePrivateDataCreateInfo</a>, <a href=\"#VkPhysicalDevice16BitStorageFeatures\">VkPhysicalDevice16BitStorageFeatures</a>, <a href=\"#VkPhysicalDevice4444FormatsFeaturesEXT\">VkPhysicalDevice4444FormatsFeaturesEXT</a>, <a href=\"#VkPhysicalDevice8BitStorageFeatures\">VkPhysicalDevice8BitStorageFeatures</a>, <a href=\"#VkPhysicalDeviceASTCDecodeFeaturesEXT\">VkPhysicalDeviceASTCDecodeFeaturesEXT</a>, <a href=\"#VkPhysicalDeviceAccelerationStructureFeaturesKHR\">VkPhysicalDeviceAccelerationStructureFeaturesKHR</a>, <a href=\"#VkPhysicalDeviceAmigoProfilingFeaturesSEC\">VkPhysicalDeviceAmigoProfilingFeaturesSEC</a>, <a href=\"#VkPhysicalDeviceAttachmentFeedbackLoopLayoutFeaturesEXT\">VkPhysicalDeviceAttachmentFeedbackLoopLayoutFeaturesEXT</a>, <a href=\"#VkPhysicalDeviceBlendOperationAdvancedFeaturesEXT\">VkPhysicalDeviceBlendOperationAdvancedFeaturesEXT</a>, <a href=\"#VkPhysicalDeviceBorderColorSwizzleFeaturesEXT\">VkPhysicalDeviceBorderColorSwizzleFeaturesEXT</a>, <a href=\"#VkPhysicalDeviceBufferDeviceAddressFeatures\">VkPhysicalDeviceBufferDeviceAddressFeatures</a>, <a href=\"#VkPhysicalDeviceBufferDeviceAddressFeaturesEXT\">VkPhysicalDeviceBufferDeviceAddressFeaturesEXT</a>, <a href=\"#VkPhysicalDeviceCoherentMemoryFeaturesAMD\">VkPhysicalDeviceCoherentMemoryFeaturesAMD</a>, <a href=\"#VkPhysicalDeviceColorWriteEnableFeaturesEXT\">VkPhysicalDeviceColorWriteEnableFeaturesEXT</a>, <a href=\"#VkPhysicalDeviceComputeShaderDerivativesFeaturesNV\">VkPhysicalDeviceComputeShaderDerivativesFeaturesNV</a>, <a href=\"#VkPhysicalDeviceConditionalRenderingFeaturesEXT\">VkPhysicalDeviceConditionalRenderingFeaturesEXT</a>, <a href=\"#VkPhysicalDeviceCooperativeMatrixFeaturesNV\">VkPhysicalDeviceCooperativeMatrixFeaturesNV</a>, <a href=\"#VkPhysicalDeviceCornerSampledImageFeaturesNV\">VkPhysicalDeviceCornerSampledImageFeaturesNV</a>, <a href=\"#VkPhysicalDeviceCoverageReductionModeFeaturesNV\">VkPhysicalDeviceCoverageReductionModeFeaturesNV</a>, <a href=\"#VkPhysicalDeviceCustomBorderColorFeaturesEXT\">VkPhysicalDeviceCustomBorderColorFeaturesEXT</a>, <a href=\"#VkPhysicalDeviceDedicatedAllocationImageAliasingFeaturesNV\">VkPhysicalDeviceDedicatedAllocationImageAliasingFeaturesNV</a>, <a href=\"#VkPhysicalDeviceDepthClipControlFeaturesEXT\">VkPhysicalDeviceDepthClipControlFeaturesEXT</a>, <a href=\"#VkPhysicalDeviceDepthClipEnableFeaturesEXT\">VkPhysicalDeviceDepthClipEnableFeaturesEXT</a>, <a href=\"#VkPhysicalDeviceDescriptorIndexingFeatures\">VkPhysicalDeviceDescriptorIndexingFeatures</a>, <a href=\"#VkPhysicalDeviceDescriptorSetHostMappingFeaturesVALVE\">VkPhysicalDeviceDescriptorSetHostMappingFeaturesVALVE</a>, <a href=\"#VkPhysicalDeviceDeviceGeneratedCommandsFeaturesNV\">VkPhysicalDeviceDeviceGeneratedCommandsFeaturesNV</a>, <a href=\"#VkPhysicalDeviceDeviceMemoryReportFeaturesEXT\">VkPhysicalDeviceDeviceMemoryReportFeaturesEXT</a>, <a href=\"#VkPhysicalDeviceDiagnosticsConfigFeaturesNV\">VkPhysicalDeviceDiagnosticsConfigFeaturesNV</a>, <a href=\"#VkPhysicalDeviceDynamicRenderingFeatures\">VkPhysicalDeviceDynamicRenderingFeatures</a>, <a href=\"#VkPhysicalDeviceExclusiveScissorFeaturesNV\">VkPhysicalDeviceExclusiveScissorFeaturesNV</a>, <a href=\"#VkPhysicalDeviceExtendedDynamicState2FeaturesEXT\">VkPhysicalDeviceExtendedDynamicState2FeaturesEXT</a>, <a href=\"#VkPhysicalDeviceExtendedDynamicStateFeaturesEXT\">VkPhysicalDeviceExtendedDynamicStateFeaturesEXT</a>, <a href=\"#VkPhysicalDeviceExternalMemoryRDMAFeaturesNV\">VkPhysicalDeviceExternalMemoryRDMAFeaturesNV</a>, <a href=\"#VkPhysicalDeviceFeatures2\">VkPhysicalDeviceFeatures2</a>, <a href=\"#VkPhysicalDeviceFragmentDensityMap2FeaturesEXT\">VkPhysicalDeviceFragmentDensityMap2FeaturesEXT</a>, <a href=\"#VkPhysicalDeviceFragmentDensityMapFeaturesEXT\">VkPhysicalDeviceFragmentDensityMapFeaturesEXT</a>, <a href=\"#VkPhysicalDeviceFragmentDensityMapOffsetFeaturesQCOM\">VkPhysicalDeviceFragmentDensityMapOffsetFeaturesQCOM</a>, <a href=\"#VkPhysicalDeviceFragmentShaderBarycentricFeaturesKHR\">VkPhysicalDeviceFragmentShaderBarycentricFeaturesKHR</a>, <a href=\"#VkPhysicalDeviceFragmentShaderInterlockFeaturesEXT\">VkPhysicalDeviceFragmentShaderInterlockFeaturesEXT</a>, <a href=\"#VkPhysicalDeviceFragmentShadingRateEnumsFeaturesNV\">VkPhysicalDeviceFragmentShadingRateEnumsFeaturesNV</a>, <a href=\"#VkPhysicalDeviceFragmentShadingRateFeaturesKHR\">VkPhysicalDeviceFragmentShadingRateFeaturesKHR</a>, <a href=\"#VkPhysicalDeviceGlobalPriorityQueryFeaturesKHR\">VkPhysicalDeviceGlobalPriorityQueryFeaturesKHR</a>, <a href=\"#VkPhysicalDeviceGraphicsPipelineLibraryFeaturesEXT\">VkPhysicalDeviceGraphicsPipelineLibraryFeaturesEXT</a>, <a href=\"#VkPhysicalDeviceHostQueryResetFeatures\">VkPhysicalDeviceHostQueryResetFeatures</a>, <a href=\"#VkPhysicalDeviceImage2DViewOf3DFeaturesEXT\">VkPhysicalDeviceImage2DViewOf3DFeaturesEXT</a>, <a href=\"#VkPhysicalDeviceImageCompressionControlFeaturesEXT\">VkPhysicalDeviceImageCompressionControlFeaturesEXT</a>, <a href=\"#VkPhysicalDeviceImageCompressionControlSwapchainFeaturesEXT\">VkPhysicalDeviceImageCompressionControlSwapchainFeaturesEXT</a>, <a href=\"#VkPhysicalDeviceImageProcessingFeaturesQCOM\">VkPhysicalDeviceImageProcessingFeaturesQCOM</a>, <a href=\"#VkPhysicalDeviceImageRobustnessFeatures\">VkPhysicalDeviceImageRobustnessFeatures</a>, <a href=\"#VkPhysicalDeviceImageViewMinLodFeaturesEXT\">VkPhysicalDeviceImageViewMinLodFeaturesEXT</a>, <a href=\"#VkPhysicalDeviceImagelessFramebufferFeatures\">VkPhysicalDeviceImagelessFramebufferFeatures</a>, <a href=\"#VkPhysicalDeviceIndexTypeUint8FeaturesEXT\">VkPhysicalDeviceIndexTypeUint8FeaturesEXT</a>, <a href=\"#VkPhysicalDeviceInheritedViewportScissorFeaturesNV\">VkPhysicalDeviceInheritedViewportScissorFeaturesNV</a>, <a href=\"#VkPhysicalDeviceInlineUniformBlockFeatures\">VkPhysicalDeviceInlineUniformBlockFeatures</a>, <a href=\"#VkPhysicalDeviceInvocationMaskFeaturesHUAWEI\">VkPhysicalDeviceInvocationMaskFeaturesHUAWEI</a>, <a href=\"#VkPhysicalDeviceLineRasterizationFeaturesEXT\">VkPhysicalDeviceLineRasterizationFeaturesEXT</a>, <a href=\"#VkPhysicalDeviceLinearColorAttachmentFeaturesNV\">VkPhysicalDeviceLinearColorAttachmentFeaturesNV</a>, <a href=\"#VkPhysicalDeviceMaintenance4Features\">VkPhysicalDeviceMaintenance4Features</a>, <a href=\"#VkPhysicalDeviceMemoryPriorityFeaturesEXT\">VkPhysicalDeviceMemoryPriorityFeaturesEXT</a>, <a href=\"#VkPhysicalDeviceMeshShaderFeaturesNV\">VkPhysicalDeviceMeshShaderFeaturesNV</a>, <a href=\"#VkPhysicalDeviceMultiDrawFeaturesEXT\">VkPhysicalDeviceMultiDrawFeaturesEXT</a>, <a href=\"#VkPhysicalDeviceMultisampledRenderToSingleSampledFeaturesEXT\">VkPhysicalDeviceMultisampledRenderToSingleSampledFeaturesEXT</a>, <a href=\"#VkPhysicalDeviceMultiviewFeatures\">VkPhysicalDeviceMultiviewFeatures</a>, <a href=\"#VkPhysicalDeviceMutableDescriptorTypeFeaturesVALVE\">VkPhysicalDeviceMutableDescriptorTypeFeaturesVALVE</a>, <a href=\"#VkPhysicalDeviceNonSeamlessCubeMapFeaturesEXT\">VkPhysicalDeviceNonSeamlessCubeMapFeaturesEXT</a>, <a href=\"#VkPhysicalDevicePageableDeviceLocalMemoryFeaturesEXT\">VkPhysicalDevicePageableDeviceLocalMemoryFeaturesEXT</a>, <a href=\"#VkPhysicalDevicePerformanceQueryFeaturesKHR\">VkPhysicalDevicePerformanceQueryFeaturesKHR</a>, <a href=\"#VkPhysicalDevicePipelineCreationCacheControlFeatures\">VkPhysicalDevicePipelineCreationCacheControlFeatures</a>, <a href=\"#VkPhysicalDevicePipelineExecutablePropertiesFeaturesKHR\">VkPhysicalDevicePipelineExecutablePropertiesFeaturesKHR</a>, <a href=\"#VkPhysicalDevicePipelinePropertiesFeaturesEXT\">VkPhysicalDevicePipelinePropertiesFeaturesEXT</a>, <a href=\"#VkPhysicalDevicePipelineRobustnessFeaturesEXT\">VkPhysicalDevicePipelineRobustnessFeaturesEXT</a>, <a href=\"#VkPhysicalDevicePortabilitySubsetFeaturesKHR\">VkPhysicalDevicePortabilitySubsetFeaturesKHR</a>, <a href=\"#VkPhysicalDevicePresentIdFeaturesKHR\">VkPhysicalDevicePresentIdFeaturesKHR</a>, <a href=\"#VkPhysicalDevicePresentWaitFeaturesKHR\">VkPhysicalDevicePresentWaitFeaturesKHR</a>, <a href=\"#VkPhysicalDevicePrimitiveTopologyListRestartFeaturesEXT\">VkPhysicalDevicePrimitiveTopologyListRestartFeaturesEXT</a>, <a href=\"#VkPhysicalDevicePrimitivesGeneratedQueryFeaturesEXT\">VkPhysicalDevicePrimitivesGeneratedQueryFeaturesEXT</a>, <a href=\"#VkPhysicalDevicePrivateDataFeatures\">VkPhysicalDevicePrivateDataFeatures</a>, <a href=\"#VkPhysicalDeviceProtectedMemoryFeatures\">VkPhysicalDeviceProtectedMemoryFeatures</a>, <a href=\"#VkPhysicalDeviceProvokingVertexFeaturesEXT\">VkPhysicalDeviceProvokingVertexFeaturesEXT</a>, <a href=\"#VkPhysicalDeviceRGBA10X6FormatsFeaturesEXT\">VkPhysicalDeviceRGBA10X6FormatsFeaturesEXT</a>, <a href=\"#VkPhysicalDeviceRasterizationOrderAttachmentAccessFeaturesARM\">VkPhysicalDeviceRasterizationOrderAttachmentAccessFeaturesARM</a>, <a href=\"#VkPhysicalDeviceRayQueryFeaturesKHR\">VkPhysicalDeviceRayQueryFeaturesKHR</a>, <a href=\"#VkPhysicalDeviceRayTracingMaintenance1FeaturesKHR\">VkPhysicalDeviceRayTracingMaintenance1FeaturesKHR</a>, <a href=\"#VkPhysicalDeviceRayTracingMotionBlurFeaturesNV\">VkPhysicalDeviceRayTracingMotionBlurFeaturesNV</a>, <a href=\"#VkPhysicalDeviceRayTracingPipelineFeaturesKHR\">VkPhysicalDeviceRayTracingPipelineFeaturesKHR</a>, <a href=\"#VkPhysicalDeviceRepresentativeFragmentTestFeaturesNV\">VkPhysicalDeviceRepresentativeFragmentTestFeaturesNV</a>, <a href=\"#VkPhysicalDeviceRobustness2FeaturesEXT\">VkPhysicalDeviceRobustness2FeaturesEXT</a>, <a href=\"#VkPhysicalDeviceSamplerYcbcrConversionFeatures\">VkPhysicalDeviceSamplerYcbcrConversionFeatures</a>, <a href=\"#VkPhysicalDeviceScalarBlockLayoutFeatures\">VkPhysicalDeviceScalarBlockLayoutFeatures</a>, <a href=\"#VkPhysicalDeviceSeparateDepthStencilLayoutsFeatures\">VkPhysicalDeviceSeparateDepthStencilLayoutsFeatures</a>, <a href=\"#VkPhysicalDeviceShaderAtomicFloat2FeaturesEXT\">VkPhysicalDeviceShaderAtomicFloat2FeaturesEXT</a>, <a href=\"#VkPhysicalDeviceShaderAtomicFloatFeaturesEXT\">VkPhysicalDeviceShaderAtomicFloatFeaturesEXT</a>, <a href=\"#VkPhysicalDeviceShaderAtomicInt64Features\">VkPhysicalDeviceShaderAtomicInt64Features</a>, <a href=\"#VkPhysicalDeviceShaderClockFeaturesKHR\">VkPhysicalDeviceShaderClockFeaturesKHR</a>, <a href=\"#VkPhysicalDeviceShaderDemoteToHelperInvocationFeatures\">VkPhysicalDeviceShaderDemoteToHelperInvocationFeatures</a>, <a href=\"#VkPhysicalDeviceShaderDrawParametersFeatures\">VkPhysicalDeviceShaderDrawParametersFeatures</a>, <a href=\"#VkPhysicalDeviceShaderEarlyAndLateFragmentTestsFeaturesAMD\">VkPhysicalDeviceShaderEarlyAndLateFragmentTestsFeaturesAMD</a>, <a href=\"#VkPhysicalDeviceShaderFloat16Int8Features\">VkPhysicalDeviceShaderFloat16Int8Features</a>, <a href=\"#VkPhysicalDeviceShaderImageAtomicInt64FeaturesEXT\">VkPhysicalDeviceShaderImageAtomicInt64FeaturesEXT</a>, <a href=\"#VkPhysicalDeviceShaderImageFootprintFeaturesNV\">VkPhysicalDeviceShaderImageFootprintFeaturesNV</a>, <a href=\"#VkPhysicalDeviceShaderIntegerDotProductFeatures\">VkPhysicalDeviceShaderIntegerDotProductFeatures</a>, <a href=\"#VkPhysicalDeviceShaderIntegerFunctions2FeaturesINTEL\">VkPhysicalDeviceShaderIntegerFunctions2FeaturesINTEL</a>, <a href=\"#VkPhysicalDeviceShaderModuleIdentifierFeaturesEXT\">VkPhysicalDeviceShaderModuleIdentifierFeaturesEXT</a>, <a href=\"#VkPhysicalDeviceShaderSMBuiltinsFeaturesNV\">VkPhysicalDeviceShaderSMBuiltinsFeaturesNV</a>, <a href=\"#VkPhysicalDeviceShaderSubgroupExtendedTypesFeatures\">VkPhysicalDeviceShaderSubgroupExtendedTypesFeatures</a>, <a href=\"#VkPhysicalDeviceShaderSubgroupUniformControlFlowFeaturesKHR\">VkPhysicalDeviceShaderSubgroupUniformControlFlowFeaturesKHR</a>, <a href=\"#VkPhysicalDeviceShaderTerminateInvocationFeatures\">VkPhysicalDeviceShaderTerminateInvocationFeatures</a>, <a href=\"#VkPhysicalDeviceShadingRateImageFeaturesNV\">VkPhysicalDeviceShadingRateImageFeaturesNV</a>, <a href=\"#VkPhysicalDeviceSubgroupSizeControlFeatures\">VkPhysicalDeviceSubgroupSizeControlFeatures</a>, <a href=\"#VkPhysicalDeviceSubpassMergeFeedbackFeaturesEXT\">VkPhysicalDeviceSubpassMergeFeedbackFeaturesEXT</a>, <a href=\"#VkPhysicalDeviceSubpassShadingFeaturesHUAWEI\">VkPhysicalDeviceSubpassShadingFeaturesHUAWEI</a>, <a href=\"#VkPhysicalDeviceSynchronization2Features\">VkPhysicalDeviceSynchronization2Features</a>, <a href=\"#VkPhysicalDeviceTexelBufferAlignmentFeaturesEXT\">VkPhysicalDeviceTexelBufferAlignmentFeaturesEXT</a>, <a href=\"#VkPhysicalDeviceTextureCompressionASTCHDRFeatures\">VkPhysicalDeviceTextureCompressionASTCHDRFeatures</a>, <a href=\"#VkPhysicalDeviceTilePropertiesFeaturesQCOM\">VkPhysicalDeviceTilePropertiesFeaturesQCOM</a>, <a href=\"#VkPhysicalDeviceTimelineSemaphoreFeatures\">VkPhysicalDeviceTimelineSemaphoreFeatures</a>, <a href=\"#VkPhysicalDeviceTransformFeedbackFeaturesEXT\">VkPhysicalDeviceTransformFeedbackFeaturesEXT</a>, <a href=\"#VkPhysicalDeviceUniformBufferStandardLayoutFeatures\">VkPhysicalDeviceUniformBufferStandardLayoutFeatures</a>, <a href=\"#VkPhysicalDeviceVariablePointersFeatures\">VkPhysicalDeviceVariablePointersFeatures</a>, <a href=\"#VkPhysicalDeviceVertexAttributeDivisorFeaturesEXT\">VkPhysicalDeviceVertexAttributeDivisorFeaturesEXT</a>, <a href=\"#VkPhysicalDeviceVertexInputDynamicStateFeaturesEXT\">VkPhysicalDeviceVertexInputDynamicStateFeaturesEXT</a>, <a href=\"#VkPhysicalDeviceVulkan11Features\">VkPhysicalDeviceVulkan11Features</a>, <a href=\"#VkPhysicalDeviceVulkan12Features\">VkPhysicalDeviceVulkan12Features</a>, <a href=\"#VkPhysicalDeviceVulkan13Features\">VkPhysicalDeviceVulkan13Features</a>, <a href=\"#VkPhysicalDeviceVulkanMemoryModelFeatures\">VkPhysicalDeviceVulkanMemoryModelFeatures</a>, <a href=\"#VkPhysicalDeviceWorkgroupMemoryExplicitLayoutFeaturesKHR\">VkPhysicalDeviceWorkgroupMemoryExplicitLayoutFeaturesKHR</a>, <a href=\"#VkPhysicalDeviceYcbcr2Plane444FormatsFeaturesEXT\">VkPhysicalDeviceYcbcr2Plane444FormatsFeaturesEXT</a>, <a href=\"#VkPhysicalDeviceYcbcrImageArraysFeaturesEXT\">VkPhysicalDeviceYcbcrImageArraysFeaturesEXT</a>, or <a href=\"#VkPhysicalDeviceZeroInitializeWorkgroupMemoryFeatures\">VkPhysicalDeviceZeroInitializeWorkgroupMemoryFeatures</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceCreateInfo-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique, with the exception of structures of type <a href=\"#VkDeviceDeviceMemoryReportCreateInfoEXT\">VkDeviceDeviceMemoryReportCreateInfoEXT</a> or <a href=\"#VkDevicePrivateDataCreateInfo\">VkDevicePrivateDataCreateInfo</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceCreateInfo-flags-zerobitmask",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceCreateInfo-pQueueCreateInfos-parameter",
|
|
"text": " <code>pQueueCreateInfos</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>queueCreateInfoCount</code> valid <a href=\"#VkDeviceQueueCreateInfo\">VkDeviceQueueCreateInfo</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceCreateInfo-ppEnabledLayerNames-parameter",
|
|
"text": " If <code>enabledLayerCount</code> is not <code>0</code>, <code>ppEnabledLayerNames</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>enabledLayerCount</code> null-terminated UTF-8 strings"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceCreateInfo-ppEnabledExtensionNames-parameter",
|
|
"text": " If <code>enabledExtensionCount</code> is not <code>0</code>, <code>ppEnabledExtensionNames</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>enabledExtensionCount</code> null-terminated UTF-8 strings"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceCreateInfo-pEnabledFeatures-parameter",
|
|
"text": " If <code>pEnabledFeatures</code> is not <code>NULL</code>, <code>pEnabledFeatures</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkPhysicalDeviceFeatures\">VkPhysicalDeviceFeatures</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceCreateInfo-queueCreateInfoCount-arraylength",
|
|
"text": " <code>queueCreateInfoCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkDeviceGroupDeviceCreateInfo": {
|
|
"(VK_VERSION_1_1,VK_KHR_device_group_creation)": [
|
|
{
|
|
"vuid": "VUID-VkDeviceGroupDeviceCreateInfo-pPhysicalDevices-00375",
|
|
"text": " Each element of <code>pPhysicalDevices</code> <strong class=\"purple\">must</strong> be unique"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceGroupDeviceCreateInfo-pPhysicalDevices-00376",
|
|
"text": " All elements of <code>pPhysicalDevices</code> <strong class=\"purple\">must</strong> be in the same device group as enumerated by <a href=\"#vkEnumeratePhysicalDeviceGroups\">vkEnumeratePhysicalDeviceGroups</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceGroupDeviceCreateInfo-physicalDeviceCount-00377",
|
|
"text": " If <code>physicalDeviceCount</code> is not <code>0</code>, the <code>physicalDevice</code> parameter of <a href=\"#vkCreateDevice\">vkCreateDevice</a> <strong class=\"purple\">must</strong> be an element of <code>pPhysicalDevices</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceGroupDeviceCreateInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_DEVICE_GROUP_DEVICE_CREATE_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceGroupDeviceCreateInfo-pPhysicalDevices-parameter",
|
|
"text": " If <code>physicalDeviceCount</code> is not <code>0</code>, <code>pPhysicalDevices</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>physicalDeviceCount</code> valid <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handles"
|
|
}
|
|
]
|
|
},
|
|
"VkDeviceMemoryOverallocationCreateInfoAMD": {
|
|
"(VK_AMD_memory_overallocation_behavior)": [
|
|
{
|
|
"vuid": "VUID-VkDeviceMemoryOverallocationCreateInfoAMD-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_DEVICE_MEMORY_OVERALLOCATION_CREATE_INFO_AMD</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceMemoryOverallocationCreateInfoAMD-overallocationBehavior-parameter",
|
|
"text": " <code>overallocationBehavior</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkMemoryOverallocationBehaviorAMD\">VkMemoryOverallocationBehaviorAMD</a> value"
|
|
}
|
|
]
|
|
},
|
|
"VkDeviceDiagnosticsConfigCreateInfoNV": {
|
|
"(VK_NV_device_diagnostics_config)": [
|
|
{
|
|
"vuid": "VUID-VkDeviceDiagnosticsConfigCreateInfoNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_DEVICE_DIAGNOSTICS_CONFIG_CREATE_INFO_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceDiagnosticsConfigCreateInfoNV-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkDeviceDiagnosticsConfigFlagBitsNV\">VkDeviceDiagnosticsConfigFlagBitsNV</a> values"
|
|
}
|
|
]
|
|
},
|
|
"VkDeviceDeviceMemoryReportCreateInfoEXT": {
|
|
"(VK_EXT_device_memory_report)": [
|
|
{
|
|
"vuid": "VUID-VkDeviceDeviceMemoryReportCreateInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_DEVICE_DEVICE_MEMORY_REPORT_CREATE_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceDeviceMemoryReportCreateInfoEXT-flags-zerobitmask",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceDeviceMemoryReportCreateInfoEXT-pfnUserCallback-parameter",
|
|
"text": " <code>pfnUserCallback</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#PFN_vkDeviceMemoryReportCallbackEXT\">PFN_vkDeviceMemoryReportCallbackEXT</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceDeviceMemoryReportCreateInfoEXT-pUserData-parameter",
|
|
"text": " <code>pUserData</code> <strong class=\"purple\">must</strong> be a pointer value"
|
|
}
|
|
]
|
|
},
|
|
"VkDeviceMemoryReportCallbackDataEXT": {
|
|
"(VK_EXT_device_memory_report)": [
|
|
{
|
|
"vuid": "VUID-VkDeviceMemoryReportCallbackDataEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_DEVICE_MEMORY_REPORT_CALLBACK_DATA_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceMemoryReportCallbackDataEXT-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkDevicePrivateDataCreateInfo": {
|
|
"(VK_VERSION_1_3,VK_EXT_private_data)": [
|
|
{
|
|
"vuid": "VUID-VkDevicePrivateDataCreateInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_DEVICE_PRIVATE_DATA_CREATE_INFO</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkDestroyDevice": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkDestroyDevice-device-00378",
|
|
"text": " All child objects created on <code>device</code> <strong class=\"purple\">must</strong> have been destroyed prior to destroying <code>device</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyDevice-device-00379",
|
|
"text": " If <code>VkAllocationCallbacks</code> were provided when <code>device</code> was created, a compatible set of callbacks <strong class=\"purple\">must</strong> be provided here"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyDevice-device-00380",
|
|
"text": " If no <code>VkAllocationCallbacks</code> were provided when <code>device</code> was created, <code>pAllocator</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyDevice-device-parameter",
|
|
"text": " If <code>device</code> is not <code>NULL</code>, <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyDevice-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkDeviceQueueCreateInfo": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkDeviceQueueCreateInfo-queueFamilyIndex-00381",
|
|
"text": " <code>queueFamilyIndex</code> <strong class=\"purple\">must</strong> be less than <code>pQueueFamilyPropertyCount</code> returned by <code>vkGetPhysicalDeviceQueueFamilyProperties</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceQueueCreateInfo-queueCount-00382",
|
|
"text": " <code>queueCount</code> <strong class=\"purple\">must</strong> be less than or equal to the <code>queueCount</code> member of the <code>VkQueueFamilyProperties</code> structure, as returned by <code>vkGetPhysicalDeviceQueueFamilyProperties</code> in the <code>pQueueFamilyProperties</code>[queueFamilyIndex]"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceQueueCreateInfo-pQueuePriorities-00383",
|
|
"text": " Each element of <code>pQueuePriorities</code> <strong class=\"purple\">must</strong> be between <code>0.0</code> and <code>1.0</code> inclusive"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceQueueCreateInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_DEVICE_QUEUE_CREATE_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceQueueCreateInfo-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkDeviceQueueGlobalPriorityCreateInfoKHR\">VkDeviceQueueGlobalPriorityCreateInfoKHR</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceQueueCreateInfo-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceQueueCreateInfo-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkDeviceQueueCreateFlagBits\">VkDeviceQueueCreateFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceQueueCreateInfo-pQueuePriorities-parameter",
|
|
"text": " <code>pQueuePriorities</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>queueCount</code> <code>float</code> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceQueueCreateInfo-queueCount-arraylength",
|
|
"text": " <code>queueCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-VkDeviceQueueCreateInfo-flags-02861",
|
|
"text": " If the <a href=\"#features-protectedMemory\"><code>protectedMemory</code></a> feature is not enabled, the <code>VK_DEVICE_QUEUE_CREATE_PROTECTED_BIT</code> bit of <code>flags</code> <strong class=\"purple\">must</strong> not be set"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceQueueCreateInfo-flags-06449",
|
|
"text": " If <code>flags</code> includes <code>VK_DEVICE_QUEUE_CREATE_PROTECTED_BIT</code>, <code>queueFamilyIndex</code> <strong class=\"purple\">must</strong> be the index of a queue family that includes the <code>VK_QUEUE_PROTECTED_BIT</code> capability"
|
|
}
|
|
]
|
|
},
|
|
"VkDeviceQueueGlobalPriorityCreateInfoKHR": {
|
|
"(VK_EXT_global_priority,VK_KHR_global_priority)": [
|
|
{
|
|
"vuid": "VUID-VkDeviceQueueGlobalPriorityCreateInfoKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_DEVICE_QUEUE_GLOBAL_PRIORITY_CREATE_INFO_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceQueueGlobalPriorityCreateInfoKHR-globalPriority-parameter",
|
|
"text": " <code>globalPriority</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkQueueGlobalPriorityKHR\">VkQueueGlobalPriorityKHR</a> value"
|
|
}
|
|
]
|
|
},
|
|
"vkGetDeviceQueue": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkGetDeviceQueue-queueFamilyIndex-00384",
|
|
"text": " <code>queueFamilyIndex</code> <strong class=\"purple\">must</strong> be one of the queue family indices specified when <code>device</code> was created, via the <a href=\"#VkDeviceQueueCreateInfo\">VkDeviceQueueCreateInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDeviceQueue-queueIndex-00385",
|
|
"text": " <code>queueIndex</code> <strong class=\"purple\">must</strong> be less than the value of <a href=\"#VkDeviceQueueCreateInfo\">VkDeviceQueueCreateInfo</a>::<code>queueCount</code> for the queue family indicated by <code>queueFamilyIndex</code> when <code>device</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDeviceQueue-flags-01841",
|
|
"text": " <a href=\"#VkDeviceQueueCreateInfo\">VkDeviceQueueCreateInfo</a>::<code>flags</code> <strong class=\"purple\">must</strong> have been set to zero when <code>device</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDeviceQueue-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDeviceQueue-pQueue-parameter",
|
|
"text": " <code>pQueue</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkQueue\">VkQueue</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"vkGetDeviceQueue2": {
|
|
"(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-vkGetDeviceQueue2-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDeviceQueue2-pQueueInfo-parameter",
|
|
"text": " <code>pQueueInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkDeviceQueueInfo2\">VkDeviceQueueInfo2</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDeviceQueue2-pQueue-parameter",
|
|
"text": " <code>pQueue</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkQueue\">VkQueue</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkDeviceQueueInfo2": {
|
|
"(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-VkDeviceQueueInfo2-queueFamilyIndex-01842",
|
|
"text": " <code>queueFamilyIndex</code> <strong class=\"purple\">must</strong> be one of the queue family indices specified when <code>device</code> was created, via the <a href=\"#VkDeviceQueueCreateInfo\">VkDeviceQueueCreateInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceQueueInfo2-flags-06225",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be equal to <a href=\"#VkDeviceQueueCreateInfo\">VkDeviceQueueCreateInfo</a>::<code>flags</code> for a <a href=\"#VkDeviceQueueCreateInfo\">VkDeviceQueueCreateInfo</a> structure for the queue family indicated by <code>queueFamilyIndex</code> when <code>device</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceQueueInfo2-queueIndex-01843",
|
|
"text": " <code>queueIndex</code> <strong class=\"purple\">must</strong> be less than <a href=\"#VkDeviceQueueCreateInfo\">VkDeviceQueueCreateInfo</a>::<code>queueCount</code> for the corresponding queue family and flags indicated by <code>queueFamilyIndex</code> and <code>flags</code> when <code>device</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceQueueInfo2-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_DEVICE_QUEUE_INFO_2</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceQueueInfo2-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceQueueInfo2-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkDeviceQueueCreateFlagBits\">VkDeviceQueueCreateFlagBits</a> values"
|
|
}
|
|
]
|
|
},
|
|
"vkCreateCommandPool": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCreateCommandPool-queueFamilyIndex-01937",
|
|
"text": " <code>pCreateInfo->queueFamilyIndex</code> <strong class=\"purple\">must</strong> be the index of a queue family available in the logical device <code>device</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateCommandPool-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateCommandPool-pCreateInfo-parameter",
|
|
"text": " <code>pCreateInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkCommandPoolCreateInfo\">VkCommandPoolCreateInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateCommandPool-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateCommandPool-pCommandPool-parameter",
|
|
"text": " <code>pCommandPool</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkCommandPool\">VkCommandPool</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkCommandPoolCreateInfo": {
|
|
"(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-VkCommandPoolCreateInfo-flags-02860",
|
|
"text": " If the <a href=\"#features-protectedMemory\"><code>protectedMemory</code></a> feature is not enabled, the <code>VK_COMMAND_POOL_CREATE_PROTECTED_BIT</code> bit of <code>flags</code> <strong class=\"purple\">must</strong> not be set"
|
|
}
|
|
],
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkCommandPoolCreateInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_COMMAND_POOL_CREATE_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCommandPoolCreateInfo-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCommandPoolCreateInfo-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkCommandPoolCreateFlagBits\">VkCommandPoolCreateFlagBits</a> values"
|
|
}
|
|
]
|
|
},
|
|
"vkTrimCommandPool": {
|
|
"(VK_VERSION_1_1,VK_KHR_maintenance1)": [
|
|
{
|
|
"vuid": "VUID-vkTrimCommandPool-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkTrimCommandPool-commandPool-parameter",
|
|
"text": " <code>commandPool</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandPool\">VkCommandPool</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkTrimCommandPool-flags-zerobitmask",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkTrimCommandPool-commandPool-parent",
|
|
"text": " <code>commandPool</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkResetCommandPool": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkResetCommandPool-commandPool-00040",
|
|
"text": " All <code>VkCommandBuffer</code> objects allocated from <code>commandPool</code> <strong class=\"purple\">must</strong> not be in the <a href=\"#commandbuffers-lifecycle\">pending state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkResetCommandPool-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkResetCommandPool-commandPool-parameter",
|
|
"text": " <code>commandPool</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandPool\">VkCommandPool</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkResetCommandPool-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkCommandPoolResetFlagBits\">VkCommandPoolResetFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkResetCommandPool-commandPool-parent",
|
|
"text": " <code>commandPool</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkDestroyCommandPool": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkDestroyCommandPool-commandPool-00041",
|
|
"text": " All <code>VkCommandBuffer</code> objects allocated from <code>commandPool</code> <strong class=\"purple\">must</strong> not be in the <a href=\"#commandbuffers-lifecycle\">pending state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyCommandPool-commandPool-00042",
|
|
"text": " If <code>VkAllocationCallbacks</code> were provided when <code>commandPool</code> was created, a compatible set of callbacks <strong class=\"purple\">must</strong> be provided here"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyCommandPool-commandPool-00043",
|
|
"text": " If no <code>VkAllocationCallbacks</code> were provided when <code>commandPool</code> was created, <code>pAllocator</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyCommandPool-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyCommandPool-commandPool-parameter",
|
|
"text": " If <code>commandPool</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>commandPool</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandPool\">VkCommandPool</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyCommandPool-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyCommandPool-commandPool-parent",
|
|
"text": " If <code>commandPool</code> is a valid handle, it <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkAllocateCommandBuffers": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkAllocateCommandBuffers-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkAllocateCommandBuffers-pAllocateInfo-parameter",
|
|
"text": " <code>pAllocateInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkCommandBufferAllocateInfo\">VkCommandBufferAllocateInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkAllocateCommandBuffers-pCommandBuffers-parameter",
|
|
"text": " <code>pCommandBuffers</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>pAllocateInfo->commandBufferCount</code> <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handles"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkAllocateCommandBuffers-pAllocateInfo::commandBufferCount-arraylength",
|
|
"text": " <code>pAllocateInfo->commandBufferCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkCommandBufferAllocateInfo": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkCommandBufferAllocateInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_COMMAND_BUFFER_ALLOCATE_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCommandBufferAllocateInfo-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCommandBufferAllocateInfo-commandPool-parameter",
|
|
"text": " <code>commandPool</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandPool\">VkCommandPool</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCommandBufferAllocateInfo-level-parameter",
|
|
"text": " <code>level</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBufferLevel\">VkCommandBufferLevel</a> value"
|
|
}
|
|
]
|
|
},
|
|
"vkResetCommandBuffer": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkResetCommandBuffer-commandBuffer-00045",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> not be in the <a href=\"#commandbuffers-lifecycle\">pending state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkResetCommandBuffer-commandBuffer-00046",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> have been allocated from a pool that was created with the <code>VK_COMMAND_POOL_CREATE_RESET_COMMAND_BUFFER_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkResetCommandBuffer-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkResetCommandBuffer-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkCommandBufferResetFlagBits\">VkCommandBufferResetFlagBits</a> values"
|
|
}
|
|
]
|
|
},
|
|
"vkFreeCommandBuffers": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkFreeCommandBuffers-pCommandBuffers-00047",
|
|
"text": " All elements of <code>pCommandBuffers</code> <strong class=\"purple\">must</strong> not be in the <a href=\"#commandbuffers-lifecycle\">pending state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkFreeCommandBuffers-pCommandBuffers-00048",
|
|
"text": " <code>pCommandBuffers</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>commandBufferCount</code> <code>VkCommandBuffer</code> handles, each element of which <strong class=\"purple\">must</strong> either be a valid handle or <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkFreeCommandBuffers-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkFreeCommandBuffers-commandPool-parameter",
|
|
"text": " <code>commandPool</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandPool\">VkCommandPool</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkFreeCommandBuffers-commandBufferCount-arraylength",
|
|
"text": " <code>commandBufferCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkFreeCommandBuffers-commandPool-parent",
|
|
"text": " <code>commandPool</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkFreeCommandBuffers-pCommandBuffers-parent",
|
|
"text": " Each element of <code>pCommandBuffers</code> that is a valid handle <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>commandPool</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkBeginCommandBuffer": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkBeginCommandBuffer-commandBuffer-00049",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> not be in the <a href=\"#commandbuffers-lifecycle\">recording or pending state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBeginCommandBuffer-commandBuffer-00050",
|
|
"text": " If <code>commandBuffer</code> was allocated from a <a href=\"#VkCommandPool\">VkCommandPool</a> which did not have the <code>VK_COMMAND_POOL_CREATE_RESET_COMMAND_BUFFER_BIT</code> flag set, <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">initial state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBeginCommandBuffer-commandBuffer-00051",
|
|
"text": " If <code>commandBuffer</code> is a secondary command buffer, the <code>pInheritanceInfo</code> member of <code>pBeginInfo</code> <strong class=\"purple\">must</strong> be a valid <code>VkCommandBufferInheritanceInfo</code> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBeginCommandBuffer-commandBuffer-00052",
|
|
"text": " If <code>commandBuffer</code> is a secondary command buffer and either the <code>occlusionQueryEnable</code> member of the <code>pInheritanceInfo</code> member of <code>pBeginInfo</code> is <code>VK_FALSE</code>, or the <a href=\"#features-occlusionQueryPrecise\"><code>occlusionQueryPrecise</code></a> feature is not enabled, then <code>pBeginInfo->pInheritanceInfo->queryFlags</code> <strong class=\"purple\">must</strong> not contain <code>VK_QUERY_CONTROL_PRECISE_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBeginCommandBuffer-commandBuffer-02840",
|
|
"text": " If <code>commandBuffer</code> is a primary command buffer, then <code>pBeginInfo->flags</code> <strong class=\"purple\">must</strong> not set both the <code>VK_COMMAND_BUFFER_USAGE_ONE_TIME_SUBMIT_BIT</code> and the <code>VK_COMMAND_BUFFER_USAGE_SIMULTANEOUS_USE_BIT</code> flags"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBeginCommandBuffer-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBeginCommandBuffer-pBeginInfo-parameter",
|
|
"text": " <code>pBeginInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkCommandBufferBeginInfo\">VkCommandBufferBeginInfo</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkCommandBufferBeginInfo": {
|
|
"!(VK_VERSION_1_3,VK_KHR_dynamic_rendering)": [
|
|
{
|
|
"vuid": "VUID-VkCommandBufferBeginInfo-flags-00053",
|
|
"text": " If <code>flags</code> contains <code>VK_COMMAND_BUFFER_USAGE_RENDER_PASS_CONTINUE_BIT</code>, the <code>renderPass</code> member of <code>pInheritanceInfo</code> <strong class=\"purple\">must</strong> be a valid <code>VkRenderPass</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCommandBufferBeginInfo-flags-00054",
|
|
"text": " If <code>flags</code> contains <code>VK_COMMAND_BUFFER_USAGE_RENDER_PASS_CONTINUE_BIT</code>, the <code>subpass</code> member of <code>pInheritanceInfo</code> <strong class=\"purple\">must</strong> be a valid subpass index within the <code>renderPass</code> member of <code>pInheritanceInfo</code>"
|
|
}
|
|
],
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkCommandBufferBeginInfo-flags-00055",
|
|
"text": " If <code>flags</code> contains <code>VK_COMMAND_BUFFER_USAGE_RENDER_PASS_CONTINUE_BIT</code>, the <code>framebuffer</code> member of <code>pInheritanceInfo</code> <strong class=\"purple\">must</strong> be either <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, or a valid <code>VkFramebuffer</code> that is compatible with the <code>renderPass</code> member of <code>pInheritanceInfo</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCommandBufferBeginInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_COMMAND_BUFFER_BEGIN_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCommandBufferBeginInfo-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkDeviceGroupCommandBufferBeginInfo\">VkDeviceGroupCommandBufferBeginInfo</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCommandBufferBeginInfo-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCommandBufferBeginInfo-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkCommandBufferUsageFlagBits\">VkCommandBufferUsageFlagBits</a> values"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)": [
|
|
{
|
|
"vuid": "VUID-VkCommandBufferBeginInfo-flags-06000",
|
|
"text": " If <code>flags</code> contains <code>VK_COMMAND_BUFFER_USAGE_RENDER_PASS_CONTINUE_BIT</code> and the <code>renderPass</code> member of <code>pInheritanceInfo</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>renderPass</code> <strong class=\"purple\">must</strong> be a valid <code>VkRenderPass</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCommandBufferBeginInfo-flags-06001",
|
|
"text": " If <code>flags</code> contains <code>VK_COMMAND_BUFFER_USAGE_RENDER_PASS_CONTINUE_BIT</code> and the <code>renderPass</code> member of <code>pInheritanceInfo</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the <code>subpass</code> member of <code>pInheritanceInfo</code> <strong class=\"purple\">must</strong> be a valid subpass index within the <code>renderPass</code> member of <code>pInheritanceInfo</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCommandBufferBeginInfo-flags-06002",
|
|
"text": " If <code>flags</code> contains <code>VK_COMMAND_BUFFER_USAGE_RENDER_PASS_CONTINUE_BIT</code> and the <code>renderPass</code> member of <code>pInheritanceInfo</code> is <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the <code>pNext</code> chain of <code>pInheritanceInfo</code> <strong class=\"purple\">must</strong> include a <a href=\"#VkCommandBufferInheritanceRenderingInfo\">VkCommandBufferInheritanceRenderingInfo</a> structure"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_AMD_mixed_attachment_samples,VK_NV_framebuffer_mixed_samples)": [
|
|
{
|
|
"vuid": "VUID-VkCommandBufferBeginInfo-flags-06003",
|
|
"text": " If <code>flags</code> contains <code>VK_COMMAND_BUFFER_USAGE_RENDER_PASS_CONTINUE_BIT</code>, the <code>renderPass</code> member of <code>pInheritanceInfo</code> is <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>pNext</code> chain of <code>pInheritanceInfo</code> includes a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, the <code>colorAttachmentCount</code> member of that structure <strong class=\"purple\">must</strong> be equal to the value of <a href=\"#VkCommandBufferInheritanceRenderingInfo\">VkCommandBufferInheritanceRenderingInfo</a>::<code>colorAttachmentCount</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkCommandBufferInheritanceInfo": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkCommandBufferInheritanceInfo-occlusionQueryEnable-00056",
|
|
"text": " If the <a href=\"#features-inheritedQueries\"><code>inheritedQueries</code></a> feature is not enabled, <code>occlusionQueryEnable</code> <strong class=\"purple\">must</strong> be <code>VK_FALSE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCommandBufferInheritanceInfo-queryFlags-00057",
|
|
"text": " If the <a href=\"#features-inheritedQueries\"><code>inheritedQueries</code></a> feature is enabled, <code>queryFlags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkQueryControlFlagBits\">VkQueryControlFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCommandBufferInheritanceInfo-queryFlags-02788",
|
|
"text": " If the <a href=\"#features-inheritedQueries\"><code>inheritedQueries</code></a> feature is not enabled, <code>queryFlags</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCommandBufferInheritanceInfo-pipelineStatistics-02789",
|
|
"text": " If the <a href=\"#features-pipelineStatisticsQuery\"><code>pipelineStatisticsQuery</code></a> feature is enabled, <code>pipelineStatistics</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkQueryPipelineStatisticFlagBits\">VkQueryPipelineStatisticFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCommandBufferInheritanceInfo-pipelineStatistics-00058",
|
|
"text": " If the <a href=\"#features-pipelineStatisticsQuery\"><code>pipelineStatisticsQuery</code></a> feature is not enabled, <code>pipelineStatistics</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCommandBufferInheritanceInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_COMMAND_BUFFER_INHERITANCE_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCommandBufferInheritanceInfo-pNext-pNext",
|
|
"text": " Each <code>pNext</code> member of any structure (including this one) in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be either <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a>, <a href=\"#VkCommandBufferInheritanceConditionalRenderingInfoEXT\">VkCommandBufferInheritanceConditionalRenderingInfoEXT</a>, <a href=\"#VkCommandBufferInheritanceRenderPassTransformInfoQCOM\">VkCommandBufferInheritanceRenderPassTransformInfoQCOM</a>, <a href=\"#VkCommandBufferInheritanceRenderingInfo\">VkCommandBufferInheritanceRenderingInfo</a>, <a href=\"#VkCommandBufferInheritanceViewportScissorInfoNV\">VkCommandBufferInheritanceViewportScissorInfoNV</a>, or <a href=\"#VkMultiviewPerViewAttributesInfoNVX\">VkMultiviewPerViewAttributesInfoNVX</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCommandBufferInheritanceInfo-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCommandBufferInheritanceInfo-commonparent",
|
|
"text": " Both of <code>framebuffer</code>, and <code>renderPass</code> that are valid handles of non-ignored parameters <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
]
|
|
},
|
|
"VkCommandBufferInheritanceConditionalRenderingInfoEXT": {
|
|
"(VK_EXT_conditional_rendering)": [
|
|
{
|
|
"vuid": "VUID-VkCommandBufferInheritanceConditionalRenderingInfoEXT-conditionalRenderingEnable-01977",
|
|
"text": " If the <a href=\"#features-inheritedConditionalRendering\"><code>inheritedConditionalRendering</code></a> feature is not enabled, <code>conditionalRenderingEnable</code> <strong class=\"purple\">must</strong> be <code>VK_FALSE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCommandBufferInheritanceConditionalRenderingInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_COMMAND_BUFFER_INHERITANCE_CONDITIONAL_RENDERING_INFO_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkCommandBufferInheritanceRenderPassTransformInfoQCOM": {
|
|
"(VK_QCOM_render_pass_transform)": [
|
|
{
|
|
"vuid": "VUID-VkCommandBufferInheritanceRenderPassTransformInfoQCOM-transform-02864",
|
|
"text": " <code>transform</code> <strong class=\"purple\">must</strong> be <code>VK_SURFACE_TRANSFORM_IDENTITY_BIT_KHR</code>, <code>VK_SURFACE_TRANSFORM_ROTATE_90_BIT_KHR</code>, <code>VK_SURFACE_TRANSFORM_ROTATE_180_BIT_KHR</code>, or <code>VK_SURFACE_TRANSFORM_ROTATE_270_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCommandBufferInheritanceRenderPassTransformInfoQCOM-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_COMMAND_BUFFER_INHERITANCE_RENDER_PASS_TRANSFORM_INFO_QCOM</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkCommandBufferInheritanceViewportScissorInfoNV": {
|
|
"(VK_NV_inherited_viewport_scissor)": [
|
|
{
|
|
"vuid": "VUID-VkCommandBufferInheritanceViewportScissorInfoNV-viewportScissor2D-04782",
|
|
"text": " If the <a href=\"#features-inheritedViewportScissor2D\"><code>inheritedViewportScissor2D</code></a> feature is not enabled, <code>viewportScissor2D</code> <strong class=\"purple\">must</strong> be <code>VK_FALSE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCommandBufferInheritanceViewportScissorInfoNV-viewportScissor2D-04783",
|
|
"text": " If the <a href=\"#features-multiViewport\"><code>multiViewport</code></a> feature is not enabled and <code>viewportScissor2D</code> is <code>VK_TRUE</code>, then <code>viewportDepthCount</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCommandBufferInheritanceViewportScissorInfoNV-viewportScissor2D-04784",
|
|
"text": " If <code>viewportScissor2D</code> is <code>VK_TRUE</code>, then <code>viewportDepthCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCommandBufferInheritanceViewportScissorInfoNV-viewportScissor2D-04785",
|
|
"text": " If <code>viewportScissor2D</code> is <code>VK_TRUE</code>, then <code>pViewportDepths</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>viewportDepthCount</code> valid <code>VkViewport</code> structures, except any requirements on <code>x</code>, <code>y</code>, <code>width</code>, and <code>height</code> do not apply"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCommandBufferInheritanceViewportScissorInfoNV-viewportScissor2D-04786",
|
|
"text": " If <code>viewportScissor2D</code> is <code>VK_TRUE</code>, then the command buffer <strong class=\"purple\">must</strong> be recorded with the <code>VK_COMMAND_BUFFER_USAGE_RENDER_PASS_CONTINUE_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCommandBufferInheritanceViewportScissorInfoNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_COMMAND_BUFFER_INHERITANCE_VIEWPORT_SCISSOR_INFO_NV</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkCommandBufferInheritanceRenderingInfo": {
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)": [
|
|
{
|
|
"vuid": "VUID-VkCommandBufferInheritanceRenderingInfo-colorAttachmentCount-06004",
|
|
"text": " If <code>colorAttachmentCount</code> is not <code>0</code>, <code>rasterizationSamples</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSampleCountFlagBits\">VkSampleCountFlagBits</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCommandBufferInheritanceRenderingInfo-variableMultisampleRate-06005",
|
|
"text": " If the <a href=\"#features-variableMultisampleRate\"><code>variableMultisampleRate</code></a> feature is not enabled, <code>rasterizationSamples</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSampleCountFlagBits\">VkSampleCountFlagBits</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCommandBufferInheritanceRenderingInfo-pColorAttachmentFormats-06006",
|
|
"text": " If any element of <code>pColorAttachmentFormats</code> is not <code>VK_FORMAT_UNDEFINED</code>, it <strong class=\"purple\">must</strong> be a format with <a href=\"#potential-format-features\">potential format features</a> that include <code>VK_FORMAT_FEATURE_COLOR_ATTACHMENT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCommandBufferInheritanceRenderingInfo-depthAttachmentFormat-06540",
|
|
"text": " If <code>depthAttachmentFormat</code> is not <code>VK_FORMAT_UNDEFINED</code>, it <strong class=\"purple\">must</strong> be a format that includes a depth aspect"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCommandBufferInheritanceRenderingInfo-depthAttachmentFormat-06007",
|
|
"text": " If <code>depthAttachmentFormat</code> is not <code>VK_FORMAT_UNDEFINED</code>, it <strong class=\"purple\">must</strong> be a format with <a href=\"#potential-format-features\">potential format features</a> that include <code>VK_FORMAT_FEATURE_DEPTH_STENCIL_ATTACHMENT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCommandBufferInheritanceRenderingInfo-stencilAttachmentFormat-06541",
|
|
"text": " If <code>stencilAttachmentFormat</code> is not <code>VK_FORMAT_UNDEFINED</code>, it <strong class=\"purple\">must</strong> be a format that includes a stencil aspect"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCommandBufferInheritanceRenderingInfo-stencilAttachmentFormat-06199",
|
|
"text": " If <code>stencilAttachmentFormat</code> is not <code>VK_FORMAT_UNDEFINED</code>, it <strong class=\"purple\">must</strong> be a format with <a href=\"#potential-format-features\">potential format features</a> that include <code>VK_FORMAT_FEATURE_DEPTH_STENCIL_ATTACHMENT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCommandBufferInheritanceRenderingInfo-depthAttachmentFormat-06200",
|
|
"text": " If <code>depthAttachmentFormat</code> is not <code>VK_FORMAT_UNDEFINED</code> and <code>stencilAttachmentFormat</code> is not <code>VK_FORMAT_UNDEFINED</code>, <code>depthAttachmentFormat</code> <strong class=\"purple\">must</strong> equal <code>stencilAttachmentFormat</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCommandBufferInheritanceRenderingInfo-multiview-06008",
|
|
"text": " If the <a href=\"#features-multiview\"><code>multiview</code></a> feature is not enabled, <code>viewMask</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCommandBufferInheritanceRenderingInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_COMMAND_BUFFER_INHERITANCE_RENDERING_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCommandBufferInheritanceRenderingInfo-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkRenderingFlagBits\">VkRenderingFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCommandBufferInheritanceRenderingInfo-pColorAttachmentFormats-parameter",
|
|
"text": " If <code>colorAttachmentCount</code> is not <code>0</code>, <code>pColorAttachmentFormats</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>colorAttachmentCount</code> valid <a href=\"#VkFormat\">VkFormat</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCommandBufferInheritanceRenderingInfo-depthAttachmentFormat-parameter",
|
|
"text": " <code>depthAttachmentFormat</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkFormat\">VkFormat</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCommandBufferInheritanceRenderingInfo-stencilAttachmentFormat-parameter",
|
|
"text": " <code>stencilAttachmentFormat</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkFormat\">VkFormat</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCommandBufferInheritanceRenderingInfo-rasterizationSamples-parameter",
|
|
"text": " If <code>rasterizationSamples</code> is not <code>0</code>, <code>rasterizationSamples</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSampleCountFlagBits\">VkSampleCountFlagBits</a> value"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_NV_linear_color_attachment)": [
|
|
{
|
|
"vuid": "VUID-VkCommandBufferInheritanceRenderingInfoKHR-pColorAttachmentFormats-06492",
|
|
"text": " When rendering to a <a href=\"#glossary\">Linear Color attachment</a>, if any element of <code>pColorAttachmentFormats</code> is not <code>VK_FORMAT_UNDEFINED</code>, it <strong class=\"purple\">must</strong> be a format with <a href=\"#potential-format-features\">potential format features</a> that include <code>VK_FORMAT_FEATURE_2_LINEAR_COLOR_ATTACHMENT_BIT_NV</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_VERSION_1_1,VK_KHR_multiview)": [
|
|
{
|
|
"vuid": "VUID-VkCommandBufferInheritanceRenderingInfo-viewMask-06009",
|
|
"text": " The index of the most significant bit in <code>viewMask</code> <strong class=\"purple\">must</strong> be less than <a href=\"#limits-maxMultiviewViewCount\"><code>maxMultiviewViewCount</code></a>"
|
|
}
|
|
]
|
|
},
|
|
"VkAttachmentSampleCountInfoAMD": {
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_AMD_mixed_attachment_samples,VK_NV_framebuffer_mixed_samples)": [
|
|
{
|
|
"vuid": "VUID-VkAttachmentSampleCountInfoAMD-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_ATTACHMENT_SAMPLE_COUNT_INFO_AMD</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkEndCommandBuffer": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkEndCommandBuffer-commandBuffer-00059",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkEndCommandBuffer-commandBuffer-00060",
|
|
"text": " If <code>commandBuffer</code> is a primary command buffer, there <strong class=\"purple\">must</strong> not be an active render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkEndCommandBuffer-commandBuffer-00061",
|
|
"text": " All queries made <a href=\"#queries-operation-active\">active</a> during the recording of <code>commandBuffer</code> <strong class=\"purple\">must</strong> have been made inactive"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkEndCommandBuffer-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
}
|
|
],
|
|
"(VK_EXT_conditional_rendering)": [
|
|
{
|
|
"vuid": "VUID-vkEndCommandBuffer-None-01978",
|
|
"text": " Conditional rendering <strong class=\"purple\">must</strong> not be <a href=\"#active-conditional-rendering\">active</a>"
|
|
}
|
|
],
|
|
"(VK_KHR_video_queue)": [
|
|
{
|
|
"vuid": "VUID-vkEndCommandBuffer-None-06991",
|
|
"text": " There <strong class=\"purple\">must</strong> be no video session object bound"
|
|
}
|
|
],
|
|
"(VK_EXT_debug_utils)": [
|
|
{
|
|
"vuid": "VUID-vkEndCommandBuffer-commandBuffer-01815",
|
|
"text": " If <code>commandBuffer</code> is a secondary command buffer, there <strong class=\"purple\">must</strong> not be an outstanding <a href=\"#vkCmdBeginDebugUtilsLabelEXT\">vkCmdBeginDebugUtilsLabelEXT</a> command recorded to <code>commandBuffer</code> that has not previously been ended by a call to <a href=\"#vkCmdEndDebugUtilsLabelEXT\">vkCmdEndDebugUtilsLabelEXT</a>"
|
|
}
|
|
],
|
|
"(VK_EXT_debug_marker)": [
|
|
{
|
|
"vuid": "VUID-vkEndCommandBuffer-commandBuffer-00062",
|
|
"text": " If <code>commandBuffer</code> is a secondary command buffer, there <strong class=\"purple\">must</strong> not be an outstanding <a href=\"#vkCmdDebugMarkerBeginEXT\">vkCmdDebugMarkerBeginEXT</a> command recorded to <code>commandBuffer</code> that has not previously been ended by a call to <a href=\"#vkCmdDebugMarkerEndEXT\">vkCmdDebugMarkerEndEXT</a>"
|
|
}
|
|
]
|
|
},
|
|
"vkQueueSubmit2": {
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)": [
|
|
{
|
|
"vuid": "VUID-vkQueueSubmit2-fence-04894",
|
|
"text": " If <code>fence</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>fence</code> <strong class=\"purple\">must</strong> be unsignaled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkQueueSubmit2-fence-04895",
|
|
"text": " If <code>fence</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>fence</code> <strong class=\"purple\">must</strong> not be associated with any other queue command that has not yet completed execution on that queue"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkQueueSubmit2-synchronization2-03866",
|
|
"text": " The <a href=\"#features-synchronization2\"><code>synchronization2</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkQueueSubmit2-commandBuffer-03867",
|
|
"text": " If a command recorded into the <code>commandBuffer</code> member of any element of the <code>pCommandBufferInfos</code> member of any element of <code>pSubmits</code> referenced an <a href=\"#VkEvent\">VkEvent</a>, that event <strong class=\"purple\">must</strong> not be referenced by a command that has been submitted to another queue and is still in the <em>pending state</em>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkQueueSubmit2-semaphore-03868",
|
|
"text": " The <code>semaphore</code> member of any binary semaphore element of the <code>pSignalSemaphoreInfos</code> member of any element of <code>pSubmits</code> <strong class=\"purple\">must</strong> be unsignaled when the semaphore signal operation it defines is executed on the device"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkQueueSubmit2-stageMask-03869",
|
|
"text": " The <code>stageMask</code> member of any element of the <code>pSignalSemaphoreInfos</code> member of any element of <code>pSubmits</code> <strong class=\"purple\">must</strong> only include pipeline stages that are supported by the queue family which <code>queue</code> belongs to"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkQueueSubmit2-stageMask-03870",
|
|
"text": " The <code>stageMask</code> member of any element of the <code>pWaitSemaphoreInfos</code> member of any element of <code>pSubmits</code> <strong class=\"purple\">must</strong> only include pipeline stages that are supported by the queue family which <code>queue</code> belongs to"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkQueueSubmit2-semaphore-03871",
|
|
"text": " When a semaphore wait operation for a binary semaphore is executed, as defined by the <code>semaphore</code> member of any element of the <code>pWaitSemaphoreInfos</code> member of any element of <code>pSubmits</code>, there <strong class=\"purple\">must</strong> be no other queues waiting on the same semaphore"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkQueueSubmit2-semaphore-03872",
|
|
"text": " The <code>semaphore</code> member of any element of the <code>pWaitSemaphoreInfos</code> member of any element of <code>pSubmits</code> <strong class=\"purple\">must</strong> be semaphores that are signaled, or have <a href=\"#synchronization-semaphores-signaling\">semaphore signal operations</a> previously submitted for execution"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkQueueSubmit2-commandBuffer-03874",
|
|
"text": " The <code>commandBuffer</code> member of any element of the <code>pCommandBufferInfos</code> member of any element of <code>pSubmits</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">pending or executable state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkQueueSubmit2-commandBuffer-03875",
|
|
"text": " If a command recorded into the <code>commandBuffer</code> member of any element of the <code>pCommandBufferInfos</code> member of any element of <code>pSubmits</code> was not recorded with the <code>VK_COMMAND_BUFFER_USAGE_SIMULTANEOUS_USE_BIT</code>, it <strong class=\"purple\">must</strong> not be in the <a href=\"#commandbuffers-lifecycle\">pending state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkQueueSubmit2-commandBuffer-03876",
|
|
"text": " Any <a href=\"#commandbuffers-secondary\">secondary command buffers recorded</a> into the <code>commandBuffer</code> member of any element of the <code>pCommandBufferInfos</code> member of any element of <code>pSubmits</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">pending or executable state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkQueueSubmit2-commandBuffer-03877",
|
|
"text": " If any <a href=\"#commandbuffers-secondary\">secondary command buffers recorded</a> into the <code>commandBuffer</code> member of any element of the <code>pCommandBufferInfos</code> member of any element of <code>pSubmits</code> was not recorded with the <code>VK_COMMAND_BUFFER_USAGE_SIMULTANEOUS_USE_BIT</code>, it <strong class=\"purple\">must</strong> not be in the <a href=\"#commandbuffers-lifecycle\">pending state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkQueueSubmit2-commandBuffer-03878",
|
|
"text": " The <code>commandBuffer</code> member of any element of the <code>pCommandBufferInfos</code> member of any element of <code>pSubmits</code> <strong class=\"purple\">must</strong> have been allocated from a <code>VkCommandPool</code> that was created for the same queue family <code>queue</code> belongs to"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkQueueSubmit2-commandBuffer-03879",
|
|
"text": " If a command recorded into the <code>commandBuffer</code> member of any element of the <code>pCommandBufferInfos</code> member of any element of <code>pSubmits</code> includes a <a href=\"#synchronization-queue-transfers-acquire\">Queue Family Transfer Acquire Operation</a>, there <strong class=\"purple\">must</strong> exist a previously submitted <a href=\"#synchronization-queue-transfers-release\">Queue Family Transfer Release Operation</a> on a queue in the queue family identified by the acquire operation, with parameters matching the acquire operation as defined in the definition of such <a href=\"#synchronization-queue-transfers-acquire\">acquire operations</a>, and which happens before the acquire operation"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkQueueSubmit2-queue-parameter",
|
|
"text": " <code>queue</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkQueue\">VkQueue</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkQueueSubmit2-pSubmits-parameter",
|
|
"text": " If <code>submitCount</code> is not <code>0</code>, <code>pSubmits</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>submitCount</code> valid <a href=\"#VkSubmitInfo2\">VkSubmitInfo2</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkQueueSubmit2-fence-parameter",
|
|
"text": " If <code>fence</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>fence</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkFence\">VkFence</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkQueueSubmit2-commonparent",
|
|
"text": " Both of <code>fence</code>, and <code>queue</code> that are valid handles of non-ignored parameters <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_KHR_timeline_semaphore)": [
|
|
{
|
|
"vuid": "VUID-vkQueueSubmit2-semaphore-03873",
|
|
"text": " Any <code>semaphore</code> member of any element of the <code>pWaitSemaphoreInfos</code> member of any element of <code>pSubmits</code> that was created with a <a href=\"#VkSemaphoreTypeKHR\">VkSemaphoreTypeKHR</a> of <code>VK_SEMAPHORE_TYPE_BINARY_KHR</code> <strong class=\"purple\">must</strong> reference a semaphore signal operation that has been submitted for execution and any semaphore signal operations on which it depends (if any) <strong class=\"purple\">must</strong> have also been submitted for execution"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_KHR_performance_query)": [
|
|
{
|
|
"vuid": "VUID-vkQueueSubmit2-commandBuffer-03880",
|
|
"text": " If a command recorded into the <code>commandBuffer</code> member of any element of the <code>pCommandBufferInfos</code> member of any element of <code>pSubmits</code> was a <a href=\"#vkCmdBeginQuery\">vkCmdBeginQuery</a> whose <code>queryPool</code> was created with a <code>queryType</code> of <code>VK_QUERY_TYPE_PERFORMANCE_QUERY_KHR</code>, the <a href=\"#profiling-lock\">profiling lock</a> <strong class=\"purple\">must</strong> have been held continuously on the <code>VkDevice</code> that <code>queue</code> was retrieved from, throughout recording of those command buffers"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-vkQueueSubmit2-queue-06447",
|
|
"text": " If <code>queue</code> was not created with <code>VK_DEVICE_QUEUE_CREATE_PROTECTED_BIT</code>, the <code>flags</code> member of any element of <code>pSubmits</code> <strong class=\"purple\">must</strong> not include <code>VK_SUBMIT_PROTECTED_BIT_KHR</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkSubmitInfo2": {
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_KHR_timeline_semaphore)": [
|
|
{
|
|
"vuid": "VUID-VkSubmitInfo2-semaphore-03881",
|
|
"text": " If the same semaphore is used as the <code>semaphore</code> member of both an element of <code>pSignalSemaphoreInfos</code> and <code>pWaitSemaphoreInfos</code>, and that semaphore is a timeline semaphore, the <code>value</code> member of the <code>pSignalSemaphoreInfos</code> element <strong class=\"purple\">must</strong> be greater than the <code>value</code> member of the <code>pWaitSemaphoreInfos</code> element"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubmitInfo2-semaphore-03882",
|
|
"text": " If the <code>semaphore</code> member of any element of <code>pSignalSemaphoreInfos</code> is a timeline semaphore, the <code>value</code> member of that element <strong class=\"purple\">must</strong> have a value greater than the current value of the semaphore when the <a href=\"#synchronization-semaphores-signaling\">semaphore signal operation</a> is executed"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubmitInfo2-semaphore-03883",
|
|
"text": " If the <code>semaphore</code> member of any element of <code>pSignalSemaphoreInfos</code> is a timeline semaphore, the <code>value</code> member of that element <strong class=\"purple\">must</strong> have a value which does not differ from the current value of the semaphore or the value of any outstanding semaphore wait or signal operation on that semaphore by more than <a href=\"#limits-maxTimelineSemaphoreValueDifference\"><code>maxTimelineSemaphoreValueDifference</code></a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubmitInfo2-semaphore-03884",
|
|
"text": " If the <code>semaphore</code> member of any element of <code>pWaitSemaphoreInfos</code> is a timeline semaphore, the <code>value</code> member of that element <strong class=\"purple\">must</strong> have a value which does not differ from the current value of the semaphore or the value of any outstanding semaphore wait or signal operation on that semaphore by more than <a href=\"#limits-maxTimelineSemaphoreValueDifference\"><code>maxTimelineSemaphoreValueDifference</code></a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-VkSubmitInfo2-flags-03886",
|
|
"text": " If <code>flags</code> includes <code>VK_SUBMIT_PROTECTED_BIT</code>, all elements of <code>pCommandBuffers</code> <strong class=\"purple\">must</strong> be protected command buffers"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubmitInfo2-flags-03887",
|
|
"text": " If <code>flags</code> does not include <code>VK_SUBMIT_PROTECTED_BIT</code>, each element of <code>pCommandBuffers</code> <strong class=\"purple\">must</strong> not be a protected command buffer"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)": [
|
|
{
|
|
"vuid": "VUID-VkSubmitInfo2KHR-commandBuffer-06192",
|
|
"text": " If any <code>commandBuffer</code> member of an element of <code>pCommandBufferInfos</code> contains any <a href=\"#renderpass-suspension\">resumed render pass instances</a>, they <strong class=\"purple\">must</strong> be suspended by a render pass instance earlier in submission order within <code>pCommandBufferInfos</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubmitInfo2KHR-commandBuffer-06010",
|
|
"text": " If any <code>commandBuffer</code> member of an element of <code>pCommandBufferInfos</code> contains any <a href=\"#renderpass-suspension\">suspended render pass instances</a>, they <strong class=\"purple\">must</strong> be resumed by a render pass instance later in submission order within <code>pCommandBufferInfos</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubmitInfo2KHR-commandBuffer-06011",
|
|
"text": " If any <code>commandBuffer</code> member of an element of <code>pCommandBufferInfos</code> contains any <a href=\"#renderpass-suspension\">suspended render pass instances</a>, there <strong class=\"purple\">must</strong> be no action or synchronization commands between that render pass instance and the render pass instance that resumes it"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubmitInfo2KHR-commandBuffer-06012",
|
|
"text": " If any <code>commandBuffer</code> member of an element of <code>pCommandBufferInfos</code> contains any <a href=\"#renderpass-suspension\">suspended render pass instances</a>, there <strong class=\"purple\">must</strong> be no render pass instances between that render pass instance and the render pass instance that resumes it"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_EXT_sample_locations)": [
|
|
{
|
|
"vuid": "VUID-VkSubmitInfo2KHR-variableSampleLocations-06013",
|
|
"text": " If the <a href=\"#limits-variableSampleLocations\"><code>variableSampleLocations</code></a> limit is not supported, and any <code>commandBuffer</code> member of an element of <code>pCommandBufferInfos</code> contains any <a href=\"#renderpass-suspension\">suspended render pass instances</a>, where a graphics pipeline has been bound, any pipelines bound in the render pass instance that resumes it, or any subsequent render pass instances that resume from that one and so on, <strong class=\"purple\">must</strong> use the same sample locations"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)": [
|
|
{
|
|
"vuid": "VUID-VkSubmitInfo2-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_SUBMIT_INFO_2</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubmitInfo2-pNext-pNext",
|
|
"text": " Each <code>pNext</code> member of any structure (including this one) in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be either <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkPerformanceQuerySubmitInfoKHR\">VkPerformanceQuerySubmitInfoKHR</a>, <a href=\"#VkWin32KeyedMutexAcquireReleaseInfoKHR\">VkWin32KeyedMutexAcquireReleaseInfoKHR</a>, or <a href=\"#VkWin32KeyedMutexAcquireReleaseInfoNV\">VkWin32KeyedMutexAcquireReleaseInfoNV</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubmitInfo2-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubmitInfo2-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkSubmitFlagBits\">VkSubmitFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubmitInfo2-pWaitSemaphoreInfos-parameter",
|
|
"text": " If <code>waitSemaphoreInfoCount</code> is not <code>0</code>, <code>pWaitSemaphoreInfos</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>waitSemaphoreInfoCount</code> valid <a href=\"#VkSemaphoreSubmitInfo\">VkSemaphoreSubmitInfo</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubmitInfo2-pCommandBufferInfos-parameter",
|
|
"text": " If <code>commandBufferInfoCount</code> is not <code>0</code>, <code>pCommandBufferInfos</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>commandBufferInfoCount</code> valid <a href=\"#VkCommandBufferSubmitInfo\">VkCommandBufferSubmitInfo</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubmitInfo2-pSignalSemaphoreInfos-parameter",
|
|
"text": " If <code>signalSemaphoreInfoCount</code> is not <code>0</code>, <code>pSignalSemaphoreInfos</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>signalSemaphoreInfoCount</code> valid <a href=\"#VkSemaphoreSubmitInfo\">VkSemaphoreSubmitInfo</a> structures"
|
|
}
|
|
]
|
|
},
|
|
"VkSemaphoreSubmitInfo": {
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)": [
|
|
{
|
|
"vuid": "VUID-VkSemaphoreSubmitInfo-stageMask-03929",
|
|
"text": " If the <a href=\"#features-geometryShader\"><code>geometryShader</code></a> feature is not enabled, pname:stageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_GEOMETRY_SHADER_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSemaphoreSubmitInfo-stageMask-03930",
|
|
"text": " If the <a href=\"#features-tessellationShader\"><code>tessellationShader</code></a> feature is not enabled, pname:stageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_TESSELLATION_CONTROL_SHADER_BIT</code> or <code>VK_PIPELINE_STAGE_2_TESSELLATION_EVALUATION_SHADER_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSemaphoreSubmitInfo-device-03888",
|
|
"text": " If the <code>device</code> that <code>semaphore</code> was created on is not a device group, <code>deviceIndex</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSemaphoreSubmitInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_SEMAPHORE_SUBMIT_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSemaphoreSubmitInfo-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSemaphoreSubmitInfo-semaphore-parameter",
|
|
"text": " <code>semaphore</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSemaphore\">VkSemaphore</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSemaphoreSubmitInfo-stageMask-parameter",
|
|
"text": " <code>stageMask</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkPipelineStageFlagBits2\">VkPipelineStageFlagBits2</a> values"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_EXT_conditional_rendering)": [
|
|
{
|
|
"vuid": "VUID-VkSemaphoreSubmitInfo-stageMask-03931",
|
|
"text": " If the <a href=\"#features-conditionalRendering\"><code>conditionalRendering</code></a> feature is not enabled, pname:stageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_CONDITIONAL_RENDERING_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_EXT_fragment_density_map)": [
|
|
{
|
|
"vuid": "VUID-VkSemaphoreSubmitInfo-stageMask-03932",
|
|
"text": " If the <a href=\"#features-fragmentDensityMap\"><code>fragmentDensityMap</code></a> feature is not enabled, pname:stageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_FRAGMENT_DENSITY_PROCESS_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_EXT_transform_feedback)": [
|
|
{
|
|
"vuid": "VUID-VkSemaphoreSubmitInfo-stageMask-03933",
|
|
"text": " If the <a href=\"#features-transformFeedback\"><code>transformFeedback</code></a> feature is not enabled, pname:stageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_TRANSFORM_FEEDBACK_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_NV_mesh_shader)": [
|
|
{
|
|
"vuid": "VUID-VkSemaphoreSubmitInfo-stageMask-03934",
|
|
"text": " If the <a href=\"#features-meshShader\"><code>meshShader</code></a> feature is not enabled, pname:stageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_MESH_SHADER_BIT_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSemaphoreSubmitInfo-stageMask-03935",
|
|
"text": " If the <a href=\"#features-taskShader\"><code>taskShader</code></a> feature is not enabled, pname:stageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_TASK_SHADER_BIT_NV</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_NV_shading_rate_image)": [
|
|
{
|
|
"vuid": "VUID-VkSemaphoreSubmitInfo-stageMask-04956",
|
|
"text": " If the <a href=\"#features-shadingRateImage\"><code>shadingRateImage</code></a> feature is not enabled, pname:stageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_SHADING_RATE_IMAGE_BIT_NV</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_HUAWEI_subpass_shading)": [
|
|
{
|
|
"vuid": "VUID-VkSemaphoreSubmitInfo-stageMask-04957",
|
|
"text": " If the <a href=\"#features-subpassShading\"><code>subpassShading</code></a> feature is not enabled, pname:stageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_SUBPASS_SHADING_BIT_HUAWEI</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_HUAWEI_invocation_mask)": [
|
|
{
|
|
"vuid": "VUID-VkSemaphoreSubmitInfo-stageMask-04995",
|
|
"text": " If the <a href=\"#features-invocationMask\"><code>invocationMask</code></a> feature is not enabled, pname:stageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_INVOCATION_MASK_BIT_HUAWEI</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_KHR_device_group_creation,VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-VkSemaphoreSubmitInfo-device-03889",
|
|
"text": " If the <code>device</code> that <code>semaphore</code> was created on is a device group, <code>deviceIndex</code> <strong class=\"purple\">must</strong> be a valid device index"
|
|
}
|
|
]
|
|
},
|
|
"VkCommandBufferSubmitInfo": {
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)": [
|
|
{
|
|
"vuid": "VUID-VkCommandBufferSubmitInfo-commandBuffer-03890",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> not have been allocated with <code>VK_COMMAND_BUFFER_LEVEL_SECONDARY</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCommandBufferSubmitInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_COMMAND_BUFFER_SUBMIT_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCommandBufferSubmitInfo-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCommandBufferSubmitInfo-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_KHR_device_group_creation,VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-VkCommandBufferSubmitInfo-deviceMask-03891",
|
|
"text": " If <code>deviceMask</code> is not <code>0</code>, it <strong class=\"purple\">must</strong> be a valid device mask"
|
|
}
|
|
]
|
|
},
|
|
"vkQueueSubmit": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkQueueSubmit-fence-00063",
|
|
"text": " If <code>fence</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>fence</code> <strong class=\"purple\">must</strong> be unsignaled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkQueueSubmit-fence-00064",
|
|
"text": " If <code>fence</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>fence</code> <strong class=\"purple\">must</strong> not be associated with any other queue command that has not yet completed execution on that queue"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkQueueSubmit-pCommandBuffers-00065",
|
|
"text": " Any calls to <a href=\"#vkCmdSetEvent\">vkCmdSetEvent</a>, <a href=\"#vkCmdResetEvent\">vkCmdResetEvent</a> or <a href=\"#vkCmdWaitEvents\">vkCmdWaitEvents</a> that have been recorded into any of the command buffer elements of the <code>pCommandBuffers</code> member of any element of <code>pSubmits</code>, <strong class=\"purple\">must</strong> not reference any <a href=\"#VkEvent\">VkEvent</a> that is referenced by any of those commands in a command buffer that has been submitted to another queue and is still in the <em>pending state</em>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkQueueSubmit-pWaitDstStageMask-00066",
|
|
"text": " Any stage flag included in any element of the <code>pWaitDstStageMask</code> member of any element of <code>pSubmits</code> <strong class=\"purple\">must</strong> be a pipeline stage supported by one of the capabilities of <code>queue</code>, as specified in the <a href=\"#synchronization-pipeline-stages-supported\">table of supported pipeline stages</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkQueueSubmit-pSignalSemaphores-00067",
|
|
"text": " Each binary semaphore element of the <code>pSignalSemaphores</code> member of any element of <code>pSubmits</code> <strong class=\"purple\">must</strong> be unsignaled when the semaphore signal operation it defines is executed on the device"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkQueueSubmit-pWaitSemaphores-00068",
|
|
"text": " When a semaphore wait operation referring to a binary semaphore defined by any element of the <code>pWaitSemaphores</code> member of any element of <code>pSubmits</code> executes on <code>queue</code>, there <strong class=\"purple\">must</strong> be no other queues waiting on the same semaphore"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkQueueSubmit-pCommandBuffers-00070",
|
|
"text": " Each element of the <code>pCommandBuffers</code> member of each element of <code>pSubmits</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">pending or executable state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkQueueSubmit-pCommandBuffers-00071",
|
|
"text": " If any element of the <code>pCommandBuffers</code> member of any element of <code>pSubmits</code> was not recorded with the <code>VK_COMMAND_BUFFER_USAGE_SIMULTANEOUS_USE_BIT</code>, it <strong class=\"purple\">must</strong> not be in the <a href=\"#commandbuffers-lifecycle\">pending state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkQueueSubmit-pCommandBuffers-00072",
|
|
"text": " Any <a href=\"#commandbuffers-secondary\">secondary command buffers recorded</a> into any element of the <code>pCommandBuffers</code> member of any element of <code>pSubmits</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">pending or executable state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkQueueSubmit-pCommandBuffers-00073",
|
|
"text": " If any <a href=\"#commandbuffers-secondary\">secondary command buffers recorded</a> into any element of the <code>pCommandBuffers</code> member of any element of <code>pSubmits</code> was not recorded with the <code>VK_COMMAND_BUFFER_USAGE_SIMULTANEOUS_USE_BIT</code>, it <strong class=\"purple\">must</strong> not be in the <a href=\"#commandbuffers-lifecycle\">pending state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkQueueSubmit-pCommandBuffers-00074",
|
|
"text": " Each element of the <code>pCommandBuffers</code> member of each element of <code>pSubmits</code> <strong class=\"purple\">must</strong> have been allocated from a <code>VkCommandPool</code> that was created for the same queue family <code>queue</code> belongs to"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkQueueSubmit-pSubmits-02207",
|
|
"text": " If any element of <code>pSubmits->pCommandBuffers</code> includes a <a href=\"#synchronization-queue-transfers-acquire\">Queue Family Transfer Acquire Operation</a>, there <strong class=\"purple\">must</strong> exist a previously submitted <a href=\"#synchronization-queue-transfers-release\">Queue Family Transfer Release Operation</a> on a queue in the queue family identified by the acquire operation, with parameters matching the acquire operation as defined in the definition of such <a href=\"#synchronization-queue-transfers-acquire\">acquire operations</a>, and which happens-before the acquire operation"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkQueueSubmit-pSubmits-02808",
|
|
"text": " Any resource created with <code>VK_SHARING_MODE_EXCLUSIVE</code> that is read by an operation specified by <code>pSubmits</code> <strong class=\"purple\">must</strong> not be owned by any queue family other than the one which <code>queue</code> belongs to, at the time it is executed"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkQueueSubmit-pSubmits-04626",
|
|
"text": " Any resource created with <code>VK_SHARING_MODE_CONCURRENT</code> that is accessed by an operation specified by <code>pSubmits</code> <strong class=\"purple\">must</strong> have included the queue family of <code>queue</code> at resource creation time"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkQueueSubmit-queue-parameter",
|
|
"text": " <code>queue</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkQueue\">VkQueue</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkQueueSubmit-pSubmits-parameter",
|
|
"text": " If <code>submitCount</code> is not <code>0</code>, <code>pSubmits</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>submitCount</code> valid <a href=\"#VkSubmitInfo\">VkSubmitInfo</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkQueueSubmit-fence-parameter",
|
|
"text": " If <code>fence</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>fence</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkFence\">VkFence</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkQueueSubmit-commonparent",
|
|
"text": " Both of <code>fence</code>, and <code>queue</code> that are valid handles of non-ignored parameters <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"!(VK_KHR_timeline_semaphore)": [
|
|
{
|
|
"vuid": "VUID-vkQueueSubmit-pWaitSemaphores-00069",
|
|
"text": " All elements of the <code>pWaitSemaphores</code> member of all elements of <code>pSubmits</code> <strong class=\"purple\">must</strong> be semaphores that are signaled, or have <a href=\"#synchronization-semaphores-signaling\">semaphore signal operations</a> previously submitted for execution"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_timeline_semaphore)": [
|
|
{
|
|
"vuid": "VUID-vkQueueSubmit-pWaitSemaphores-03238",
|
|
"text": " All elements of the <code>pWaitSemaphores</code> member of all elements of <code>pSubmits</code> created with a <a href=\"#VkSemaphoreType\">VkSemaphoreType</a> of <code>VK_SEMAPHORE_TYPE_BINARY</code> <strong class=\"purple\">must</strong> reference a semaphore signal operation that has been submitted for execution and any semaphore signal operations on which it depends (if any) <strong class=\"purple\">must</strong> have also been submitted for execution"
|
|
}
|
|
],
|
|
"(VK_KHR_performance_query)": [
|
|
{
|
|
"vuid": "VUID-vkQueueSubmit-pCommandBuffers-03220",
|
|
"text": " If a command recorded into any element of <code>pCommandBuffers</code> was a <a href=\"#vkCmdBeginQuery\">vkCmdBeginQuery</a> whose <code>queryPool</code> was created with a <code>queryType</code> of <code>VK_QUERY_TYPE_PERFORMANCE_QUERY_KHR</code>, the <a href=\"#profiling-lock\">profiling lock</a> <strong class=\"purple\">must</strong> have been held continuously on the <code>VkDevice</code> that <code>queue</code> was retrieved from, throughout recording of those command buffers"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-vkQueueSubmit-queue-06448",
|
|
"text": " If <code>queue</code> was not created with <code>VK_DEVICE_QUEUE_CREATE_PROTECTED_BIT</code>, there <strong class=\"purple\">must</strong> be no element of <code>pSubmits</code> that includes an <a href=\"#VkProtectedSubmitInfo\">VkProtectedSubmitInfo</a> structure in its <code>pNext</code> chain with <code>protectedSubmit</code> equal to <code>VK_TRUE</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkSubmitInfo": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkSubmitInfo-pWaitDstStageMask-04090",
|
|
"text": " If the <a href=\"#features-geometryShader\"><code>geometryShader</code></a> feature is not enabled, pname:pWaitDstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_GEOMETRY_SHADER_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubmitInfo-pWaitDstStageMask-04091",
|
|
"text": " If the <a href=\"#features-tessellationShader\"><code>tessellationShader</code></a> feature is not enabled, pname:pWaitDstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_TESSELLATION_CONTROL_SHADER_BIT</code> or <code>VK_PIPELINE_STAGE_TESSELLATION_EVALUATION_SHADER_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubmitInfo-pCommandBuffers-00075",
|
|
"text": " Each element of <code>pCommandBuffers</code> <strong class=\"purple\">must</strong> not have been allocated with <code>VK_COMMAND_BUFFER_LEVEL_SECONDARY</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubmitInfo-pWaitDstStageMask-00078",
|
|
"text": " Each element of <code>pWaitDstStageMask</code> <strong class=\"purple\">must</strong> not include <code>VK_PIPELINE_STAGE_HOST_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubmitInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_SUBMIT_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubmitInfo-pNext-pNext",
|
|
"text": " Each <code>pNext</code> member of any structure (including this one) in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be either <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkAmigoProfilingSubmitInfoSEC\">VkAmigoProfilingSubmitInfoSEC</a>, <a href=\"#VkD3D12FenceSubmitInfoKHR\">VkD3D12FenceSubmitInfoKHR</a>, <a href=\"#VkDeviceGroupSubmitInfo\">VkDeviceGroupSubmitInfo</a>, <a href=\"#VkPerformanceQuerySubmitInfoKHR\">VkPerformanceQuerySubmitInfoKHR</a>, <a href=\"#VkProtectedSubmitInfo\">VkProtectedSubmitInfo</a>, <a href=\"#VkTimelineSemaphoreSubmitInfo\">VkTimelineSemaphoreSubmitInfo</a>, <a href=\"#VkWin32KeyedMutexAcquireReleaseInfoKHR\">VkWin32KeyedMutexAcquireReleaseInfoKHR</a>, or <a href=\"#VkWin32KeyedMutexAcquireReleaseInfoNV\">VkWin32KeyedMutexAcquireReleaseInfoNV</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubmitInfo-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubmitInfo-pWaitSemaphores-parameter",
|
|
"text": " If <code>waitSemaphoreCount</code> is not <code>0</code>, <code>pWaitSemaphores</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>waitSemaphoreCount</code> valid <a href=\"#VkSemaphore\">VkSemaphore</a> handles"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubmitInfo-pWaitDstStageMask-parameter",
|
|
"text": " If <code>waitSemaphoreCount</code> is not <code>0</code>, <code>pWaitDstStageMask</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>waitSemaphoreCount</code> valid combinations of <a href=\"#VkPipelineStageFlagBits\">VkPipelineStageFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubmitInfo-pWaitDstStageMask-requiredbitmask",
|
|
"text": " Each element of <code>pWaitDstStageMask</code> <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubmitInfo-pCommandBuffers-parameter",
|
|
"text": " If <code>commandBufferCount</code> is not <code>0</code>, <code>pCommandBuffers</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>commandBufferCount</code> valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handles"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubmitInfo-pSignalSemaphores-parameter",
|
|
"text": " If <code>signalSemaphoreCount</code> is not <code>0</code>, <code>pSignalSemaphores</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>signalSemaphoreCount</code> valid <a href=\"#VkSemaphore\">VkSemaphore</a> handles"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubmitInfo-commonparent",
|
|
"text": " Each of the elements of <code>pCommandBuffers</code>, the elements of <code>pSignalSemaphores</code>, and the elements of <code>pWaitSemaphores</code> that are valid handles of non-ignored parameters <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"(VK_EXT_conditional_rendering)": [
|
|
{
|
|
"vuid": "VUID-VkSubmitInfo-pWaitDstStageMask-04092",
|
|
"text": " If the <a href=\"#features-conditionalRendering\"><code>conditionalRendering</code></a> feature is not enabled, pname:pWaitDstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_CONDITIONAL_RENDERING_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_fragment_density_map)": [
|
|
{
|
|
"vuid": "VUID-VkSubmitInfo-pWaitDstStageMask-04093",
|
|
"text": " If the <a href=\"#features-fragmentDensityMap\"><code>fragmentDensityMap</code></a> feature is not enabled, pname:pWaitDstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_FRAGMENT_DENSITY_PROCESS_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)": [
|
|
{
|
|
"vuid": "VUID-VkSubmitInfo-pWaitDstStageMask-04094",
|
|
"text": " If the <a href=\"#features-transformFeedback\"><code>transformFeedback</code></a> feature is not enabled, pname:pWaitDstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_TRANSFORM_FEEDBACK_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)": [
|
|
{
|
|
"vuid": "VUID-VkSubmitInfo-pWaitDstStageMask-04095",
|
|
"text": " If the <a href=\"#features-meshShader\"><code>meshShader</code></a> feature is not enabled, pname:pWaitDstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_MESH_SHADER_BIT_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubmitInfo-pWaitDstStageMask-04096",
|
|
"text": " If the <a href=\"#features-taskShader\"><code>taskShader</code></a> feature is not enabled, pname:pWaitDstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_TASK_SHADER_BIT_NV</code>"
|
|
}
|
|
],
|
|
"(VK_NV_shading_rate_image)": [
|
|
{
|
|
"vuid": "VUID-VkSubmitInfo-pWaitDstStageMask-04097",
|
|
"text": " If the <a href=\"#features-shadingRateImage\"><code>shadingRateImage</code></a> feature is not enabled, pname:pWaitDstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_SHADING_RATE_IMAGE_BIT_NV</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)": [
|
|
{
|
|
"vuid": "VUID-VkSubmitInfo-pWaitDstStageMask-03937",
|
|
"text": " If the <a href=\"#features-synchronization2\"><code>synchronization2</code></a> feature is not enabled, pname:pWaitDstStageMask <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
}
|
|
],
|
|
"!(VK_VERSION_1_3,VK_KHR_synchronization2)": [
|
|
{
|
|
"vuid": "VUID-VkSubmitInfo-pWaitDstStageMask-04996",
|
|
"text": " pname:pWaitDstStageMask <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_timeline_semaphore)": [
|
|
{
|
|
"vuid": "VUID-VkSubmitInfo-pWaitSemaphores-03239",
|
|
"text": " If any element of <code>pWaitSemaphores</code> or <code>pSignalSemaphores</code> was created with a <a href=\"#VkSemaphoreType\">VkSemaphoreType</a> of <code>VK_SEMAPHORE_TYPE_TIMELINE</code>, then the <code>pNext</code> chain <strong class=\"purple\">must</strong> include a <a href=\"#VkTimelineSemaphoreSubmitInfo\">VkTimelineSemaphoreSubmitInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubmitInfo-pNext-03240",
|
|
"text": " If the <code>pNext</code> chain of this structure includes a <a href=\"#VkTimelineSemaphoreSubmitInfo\">VkTimelineSemaphoreSubmitInfo</a> structure and any element of <code>pWaitSemaphores</code> was created with a <a href=\"#VkSemaphoreType\">VkSemaphoreType</a> of <code>VK_SEMAPHORE_TYPE_TIMELINE</code>, then its <code>waitSemaphoreValueCount</code> member <strong class=\"purple\">must</strong> equal <code>waitSemaphoreCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubmitInfo-pNext-03241",
|
|
"text": " If the <code>pNext</code> chain of this structure includes a <a href=\"#VkTimelineSemaphoreSubmitInfo\">VkTimelineSemaphoreSubmitInfo</a> structure and any element of <code>pSignalSemaphores</code> was created with a <a href=\"#VkSemaphoreType\">VkSemaphoreType</a> of <code>VK_SEMAPHORE_TYPE_TIMELINE</code>, then its <code>signalSemaphoreValueCount</code> member <strong class=\"purple\">must</strong> equal <code>signalSemaphoreCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubmitInfo-pSignalSemaphores-03242",
|
|
"text": " For each element of <code>pSignalSemaphores</code> created with a <a href=\"#VkSemaphoreType\">VkSemaphoreType</a> of <code>VK_SEMAPHORE_TYPE_TIMELINE</code> the corresponding element of <a href=\"#VkTimelineSemaphoreSubmitInfo\">VkTimelineSemaphoreSubmitInfo</a>::<code>pSignalSemaphoreValues</code> <strong class=\"purple\">must</strong> have a value greater than the current value of the semaphore when the <a href=\"#synchronization-semaphores-signaling\">semaphore signal operation</a> is executed"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubmitInfo-pWaitSemaphores-03243",
|
|
"text": " For each element of <code>pWaitSemaphores</code> created with a <a href=\"#VkSemaphoreType\">VkSemaphoreType</a> of <code>VK_SEMAPHORE_TYPE_TIMELINE</code> the corresponding element of <a href=\"#VkTimelineSemaphoreSubmitInfo\">VkTimelineSemaphoreSubmitInfo</a>::<code>pWaitSemaphoreValues</code> <strong class=\"purple\">must</strong> have a value which does not differ from the current value of the semaphore or the value of any outstanding semaphore wait or signal operation on that semaphore by more than <a href=\"#limits-maxTimelineSemaphoreValueDifference\"><code>maxTimelineSemaphoreValueDifference</code></a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubmitInfo-pSignalSemaphores-03244",
|
|
"text": " For each element of <code>pSignalSemaphores</code> created with a <a href=\"#VkSemaphoreType\">VkSemaphoreType</a> of <code>VK_SEMAPHORE_TYPE_TIMELINE</code> the corresponding element of <a href=\"#VkTimelineSemaphoreSubmitInfo\">VkTimelineSemaphoreSubmitInfo</a>::<code>pSignalSemaphoreValues</code> <strong class=\"purple\">must</strong> have a value which does not differ from the current value of the semaphore or the value of any outstanding semaphore wait or signal operation on that semaphore by more than <a href=\"#limits-maxTimelineSemaphoreValueDifference\"><code>maxTimelineSemaphoreValueDifference</code></a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-VkSubmitInfo-pNext-04120",
|
|
"text": " If the <code>pNext</code> chain of this structure does not include a <code>VkProtectedSubmitInfo</code> structure with <code>protectedSubmit</code> set to <code>VK_TRUE</code>, then each element of the <code>pCommandBuffers</code> array <strong class=\"purple\">must</strong> be an unprotected command buffer"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubmitInfo-pNext-04148",
|
|
"text": " If the <code>pNext</code> chain of this structure includes a <code>VkProtectedSubmitInfo</code> structure with <code>protectedSubmit</code> set to <code>VK_TRUE</code>, then each element of the <code>pCommandBuffers</code> array <strong class=\"purple\">must</strong> be a protected command buffer"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)": [
|
|
{
|
|
"vuid": "VUID-VkSubmitInfo-pCommandBuffers-06193",
|
|
"text": " If <code>pCommandBuffers</code> contains any <a href=\"#renderpass-suspension\">resumed render pass instances</a>, they <strong class=\"purple\">must</strong> be suspended by a render pass instance earlier in submission order within <code>pCommandBuffers</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubmitInfo-pCommandBuffers-06014",
|
|
"text": " If <code>pCommandBuffers</code> contains any <a href=\"#renderpass-suspension\">suspended render pass instances</a>, they <strong class=\"purple\">must</strong> be resumed by a render pass instance later in submission order within <code>pCommandBuffers</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubmitInfo-pCommandBuffers-06015",
|
|
"text": " If <code>pCommandBuffers</code> contains any <a href=\"#renderpass-suspension\">suspended render pass instances</a>, there <strong class=\"purple\">must</strong> be no action or synchronization commands between that render pass instance and the render pass instance that resumes it"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubmitInfo-pCommandBuffers-06016",
|
|
"text": " If <code>pCommandBuffers</code> contains any <a href=\"#renderpass-suspension\">suspended render pass instances</a>, there <strong class=\"purple\">must</strong> be no render pass instances between that render pass instance and the render pass instance that resumes it"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_EXT_sample_locations)": [
|
|
{
|
|
"vuid": "VUID-VkSubmitInfo-variableSampleLocations-06017",
|
|
"text": " If the <a href=\"#limits-variableSampleLocations\"><code>variableSampleLocations</code></a> limit is not supported, and any element of <code>pCommandBuffers</code> contains any <a href=\"#renderpass-suspension\">suspended render pass instances</a>, where a graphics pipeline has been bound, any pipelines bound in the render pass instance that resumes it, or any subsequent render pass instances that resume from that one and so on, <strong class=\"purple\">must</strong> use the same sample locations"
|
|
}
|
|
]
|
|
},
|
|
"VkTimelineSemaphoreSubmitInfo": {
|
|
"(VK_VERSION_1_2,VK_KHR_timeline_semaphore)": [
|
|
{
|
|
"vuid": "VUID-VkTimelineSemaphoreSubmitInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_TIMELINE_SEMAPHORE_SUBMIT_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkTimelineSemaphoreSubmitInfo-pWaitSemaphoreValues-parameter",
|
|
"text": " If <code>waitSemaphoreValueCount</code> is not <code>0</code>, and <code>pWaitSemaphoreValues</code> is not <code>NULL</code>, <code>pWaitSemaphoreValues</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>waitSemaphoreValueCount</code> <code>uint64_t</code> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkTimelineSemaphoreSubmitInfo-pSignalSemaphoreValues-parameter",
|
|
"text": " If <code>signalSemaphoreValueCount</code> is not <code>0</code>, and <code>pSignalSemaphoreValues</code> is not <code>NULL</code>, <code>pSignalSemaphoreValues</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>signalSemaphoreValueCount</code> <code>uint64_t</code> values"
|
|
}
|
|
]
|
|
},
|
|
"VkD3D12FenceSubmitInfoKHR": {
|
|
"(VK_KHR_external_semaphore_win32)": [
|
|
{
|
|
"vuid": "VUID-VkD3D12FenceSubmitInfoKHR-waitSemaphoreValuesCount-00079",
|
|
"text": " <code>waitSemaphoreValuesCount</code> <strong class=\"purple\">must</strong> be the same value as <code>VkSubmitInfo</code>::<code>waitSemaphoreCount</code>, where <code>VkSubmitInfo</code> is in the <code>pNext</code> chain of this <code>VkD3D12FenceSubmitInfoKHR</code> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkD3D12FenceSubmitInfoKHR-signalSemaphoreValuesCount-00080",
|
|
"text": " <code>signalSemaphoreValuesCount</code> <strong class=\"purple\">must</strong> be the same value as <code>VkSubmitInfo</code>::<code>signalSemaphoreCount</code>, where <code>VkSubmitInfo</code> is in the <code>pNext</code> chain of this <code>VkD3D12FenceSubmitInfoKHR</code> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkD3D12FenceSubmitInfoKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_D3D12_FENCE_SUBMIT_INFO_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkD3D12FenceSubmitInfoKHR-pWaitSemaphoreValues-parameter",
|
|
"text": " If <code>waitSemaphoreValuesCount</code> is not <code>0</code>, and <code>pWaitSemaphoreValues</code> is not <code>NULL</code>, <code>pWaitSemaphoreValues</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>waitSemaphoreValuesCount</code> <code>uint64_t</code> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkD3D12FenceSubmitInfoKHR-pSignalSemaphoreValues-parameter",
|
|
"text": " If <code>signalSemaphoreValuesCount</code> is not <code>0</code>, and <code>pSignalSemaphoreValues</code> is not <code>NULL</code>, <code>pSignalSemaphoreValues</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>signalSemaphoreValuesCount</code> <code>uint64_t</code> values"
|
|
}
|
|
]
|
|
},
|
|
"VkWin32KeyedMutexAcquireReleaseInfoKHR": {
|
|
"(VK_KHR_win32_keyed_mutex)": [
|
|
{
|
|
"vuid": "VUID-VkWin32KeyedMutexAcquireReleaseInfoKHR-pAcquireSyncs-00081",
|
|
"text": " Each member of <code>pAcquireSyncs</code> and <code>pReleaseSyncs</code> <strong class=\"purple\">must</strong> be a device memory object imported by setting <a href=\"#VkImportMemoryWin32HandleInfoKHR\">VkImportMemoryWin32HandleInfoKHR</a>::<code>handleType</code> to <code>VK_EXTERNAL_MEMORY_HANDLE_TYPE_D3D11_TEXTURE_BIT</code> or <code>VK_EXTERNAL_MEMORY_HANDLE_TYPE_D3D11_TEXTURE_KMT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWin32KeyedMutexAcquireReleaseInfoKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_WIN32_KEYED_MUTEX_ACQUIRE_RELEASE_INFO_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWin32KeyedMutexAcquireReleaseInfoKHR-pAcquireSyncs-parameter",
|
|
"text": " If <code>acquireCount</code> is not <code>0</code>, <code>pAcquireSyncs</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>acquireCount</code> valid <a href=\"#VkDeviceMemory\">VkDeviceMemory</a> handles"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWin32KeyedMutexAcquireReleaseInfoKHR-pAcquireKeys-parameter",
|
|
"text": " If <code>acquireCount</code> is not <code>0</code>, <code>pAcquireKeys</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>acquireCount</code> <code>uint64_t</code> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWin32KeyedMutexAcquireReleaseInfoKHR-pAcquireTimeouts-parameter",
|
|
"text": " If <code>acquireCount</code> is not <code>0</code>, <code>pAcquireTimeouts</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>acquireCount</code> <code>uint32_t</code> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWin32KeyedMutexAcquireReleaseInfoKHR-pReleaseSyncs-parameter",
|
|
"text": " If <code>releaseCount</code> is not <code>0</code>, <code>pReleaseSyncs</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>releaseCount</code> valid <a href=\"#VkDeviceMemory\">VkDeviceMemory</a> handles"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWin32KeyedMutexAcquireReleaseInfoKHR-pReleaseKeys-parameter",
|
|
"text": " If <code>releaseCount</code> is not <code>0</code>, <code>pReleaseKeys</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>releaseCount</code> <code>uint64_t</code> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWin32KeyedMutexAcquireReleaseInfoKHR-commonparent",
|
|
"text": " Both of the elements of <code>pAcquireSyncs</code>, and the elements of <code>pReleaseSyncs</code> that are valid handles of non-ignored parameters <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
]
|
|
},
|
|
"VkWin32KeyedMutexAcquireReleaseInfoNV": {
|
|
"(VK_NV_win32_keyed_mutex)": [
|
|
{
|
|
"vuid": "VUID-VkWin32KeyedMutexAcquireReleaseInfoNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_WIN32_KEYED_MUTEX_ACQUIRE_RELEASE_INFO_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWin32KeyedMutexAcquireReleaseInfoNV-pAcquireSyncs-parameter",
|
|
"text": " If <code>acquireCount</code> is not <code>0</code>, <code>pAcquireSyncs</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>acquireCount</code> valid <a href=\"#VkDeviceMemory\">VkDeviceMemory</a> handles"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWin32KeyedMutexAcquireReleaseInfoNV-pAcquireKeys-parameter",
|
|
"text": " If <code>acquireCount</code> is not <code>0</code>, <code>pAcquireKeys</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>acquireCount</code> <code>uint64_t</code> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWin32KeyedMutexAcquireReleaseInfoNV-pAcquireTimeoutMilliseconds-parameter",
|
|
"text": " If <code>acquireCount</code> is not <code>0</code>, <code>pAcquireTimeoutMilliseconds</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>acquireCount</code> <code>uint32_t</code> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWin32KeyedMutexAcquireReleaseInfoNV-pReleaseSyncs-parameter",
|
|
"text": " If <code>releaseCount</code> is not <code>0</code>, <code>pReleaseSyncs</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>releaseCount</code> valid <a href=\"#VkDeviceMemory\">VkDeviceMemory</a> handles"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWin32KeyedMutexAcquireReleaseInfoNV-pReleaseKeys-parameter",
|
|
"text": " If <code>releaseCount</code> is not <code>0</code>, <code>pReleaseKeys</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>releaseCount</code> <code>uint64_t</code> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWin32KeyedMutexAcquireReleaseInfoNV-commonparent",
|
|
"text": " Both of the elements of <code>pAcquireSyncs</code>, and the elements of <code>pReleaseSyncs</code> that are valid handles of non-ignored parameters <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
]
|
|
},
|
|
"VkProtectedSubmitInfo": {
|
|
"(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-VkProtectedSubmitInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PROTECTED_SUBMIT_INFO</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkDeviceGroupSubmitInfo": {
|
|
"(VK_VERSION_1_1,VK_KHR_device_group)": [
|
|
{
|
|
"vuid": "VUID-VkDeviceGroupSubmitInfo-waitSemaphoreCount-00082",
|
|
"text": " <code>waitSemaphoreCount</code> <strong class=\"purple\">must</strong> equal <a href=\"#VkSubmitInfo\">VkSubmitInfo</a>::<code>waitSemaphoreCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceGroupSubmitInfo-commandBufferCount-00083",
|
|
"text": " <code>commandBufferCount</code> <strong class=\"purple\">must</strong> equal <a href=\"#VkSubmitInfo\">VkSubmitInfo</a>::<code>commandBufferCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceGroupSubmitInfo-signalSemaphoreCount-00084",
|
|
"text": " <code>signalSemaphoreCount</code> <strong class=\"purple\">must</strong> equal <a href=\"#VkSubmitInfo\">VkSubmitInfo</a>::<code>signalSemaphoreCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceGroupSubmitInfo-pWaitSemaphoreDeviceIndices-00085",
|
|
"text": " All elements of <code>pWaitSemaphoreDeviceIndices</code> and <code>pSignalSemaphoreDeviceIndices</code> <strong class=\"purple\">must</strong> be valid device indices"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceGroupSubmitInfo-pCommandBufferDeviceMasks-00086",
|
|
"text": " All elements of <code>pCommandBufferDeviceMasks</code> <strong class=\"purple\">must</strong> be valid device masks"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceGroupSubmitInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_DEVICE_GROUP_SUBMIT_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceGroupSubmitInfo-pWaitSemaphoreDeviceIndices-parameter",
|
|
"text": " If <code>waitSemaphoreCount</code> is not <code>0</code>, <code>pWaitSemaphoreDeviceIndices</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>waitSemaphoreCount</code> <code>uint32_t</code> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceGroupSubmitInfo-pCommandBufferDeviceMasks-parameter",
|
|
"text": " If <code>commandBufferCount</code> is not <code>0</code>, <code>pCommandBufferDeviceMasks</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>commandBufferCount</code> <code>uint32_t</code> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceGroupSubmitInfo-pSignalSemaphoreDeviceIndices-parameter",
|
|
"text": " If <code>signalSemaphoreCount</code> is not <code>0</code>, <code>pSignalSemaphoreDeviceIndices</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>signalSemaphoreCount</code> <code>uint32_t</code> values"
|
|
}
|
|
]
|
|
},
|
|
"VkPerformanceQuerySubmitInfoKHR": {
|
|
"(VK_KHR_performance_query)": [
|
|
{
|
|
"vuid": "VUID-VkPerformanceQuerySubmitInfoKHR-counterPassIndex-03221",
|
|
"text": " <code>counterPassIndex</code> <strong class=\"purple\">must</strong> be less than the number of counter passes required by any queries within the batch. The required number of counter passes for a performance query is obtained by calling <a href=\"#vkGetPhysicalDeviceQueueFamilyPerformanceQueryPassesKHR\">vkGetPhysicalDeviceQueueFamilyPerformanceQueryPassesKHR</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPerformanceQuerySubmitInfoKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PERFORMANCE_QUERY_SUBMIT_INFO_KHR</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdExecuteCommands": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteCommands-pCommandBuffers-00088",
|
|
"text": " Each element of <code>pCommandBuffers</code> <strong class=\"purple\">must</strong> have been allocated with a <code>level</code> of <code>VK_COMMAND_BUFFER_LEVEL_SECONDARY</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteCommands-pCommandBuffers-00089",
|
|
"text": " Each element of <code>pCommandBuffers</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">pending or executable state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteCommands-pCommandBuffers-00091",
|
|
"text": " If any element of <code>pCommandBuffers</code> was not recorded with the <code>VK_COMMAND_BUFFER_USAGE_SIMULTANEOUS_USE_BIT</code> flag, it <strong class=\"purple\">must</strong> not be in the <a href=\"#commandbuffers-lifecycle\">pending state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteCommands-pCommandBuffers-00092",
|
|
"text": " If any element of <code>pCommandBuffers</code> was not recorded with the <code>VK_COMMAND_BUFFER_USAGE_SIMULTANEOUS_USE_BIT</code> flag, it <strong class=\"purple\">must</strong> not have already been recorded to <code>commandBuffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteCommands-pCommandBuffers-00093",
|
|
"text": " If any element of <code>pCommandBuffers</code> was not recorded with the <code>VK_COMMAND_BUFFER_USAGE_SIMULTANEOUS_USE_BIT</code> flag, it <strong class=\"purple\">must</strong> not appear more than once in <code>pCommandBuffers</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteCommands-pCommandBuffers-00094",
|
|
"text": " Each element of <code>pCommandBuffers</code> <strong class=\"purple\">must</strong> have been allocated from a <code>VkCommandPool</code> that was created for the same queue family as the <code>VkCommandPool</code> from which <code>commandBuffer</code> was allocated"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteCommands-pCommandBuffers-00096",
|
|
"text": " If <code>vkCmdExecuteCommands</code> is being called within a render pass instance, each element of <code>pCommandBuffers</code> <strong class=\"purple\">must</strong> have been recorded with the <code>VK_COMMAND_BUFFER_USAGE_RENDER_PASS_CONTINUE_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteCommands-pCommandBuffers-00099",
|
|
"text": " If <code>vkCmdExecuteCommands</code> is being called within a render pass instance, and any element of <code>pCommandBuffers</code> was recorded with <a href=\"#VkCommandBufferInheritanceInfo\">VkCommandBufferInheritanceInfo</a>::<code>framebuffer</code> not equal to <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, that <code>VkFramebuffer</code> <strong class=\"purple\">must</strong> match the <code>VkFramebuffer</code> used in the current render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteCommands-contents-06018",
|
|
"text": " If <code>vkCmdExecuteCommands</code> is being called within a render pass instance begun with <a href=\"#vkCmdBeginRenderPass\">vkCmdBeginRenderPass</a>, its <code>contents</code> parameter <strong class=\"purple\">must</strong> have been set to <code>VK_SUBPASS_CONTENTS_SECONDARY_COMMAND_BUFFERS</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteCommands-pCommandBuffers-06019",
|
|
"text": " If <code>vkCmdExecuteCommands</code> is being called within a render pass instance begun with <a href=\"#vkCmdBeginRenderPass\">vkCmdBeginRenderPass</a>, each element of <code>pCommandBuffers</code> <strong class=\"purple\">must</strong> have been recorded with <a href=\"#VkCommandBufferInheritanceInfo\">VkCommandBufferInheritanceInfo</a>::<code>subpass</code> set to the index of the subpass which the given command buffer will be executed in"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteCommands-pBeginInfo-06020",
|
|
"text": " If <code>vkCmdExecuteCommands</code> is being called within a render pass instance begun with <a href=\"#vkCmdBeginRenderPass\">vkCmdBeginRenderPass</a>, the render passes specified in the <code>pBeginInfo->pInheritanceInfo->renderPass</code> members of the <a href=\"#vkBeginCommandBuffer\">vkBeginCommandBuffer</a> commands used to begin recording each element of <code>pCommandBuffers</code> <strong class=\"purple\">must</strong> be <a href=\"#renderpass-compatibility\">compatible</a> with the current render pass"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteCommands-pCommandBuffers-00100",
|
|
"text": " If <code>vkCmdExecuteCommands</code> is not being called within a render pass instance, each element of <code>pCommandBuffers</code> <strong class=\"purple\">must</strong> not have been recorded with the <code>VK_COMMAND_BUFFER_USAGE_RENDER_PASS_CONTINUE_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteCommands-commandBuffer-00101",
|
|
"text": " If the <a href=\"#features-inheritedQueries\"><code>inheritedQueries</code></a> feature is not enabled, <code>commandBuffer</code> <strong class=\"purple\">must</strong> not have any queries <a href=\"#queries-operation-active\">active</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteCommands-commandBuffer-00102",
|
|
"text": " If <code>commandBuffer</code> has a <code>VK_QUERY_TYPE_OCCLUSION</code> query <a href=\"#queries-operation-active\">active</a>, then each element of <code>pCommandBuffers</code> <strong class=\"purple\">must</strong> have been recorded with <code>VkCommandBufferInheritanceInfo</code>::<code>occlusionQueryEnable</code> set to <code>VK_TRUE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteCommands-commandBuffer-00103",
|
|
"text": " If <code>commandBuffer</code> has a <code>VK_QUERY_TYPE_OCCLUSION</code> query <a href=\"#queries-operation-active\">active</a>, then each element of <code>pCommandBuffers</code> <strong class=\"purple\">must</strong> have been recorded with <code>VkCommandBufferInheritanceInfo</code>::<code>queryFlags</code> having all bits set that are set for the query"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteCommands-commandBuffer-00104",
|
|
"text": " If <code>commandBuffer</code> has a <code>VK_QUERY_TYPE_PIPELINE_STATISTICS</code> query <a href=\"#queries-operation-active\">active</a>, then each element of <code>pCommandBuffers</code> <strong class=\"purple\">must</strong> have been recorded with <code>VkCommandBufferInheritanceInfo</code>::<code>pipelineStatistics</code> having all bits set that are set in the <code>VkQueryPool</code> the query uses"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteCommands-pCommandBuffers-00105",
|
|
"text": " Each element of <code>pCommandBuffers</code> <strong class=\"purple\">must</strong> not begin any query types that are <a href=\"#queries-operation-active\">active</a> in <code>commandBuffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteCommands-commandBuffer-06533",
|
|
"text": " If <code>vkCmdExecuteCommands</code> is being called within a render pass instance and any recorded command in <code>commandBuffer</code> in the current subpass will write to an image subresource as an attachment, commands recorded in elements of <code>pCommandBuffers</code> <strong class=\"purple\">must</strong> not read from the memory backing that image subresource in any other way"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteCommands-commandBuffer-06534",
|
|
"text": " If <code>vkCmdExecuteCommands</code> is being called within a render pass instance and any recorded command in <code>commandBuffer</code> in the current subpass will read from an image subresource used as an attachment in any way other than as an attachment, commands recorded in elements of <code>pCommandBuffers</code> <strong class=\"purple\">must</strong> not write to that image subresource as an attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteCommands-pCommandBuffers-06535",
|
|
"text": " If <code>vkCmdExecuteCommands</code> is being called within a render pass instance and any recorded command in a given element of <code>pCommandBuffers</code> will write to an image subresource as an attachment, commands recorded in elements of <code>pCommandBuffers</code> at a higher index <strong class=\"purple\">must</strong> not read from the memory backing that image subresource in any other way"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteCommands-pCommandBuffers-06536",
|
|
"text": " If <code>vkCmdExecuteCommands</code> is being called within a render pass instance and any recorded command in a given element of <code>pCommandBuffers</code> will read from an image subresource used as an attachment in any way other than as an attachment, commands recorded in elements of <code>pCommandBuffers</code> at a higher index <strong class=\"purple\">must</strong> not write to that image subresource as an attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteCommands-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteCommands-pCommandBuffers-parameter",
|
|
"text": " <code>pCommandBuffers</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>commandBufferCount</code> valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handles"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteCommands-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteCommands-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support transfer, graphics, or compute operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteCommands-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteCommands-bufferlevel",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a primary <code>VkCommandBuffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteCommands-commandBufferCount-arraylength",
|
|
"text": " <code>commandBufferCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteCommands-commonparent",
|
|
"text": " Both of <code>commandBuffer</code>, and the elements of <code>pCommandBuffers</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"!(VK_VERSION_1_3,VK_KHR_dynamic_rendering)": [
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteCommands-contents-00095",
|
|
"text": " If <code>vkCmdExecuteCommands</code> is being called within a render pass instance, that render pass instance <strong class=\"purple\">must</strong> have been begun with the <code>contents</code> parameter of <code>vkCmdBeginRenderPass</code> set to <code>VK_SUBPASS_CONTENTS_SECONDARY_COMMAND_BUFFERS</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteCommands-pCommandBuffers-00097",
|
|
"text": " If <code>vkCmdExecuteCommands</code> is being called within a render pass instance, each element of <code>pCommandBuffers</code> <strong class=\"purple\">must</strong> have been recorded with <code>VkCommandBufferInheritanceInfo</code>::<code>subpass</code> set to the index of the subpass which the given command buffer will be executed in"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteCommands-pInheritanceInfo-00098",
|
|
"text": " If <code>vkCmdExecuteCommands</code> is being called within a render pass instance, the render passes specified in the <code>pBeginInfo->pInheritanceInfo->renderPass</code> members of the <a href=\"#vkBeginCommandBuffer\">vkBeginCommandBuffer</a> commands used to begin recording each element of <code>pCommandBuffers</code> <strong class=\"purple\">must</strong> be <a href=\"#renderpass-compatibility\">compatible</a> with the current render pass"
|
|
}
|
|
],
|
|
"(VK_QCOM_render_pass_transform)": [
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteCommands-pNext-02865",
|
|
"text": " If <code>vkCmdExecuteCommands</code> is being called within a render pass instance that included <a href=\"#VkRenderPassTransformBeginInfoQCOM\">VkRenderPassTransformBeginInfoQCOM</a> in the <code>pNext</code> chain of <a href=\"#VkRenderPassBeginInfo\">VkRenderPassBeginInfo</a>, then each element of <code>pCommandBuffers</code> <strong class=\"purple\">must</strong> have been recorded with <a href=\"#VkCommandBufferInheritanceRenderPassTransformInfoQCOM\">VkCommandBufferInheritanceRenderPassTransformInfoQCOM</a> in the <code>pNext</code> chain of <a href=\"#VkCommandBufferBeginInfo\">VkCommandBufferBeginInfo</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteCommands-pNext-02866",
|
|
"text": " If <code>vkCmdExecuteCommands</code> is being called within a render pass instance that included <a href=\"#VkRenderPassTransformBeginInfoQCOM\">VkRenderPassTransformBeginInfoQCOM</a> in the <code>pNext</code> chain of <a href=\"#VkRenderPassBeginInfo\">VkRenderPassBeginInfo</a>, then each element of <code>pCommandBuffers</code> <strong class=\"purple\">must</strong> have been recorded with <a href=\"#VkCommandBufferInheritanceRenderPassTransformInfoQCOM\">VkCommandBufferInheritanceRenderPassTransformInfoQCOM</a>::<code>transform</code> identical to <a href=\"#VkRenderPassTransformBeginInfoQCOM\">VkRenderPassTransformBeginInfoQCOM</a>::<code>transform</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteCommands-pNext-02867",
|
|
"text": " If <code>vkCmdExecuteCommands</code> is being called within a render pass instance that included <a href=\"#VkRenderPassTransformBeginInfoQCOM\">VkRenderPassTransformBeginInfoQCOM</a> in the <code>pNext</code> chain of <a href=\"#VkRenderPassBeginInfo\">VkRenderPassBeginInfo</a>, then each element of <code>pCommandBuffers</code> <strong class=\"purple\">must</strong> have been recorded with <a href=\"#VkCommandBufferInheritanceRenderPassTransformInfoQCOM\">VkCommandBufferInheritanceRenderPassTransformInfoQCOM</a>::<code>renderArea</code> identical to <a href=\"#VkRenderPassBeginInfo\">VkRenderPassBeginInfo</a>::<code>renderArea</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteCommands-commandBuffer-01820",
|
|
"text": " If <code>commandBuffer</code> is a protected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, each element of <code>pCommandBuffers</code> <strong class=\"purple\">must</strong> be a protected command buffer"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteCommands-commandBuffer-01821",
|
|
"text": " If <code>commandBuffer</code> is an unprotected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, each element of <code>pCommandBuffers</code> <strong class=\"purple\">must</strong> be an unprotected command buffer"
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)": [
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteCommands-None-02286",
|
|
"text": " This command <strong class=\"purple\">must</strong> not be recorded when transform feedback is active"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)": [
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteCommands-pCommandBuffers-06021",
|
|
"text": " If <code>pCommandBuffers</code> contains any <a href=\"#renderpass-suspension\">suspended render pass instances</a>, there <strong class=\"purple\">must</strong> be no action or synchronization commands between that render pass instance and any render pass instance that resumes it"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteCommands-pCommandBuffers-06022",
|
|
"text": " If <code>pCommandBuffers</code> contains any <a href=\"#renderpass-suspension\">suspended render pass instances</a>, there <strong class=\"purple\">must</strong> be no render pass instances between that render pass instance and any render pass instance that resumes it"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteCommands-flags-06024",
|
|
"text": " If <code>vkCmdExecuteCommands</code> is being called within a render pass instance begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, its <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>flags</code> parameter <strong class=\"purple\">must</strong> have included <code>VK_RENDERING_CONTENTS_SECONDARY_COMMAND_BUFFERS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteCommands-pBeginInfo-06025",
|
|
"text": " If <code>vkCmdExecuteCommands</code> is being called within a render pass instance begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the render passes specified in the <code>pBeginInfo->pInheritanceInfo->renderPass</code> members of the <a href=\"#vkBeginCommandBuffer\">vkBeginCommandBuffer</a> commands used to begin recording each element of <code>pCommandBuffers</code> <strong class=\"purple\">must</strong> be <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteCommands-flags-06026",
|
|
"text": " If <code>vkCmdExecuteCommands</code> is being called within a render pass instance begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>flags</code> member of the <a href=\"#VkCommandBufferInheritanceRenderingInfo\">VkCommandBufferInheritanceRenderingInfo</a> structure included in the <code>pNext</code> chain of <a href=\"#VkCommandBufferBeginInfo\">VkCommandBufferBeginInfo</a>::<code>pInheritanceInfo</code> used to begin recording each element of <code>pCommandBuffers</code> <strong class=\"purple\">must</strong> be equal to the <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>flags</code> parameter to <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, excluding <code>VK_RENDERING_CONTENTS_SECONDARY_COMMAND_BUFFERS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteCommands-colorAttachmentCount-06027",
|
|
"text": " If <code>vkCmdExecuteCommands</code> is being called within a render pass instance begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>colorAttachmentCount</code> member of the <a href=\"#VkCommandBufferInheritanceRenderingInfo\">VkCommandBufferInheritanceRenderingInfo</a> structure included in the <code>pNext</code> chain of <a href=\"#VkCommandBufferBeginInfo\">VkCommandBufferBeginInfo</a>::<code>pInheritanceInfo</code> used to begin recording each element of <code>pCommandBuffers</code> <strong class=\"purple\">must</strong> be equal to the <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>colorAttachmentCount</code> parameter to <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteCommands-imageView-06028",
|
|
"text": " If <code>vkCmdExecuteCommands</code> is being called within a render pass instance begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, if the <code>imageView</code> member of an element of the <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pColorAttachments</code> parameter to <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the corresponding element of the <code>pColorAttachmentFormats</code> member of the <a href=\"#VkCommandBufferInheritanceRenderingInfo\">VkCommandBufferInheritanceRenderingInfo</a> structure included in the <code>pNext</code> chain of <a href=\"#VkCommandBufferBeginInfo\">VkCommandBufferBeginInfo</a>::<code>pInheritanceInfo</code> used to begin recording each element of <code>pCommandBuffers</code> <strong class=\"purple\">must</strong> be equal to the format used to create that image view"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteCommands-pDepthAttachment-06029",
|
|
"text": " If <code>vkCmdExecuteCommands</code> is being called within a render pass instance begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, if the <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code> parameter to <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of the <code>depthAttachmentFormat</code> member of the <a href=\"#VkCommandBufferInheritanceRenderingInfo\">VkCommandBufferInheritanceRenderingInfo</a> structure included in the <code>pNext</code> chain of <a href=\"#VkCommandBufferBeginInfo\">VkCommandBufferBeginInfo</a>::<code>pInheritanceInfo</code> used to begin recording each element of <code>pCommandBuffers</code> <strong class=\"purple\">must</strong> be equal to the format used to create that image view"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteCommands-pStencilAttachment-06030",
|
|
"text": " If <code>vkCmdExecuteCommands</code> is being called within a render pass instance begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, if the <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code> parameter to <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of the <code>stencilAttachmentFormat</code> member of the <a href=\"#VkCommandBufferInheritanceRenderingInfo\">VkCommandBufferInheritanceRenderingInfo</a> structure included in the <code>pNext</code> chain of <a href=\"#VkCommandBufferBeginInfo\">VkCommandBufferBeginInfo</a>::<code>pInheritanceInfo</code> used to begin recording each element of <code>pCommandBuffers</code> <strong class=\"purple\">must</strong> be equal to the format used to create that image view"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteCommands-pDepthAttachment-06774",
|
|
"text": " If <code>vkCmdExecuteCommands</code> is being called within a render pass instance begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and the <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code> parameter to <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> was <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of the <code>depthAttachmentFormat</code> member of the <a href=\"#VkCommandBufferInheritanceRenderingInfo\">VkCommandBufferInheritanceRenderingInfo</a> structure included in the <code>pNext</code> chain of <a href=\"#VkCommandBufferBeginInfo\">VkCommandBufferBeginInfo</a>::<code>pInheritanceInfo</code> used to begin recording each element of <code>pCommandBuffers</code> <strong class=\"purple\">must</strong> be <code>VK_FORMAT_UNDEFINED</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteCommands-pStencilAttachment-06775",
|
|
"text": " If <code>vkCmdExecuteCommands</code> is being called within a render pass instance begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and the <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code> parameter to <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> was <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of the <code>stencilAttachmentFormat</code> member of the <a href=\"#VkCommandBufferInheritanceRenderingInfo\">VkCommandBufferInheritanceRenderingInfo</a> structure included in the <code>pNext</code> chain of <a href=\"#VkCommandBufferBeginInfo\">VkCommandBufferBeginInfo</a>::<code>pInheritanceInfo</code> used to begin recording each element of <code>pCommandBuffers</code> <strong class=\"purple\">must</strong> be <code>VK_FORMAT_UNDEFINED</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_EXT_sample_locations)": [
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteCommands-variableSampleLocations-06023",
|
|
"text": " If the <a href=\"#limits-variableSampleLocations\"><code>variableSampleLocations</code></a> limit is not supported, and any element of <code>pCommandBuffers</code> contains any <a href=\"#renderpass-suspension\">suspended render pass instances</a>, where a graphics pipeline has been bound, any pipelines bound in the render pass instance that resumes it, or any subsequent render pass instances that resume from that one and so on, <strong class=\"purple\">must</strong> use the same sample locations"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_KHR_multiview,VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteCommands-viewMask-06031",
|
|
"text": " If <code>vkCmdExecuteCommands</code> is being called within a render pass instance begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>viewMask</code> member of the <a href=\"#VkCommandBufferInheritanceRenderingInfo\">VkCommandBufferInheritanceRenderingInfo</a> structure included in the <code>pNext</code> chain of <a href=\"#VkCommandBufferBeginInfo\">VkCommandBufferBeginInfo</a>::<code>pInheritanceInfo</code> used to begin recording each element of <code>pCommandBuffers</code> <strong class=\"purple\">must</strong> be equal to the <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>viewMask</code> parameter to <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_AMD_mixed_attachment_samples,VK_NV_framebuffer_mixed_samples)": [
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteCommands-pNext-06032",
|
|
"text": " If <code>vkCmdExecuteCommands</code> is being called within a render pass instance begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and the <code>pNext</code> chain of <a href=\"#VkCommandBufferInheritanceInfo\">VkCommandBufferInheritanceInfo</a> includes a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, if the <code>imageView</code> member of an element of the <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pColorAttachments</code> parameter to <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the corresponding element of the <code>pColorAttachmentSamples</code> member of the <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure included in the <code>pNext</code> chain of <a href=\"#VkCommandBufferBeginInfo\">VkCommandBufferBeginInfo</a>::<code>pInheritanceInfo</code> used to begin recording each element of <code>pCommandBuffers</code> <strong class=\"purple\">must</strong> be equal to the sample count used to create that image view"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteCommands-pNext-06033",
|
|
"text": " If <code>vkCmdExecuteCommands</code> is being called within a render pass instance begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and the <code>pNext</code> chain of <a href=\"#VkCommandBufferInheritanceInfo\">VkCommandBufferInheritanceInfo</a> includes a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, if the <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code> parameter to <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of the <code>depthStencilAttachmentSamples</code> member of the <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure included in the <code>pNext</code> chain of <a href=\"#VkCommandBufferBeginInfo\">VkCommandBufferBeginInfo</a>::<code>pInheritanceInfo</code> used to begin recording each element of <code>pCommandBuffers</code> <strong class=\"purple\">must</strong> be equal to the sample count used to create that image view"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteCommands-pNext-06034",
|
|
"text": " If <code>vkCmdExecuteCommands</code> is being called within a render pass instance begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and the <code>pNext</code> chain of <a href=\"#VkCommandBufferInheritanceInfo\">VkCommandBufferInheritanceInfo</a> includes a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, if the <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code> parameter to <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of the <code>depthStencilAttachmentSamples</code> member of the <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure included in the <code>pNext</code> chain of <a href=\"#VkCommandBufferBeginInfo\">VkCommandBufferBeginInfo</a>::<code>pInheritanceInfo</code> used to begin recording each element of <code>pCommandBuffers</code> <strong class=\"purple\">must</strong> be equal to the sample count used to create that image view"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteCommands-pNext-06035",
|
|
"text": " If <code>vkCmdExecuteCommands</code> is being called within a render pass instance begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and the <code>pNext</code> chain of <a href=\"#VkCommandBufferInheritanceInfo\">VkCommandBufferInheritanceInfo</a> does not include a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, if the <code>imageView</code> member of an element of the <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pColorAttachments</code> parameter to <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of <a href=\"#VkCommandBufferInheritanceRenderingInfo\">VkCommandBufferInheritanceRenderingInfo</a>::<code>rasterizationSamples</code> <strong class=\"purple\">must</strong> be equal to the sample count used to create that image view"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteCommands-pNext-06036",
|
|
"text": " If <code>vkCmdExecuteCommands</code> is being called within a render pass instance begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and the <code>pNext</code> chain of <a href=\"#VkCommandBufferInheritanceInfo\">VkCommandBufferInheritanceInfo</a> does not include a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, if the <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code> parameter to <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of <a href=\"#VkCommandBufferInheritanceRenderingInfo\">VkCommandBufferInheritanceRenderingInfo</a>::<code>rasterizationSamples</code> <strong class=\"purple\">must</strong> be equal to the sample count used to create that image view"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteCommands-pNext-06037",
|
|
"text": " If <code>vkCmdExecuteCommands</code> is being called within a render pass instance begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and the <code>pNext</code> chain of <a href=\"#VkCommandBufferInheritanceInfo\">VkCommandBufferInheritanceInfo</a> does not include a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, if the <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code> parameter to <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of <a href=\"#VkCommandBufferInheritanceRenderingInfo\">VkCommandBufferInheritanceRenderingInfo</a>::<code>rasterizationSamples</code> <strong class=\"purple\">must</strong> be equal to the sample count used to create that image view"
|
|
}
|
|
]
|
|
},
|
|
"VkDeviceGroupCommandBufferBeginInfo": {
|
|
"(VK_VERSION_1_1,VK_KHR_device_group)": [
|
|
{
|
|
"vuid": "VUID-VkDeviceGroupCommandBufferBeginInfo-deviceMask-00106",
|
|
"text": " <code>deviceMask</code> <strong class=\"purple\">must</strong> be a valid device mask value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceGroupCommandBufferBeginInfo-deviceMask-00107",
|
|
"text": " <code>deviceMask</code> <strong class=\"purple\">must</strong> not be zero"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceGroupCommandBufferBeginInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_DEVICE_GROUP_COMMAND_BUFFER_BEGIN_INFO</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdSetDeviceMask": {
|
|
"(VK_VERSION_1_1,VK_KHR_device_group)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetDeviceMask-deviceMask-00108",
|
|
"text": " <code>deviceMask</code> <strong class=\"purple\">must</strong> be a valid device mask value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetDeviceMask-deviceMask-00109",
|
|
"text": " <code>deviceMask</code> <strong class=\"purple\">must</strong> not be zero"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetDeviceMask-deviceMask-00110",
|
|
"text": " <code>deviceMask</code> <strong class=\"purple\">must</strong> not include any set bits that were not in the <a href=\"#VkDeviceGroupCommandBufferBeginInfo\">VkDeviceGroupCommandBufferBeginInfo</a>::<code>deviceMask</code> value when the command buffer began recording"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetDeviceMask-deviceMask-00111",
|
|
"text": " If <code>vkCmdSetDeviceMask</code> is called inside a render pass instance, <code>deviceMask</code> <strong class=\"purple\">must</strong> not include any set bits that were not in the <a href=\"#VkDeviceGroupRenderPassBeginInfo\">VkDeviceGroupRenderPassBeginInfo</a>::<code>deviceMask</code> value when the render pass instance began recording"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetDeviceMask-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetDeviceMask-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetDeviceMask-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics, compute, or transfer operations"
|
|
}
|
|
]
|
|
},
|
|
"vkCreateFence": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCreateFence-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateFence-pCreateInfo-parameter",
|
|
"text": " <code>pCreateInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkFenceCreateInfo\">VkFenceCreateInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateFence-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateFence-pFence-parameter",
|
|
"text": " <code>pFence</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkFence\">VkFence</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkFenceCreateInfo": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkFenceCreateInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_FENCE_CREATE_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFenceCreateInfo-pNext-pNext",
|
|
"text": " Each <code>pNext</code> member of any structure (including this one) in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be either <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkExportFenceCreateInfo\">VkExportFenceCreateInfo</a> or <a href=\"#VkExportFenceWin32HandleInfoKHR\">VkExportFenceWin32HandleInfoKHR</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFenceCreateInfo-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFenceCreateInfo-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkFenceCreateFlagBits\">VkFenceCreateFlagBits</a> values"
|
|
}
|
|
]
|
|
},
|
|
"VkExportFenceCreateInfo": {
|
|
"(VK_VERSION_1_1,VK_KHR_external_fence)": [
|
|
{
|
|
"vuid": "VUID-VkExportFenceCreateInfo-handleTypes-01446",
|
|
"text": " The bits in <code>handleTypes</code> <strong class=\"purple\">must</strong> be supported and compatible, as reported by <a href=\"#VkExternalFenceProperties\">VkExternalFenceProperties</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkExportFenceCreateInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_EXPORT_FENCE_CREATE_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkExportFenceCreateInfo-handleTypes-parameter",
|
|
"text": " <code>handleTypes</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkExternalFenceHandleTypeFlagBits\">VkExternalFenceHandleTypeFlagBits</a> values"
|
|
}
|
|
]
|
|
},
|
|
"VkExportFenceWin32HandleInfoKHR": {
|
|
"(VK_KHR_external_fence_win32)": [
|
|
{
|
|
"vuid": "VUID-VkExportFenceWin32HandleInfoKHR-handleTypes-01447",
|
|
"text": " If <a href=\"#VkExportFenceCreateInfo\">VkExportFenceCreateInfo</a>::<code>handleTypes</code> does not include <code>VK_EXTERNAL_FENCE_HANDLE_TYPE_OPAQUE_WIN32_BIT</code>, a <code>VkExportFenceWin32HandleInfoKHR</code> structure <strong class=\"purple\">must</strong> not be included in the <code>pNext</code> chain of <a href=\"#VkFenceCreateInfo\">VkFenceCreateInfo</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkExportFenceWin32HandleInfoKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_EXPORT_FENCE_WIN32_HANDLE_INFO_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkExportFenceWin32HandleInfoKHR-pAttributes-parameter",
|
|
"text": " If <code>pAttributes</code> is not <code>NULL</code>, <code>pAttributes</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <code>SECURITY_ATTRIBUTES</code> value"
|
|
}
|
|
]
|
|
},
|
|
"vkGetFenceWin32HandleKHR": {
|
|
"(VK_KHR_external_fence_win32)": [
|
|
{
|
|
"vuid": "VUID-vkGetFenceWin32HandleKHR-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetFenceWin32HandleKHR-pGetWin32HandleInfo-parameter",
|
|
"text": " <code>pGetWin32HandleInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkFenceGetWin32HandleInfoKHR\">VkFenceGetWin32HandleInfoKHR</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetFenceWin32HandleKHR-pHandle-parameter",
|
|
"text": " <code>pHandle</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>HANDLE</code> value"
|
|
}
|
|
]
|
|
},
|
|
"VkFenceGetWin32HandleInfoKHR": {
|
|
"(VK_KHR_external_fence_win32)": [
|
|
{
|
|
"vuid": "VUID-VkFenceGetWin32HandleInfoKHR-handleType-01448",
|
|
"text": " <code>handleType</code> <strong class=\"purple\">must</strong> have been included in <a href=\"#VkExportFenceCreateInfo\">VkExportFenceCreateInfo</a>::<code>handleTypes</code> when the <code>fence</code>’s current payload was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFenceGetWin32HandleInfoKHR-handleType-01449",
|
|
"text": " If <code>handleType</code> is defined as an NT handle, <a href=\"#vkGetFenceWin32HandleKHR\">vkGetFenceWin32HandleKHR</a> <strong class=\"purple\">must</strong> be called no more than once for each valid unique combination of <code>fence</code> and <code>handleType</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFenceGetWin32HandleInfoKHR-fence-01450",
|
|
"text": " <code>fence</code> <strong class=\"purple\">must</strong> not currently have its payload replaced by an imported payload as described below in <a href=\"#synchronization-fences-importing\">Importing Fence Payloads</a> unless that imported payload’s handle type was included in <a href=\"#VkExternalFenceProperties\">VkExternalFenceProperties</a>::<code>exportFromImportedHandleTypes</code> for <code>handleType</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFenceGetWin32HandleInfoKHR-handleType-01451",
|
|
"text": " If <code>handleType</code> refers to a handle type with copy payload transference semantics, <code>fence</code> <strong class=\"purple\">must</strong> be signaled, or have an associated <a href=\"#synchronization-fences-signaling\">fence signal operation</a> pending execution"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFenceGetWin32HandleInfoKHR-handleType-01452",
|
|
"text": " <code>handleType</code> <strong class=\"purple\">must</strong> be defined as an NT handle or a global share handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFenceGetWin32HandleInfoKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_FENCE_GET_WIN32_HANDLE_INFO_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFenceGetWin32HandleInfoKHR-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFenceGetWin32HandleInfoKHR-fence-parameter",
|
|
"text": " <code>fence</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkFence\">VkFence</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFenceGetWin32HandleInfoKHR-handleType-parameter",
|
|
"text": " <code>handleType</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkExternalFenceHandleTypeFlagBits\">VkExternalFenceHandleTypeFlagBits</a> value"
|
|
}
|
|
]
|
|
},
|
|
"vkGetFenceFdKHR": {
|
|
"(VK_KHR_external_fence_fd)": [
|
|
{
|
|
"vuid": "VUID-vkGetFenceFdKHR-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetFenceFdKHR-pGetFdInfo-parameter",
|
|
"text": " <code>pGetFdInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkFenceGetFdInfoKHR\">VkFenceGetFdInfoKHR</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetFenceFdKHR-pFd-parameter",
|
|
"text": " <code>pFd</code> <strong class=\"purple\">must</strong> be a valid pointer to an <code>int</code> value"
|
|
}
|
|
]
|
|
},
|
|
"VkFenceGetFdInfoKHR": {
|
|
"(VK_KHR_external_fence_fd)": [
|
|
{
|
|
"vuid": "VUID-VkFenceGetFdInfoKHR-handleType-01453",
|
|
"text": " <code>handleType</code> <strong class=\"purple\">must</strong> have been included in <a href=\"#VkExportFenceCreateInfo\">VkExportFenceCreateInfo</a>::<code>handleTypes</code> when <code>fence</code>’s current payload was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFenceGetFdInfoKHR-handleType-01454",
|
|
"text": " If <code>handleType</code> refers to a handle type with copy payload transference semantics, <code>fence</code> <strong class=\"purple\">must</strong> be signaled, or have an associated <a href=\"#synchronization-fences-signaling\">fence signal operation</a> pending execution"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFenceGetFdInfoKHR-fence-01455",
|
|
"text": " <code>fence</code> <strong class=\"purple\">must</strong> not currently have its payload replaced by an imported payload as described below in <a href=\"#synchronization-fences-importing\">Importing Fence Payloads</a> unless that imported payload’s handle type was included in <a href=\"#VkExternalFenceProperties\">VkExternalFenceProperties</a>::<code>exportFromImportedHandleTypes</code> for <code>handleType</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFenceGetFdInfoKHR-handleType-01456",
|
|
"text": " <code>handleType</code> <strong class=\"purple\">must</strong> be defined as a POSIX file descriptor handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFenceGetFdInfoKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_FENCE_GET_FD_INFO_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFenceGetFdInfoKHR-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFenceGetFdInfoKHR-fence-parameter",
|
|
"text": " <code>fence</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkFence\">VkFence</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFenceGetFdInfoKHR-handleType-parameter",
|
|
"text": " <code>handleType</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkExternalFenceHandleTypeFlagBits\">VkExternalFenceHandleTypeFlagBits</a> value"
|
|
}
|
|
]
|
|
},
|
|
"vkDestroyFence": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkDestroyFence-fence-01120",
|
|
"text": " All <a href=\"#devsandqueues-submission\">queue submission</a> commands that refer to <code>fence</code> <strong class=\"purple\">must</strong> have completed execution"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyFence-fence-01121",
|
|
"text": " If <code>VkAllocationCallbacks</code> were provided when <code>fence</code> was created, a compatible set of callbacks <strong class=\"purple\">must</strong> be provided here"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyFence-fence-01122",
|
|
"text": " If no <code>VkAllocationCallbacks</code> were provided when <code>fence</code> was created, <code>pAllocator</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyFence-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyFence-fence-parameter",
|
|
"text": " If <code>fence</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>fence</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkFence\">VkFence</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyFence-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyFence-fence-parent",
|
|
"text": " If <code>fence</code> is a valid handle, it <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetFenceStatus": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkGetFenceStatus-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetFenceStatus-fence-parameter",
|
|
"text": " <code>fence</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkFence\">VkFence</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetFenceStatus-fence-parent",
|
|
"text": " <code>fence</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkResetFences": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkResetFences-pFences-01123",
|
|
"text": " Each element of <code>pFences</code> <strong class=\"purple\">must</strong> not be currently associated with any queue command that has not yet completed execution on that queue"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkResetFences-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkResetFences-pFences-parameter",
|
|
"text": " <code>pFences</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>fenceCount</code> valid <a href=\"#VkFence\">VkFence</a> handles"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkResetFences-fenceCount-arraylength",
|
|
"text": " <code>fenceCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkResetFences-pFences-parent",
|
|
"text": " Each element of <code>pFences</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkWaitForFences": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkWaitForFences-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkWaitForFences-pFences-parameter",
|
|
"text": " <code>pFences</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>fenceCount</code> valid <a href=\"#VkFence\">VkFence</a> handles"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkWaitForFences-fenceCount-arraylength",
|
|
"text": " <code>fenceCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkWaitForFences-pFences-parent",
|
|
"text": " Each element of <code>pFences</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkRegisterDeviceEventEXT": {
|
|
"(VK_EXT_display_control)": [
|
|
{
|
|
"vuid": "VUID-vkRegisterDeviceEventEXT-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkRegisterDeviceEventEXT-pDeviceEventInfo-parameter",
|
|
"text": " <code>pDeviceEventInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkDeviceEventInfoEXT\">VkDeviceEventInfoEXT</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkRegisterDeviceEventEXT-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkRegisterDeviceEventEXT-pFence-parameter",
|
|
"text": " <code>pFence</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkFence\">VkFence</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkDeviceEventInfoEXT": {
|
|
"(VK_EXT_display_control)": [
|
|
{
|
|
"vuid": "VUID-VkDeviceEventInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_DEVICE_EVENT_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceEventInfoEXT-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceEventInfoEXT-deviceEvent-parameter",
|
|
"text": " <code>deviceEvent</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDeviceEventTypeEXT\">VkDeviceEventTypeEXT</a> value"
|
|
}
|
|
]
|
|
},
|
|
"vkRegisterDisplayEventEXT": {
|
|
"(VK_EXT_display_control)": [
|
|
{
|
|
"vuid": "VUID-vkRegisterDisplayEventEXT-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkRegisterDisplayEventEXT-display-parameter",
|
|
"text": " <code>display</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDisplayKHR\">VkDisplayKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkRegisterDisplayEventEXT-pDisplayEventInfo-parameter",
|
|
"text": " <code>pDisplayEventInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkDisplayEventInfoEXT\">VkDisplayEventInfoEXT</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkRegisterDisplayEventEXT-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkRegisterDisplayEventEXT-pFence-parameter",
|
|
"text": " <code>pFence</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkFence\">VkFence</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkRegisterDisplayEventEXT-commonparent",
|
|
"text": " Both of <code>device</code>, and <code>display</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a>"
|
|
}
|
|
]
|
|
},
|
|
"VkDisplayEventInfoEXT": {
|
|
"(VK_EXT_display_control)": [
|
|
{
|
|
"vuid": "VUID-VkDisplayEventInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_DISPLAY_EVENT_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDisplayEventInfoEXT-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDisplayEventInfoEXT-displayEvent-parameter",
|
|
"text": " <code>displayEvent</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDisplayEventTypeEXT\">VkDisplayEventTypeEXT</a> value"
|
|
}
|
|
]
|
|
},
|
|
"vkImportFenceWin32HandleKHR": {
|
|
"(VK_KHR_external_fence_win32)": [
|
|
{
|
|
"vuid": "VUID-vkImportFenceWin32HandleKHR-fence-04448",
|
|
"text": " <code>fence</code> <strong class=\"purple\">must</strong> not be associated with any queue command that has not yet completed execution on that queue"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkImportFenceWin32HandleKHR-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkImportFenceWin32HandleKHR-pImportFenceWin32HandleInfo-parameter",
|
|
"text": " <code>pImportFenceWin32HandleInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkImportFenceWin32HandleInfoKHR\">VkImportFenceWin32HandleInfoKHR</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkImportFenceWin32HandleInfoKHR": {
|
|
"(VK_KHR_external_fence_win32)": [
|
|
{
|
|
"vuid": "VUID-VkImportFenceWin32HandleInfoKHR-handleType-01457",
|
|
"text": " <code>handleType</code> <strong class=\"purple\">must</strong> be a value included in the <a href=\"#synchronization-fence-handletypes-win32\">Handle Types Supported by <code>VkImportFenceWin32HandleInfoKHR</code></a> table"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportFenceWin32HandleInfoKHR-handleType-01459",
|
|
"text": " If <code>handleType</code> is not <code>VK_EXTERNAL_FENCE_HANDLE_TYPE_OPAQUE_WIN32_BIT</code>, <code>name</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportFenceWin32HandleInfoKHR-handleType-01460",
|
|
"text": " If <code>handle</code> is <code>NULL</code>, <code>name</code> <strong class=\"purple\">must</strong> name a valid synchronization primitive of the type specified by <code>handleType</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportFenceWin32HandleInfoKHR-handleType-01461",
|
|
"text": " If <code>name</code> is <code>NULL</code>, <code>handle</code> <strong class=\"purple\">must</strong> be a valid handle of the type specified by <code>handleType</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportFenceWin32HandleInfoKHR-handle-01462",
|
|
"text": " If <code>handle</code> is not <code>NULL</code>, <code>name</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportFenceWin32HandleInfoKHR-handle-01539",
|
|
"text": " If <code>handle</code> is not <code>NULL</code>, it <strong class=\"purple\">must</strong> obey any requirements listed for <code>handleType</code> in <a href=\"#external-fence-handle-types-compatibility\">external fence handle types compatibility</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportFenceWin32HandleInfoKHR-name-01540",
|
|
"text": " If <code>name</code> is not <code>NULL</code>, it <strong class=\"purple\">must</strong> obey any requirements listed for <code>handleType</code> in <a href=\"#external-fence-handle-types-compatibility\">external fence handle types compatibility</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportFenceWin32HandleInfoKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_IMPORT_FENCE_WIN32_HANDLE_INFO_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportFenceWin32HandleInfoKHR-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportFenceWin32HandleInfoKHR-fence-parameter",
|
|
"text": " <code>fence</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkFence\">VkFence</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportFenceWin32HandleInfoKHR-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkFenceImportFlagBits\">VkFenceImportFlagBits</a> values"
|
|
}
|
|
]
|
|
},
|
|
"vkImportFenceFdKHR": {
|
|
"(VK_KHR_external_fence_fd)": [
|
|
{
|
|
"vuid": "VUID-vkImportFenceFdKHR-fence-01463",
|
|
"text": " <code>fence</code> <strong class=\"purple\">must</strong> not be associated with any queue command that has not yet completed execution on that queue"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkImportFenceFdKHR-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkImportFenceFdKHR-pImportFenceFdInfo-parameter",
|
|
"text": " <code>pImportFenceFdInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkImportFenceFdInfoKHR\">VkImportFenceFdInfoKHR</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkImportFenceFdInfoKHR": {
|
|
"(VK_KHR_external_fence_fd)": [
|
|
{
|
|
"vuid": "VUID-VkImportFenceFdInfoKHR-handleType-01464",
|
|
"text": " <code>handleType</code> <strong class=\"purple\">must</strong> be a value included in the <a href=\"#synchronization-fence-handletypes-fd\">Handle Types Supported by <code>VkImportFenceFdInfoKHR</code></a> table"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportFenceFdInfoKHR-fd-01541",
|
|
"text": " <code>fd</code> <strong class=\"purple\">must</strong> obey any requirements listed for <code>handleType</code> in <a href=\"#external-fence-handle-types-compatibility\">external fence handle types compatibility</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportFenceFdInfoKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_IMPORT_FENCE_FD_INFO_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportFenceFdInfoKHR-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportFenceFdInfoKHR-fence-parameter",
|
|
"text": " <code>fence</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkFence\">VkFence</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportFenceFdInfoKHR-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkFenceImportFlagBits\">VkFenceImportFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportFenceFdInfoKHR-handleType-parameter",
|
|
"text": " <code>handleType</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkExternalFenceHandleTypeFlagBits\">VkExternalFenceHandleTypeFlagBits</a> value"
|
|
}
|
|
]
|
|
},
|
|
"vkCreateSemaphore": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCreateSemaphore-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateSemaphore-pCreateInfo-parameter",
|
|
"text": " <code>pCreateInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkSemaphoreCreateInfo\">VkSemaphoreCreateInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateSemaphore-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateSemaphore-pSemaphore-parameter",
|
|
"text": " <code>pSemaphore</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkSemaphore\">VkSemaphore</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkSemaphoreCreateInfo": {
|
|
"(VK_EXT_metal_objects)": [
|
|
{
|
|
"vuid": "VUID-VkSemaphoreCreateInfo-pNext-06789",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkExportMetalObjectCreateInfoEXT\">VkExportMetalObjectCreateInfoEXT</a> structure, its <code>exportObjectType</code> member <strong class=\"purple\">must</strong> be <code>VK_EXPORT_METAL_OBJECT_TYPE_METAL_SHARED_EVENT_BIT_EXT</code>."
|
|
}
|
|
],
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkSemaphoreCreateInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_SEMAPHORE_CREATE_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSemaphoreCreateInfo-pNext-pNext",
|
|
"text": " Each <code>pNext</code> member of any structure (including this one) in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be either <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkExportMetalObjectCreateInfoEXT\">VkExportMetalObjectCreateInfoEXT</a>, <a href=\"#VkExportSemaphoreCreateInfo\">VkExportSemaphoreCreateInfo</a>, <a href=\"#VkExportSemaphoreWin32HandleInfoKHR\">VkExportSemaphoreWin32HandleInfoKHR</a>, <a href=\"#VkImportMetalSharedEventInfoEXT\">VkImportMetalSharedEventInfoEXT</a>, or <a href=\"#VkSemaphoreTypeCreateInfo\">VkSemaphoreTypeCreateInfo</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSemaphoreCreateInfo-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique, with the exception of structures of type <a href=\"#VkExportMetalObjectCreateInfoEXT\">VkExportMetalObjectCreateInfoEXT</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSemaphoreCreateInfo-flags-zerobitmask",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkSemaphoreTypeCreateInfo": {
|
|
"(VK_VERSION_1_2,VK_KHR_timeline_semaphore)": [
|
|
{
|
|
"vuid": "VUID-VkSemaphoreTypeCreateInfo-timelineSemaphore-03252",
|
|
"text": " If the <a href=\"#features-timelineSemaphore\"><code>timelineSemaphore</code></a> feature is not enabled, <code>semaphoreType</code> <strong class=\"purple\">must</strong> not equal <code>VK_SEMAPHORE_TYPE_TIMELINE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSemaphoreTypeCreateInfo-semaphoreType-03279",
|
|
"text": " If <code>semaphoreType</code> is <code>VK_SEMAPHORE_TYPE_BINARY</code>, <code>initialValue</code> <strong class=\"purple\">must</strong> be zero"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSemaphoreTypeCreateInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_SEMAPHORE_TYPE_CREATE_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSemaphoreTypeCreateInfo-semaphoreType-parameter",
|
|
"text": " <code>semaphoreType</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSemaphoreType\">VkSemaphoreType</a> value"
|
|
}
|
|
]
|
|
},
|
|
"VkExportSemaphoreCreateInfo": {
|
|
"(VK_VERSION_1_1,VK_KHR_external_semaphore)": [
|
|
{
|
|
"vuid": "VUID-VkExportSemaphoreCreateInfo-handleTypes-01124",
|
|
"text": " The bits in <code>handleTypes</code> <strong class=\"purple\">must</strong> be supported and compatible, as reported by <a href=\"#VkExternalSemaphoreProperties\">VkExternalSemaphoreProperties</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkExportSemaphoreCreateInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_EXPORT_SEMAPHORE_CREATE_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkExportSemaphoreCreateInfo-handleTypes-parameter",
|
|
"text": " <code>handleTypes</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkExternalSemaphoreHandleTypeFlagBits\">VkExternalSemaphoreHandleTypeFlagBits</a> values"
|
|
}
|
|
]
|
|
},
|
|
"VkExportSemaphoreWin32HandleInfoKHR": {
|
|
"(VK_KHR_external_semaphore_win32)": [
|
|
{
|
|
"vuid": "VUID-VkExportSemaphoreWin32HandleInfoKHR-handleTypes-01125",
|
|
"text": " If <a href=\"#VkExportSemaphoreCreateInfo\">VkExportSemaphoreCreateInfo</a>::<code>handleTypes</code> does not include <code>VK_EXTERNAL_SEMAPHORE_HANDLE_TYPE_OPAQUE_WIN32_BIT</code> or <code>VK_EXTERNAL_SEMAPHORE_HANDLE_TYPE_D3D12_FENCE_BIT</code>, <code>VkExportSemaphoreWin32HandleInfoKHR</code> <strong class=\"purple\">must</strong> not be included in the <code>pNext</code> chain of <a href=\"#VkSemaphoreCreateInfo\">VkSemaphoreCreateInfo</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkExportSemaphoreWin32HandleInfoKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_EXPORT_SEMAPHORE_WIN32_HANDLE_INFO_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkExportSemaphoreWin32HandleInfoKHR-pAttributes-parameter",
|
|
"text": " If <code>pAttributes</code> is not <code>NULL</code>, <code>pAttributes</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <code>SECURITY_ATTRIBUTES</code> value"
|
|
}
|
|
]
|
|
},
|
|
"vkGetSemaphoreWin32HandleKHR": {
|
|
"(VK_KHR_external_semaphore_win32)": [
|
|
{
|
|
"vuid": "VUID-vkGetSemaphoreWin32HandleKHR-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetSemaphoreWin32HandleKHR-pGetWin32HandleInfo-parameter",
|
|
"text": " <code>pGetWin32HandleInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkSemaphoreGetWin32HandleInfoKHR\">VkSemaphoreGetWin32HandleInfoKHR</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetSemaphoreWin32HandleKHR-pHandle-parameter",
|
|
"text": " <code>pHandle</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>HANDLE</code> value"
|
|
}
|
|
]
|
|
},
|
|
"VkSemaphoreGetWin32HandleInfoKHR": {
|
|
"(VK_KHR_external_semaphore_win32)": [
|
|
{
|
|
"vuid": "VUID-VkSemaphoreGetWin32HandleInfoKHR-handleType-01126",
|
|
"text": " <code>handleType</code> <strong class=\"purple\">must</strong> have been included in <a href=\"#VkExportSemaphoreCreateInfo\">VkExportSemaphoreCreateInfo</a>::<code>handleTypes</code> when the <code>semaphore</code>’s current payload was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSemaphoreGetWin32HandleInfoKHR-handleType-01127",
|
|
"text": " If <code>handleType</code> is defined as an NT handle, <a href=\"#vkGetSemaphoreWin32HandleKHR\">vkGetSemaphoreWin32HandleKHR</a> <strong class=\"purple\">must</strong> be called no more than once for each valid unique combination of <code>semaphore</code> and <code>handleType</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSemaphoreGetWin32HandleInfoKHR-semaphore-01128",
|
|
"text": " <code>semaphore</code> <strong class=\"purple\">must</strong> not currently have its payload replaced by an imported payload as described below in <a href=\"#synchronization-semaphores-importing\">Importing Semaphore Payloads</a> unless that imported payload’s handle type was included in <a href=\"#VkExternalSemaphoreProperties\">VkExternalSemaphoreProperties</a>::<code>exportFromImportedHandleTypes</code> for <code>handleType</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSemaphoreGetWin32HandleInfoKHR-handleType-01129",
|
|
"text": " If <code>handleType</code> refers to a handle type with copy payload transference semantics, as defined below in <a href=\"#synchronization-semaphores-importing\">Importing Semaphore Payloads</a>, there <strong class=\"purple\">must</strong> be no queue waiting on <code>semaphore</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSemaphoreGetWin32HandleInfoKHR-handleType-01130",
|
|
"text": " If <code>handleType</code> refers to a handle type with copy payload transference semantics, <code>semaphore</code> <strong class=\"purple\">must</strong> be signaled, or have an associated <a href=\"#synchronization-semaphores-signaling\">semaphore signal operation</a> pending execution"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSemaphoreGetWin32HandleInfoKHR-handleType-01131",
|
|
"text": " <code>handleType</code> <strong class=\"purple\">must</strong> be defined as an NT handle or a global share handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSemaphoreGetWin32HandleInfoKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_SEMAPHORE_GET_WIN32_HANDLE_INFO_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSemaphoreGetWin32HandleInfoKHR-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSemaphoreGetWin32HandleInfoKHR-semaphore-parameter",
|
|
"text": " <code>semaphore</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSemaphore\">VkSemaphore</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSemaphoreGetWin32HandleInfoKHR-handleType-parameter",
|
|
"text": " <code>handleType</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkExternalSemaphoreHandleTypeFlagBits\">VkExternalSemaphoreHandleTypeFlagBits</a> value"
|
|
}
|
|
]
|
|
},
|
|
"vkGetSemaphoreFdKHR": {
|
|
"(VK_KHR_external_semaphore_fd)": [
|
|
{
|
|
"vuid": "VUID-vkGetSemaphoreFdKHR-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetSemaphoreFdKHR-pGetFdInfo-parameter",
|
|
"text": " <code>pGetFdInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkSemaphoreGetFdInfoKHR\">VkSemaphoreGetFdInfoKHR</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetSemaphoreFdKHR-pFd-parameter",
|
|
"text": " <code>pFd</code> <strong class=\"purple\">must</strong> be a valid pointer to an <code>int</code> value"
|
|
}
|
|
]
|
|
},
|
|
"VkSemaphoreGetFdInfoKHR": {
|
|
"(VK_KHR_external_semaphore_fd)": [
|
|
{
|
|
"vuid": "VUID-VkSemaphoreGetFdInfoKHR-handleType-01132",
|
|
"text": " <code>handleType</code> <strong class=\"purple\">must</strong> have been included in <a href=\"#VkExportSemaphoreCreateInfo\">VkExportSemaphoreCreateInfo</a>::<code>handleTypes</code> when <code>semaphore</code>’s current payload was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSemaphoreGetFdInfoKHR-semaphore-01133",
|
|
"text": " <code>semaphore</code> <strong class=\"purple\">must</strong> not currently have its payload replaced by an imported payload as described below in <a href=\"#synchronization-semaphores-importing\">Importing Semaphore Payloads</a> unless that imported payload’s handle type was included in <a href=\"#VkExternalSemaphoreProperties\">VkExternalSemaphoreProperties</a>::<code>exportFromImportedHandleTypes</code> for <code>handleType</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSemaphoreGetFdInfoKHR-handleType-01134",
|
|
"text": " If <code>handleType</code> refers to a handle type with copy payload transference semantics, as defined below in <a href=\"#synchronization-semaphores-importing\">Importing Semaphore Payloads</a>, there <strong class=\"purple\">must</strong> be no queue waiting on <code>semaphore</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSemaphoreGetFdInfoKHR-handleType-01135",
|
|
"text": " If <code>handleType</code> refers to a handle type with copy payload transference semantics, <code>semaphore</code> <strong class=\"purple\">must</strong> be signaled, or have an associated <a href=\"#synchronization-semaphores-signaling\">semaphore signal operation</a> pending execution"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSemaphoreGetFdInfoKHR-handleType-01136",
|
|
"text": " <code>handleType</code> <strong class=\"purple\">must</strong> be defined as a POSIX file descriptor handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSemaphoreGetFdInfoKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_SEMAPHORE_GET_FD_INFO_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSemaphoreGetFdInfoKHR-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSemaphoreGetFdInfoKHR-semaphore-parameter",
|
|
"text": " <code>semaphore</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSemaphore\">VkSemaphore</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSemaphoreGetFdInfoKHR-handleType-parameter",
|
|
"text": " <code>handleType</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkExternalSemaphoreHandleTypeFlagBits\">VkExternalSemaphoreHandleTypeFlagBits</a> value"
|
|
}
|
|
],
|
|
"(VK_KHR_external_semaphore_fd)+(VK_VERSION_1_2,VK_KHR_timeline_semaphore)": [
|
|
{
|
|
"vuid": "VUID-VkSemaphoreGetFdInfoKHR-handleType-03253",
|
|
"text": " If <code>handleType</code> refers to a handle type with copy payload transference semantics, <code>semaphore</code> <strong class=\"purple\">must</strong> have been created with a <a href=\"#VkSemaphoreType\">VkSemaphoreType</a> of <code>VK_SEMAPHORE_TYPE_BINARY</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSemaphoreGetFdInfoKHR-handleType-03254",
|
|
"text": " If <code>handleType</code> refers to a handle type with copy payload transference semantics, <code>semaphore</code> <strong class=\"purple\">must</strong> have an associated semaphore signal operation that has been submitted for execution and any semaphore signal operations on which it depends (if any) <strong class=\"purple\">must</strong> have also been submitted for execution"
|
|
}
|
|
]
|
|
},
|
|
"vkGetSemaphoreZirconHandleFUCHSIA": {
|
|
"(VK_FUCHSIA_external_semaphore)": [
|
|
{
|
|
"vuid": "VUID-vkGetSemaphoreZirconHandleFUCHSIA-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetSemaphoreZirconHandleFUCHSIA-pGetZirconHandleInfo-parameter",
|
|
"text": " <code>pGetZirconHandleInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkSemaphoreGetZirconHandleInfoFUCHSIA\">VkSemaphoreGetZirconHandleInfoFUCHSIA</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetSemaphoreZirconHandleFUCHSIA-pZirconHandle-parameter",
|
|
"text": " <code>pZirconHandle</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>zx_handle_t</code> value"
|
|
}
|
|
]
|
|
},
|
|
"VkSemaphoreGetZirconHandleInfoFUCHSIA": {
|
|
"(VK_FUCHSIA_external_semaphore)": [
|
|
{
|
|
"vuid": "VUID-VkSemaphoreGetZirconHandleInfoFUCHSIA-handleType-04758",
|
|
"text": " <code>handleType</code> <strong class=\"purple\">must</strong> have been included in <a href=\"#VkExportSemaphoreCreateInfo\">VkExportSemaphoreCreateInfo</a>::<code>handleTypes</code> when <code>semaphore</code>’s current payload was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSemaphoreGetZirconHandleInfoFUCHSIA-semaphore-04759",
|
|
"text": " <code>semaphore</code> <strong class=\"purple\">must</strong> not currently have its payload replaced by an imported payload as described below in <a href=\"#synchronization-semaphores-importing\">Importing Semaphore Payloads</a> unless that imported payload’s handle type was included in <a href=\"#VkExternalSemaphoreProperties\">VkExternalSemaphoreProperties</a>::<code>exportFromImportedHandleTypes</code> for <code>handleType</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSemaphoreGetZirconHandleInfoFUCHSIA-handleType-04760",
|
|
"text": " If <code>handleType</code> refers to a handle type with copy payload transference semantics, as defined below in <a href=\"#synchronization-semaphores-importing\">Importing Semaphore Payloads</a>, there <strong class=\"purple\">must</strong> be no queue waiting on <code>semaphore</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSemaphoreGetZirconHandleInfoFUCHSIA-handleType-04761",
|
|
"text": " If <code>handleType</code> refers to a handle type with copy payload transference semantics, <code>semaphore</code> <strong class=\"purple\">must</strong> be signaled, or have an associated <a href=\"#synchronization-semaphores-signaling\">semaphore signal operation</a> pending execution"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSemaphoreGetZirconHandleInfoFUCHSIA-handleType-04762",
|
|
"text": " <code>handleType</code> <strong class=\"purple\">must</strong> be defined as a Zircon event handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSemaphoreGetZirconHandleInfoFUCHSIA-semaphore-04763",
|
|
"text": " <code>semaphore</code> <strong class=\"purple\">must</strong> have been created with a <a href=\"#VkSemaphoreType\">VkSemaphoreType</a> of <code>VK_SEMAPHORE_TYPE_BINARY</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSemaphoreGetZirconHandleInfoFUCHSIA-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_SEMAPHORE_GET_ZIRCON_HANDLE_INFO_FUCHSIA</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSemaphoreGetZirconHandleInfoFUCHSIA-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSemaphoreGetZirconHandleInfoFUCHSIA-semaphore-parameter",
|
|
"text": " <code>semaphore</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSemaphore\">VkSemaphore</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSemaphoreGetZirconHandleInfoFUCHSIA-handleType-parameter",
|
|
"text": " <code>handleType</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkExternalSemaphoreHandleTypeFlagBits\">VkExternalSemaphoreHandleTypeFlagBits</a> value"
|
|
}
|
|
]
|
|
},
|
|
"vkDestroySemaphore": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkDestroySemaphore-semaphore-01137",
|
|
"text": " All submitted batches that refer to <code>semaphore</code> <strong class=\"purple\">must</strong> have completed execution"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroySemaphore-semaphore-01138",
|
|
"text": " If <code>VkAllocationCallbacks</code> were provided when <code>semaphore</code> was created, a compatible set of callbacks <strong class=\"purple\">must</strong> be provided here"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroySemaphore-semaphore-01139",
|
|
"text": " If no <code>VkAllocationCallbacks</code> were provided when <code>semaphore</code> was created, <code>pAllocator</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroySemaphore-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroySemaphore-semaphore-parameter",
|
|
"text": " If <code>semaphore</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>semaphore</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSemaphore\">VkSemaphore</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroySemaphore-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroySemaphore-semaphore-parent",
|
|
"text": " If <code>semaphore</code> is a valid handle, it <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetSemaphoreCounterValue": {
|
|
"(VK_VERSION_1_2,VK_KHR_timeline_semaphore)": [
|
|
{
|
|
"vuid": "VUID-vkGetSemaphoreCounterValue-semaphore-03255",
|
|
"text": " <code>semaphore</code> <strong class=\"purple\">must</strong> have been created with a <a href=\"#VkSemaphoreType\">VkSemaphoreType</a> of <code>VK_SEMAPHORE_TYPE_TIMELINE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetSemaphoreCounterValue-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetSemaphoreCounterValue-semaphore-parameter",
|
|
"text": " <code>semaphore</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSemaphore\">VkSemaphore</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetSemaphoreCounterValue-pValue-parameter",
|
|
"text": " <code>pValue</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>uint64_t</code> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetSemaphoreCounterValue-semaphore-parent",
|
|
"text": " <code>semaphore</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkWaitSemaphores": {
|
|
"(VK_VERSION_1_2,VK_KHR_timeline_semaphore)": [
|
|
{
|
|
"vuid": "VUID-vkWaitSemaphores-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkWaitSemaphores-pWaitInfo-parameter",
|
|
"text": " <code>pWaitInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkSemaphoreWaitInfo\">VkSemaphoreWaitInfo</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkSemaphoreWaitInfo": {
|
|
"(VK_VERSION_1_2,VK_KHR_timeline_semaphore)": [
|
|
{
|
|
"vuid": "VUID-VkSemaphoreWaitInfo-pSemaphores-03256",
|
|
"text": " All of the elements of <code>pSemaphores</code> <strong class=\"purple\">must</strong> reference a semaphore that was created with a <a href=\"#VkSemaphoreType\">VkSemaphoreType</a> of <code>VK_SEMAPHORE_TYPE_TIMELINE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSemaphoreWaitInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_SEMAPHORE_WAIT_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSemaphoreWaitInfo-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSemaphoreWaitInfo-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkSemaphoreWaitFlagBits\">VkSemaphoreWaitFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSemaphoreWaitInfo-pSemaphores-parameter",
|
|
"text": " <code>pSemaphores</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>semaphoreCount</code> valid <a href=\"#VkSemaphore\">VkSemaphore</a> handles"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSemaphoreWaitInfo-pValues-parameter",
|
|
"text": " <code>pValues</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>semaphoreCount</code> <code>uint64_t</code> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSemaphoreWaitInfo-semaphoreCount-arraylength",
|
|
"text": " <code>semaphoreCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkSignalSemaphore": {
|
|
"(VK_VERSION_1_2,VK_KHR_timeline_semaphore)": [
|
|
{
|
|
"vuid": "VUID-vkSignalSemaphore-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkSignalSemaphore-pSignalInfo-parameter",
|
|
"text": " <code>pSignalInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkSemaphoreSignalInfo\">VkSemaphoreSignalInfo</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkSemaphoreSignalInfo": {
|
|
"(VK_VERSION_1_2,VK_KHR_timeline_semaphore)": [
|
|
{
|
|
"vuid": "VUID-VkSemaphoreSignalInfo-semaphore-03257",
|
|
"text": " <code>semaphore</code> <strong class=\"purple\">must</strong> have been created with a <a href=\"#VkSemaphoreType\">VkSemaphoreType</a> of <code>VK_SEMAPHORE_TYPE_TIMELINE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSemaphoreSignalInfo-value-03258",
|
|
"text": " <code>value</code> <strong class=\"purple\">must</strong> have a value greater than the current value of the semaphore"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSemaphoreSignalInfo-value-03259",
|
|
"text": " <code>value</code> <strong class=\"purple\">must</strong> be less than the value of any pending semaphore signal operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSemaphoreSignalInfo-value-03260",
|
|
"text": " <code>value</code> <strong class=\"purple\">must</strong> have a value which does not differ from the current value of the semaphore or the value of any outstanding semaphore wait or signal operation on <code>semaphore</code> by more than <a href=\"#limits-maxTimelineSemaphoreValueDifference\"><code>maxTimelineSemaphoreValueDifference</code></a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSemaphoreSignalInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_SEMAPHORE_SIGNAL_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSemaphoreSignalInfo-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSemaphoreSignalInfo-semaphore-parameter",
|
|
"text": " <code>semaphore</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSemaphore\">VkSemaphore</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"vkImportSemaphoreWin32HandleKHR": {
|
|
"(VK_KHR_external_semaphore_win32)": [
|
|
{
|
|
"vuid": "VUID-vkImportSemaphoreWin32HandleKHR-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkImportSemaphoreWin32HandleKHR-pImportSemaphoreWin32HandleInfo-parameter",
|
|
"text": " <code>pImportSemaphoreWin32HandleInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkImportSemaphoreWin32HandleInfoKHR\">VkImportSemaphoreWin32HandleInfoKHR</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkImportSemaphoreWin32HandleInfoKHR": {
|
|
"(VK_KHR_external_semaphore_win32)": [
|
|
{
|
|
"vuid": "VUID-VkImportSemaphoreWin32HandleInfoKHR-handleType-01140",
|
|
"text": " <code>handleType</code> <strong class=\"purple\">must</strong> be a value included in the <a href=\"#synchronization-semaphore-handletypes-win32\">Handle Types Supported by <code>VkImportSemaphoreWin32HandleInfoKHR</code></a> table"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportSemaphoreWin32HandleInfoKHR-handleType-01466",
|
|
"text": " If <code>handleType</code> is not <code>VK_EXTERNAL_SEMAPHORE_HANDLE_TYPE_OPAQUE_WIN32_BIT</code> or <code>VK_EXTERNAL_SEMAPHORE_HANDLE_TYPE_D3D12_FENCE_BIT</code>, <code>name</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportSemaphoreWin32HandleInfoKHR-handleType-01467",
|
|
"text": " If <code>handle</code> is <code>NULL</code>, <code>name</code> <strong class=\"purple\">must</strong> name a valid synchronization primitive of the type specified by <code>handleType</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportSemaphoreWin32HandleInfoKHR-handleType-01468",
|
|
"text": " If <code>name</code> is <code>NULL</code>, <code>handle</code> <strong class=\"purple\">must</strong> be a valid handle of the type specified by <code>handleType</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportSemaphoreWin32HandleInfoKHR-handle-01469",
|
|
"text": " If <code>handle</code> is not <code>NULL</code>, <code>name</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportSemaphoreWin32HandleInfoKHR-handle-01542",
|
|
"text": " If <code>handle</code> is not <code>NULL</code>, it <strong class=\"purple\">must</strong> obey any requirements listed for <code>handleType</code> in <a href=\"#external-semaphore-handle-types-compatibility\">external semaphore handle types compatibility</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportSemaphoreWin32HandleInfoKHR-name-01543",
|
|
"text": " If <code>name</code> is not <code>NULL</code>, it <strong class=\"purple\">must</strong> obey any requirements listed for <code>handleType</code> in <a href=\"#external-semaphore-handle-types-compatibility\">external semaphore handle types compatibility</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportSemaphoreWin32HandleInfoKHR-handleType-03261",
|
|
"text": " If <code>handleType</code> is <code>VK_EXTERNAL_SEMAPHORE_HANDLE_TYPE_OPAQUE_WIN32_BIT</code> or <code>VK_EXTERNAL_SEMAPHORE_HANDLE_TYPE_OPAQUE_WIN32_KMT_BIT</code>, the <a href=\"#VkSemaphoreCreateInfo\">VkSemaphoreCreateInfo</a>::<code>flags</code> field <strong class=\"purple\">must</strong> match that of the semaphore from which <code>handle</code> or <code>name</code> was exported"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportSemaphoreWin32HandleInfoKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_IMPORT_SEMAPHORE_WIN32_HANDLE_INFO_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportSemaphoreWin32HandleInfoKHR-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportSemaphoreWin32HandleInfoKHR-semaphore-parameter",
|
|
"text": " <code>semaphore</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSemaphore\">VkSemaphore</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportSemaphoreWin32HandleInfoKHR-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkSemaphoreImportFlagBits\">VkSemaphoreImportFlagBits</a> values"
|
|
}
|
|
],
|
|
"(VK_KHR_external_semaphore_win32)+(VK_VERSION_1_2,VK_KHR_timeline_semaphore)": [
|
|
{
|
|
"vuid": "VUID-VkImportSemaphoreWin32HandleInfoKHR-handleType-03262",
|
|
"text": " If <code>handleType</code> is <code>VK_EXTERNAL_SEMAPHORE_HANDLE_TYPE_OPAQUE_WIN32_BIT</code> or <code>VK_EXTERNAL_SEMAPHORE_HANDLE_TYPE_OPAQUE_WIN32_KMT_BIT</code>, the <a href=\"#VkSemaphoreTypeCreateInfo\">VkSemaphoreTypeCreateInfo</a>::<code>semaphoreType</code> field <strong class=\"purple\">must</strong> match that of the semaphore from which <code>handle</code> or <code>name</code> was exported"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportSemaphoreWin32HandleInfoKHR-flags-03322",
|
|
"text": " If <code>flags</code> contains <code>VK_SEMAPHORE_IMPORT_TEMPORARY_BIT</code>, the <a href=\"#VkSemaphoreTypeCreateInfo\">VkSemaphoreTypeCreateInfo</a>::<code>semaphoreType</code> field of the semaphore from which <code>handle</code> or <code>name</code> was exported <strong class=\"purple\">must</strong> not be <code>VK_SEMAPHORE_TYPE_TIMELINE</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkImportSemaphoreFdKHR": {
|
|
"(VK_KHR_external_semaphore_fd)": [
|
|
{
|
|
"vuid": "VUID-vkImportSemaphoreFdKHR-semaphore-01142",
|
|
"text": " <code>semaphore</code> <strong class=\"purple\">must</strong> not be associated with any queue command that has not yet completed execution on that queue"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkImportSemaphoreFdKHR-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkImportSemaphoreFdKHR-pImportSemaphoreFdInfo-parameter",
|
|
"text": " <code>pImportSemaphoreFdInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkImportSemaphoreFdInfoKHR\">VkImportSemaphoreFdInfoKHR</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkImportSemaphoreFdInfoKHR": {
|
|
"(VK_KHR_external_semaphore_fd)": [
|
|
{
|
|
"vuid": "VUID-VkImportSemaphoreFdInfoKHR-handleType-01143",
|
|
"text": " <code>handleType</code> <strong class=\"purple\">must</strong> be a value included in the <a href=\"#synchronization-semaphore-handletypes-fd\">Handle Types Supported by <code>VkImportSemaphoreFdInfoKHR</code></a> table"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportSemaphoreFdInfoKHR-fd-01544",
|
|
"text": " <code>fd</code> <strong class=\"purple\">must</strong> obey any requirements listed for <code>handleType</code> in <a href=\"#external-semaphore-handle-types-compatibility\">external semaphore handle types compatibility</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportSemaphoreFdInfoKHR-handleType-03263",
|
|
"text": " If <code>handleType</code> is <code>VK_EXTERNAL_SEMAPHORE_HANDLE_TYPE_OPAQUE_FD_BIT</code>, the <a href=\"#VkSemaphoreCreateInfo\">VkSemaphoreCreateInfo</a>::<code>flags</code> field <strong class=\"purple\">must</strong> match that of the semaphore from which <code>fd</code> was exported"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportSemaphoreFdInfoKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_IMPORT_SEMAPHORE_FD_INFO_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportSemaphoreFdInfoKHR-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportSemaphoreFdInfoKHR-semaphore-parameter",
|
|
"text": " <code>semaphore</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSemaphore\">VkSemaphore</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportSemaphoreFdInfoKHR-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkSemaphoreImportFlagBits\">VkSemaphoreImportFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportSemaphoreFdInfoKHR-handleType-parameter",
|
|
"text": " <code>handleType</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkExternalSemaphoreHandleTypeFlagBits\">VkExternalSemaphoreHandleTypeFlagBits</a> value"
|
|
}
|
|
],
|
|
"(VK_KHR_external_semaphore_fd)+(VK_VERSION_1_2,VK_KHR_timeline_semaphore)": [
|
|
{
|
|
"vuid": "VUID-VkImportSemaphoreFdInfoKHR-handleType-03264",
|
|
"text": " If <code>handleType</code> is <code>VK_EXTERNAL_SEMAPHORE_HANDLE_TYPE_OPAQUE_FD_BIT</code>, the <a href=\"#VkSemaphoreTypeCreateInfo\">VkSemaphoreTypeCreateInfo</a>::<code>semaphoreType</code> field <strong class=\"purple\">must</strong> match that of the semaphore from which <code>fd</code> was exported"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportSemaphoreFdInfoKHR-flags-03323",
|
|
"text": " If <code>flags</code> contains <code>VK_SEMAPHORE_IMPORT_TEMPORARY_BIT</code>, the <a href=\"#VkSemaphoreTypeCreateInfo\">VkSemaphoreTypeCreateInfo</a>::<code>semaphoreType</code> field of the semaphore from which <code>fd</code> was exported <strong class=\"purple\">must</strong> not be <code>VK_SEMAPHORE_TYPE_TIMELINE</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkImportSemaphoreZirconHandleFUCHSIA": {
|
|
"(VK_FUCHSIA_external_semaphore)": [
|
|
{
|
|
"vuid": "VUID-vkImportSemaphoreZirconHandleFUCHSIA-semaphore-04764",
|
|
"text": " <code>semaphore</code> <strong class=\"purple\">must</strong> not be associated with any queue command that has not yet completed execution on that queue"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkImportSemaphoreZirconHandleFUCHSIA-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkImportSemaphoreZirconHandleFUCHSIA-pImportSemaphoreZirconHandleInfo-parameter",
|
|
"text": " <code>pImportSemaphoreZirconHandleInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkImportSemaphoreZirconHandleInfoFUCHSIA\">VkImportSemaphoreZirconHandleInfoFUCHSIA</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkImportSemaphoreZirconHandleInfoFUCHSIA": {
|
|
"(VK_FUCHSIA_external_semaphore)": [
|
|
{
|
|
"vuid": "VUID-VkImportSemaphoreZirconHandleInfoFUCHSIA-handleType-04765",
|
|
"text": " <code>handleType</code> <strong class=\"purple\">must</strong> be a value included in the <a href=\"#synchronization-semaphore-handletypes-fuchsia\">Handle Types Supported by <code>VkImportSemaphoreZirconHandleInfoFUCHSIA</code></a> table"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportSemaphoreZirconHandleInfoFUCHSIA-zirconHandle-04766",
|
|
"text": " <code>zirconHandle</code> <strong class=\"purple\">must</strong> obey any requirements listed for <code>handleType</code> in <a href=\"#external-semaphore-handle-types-compatibility\">external semaphore handle types compatibility</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportSemaphoreZirconHandleInfoFUCHSIA-zirconHandle-04767",
|
|
"text": " <code>zirconHandle</code> <strong class=\"purple\">must</strong> have <code>ZX_RIGHTS_BASIC</code> and <code>ZX_RIGHTS_SIGNAL</code> rights"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportSemaphoreZirconHandleInfoFUCHSIA-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_IMPORT_SEMAPHORE_ZIRCON_HANDLE_INFO_FUCHSIA</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportSemaphoreZirconHandleInfoFUCHSIA-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportSemaphoreZirconHandleInfoFUCHSIA-semaphore-parameter",
|
|
"text": " <code>semaphore</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSemaphore\">VkSemaphore</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportSemaphoreZirconHandleInfoFUCHSIA-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkSemaphoreImportFlagBits\">VkSemaphoreImportFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportSemaphoreZirconHandleInfoFUCHSIA-handleType-parameter",
|
|
"text": " <code>handleType</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkExternalSemaphoreHandleTypeFlagBits\">VkExternalSemaphoreHandleTypeFlagBits</a> value"
|
|
}
|
|
],
|
|
"(VK_FUCHSIA_external_semaphore)+(VK_VERSION_1_2,VK_KHR_timeline_semaphore)": [
|
|
{
|
|
"vuid": "VUID-VkImportSemaphoreZirconHandleInfoFUCHSIA-semaphoreType-04768",
|
|
"text": " The <a href=\"#VkSemaphoreTypeCreateInfo\">VkSemaphoreTypeCreateInfo</a>::<code>semaphoreType</code> field <strong class=\"purple\">must</strong> not be <code>VK_SEMAPHORE_TYPE_TIMELINE</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCreateEvent": {
|
|
"(VK_KHR_portability_subset)": [
|
|
{
|
|
"vuid": "VUID-vkCreateEvent-events-04468",
|
|
"text": " If the <code><a href=\"#VK_KHR_portability_subset\">VK_KHR_portability_subset</a></code> extension is enabled, and <a href=\"#VkPhysicalDevicePortabilitySubsetFeaturesKHR\">VkPhysicalDevicePortabilitySubsetFeaturesKHR</a>::<code>events</code> is <code>VK_FALSE</code>, then the implementation does not support <a href=\"#synchronization-events\">events</a>, and <a href=\"#vkCreateEvent\">vkCreateEvent</a> <strong class=\"purple\">must</strong> not be used"
|
|
}
|
|
],
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCreateEvent-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateEvent-pCreateInfo-parameter",
|
|
"text": " <code>pCreateInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkEventCreateInfo\">VkEventCreateInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateEvent-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateEvent-pEvent-parameter",
|
|
"text": " <code>pEvent</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkEvent\">VkEvent</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkEventCreateInfo": {
|
|
"(VK_EXT_metal_objects)": [
|
|
{
|
|
"vuid": "VUID-VkEventCreateInfo-pNext-06790",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkExportMetalObjectCreateInfoEXT\">VkExportMetalObjectCreateInfoEXT</a> structure, its <code>exportObjectType</code> member <strong class=\"purple\">must</strong> be <code>VK_EXPORT_METAL_OBJECT_TYPE_METAL_SHARED_EVENT_BIT_EXT</code>."
|
|
}
|
|
],
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkEventCreateInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_EVENT_CREATE_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkEventCreateInfo-pNext-pNext",
|
|
"text": " Each <code>pNext</code> member of any structure (including this one) in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be either <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkExportMetalObjectCreateInfoEXT\">VkExportMetalObjectCreateInfoEXT</a> or <a href=\"#VkImportMetalSharedEventInfoEXT\">VkImportMetalSharedEventInfoEXT</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkEventCreateInfo-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique, with the exception of structures of type <a href=\"#VkExportMetalObjectCreateInfoEXT\">VkExportMetalObjectCreateInfoEXT</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkEventCreateInfo-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkEventCreateFlagBits\">VkEventCreateFlagBits</a> values"
|
|
}
|
|
]
|
|
},
|
|
"vkDestroyEvent": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkDestroyEvent-event-01145",
|
|
"text": " All submitted commands that refer to <code>event</code> <strong class=\"purple\">must</strong> have completed execution"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyEvent-event-01146",
|
|
"text": " If <code>VkAllocationCallbacks</code> were provided when <code>event</code> was created, a compatible set of callbacks <strong class=\"purple\">must</strong> be provided here"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyEvent-event-01147",
|
|
"text": " If no <code>VkAllocationCallbacks</code> were provided when <code>event</code> was created, <code>pAllocator</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyEvent-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyEvent-event-parameter",
|
|
"text": " If <code>event</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>event</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkEvent\">VkEvent</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyEvent-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyEvent-event-parent",
|
|
"text": " If <code>event</code> is a valid handle, it <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetEventStatus": {
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)": [
|
|
{
|
|
"vuid": "VUID-vkGetEventStatus-event-03940",
|
|
"text": " <code>event</code> <strong class=\"purple\">must</strong> not have been created with <code>VK_EVENT_CREATE_DEVICE_ONLY_BIT</code>"
|
|
}
|
|
],
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkGetEventStatus-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetEventStatus-event-parameter",
|
|
"text": " <code>event</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkEvent\">VkEvent</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetEventStatus-event-parent",
|
|
"text": " <code>event</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkSetEvent": {
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)": [
|
|
{
|
|
"vuid": "VUID-vkSetEvent-event-03941",
|
|
"text": " <code>event</code> <strong class=\"purple\">must</strong> not have been created with <code>VK_EVENT_CREATE_DEVICE_ONLY_BIT</code>"
|
|
}
|
|
],
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkSetEvent-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkSetEvent-event-parameter",
|
|
"text": " <code>event</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkEvent\">VkEvent</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkSetEvent-event-parent",
|
|
"text": " <code>event</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkResetEvent": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkResetEvent-event-03821",
|
|
"text": " There <strong class=\"purple\">must</strong> be an execution dependency between <code>vkResetEvent</code> and the execution of any <a href=\"#vkCmdWaitEvents\">vkCmdWaitEvents</a> that includes <code>event</code> in its <code>pEvents</code> parameter"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkResetEvent-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkResetEvent-event-parameter",
|
|
"text": " <code>event</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkEvent\">VkEvent</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkResetEvent-event-parent",
|
|
"text": " <code>event</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)": [
|
|
{
|
|
"vuid": "VUID-vkResetEvent-event-03822",
|
|
"text": " There <strong class=\"purple\">must</strong> be an execution dependency between <code>vkResetEvent</code> and the execution of any <a href=\"#vkCmdWaitEvents2\">vkCmdWaitEvents2</a> that includes <code>event</code> in its <code>pEvents</code> parameter"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkResetEvent-event-03823",
|
|
"text": " <code>event</code> <strong class=\"purple\">must</strong> not have been created with <code>VK_EVENT_CREATE_DEVICE_ONLY_BIT</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdSetEvent2": {
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetEvent2-synchronization2-03824",
|
|
"text": " The <a href=\"#features-synchronization2\"><code>synchronization2</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetEvent2-dependencyFlags-03825",
|
|
"text": " The <code>dependencyFlags</code> member of <code>pDependencyInfo</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetEvent2-srcStageMask-03827",
|
|
"text": " The <code>srcStageMask</code> member of any element of the <code>pMemoryBarriers</code>, <code>pBufferMemoryBarriers</code>, or <code>pImageMemoryBarriers</code> members of <code>pDependencyInfo</code> <strong class=\"purple\">must</strong> only include pipeline stages valid for the queue family that was used to create the command pool that <code>commandBuffer</code> was allocated from"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetEvent2-dstStageMask-03828",
|
|
"text": " The <code>dstStageMask</code> member of any element of the <code>pMemoryBarriers</code>, <code>pBufferMemoryBarriers</code>, or <code>pImageMemoryBarriers</code> members of <code>pDependencyInfo</code> <strong class=\"purple\">must</strong> only include pipeline stages valid for the queue family that was used to create the command pool that <code>commandBuffer</code> was allocated from"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetEvent2-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetEvent2-event-parameter",
|
|
"text": " <code>event</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkEvent\">VkEvent</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetEvent2-pDependencyInfo-parameter",
|
|
"text": " <code>pDependencyInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkDependencyInfo\">VkDependencyInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetEvent2-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetEvent2-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics, compute, decode, or encode operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetEvent2-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetEvent2-commonparent",
|
|
"text": " Both of <code>commandBuffer</code>, and <code>event</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_VERSION_1_1,VK_KHR_device_group)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetEvent2-commandBuffer-03826",
|
|
"text": " The current device mask of <code>commandBuffer</code> <strong class=\"purple\">must</strong> include exactly one physical device"
|
|
}
|
|
]
|
|
},
|
|
"VkDependencyInfo": {
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)": [
|
|
{
|
|
"vuid": "VUID-VkDependencyInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_DEPENDENCY_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDependencyInfo-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDependencyInfo-dependencyFlags-parameter",
|
|
"text": " <code>dependencyFlags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkDependencyFlagBits\">VkDependencyFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDependencyInfo-pMemoryBarriers-parameter",
|
|
"text": " If <code>memoryBarrierCount</code> is not <code>0</code>, <code>pMemoryBarriers</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>memoryBarrierCount</code> valid <a href=\"#VkMemoryBarrier2\">VkMemoryBarrier2</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDependencyInfo-pBufferMemoryBarriers-parameter",
|
|
"text": " If <code>bufferMemoryBarrierCount</code> is not <code>0</code>, <code>pBufferMemoryBarriers</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>bufferMemoryBarrierCount</code> valid <a href=\"#VkBufferMemoryBarrier2\">VkBufferMemoryBarrier2</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDependencyInfo-pImageMemoryBarriers-parameter",
|
|
"text": " If <code>imageMemoryBarrierCount</code> is not <code>0</code>, <code>pImageMemoryBarriers</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>imageMemoryBarrierCount</code> valid <a href=\"#VkImageMemoryBarrier2\">VkImageMemoryBarrier2</a> structures"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdSetEvent": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetEvent-stageMask-04090",
|
|
"text": " If the <a href=\"#features-geometryShader\"><code>geometryShader</code></a> feature is not enabled, pname:stageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_GEOMETRY_SHADER_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetEvent-stageMask-04091",
|
|
"text": " If the <a href=\"#features-tessellationShader\"><code>tessellationShader</code></a> feature is not enabled, pname:stageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_TESSELLATION_CONTROL_SHADER_BIT</code> or <code>VK_PIPELINE_STAGE_TESSELLATION_EVALUATION_SHADER_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetEvent-stageMask-06457",
|
|
"text": " Any pipeline stage included in <code>stageMask</code> <strong class=\"purple\">must</strong> be supported by the capabilities of the queue family specified by the <code>queueFamilyIndex</code> member of the <a href=\"#VkCommandPoolCreateInfo\">VkCommandPoolCreateInfo</a> structure that was used to create the <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from, as specified in the <a href=\"#synchronization-pipeline-stages-supported\">table of supported pipeline stages</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetEvent-stageMask-01149",
|
|
"text": " <code>stageMask</code> <strong class=\"purple\">must</strong> not include <code>VK_PIPELINE_STAGE_HOST_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetEvent-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetEvent-event-parameter",
|
|
"text": " <code>event</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkEvent\">VkEvent</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetEvent-stageMask-parameter",
|
|
"text": " <code>stageMask</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkPipelineStageFlagBits\">VkPipelineStageFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetEvent-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetEvent-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics, compute, decode, or encode operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetEvent-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetEvent-commonparent",
|
|
"text": " Both of <code>commandBuffer</code>, and <code>event</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"(VK_EXT_conditional_rendering)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetEvent-stageMask-04092",
|
|
"text": " If the <a href=\"#features-conditionalRendering\"><code>conditionalRendering</code></a> feature is not enabled, pname:stageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_CONDITIONAL_RENDERING_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_fragment_density_map)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetEvent-stageMask-04093",
|
|
"text": " If the <a href=\"#features-fragmentDensityMap\"><code>fragmentDensityMap</code></a> feature is not enabled, pname:stageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_FRAGMENT_DENSITY_PROCESS_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetEvent-stageMask-04094",
|
|
"text": " If the <a href=\"#features-transformFeedback\"><code>transformFeedback</code></a> feature is not enabled, pname:stageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_TRANSFORM_FEEDBACK_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetEvent-stageMask-04095",
|
|
"text": " If the <a href=\"#features-meshShader\"><code>meshShader</code></a> feature is not enabled, pname:stageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_MESH_SHADER_BIT_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetEvent-stageMask-04096",
|
|
"text": " If the <a href=\"#features-taskShader\"><code>taskShader</code></a> feature is not enabled, pname:stageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_TASK_SHADER_BIT_NV</code>"
|
|
}
|
|
],
|
|
"(VK_NV_shading_rate_image)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetEvent-stageMask-04097",
|
|
"text": " If the <a href=\"#features-shadingRateImage\"><code>shadingRateImage</code></a> feature is not enabled, pname:stageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_SHADING_RATE_IMAGE_BIT_NV</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetEvent-stageMask-03937",
|
|
"text": " If the <a href=\"#features-synchronization2\"><code>synchronization2</code></a> feature is not enabled, pname:stageMask <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
}
|
|
],
|
|
"!(VK_VERSION_1_3,VK_KHR_synchronization2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetEvent-stageMask-04996",
|
|
"text": " pname:stageMask <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_device_group)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetEvent-commandBuffer-01152",
|
|
"text": " <code>commandBuffer</code>’s current device mask <strong class=\"purple\">must</strong> include exactly one physical device"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdResetEvent2": {
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdResetEvent2-stageMask-03929",
|
|
"text": " If the <a href=\"#features-geometryShader\"><code>geometryShader</code></a> feature is not enabled, pname:stageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_GEOMETRY_SHADER_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResetEvent2-stageMask-03930",
|
|
"text": " If the <a href=\"#features-tessellationShader\"><code>tessellationShader</code></a> feature is not enabled, pname:stageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_TESSELLATION_CONTROL_SHADER_BIT</code> or <code>VK_PIPELINE_STAGE_2_TESSELLATION_EVALUATION_SHADER_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResetEvent2-synchronization2-03829",
|
|
"text": " The <a href=\"#features-synchronization2\"><code>synchronization2</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResetEvent2-stageMask-03830",
|
|
"text": " <code>stageMask</code> <strong class=\"purple\">must</strong> not include <code>VK_PIPELINE_STAGE_2_HOST_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResetEvent2-event-03831",
|
|
"text": " There <strong class=\"purple\">must</strong> be an execution dependency between <code>vkCmdResetEvent2</code> and the execution of any <a href=\"#vkCmdWaitEvents\">vkCmdWaitEvents</a> that includes <code>event</code> in its <code>pEvents</code> parameter"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResetEvent2-event-03832",
|
|
"text": " There <strong class=\"purple\">must</strong> be an execution dependency between <code>vkCmdResetEvent2</code> and the execution of any <a href=\"#vkCmdWaitEvents2\">vkCmdWaitEvents2</a> that includes <code>event</code> in its <code>pEvents</code> parameter"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResetEvent2-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResetEvent2-event-parameter",
|
|
"text": " <code>event</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkEvent\">VkEvent</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResetEvent2-stageMask-parameter",
|
|
"text": " <code>stageMask</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkPipelineStageFlagBits2\">VkPipelineStageFlagBits2</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResetEvent2-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResetEvent2-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics, compute, decode, or encode operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResetEvent2-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResetEvent2-commonparent",
|
|
"text": " Both of <code>commandBuffer</code>, and <code>event</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_EXT_conditional_rendering)": [
|
|
{
|
|
"vuid": "VUID-vkCmdResetEvent2-stageMask-03931",
|
|
"text": " If the <a href=\"#features-conditionalRendering\"><code>conditionalRendering</code></a> feature is not enabled, pname:stageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_CONDITIONAL_RENDERING_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_EXT_fragment_density_map)": [
|
|
{
|
|
"vuid": "VUID-vkCmdResetEvent2-stageMask-03932",
|
|
"text": " If the <a href=\"#features-fragmentDensityMap\"><code>fragmentDensityMap</code></a> feature is not enabled, pname:stageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_FRAGMENT_DENSITY_PROCESS_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_EXT_transform_feedback)": [
|
|
{
|
|
"vuid": "VUID-vkCmdResetEvent2-stageMask-03933",
|
|
"text": " If the <a href=\"#features-transformFeedback\"><code>transformFeedback</code></a> feature is not enabled, pname:stageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_TRANSFORM_FEEDBACK_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_NV_mesh_shader)": [
|
|
{
|
|
"vuid": "VUID-vkCmdResetEvent2-stageMask-03934",
|
|
"text": " If the <a href=\"#features-meshShader\"><code>meshShader</code></a> feature is not enabled, pname:stageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_MESH_SHADER_BIT_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResetEvent2-stageMask-03935",
|
|
"text": " If the <a href=\"#features-taskShader\"><code>taskShader</code></a> feature is not enabled, pname:stageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_TASK_SHADER_BIT_NV</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_NV_shading_rate_image)": [
|
|
{
|
|
"vuid": "VUID-vkCmdResetEvent2-stageMask-04956",
|
|
"text": " If the <a href=\"#features-shadingRateImage\"><code>shadingRateImage</code></a> feature is not enabled, pname:stageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_SHADING_RATE_IMAGE_BIT_NV</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_HUAWEI_subpass_shading)": [
|
|
{
|
|
"vuid": "VUID-vkCmdResetEvent2-stageMask-04957",
|
|
"text": " If the <a href=\"#features-subpassShading\"><code>subpassShading</code></a> feature is not enabled, pname:stageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_SUBPASS_SHADING_BIT_HUAWEI</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_HUAWEI_invocation_mask)": [
|
|
{
|
|
"vuid": "VUID-vkCmdResetEvent2-stageMask-04995",
|
|
"text": " If the <a href=\"#features-invocationMask\"><code>invocationMask</code></a> feature is not enabled, pname:stageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_INVOCATION_MASK_BIT_HUAWEI</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_VERSION_1_1,VK_KHR_device_group)": [
|
|
{
|
|
"vuid": "VUID-vkCmdResetEvent2-commandBuffer-03833",
|
|
"text": " <code>commandBuffer</code>’s current device mask <strong class=\"purple\">must</strong> include exactly one physical device"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdResetEvent": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCmdResetEvent-stageMask-04090",
|
|
"text": " If the <a href=\"#features-geometryShader\"><code>geometryShader</code></a> feature is not enabled, pname:stageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_GEOMETRY_SHADER_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResetEvent-stageMask-04091",
|
|
"text": " If the <a href=\"#features-tessellationShader\"><code>tessellationShader</code></a> feature is not enabled, pname:stageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_TESSELLATION_CONTROL_SHADER_BIT</code> or <code>VK_PIPELINE_STAGE_TESSELLATION_EVALUATION_SHADER_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResetEvent-stageMask-06458",
|
|
"text": " Any pipeline stage included in <code>stageMask</code> <strong class=\"purple\">must</strong> be supported by the capabilities of the queue family specified by the <code>queueFamilyIndex</code> member of the <a href=\"#VkCommandPoolCreateInfo\">VkCommandPoolCreateInfo</a> structure that was used to create the <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from, as specified in the <a href=\"#synchronization-pipeline-stages-supported\">table of supported pipeline stages</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResetEvent-stageMask-01153",
|
|
"text": " <code>stageMask</code> <strong class=\"purple\">must</strong> not include <code>VK_PIPELINE_STAGE_HOST_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResetEvent-event-03834",
|
|
"text": " There <strong class=\"purple\">must</strong> be an execution dependency between <code>vkCmdResetEvent</code> and the execution of any <a href=\"#vkCmdWaitEvents\">vkCmdWaitEvents</a> that includes <code>event</code> in its <code>pEvents</code> parameter"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResetEvent-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResetEvent-event-parameter",
|
|
"text": " <code>event</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkEvent\">VkEvent</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResetEvent-stageMask-parameter",
|
|
"text": " <code>stageMask</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkPipelineStageFlagBits\">VkPipelineStageFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResetEvent-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResetEvent-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics, compute, decode, or encode operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResetEvent-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResetEvent-commonparent",
|
|
"text": " Both of <code>commandBuffer</code>, and <code>event</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"(VK_EXT_conditional_rendering)": [
|
|
{
|
|
"vuid": "VUID-vkCmdResetEvent-stageMask-04092",
|
|
"text": " If the <a href=\"#features-conditionalRendering\"><code>conditionalRendering</code></a> feature is not enabled, pname:stageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_CONDITIONAL_RENDERING_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_fragment_density_map)": [
|
|
{
|
|
"vuid": "VUID-vkCmdResetEvent-stageMask-04093",
|
|
"text": " If the <a href=\"#features-fragmentDensityMap\"><code>fragmentDensityMap</code></a> feature is not enabled, pname:stageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_FRAGMENT_DENSITY_PROCESS_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)": [
|
|
{
|
|
"vuid": "VUID-vkCmdResetEvent-stageMask-04094",
|
|
"text": " If the <a href=\"#features-transformFeedback\"><code>transformFeedback</code></a> feature is not enabled, pname:stageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_TRANSFORM_FEEDBACK_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)": [
|
|
{
|
|
"vuid": "VUID-vkCmdResetEvent-stageMask-04095",
|
|
"text": " If the <a href=\"#features-meshShader\"><code>meshShader</code></a> feature is not enabled, pname:stageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_MESH_SHADER_BIT_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResetEvent-stageMask-04096",
|
|
"text": " If the <a href=\"#features-taskShader\"><code>taskShader</code></a> feature is not enabled, pname:stageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_TASK_SHADER_BIT_NV</code>"
|
|
}
|
|
],
|
|
"(VK_NV_shading_rate_image)": [
|
|
{
|
|
"vuid": "VUID-vkCmdResetEvent-stageMask-04097",
|
|
"text": " If the <a href=\"#features-shadingRateImage\"><code>shadingRateImage</code></a> feature is not enabled, pname:stageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_SHADING_RATE_IMAGE_BIT_NV</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdResetEvent-stageMask-03937",
|
|
"text": " If the <a href=\"#features-synchronization2\"><code>synchronization2</code></a> feature is not enabled, pname:stageMask <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResetEvent-event-03835",
|
|
"text": " There <strong class=\"purple\">must</strong> be an execution dependency between <code>vkCmdResetEvent</code> and the execution of any <a href=\"#vkCmdWaitEvents2\">vkCmdWaitEvents2</a> that includes <code>event</code> in its <code>pEvents</code> parameter"
|
|
}
|
|
],
|
|
"!(VK_VERSION_1_3,VK_KHR_synchronization2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdResetEvent-stageMask-04996",
|
|
"text": " pname:stageMask <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_device_group)": [
|
|
{
|
|
"vuid": "VUID-vkCmdResetEvent-commandBuffer-01157",
|
|
"text": " <code>commandBuffer</code>’s current device mask <strong class=\"purple\">must</strong> include exactly one physical device"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdWaitEvents2": {
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdWaitEvents2-synchronization2-03836",
|
|
"text": " The <a href=\"#features-synchronization2\"><code>synchronization2</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWaitEvents2-pEvents-03837",
|
|
"text": " Members of <code>pEvents</code> <strong class=\"purple\">must</strong> not have been signaled by <a href=\"#vkCmdSetEvent\">vkCmdSetEvent</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWaitEvents2-pEvents-03838",
|
|
"text": " For any element <span class=\"eq\">i</span> of <code>pEvents</code>, if that event is signaled by <a href=\"#vkCmdSetEvent2\">vkCmdSetEvent2</a>, that command’s <code>dependencyInfo</code> parameter <strong class=\"purple\">must</strong> be exactly equal to the <span class=\"eq\">i</span>th element of <code>pDependencyInfos</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWaitEvents2-pEvents-03839",
|
|
"text": " For any element <span class=\"eq\">i</span> of <code>pEvents</code>, if that event is signaled by <a href=\"#vkSetEvent\">vkSetEvent</a>, barriers in the <span class=\"eq\">i</span>th element of <code>pDependencyInfos</code> <strong class=\"purple\">must</strong> include only host operations in their first <a href=\"#synchronization-dependencies-scopes\">synchronization scope</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWaitEvents2-pEvents-03840",
|
|
"text": " For any element <span class=\"eq\">i</span> of <code>pEvents</code>, if barriers in the <span class=\"eq\">i</span>th element of <code>pDependencyInfos</code> include only host operations, the <span class=\"eq\">i</span>th element of <code>pEvents</code> <strong class=\"purple\">must</strong> be signaled before <a href=\"#vkCmdWaitEvents2\">vkCmdWaitEvents2</a> is executed"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWaitEvents2-pEvents-03841",
|
|
"text": " For any element <span class=\"eq\">i</span> of <code>pEvents</code>, if barriers in the <span class=\"eq\">i</span>th element of <code>pDependencyInfos</code> do not include host operations, the <span class=\"eq\">i</span>th element of <code>pEvents</code> <strong class=\"purple\">must</strong> be signaled by a corresponding <a href=\"#vkCmdSetEvent2\">vkCmdSetEvent2</a> that occurred earlier in <a href=\"#synchronization-submission-order\">submission order</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWaitEvents2-srcStageMask-03842",
|
|
"text": " The <code>srcStageMask</code> member of any element of the <code>pMemoryBarriers</code>, <code>pBufferMemoryBarriers</code>, or <code>pImageMemoryBarriers</code> members of <code>pDependencyInfos</code> <strong class=\"purple\">must</strong> either include only pipeline stages valid for the queue family that was used to create the command pool that <code>commandBuffer</code> was allocated from, or include only <code>VK_PIPELINE_STAGE_2_HOST_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWaitEvents2-dstStageMask-03843",
|
|
"text": " The <code>dstStageMask</code> member of any element of the <code>pMemoryBarriers</code>, <code>pBufferMemoryBarriers</code>, or <code>pImageMemoryBarriers</code> members of <code>pDependencyInfos</code> <strong class=\"purple\">must</strong> only include pipeline stages valid for the queue family that was used to create the command pool that <code>commandBuffer</code> was allocated from"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWaitEvents2-dependencyFlags-03844",
|
|
"text": " The <code>dependencyFlags</code> member of any element of <code>pDependencyInfo</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWaitEvents2-pEvents-03845",
|
|
"text": " If <code>pEvents</code> includes one or more events that will be signaled by <a href=\"#vkSetEvent\">vkSetEvent</a> after <code>commandBuffer</code> has been submitted to a queue, then <code>vkCmdWaitEvents2</code> <strong class=\"purple\">must</strong> not be called inside a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWaitEvents2-commandBuffer-03846",
|
|
"text": " <code>commandBuffer</code>’s current device mask <strong class=\"purple\">must</strong> include exactly one physical device"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWaitEvents2-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWaitEvents2-pEvents-parameter",
|
|
"text": " <code>pEvents</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>eventCount</code> valid <a href=\"#VkEvent\">VkEvent</a> handles"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWaitEvents2-pDependencyInfos-parameter",
|
|
"text": " <code>pDependencyInfos</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>eventCount</code> valid <a href=\"#VkDependencyInfo\">VkDependencyInfo</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWaitEvents2-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWaitEvents2-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics, compute, decode, or encode operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWaitEvents2-eventCount-arraylength",
|
|
"text": " <code>eventCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWaitEvents2-commonparent",
|
|
"text": " Both of <code>commandBuffer</code>, and the elements of <code>pEvents</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdWaitEvents": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCmdWaitEvents-srcStageMask-04090",
|
|
"text": " If the <a href=\"#features-geometryShader\"><code>geometryShader</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_GEOMETRY_SHADER_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWaitEvents-srcStageMask-04091",
|
|
"text": " If the <a href=\"#features-tessellationShader\"><code>tessellationShader</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_TESSELLATION_CONTROL_SHADER_BIT</code> or <code>VK_PIPELINE_STAGE_TESSELLATION_EVALUATION_SHADER_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWaitEvents-dstStageMask-04090",
|
|
"text": " If the <a href=\"#features-geometryShader\"><code>geometryShader</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_GEOMETRY_SHADER_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWaitEvents-dstStageMask-04091",
|
|
"text": " If the <a href=\"#features-tessellationShader\"><code>tessellationShader</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_TESSELLATION_CONTROL_SHADER_BIT</code> or <code>VK_PIPELINE_STAGE_TESSELLATION_EVALUATION_SHADER_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWaitEvents-srcAccessMask-02815",
|
|
"text": " The <code>srcAccessMask</code> member of each element of <code>pMemoryBarriers</code> <strong class=\"purple\">must</strong> only include access flags that are supported by one or more of the pipeline stages in <code>srcStageMask</code>, as specified in the <a href=\"#synchronization-access-types-supported\">table of supported access types</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWaitEvents-dstAccessMask-02816",
|
|
"text": " The <code>dstAccessMask</code> member of each element of <code>pMemoryBarriers</code> <strong class=\"purple\">must</strong> only include access flags that are supported by one or more of the pipeline stages in <code>dstStageMask</code>, as specified in the <a href=\"#synchronization-access-types-supported\">table of supported access types</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWaitEvents-pBufferMemoryBarriers-02817",
|
|
"text": " For any element of <code>pBufferMemoryBarriers</code>, if its <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> members are equal, or if its <code>srcQueueFamilyIndex</code> is the queue family index that was used to create the command pool that <code>commandBuffer</code> was allocated from, then its <code>srcAccessMask</code> member <strong class=\"purple\">must</strong> only contain access flags that are supported by one or more of the pipeline stages in <code>srcStageMask</code>, as specified in the <a href=\"#synchronization-access-types-supported\">table of supported access types</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWaitEvents-pBufferMemoryBarriers-02818",
|
|
"text": " For any element of <code>pBufferMemoryBarriers</code>, if its <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> members are equal, or if its <code>dstQueueFamilyIndex</code> is the queue family index that was used to create the command pool that <code>commandBuffer</code> was allocated from, then its <code>dstAccessMask</code> member <strong class=\"purple\">must</strong> only contain access flags that are supported by one or more of the pipeline stages in <code>dstStageMask</code>, as specified in the <a href=\"#synchronization-access-types-supported\">table of supported access types</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWaitEvents-pImageMemoryBarriers-02819",
|
|
"text": " For any element of <code>pImageMemoryBarriers</code>, if its <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> members are equal, or if its <code>srcQueueFamilyIndex</code> is the queue family index that was used to create the command pool that <code>commandBuffer</code> was allocated from, then its <code>srcAccessMask</code> member <strong class=\"purple\">must</strong> only contain access flags that are supported by one or more of the pipeline stages in <code>srcStageMask</code>, as specified in the <a href=\"#synchronization-access-types-supported\">table of supported access types</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWaitEvents-pImageMemoryBarriers-02820",
|
|
"text": " For any element of <code>pImageMemoryBarriers</code>, if its <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> members are equal, or if its <code>dstQueueFamilyIndex</code> is the queue family index that was used to create the command pool that <code>commandBuffer</code> was allocated from, then its <code>dstAccessMask</code> member <strong class=\"purple\">must</strong> only contain access flags that are supported by one or more of the pipeline stages in <code>dstStageMask</code>, as specified in the <a href=\"#synchronization-access-types-supported\">table of supported access types</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWaitEvents-srcStageMask-06459",
|
|
"text": " Any pipeline stage included in <code>srcStageMask</code> <strong class=\"purple\">must</strong> be supported by the capabilities of the queue family specified by the <code>queueFamilyIndex</code> member of the <a href=\"#VkCommandPoolCreateInfo\">VkCommandPoolCreateInfo</a> structure that was used to create the <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from, as specified in the <a href=\"#synchronization-pipeline-stages-supported\">table of supported pipeline stages</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWaitEvents-dstStageMask-06460",
|
|
"text": " Any pipeline stage included in <code>dstStageMask</code> <strong class=\"purple\">must</strong> be supported by the capabilities of the queue family specified by the <code>queueFamilyIndex</code> member of the <a href=\"#VkCommandPoolCreateInfo\">VkCommandPoolCreateInfo</a> structure that was used to create the <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from, as specified in the <a href=\"#synchronization-pipeline-stages-supported\">table of supported pipeline stages</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWaitEvents-srcStageMask-01158",
|
|
"text": " <code>srcStageMask</code> <strong class=\"purple\">must</strong> be the bitwise OR of the <code>stageMask</code> parameter used in previous calls to <code>vkCmdSetEvent</code> with any of the elements of <code>pEvents</code> and <code>VK_PIPELINE_STAGE_HOST_BIT</code> if any of the elements of <code>pEvents</code> was set using <code>vkSetEvent</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWaitEvents-pEvents-01163",
|
|
"text": " If <code>pEvents</code> includes one or more events that will be signaled by <code>vkSetEvent</code> after <code>commandBuffer</code> has been submitted to a queue, then <code>vkCmdWaitEvents</code> <strong class=\"purple\">must</strong> not be called inside a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWaitEvents-srcQueueFamilyIndex-02803",
|
|
"text": " The <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> members of any element of <code>pBufferMemoryBarriers</code> or <code>pImageMemoryBarriers</code> <strong class=\"purple\">must</strong> be equal"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWaitEvents-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWaitEvents-pEvents-parameter",
|
|
"text": " <code>pEvents</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>eventCount</code> valid <a href=\"#VkEvent\">VkEvent</a> handles"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWaitEvents-srcStageMask-parameter",
|
|
"text": " <code>srcStageMask</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkPipelineStageFlagBits\">VkPipelineStageFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWaitEvents-dstStageMask-parameter",
|
|
"text": " <code>dstStageMask</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkPipelineStageFlagBits\">VkPipelineStageFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWaitEvents-pMemoryBarriers-parameter",
|
|
"text": " If <code>memoryBarrierCount</code> is not <code>0</code>, <code>pMemoryBarriers</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>memoryBarrierCount</code> valid <a href=\"#VkMemoryBarrier\">VkMemoryBarrier</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWaitEvents-pBufferMemoryBarriers-parameter",
|
|
"text": " If <code>bufferMemoryBarrierCount</code> is not <code>0</code>, <code>pBufferMemoryBarriers</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>bufferMemoryBarrierCount</code> valid <a href=\"#VkBufferMemoryBarrier\">VkBufferMemoryBarrier</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWaitEvents-pImageMemoryBarriers-parameter",
|
|
"text": " If <code>imageMemoryBarrierCount</code> is not <code>0</code>, <code>pImageMemoryBarriers</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>imageMemoryBarrierCount</code> valid <a href=\"#VkImageMemoryBarrier\">VkImageMemoryBarrier</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWaitEvents-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWaitEvents-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics, compute, decode, or encode operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWaitEvents-eventCount-arraylength",
|
|
"text": " <code>eventCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWaitEvents-commonparent",
|
|
"text": " Both of <code>commandBuffer</code>, and the elements of <code>pEvents</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"(VK_EXT_conditional_rendering)": [
|
|
{
|
|
"vuid": "VUID-vkCmdWaitEvents-srcStageMask-04092",
|
|
"text": " If the <a href=\"#features-conditionalRendering\"><code>conditionalRendering</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_CONDITIONAL_RENDERING_BIT_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWaitEvents-dstStageMask-04092",
|
|
"text": " If the <a href=\"#features-conditionalRendering\"><code>conditionalRendering</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_CONDITIONAL_RENDERING_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_fragment_density_map)": [
|
|
{
|
|
"vuid": "VUID-vkCmdWaitEvents-srcStageMask-04093",
|
|
"text": " If the <a href=\"#features-fragmentDensityMap\"><code>fragmentDensityMap</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_FRAGMENT_DENSITY_PROCESS_BIT_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWaitEvents-dstStageMask-04093",
|
|
"text": " If the <a href=\"#features-fragmentDensityMap\"><code>fragmentDensityMap</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_FRAGMENT_DENSITY_PROCESS_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)": [
|
|
{
|
|
"vuid": "VUID-vkCmdWaitEvents-srcStageMask-04094",
|
|
"text": " If the <a href=\"#features-transformFeedback\"><code>transformFeedback</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_TRANSFORM_FEEDBACK_BIT_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWaitEvents-dstStageMask-04094",
|
|
"text": " If the <a href=\"#features-transformFeedback\"><code>transformFeedback</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_TRANSFORM_FEEDBACK_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)": [
|
|
{
|
|
"vuid": "VUID-vkCmdWaitEvents-srcStageMask-04095",
|
|
"text": " If the <a href=\"#features-meshShader\"><code>meshShader</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_MESH_SHADER_BIT_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWaitEvents-srcStageMask-04096",
|
|
"text": " If the <a href=\"#features-taskShader\"><code>taskShader</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_TASK_SHADER_BIT_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWaitEvents-dstStageMask-04095",
|
|
"text": " If the <a href=\"#features-meshShader\"><code>meshShader</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_MESH_SHADER_BIT_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWaitEvents-dstStageMask-04096",
|
|
"text": " If the <a href=\"#features-taskShader\"><code>taskShader</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_TASK_SHADER_BIT_NV</code>"
|
|
}
|
|
],
|
|
"(VK_NV_shading_rate_image)": [
|
|
{
|
|
"vuid": "VUID-vkCmdWaitEvents-srcStageMask-04097",
|
|
"text": " If the <a href=\"#features-shadingRateImage\"><code>shadingRateImage</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_SHADING_RATE_IMAGE_BIT_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWaitEvents-dstStageMask-04097",
|
|
"text": " If the <a href=\"#features-shadingRateImage\"><code>shadingRateImage</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_SHADING_RATE_IMAGE_BIT_NV</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdWaitEvents-srcStageMask-03937",
|
|
"text": " If the <a href=\"#features-synchronization2\"><code>synchronization2</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWaitEvents-dstStageMask-03937",
|
|
"text": " If the <a href=\"#features-synchronization2\"><code>synchronization2</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWaitEvents-pEvents-03847",
|
|
"text": " Elements of <code>pEvents</code> <strong class=\"purple\">must</strong> not have been signaled by <a href=\"#vkCmdSetEvent2\">vkCmdSetEvent2</a>"
|
|
}
|
|
],
|
|
"!(VK_VERSION_1_3,VK_KHR_synchronization2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdWaitEvents-srcStageMask-04996",
|
|
"text": " pname:srcStageMask <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWaitEvents-dstStageMask-04996",
|
|
"text": " pname:dstStageMask <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_device_group)": [
|
|
{
|
|
"vuid": "VUID-vkCmdWaitEvents-commandBuffer-01167",
|
|
"text": " <code>commandBuffer</code>’s current device mask <strong class=\"purple\">must</strong> include exactly one physical device"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdPipelineBarrier2": {
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdPipelineBarrier2-pDependencies-02285",
|
|
"text": " If fname:vkCmdPipelineBarrier2 is called within a render pass instance, the render pass <strong class=\"purple\">must</strong> have been created with at least one <a href=\"#VkSubpassDependency\">VkSubpassDependency</a> instance in <code>VkRenderPassCreateInfo</code>::<code>pDependencies</code> that expresses a dependency from the current subpass to itself, with <a href=\"#synchronization-dependencies-scopes\">synchronization scopes</a> and <a href=\"#synchronization-dependencies-access-scopes\">access scopes</a> that are all supersets of the scopes defined in this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPipelineBarrier2-bufferMemoryBarrierCount-01178",
|
|
"text": " If fname:vkCmdPipelineBarrier2 is called within a render pass instance, it <strong class=\"purple\">must</strong> not include any buffer memory barriers"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPipelineBarrier2-image-04073",
|
|
"text": " If fname:vkCmdPipelineBarrier2 is called within a render pass instance, the <code>image</code> member of any image memory barrier included in this command <strong class=\"purple\">must</strong> be an attachment used in the current subpass both as an input attachment, and as either a color or depth/stencil attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPipelineBarrier2-oldLayout-01181",
|
|
"text": " If fname:vkCmdPipelineBarrier2 is called within a render pass instance, the <code>oldLayout</code> and <code>newLayout</code> members of any image memory barrier included in this command <strong class=\"purple\">must</strong> be equal"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPipelineBarrier2-srcQueueFamilyIndex-01182",
|
|
"text": " If fname:vkCmdPipelineBarrier2 is called within a render pass instance, the <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> members of any image memory barrier included in this command <strong class=\"purple\">must</strong> be equal"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPipelineBarrier2-synchronization2-03848",
|
|
"text": " The <a href=\"#features-synchronization2\"><code>synchronization2</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPipelineBarrier2-srcStageMask-03849",
|
|
"text": " The <code>srcStageMask</code> member of any element of the <code>pMemoryBarriers</code>, <code>pBufferMemoryBarriers</code>, or <code>pImageMemoryBarriers</code> members of <code>pDependencyInfo</code> <strong class=\"purple\">must</strong> only include pipeline stages valid for the queue family that was used to create the command pool that <code>commandBuffer</code> was allocated from"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPipelineBarrier2-dstStageMask-03850",
|
|
"text": " The <code>dstStageMask</code> member of any element of the <code>pMemoryBarriers</code>, <code>pBufferMemoryBarriers</code>, or <code>pImageMemoryBarriers</code> members of <code>pDependencyInfo</code> <strong class=\"purple\">must</strong> only include pipeline stages valid for the queue family that was used to create the command pool that <code>commandBuffer</code> was allocated from"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPipelineBarrier2-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPipelineBarrier2-pDependencyInfo-parameter",
|
|
"text": " <code>pDependencyInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkDependencyInfo\">VkDependencyInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPipelineBarrier2-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPipelineBarrier2-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support transfer, graphics, compute, decode, or encode operations"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_VERSION_1_1,VK_KHR_multiview)": [
|
|
{
|
|
"vuid": "VUID-vkCmdPipelineBarrier2-dependencyFlags-01186",
|
|
"text": " If fname:vkCmdPipelineBarrier2 is called outside of a render pass instance, <code>VK_DEPENDENCY_VIEW_LOCAL_BIT</code> <strong class=\"purple\">must</strong> not be included in the dependency flags"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)": [
|
|
{
|
|
"vuid": "VUID-vkCmdPipelineBarrier2-None-06191",
|
|
"text": " If fname:vkCmdPipelineBarrier2 is called within a render pass instance, the render pass <strong class=\"purple\">must</strong> not have been started with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdPipelineBarrier": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCmdPipelineBarrier-srcStageMask-04090",
|
|
"text": " If the <a href=\"#features-geometryShader\"><code>geometryShader</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_GEOMETRY_SHADER_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPipelineBarrier-srcStageMask-04091",
|
|
"text": " If the <a href=\"#features-tessellationShader\"><code>tessellationShader</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_TESSELLATION_CONTROL_SHADER_BIT</code> or <code>VK_PIPELINE_STAGE_TESSELLATION_EVALUATION_SHADER_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPipelineBarrier-dstStageMask-04090",
|
|
"text": " If the <a href=\"#features-geometryShader\"><code>geometryShader</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_GEOMETRY_SHADER_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPipelineBarrier-dstStageMask-04091",
|
|
"text": " If the <a href=\"#features-tessellationShader\"><code>tessellationShader</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_TESSELLATION_CONTROL_SHADER_BIT</code> or <code>VK_PIPELINE_STAGE_TESSELLATION_EVALUATION_SHADER_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPipelineBarrier-srcAccessMask-02815",
|
|
"text": " The <code>srcAccessMask</code> member of each element of <code>pMemoryBarriers</code> <strong class=\"purple\">must</strong> only include access flags that are supported by one or more of the pipeline stages in <code>srcStageMask</code>, as specified in the <a href=\"#synchronization-access-types-supported\">table of supported access types</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPipelineBarrier-dstAccessMask-02816",
|
|
"text": " The <code>dstAccessMask</code> member of each element of <code>pMemoryBarriers</code> <strong class=\"purple\">must</strong> only include access flags that are supported by one or more of the pipeline stages in <code>dstStageMask</code>, as specified in the <a href=\"#synchronization-access-types-supported\">table of supported access types</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPipelineBarrier-pBufferMemoryBarriers-02817",
|
|
"text": " For any element of <code>pBufferMemoryBarriers</code>, if its <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> members are equal, or if its <code>srcQueueFamilyIndex</code> is the queue family index that was used to create the command pool that <code>commandBuffer</code> was allocated from, then its <code>srcAccessMask</code> member <strong class=\"purple\">must</strong> only contain access flags that are supported by one or more of the pipeline stages in <code>srcStageMask</code>, as specified in the <a href=\"#synchronization-access-types-supported\">table of supported access types</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPipelineBarrier-pBufferMemoryBarriers-02818",
|
|
"text": " For any element of <code>pBufferMemoryBarriers</code>, if its <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> members are equal, or if its <code>dstQueueFamilyIndex</code> is the queue family index that was used to create the command pool that <code>commandBuffer</code> was allocated from, then its <code>dstAccessMask</code> member <strong class=\"purple\">must</strong> only contain access flags that are supported by one or more of the pipeline stages in <code>dstStageMask</code>, as specified in the <a href=\"#synchronization-access-types-supported\">table of supported access types</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPipelineBarrier-pImageMemoryBarriers-02819",
|
|
"text": " For any element of <code>pImageMemoryBarriers</code>, if its <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> members are equal, or if its <code>srcQueueFamilyIndex</code> is the queue family index that was used to create the command pool that <code>commandBuffer</code> was allocated from, then its <code>srcAccessMask</code> member <strong class=\"purple\">must</strong> only contain access flags that are supported by one or more of the pipeline stages in <code>srcStageMask</code>, as specified in the <a href=\"#synchronization-access-types-supported\">table of supported access types</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPipelineBarrier-pImageMemoryBarriers-02820",
|
|
"text": " For any element of <code>pImageMemoryBarriers</code>, if its <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> members are equal, or if its <code>dstQueueFamilyIndex</code> is the queue family index that was used to create the command pool that <code>commandBuffer</code> was allocated from, then its <code>dstAccessMask</code> member <strong class=\"purple\">must</strong> only contain access flags that are supported by one or more of the pipeline stages in <code>dstStageMask</code>, as specified in the <a href=\"#synchronization-access-types-supported\">table of supported access types</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPipelineBarrier-pDependencies-02285",
|
|
"text": " If fname:vkCmdPipelineBarrier is called within a render pass instance, the render pass <strong class=\"purple\">must</strong> have been created with at least one <a href=\"#VkSubpassDependency\">VkSubpassDependency</a> instance in <code>VkRenderPassCreateInfo</code>::<code>pDependencies</code> that expresses a dependency from the current subpass to itself, with <a href=\"#synchronization-dependencies-scopes\">synchronization scopes</a> and <a href=\"#synchronization-dependencies-access-scopes\">access scopes</a> that are all supersets of the scopes defined in this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPipelineBarrier-bufferMemoryBarrierCount-01178",
|
|
"text": " If fname:vkCmdPipelineBarrier is called within a render pass instance, it <strong class=\"purple\">must</strong> not include any buffer memory barriers"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPipelineBarrier-image-04073",
|
|
"text": " If fname:vkCmdPipelineBarrier is called within a render pass instance, the <code>image</code> member of any image memory barrier included in this command <strong class=\"purple\">must</strong> be an attachment used in the current subpass both as an input attachment, and as either a color or depth/stencil attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPipelineBarrier-oldLayout-01181",
|
|
"text": " If fname:vkCmdPipelineBarrier is called within a render pass instance, the <code>oldLayout</code> and <code>newLayout</code> members of any image memory barrier included in this command <strong class=\"purple\">must</strong> be equal"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPipelineBarrier-srcQueueFamilyIndex-01182",
|
|
"text": " If fname:vkCmdPipelineBarrier is called within a render pass instance, the <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> members of any image memory barrier included in this command <strong class=\"purple\">must</strong> be equal"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPipelineBarrier-srcStageMask-06461",
|
|
"text": " Any pipeline stage included in <code>srcStageMask</code> <strong class=\"purple\">must</strong> be supported by the capabilities of the queue family specified by the <code>queueFamilyIndex</code> member of the <a href=\"#VkCommandPoolCreateInfo\">VkCommandPoolCreateInfo</a> structure that was used to create the <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from, as specified in the <a href=\"#synchronization-pipeline-stages-supported\">table of supported pipeline stages</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPipelineBarrier-dstStageMask-06462",
|
|
"text": " Any pipeline stage included in <code>dstStageMask</code> <strong class=\"purple\">must</strong> be supported by the capabilities of the queue family specified by the <code>queueFamilyIndex</code> member of the <a href=\"#VkCommandPoolCreateInfo\">VkCommandPoolCreateInfo</a> structure that was used to create the <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from, as specified in the <a href=\"#synchronization-pipeline-stages-supported\">table of supported pipeline stages</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPipelineBarrier-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPipelineBarrier-srcStageMask-parameter",
|
|
"text": " <code>srcStageMask</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkPipelineStageFlagBits\">VkPipelineStageFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPipelineBarrier-dstStageMask-parameter",
|
|
"text": " <code>dstStageMask</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkPipelineStageFlagBits\">VkPipelineStageFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPipelineBarrier-dependencyFlags-parameter",
|
|
"text": " <code>dependencyFlags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkDependencyFlagBits\">VkDependencyFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPipelineBarrier-pMemoryBarriers-parameter",
|
|
"text": " If <code>memoryBarrierCount</code> is not <code>0</code>, <code>pMemoryBarriers</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>memoryBarrierCount</code> valid <a href=\"#VkMemoryBarrier\">VkMemoryBarrier</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPipelineBarrier-pBufferMemoryBarriers-parameter",
|
|
"text": " If <code>bufferMemoryBarrierCount</code> is not <code>0</code>, <code>pBufferMemoryBarriers</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>bufferMemoryBarrierCount</code> valid <a href=\"#VkBufferMemoryBarrier\">VkBufferMemoryBarrier</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPipelineBarrier-pImageMemoryBarriers-parameter",
|
|
"text": " If <code>imageMemoryBarrierCount</code> is not <code>0</code>, <code>pImageMemoryBarriers</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>imageMemoryBarrierCount</code> valid <a href=\"#VkImageMemoryBarrier\">VkImageMemoryBarrier</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPipelineBarrier-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPipelineBarrier-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support transfer, graphics, compute, decode, or encode operations"
|
|
}
|
|
],
|
|
"(VK_EXT_conditional_rendering)": [
|
|
{
|
|
"vuid": "VUID-vkCmdPipelineBarrier-srcStageMask-04092",
|
|
"text": " If the <a href=\"#features-conditionalRendering\"><code>conditionalRendering</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_CONDITIONAL_RENDERING_BIT_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPipelineBarrier-dstStageMask-04092",
|
|
"text": " If the <a href=\"#features-conditionalRendering\"><code>conditionalRendering</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_CONDITIONAL_RENDERING_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_fragment_density_map)": [
|
|
{
|
|
"vuid": "VUID-vkCmdPipelineBarrier-srcStageMask-04093",
|
|
"text": " If the <a href=\"#features-fragmentDensityMap\"><code>fragmentDensityMap</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_FRAGMENT_DENSITY_PROCESS_BIT_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPipelineBarrier-dstStageMask-04093",
|
|
"text": " If the <a href=\"#features-fragmentDensityMap\"><code>fragmentDensityMap</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_FRAGMENT_DENSITY_PROCESS_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)": [
|
|
{
|
|
"vuid": "VUID-vkCmdPipelineBarrier-srcStageMask-04094",
|
|
"text": " If the <a href=\"#features-transformFeedback\"><code>transformFeedback</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_TRANSFORM_FEEDBACK_BIT_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPipelineBarrier-dstStageMask-04094",
|
|
"text": " If the <a href=\"#features-transformFeedback\"><code>transformFeedback</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_TRANSFORM_FEEDBACK_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)": [
|
|
{
|
|
"vuid": "VUID-vkCmdPipelineBarrier-srcStageMask-04095",
|
|
"text": " If the <a href=\"#features-meshShader\"><code>meshShader</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_MESH_SHADER_BIT_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPipelineBarrier-srcStageMask-04096",
|
|
"text": " If the <a href=\"#features-taskShader\"><code>taskShader</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_TASK_SHADER_BIT_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPipelineBarrier-dstStageMask-04095",
|
|
"text": " If the <a href=\"#features-meshShader\"><code>meshShader</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_MESH_SHADER_BIT_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPipelineBarrier-dstStageMask-04096",
|
|
"text": " If the <a href=\"#features-taskShader\"><code>taskShader</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_TASK_SHADER_BIT_NV</code>"
|
|
}
|
|
],
|
|
"(VK_NV_shading_rate_image)": [
|
|
{
|
|
"vuid": "VUID-vkCmdPipelineBarrier-srcStageMask-04097",
|
|
"text": " If the <a href=\"#features-shadingRateImage\"><code>shadingRateImage</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_SHADING_RATE_IMAGE_BIT_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPipelineBarrier-dstStageMask-04097",
|
|
"text": " If the <a href=\"#features-shadingRateImage\"><code>shadingRateImage</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_SHADING_RATE_IMAGE_BIT_NV</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdPipelineBarrier-srcStageMask-03937",
|
|
"text": " If the <a href=\"#features-synchronization2\"><code>synchronization2</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPipelineBarrier-dstStageMask-03937",
|
|
"text": " If the <a href=\"#features-synchronization2\"><code>synchronization2</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
}
|
|
],
|
|
"!(VK_VERSION_1_3,VK_KHR_synchronization2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdPipelineBarrier-srcStageMask-04996",
|
|
"text": " pname:srcStageMask <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPipelineBarrier-dstStageMask-04996",
|
|
"text": " pname:dstStageMask <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_multiview)": [
|
|
{
|
|
"vuid": "VUID-vkCmdPipelineBarrier-dependencyFlags-01186",
|
|
"text": " If fname:vkCmdPipelineBarrier is called outside of a render pass instance, <code>VK_DEPENDENCY_VIEW_LOCAL_BIT</code> <strong class=\"purple\">must</strong> not be included in the dependency flags"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)": [
|
|
{
|
|
"vuid": "VUID-vkCmdPipelineBarrier-None-06191",
|
|
"text": " If fname:vkCmdPipelineBarrier is called within a render pass instance, the render pass <strong class=\"purple\">must</strong> not have been started with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>"
|
|
}
|
|
]
|
|
},
|
|
"VkMemoryBarrier2": {
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)": [
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-srcStageMask-03929",
|
|
"text": " If the <a href=\"#features-geometryShader\"><code>geometryShader</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_GEOMETRY_SHADER_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-srcStageMask-03930",
|
|
"text": " If the <a href=\"#features-tessellationShader\"><code>tessellationShader</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_TESSELLATION_CONTROL_SHADER_BIT</code> or <code>VK_PIPELINE_STAGE_2_TESSELLATION_EVALUATION_SHADER_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-srcAccessMask-03900",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_INDIRECT_COMMAND_READ_BIT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_DRAW_INDIRECT_BIT</code>, <code>VK_PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_BUILD_BIT_KHR</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-srcAccessMask-03901",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_INDEX_READ_BIT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_INDEX_INPUT_BIT</code>, <code>VK_PIPELINE_STAGE_2_VERTEX_INPUT_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-srcAccessMask-03902",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_VERTEX_ATTRIBUTE_READ_BIT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_VERTEX_ATTRIBUTE_INPUT_BIT</code>, <code>VK_PIPELINE_STAGE_2_VERTEX_INPUT_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-srcAccessMask-03903",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_INPUT_ATTACHMENT_READ_BIT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_FRAGMENT_SHADER_BIT</code>, <code>VK_PIPELINE_STAGE_2_SUBPASS_SHADING_BIT_HUAWEI</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-srcAccessMask-03904",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_UNIFORM_READ_BIT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>, or one of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-srcAccessMask-03905",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_SHADER_SAMPLED_READ_BIT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>, or one of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-srcAccessMask-03906",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_SHADER_STORAGE_READ_BIT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>, or one of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-srcAccessMask-03907",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_SHADER_STORAGE_WRITE_BIT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>, or one of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-srcAccessMask-03908",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_SHADER_READ_BIT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>, <code>VK_PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_BUILD_BIT_KHR</code>, or one of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-srcAccessMask-03909",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_SHADER_WRITE_BIT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>, or one of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-srcAccessMask-03910",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_COLOR_ATTACHMENT_READ_BIT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_COLOR_ATTACHMENT_OUTPUT_BIT</code> <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-srcAccessMask-03911",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_COLOR_ATTACHMENT_WRITE_BIT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_COLOR_ATTACHMENT_OUTPUT_BIT</code> <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-srcAccessMask-03912",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_DEPTH_STENCIL_ATTACHMENT_READ_BIT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_EARLY_FRAGMENT_TESTS_BIT</code>, <code>VK_PIPELINE_STAGE_2_LATE_FRAGMENT_TESTS_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-srcAccessMask-03913",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_DEPTH_STENCIL_ATTACHMENT_WRITE_BIT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_EARLY_FRAGMENT_TESTS_BIT</code>, <code>VK_PIPELINE_STAGE_2_LATE_FRAGMENT_TESTS_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-srcAccessMask-03914",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_TRANSFER_READ_BIT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_COPY_BIT</code>, <code>VK_PIPELINE_STAGE_2_BLIT_BIT</code>, <code>VK_PIPELINE_STAGE_2_RESOLVE_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_TRANSFER_BIT</code>, <code>VK_PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_BUILD_BIT_KHR</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-srcAccessMask-03915",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_TRANSFER_WRITE_BIT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_COPY_BIT</code>, <code>VK_PIPELINE_STAGE_2_BLIT_BIT</code>, <code>VK_PIPELINE_STAGE_2_RESOLVE_BIT</code>, <code>VK_PIPELINE_STAGE_2_CLEAR_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_TRANSFER_BIT</code>, <code>VK_PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_BUILD_BIT_KHR</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-srcAccessMask-03916",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_HOST_READ_BIT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_HOST_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-srcAccessMask-03917",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_HOST_WRITE_BIT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_HOST_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-dstStageMask-03929",
|
|
"text": " If the <a href=\"#features-geometryShader\"><code>geometryShader</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_GEOMETRY_SHADER_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-dstStageMask-03930",
|
|
"text": " If the <a href=\"#features-tessellationShader\"><code>tessellationShader</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_TESSELLATION_CONTROL_SHADER_BIT</code> or <code>VK_PIPELINE_STAGE_2_TESSELLATION_EVALUATION_SHADER_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-dstAccessMask-03900",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_INDIRECT_COMMAND_READ_BIT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_DRAW_INDIRECT_BIT</code>, <code>VK_PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_BUILD_BIT_KHR</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-dstAccessMask-03901",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_INDEX_READ_BIT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_INDEX_INPUT_BIT</code>, <code>VK_PIPELINE_STAGE_2_VERTEX_INPUT_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-dstAccessMask-03902",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_VERTEX_ATTRIBUTE_READ_BIT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_VERTEX_ATTRIBUTE_INPUT_BIT</code>, <code>VK_PIPELINE_STAGE_2_VERTEX_INPUT_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-dstAccessMask-03903",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_INPUT_ATTACHMENT_READ_BIT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_FRAGMENT_SHADER_BIT</code>, <code>VK_PIPELINE_STAGE_2_SUBPASS_SHADING_BIT_HUAWEI</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-dstAccessMask-03904",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_UNIFORM_READ_BIT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>, or one of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-dstAccessMask-03905",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_SHADER_SAMPLED_READ_BIT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>, or one of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-dstAccessMask-03906",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_SHADER_STORAGE_READ_BIT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>, or one of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-dstAccessMask-03907",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_SHADER_STORAGE_WRITE_BIT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>, or one of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-dstAccessMask-03908",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_SHADER_READ_BIT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>, <code>VK_PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_BUILD_BIT_KHR</code>, or one of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-dstAccessMask-03909",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_SHADER_WRITE_BIT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>, or one of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-dstAccessMask-03910",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_COLOR_ATTACHMENT_READ_BIT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_COLOR_ATTACHMENT_OUTPUT_BIT</code> <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-dstAccessMask-03911",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_COLOR_ATTACHMENT_WRITE_BIT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_COLOR_ATTACHMENT_OUTPUT_BIT</code> <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-dstAccessMask-03912",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_DEPTH_STENCIL_ATTACHMENT_READ_BIT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_EARLY_FRAGMENT_TESTS_BIT</code>, <code>VK_PIPELINE_STAGE_2_LATE_FRAGMENT_TESTS_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-dstAccessMask-03913",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_DEPTH_STENCIL_ATTACHMENT_WRITE_BIT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_EARLY_FRAGMENT_TESTS_BIT</code>, <code>VK_PIPELINE_STAGE_2_LATE_FRAGMENT_TESTS_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-dstAccessMask-03914",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_TRANSFER_READ_BIT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_COPY_BIT</code>, <code>VK_PIPELINE_STAGE_2_BLIT_BIT</code>, <code>VK_PIPELINE_STAGE_2_RESOLVE_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_TRANSFER_BIT</code>, <code>VK_PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_BUILD_BIT_KHR</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-dstAccessMask-03915",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_TRANSFER_WRITE_BIT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_COPY_BIT</code>, <code>VK_PIPELINE_STAGE_2_BLIT_BIT</code>, <code>VK_PIPELINE_STAGE_2_RESOLVE_BIT</code>, <code>VK_PIPELINE_STAGE_2_CLEAR_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_TRANSFER_BIT</code>, <code>VK_PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_BUILD_BIT_KHR</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-dstAccessMask-03916",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_HOST_READ_BIT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_HOST_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-dstAccessMask-03917",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_HOST_WRITE_BIT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_HOST_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_MEMORY_BARRIER_2</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-srcStageMask-parameter",
|
|
"text": " <code>srcStageMask</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkPipelineStageFlagBits2\">VkPipelineStageFlagBits2</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-srcAccessMask-parameter",
|
|
"text": " <code>srcAccessMask</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkAccessFlagBits2\">VkAccessFlagBits2</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-dstStageMask-parameter",
|
|
"text": " <code>dstStageMask</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkPipelineStageFlagBits2\">VkPipelineStageFlagBits2</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-dstAccessMask-parameter",
|
|
"text": " <code>dstAccessMask</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkAccessFlagBits2\">VkAccessFlagBits2</a> values"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_EXT_conditional_rendering)": [
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-srcStageMask-03931",
|
|
"text": " If the <a href=\"#features-conditionalRendering\"><code>conditionalRendering</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_CONDITIONAL_RENDERING_BIT_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-srcAccessMask-03918",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_CONDITIONAL_RENDERING_READ_BIT_EXT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_CONDITIONAL_RENDERING_BIT_EXT</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-dstStageMask-03931",
|
|
"text": " If the <a href=\"#features-conditionalRendering\"><code>conditionalRendering</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_CONDITIONAL_RENDERING_BIT_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-dstAccessMask-03918",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_CONDITIONAL_RENDERING_READ_BIT_EXT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_CONDITIONAL_RENDERING_BIT_EXT</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_EXT_fragment_density_map)": [
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-srcStageMask-03932",
|
|
"text": " If the <a href=\"#features-fragmentDensityMap\"><code>fragmentDensityMap</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_FRAGMENT_DENSITY_PROCESS_BIT_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-srcAccessMask-03919",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_FRAGMENT_DENSITY_MAP_READ_BIT_EXT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_FRAGMENT_DENSITY_PROCESS_BIT_EXT</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-dstStageMask-03932",
|
|
"text": " If the <a href=\"#features-fragmentDensityMap\"><code>fragmentDensityMap</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_FRAGMENT_DENSITY_PROCESS_BIT_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-dstAccessMask-03919",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_FRAGMENT_DENSITY_MAP_READ_BIT_EXT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_FRAGMENT_DENSITY_PROCESS_BIT_EXT</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_EXT_transform_feedback)": [
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-srcStageMask-03933",
|
|
"text": " If the <a href=\"#features-transformFeedback\"><code>transformFeedback</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_TRANSFORM_FEEDBACK_BIT_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-srcAccessMask-03920",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_TRANSFORM_FEEDBACK_WRITE_BIT_EXT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_TRANSFORM_FEEDBACK_BIT_EXT</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-srcAccessMask-04747",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_TRANSFORM_FEEDBACK_COUNTER_READ_BIT_EXT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_DRAW_INDIRECT_BIT</code>, <code>VK_PIPELINE_STAGE_2_TRANSFORM_FEEDBACK_BIT_EXT</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-srcAccessMask-03922",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_TRANSFORM_FEEDBACK_COUNTER_WRITE_BIT_EXT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_TRANSFORM_FEEDBACK_BIT_EXT</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-dstStageMask-03933",
|
|
"text": " If the <a href=\"#features-transformFeedback\"><code>transformFeedback</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_TRANSFORM_FEEDBACK_BIT_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-dstAccessMask-03920",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_TRANSFORM_FEEDBACK_WRITE_BIT_EXT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_TRANSFORM_FEEDBACK_BIT_EXT</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-dstAccessMask-04747",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_TRANSFORM_FEEDBACK_COUNTER_READ_BIT_EXT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_DRAW_INDIRECT_BIT</code>, <code>VK_PIPELINE_STAGE_2_TRANSFORM_FEEDBACK_BIT_EXT</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-dstAccessMask-03922",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_TRANSFORM_FEEDBACK_COUNTER_WRITE_BIT_EXT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_TRANSFORM_FEEDBACK_BIT_EXT</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_NV_mesh_shader)": [
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-srcStageMask-03934",
|
|
"text": " If the <a href=\"#features-meshShader\"><code>meshShader</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_MESH_SHADER_BIT_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-srcStageMask-03935",
|
|
"text": " If the <a href=\"#features-taskShader\"><code>taskShader</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_TASK_SHADER_BIT_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-dstStageMask-03934",
|
|
"text": " If the <a href=\"#features-meshShader\"><code>meshShader</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_MESH_SHADER_BIT_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-dstStageMask-03935",
|
|
"text": " If the <a href=\"#features-taskShader\"><code>taskShader</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_TASK_SHADER_BIT_NV</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_NV_shading_rate_image)": [
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-srcStageMask-04956",
|
|
"text": " If the <a href=\"#features-shadingRateImage\"><code>shadingRateImage</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_SHADING_RATE_IMAGE_BIT_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-srcAccessMask-03923",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_SHADING_RATE_IMAGE_READ_BIT_NV</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_SHADING_RATE_IMAGE_BIT_NV</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-dstStageMask-04956",
|
|
"text": " If the <a href=\"#features-shadingRateImage\"><code>shadingRateImage</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_SHADING_RATE_IMAGE_BIT_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-dstAccessMask-03923",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_SHADING_RATE_IMAGE_READ_BIT_NV</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_SHADING_RATE_IMAGE_BIT_NV</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_HUAWEI_subpass_shading)": [
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-srcStageMask-04957",
|
|
"text": " If the <a href=\"#features-subpassShading\"><code>subpassShading</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_SUBPASS_SHADING_BIT_HUAWEI</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-dstStageMask-04957",
|
|
"text": " If the <a href=\"#features-subpassShading\"><code>subpassShading</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_SUBPASS_SHADING_BIT_HUAWEI</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_HUAWEI_invocation_mask)": [
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-srcStageMask-04995",
|
|
"text": " If the <a href=\"#features-invocationMask\"><code>invocationMask</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_INVOCATION_MASK_BIT_HUAWEI</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-srcAccessMask-04994",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_INVOCATION_MASK_READ_BIT_HUAWEI</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_INVOCATION_MASK_BIT_HUAWEI</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-dstStageMask-04995",
|
|
"text": " If the <a href=\"#features-invocationMask\"><code>invocationMask</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_INVOCATION_MASK_BIT_HUAWEI</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-dstAccessMask-04994",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_INVOCATION_MASK_READ_BIT_HUAWEI</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_INVOCATION_MASK_BIT_HUAWEI</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_NV_device_generated_commands)": [
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-srcAccessMask-03924",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_COMMAND_PREPROCESS_READ_BIT_NV</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_COMMAND_PREPROCESS_BIT_NV</code> or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-srcAccessMask-03925",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_COMMAND_PREPROCESS_WRITE_BIT_NV</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_COMMAND_PREPROCESS_BIT_NV</code> or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-dstAccessMask-03924",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_COMMAND_PREPROCESS_READ_BIT_NV</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_COMMAND_PREPROCESS_BIT_NV</code> or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-dstAccessMask-03925",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_COMMAND_PREPROCESS_WRITE_BIT_NV</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_COMMAND_PREPROCESS_BIT_NV</code> or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_EXT_blend_operation_advanced)": [
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-srcAccessMask-03926",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_COLOR_ATTACHMENT_READ_NONCOHERENT_BIT_EXT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_COLOR_ATTACHMENT_OUTPUT_BIT</code> <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-dstAccessMask-03926",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_COLOR_ATTACHMENT_READ_NONCOHERENT_BIT_EXT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_COLOR_ATTACHMENT_OUTPUT_BIT</code> <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_KHR_acceleration_structure,VK_NV_ray_tracing)": [
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-srcAccessMask-03927",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_ACCELERATION_STRUCTURE_READ_BIT_KHR</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_BUILD_BIT_KHR</code>, <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>, or one of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-srcAccessMask-03928",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_ACCELERATION_STRUCTURE_WRITE_BIT_KHR</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_BUILD_BIT_KHR</code> or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-dstAccessMask-03927",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_ACCELERATION_STRUCTURE_READ_BIT_KHR</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_BUILD_BIT_KHR</code>, <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>, or one of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-dstAccessMask-03928",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_ACCELERATION_STRUCTURE_WRITE_BIT_KHR</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_BUILD_BIT_KHR</code> or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_KHR_acceleration_structure,VK_NV_ray_tracing)+!(VK_KHR_ray_query)+(VK_KHR_ray_tracing_pipeline,VK_NV_ray_tracing)": [
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-srcAccessMask-06254",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_ACCELERATION_STRUCTURE_READ_BIT_KHR</code>, pname:srcStageMask <strong class=\"purple\">must</strong> not include any of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages except <code>VK_PIPELINE_STAGE_2_RAY_TRACING_SHADER_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-dstAccessMask-06254",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_ACCELERATION_STRUCTURE_READ_BIT_KHR</code>, pname:dstStageMask <strong class=\"purple\">must</strong> not include any of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages except <code>VK_PIPELINE_STAGE_2_RAY_TRACING_SHADER_BIT_KHR</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_KHR_acceleration_structure,VK_NV_ray_tracing)+!(VK_KHR_ray_query)+!(VK_KHR_ray_tracing_pipeline,VK_NV_ray_tracing)": [
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-srcAccessMask-06255",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_ACCELERATION_STRUCTURE_READ_BIT_KHR</code>, pname:srcStageMask <strong class=\"purple\">must</strong> not include any of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-dstAccessMask-06255",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_ACCELERATION_STRUCTURE_READ_BIT_KHR</code>, pname:dstStageMask <strong class=\"purple\">must</strong> not include any of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_KHR_acceleration_structure,VK_NV_ray_tracing)+(VK_KHR_ray_query)+(VK_KHR_ray_tracing_pipeline,VK_NV_ray_tracing)": [
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-srcAccessMask-06256",
|
|
"text": " If the <a href=\"#features-rayQuery\"><code>rayQuery</code></a> feature is not enabled and pname:srcAccessMask includes <code>VK_ACCESS_2_ACCELERATION_STRUCTURE_READ_BIT_KHR</code>, pname:srcStageMask <strong class=\"purple\">must</strong> not include any of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages except <code>VK_PIPELINE_STAGE_2_RAY_TRACING_SHADER_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-dstAccessMask-06256",
|
|
"text": " If the <a href=\"#features-rayQuery\"><code>rayQuery</code></a> feature is not enabled and pname:dstAccessMask includes <code>VK_ACCESS_2_ACCELERATION_STRUCTURE_READ_BIT_KHR</code>, pname:dstStageMask <strong class=\"purple\">must</strong> not include any of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages except <code>VK_PIPELINE_STAGE_2_RAY_TRACING_SHADER_BIT_KHR</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_KHR_acceleration_structure,VK_NV_ray_tracing)+(VK_KHR_ray_query)+!(VK_KHR_ray_tracing_pipeline,VK_NV_ray_tracing)": [
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-srcAccessMask-06257",
|
|
"text": " If the <a href=\"#features-rayQuery\"><code>rayQuery</code></a> feature is not enabled and pname:srcAccessMask includes <code>VK_ACCESS_2_ACCELERATION_STRUCTURE_READ_BIT_KHR</code>, pname:srcStageMask <strong class=\"purple\">must</strong> not include any of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-dstAccessMask-06257",
|
|
"text": " If the <a href=\"#features-rayQuery\"><code>rayQuery</code></a> feature is not enabled and pname:dstAccessMask includes <code>VK_ACCESS_2_ACCELERATION_STRUCTURE_READ_BIT_KHR</code>, pname:dstStageMask <strong class=\"purple\">must</strong> not include any of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_KHR_video_decode_queue)": [
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-srcAccessMask-04858",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_VIDEO_DECODE_READ_BIT_KHR</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_VIDEO_DECODE_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-srcAccessMask-04859",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_VIDEO_DECODE_WRITE_BIT_KHR</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_VIDEO_DECODE_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-dstAccessMask-04858",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_VIDEO_DECODE_READ_BIT_KHR</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_VIDEO_DECODE_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-dstAccessMask-04859",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_VIDEO_DECODE_WRITE_BIT_KHR</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_VIDEO_DECODE_BIT_KHR</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_KHR_video_encode_queue)": [
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-srcAccessMask-04860",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_VIDEO_ENCODE_READ_BIT_KHR</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_VIDEO_ENCODE_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-srcAccessMask-04861",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_VIDEO_ENCODE_WRITE_BIT_KHR</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_VIDEO_ENCODE_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-dstAccessMask-04860",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_VIDEO_ENCODE_READ_BIT_KHR</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_VIDEO_ENCODE_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier2-dstAccessMask-04861",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_VIDEO_ENCODE_WRITE_BIT_KHR</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_VIDEO_ENCODE_BIT_KHR</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkMemoryBarrier": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_MEMORY_BARRIER</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier-srcAccessMask-parameter",
|
|
"text": " <code>srcAccessMask</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkAccessFlagBits\">VkAccessFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryBarrier-dstAccessMask-parameter",
|
|
"text": " <code>dstAccessMask</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkAccessFlagBits\">VkAccessFlagBits</a> values"
|
|
}
|
|
]
|
|
},
|
|
"VkBufferMemoryBarrier2": {
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)": [
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-srcStageMask-03929",
|
|
"text": " If the <a href=\"#features-geometryShader\"><code>geometryShader</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_GEOMETRY_SHADER_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-srcStageMask-03930",
|
|
"text": " If the <a href=\"#features-tessellationShader\"><code>tessellationShader</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_TESSELLATION_CONTROL_SHADER_BIT</code> or <code>VK_PIPELINE_STAGE_2_TESSELLATION_EVALUATION_SHADER_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-srcAccessMask-03900",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_INDIRECT_COMMAND_READ_BIT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_DRAW_INDIRECT_BIT</code>, <code>VK_PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_BUILD_BIT_KHR</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-srcAccessMask-03901",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_INDEX_READ_BIT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_INDEX_INPUT_BIT</code>, <code>VK_PIPELINE_STAGE_2_VERTEX_INPUT_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-srcAccessMask-03902",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_VERTEX_ATTRIBUTE_READ_BIT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_VERTEX_ATTRIBUTE_INPUT_BIT</code>, <code>VK_PIPELINE_STAGE_2_VERTEX_INPUT_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-srcAccessMask-03903",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_INPUT_ATTACHMENT_READ_BIT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_FRAGMENT_SHADER_BIT</code>, <code>VK_PIPELINE_STAGE_2_SUBPASS_SHADING_BIT_HUAWEI</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-srcAccessMask-03904",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_UNIFORM_READ_BIT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>, or one of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-srcAccessMask-03905",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_SHADER_SAMPLED_READ_BIT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>, or one of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-srcAccessMask-03906",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_SHADER_STORAGE_READ_BIT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>, or one of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-srcAccessMask-03907",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_SHADER_STORAGE_WRITE_BIT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>, or one of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-srcAccessMask-03908",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_SHADER_READ_BIT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>, <code>VK_PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_BUILD_BIT_KHR</code>, or one of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-srcAccessMask-03909",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_SHADER_WRITE_BIT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>, or one of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-srcAccessMask-03910",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_COLOR_ATTACHMENT_READ_BIT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_COLOR_ATTACHMENT_OUTPUT_BIT</code> <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-srcAccessMask-03911",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_COLOR_ATTACHMENT_WRITE_BIT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_COLOR_ATTACHMENT_OUTPUT_BIT</code> <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-srcAccessMask-03912",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_DEPTH_STENCIL_ATTACHMENT_READ_BIT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_EARLY_FRAGMENT_TESTS_BIT</code>, <code>VK_PIPELINE_STAGE_2_LATE_FRAGMENT_TESTS_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-srcAccessMask-03913",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_DEPTH_STENCIL_ATTACHMENT_WRITE_BIT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_EARLY_FRAGMENT_TESTS_BIT</code>, <code>VK_PIPELINE_STAGE_2_LATE_FRAGMENT_TESTS_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-srcAccessMask-03914",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_TRANSFER_READ_BIT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_COPY_BIT</code>, <code>VK_PIPELINE_STAGE_2_BLIT_BIT</code>, <code>VK_PIPELINE_STAGE_2_RESOLVE_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_TRANSFER_BIT</code>, <code>VK_PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_BUILD_BIT_KHR</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-srcAccessMask-03915",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_TRANSFER_WRITE_BIT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_COPY_BIT</code>, <code>VK_PIPELINE_STAGE_2_BLIT_BIT</code>, <code>VK_PIPELINE_STAGE_2_RESOLVE_BIT</code>, <code>VK_PIPELINE_STAGE_2_CLEAR_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_TRANSFER_BIT</code>, <code>VK_PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_BUILD_BIT_KHR</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-srcAccessMask-03916",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_HOST_READ_BIT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_HOST_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-srcAccessMask-03917",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_HOST_WRITE_BIT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_HOST_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-dstStageMask-03929",
|
|
"text": " If the <a href=\"#features-geometryShader\"><code>geometryShader</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_GEOMETRY_SHADER_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-dstStageMask-03930",
|
|
"text": " If the <a href=\"#features-tessellationShader\"><code>tessellationShader</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_TESSELLATION_CONTROL_SHADER_BIT</code> or <code>VK_PIPELINE_STAGE_2_TESSELLATION_EVALUATION_SHADER_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-dstAccessMask-03900",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_INDIRECT_COMMAND_READ_BIT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_DRAW_INDIRECT_BIT</code>, <code>VK_PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_BUILD_BIT_KHR</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-dstAccessMask-03901",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_INDEX_READ_BIT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_INDEX_INPUT_BIT</code>, <code>VK_PIPELINE_STAGE_2_VERTEX_INPUT_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-dstAccessMask-03902",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_VERTEX_ATTRIBUTE_READ_BIT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_VERTEX_ATTRIBUTE_INPUT_BIT</code>, <code>VK_PIPELINE_STAGE_2_VERTEX_INPUT_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-dstAccessMask-03903",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_INPUT_ATTACHMENT_READ_BIT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_FRAGMENT_SHADER_BIT</code>, <code>VK_PIPELINE_STAGE_2_SUBPASS_SHADING_BIT_HUAWEI</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-dstAccessMask-03904",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_UNIFORM_READ_BIT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>, or one of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-dstAccessMask-03905",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_SHADER_SAMPLED_READ_BIT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>, or one of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-dstAccessMask-03906",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_SHADER_STORAGE_READ_BIT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>, or one of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-dstAccessMask-03907",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_SHADER_STORAGE_WRITE_BIT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>, or one of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-dstAccessMask-03908",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_SHADER_READ_BIT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>, <code>VK_PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_BUILD_BIT_KHR</code>, or one of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-dstAccessMask-03909",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_SHADER_WRITE_BIT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>, or one of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-dstAccessMask-03910",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_COLOR_ATTACHMENT_READ_BIT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_COLOR_ATTACHMENT_OUTPUT_BIT</code> <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-dstAccessMask-03911",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_COLOR_ATTACHMENT_WRITE_BIT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_COLOR_ATTACHMENT_OUTPUT_BIT</code> <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-dstAccessMask-03912",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_DEPTH_STENCIL_ATTACHMENT_READ_BIT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_EARLY_FRAGMENT_TESTS_BIT</code>, <code>VK_PIPELINE_STAGE_2_LATE_FRAGMENT_TESTS_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-dstAccessMask-03913",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_DEPTH_STENCIL_ATTACHMENT_WRITE_BIT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_EARLY_FRAGMENT_TESTS_BIT</code>, <code>VK_PIPELINE_STAGE_2_LATE_FRAGMENT_TESTS_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-dstAccessMask-03914",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_TRANSFER_READ_BIT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_COPY_BIT</code>, <code>VK_PIPELINE_STAGE_2_BLIT_BIT</code>, <code>VK_PIPELINE_STAGE_2_RESOLVE_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_TRANSFER_BIT</code>, <code>VK_PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_BUILD_BIT_KHR</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-dstAccessMask-03915",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_TRANSFER_WRITE_BIT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_COPY_BIT</code>, <code>VK_PIPELINE_STAGE_2_BLIT_BIT</code>, <code>VK_PIPELINE_STAGE_2_RESOLVE_BIT</code>, <code>VK_PIPELINE_STAGE_2_CLEAR_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_TRANSFER_BIT</code>, <code>VK_PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_BUILD_BIT_KHR</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-dstAccessMask-03916",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_HOST_READ_BIT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_HOST_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-dstAccessMask-03917",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_HOST_WRITE_BIT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_HOST_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-offset-01187",
|
|
"text": " <code>offset</code> <strong class=\"purple\">must</strong> be less than the size of <code>buffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-size-01188",
|
|
"text": " If <code>size</code> is not equal to <code>VK_WHOLE_SIZE</code>, <code>size</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-size-01189",
|
|
"text": " If <code>size</code> is not equal to <code>VK_WHOLE_SIZE</code>, <code>size</code> <strong class=\"purple\">must</strong> be less than or equal to than the size of <code>buffer</code> minus <code>offset</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-buffer-01931",
|
|
"text": " If <code>buffer</code> is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-srcStageMask-03851",
|
|
"text": " If either <code>srcStageMask</code> or <code>dstStageMask</code> includes <code>VK_PIPELINE_STAGE_2_HOST_BIT</code>, <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> <strong class=\"purple\">must</strong> be equal"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_BUFFER_MEMORY_BARRIER_2</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-srcStageMask-parameter",
|
|
"text": " <code>srcStageMask</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkPipelineStageFlagBits2\">VkPipelineStageFlagBits2</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-srcAccessMask-parameter",
|
|
"text": " <code>srcAccessMask</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkAccessFlagBits2\">VkAccessFlagBits2</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-dstStageMask-parameter",
|
|
"text": " <code>dstStageMask</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkPipelineStageFlagBits2\">VkPipelineStageFlagBits2</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-dstAccessMask-parameter",
|
|
"text": " <code>dstAccessMask</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkAccessFlagBits2\">VkAccessFlagBits2</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-buffer-parameter",
|
|
"text": " <code>buffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBuffer\">VkBuffer</a> handle"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_EXT_conditional_rendering)": [
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-srcStageMask-03931",
|
|
"text": " If the <a href=\"#features-conditionalRendering\"><code>conditionalRendering</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_CONDITIONAL_RENDERING_BIT_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-srcAccessMask-03918",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_CONDITIONAL_RENDERING_READ_BIT_EXT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_CONDITIONAL_RENDERING_BIT_EXT</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-dstStageMask-03931",
|
|
"text": " If the <a href=\"#features-conditionalRendering\"><code>conditionalRendering</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_CONDITIONAL_RENDERING_BIT_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-dstAccessMask-03918",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_CONDITIONAL_RENDERING_READ_BIT_EXT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_CONDITIONAL_RENDERING_BIT_EXT</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_EXT_fragment_density_map)": [
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-srcStageMask-03932",
|
|
"text": " If the <a href=\"#features-fragmentDensityMap\"><code>fragmentDensityMap</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_FRAGMENT_DENSITY_PROCESS_BIT_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-srcAccessMask-03919",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_FRAGMENT_DENSITY_MAP_READ_BIT_EXT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_FRAGMENT_DENSITY_PROCESS_BIT_EXT</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-dstStageMask-03932",
|
|
"text": " If the <a href=\"#features-fragmentDensityMap\"><code>fragmentDensityMap</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_FRAGMENT_DENSITY_PROCESS_BIT_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-dstAccessMask-03919",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_FRAGMENT_DENSITY_MAP_READ_BIT_EXT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_FRAGMENT_DENSITY_PROCESS_BIT_EXT</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_EXT_transform_feedback)": [
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-srcStageMask-03933",
|
|
"text": " If the <a href=\"#features-transformFeedback\"><code>transformFeedback</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_TRANSFORM_FEEDBACK_BIT_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-srcAccessMask-03920",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_TRANSFORM_FEEDBACK_WRITE_BIT_EXT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_TRANSFORM_FEEDBACK_BIT_EXT</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-srcAccessMask-04747",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_TRANSFORM_FEEDBACK_COUNTER_READ_BIT_EXT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_DRAW_INDIRECT_BIT</code>, <code>VK_PIPELINE_STAGE_2_TRANSFORM_FEEDBACK_BIT_EXT</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-srcAccessMask-03922",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_TRANSFORM_FEEDBACK_COUNTER_WRITE_BIT_EXT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_TRANSFORM_FEEDBACK_BIT_EXT</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-dstStageMask-03933",
|
|
"text": " If the <a href=\"#features-transformFeedback\"><code>transformFeedback</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_TRANSFORM_FEEDBACK_BIT_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-dstAccessMask-03920",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_TRANSFORM_FEEDBACK_WRITE_BIT_EXT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_TRANSFORM_FEEDBACK_BIT_EXT</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-dstAccessMask-04747",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_TRANSFORM_FEEDBACK_COUNTER_READ_BIT_EXT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_DRAW_INDIRECT_BIT</code>, <code>VK_PIPELINE_STAGE_2_TRANSFORM_FEEDBACK_BIT_EXT</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-dstAccessMask-03922",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_TRANSFORM_FEEDBACK_COUNTER_WRITE_BIT_EXT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_TRANSFORM_FEEDBACK_BIT_EXT</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_NV_mesh_shader)": [
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-srcStageMask-03934",
|
|
"text": " If the <a href=\"#features-meshShader\"><code>meshShader</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_MESH_SHADER_BIT_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-srcStageMask-03935",
|
|
"text": " If the <a href=\"#features-taskShader\"><code>taskShader</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_TASK_SHADER_BIT_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-dstStageMask-03934",
|
|
"text": " If the <a href=\"#features-meshShader\"><code>meshShader</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_MESH_SHADER_BIT_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-dstStageMask-03935",
|
|
"text": " If the <a href=\"#features-taskShader\"><code>taskShader</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_TASK_SHADER_BIT_NV</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_NV_shading_rate_image)": [
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-srcStageMask-04956",
|
|
"text": " If the <a href=\"#features-shadingRateImage\"><code>shadingRateImage</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_SHADING_RATE_IMAGE_BIT_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-srcAccessMask-03923",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_SHADING_RATE_IMAGE_READ_BIT_NV</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_SHADING_RATE_IMAGE_BIT_NV</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-dstStageMask-04956",
|
|
"text": " If the <a href=\"#features-shadingRateImage\"><code>shadingRateImage</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_SHADING_RATE_IMAGE_BIT_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-dstAccessMask-03923",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_SHADING_RATE_IMAGE_READ_BIT_NV</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_SHADING_RATE_IMAGE_BIT_NV</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_HUAWEI_subpass_shading)": [
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-srcStageMask-04957",
|
|
"text": " If the <a href=\"#features-subpassShading\"><code>subpassShading</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_SUBPASS_SHADING_BIT_HUAWEI</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-dstStageMask-04957",
|
|
"text": " If the <a href=\"#features-subpassShading\"><code>subpassShading</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_SUBPASS_SHADING_BIT_HUAWEI</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_HUAWEI_invocation_mask)": [
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-srcStageMask-04995",
|
|
"text": " If the <a href=\"#features-invocationMask\"><code>invocationMask</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_INVOCATION_MASK_BIT_HUAWEI</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-srcAccessMask-04994",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_INVOCATION_MASK_READ_BIT_HUAWEI</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_INVOCATION_MASK_BIT_HUAWEI</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-dstStageMask-04995",
|
|
"text": " If the <a href=\"#features-invocationMask\"><code>invocationMask</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_INVOCATION_MASK_BIT_HUAWEI</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-dstAccessMask-04994",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_INVOCATION_MASK_READ_BIT_HUAWEI</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_INVOCATION_MASK_BIT_HUAWEI</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_NV_device_generated_commands)": [
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-srcAccessMask-03924",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_COMMAND_PREPROCESS_READ_BIT_NV</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_COMMAND_PREPROCESS_BIT_NV</code> or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-srcAccessMask-03925",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_COMMAND_PREPROCESS_WRITE_BIT_NV</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_COMMAND_PREPROCESS_BIT_NV</code> or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-dstAccessMask-03924",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_COMMAND_PREPROCESS_READ_BIT_NV</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_COMMAND_PREPROCESS_BIT_NV</code> or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-dstAccessMask-03925",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_COMMAND_PREPROCESS_WRITE_BIT_NV</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_COMMAND_PREPROCESS_BIT_NV</code> or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_EXT_blend_operation_advanced)": [
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-srcAccessMask-03926",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_COLOR_ATTACHMENT_READ_NONCOHERENT_BIT_EXT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_COLOR_ATTACHMENT_OUTPUT_BIT</code> <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-dstAccessMask-03926",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_COLOR_ATTACHMENT_READ_NONCOHERENT_BIT_EXT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_COLOR_ATTACHMENT_OUTPUT_BIT</code> <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_KHR_acceleration_structure,VK_NV_ray_tracing)": [
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-srcAccessMask-03927",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_ACCELERATION_STRUCTURE_READ_BIT_KHR</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_BUILD_BIT_KHR</code>, <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>, or one of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-srcAccessMask-03928",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_ACCELERATION_STRUCTURE_WRITE_BIT_KHR</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_BUILD_BIT_KHR</code> or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-dstAccessMask-03927",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_ACCELERATION_STRUCTURE_READ_BIT_KHR</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_BUILD_BIT_KHR</code>, <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>, or one of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-dstAccessMask-03928",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_ACCELERATION_STRUCTURE_WRITE_BIT_KHR</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_BUILD_BIT_KHR</code> or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_KHR_acceleration_structure,VK_NV_ray_tracing)+!(VK_KHR_ray_query)+(VK_KHR_ray_tracing_pipeline,VK_NV_ray_tracing)": [
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-srcAccessMask-06254",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_ACCELERATION_STRUCTURE_READ_BIT_KHR</code>, pname:srcStageMask <strong class=\"purple\">must</strong> not include any of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages except <code>VK_PIPELINE_STAGE_2_RAY_TRACING_SHADER_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-dstAccessMask-06254",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_ACCELERATION_STRUCTURE_READ_BIT_KHR</code>, pname:dstStageMask <strong class=\"purple\">must</strong> not include any of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages except <code>VK_PIPELINE_STAGE_2_RAY_TRACING_SHADER_BIT_KHR</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_KHR_acceleration_structure,VK_NV_ray_tracing)+!(VK_KHR_ray_query)+!(VK_KHR_ray_tracing_pipeline,VK_NV_ray_tracing)": [
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-srcAccessMask-06255",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_ACCELERATION_STRUCTURE_READ_BIT_KHR</code>, pname:srcStageMask <strong class=\"purple\">must</strong> not include any of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-dstAccessMask-06255",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_ACCELERATION_STRUCTURE_READ_BIT_KHR</code>, pname:dstStageMask <strong class=\"purple\">must</strong> not include any of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_KHR_acceleration_structure,VK_NV_ray_tracing)+(VK_KHR_ray_query)+(VK_KHR_ray_tracing_pipeline,VK_NV_ray_tracing)": [
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-srcAccessMask-06256",
|
|
"text": " If the <a href=\"#features-rayQuery\"><code>rayQuery</code></a> feature is not enabled and pname:srcAccessMask includes <code>VK_ACCESS_2_ACCELERATION_STRUCTURE_READ_BIT_KHR</code>, pname:srcStageMask <strong class=\"purple\">must</strong> not include any of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages except <code>VK_PIPELINE_STAGE_2_RAY_TRACING_SHADER_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-dstAccessMask-06256",
|
|
"text": " If the <a href=\"#features-rayQuery\"><code>rayQuery</code></a> feature is not enabled and pname:dstAccessMask includes <code>VK_ACCESS_2_ACCELERATION_STRUCTURE_READ_BIT_KHR</code>, pname:dstStageMask <strong class=\"purple\">must</strong> not include any of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages except <code>VK_PIPELINE_STAGE_2_RAY_TRACING_SHADER_BIT_KHR</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_KHR_acceleration_structure,VK_NV_ray_tracing)+(VK_KHR_ray_query)+!(VK_KHR_ray_tracing_pipeline,VK_NV_ray_tracing)": [
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-srcAccessMask-06257",
|
|
"text": " If the <a href=\"#features-rayQuery\"><code>rayQuery</code></a> feature is not enabled and pname:srcAccessMask includes <code>VK_ACCESS_2_ACCELERATION_STRUCTURE_READ_BIT_KHR</code>, pname:srcStageMask <strong class=\"purple\">must</strong> not include any of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-dstAccessMask-06257",
|
|
"text": " If the <a href=\"#features-rayQuery\"><code>rayQuery</code></a> feature is not enabled and pname:dstAccessMask includes <code>VK_ACCESS_2_ACCELERATION_STRUCTURE_READ_BIT_KHR</code>, pname:dstStageMask <strong class=\"purple\">must</strong> not include any of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_KHR_video_decode_queue)": [
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-srcAccessMask-04858",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_VIDEO_DECODE_READ_BIT_KHR</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_VIDEO_DECODE_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-srcAccessMask-04859",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_VIDEO_DECODE_WRITE_BIT_KHR</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_VIDEO_DECODE_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-dstAccessMask-04858",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_VIDEO_DECODE_READ_BIT_KHR</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_VIDEO_DECODE_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-dstAccessMask-04859",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_VIDEO_DECODE_WRITE_BIT_KHR</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_VIDEO_DECODE_BIT_KHR</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_KHR_video_encode_queue)": [
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-srcAccessMask-04860",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_VIDEO_ENCODE_READ_BIT_KHR</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_VIDEO_ENCODE_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-srcAccessMask-04861",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_VIDEO_ENCODE_WRITE_BIT_KHR</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_VIDEO_ENCODE_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-dstAccessMask-04860",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_VIDEO_ENCODE_READ_BIT_KHR</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_VIDEO_ENCODE_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-dstAccessMask-04861",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_VIDEO_ENCODE_WRITE_BIT_KHR</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_VIDEO_ENCODE_BIT_KHR</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+!(VK_VERSION_1_1,VK_KHR_external_memory)": [
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-buffer-04086",
|
|
"text": " If <code>buffer</code> was created with a sharing mode of <code>VK_SHARING_MODE_EXCLUSIVE</code>, and <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> are not equal, <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> <strong class=\"purple\">must</strong> be valid queue families"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_VERSION_1_1,VK_KHR_external_memory)": [
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-srcQueueFamilyIndex-04087",
|
|
"text": " If <code>srcQueueFamilyIndex</code> is not equal to <code>dstQueueFamilyIndex</code>, at least one <strong class=\"purple\">must</strong> not be a special queue family reserved for external memory ownership transfers, as described in <a href=\"#synchronization-queue-transfers\">Queue Family Ownership Transfer</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-buffer-04088",
|
|
"text": " If <code>buffer</code> was created with a sharing mode of <code>VK_SHARING_MODE_CONCURRENT</code>, <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> are not equal, and one of <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> is one of the special queue family values reserved for external memory transfers, the other <strong class=\"purple\">must</strong> be <code>VK_QUEUE_FAMILY_IGNORED</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier2-buffer-04089",
|
|
"text": " If <code>buffer</code> was created with a sharing mode of <code>VK_SHARING_MODE_EXCLUSIVE</code>, and <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> are not equal, <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> <strong class=\"purple\">must</strong> both be valid queue families, or one of the special queue family values reserved for external memory transfers, as described in <a href=\"#synchronization-queue-transfers\">Queue Family Ownership Transfer</a>"
|
|
}
|
|
]
|
|
},
|
|
"VkBufferMemoryBarrier": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier-offset-01187",
|
|
"text": " <code>offset</code> <strong class=\"purple\">must</strong> be less than the size of <code>buffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier-size-01188",
|
|
"text": " If <code>size</code> is not equal to <code>VK_WHOLE_SIZE</code>, <code>size</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier-size-01189",
|
|
"text": " If <code>size</code> is not equal to <code>VK_WHOLE_SIZE</code>, <code>size</code> <strong class=\"purple\">must</strong> be less than or equal to than the size of <code>buffer</code> minus <code>offset</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier-buffer-01931",
|
|
"text": " If <code>buffer</code> is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_BUFFER_MEMORY_BARRIER</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier-buffer-parameter",
|
|
"text": " <code>buffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBuffer\">VkBuffer</a> handle"
|
|
}
|
|
],
|
|
"!(VK_VERSION_1_1,VK_KHR_external_memory)": [
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier-buffer-04086",
|
|
"text": " If <code>buffer</code> was created with a sharing mode of <code>VK_SHARING_MODE_EXCLUSIVE</code>, and <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> are not equal, <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> <strong class=\"purple\">must</strong> be valid queue families"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier-synchronization2-03852",
|
|
"text": " If the <a href=\"#features-synchronization2\"><code>synchronization2</code></a> feature is not enabled, and <code>buffer</code> was created with a sharing mode of <code>VK_SHARING_MODE_CONCURRENT</code>, <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> <strong class=\"purple\">must</strong> both be <code>VK_QUEUE_FAMILY_IGNORED</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_external_memory)": [
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier-srcQueueFamilyIndex-04087",
|
|
"text": " If <code>srcQueueFamilyIndex</code> is not equal to <code>dstQueueFamilyIndex</code>, at least one <strong class=\"purple\">must</strong> not be a special queue family reserved for external memory ownership transfers, as described in <a href=\"#synchronization-queue-transfers\">Queue Family Ownership Transfer</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier-buffer-04088",
|
|
"text": " If <code>buffer</code> was created with a sharing mode of <code>VK_SHARING_MODE_CONCURRENT</code>, <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> are not equal, and one of <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> is one of the special queue family values reserved for external memory transfers, the other <strong class=\"purple\">must</strong> be <code>VK_QUEUE_FAMILY_IGNORED</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier-buffer-04089",
|
|
"text": " If <code>buffer</code> was created with a sharing mode of <code>VK_SHARING_MODE_EXCLUSIVE</code>, and <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> are not equal, <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> <strong class=\"purple\">must</strong> both be valid queue families, or one of the special queue family values reserved for external memory transfers, as described in <a href=\"#synchronization-queue-transfers\">Queue Family Ownership Transfer</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryBarrier-synchronization2-03853",
|
|
"text": " If the <a href=\"#features-synchronization2\"><code>synchronization2</code></a> feature is not enabled, and <code>buffer</code> was created with a sharing mode of <code>VK_SHARING_MODE_CONCURRENT</code>, at least one of <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> <strong class=\"purple\">must</strong> be <code>VK_QUEUE_FAMILY_IGNORED</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkImageMemoryBarrier2": {
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)": [
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-srcStageMask-03929",
|
|
"text": " If the <a href=\"#features-geometryShader\"><code>geometryShader</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_GEOMETRY_SHADER_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-srcStageMask-03930",
|
|
"text": " If the <a href=\"#features-tessellationShader\"><code>tessellationShader</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_TESSELLATION_CONTROL_SHADER_BIT</code> or <code>VK_PIPELINE_STAGE_2_TESSELLATION_EVALUATION_SHADER_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-srcAccessMask-03900",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_INDIRECT_COMMAND_READ_BIT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_DRAW_INDIRECT_BIT</code>, <code>VK_PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_BUILD_BIT_KHR</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-srcAccessMask-03901",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_INDEX_READ_BIT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_INDEX_INPUT_BIT</code>, <code>VK_PIPELINE_STAGE_2_VERTEX_INPUT_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-srcAccessMask-03902",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_VERTEX_ATTRIBUTE_READ_BIT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_VERTEX_ATTRIBUTE_INPUT_BIT</code>, <code>VK_PIPELINE_STAGE_2_VERTEX_INPUT_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-srcAccessMask-03903",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_INPUT_ATTACHMENT_READ_BIT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_FRAGMENT_SHADER_BIT</code>, <code>VK_PIPELINE_STAGE_2_SUBPASS_SHADING_BIT_HUAWEI</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-srcAccessMask-03904",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_UNIFORM_READ_BIT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>, or one of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-srcAccessMask-03905",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_SHADER_SAMPLED_READ_BIT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>, or one of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-srcAccessMask-03906",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_SHADER_STORAGE_READ_BIT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>, or one of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-srcAccessMask-03907",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_SHADER_STORAGE_WRITE_BIT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>, or one of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-srcAccessMask-03908",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_SHADER_READ_BIT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>, <code>VK_PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_BUILD_BIT_KHR</code>, or one of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-srcAccessMask-03909",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_SHADER_WRITE_BIT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>, or one of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-srcAccessMask-03910",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_COLOR_ATTACHMENT_READ_BIT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_COLOR_ATTACHMENT_OUTPUT_BIT</code> <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-srcAccessMask-03911",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_COLOR_ATTACHMENT_WRITE_BIT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_COLOR_ATTACHMENT_OUTPUT_BIT</code> <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-srcAccessMask-03912",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_DEPTH_STENCIL_ATTACHMENT_READ_BIT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_EARLY_FRAGMENT_TESTS_BIT</code>, <code>VK_PIPELINE_STAGE_2_LATE_FRAGMENT_TESTS_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-srcAccessMask-03913",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_DEPTH_STENCIL_ATTACHMENT_WRITE_BIT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_EARLY_FRAGMENT_TESTS_BIT</code>, <code>VK_PIPELINE_STAGE_2_LATE_FRAGMENT_TESTS_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-srcAccessMask-03914",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_TRANSFER_READ_BIT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_COPY_BIT</code>, <code>VK_PIPELINE_STAGE_2_BLIT_BIT</code>, <code>VK_PIPELINE_STAGE_2_RESOLVE_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_TRANSFER_BIT</code>, <code>VK_PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_BUILD_BIT_KHR</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-srcAccessMask-03915",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_TRANSFER_WRITE_BIT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_COPY_BIT</code>, <code>VK_PIPELINE_STAGE_2_BLIT_BIT</code>, <code>VK_PIPELINE_STAGE_2_RESOLVE_BIT</code>, <code>VK_PIPELINE_STAGE_2_CLEAR_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_TRANSFER_BIT</code>, <code>VK_PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_BUILD_BIT_KHR</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-srcAccessMask-03916",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_HOST_READ_BIT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_HOST_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-srcAccessMask-03917",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_HOST_WRITE_BIT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_HOST_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-dstStageMask-03929",
|
|
"text": " If the <a href=\"#features-geometryShader\"><code>geometryShader</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_GEOMETRY_SHADER_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-dstStageMask-03930",
|
|
"text": " If the <a href=\"#features-tessellationShader\"><code>tessellationShader</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_TESSELLATION_CONTROL_SHADER_BIT</code> or <code>VK_PIPELINE_STAGE_2_TESSELLATION_EVALUATION_SHADER_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-dstAccessMask-03900",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_INDIRECT_COMMAND_READ_BIT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_DRAW_INDIRECT_BIT</code>, <code>VK_PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_BUILD_BIT_KHR</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-dstAccessMask-03901",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_INDEX_READ_BIT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_INDEX_INPUT_BIT</code>, <code>VK_PIPELINE_STAGE_2_VERTEX_INPUT_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-dstAccessMask-03902",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_VERTEX_ATTRIBUTE_READ_BIT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_VERTEX_ATTRIBUTE_INPUT_BIT</code>, <code>VK_PIPELINE_STAGE_2_VERTEX_INPUT_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-dstAccessMask-03903",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_INPUT_ATTACHMENT_READ_BIT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_FRAGMENT_SHADER_BIT</code>, <code>VK_PIPELINE_STAGE_2_SUBPASS_SHADING_BIT_HUAWEI</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-dstAccessMask-03904",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_UNIFORM_READ_BIT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>, or one of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-dstAccessMask-03905",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_SHADER_SAMPLED_READ_BIT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>, or one of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-dstAccessMask-03906",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_SHADER_STORAGE_READ_BIT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>, or one of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-dstAccessMask-03907",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_SHADER_STORAGE_WRITE_BIT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>, or one of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-dstAccessMask-03908",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_SHADER_READ_BIT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>, <code>VK_PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_BUILD_BIT_KHR</code>, or one of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-dstAccessMask-03909",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_SHADER_WRITE_BIT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>, or one of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-dstAccessMask-03910",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_COLOR_ATTACHMENT_READ_BIT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_COLOR_ATTACHMENT_OUTPUT_BIT</code> <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-dstAccessMask-03911",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_COLOR_ATTACHMENT_WRITE_BIT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_COLOR_ATTACHMENT_OUTPUT_BIT</code> <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-dstAccessMask-03912",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_DEPTH_STENCIL_ATTACHMENT_READ_BIT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_EARLY_FRAGMENT_TESTS_BIT</code>, <code>VK_PIPELINE_STAGE_2_LATE_FRAGMENT_TESTS_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-dstAccessMask-03913",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_DEPTH_STENCIL_ATTACHMENT_WRITE_BIT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_EARLY_FRAGMENT_TESTS_BIT</code>, <code>VK_PIPELINE_STAGE_2_LATE_FRAGMENT_TESTS_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-dstAccessMask-03914",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_TRANSFER_READ_BIT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_COPY_BIT</code>, <code>VK_PIPELINE_STAGE_2_BLIT_BIT</code>, <code>VK_PIPELINE_STAGE_2_RESOLVE_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_TRANSFER_BIT</code>, <code>VK_PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_BUILD_BIT_KHR</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-dstAccessMask-03915",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_TRANSFER_WRITE_BIT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_COPY_BIT</code>, <code>VK_PIPELINE_STAGE_2_BLIT_BIT</code>, <code>VK_PIPELINE_STAGE_2_RESOLVE_BIT</code>, <code>VK_PIPELINE_STAGE_2_CLEAR_BIT</code>, <code>VK_PIPELINE_STAGE_2_ALL_TRANSFER_BIT</code>, <code>VK_PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_BUILD_BIT_KHR</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-dstAccessMask-03916",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_HOST_READ_BIT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_HOST_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-dstAccessMask-03917",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_HOST_WRITE_BIT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_HOST_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-subresourceRange-01486",
|
|
"text": " <code>subresourceRange.baseMipLevel</code> <strong class=\"purple\">must</strong> be less than the <code>mipLevels</code> specified in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> when <code>image</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-subresourceRange-01724",
|
|
"text": " If <code>subresourceRange.levelCount</code> is not <code>VK_REMAINING_MIP_LEVELS</code>, <span class=\"eq\"><code>subresourceRange.baseMipLevel</code> + <code>subresourceRange.levelCount</code></span> <strong class=\"purple\">must</strong> be less than or equal to the <code>mipLevels</code> specified in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> when <code>image</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-subresourceRange-01488",
|
|
"text": " <code>subresourceRange.baseArrayLayer</code> <strong class=\"purple\">must</strong> be less than the <code>arrayLayers</code> specified in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> when <code>image</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-subresourceRange-01725",
|
|
"text": " If <code>subresourceRange.layerCount</code> is not <code>VK_REMAINING_ARRAY_LAYERS</code>, <span class=\"eq\"><code>subresourceRange.baseArrayLayer</code> + <code>subresourceRange.layerCount</code></span> <strong class=\"purple\">must</strong> be less than or equal to the <code>arrayLayers</code> specified in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> when <code>image</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-image-01932",
|
|
"text": " If <code>image</code> is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-oldLayout-01208",
|
|
"text": " If <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> define a <a href=\"#synchronization-queue-transfers\">queue family ownership transfer</a> or <code>oldLayout</code> and <code>newLayout</code> define an <a href=\"#synchronization-image-layout-transitions\">image layout transition</a>, and <code>oldLayout</code> or <code>newLayout</code> is <code>VK_IMAGE_LAYOUT_COLOR_ATTACHMENT_OPTIMAL</code> then <code>image</code> <strong class=\"purple\">must</strong> have been created with <code>VK_IMAGE_USAGE_COLOR_ATTACHMENT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-oldLayout-01209",
|
|
"text": " If <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> define a <a href=\"#synchronization-queue-transfers\">queue family ownership transfer</a> or <code>oldLayout</code> and <code>newLayout</code> define an <a href=\"#synchronization-image-layout-transitions\">image layout transition</a>, and <code>oldLayout</code> or <code>newLayout</code> is <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_ATTACHMENT_OPTIMAL</code> then <code>image</code> <strong class=\"purple\">must</strong> have been created with <code>VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-oldLayout-01210",
|
|
"text": " If <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> define a <a href=\"#synchronization-queue-transfers\">queue family ownership transfer</a> or <code>oldLayout</code> and <code>newLayout</code> define an <a href=\"#synchronization-image-layout-transitions\">image layout transition</a>, and <code>oldLayout</code> or <code>newLayout</code> is <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL</code> then <code>image</code> <strong class=\"purple\">must</strong> have been created with <code>VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-oldLayout-01211",
|
|
"text": " If <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> define a <a href=\"#synchronization-queue-transfers\">queue family ownership transfer</a> or <code>oldLayout</code> and <code>newLayout</code> define an <a href=\"#synchronization-image-layout-transitions\">image layout transition</a>, and <code>oldLayout</code> or <code>newLayout</code> is <code>VK_IMAGE_LAYOUT_SHADER_READ_ONLY_OPTIMAL</code> then <code>image</code> <strong class=\"purple\">must</strong> have been created with <code>VK_IMAGE_USAGE_SAMPLED_BIT</code> or <code>VK_IMAGE_USAGE_INPUT_ATTACHMENT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-oldLayout-01212",
|
|
"text": " If <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> define a <a href=\"#synchronization-queue-transfers\">queue family ownership transfer</a> or <code>oldLayout</code> and <code>newLayout</code> define an <a href=\"#synchronization-image-layout-transitions\">image layout transition</a>, and <code>oldLayout</code> or <code>newLayout</code> is <code>VK_IMAGE_LAYOUT_TRANSFER_SRC_OPTIMAL</code> then <code>image</code> <strong class=\"purple\">must</strong> have been created with <code>VK_IMAGE_USAGE_TRANSFER_SRC_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-oldLayout-01213",
|
|
"text": " If <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> define a <a href=\"#synchronization-queue-transfers\">queue family ownership transfer</a> or <code>oldLayout</code> and <code>newLayout</code> define an <a href=\"#synchronization-image-layout-transitions\">image layout transition</a>, and <code>oldLayout</code> or <code>newLayout</code> is <code>VK_IMAGE_LAYOUT_TRANSFER_DST_OPTIMAL</code> then <code>image</code> <strong class=\"purple\">must</strong> have been created with <code>VK_IMAGE_USAGE_TRANSFER_DST_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-oldLayout-01197",
|
|
"text": " If <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> define a <a href=\"#synchronization-queue-transfers\">queue family ownership transfer</a> or <code>oldLayout</code> and <code>newLayout</code> define an <a href=\"#synchronization-image-layout-transitions\">image layout transition</a>, <code>oldLayout</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_LAYOUT_UNDEFINED</code> or the current layout of the image subresources affected by the barrier"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-newLayout-01198",
|
|
"text": " If <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> define a <a href=\"#synchronization-queue-transfers\">queue family ownership transfer</a> or <code>oldLayout</code> and <code>newLayout</code> define an <a href=\"#synchronization-image-layout-transitions\">image layout transition</a>, <code>newLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_UNDEFINED</code> or <code>VK_IMAGE_LAYOUT_PREINITIALIZED</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-srcStageMask-03854",
|
|
"text": " If either <code>srcStageMask</code> or <code>dstStageMask</code> includes <code>VK_PIPELINE_STAGE_2_HOST_BIT</code>, <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> <strong class=\"purple\">must</strong> be equal"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-srcStageMask-03855",
|
|
"text": " If <code>srcStageMask</code> includes <code>VK_PIPELINE_STAGE_2_HOST_BIT</code>, and <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> define a <a href=\"#synchronization-queue-transfers\">queue family ownership transfer</a> or <code>oldLayout</code> and <code>newLayout</code> define an <a href=\"#synchronization-image-layout-transitions\">image layout transition</a>, <code>oldLayout</code> <strong class=\"purple\">must</strong> be one of <code>VK_IMAGE_LAYOUT_PREINITIALIZED</code>, <code>VK_IMAGE_LAYOUT_UNDEFINED</code>, or <code>VK_IMAGE_LAYOUT_GENERAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_IMAGE_MEMORY_BARRIER_2</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkSampleLocationsInfoEXT\">VkSampleLocationsInfoEXT</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-srcStageMask-parameter",
|
|
"text": " <code>srcStageMask</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkPipelineStageFlagBits2\">VkPipelineStageFlagBits2</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-srcAccessMask-parameter",
|
|
"text": " <code>srcAccessMask</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkAccessFlagBits2\">VkAccessFlagBits2</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-dstStageMask-parameter",
|
|
"text": " <code>dstStageMask</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkPipelineStageFlagBits2\">VkPipelineStageFlagBits2</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-dstAccessMask-parameter",
|
|
"text": " <code>dstAccessMask</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkAccessFlagBits2\">VkAccessFlagBits2</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-oldLayout-parameter",
|
|
"text": " <code>oldLayout</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageLayout\">VkImageLayout</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-newLayout-parameter",
|
|
"text": " <code>newLayout</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageLayout\">VkImageLayout</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-image-parameter",
|
|
"text": " <code>image</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImage\">VkImage</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-subresourceRange-parameter",
|
|
"text": " <code>subresourceRange</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageSubresourceRange\">VkImageSubresourceRange</a> structure"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_EXT_conditional_rendering)": [
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-srcStageMask-03931",
|
|
"text": " If the <a href=\"#features-conditionalRendering\"><code>conditionalRendering</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_CONDITIONAL_RENDERING_BIT_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-srcAccessMask-03918",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_CONDITIONAL_RENDERING_READ_BIT_EXT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_CONDITIONAL_RENDERING_BIT_EXT</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-dstStageMask-03931",
|
|
"text": " If the <a href=\"#features-conditionalRendering\"><code>conditionalRendering</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_CONDITIONAL_RENDERING_BIT_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-dstAccessMask-03918",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_CONDITIONAL_RENDERING_READ_BIT_EXT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_CONDITIONAL_RENDERING_BIT_EXT</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_EXT_fragment_density_map)": [
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-srcStageMask-03932",
|
|
"text": " If the <a href=\"#features-fragmentDensityMap\"><code>fragmentDensityMap</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_FRAGMENT_DENSITY_PROCESS_BIT_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-srcAccessMask-03919",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_FRAGMENT_DENSITY_MAP_READ_BIT_EXT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_FRAGMENT_DENSITY_PROCESS_BIT_EXT</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-dstStageMask-03932",
|
|
"text": " If the <a href=\"#features-fragmentDensityMap\"><code>fragmentDensityMap</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_FRAGMENT_DENSITY_PROCESS_BIT_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-dstAccessMask-03919",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_FRAGMENT_DENSITY_MAP_READ_BIT_EXT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_FRAGMENT_DENSITY_PROCESS_BIT_EXT</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_EXT_transform_feedback)": [
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-srcStageMask-03933",
|
|
"text": " If the <a href=\"#features-transformFeedback\"><code>transformFeedback</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_TRANSFORM_FEEDBACK_BIT_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-srcAccessMask-03920",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_TRANSFORM_FEEDBACK_WRITE_BIT_EXT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_TRANSFORM_FEEDBACK_BIT_EXT</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-srcAccessMask-04747",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_TRANSFORM_FEEDBACK_COUNTER_READ_BIT_EXT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_DRAW_INDIRECT_BIT</code>, <code>VK_PIPELINE_STAGE_2_TRANSFORM_FEEDBACK_BIT_EXT</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-srcAccessMask-03922",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_TRANSFORM_FEEDBACK_COUNTER_WRITE_BIT_EXT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_TRANSFORM_FEEDBACK_BIT_EXT</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-dstStageMask-03933",
|
|
"text": " If the <a href=\"#features-transformFeedback\"><code>transformFeedback</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_TRANSFORM_FEEDBACK_BIT_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-dstAccessMask-03920",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_TRANSFORM_FEEDBACK_WRITE_BIT_EXT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_TRANSFORM_FEEDBACK_BIT_EXT</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-dstAccessMask-04747",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_TRANSFORM_FEEDBACK_COUNTER_READ_BIT_EXT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_DRAW_INDIRECT_BIT</code>, <code>VK_PIPELINE_STAGE_2_TRANSFORM_FEEDBACK_BIT_EXT</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-dstAccessMask-03922",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_TRANSFORM_FEEDBACK_COUNTER_WRITE_BIT_EXT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_TRANSFORM_FEEDBACK_BIT_EXT</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_NV_mesh_shader)": [
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-srcStageMask-03934",
|
|
"text": " If the <a href=\"#features-meshShader\"><code>meshShader</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_MESH_SHADER_BIT_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-srcStageMask-03935",
|
|
"text": " If the <a href=\"#features-taskShader\"><code>taskShader</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_TASK_SHADER_BIT_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-dstStageMask-03934",
|
|
"text": " If the <a href=\"#features-meshShader\"><code>meshShader</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_MESH_SHADER_BIT_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-dstStageMask-03935",
|
|
"text": " If the <a href=\"#features-taskShader\"><code>taskShader</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_TASK_SHADER_BIT_NV</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_NV_shading_rate_image)": [
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-srcStageMask-04956",
|
|
"text": " If the <a href=\"#features-shadingRateImage\"><code>shadingRateImage</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_SHADING_RATE_IMAGE_BIT_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-srcAccessMask-03923",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_SHADING_RATE_IMAGE_READ_BIT_NV</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_SHADING_RATE_IMAGE_BIT_NV</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-dstStageMask-04956",
|
|
"text": " If the <a href=\"#features-shadingRateImage\"><code>shadingRateImage</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_SHADING_RATE_IMAGE_BIT_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-dstAccessMask-03923",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_SHADING_RATE_IMAGE_READ_BIT_NV</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_SHADING_RATE_IMAGE_BIT_NV</code>, <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_HUAWEI_subpass_shading)": [
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-srcStageMask-04957",
|
|
"text": " If the <a href=\"#features-subpassShading\"><code>subpassShading</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_SUBPASS_SHADING_BIT_HUAWEI</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-dstStageMask-04957",
|
|
"text": " If the <a href=\"#features-subpassShading\"><code>subpassShading</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_SUBPASS_SHADING_BIT_HUAWEI</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_HUAWEI_invocation_mask)": [
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-srcStageMask-04995",
|
|
"text": " If the <a href=\"#features-invocationMask\"><code>invocationMask</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_INVOCATION_MASK_BIT_HUAWEI</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-srcAccessMask-04994",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_INVOCATION_MASK_READ_BIT_HUAWEI</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_INVOCATION_MASK_BIT_HUAWEI</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-dstStageMask-04995",
|
|
"text": " If the <a href=\"#features-invocationMask\"><code>invocationMask</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_INVOCATION_MASK_BIT_HUAWEI</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-dstAccessMask-04994",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_INVOCATION_MASK_READ_BIT_HUAWEI</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_INVOCATION_MASK_BIT_HUAWEI</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_NV_device_generated_commands)": [
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-srcAccessMask-03924",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_COMMAND_PREPROCESS_READ_BIT_NV</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_COMMAND_PREPROCESS_BIT_NV</code> or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-srcAccessMask-03925",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_COMMAND_PREPROCESS_WRITE_BIT_NV</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_COMMAND_PREPROCESS_BIT_NV</code> or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-dstAccessMask-03924",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_COMMAND_PREPROCESS_READ_BIT_NV</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_COMMAND_PREPROCESS_BIT_NV</code> or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-dstAccessMask-03925",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_COMMAND_PREPROCESS_WRITE_BIT_NV</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_COMMAND_PREPROCESS_BIT_NV</code> or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_EXT_blend_operation_advanced)": [
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-srcAccessMask-03926",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_COLOR_ATTACHMENT_READ_NONCOHERENT_BIT_EXT</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_COLOR_ATTACHMENT_OUTPUT_BIT</code> <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-dstAccessMask-03926",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_COLOR_ATTACHMENT_READ_NONCOHERENT_BIT_EXT</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_COLOR_ATTACHMENT_OUTPUT_BIT</code> <code>VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT</code>, or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_KHR_acceleration_structure,VK_NV_ray_tracing)": [
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-srcAccessMask-03927",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_ACCELERATION_STRUCTURE_READ_BIT_KHR</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_BUILD_BIT_KHR</code>, <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>, or one of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-srcAccessMask-03928",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_ACCELERATION_STRUCTURE_WRITE_BIT_KHR</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_BUILD_BIT_KHR</code> or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-dstAccessMask-03927",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_ACCELERATION_STRUCTURE_READ_BIT_KHR</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_BUILD_BIT_KHR</code>, <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>, or one of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-dstAccessMask-03928",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_ACCELERATION_STRUCTURE_WRITE_BIT_KHR</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_ACCELERATION_STRUCTURE_BUILD_BIT_KHR</code> or <code>VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_KHR_acceleration_structure,VK_NV_ray_tracing)+!(VK_KHR_ray_query)+(VK_KHR_ray_tracing_pipeline,VK_NV_ray_tracing)": [
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-srcAccessMask-06254",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_ACCELERATION_STRUCTURE_READ_BIT_KHR</code>, pname:srcStageMask <strong class=\"purple\">must</strong> not include any of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages except <code>VK_PIPELINE_STAGE_2_RAY_TRACING_SHADER_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-dstAccessMask-06254",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_ACCELERATION_STRUCTURE_READ_BIT_KHR</code>, pname:dstStageMask <strong class=\"purple\">must</strong> not include any of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages except <code>VK_PIPELINE_STAGE_2_RAY_TRACING_SHADER_BIT_KHR</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_KHR_acceleration_structure,VK_NV_ray_tracing)+!(VK_KHR_ray_query)+!(VK_KHR_ray_tracing_pipeline,VK_NV_ray_tracing)": [
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-srcAccessMask-06255",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_ACCELERATION_STRUCTURE_READ_BIT_KHR</code>, pname:srcStageMask <strong class=\"purple\">must</strong> not include any of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-dstAccessMask-06255",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_ACCELERATION_STRUCTURE_READ_BIT_KHR</code>, pname:dstStageMask <strong class=\"purple\">must</strong> not include any of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_KHR_acceleration_structure,VK_NV_ray_tracing)+(VK_KHR_ray_query)+(VK_KHR_ray_tracing_pipeline,VK_NV_ray_tracing)": [
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-srcAccessMask-06256",
|
|
"text": " If the <a href=\"#features-rayQuery\"><code>rayQuery</code></a> feature is not enabled and pname:srcAccessMask includes <code>VK_ACCESS_2_ACCELERATION_STRUCTURE_READ_BIT_KHR</code>, pname:srcStageMask <strong class=\"purple\">must</strong> not include any of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages except <code>VK_PIPELINE_STAGE_2_RAY_TRACING_SHADER_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-dstAccessMask-06256",
|
|
"text": " If the <a href=\"#features-rayQuery\"><code>rayQuery</code></a> feature is not enabled and pname:dstAccessMask includes <code>VK_ACCESS_2_ACCELERATION_STRUCTURE_READ_BIT_KHR</code>, pname:dstStageMask <strong class=\"purple\">must</strong> not include any of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages except <code>VK_PIPELINE_STAGE_2_RAY_TRACING_SHADER_BIT_KHR</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_KHR_acceleration_structure,VK_NV_ray_tracing)+(VK_KHR_ray_query)+!(VK_KHR_ray_tracing_pipeline,VK_NV_ray_tracing)": [
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-srcAccessMask-06257",
|
|
"text": " If the <a href=\"#features-rayQuery\"><code>rayQuery</code></a> feature is not enabled and pname:srcAccessMask includes <code>VK_ACCESS_2_ACCELERATION_STRUCTURE_READ_BIT_KHR</code>, pname:srcStageMask <strong class=\"purple\">must</strong> not include any of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-dstAccessMask-06257",
|
|
"text": " If the <a href=\"#features-rayQuery\"><code>rayQuery</code></a> feature is not enabled and pname:dstAccessMask includes <code>VK_ACCESS_2_ACCELERATION_STRUCTURE_READ_BIT_KHR</code>, pname:dstStageMask <strong class=\"purple\">must</strong> not include any of the <code>VK_PIPELINE_STAGE_*_SHADER_BIT</code> stages"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_KHR_video_decode_queue)": [
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-srcAccessMask-04858",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_VIDEO_DECODE_READ_BIT_KHR</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_VIDEO_DECODE_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-srcAccessMask-04859",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_VIDEO_DECODE_WRITE_BIT_KHR</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_VIDEO_DECODE_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-dstAccessMask-04858",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_VIDEO_DECODE_READ_BIT_KHR</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_VIDEO_DECODE_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-dstAccessMask-04859",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_VIDEO_DECODE_WRITE_BIT_KHR</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_VIDEO_DECODE_BIT_KHR</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_KHR_video_encode_queue)": [
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-srcAccessMask-04860",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_VIDEO_ENCODE_READ_BIT_KHR</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_VIDEO_ENCODE_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-srcAccessMask-04861",
|
|
"text": " If pname:srcAccessMask includes <code>VK_ACCESS_2_VIDEO_ENCODE_WRITE_BIT_KHR</code>, pname:srcStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_VIDEO_ENCODE_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-dstAccessMask-04860",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_VIDEO_ENCODE_READ_BIT_KHR</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_VIDEO_ENCODE_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-dstAccessMask-04861",
|
|
"text": " If pname:dstAccessMask includes <code>VK_ACCESS_2_VIDEO_ENCODE_WRITE_BIT_KHR</code>, pname:dstStageMask <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_STAGE_2_VIDEO_ENCODE_BIT_KHR</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_VERSION_1_1,VK_KHR_maintenance2)": [
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-oldLayout-01658",
|
|
"text": " If <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> define a <a href=\"#synchronization-queue-transfers\">queue family ownership transfer</a> or <code>oldLayout</code> and <code>newLayout</code> define an <a href=\"#synchronization-image-layout-transitions\">image layout transition</a>, and <code>oldLayout</code> or <code>newLayout</code> is <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_STENCIL_ATTACHMENT_OPTIMAL</code> then <code>image</code> <strong class=\"purple\">must</strong> have been created with <code>VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-oldLayout-01659",
|
|
"text": " If <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> define a <a href=\"#synchronization-queue-transfers\">queue family ownership transfer</a> or <code>oldLayout</code> and <code>newLayout</code> define an <a href=\"#synchronization-image-layout-transitions\">image layout transition</a>, and <code>oldLayout</code> or <code>newLayout</code> is <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_STENCIL_READ_ONLY_OPTIMAL</code> then <code>image</code> <strong class=\"purple\">must</strong> have been created with <code>VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_VERSION_1_2,VK_EXT_separate_depth_stencil_layouts)": [
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-srcQueueFamilyIndex-04065",
|
|
"text": " If <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> define a <a href=\"#synchronization-queue-transfers\">queue family ownership transfer</a> or <code>oldLayout</code> and <code>newLayout</code> define an <a href=\"#synchronization-image-layout-transitions\">image layout transition</a>, and <code>oldLayout</code> or <code>newLayout</code> is <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL</code> then <code>image</code> <strong class=\"purple\">must</strong> have been created with at least one of <code>VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT</code>, <code>VK_IMAGE_USAGE_SAMPLED_BIT</code>, or <code>VK_IMAGE_USAGE_INPUT_ATTACHMENT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-srcQueueFamilyIndex-04066",
|
|
"text": " If <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> define a <a href=\"#synchronization-queue-transfers\">queue family ownership transfer</a> or <code>oldLayout</code> and <code>newLayout</code> define an <a href=\"#synchronization-image-layout-transitions\">image layout transition</a>, and <code>oldLayout</code> or <code>newLayout</code> is <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_OPTIMAL</code> then <code>image</code> <strong class=\"purple\">must</strong> have been created with <code>VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT</code> set"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-srcQueueFamilyIndex-04067",
|
|
"text": " If <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> define a <a href=\"#synchronization-queue-transfers\">queue family ownership transfer</a> or <code>oldLayout</code> and <code>newLayout</code> define an <a href=\"#synchronization-image-layout-transitions\">image layout transition</a>, and <code>oldLayout</code> or <code>newLayout</code> is <code>VK_IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL</code> then <code>image</code> <strong class=\"purple\">must</strong> have been created with at least one of <code>VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT</code>, <code>VK_IMAGE_USAGE_SAMPLED_BIT</code>, or <code>VK_IMAGE_USAGE_INPUT_ATTACHMENT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-srcQueueFamilyIndex-04068",
|
|
"text": " If <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> define a <a href=\"#synchronization-queue-transfers\">queue family ownership transfer</a> or <code>oldLayout</code> and <code>newLayout</code> define an <a href=\"#synchronization-image-layout-transitions\">image layout transition</a>, and <code>oldLayout</code> or <code>newLayout</code> is <code>VK_IMAGE_LAYOUT_STENCIL_ATTACHMENT_OPTIMAL</code> then <code>image</code> <strong class=\"purple\">must</strong> have been created with <code>VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT</code> set"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_VERSION_1_3,VK_KHR_synchronization2)": [
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-synchronization2-06911",
|
|
"text": " If the <a href=\"#features-synchronization2\"><code>synchronization2</code></a> feature is not enabled, <code>layout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_ATTACHMENT_OPTIMAL_KHR</code> or <code>VK_IMAGE_LAYOUT_READ_ONLY_OPTIMAL_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-srcQueueFamilyIndex-03938",
|
|
"text": " If <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> define a <a href=\"#synchronization-queue-transfers\">queue family ownership transfer</a> or <code>oldLayout</code> and <code>newLayout</code> define an <a href=\"#synchronization-image-layout-transitions\">image layout transition</a>, and <code>oldLayout</code> or <code>newLayout</code> is <code>VK_IMAGE_LAYOUT_ATTACHMENT_OPTIMAL</code>, <code>image</code> <strong class=\"purple\">must</strong> have been created with <code>VK_IMAGE_USAGE_COLOR_ATTACHMENT_BIT</code> or <code>VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-srcQueueFamilyIndex-03939",
|
|
"text": " If <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> define a <a href=\"#synchronization-queue-transfers\">queue family ownership transfer</a> or <code>oldLayout</code> and <code>newLayout</code> define an <a href=\"#synchronization-image-layout-transitions\">image layout transition</a>, and <code>oldLayout</code> or <code>newLayout</code> is <code>VK_IMAGE_LAYOUT_READ_ONLY_OPTIMAL</code>, <code>image</code> <strong class=\"purple\">must</strong> have been created with at least one of <code>VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT</code>, <code>VK_IMAGE_USAGE_SAMPLED_BIT</code>, or <code>VK_IMAGE_USAGE_INPUT_ATTACHMENT_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_KHR_fragment_shading_rate,VK_NV_shading_rate_image)": [
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-oldLayout-02088",
|
|
"text": " If <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> define a <a href=\"#synchronization-queue-transfers\">queue family ownership transfer</a> or <code>oldLayout</code> and <code>newLayout</code> define an <a href=\"#synchronization-image-layout-transitions\">image layout transition</a>, and <code>oldLayout</code> or <code>newLayout</code> is <code>VK_IMAGE_LAYOUT_FRAGMENT_SHADING_RATE_ATTACHMENT_OPTIMAL_KHR</code> then <code>image</code> <strong class=\"purple\">must</strong> have been created with <code>VK_IMAGE_USAGE_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR</code> set"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+!(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-image-02902",
|
|
"text": " If <code>image</code> has a color format, then the <code>aspectMask</code> member of <code>subresourceRange</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_ASPECT_COLOR_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-image-01671",
|
|
"text": " If <code>image</code> has a single-plane color format or is not <em>disjoint</em>, then the <code>aspectMask</code> member of <code>subresourceRange</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_ASPECT_COLOR_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-image-01672",
|
|
"text": " If <code>image</code> has a multi-planar format and the image is <em>disjoint</em>, then the <code>aspectMask</code> member of <code>subresourceRange</code> <strong class=\"purple\">must</strong> include either at least one of <code>VK_IMAGE_ASPECT_PLANE_0_BIT</code>, <code>VK_IMAGE_ASPECT_PLANE_1_BIT</code>, and <code>VK_IMAGE_ASPECT_PLANE_2_BIT</code>; or <strong class=\"purple\">must</strong> include <code>VK_IMAGE_ASPECT_COLOR_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-image-01673",
|
|
"text": " If <code>image</code> has a multi-planar format with only two planes, then the <code>aspectMask</code> member of <code>subresourceRange</code> <strong class=\"purple\">must</strong> not include <code>VK_IMAGE_ASPECT_PLANE_2_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+!(VK_VERSION_1_2,VK_KHR_separate_depth_stencil_layouts)": [
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-image-01207",
|
|
"text": " If <code>image</code> has a depth/stencil format with both depth and stencil components, then the <code>aspectMask</code> member of <code>subresourceRange</code> <strong class=\"purple\">must</strong> include both <code>VK_IMAGE_ASPECT_DEPTH_BIT</code> and <code>VK_IMAGE_ASPECT_STENCIL_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_VERSION_1_2,VK_KHR_separate_depth_stencil_layouts)": [
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-image-03319",
|
|
"text": " If <code>image</code> has a depth/stencil format with both depth and stencil and the <a href=\"#features-separateDepthStencilLayouts\"><code>separateDepthStencilLayouts</code></a> feature is enabled, then the <code>aspectMask</code> member of <code>subresourceRange</code> <strong class=\"purple\">must</strong> include either or both <code>VK_IMAGE_ASPECT_DEPTH_BIT</code> and <code>VK_IMAGE_ASPECT_STENCIL_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-image-03320",
|
|
"text": " If <code>image</code> has a depth/stencil format with both depth and stencil and the <a href=\"#features-separateDepthStencilLayouts\"><code>separateDepthStencilLayouts</code></a> feature is not enabled, then the <code>aspectMask</code> member of <code>subresourceRange</code> <strong class=\"purple\">must</strong> include both <code>VK_IMAGE_ASPECT_DEPTH_BIT</code> and <code>VK_IMAGE_ASPECT_STENCIL_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+!(VK_VERSION_1_1,VK_KHR_external_memory)": [
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-image-04069",
|
|
"text": " If <code>image</code> was created with a sharing mode of <code>VK_SHARING_MODE_EXCLUSIVE</code>, and <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> are not equal, <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> <strong class=\"purple\">must</strong> be valid queue families"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_VERSION_1_1,VK_KHR_external_memory)": [
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-srcQueueFamilyIndex-04070",
|
|
"text": " If <code>srcQueueFamilyIndex</code> is not equal to <code>dstQueueFamilyIndex</code>, at least one <strong class=\"purple\">must</strong> not be a special queue family reserved for external memory ownership transfers, as described in <a href=\"#synchronization-queue-transfers\">Queue Family Ownership Transfer</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-image-04071",
|
|
"text": " If <code>image</code> was created with a sharing mode of <code>VK_SHARING_MODE_CONCURRENT</code>, <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> are not equal, and one of <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> is one of the special queue family values reserved for external memory transfers, the other <strong class=\"purple\">must</strong> be <code>VK_QUEUE_FAMILY_IGNORED</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-image-04072",
|
|
"text": " If <code>image</code> was created with a sharing mode of <code>VK_SHARING_MODE_EXCLUSIVE</code>, and <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> are not equal, <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> <strong class=\"purple\">must</strong> both be valid queue families, or one of the special queue family values reserved for external memory transfers, as described in <a href=\"#synchronization-queue-transfers\">Queue Family Ownership Transfer</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_EXT_attachment_feedback_loop_layout)": [
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier2-srcQueueFamilyIndex-07006",
|
|
"text": " If <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> define a <a href=\"#synchronization-queue-transfers\">queue family ownership transfer</a> or <code>oldLayout</code> and <code>newLayout</code> define an <a href=\"#synchronization-image-layout-transitions\">image layout transition</a>, and <code>oldLayout</code> or <code>newLayout</code> is <code>VK_IMAGE_LAYOUT_ATTACHMENT_FEEDBACK_LOOP_OPTIMAL_EXT</code> then <code>image</code> <strong class=\"purple\">must</strong> have been created with either the <code>VK_IMAGE_USAGE_COLOR_ATTACHMENT_BIT</code> or <code>VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT</code> usage bits, and the <code>VK_IMAGE_USAGE_INPUT_ATTACHMENT_BIT</code> or <code>VK_IMAGE_USAGE_SAMPLED_BIT</code> usage bits, and the <code>VK_IMAGE_USAGE_ATTACHMENT_FEEDBACK_LOOP_BIT_EXT</code> usage bit."
|
|
}
|
|
]
|
|
},
|
|
"VkImageMemoryBarrier": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier-subresourceRange-01486",
|
|
"text": " <code>subresourceRange.baseMipLevel</code> <strong class=\"purple\">must</strong> be less than the <code>mipLevels</code> specified in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> when <code>image</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier-subresourceRange-01724",
|
|
"text": " If <code>subresourceRange.levelCount</code> is not <code>VK_REMAINING_MIP_LEVELS</code>, <span class=\"eq\"><code>subresourceRange.baseMipLevel</code> + <code>subresourceRange.levelCount</code></span> <strong class=\"purple\">must</strong> be less than or equal to the <code>mipLevels</code> specified in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> when <code>image</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier-subresourceRange-01488",
|
|
"text": " <code>subresourceRange.baseArrayLayer</code> <strong class=\"purple\">must</strong> be less than the <code>arrayLayers</code> specified in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> when <code>image</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier-subresourceRange-01725",
|
|
"text": " If <code>subresourceRange.layerCount</code> is not <code>VK_REMAINING_ARRAY_LAYERS</code>, <span class=\"eq\"><code>subresourceRange.baseArrayLayer</code> + <code>subresourceRange.layerCount</code></span> <strong class=\"purple\">must</strong> be less than or equal to the <code>arrayLayers</code> specified in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> when <code>image</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier-image-01932",
|
|
"text": " If <code>image</code> is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier-oldLayout-01208",
|
|
"text": " If <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> define a <a href=\"#synchronization-queue-transfers\">queue family ownership transfer</a> or <code>oldLayout</code> and <code>newLayout</code> define an <a href=\"#synchronization-image-layout-transitions\">image layout transition</a>, and <code>oldLayout</code> or <code>newLayout</code> is <code>VK_IMAGE_LAYOUT_COLOR_ATTACHMENT_OPTIMAL</code> then <code>image</code> <strong class=\"purple\">must</strong> have been created with <code>VK_IMAGE_USAGE_COLOR_ATTACHMENT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier-oldLayout-01209",
|
|
"text": " If <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> define a <a href=\"#synchronization-queue-transfers\">queue family ownership transfer</a> or <code>oldLayout</code> and <code>newLayout</code> define an <a href=\"#synchronization-image-layout-transitions\">image layout transition</a>, and <code>oldLayout</code> or <code>newLayout</code> is <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_ATTACHMENT_OPTIMAL</code> then <code>image</code> <strong class=\"purple\">must</strong> have been created with <code>VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier-oldLayout-01210",
|
|
"text": " If <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> define a <a href=\"#synchronization-queue-transfers\">queue family ownership transfer</a> or <code>oldLayout</code> and <code>newLayout</code> define an <a href=\"#synchronization-image-layout-transitions\">image layout transition</a>, and <code>oldLayout</code> or <code>newLayout</code> is <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL</code> then <code>image</code> <strong class=\"purple\">must</strong> have been created with <code>VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier-oldLayout-01211",
|
|
"text": " If <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> define a <a href=\"#synchronization-queue-transfers\">queue family ownership transfer</a> or <code>oldLayout</code> and <code>newLayout</code> define an <a href=\"#synchronization-image-layout-transitions\">image layout transition</a>, and <code>oldLayout</code> or <code>newLayout</code> is <code>VK_IMAGE_LAYOUT_SHADER_READ_ONLY_OPTIMAL</code> then <code>image</code> <strong class=\"purple\">must</strong> have been created with <code>VK_IMAGE_USAGE_SAMPLED_BIT</code> or <code>VK_IMAGE_USAGE_INPUT_ATTACHMENT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier-oldLayout-01212",
|
|
"text": " If <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> define a <a href=\"#synchronization-queue-transfers\">queue family ownership transfer</a> or <code>oldLayout</code> and <code>newLayout</code> define an <a href=\"#synchronization-image-layout-transitions\">image layout transition</a>, and <code>oldLayout</code> or <code>newLayout</code> is <code>VK_IMAGE_LAYOUT_TRANSFER_SRC_OPTIMAL</code> then <code>image</code> <strong class=\"purple\">must</strong> have been created with <code>VK_IMAGE_USAGE_TRANSFER_SRC_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier-oldLayout-01213",
|
|
"text": " If <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> define a <a href=\"#synchronization-queue-transfers\">queue family ownership transfer</a> or <code>oldLayout</code> and <code>newLayout</code> define an <a href=\"#synchronization-image-layout-transitions\">image layout transition</a>, and <code>oldLayout</code> or <code>newLayout</code> is <code>VK_IMAGE_LAYOUT_TRANSFER_DST_OPTIMAL</code> then <code>image</code> <strong class=\"purple\">must</strong> have been created with <code>VK_IMAGE_USAGE_TRANSFER_DST_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier-oldLayout-01197",
|
|
"text": " If <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> define a <a href=\"#synchronization-queue-transfers\">queue family ownership transfer</a> or <code>oldLayout</code> and <code>newLayout</code> define an <a href=\"#synchronization-image-layout-transitions\">image layout transition</a>, <code>oldLayout</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_LAYOUT_UNDEFINED</code> or the current layout of the image subresources affected by the barrier"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier-newLayout-01198",
|
|
"text": " If <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> define a <a href=\"#synchronization-queue-transfers\">queue family ownership transfer</a> or <code>oldLayout</code> and <code>newLayout</code> define an <a href=\"#synchronization-image-layout-transitions\">image layout transition</a>, <code>newLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_UNDEFINED</code> or <code>VK_IMAGE_LAYOUT_PREINITIALIZED</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_IMAGE_MEMORY_BARRIER</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkSampleLocationsInfoEXT\">VkSampleLocationsInfoEXT</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier-oldLayout-parameter",
|
|
"text": " <code>oldLayout</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageLayout\">VkImageLayout</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier-newLayout-parameter",
|
|
"text": " <code>newLayout</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageLayout\">VkImageLayout</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier-image-parameter",
|
|
"text": " <code>image</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImage\">VkImage</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier-subresourceRange-parameter",
|
|
"text": " <code>subresourceRange</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageSubresourceRange\">VkImageSubresourceRange</a> structure"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_maintenance2)": [
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier-oldLayout-01658",
|
|
"text": " If <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> define a <a href=\"#synchronization-queue-transfers\">queue family ownership transfer</a> or <code>oldLayout</code> and <code>newLayout</code> define an <a href=\"#synchronization-image-layout-transitions\">image layout transition</a>, and <code>oldLayout</code> or <code>newLayout</code> is <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_STENCIL_ATTACHMENT_OPTIMAL</code> then <code>image</code> <strong class=\"purple\">must</strong> have been created with <code>VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier-oldLayout-01659",
|
|
"text": " If <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> define a <a href=\"#synchronization-queue-transfers\">queue family ownership transfer</a> or <code>oldLayout</code> and <code>newLayout</code> define an <a href=\"#synchronization-image-layout-transitions\">image layout transition</a>, and <code>oldLayout</code> or <code>newLayout</code> is <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_STENCIL_READ_ONLY_OPTIMAL</code> then <code>image</code> <strong class=\"purple\">must</strong> have been created with <code>VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_EXT_separate_depth_stencil_layouts)": [
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier-srcQueueFamilyIndex-04065",
|
|
"text": " If <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> define a <a href=\"#synchronization-queue-transfers\">queue family ownership transfer</a> or <code>oldLayout</code> and <code>newLayout</code> define an <a href=\"#synchronization-image-layout-transitions\">image layout transition</a>, and <code>oldLayout</code> or <code>newLayout</code> is <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL</code> then <code>image</code> <strong class=\"purple\">must</strong> have been created with at least one of <code>VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT</code>, <code>VK_IMAGE_USAGE_SAMPLED_BIT</code>, or <code>VK_IMAGE_USAGE_INPUT_ATTACHMENT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier-srcQueueFamilyIndex-04066",
|
|
"text": " If <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> define a <a href=\"#synchronization-queue-transfers\">queue family ownership transfer</a> or <code>oldLayout</code> and <code>newLayout</code> define an <a href=\"#synchronization-image-layout-transitions\">image layout transition</a>, and <code>oldLayout</code> or <code>newLayout</code> is <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_OPTIMAL</code> then <code>image</code> <strong class=\"purple\">must</strong> have been created with <code>VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT</code> set"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier-srcQueueFamilyIndex-04067",
|
|
"text": " If <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> define a <a href=\"#synchronization-queue-transfers\">queue family ownership transfer</a> or <code>oldLayout</code> and <code>newLayout</code> define an <a href=\"#synchronization-image-layout-transitions\">image layout transition</a>, and <code>oldLayout</code> or <code>newLayout</code> is <code>VK_IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL</code> then <code>image</code> <strong class=\"purple\">must</strong> have been created with at least one of <code>VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT</code>, <code>VK_IMAGE_USAGE_SAMPLED_BIT</code>, or <code>VK_IMAGE_USAGE_INPUT_ATTACHMENT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier-srcQueueFamilyIndex-04068",
|
|
"text": " If <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> define a <a href=\"#synchronization-queue-transfers\">queue family ownership transfer</a> or <code>oldLayout</code> and <code>newLayout</code> define an <a href=\"#synchronization-image-layout-transitions\">image layout transition</a>, and <code>oldLayout</code> or <code>newLayout</code> is <code>VK_IMAGE_LAYOUT_STENCIL_ATTACHMENT_OPTIMAL</code> then <code>image</code> <strong class=\"purple\">must</strong> have been created with <code>VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT</code> set"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)": [
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier-synchronization2-06911",
|
|
"text": " If the <a href=\"#features-synchronization2\"><code>synchronization2</code></a> feature is not enabled, <code>layout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_ATTACHMENT_OPTIMAL_KHR</code> or <code>VK_IMAGE_LAYOUT_READ_ONLY_OPTIMAL_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier-srcQueueFamilyIndex-03938",
|
|
"text": " If <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> define a <a href=\"#synchronization-queue-transfers\">queue family ownership transfer</a> or <code>oldLayout</code> and <code>newLayout</code> define an <a href=\"#synchronization-image-layout-transitions\">image layout transition</a>, and <code>oldLayout</code> or <code>newLayout</code> is <code>VK_IMAGE_LAYOUT_ATTACHMENT_OPTIMAL</code>, <code>image</code> <strong class=\"purple\">must</strong> have been created with <code>VK_IMAGE_USAGE_COLOR_ATTACHMENT_BIT</code> or <code>VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier-srcQueueFamilyIndex-03939",
|
|
"text": " If <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> define a <a href=\"#synchronization-queue-transfers\">queue family ownership transfer</a> or <code>oldLayout</code> and <code>newLayout</code> define an <a href=\"#synchronization-image-layout-transitions\">image layout transition</a>, and <code>oldLayout</code> or <code>newLayout</code> is <code>VK_IMAGE_LAYOUT_READ_ONLY_OPTIMAL</code>, <code>image</code> <strong class=\"purple\">must</strong> have been created with at least one of <code>VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT</code>, <code>VK_IMAGE_USAGE_SAMPLED_BIT</code>, or <code>VK_IMAGE_USAGE_INPUT_ATTACHMENT_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_KHR_fragment_shading_rate,VK_NV_shading_rate_image)": [
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier-oldLayout-02088",
|
|
"text": " If <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> define a <a href=\"#synchronization-queue-transfers\">queue family ownership transfer</a> or <code>oldLayout</code> and <code>newLayout</code> define an <a href=\"#synchronization-image-layout-transitions\">image layout transition</a>, and <code>oldLayout</code> or <code>newLayout</code> is <code>VK_IMAGE_LAYOUT_FRAGMENT_SHADING_RATE_ATTACHMENT_OPTIMAL_KHR</code> then <code>image</code> <strong class=\"purple\">must</strong> have been created with <code>VK_IMAGE_USAGE_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR</code> set"
|
|
}
|
|
],
|
|
"!(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier-image-02902",
|
|
"text": " If <code>image</code> has a color format, then the <code>aspectMask</code> member of <code>subresourceRange</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_ASPECT_COLOR_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier-image-01671",
|
|
"text": " If <code>image</code> has a single-plane color format or is not <em>disjoint</em>, then the <code>aspectMask</code> member of <code>subresourceRange</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_ASPECT_COLOR_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier-image-01672",
|
|
"text": " If <code>image</code> has a multi-planar format and the image is <em>disjoint</em>, then the <code>aspectMask</code> member of <code>subresourceRange</code> <strong class=\"purple\">must</strong> include either at least one of <code>VK_IMAGE_ASPECT_PLANE_0_BIT</code>, <code>VK_IMAGE_ASPECT_PLANE_1_BIT</code>, and <code>VK_IMAGE_ASPECT_PLANE_2_BIT</code>; or <strong class=\"purple\">must</strong> include <code>VK_IMAGE_ASPECT_COLOR_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier-image-01673",
|
|
"text": " If <code>image</code> has a multi-planar format with only two planes, then the <code>aspectMask</code> member of <code>subresourceRange</code> <strong class=\"purple\">must</strong> not include <code>VK_IMAGE_ASPECT_PLANE_2_BIT</code>"
|
|
}
|
|
],
|
|
"!(VK_VERSION_1_2,VK_KHR_separate_depth_stencil_layouts)": [
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier-image-01207",
|
|
"text": " If <code>image</code> has a depth/stencil format with both depth and stencil components, then the <code>aspectMask</code> member of <code>subresourceRange</code> <strong class=\"purple\">must</strong> include both <code>VK_IMAGE_ASPECT_DEPTH_BIT</code> and <code>VK_IMAGE_ASPECT_STENCIL_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_separate_depth_stencil_layouts)": [
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier-image-03319",
|
|
"text": " If <code>image</code> has a depth/stencil format with both depth and stencil and the <a href=\"#features-separateDepthStencilLayouts\"><code>separateDepthStencilLayouts</code></a> feature is enabled, then the <code>aspectMask</code> member of <code>subresourceRange</code> <strong class=\"purple\">must</strong> include either or both <code>VK_IMAGE_ASPECT_DEPTH_BIT</code> and <code>VK_IMAGE_ASPECT_STENCIL_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier-image-03320",
|
|
"text": " If <code>image</code> has a depth/stencil format with both depth and stencil and the <a href=\"#features-separateDepthStencilLayouts\"><code>separateDepthStencilLayouts</code></a> feature is not enabled, then the <code>aspectMask</code> member of <code>subresourceRange</code> <strong class=\"purple\">must</strong> include both <code>VK_IMAGE_ASPECT_DEPTH_BIT</code> and <code>VK_IMAGE_ASPECT_STENCIL_BIT</code>"
|
|
}
|
|
],
|
|
"!(VK_VERSION_1_1,VK_KHR_external_memory)": [
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier-image-04069",
|
|
"text": " If <code>image</code> was created with a sharing mode of <code>VK_SHARING_MODE_EXCLUSIVE</code>, and <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> are not equal, <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> <strong class=\"purple\">must</strong> be valid queue families"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier-synchronization2-03856",
|
|
"text": " If the <a href=\"#features-synchronization2\"><code>synchronization2</code></a> feature is not enabled, and <code>image</code> was created with a sharing mode of <code>VK_SHARING_MODE_CONCURRENT</code>, <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> <strong class=\"purple\">must</strong> both be <code>VK_QUEUE_FAMILY_IGNORED</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_external_memory)": [
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier-srcQueueFamilyIndex-04070",
|
|
"text": " If <code>srcQueueFamilyIndex</code> is not equal to <code>dstQueueFamilyIndex</code>, at least one <strong class=\"purple\">must</strong> not be a special queue family reserved for external memory ownership transfers, as described in <a href=\"#synchronization-queue-transfers\">Queue Family Ownership Transfer</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier-image-04071",
|
|
"text": " If <code>image</code> was created with a sharing mode of <code>VK_SHARING_MODE_CONCURRENT</code>, <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> are not equal, and one of <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> is one of the special queue family values reserved for external memory transfers, the other <strong class=\"purple\">must</strong> be <code>VK_QUEUE_FAMILY_IGNORED</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier-image-04072",
|
|
"text": " If <code>image</code> was created with a sharing mode of <code>VK_SHARING_MODE_EXCLUSIVE</code>, and <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> are not equal, <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> <strong class=\"purple\">must</strong> both be valid queue families, or one of the special queue family values reserved for external memory transfers, as described in <a href=\"#synchronization-queue-transfers\">Queue Family Ownership Transfer</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier-synchronization2-03857",
|
|
"text": " If the <a href=\"#features-synchronization2\"><code>synchronization2</code></a> feature is not enabled, and <code>image</code> was created with a sharing mode of <code>VK_SHARING_MODE_CONCURRENT</code>, at least one of <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> <strong class=\"purple\">must</strong> be <code>VK_QUEUE_FAMILY_IGNORED</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_attachment_feedback_loop_layout)": [
|
|
{
|
|
"vuid": "VUID-VkImageMemoryBarrier-srcQueueFamilyIndex-07006",
|
|
"text": " If <code>srcQueueFamilyIndex</code> and <code>dstQueueFamilyIndex</code> define a <a href=\"#synchronization-queue-transfers\">queue family ownership transfer</a> or <code>oldLayout</code> and <code>newLayout</code> define an <a href=\"#synchronization-image-layout-transitions\">image layout transition</a>, and <code>oldLayout</code> or <code>newLayout</code> is <code>VK_IMAGE_LAYOUT_ATTACHMENT_FEEDBACK_LOOP_OPTIMAL_EXT</code> then <code>image</code> <strong class=\"purple\">must</strong> have been created with either the <code>VK_IMAGE_USAGE_COLOR_ATTACHMENT_BIT</code> or <code>VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT</code> usage bits, and the <code>VK_IMAGE_USAGE_INPUT_ATTACHMENT_BIT</code> or <code>VK_IMAGE_USAGE_SAMPLED_BIT</code> usage bits, and the <code>VK_IMAGE_USAGE_ATTACHMENT_FEEDBACK_LOOP_BIT_EXT</code> usage bit."
|
|
}
|
|
]
|
|
},
|
|
"vkQueueWaitIdle": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkQueueWaitIdle-queue-parameter",
|
|
"text": " <code>queue</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkQueue\">VkQueue</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"vkDeviceWaitIdle": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkDeviceWaitIdle-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"vkGetCalibratedTimestampsEXT": {
|
|
"(VK_EXT_calibrated_timestamps)": [
|
|
{
|
|
"vuid": "VUID-vkGetCalibratedTimestampsEXT-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetCalibratedTimestampsEXT-pTimestampInfos-parameter",
|
|
"text": " <code>pTimestampInfos</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>timestampCount</code> valid <a href=\"#VkCalibratedTimestampInfoEXT\">VkCalibratedTimestampInfoEXT</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetCalibratedTimestampsEXT-pTimestamps-parameter",
|
|
"text": " <code>pTimestamps</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>timestampCount</code> <code>uint64_t</code> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetCalibratedTimestampsEXT-pMaxDeviation-parameter",
|
|
"text": " <code>pMaxDeviation</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>uint64_t</code> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetCalibratedTimestampsEXT-timestampCount-arraylength",
|
|
"text": " <code>timestampCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkCalibratedTimestampInfoEXT": {
|
|
"(VK_EXT_calibrated_timestamps)": [
|
|
{
|
|
"vuid": "VUID-VkCalibratedTimestampInfoEXT-timeDomain-02354",
|
|
"text": " <code>timeDomain</code> <strong class=\"purple\">must</strong> be one of the <a href=\"#VkTimeDomainEXT\">VkTimeDomainEXT</a> values returned by <a href=\"#vkGetPhysicalDeviceCalibrateableTimeDomainsEXT\">vkGetPhysicalDeviceCalibrateableTimeDomainsEXT</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCalibratedTimestampInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_CALIBRATED_TIMESTAMP_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCalibratedTimestampInfoEXT-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCalibratedTimestampInfoEXT-timeDomain-parameter",
|
|
"text": " <code>timeDomain</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkTimeDomainEXT\">VkTimeDomainEXT</a> value"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdBeginRendering": {
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBeginRendering-dynamicRendering-06446",
|
|
"text": " The <a href=\"#features-dynamicRendering\"><code>dynamicRendering</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginRendering-commandBuffer-06068",
|
|
"text": " If <code>commandBuffer</code> is a secondary command buffer, <code>pRenderingInfo->flags</code> <strong class=\"purple\">must</strong> not include <code>VK_RENDERING_CONTENTS_SECONDARY_COMMAND_BUFFERS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginRendering-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginRendering-pRenderingInfo-parameter",
|
|
"text": " <code>pRenderingInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkRenderingInfo\">VkRenderingInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginRendering-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginRendering-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginRendering-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginRendering-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
]
|
|
},
|
|
"VkRenderingInfo": {
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)": [
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-viewMask-06069",
|
|
"text": " If <code>viewMask</code> is <code>0</code>, <code>layerCount</code> <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-multisampledRenderToSingleSampled-06857",
|
|
"text": " If none of the <code><a href=\"#VK_AMD_mixed_attachment_samples\">VK_AMD_mixed_attachment_samples</a></code> extension, the <code><a href=\"#VK_NV_framebuffer_mixed_samples\">VK_NV_framebuffer_mixed_samples</a></code> extension, or the <a href=\"#features-multisampledRenderToSingleSampled\"><code>multisampledRenderToSingleSampled</code></a> feature are enabled, <code>imageView</code> members of <code>pDepthAttachment</code>, <code>pStencilAttachment</code>, and elements of <code>pColorAttachments</code> that are not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> <strong class=\"purple\">must</strong> have been created with the same <code>sampleCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-colorAttachmentCount-06087",
|
|
"text": " If <code>colorAttachmentCount</code> is not <code>0</code> and the <code>imageView</code> member of an element of <code>pColorAttachments</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, that <code>imageView</code> <strong class=\"purple\">must</strong> have been created with <code>VK_IMAGE_USAGE_COLOR_ATTACHMENT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-pDepthAttachment-06547",
|
|
"text": " If <code>pDepthAttachment</code> is not <code>NULL</code> and <code>pDepthAttachment->imageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>pDepthAttachment->imageView</code> <strong class=\"purple\">must</strong> have been created with a format that includes a depth aspect"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-pDepthAttachment-06088",
|
|
"text": " If <code>pDepthAttachment</code> is not <code>NULL</code> and <code>pDepthAttachment->imageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>pDepthAttachment->imageView</code> <strong class=\"purple\">must</strong> have been created with <code>VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-pStencilAttachment-06548",
|
|
"text": " If <code>pStencilAttachment</code> is not <code>NULL</code> and <code>pStencilAttachment->imageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>pStencilAttachment->imageView</code> <strong class=\"purple\">must</strong> have been created with a format that includes a stencil aspect"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-pStencilAttachment-06089",
|
|
"text": " If <code>pStencilAttachment</code> is not <code>NULL</code> and <code>pStencilAttachment->imageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>pStencilAttachment->imageView</code> <strong class=\"purple\">must</strong> have been created with a stencil usage including <code>VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-colorAttachmentCount-06090",
|
|
"text": " If <code>colorAttachmentCount</code> is not <code>0</code> and the <code>imageView</code> member of an element of <code>pColorAttachments</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the <code>layout</code> member of that element of <code>pColorAttachments</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_ATTACHMENT_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-colorAttachmentCount-06091",
|
|
"text": " If <code>colorAttachmentCount</code> is not <code>0</code> and the <code>imageView</code> member of an element of <code>pColorAttachments</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, if the <code>resolveMode</code> member of that element of <code>pColorAttachments</code> is not <code>VK_RESOLVE_MODE_NONE</code>, its <code>resolveImageLayout</code> member <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_ATTACHMENT_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-pDepthAttachment-06092",
|
|
"text": " If <code>pDepthAttachment</code> is not <code>NULL</code> and <code>pDepthAttachment->imageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>pDepthAttachment->layout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_COLOR_ATTACHMENT_OPTIMAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-pDepthAttachment-06093",
|
|
"text": " If <code>pDepthAttachment</code> is not <code>NULL</code>, <code>pDepthAttachment->imageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and <code>pDepthAttachment->resolveMode</code> is not <code>VK_RESOLVE_MODE_NONE</code>, <code>pDepthAttachment->resolveImageLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_COLOR_ATTACHMENT_OPTIMAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-pStencilAttachment-06094",
|
|
"text": " If <code>pStencilAttachment</code> is not <code>NULL</code> and <code>pStencilAttachment->imageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>pStencilAttachment->layout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_COLOR_ATTACHMENT_OPTIMAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-pStencilAttachment-06095",
|
|
"text": " If <code>pStencilAttachment</code> is not <code>NULL</code>, <code>pStencilAttachment->imageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and <code>pStencilAttachment->resolveMode</code> is not <code>VK_RESOLVE_MODE_NONE</code>, <code>pStencilAttachment->resolveImageLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_COLOR_ATTACHMENT_OPTIMAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-pDepthAttachment-06102",
|
|
"text": " If <code>pDepthAttachment</code> is not <code>NULL</code> and <code>pDepthAttachment->imageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>pDepthAttachment->resolveMode</code> <strong class=\"purple\">must</strong> be one of the bits set in <a href=\"#VkPhysicalDeviceDepthStencilResolveProperties\">VkPhysicalDeviceDepthStencilResolveProperties</a>::<code>supportedDepthResolveModes</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-pStencilAttachment-06103",
|
|
"text": " If <code>pStencilAttachment</code> is not <code>NULL</code> and <code>pStencilAttachment->imageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>pStencilAttachment->resolveMode</code> <strong class=\"purple\">must</strong> be one of the bits set in <a href=\"#VkPhysicalDeviceDepthStencilResolveProperties\">VkPhysicalDeviceDepthStencilResolveProperties</a>::<code>supportedStencilResolveModes</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-pDepthAttachment-06104",
|
|
"text": " If <code>pDepthAttachment</code> or <code>pStencilAttachment</code> are both not <code>NULL</code>, <code>pDepthAttachment->imageView</code> and <code>pStencilAttachment->imageView</code> are both not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and <a href=\"#VkPhysicalDeviceDepthStencilResolveProperties\">VkPhysicalDeviceDepthStencilResolveProperties</a>::<code>independentResolveNone</code> is <code>VK_FALSE</code>, the <code>resolveMode</code> of both structures <strong class=\"purple\">must</strong> be the same value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-pDepthAttachment-06105",
|
|
"text": " If <code>pDepthAttachment</code> or <code>pStencilAttachment</code> are both not <code>NULL</code>, <code>pDepthAttachment->imageView</code> and <code>pStencilAttachment->imageView</code> are both not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <a href=\"#VkPhysicalDeviceDepthStencilResolveProperties\">VkPhysicalDeviceDepthStencilResolveProperties</a>::<code>independentResolve</code> is <code>VK_FALSE</code>, and the <code>resolveMode</code> of neither structure is <code>VK_RESOLVE_MODE_NONE</code>, the <code>resolveMode</code> of both structures <strong class=\"purple\">must</strong> be the same value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-colorAttachmentCount-06106",
|
|
"text": " <code>colorAttachmentCount</code> <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#VkPhysicalDeviceLimits\">VkPhysicalDeviceLimits</a>::<code>maxColorAttachments</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-multiview-06127",
|
|
"text": " If the <a href=\"#features-multiview\"><code>multiview</code></a> feature is not enabled, <code>viewMask</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_RENDERING_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-pNext-pNext",
|
|
"text": " Each <code>pNext</code> member of any structure (including this one) in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be either <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkDeviceGroupRenderPassBeginInfo\">VkDeviceGroupRenderPassBeginInfo</a>, <a href=\"#VkMultisampledRenderToSingleSampledInfoEXT\">VkMultisampledRenderToSingleSampledInfoEXT</a>, <a href=\"#VkMultiviewPerViewAttributesInfoNVX\">VkMultiviewPerViewAttributesInfoNVX</a>, <a href=\"#VkRenderingFragmentDensityMapAttachmentInfoEXT\">VkRenderingFragmentDensityMapAttachmentInfoEXT</a>, or <a href=\"#VkRenderingFragmentShadingRateAttachmentInfoKHR\">VkRenderingFragmentShadingRateAttachmentInfoKHR</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkRenderingFlagBits\">VkRenderingFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-pColorAttachments-parameter",
|
|
"text": " If <code>colorAttachmentCount</code> is not <code>0</code>, <code>pColorAttachments</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>colorAttachmentCount</code> valid <a href=\"#VkRenderingAttachmentInfo\">VkRenderingAttachmentInfo</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-pDepthAttachment-parameter",
|
|
"text": " If <code>pDepthAttachment</code> is not <code>NULL</code>, <code>pDepthAttachment</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkRenderingAttachmentInfo\">VkRenderingAttachmentInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-pStencilAttachment-parameter",
|
|
"text": " If <code>pStencilAttachment</code> is not <code>NULL</code>, <code>pStencilAttachment</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkRenderingAttachmentInfo\">VkRenderingAttachmentInfo</a> structure"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_EXT_multisampled_render_to_single_sampled)": [
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-imageView-06858",
|
|
"text": " If <a href=\"#subpass-multisampledrendertosinglesampled\">multisampled-render-to-single-sampled</a> is enabled, then all attachments referenced by <code>imageView</code> members of <code>pDepthAttachment</code>, <code>pStencilAttachment</code>, and elements of <code>pColorAttachments</code> that are not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> <strong class=\"purple\">must</strong> have a sample count that is either <code>VK_SAMPLE_COUNT_1_BIT</code> or equal to <a href=\"#VkMultisampledRenderToSingleSampledInfoEXT\">VkMultisampledRenderToSingleSampledInfoEXT</a>::<code>rasterizationSamples</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-imageView-06859",
|
|
"text": " If <a href=\"#subpass-multisampledrendertosinglesampled\">multisampled-render-to-single-sampled</a> is enabled, then all attachments referenced by <code>imageView</code> members of <code>pDepthAttachment</code>, <code>pStencilAttachment</code>, and elements of <code>pColorAttachments</code> that are not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> and have a sample count of <code>VK_SAMPLE_COUNT_1_BIT</code> <strong class=\"purple\">must</strong> have been created with <code>VK_IMAGE_CREATE_MULTISAMPLED_RENDER_TO_SINGLE_SAMPLED_BIT_EXT</code> in their <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a>::<code>flags</code>."
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+!(VK_VERSION_1_1,VK_KHR_device_group)": [
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-renderArea-06071",
|
|
"text": " <code>renderArea.offset.x</code> <strong class=\"purple\">must</strong> be greater than or equal to 0"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-renderArea-06072",
|
|
"text": " <code>renderArea.offset.y</code> <strong class=\"purple\">must</strong> be greater than or equal to 0"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-renderArea-06073",
|
|
"text": " The sum of <code>renderArea.offset.x</code> and <code>renderArea.extent.width</code> <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#limits-maxFramebufferWidth\"><code>maxFramebufferWidth</code></a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-renderArea-06074",
|
|
"text": " The sum of <code>renderArea.offset.y</code> and <code>renderArea.extent.height</code> <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#limits-maxFramebufferHeight\"><code>maxFramebufferHeight</code></a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-imageView-06075",
|
|
"text": " The width of the <code>imageView</code> member of any element of <code>pColorAttachments</code>, <code>pDepthAttachment</code>, or <code>pStencilAttachment</code> that is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> <strong class=\"purple\">must</strong> be greater than or equal to <span class=\"eq\"><code>renderArea.offset.x</code> + <code>renderArea.extent.width</code></span>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-imageView-06076",
|
|
"text": " The height of the <code>imageView</code> member of any element of <code>pColorAttachments</code>, <code>pDepthAttachment</code>, or <code>pStencilAttachment</code> that is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> <strong class=\"purple\">must</strong> be greater than or equal to <span class=\"eq\"><code>renderArea.offset.y</code> + <code>renderArea.extent.height</code></span>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_VERSION_1_1,VK_KHR_device_group)": [
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-pNext-06077",
|
|
"text": " If the <code>pNext</code> chain does not contain <a href=\"#VkDeviceGroupRenderPassBeginInfo\">VkDeviceGroupRenderPassBeginInfo</a> or its <code>deviceRenderAreaCount</code> member is equal to 0, <code>renderArea.offset.x</code> <strong class=\"purple\">must</strong> be greater than or equal to 0"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-pNext-06078",
|
|
"text": " If the <code>pNext</code> chain does not contain <a href=\"#VkDeviceGroupRenderPassBeginInfo\">VkDeviceGroupRenderPassBeginInfo</a> or its <code>deviceRenderAreaCount</code> member is equal to 0, <code>renderArea.offset.y</code> <strong class=\"purple\">must</strong> be greater than or equal to 0"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-pNext-06079",
|
|
"text": " If the <code>pNext</code> chain does not contain <a href=\"#VkDeviceGroupRenderPassBeginInfo\">VkDeviceGroupRenderPassBeginInfo</a> or its <code>deviceRenderAreaCount</code> member is equal to 0, the width of the <code>imageView</code> member of any element of <code>pColorAttachments</code>, <code>pDepthAttachment</code>, or <code>pStencilAttachment</code> that is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> <strong class=\"purple\">must</strong> be greater than or equal to <span class=\"eq\"><code>renderArea.offset.x</code> + <code>renderArea.extent.width</code></span>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-pNext-06080",
|
|
"text": " If the <code>pNext</code> chain does not contain <a href=\"#VkDeviceGroupRenderPassBeginInfo\">VkDeviceGroupRenderPassBeginInfo</a> or its <code>deviceRenderAreaCount</code> member is equal to 0, the height of the <code>imageView</code> member of any element of <code>pColorAttachments</code>, <code>pDepthAttachment</code>, or <code>pStencilAttachment</code> that is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> <strong class=\"purple\">must</strong> be greater than or equal to <span class=\"eq\"><code>renderArea.offset.y</code> + <code>renderArea.extent.height</code></span>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-pNext-06083",
|
|
"text": " If the <code>pNext</code> chain contains <a href=\"#VkDeviceGroupRenderPassBeginInfo\">VkDeviceGroupRenderPassBeginInfo</a>, the width of the <code>imageView</code> member of any element of <code>pColorAttachments</code>, <code>pDepthAttachment</code>, or <code>pStencilAttachment</code> that is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> <strong class=\"purple\">must</strong> be greater than or equal to the sum of the <code>offset.x</code> and <code>extent.width</code> members of each element of <code>pDeviceRenderAreas</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-pNext-06084",
|
|
"text": " If the <code>pNext</code> chain contains <a href=\"#VkDeviceGroupRenderPassBeginInfo\">VkDeviceGroupRenderPassBeginInfo</a>, the height of the <code>imageView</code> member of any element of <code>pColorAttachments</code>, <code>pDepthAttachment</code>, or <code>pStencilAttachment</code> that is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> <strong class=\"purple\">must</strong> be greater than or equal to the sum of the <code>offset.y</code> and <code>extent.height</code> members of each element of <code>pDeviceRenderAreas</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-pDepthAttachment-06085",
|
|
"text": " If neither <code>pDepthAttachment</code> or <code>pStencilAttachment</code> are <code>NULL</code> and the <code>imageView</code> member of either structure is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the <code>imageView</code> member of each structure <strong class=\"purple\">must</strong> be the same"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-pDepthAttachment-06086",
|
|
"text": " If neither <code>pDepthAttachment</code> or <code>pStencilAttachment</code> are <code>NULL</code>, and the <code>resolveMode</code> member of each is not <code>VK_RESOLVE_MODE_NONE</code>, the <code>resolveImageView</code> member of each structure <strong class=\"purple\">must</strong> be the same"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_KHR_maintenance2,VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-colorAttachmentCount-06096",
|
|
"text": " If <code>colorAttachmentCount</code> is not <code>0</code> and the <code>imageView</code> member of an element of <code>pColorAttachments</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the <code>layout</code> member of that element of <code>pColorAttachments</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_STENCIL_ATTACHMENT_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_STENCIL_READ_ONLY_OPTIMAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-colorAttachmentCount-06097",
|
|
"text": " If <code>colorAttachmentCount</code> is not <code>0</code> and the <code>imageView</code> member of an element of <code>pColorAttachments</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, if the <code>resolveMode</code> member of that element of <code>pColorAttachments</code> is not <code>VK_RESOLVE_MODE_NONE</code>, its <code>resolveImageLayout</code> member <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_STENCIL_ATTACHMENT_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_STENCIL_READ_ONLY_OPTIMAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-pDepthAttachment-06098",
|
|
"text": " If <code>pDepthAttachment</code> is not <code>NULL</code>, <code>pDepthAttachment->imageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and <code>pDepthAttachment->resolveMode</code> is not <code>VK_RESOLVE_MODE_NONE</code>, <code>pDepthAttachment->resolveImageLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_STENCIL_ATTACHMENT_OPTIMAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-pStencilAttachment-06099",
|
|
"text": " If <code>pStencilAttachment</code> is not <code>NULL</code>, <code>pStencilAttachment->imageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and <code>pStencilAttachment->resolveMode</code> is not <code>VK_RESOLVE_MODE_NONE</code>, <code>pStencilAttachment->resolveImageLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_STENCIL_READ_ONLY_OPTIMAL</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_KHR_separate_depth_stencil_layouts,VK_VERSION_1_2)": [
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-colorAttachmentCount-06100",
|
|
"text": " If <code>colorAttachmentCount</code> is not <code>0</code> and the <code>imageView</code> member of an element of <code>pColorAttachments</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the <code>layout</code> member of that element of <code>pColorAttachments</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_STENCIL_ATTACHMENT_OPTIMAL</code>, or <code>VK_IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-colorAttachmentCount-06101",
|
|
"text": " If <code>colorAttachmentCount</code> is not <code>0</code> and the <code>imageView</code> member of an element of <code>pColorAttachments</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, if the <code>resolveMode</code> member of that element of <code>pColorAttachments</code> is not <code>VK_RESOLVE_MODE_NONE</code>, its <code>resolveImageLayout</code> member <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_STENCIL_ATTACHMENT_OPTIMAL</code>, or <code>VK_IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_EXT_fragment_density_map)": [
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-imageView-06107",
|
|
"text": " If the <code>imageView</code> member of a <a href=\"#VkRenderingFragmentDensityMapAttachmentInfoEXT\">VkRenderingFragmentDensityMapAttachmentInfoEXT</a> structure included in the <code>pNext</code> chain is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <a href=\"#features-fragmentDensityMapNonSubsampledImages\"><code>fragmentDensityMapNonSubsampledImages</code></a> feature is not enabled, valid <code>imageView</code> and <code>resolveImageView</code> members of <code>pDepthAttachment</code>, <code>pStencilAttachment</code>, and each element of <code>pColorAttachments</code> <strong class=\"purple\">must</strong> be a <a href=\"#VkImageView\">VkImageView</a> created with <code>VK_IMAGE_CREATE_SUBSAMPLED_BIT_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-imageView-06116",
|
|
"text": " If the <code>imageView</code> member of a <a href=\"#VkRenderingFragmentDensityMapAttachmentInfoEXT\">VkRenderingFragmentDensityMapAttachmentInfoEXT</a> structure included in the <code>pNext</code> chain is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, it <strong class=\"purple\">must</strong> not be equal to the <code>imageView</code> or <code>resolveImageView</code> member of <code>pDepthAttachment</code>, <code>pStencilAttachment</code>, or any element of <code>pColorAttachments</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_EXT_fragment_density_map)+(VK_VERSION_1_1,VK_KHR_multiview)": [
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-imageView-06108",
|
|
"text": " If the <code>imageView</code> member of a <a href=\"#VkRenderingFragmentDensityMapAttachmentInfoEXT\">VkRenderingFragmentDensityMapAttachmentInfoEXT</a> structure included in the <code>pNext</code> chain is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and <code>viewMask</code> is not <code>0</code>, <code>imageView</code> <strong class=\"purple\">must</strong> have a <code>layerCount</code> greater than or equal to the index of the most significant bit in <code>viewMask</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-imageView-06109",
|
|
"text": " If the <code>imageView</code> member of a <a href=\"#VkRenderingFragmentDensityMapAttachmentInfoEXT\">VkRenderingFragmentDensityMapAttachmentInfoEXT</a> structure included in the <code>pNext</code> chain is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and <code>viewMask</code> is <code>0</code>, <code>imageView</code> <strong class=\"purple\">must</strong> have a <code>layerCount</code> equal to <code>1</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_EXT_fragment_density_map)+!(VK_VERSION_1_1,VK_KHR_device_group)": [
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-imageView-06110",
|
|
"text": " If the <code>imageView</code> member of a <a href=\"#VkRenderingFragmentDensityMapAttachmentInfoEXT\">VkRenderingFragmentDensityMapAttachmentInfoEXT</a> structure included in the <code>pNext</code> chain is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>imageView</code> <strong class=\"purple\">must</strong> have a width greater than or equal to \\(\\left\\lceil{\\frac{renderArea_{x}+renderArea_{width}}{maxFragmentDensityTexelSize_{width}}}\\right\\rceil\\)"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-imageView-06111",
|
|
"text": " If the <code>imageView</code> member of a <a href=\"#VkRenderingFragmentDensityMapAttachmentInfoEXT\">VkRenderingFragmentDensityMapAttachmentInfoEXT</a> structure included in the <code>pNext</code> chain is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>imageView</code> <strong class=\"purple\">must</strong> have a height greater than or equal to \\(\\left\\lceil{\\frac{renderArea_{y}+renderArea_{height}}{maxFragmentDensityTexelSize_{height}}}\\right\\rceil\\)"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_EXT_fragment_density_map)+(VK_VERSION_1_1,VK_KHR_device_group)": [
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-pNext-06112",
|
|
"text": " If the <code>pNext</code> chain does not contain <a href=\"#VkDeviceGroupRenderPassBeginInfo\">VkDeviceGroupRenderPassBeginInfo</a> or its <code>deviceRenderAreaCount</code> member is equal to 0 and the <code>imageView</code> member of a <a href=\"#VkRenderingFragmentDensityMapAttachmentInfoEXT\">VkRenderingFragmentDensityMapAttachmentInfoEXT</a> structure included in the <code>pNext</code> chain is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>imageView</code> <strong class=\"purple\">must</strong> have a width greater than or equal to \\(\\left\\lceil{\\frac{renderArea_{x}+renderArea_{width}}{maxFragmentDensityTexelSize_{width}}}\\right\\rceil\\)"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-pNext-06113",
|
|
"text": " If the <code>pNext</code> chain contains a <a href=\"#VkDeviceGroupRenderPassBeginInfo\">VkDeviceGroupRenderPassBeginInfo</a> structure, its <code>deviceRenderAreaCount</code> member is not 0, and the <code>imageView</code> member of a <a href=\"#VkRenderingFragmentDensityMapAttachmentInfoEXT\">VkRenderingFragmentDensityMapAttachmentInfoEXT</a> structure included in the <code>pNext</code> chain is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>imageView</code> <strong class=\"purple\">must</strong> have a width greater than or equal to \\(\\left\\lceil{\\frac{pDeviceRenderAreas_{x}+pDeviceRenderAreas_{width}}{maxFragmentDensityTexelSize_{width}}}\\right\\rceil\\) for each element of <code>pDeviceRenderAreas</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-pNext-06114",
|
|
"text": " If the <code>pNext</code> chain does not contain <a href=\"#VkDeviceGroupRenderPassBeginInfo\">VkDeviceGroupRenderPassBeginInfo</a> or its <code>deviceRenderAreaCount</code> member is equal to 0 and the <code>imageView</code> member of a <a href=\"#VkRenderingFragmentDensityMapAttachmentInfoEXT\">VkRenderingFragmentDensityMapAttachmentInfoEXT</a> structure included in the <code>pNext</code> chain is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>imageView</code> <strong class=\"purple\">must</strong> have a height greater than or equal to \\(\\left\\lceil{\\frac{renderArea_{y}+renderArea_{height}}{maxFragmentDensityTexelSize_{height}}}\\right\\rceil\\)"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-pNext-06115",
|
|
"text": " If the <code>pNext</code> chain contains a <a href=\"#VkDeviceGroupRenderPassBeginInfo\">VkDeviceGroupRenderPassBeginInfo</a> structure, its <code>deviceRenderAreaCount</code> member is not 0, and the <code>imageView</code> member of a <a href=\"#VkRenderingFragmentDensityMapAttachmentInfoEXT\">VkRenderingFragmentDensityMapAttachmentInfoEXT</a> structure included in the <code>pNext</code> chain is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>imageView</code> <strong class=\"purple\">must</strong> have a height greater than or equal to \\(\\left\\lceil{\\frac{pDeviceRenderAreas_{y}+pDeviceRenderAreas_{height}}{maxFragmentDensityTexelSize_{height}}}\\right\\rceil\\) for each element of <code>pDeviceRenderAreas</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_KHR_fragment_shading_rate)+!(VK_VERSION_1_1,VK_KHR_device_group)": [
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-imageView-06117",
|
|
"text": " If the <code>imageView</code> member of a <a href=\"#VkRenderingFragmentShadingRateAttachmentInfoKHR\">VkRenderingFragmentShadingRateAttachmentInfoKHR</a> structure included in the <code>pNext</code> chain is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>imageView</code> <strong class=\"purple\">must</strong> have a width greater than or equal to \\(\\left\\lceil{\\frac{renderArea_{x}+renderArea_{width}}{shadingRateAttachmentTexelSize_{width}}}\\right\\rceil\\)"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-imageView-06118",
|
|
"text": " If the <code>imageView</code> member of a <a href=\"#VkRenderingFragmentShadingRateAttachmentInfoKHR\">VkRenderingFragmentShadingRateAttachmentInfoKHR</a> structure included in the <code>pNext</code> chain is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>imageView</code> <strong class=\"purple\">must</strong> have a height greater than or equal to \\(\\left\\lceil{\\frac{renderArea_{y}+renderArea_{height}}{shadingRateAttachmentTexelSize_{height}}}\\right\\rceil\\)"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_KHR_fragment_shading_rate)+(VK_VERSION_1_1,VK_KHR_device_group)": [
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-pNext-06119",
|
|
"text": " If the <code>pNext</code> chain does not contain <a href=\"#VkDeviceGroupRenderPassBeginInfo\">VkDeviceGroupRenderPassBeginInfo</a> or its <code>deviceRenderAreaCount</code> member is equal to 0 and the <code>imageView</code> member of a <a href=\"#VkRenderingFragmentShadingRateAttachmentInfoKHR\">VkRenderingFragmentShadingRateAttachmentInfoKHR</a> structure included in the <code>pNext</code> chain is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>imageView</code> <strong class=\"purple\">must</strong> have a width greater than or equal to \\(\\left\\lceil{\\frac{renderArea_{x}+renderArea_{width}}{shadingRateAttachmentTexelSize_{width}}}\\right\\rceil\\)"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-pNext-06120",
|
|
"text": " If the <code>pNext</code> chain contains a <a href=\"#VkDeviceGroupRenderPassBeginInfo\">VkDeviceGroupRenderPassBeginInfo</a> structure, its <code>deviceRenderAreaCount</code> member is not 0, and the <code>imageView</code> member of a <a href=\"#VkRenderingFragmentShadingRateAttachmentInfoKHR\">VkRenderingFragmentShadingRateAttachmentInfoKHR</a> structure included in the <code>pNext</code> chain is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>imageView</code> <strong class=\"purple\">must</strong> have a width greater than or equal to \\(\\left\\lceil{\\frac{pDeviceRenderAreas_{x}+pDeviceRenderAreas_{width}}{shadingRateAttachmentTexelSize_{width}}}\\right\\rceil\\) for each element of <code>pDeviceRenderAreas</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-pNext-06121",
|
|
"text": " If the <code>pNext</code> chain does not contain <a href=\"#VkDeviceGroupRenderPassBeginInfo\">VkDeviceGroupRenderPassBeginInfo</a> or its <code>deviceRenderAreaCount</code> member is equal to 0 and the <code>imageView</code> member of a <a href=\"#VkRenderingFragmentShadingRateAttachmentInfoKHR\">VkRenderingFragmentShadingRateAttachmentInfoKHR</a> structure included in the <code>pNext</code> chain is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>imageView</code> <strong class=\"purple\">must</strong> have a height greater than or equal to \\(\\left\\lceil{\\frac{renderArea_{y}+renderArea_{height}}{shadingRateAttachmentTexelSize_{height}}}\\right\\rceil\\)"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-pNext-06122",
|
|
"text": " If the <code>pNext</code> chain contains a <a href=\"#VkDeviceGroupRenderPassBeginInfo\">VkDeviceGroupRenderPassBeginInfo</a> structure, its <code>deviceRenderAreaCount</code> member is not 0, and the <code>imageView</code> member of a <a href=\"#VkRenderingFragmentShadingRateAttachmentInfoKHR\">VkRenderingFragmentShadingRateAttachmentInfoKHR</a> structure included in the <code>pNext</code> chain is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>imageView</code> <strong class=\"purple\">must</strong> have a height greater than or equal to \\(\\left\\lceil{\\frac{pDeviceRenderAreas_{y}+pDeviceRenderAreas_{height}}{shadingRateAttachmentTexelSize_{height}}}\\right\\rceil\\) for each element of <code>pDeviceRenderAreas</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_KHR_fragment_shading_rate)": [
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-imageView-06123",
|
|
"text": " If the <code>imageView</code> member of a <a href=\"#VkRenderingFragmentShadingRateAttachmentInfoKHR\">VkRenderingFragmentShadingRateAttachmentInfoKHR</a> structure included in the <code>pNext</code> chain is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and <code>viewMask</code> is <code>0</code>, <code>imageView</code> <strong class=\"purple\">must</strong> have a <code>layerCount</code> that is either equal to <code>1</code> or greater than or equal to <code>layerCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-imageView-06124",
|
|
"text": " If the <code>imageView</code> member of a <a href=\"#VkRenderingFragmentShadingRateAttachmentInfoKHR\">VkRenderingFragmentShadingRateAttachmentInfoKHR</a> structure included in the <code>pNext</code> chain is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and <code>viewMask</code> is not <code>0</code>, <code>imageView</code> <strong class=\"purple\">must</strong> have a <code>layerCount</code> that either equal to <code>1</code> or greater than or equal to the index of the most significant bit in <code>viewMask</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-imageView-06125",
|
|
"text": " If the <code>imageView</code> member of a <a href=\"#VkRenderingFragmentShadingRateAttachmentInfoKHR\">VkRenderingFragmentShadingRateAttachmentInfoKHR</a> structure included in the <code>pNext</code> chain is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, it <strong class=\"purple\">must</strong> not be equal to the <code>imageView</code> or <code>resolveImageView</code> member of <code>pDepthAttachment</code>, <code>pStencilAttachment</code>, or any element of <code>pColorAttachments</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_KHR_fragment_shading_rate)+(VK_EXT_fragment_density_map)": [
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-imageView-06126",
|
|
"text": " If the <code>imageView</code> member of a <a href=\"#VkRenderingFragmentShadingRateAttachmentInfoKHR\">VkRenderingFragmentShadingRateAttachmentInfoKHR</a> structure included in the <code>pNext</code> chain is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, it <strong class=\"purple\">must</strong> not be equal to the <code>imageView</code> member of a <a href=\"#VkRenderingFragmentDensityMapAttachmentInfoEXT\">VkRenderingFragmentDensityMapAttachmentInfoEXT</a> structure included in the <code>pNext</code> chain"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_VERSION_1_1,VK_KHR_multiview)": [
|
|
{
|
|
"vuid": "VUID-VkRenderingInfo-viewMask-06128",
|
|
"text": " The index of the most significant bit in <code>viewMask</code> <strong class=\"purple\">must</strong> be less than <a href=\"#limits-maxMultiviewViewCount\"><code>maxMultiviewViewCount</code></a>"
|
|
}
|
|
]
|
|
},
|
|
"VkRenderingAttachmentInfo": {
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)": [
|
|
{
|
|
"vuid": "VUID-VkRenderingAttachmentInfo-imageView-06129",
|
|
"text": " If <code>imageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> and has a non-integer color format, <code>resolveMode</code> <strong class=\"purple\">must</strong> be <code>VK_RESOLVE_MODE_NONE</code> or <code>VK_RESOLVE_MODE_AVERAGE_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingAttachmentInfo-imageView-06130",
|
|
"text": " If <code>imageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> and has an integer color format, <code>resolveMode</code> <strong class=\"purple\">must</strong> be <code>VK_RESOLVE_MODE_NONE</code> or <code>VK_RESOLVE_MODE_SAMPLE_ZERO_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingAttachmentInfo-imageView-06864",
|
|
"text": " If <code>imageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>resolveImageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and <code>resolveMode</code> is not <code>VK_RESOLVE_MODE_NONE</code>, <code>resolveImageView</code> <strong class=\"purple\">must</strong> have a sample count of <code>VK_SAMPLE_COUNT_1_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingAttachmentInfo-imageView-06865",
|
|
"text": " If <code>imageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>resolveImageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and <code>resolveMode</code> is not <code>VK_RESOLVE_MODE_NONE</code>, <code>imageView</code> and <code>resolveImageView</code> <strong class=\"purple\">must</strong> have the same <a href=\"#VkFormat\">VkFormat</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingAttachmentInfo-imageView-06135",
|
|
"text": " If <code>imageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>imageLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_UNDEFINED</code>, <code>VK_IMAGE_LAYOUT_SHADER_READ_ONLY_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_TRANSFER_SRC_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_TRANSFER_DST_OPTIMAL</code>, or <code>VK_IMAGE_LAYOUT_PREINITIALIZED</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingAttachmentInfo-imageView-06136",
|
|
"text": " If <code>imageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> and <code>resolveMode</code> is not <code>VK_RESOLVE_MODE_NONE</code>, <code>resolveImageLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_UNDEFINED</code>, <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_SHADER_READ_ONLY_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_TRANSFER_SRC_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_TRANSFER_DST_OPTIMAL</code>, or <code>VK_IMAGE_LAYOUT_PREINITIALIZED</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingAttachmentInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_RENDERING_ATTACHMENT_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingAttachmentInfo-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingAttachmentInfo-imageView-parameter",
|
|
"text": " If <code>imageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>imageView</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageView\">VkImageView</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingAttachmentInfo-imageLayout-parameter",
|
|
"text": " <code>imageLayout</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageLayout\">VkImageLayout</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingAttachmentInfo-resolveMode-parameter",
|
|
"text": " If <code>resolveMode</code> is not <code>0</code>, <code>resolveMode</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkResolveModeFlagBits\">VkResolveModeFlagBits</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingAttachmentInfo-resolveImageView-parameter",
|
|
"text": " If <code>resolveImageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>resolveImageView</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageView\">VkImageView</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingAttachmentInfo-resolveImageLayout-parameter",
|
|
"text": " <code>resolveImageLayout</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageLayout\">VkImageLayout</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingAttachmentInfo-loadOp-parameter",
|
|
"text": " <code>loadOp</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkAttachmentLoadOp\">VkAttachmentLoadOp</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingAttachmentInfo-storeOp-parameter",
|
|
"text": " <code>storeOp</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkAttachmentStoreOp\">VkAttachmentStoreOp</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingAttachmentInfo-clearValue-parameter",
|
|
"text": " <code>clearValue</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkClearValue\">VkClearValue</a> union"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingAttachmentInfo-commonparent",
|
|
"text": " Both of <code>imageView</code>, and <code>resolveImageView</code> that are valid handles of non-ignored parameters <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+!(VK_EXT_multisampled_render_to_single_sampled)": [
|
|
{
|
|
"vuid": "VUID-VkRenderingAttachmentInfo-imageView-06132",
|
|
"text": " If <code>imageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> and <code>resolveMode</code> is not <code>VK_RESOLVE_MODE_NONE</code>, <code>imageView</code> <strong class=\"purple\">must</strong> not have a sample count of <code>VK_SAMPLE_COUNT_1_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingAttachmentInfo-imageView-06860",
|
|
"text": " If <code>imageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> and <code>resolveMode</code> is not <code>VK_RESOLVE_MODE_NONE</code>, <code>resolveImageView</code> <strong class=\"purple\">must</strong> not be <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_EXT_multisampled_render_to_single_sampled)": [
|
|
{
|
|
"vuid": "VUID-VkRenderingAttachmentInfo-imageView-06861",
|
|
"text": " If <code>imageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>resolveMode</code> is not <code>VK_RESOLVE_MODE_NONE</code>, and the <code>pNext</code> chain of <a href=\"#VkRenderingInfo\">VkRenderingInfo</a> does not includes a <a href=\"#VkMultisampledRenderToSingleSampledInfoEXT\">VkMultisampledRenderToSingleSampledInfoEXT</a> structure with the <code>multisampledRenderToSingleSampledEnable</code> field equal to <code>VK_TRUE</code>, <code>imageView</code> <strong class=\"purple\">must</strong> not have a sample count of <code>VK_SAMPLE_COUNT_1_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingAttachmentInfo-imageView-06862",
|
|
"text": " If <code>imageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>resolveMode</code> is not <code>VK_RESOLVE_MODE_NONE</code>, and the <code>pNext</code> chain of <a href=\"#VkRenderingInfo\">VkRenderingInfo</a> does not includes a <a href=\"#VkMultisampledRenderToSingleSampledInfoEXT\">VkMultisampledRenderToSingleSampledInfoEXT</a> structure with the <code>multisampledRenderToSingleSampledEnable</code> field equal to <code>VK_TRUE</code>, <code>resolveImageView</code> <strong class=\"purple\">must</strong> not be <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingAttachmentInfo-imageView-06863",
|
|
"text": " If <code>imageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>resolveMode</code> is not <code>VK_RESOLVE_MODE_NONE</code>, the <code>pNext</code> chain of <a href=\"#VkRenderingInfo\">VkRenderingInfo</a> includes a <a href=\"#VkMultisampledRenderToSingleSampledInfoEXT\">VkMultisampledRenderToSingleSampledInfoEXT</a> structure with the <code>multisampledRenderToSingleSampledEnable</code> field equal to <code>VK_TRUE</code>, and <code>imageView</code> has a sample count of <code>VK_SAMPLE_COUNT_1_BIT</code>, <code>resolveImageView</code> <strong class=\"purple\">must</strong> be <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_KHR_separate_depth_stencil_layouts,VK_VERSION_1_2)": [
|
|
{
|
|
"vuid": "VUID-VkRenderingAttachmentInfo-imageView-06137",
|
|
"text": " If <code>imageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> and <code>resolveMode</code> is not <code>VK_RESOLVE_MODE_NONE</code>, <code>resolveImageLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_NV_shading_rate_image)": [
|
|
{
|
|
"vuid": "VUID-VkRenderingAttachmentInfo-imageView-06138",
|
|
"text": " If <code>imageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>imageLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_SHADING_RATE_OPTIMAL_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingAttachmentInfo-imageView-06139",
|
|
"text": " If <code>imageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> and <code>resolveMode</code> is not <code>VK_RESOLVE_MODE_NONE</code>, <code>resolveImageLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_SHADING_RATE_OPTIMAL_NV</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_EXT_fragment_density_map)": [
|
|
{
|
|
"vuid": "VUID-VkRenderingAttachmentInfo-imageView-06140",
|
|
"text": " If <code>imageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>imageLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_FRAGMENT_DENSITY_MAP_OPTIMAL_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingAttachmentInfo-imageView-06141",
|
|
"text": " If <code>imageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> and <code>resolveMode</code> is not <code>VK_RESOLVE_MODE_NONE</code>, <code>resolveImageLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_FRAGMENT_DENSITY_MAP_OPTIMAL_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_VERSION_1_3,VK_KHR_synchronization2)": [
|
|
{
|
|
"vuid": "VUID-VkRenderingAttachmentInfo-imageView-06142",
|
|
"text": " If <code>imageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> and <code>resolveMode</code> is not <code>VK_RESOLVE_MODE_NONE</code>, <code>resolveImageLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_READ_ONLY_OPTIMAL_KHR</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_KHR_fragment_shading_rate)": [
|
|
{
|
|
"vuid": "VUID-VkRenderingAttachmentInfo-imageView-06143",
|
|
"text": " If <code>imageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>imageLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_FRAGMENT_SHADING_RATE_ATTACHMENT_OPTIMAL_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingAttachmentInfo-imageView-06144",
|
|
"text": " If <code>imageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> and <code>resolveMode</code> is not <code>VK_RESOLVE_MODE_NONE</code>, <code>resolveImageLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_FRAGMENT_SHADING_RATE_ATTACHMENT_OPTIMAL_KHR</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_KHR_swapchain)": [
|
|
{
|
|
"vuid": "VUID-VkRenderingAttachmentInfo-imageView-06145",
|
|
"text": " If <code>imageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>imageLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_PRESENT_SRC_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingAttachmentInfo-imageView-06146",
|
|
"text": " If <code>imageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> and <code>resolveMode</code> is not <code>VK_RESOLVE_MODE_NONE</code>, <code>resolveImageLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_PRESENT_SRC_KHR</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkRenderingFragmentShadingRateAttachmentInfoKHR": {
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_KHR_fragment_shading_rate)": [
|
|
{
|
|
"vuid": "VUID-VkRenderingFragmentShadingRateAttachmentInfoKHR-imageView-06147",
|
|
"text": " If <code>imageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>layout</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_LAYOUT_GENERAL</code> or <code>VK_IMAGE_LAYOUT_FRAGMENT_SHADING_RATE_ATTACHMENT_OPTIMAL_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingFragmentShadingRateAttachmentInfoKHR-imageView-06148",
|
|
"text": " If <code>imageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, it <strong class=\"purple\">must</strong> have been created with <code>VK_IMAGE_USAGE_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingFragmentShadingRateAttachmentInfoKHR-imageView-06149",
|
|
"text": " If <code>imageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>shadingRateAttachmentTexelSize.width</code> <strong class=\"purple\">must</strong> be a power of two value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingFragmentShadingRateAttachmentInfoKHR-imageView-06150",
|
|
"text": " If <code>imageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>shadingRateAttachmentTexelSize.width</code> <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#limits-maxFragmentShadingRateAttachmentTexelSize\"><code>maxFragmentShadingRateAttachmentTexelSize.width</code></a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingFragmentShadingRateAttachmentInfoKHR-imageView-06151",
|
|
"text": " If <code>imageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>shadingRateAttachmentTexelSize.width</code> <strong class=\"purple\">must</strong> be greater than or equal to <a href=\"#limits-minFragmentShadingRateAttachmentTexelSize\"><code>minFragmentShadingRateAttachmentTexelSize.width</code></a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingFragmentShadingRateAttachmentInfoKHR-imageView-06152",
|
|
"text": " If <code>imageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>shadingRateAttachmentTexelSize.height</code> <strong class=\"purple\">must</strong> be a power of two value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingFragmentShadingRateAttachmentInfoKHR-imageView-06153",
|
|
"text": " If <code>imageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>shadingRateAttachmentTexelSize.height</code> <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#limits-maxFragmentShadingRateAttachmentTexelSize\"><code>maxFragmentShadingRateAttachmentTexelSize.height</code></a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingFragmentShadingRateAttachmentInfoKHR-imageView-06154",
|
|
"text": " If <code>imageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>shadingRateAttachmentTexelSize.height</code> <strong class=\"purple\">must</strong> be greater than or equal to <a href=\"#limits-minFragmentShadingRateAttachmentTexelSize\"><code>minFragmentShadingRateAttachmentTexelSize.height</code></a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingFragmentShadingRateAttachmentInfoKHR-imageView-06155",
|
|
"text": " If <code>imageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the quotient of <code>shadingRateAttachmentTexelSize.width</code> and <code>shadingRateAttachmentTexelSize.height</code> <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#limits-maxFragmentShadingRateAttachmentTexelSizeAspectRatio\"><code>maxFragmentShadingRateAttachmentTexelSizeAspectRatio</code></a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingFragmentShadingRateAttachmentInfoKHR-imageView-06156",
|
|
"text": " If <code>imageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the quotient of <code>shadingRateAttachmentTexelSize.height</code> and <code>shadingRateAttachmentTexelSize.width</code> <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#limits-maxFragmentShadingRateAttachmentTexelSizeAspectRatio\"><code>maxFragmentShadingRateAttachmentTexelSizeAspectRatio</code></a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingFragmentShadingRateAttachmentInfoKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_RENDERING_FRAGMENT_SHADING_RATE_ATTACHMENT_INFO_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingFragmentShadingRateAttachmentInfoKHR-imageView-parameter",
|
|
"text": " If <code>imageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>imageView</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageView\">VkImageView</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingFragmentShadingRateAttachmentInfoKHR-imageLayout-parameter",
|
|
"text": " <code>imageLayout</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageLayout\">VkImageLayout</a> value"
|
|
}
|
|
]
|
|
},
|
|
"VkRenderingFragmentDensityMapAttachmentInfoEXT": {
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_EXT_fragment_density_map)": [
|
|
{
|
|
"vuid": "VUID-VkRenderingFragmentDensityMapAttachmentInfoEXT-imageView-06157",
|
|
"text": " If <code>imageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>layout</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_LAYOUT_GENERAL</code> or <code>VK_IMAGE_LAYOUT_FRAGMENT_DENSITY_MAP_OPTIMAL_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingFragmentDensityMapAttachmentInfoEXT-imageView-06158",
|
|
"text": " If <code>imageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, it <strong class=\"purple\">must</strong> have been created with <code>VK_IMAGE_USAGE_FRAGMENT_DENSITY_MAP_BIT_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingFragmentDensityMapAttachmentInfoEXT-imageView-06159",
|
|
"text": " If <code>imageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, it <strong class=\"purple\">must</strong> not have been created with <code>VK_IMAGE_CREATE_SUBSAMPLED_BIT_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingFragmentDensityMapAttachmentInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_RENDERING_FRAGMENT_DENSITY_MAP_ATTACHMENT_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingFragmentDensityMapAttachmentInfoEXT-imageView-parameter",
|
|
"text": " <code>imageView</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageView\">VkImageView</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderingFragmentDensityMapAttachmentInfoEXT-imageLayout-parameter",
|
|
"text": " <code>imageLayout</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageLayout\">VkImageLayout</a> value"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_EXT_fragment_density_map)+!(VK_VERSION_1_1,VK_KHR_multiview)": [
|
|
{
|
|
"vuid": "VUID-VkRenderingFragmentDensityMapAttachmentInfoEXT-imageView-06160",
|
|
"text": " If <code>imageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, it <strong class=\"purple\">must</strong> have a <code>layerCount</code> equal to <code>1</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdEndRendering": {
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)": [
|
|
{
|
|
"vuid": "VUID-vkCmdEndRendering-None-06161",
|
|
"text": " The current render pass instance <strong class=\"purple\">must</strong> have been begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndRendering-commandBuffer-06162",
|
|
"text": " The current render pass instance <strong class=\"purple\">must</strong> have been begun in <code>commandBuffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndRendering-None-06999",
|
|
"text": " If <code>vkCmdBeginQuery</code>* was called within the render pass, the corresponding <code>vkCmdEndQuery</code>* <strong class=\"purple\">must</strong> have been called subsequently within the same subpass."
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndRendering-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndRendering-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndRendering-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndRendering-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called inside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndRendering-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_EXT_transform_feedback)": [
|
|
{
|
|
"vuid": "VUID-vkCmdEndRendering-None-06781",
|
|
"text": " This command <strong class=\"purple\">must</strong> not be recorded when transform feedback is active"
|
|
}
|
|
]
|
|
},
|
|
"VkTilePropertiesQCOM": {
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_QCOM_tile_properties)": [
|
|
{
|
|
"vuid": "VUID-VkTilePropertiesQCOM-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_TILE_PROPERTIES_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkTilePropertiesQCOM-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetDynamicRenderingTilePropertiesQCOM": {
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_QCOM_tile_properties)": [
|
|
{
|
|
"vuid": "VUID-vkGetDynamicRenderingTilePropertiesQCOM-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDynamicRenderingTilePropertiesQCOM-pRenderingInfo-parameter",
|
|
"text": " <code>pRenderingInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkRenderingInfo\">VkRenderingInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDynamicRenderingTilePropertiesQCOM-pProperties-parameter",
|
|
"text": " <code>pProperties</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkTilePropertiesQCOM\">VkTilePropertiesQCOM</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"vkCreateRenderPass": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCreateRenderPass-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateRenderPass-pCreateInfo-parameter",
|
|
"text": " <code>pCreateInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkRenderPassCreateInfo\">VkRenderPassCreateInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateRenderPass-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateRenderPass-pRenderPass-parameter",
|
|
"text": " <code>pRenderPass</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkRenderPass\">VkRenderPass</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkRenderPassCreateInfo": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo-attachment-00834",
|
|
"text": " If the <code>attachment</code> member of any element of <code>pInputAttachments</code>, <code>pColorAttachments</code>, <code>pResolveAttachments</code> or <code>pDepthStencilAttachment</code>, or any element of <code>pPreserveAttachments</code> in any element of <code>pSubpasses</code> is not <code>VK_ATTACHMENT_UNUSED</code>, then it <strong class=\"purple\">must</strong> be less than <code>attachmentCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo-pAttachments-00836",
|
|
"text": " For any member of <code>pAttachments</code> with a <code>loadOp</code> equal to <code>VK_ATTACHMENT_LOAD_OP_CLEAR</code>, the first use of that attachment <strong class=\"purple\">must</strong> not specify a <code>layout</code> equal to <code>VK_IMAGE_LAYOUT_SHADER_READ_ONLY_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo-pAttachments-02511",
|
|
"text": " For any member of <code>pAttachments</code> with a <code>stencilLoadOp</code> equal to <code>VK_ATTACHMENT_LOAD_OP_CLEAR</code>, the first use of that attachment <strong class=\"purple\">must</strong> not specify a <code>layout</code> equal to <code>VK_IMAGE_LAYOUT_SHADER_READ_ONLY_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo-pDependencies-00837",
|
|
"text": " For any element of <code>pDependencies</code>, if the <code>srcSubpass</code> is not <code>VK_SUBPASS_EXTERNAL</code>, all stage flags included in the <code>srcStageMask</code> member of that dependency <strong class=\"purple\">must</strong> be a pipeline stage supported by the <a href=\"#synchronization-pipeline-stages-types\">pipeline</a> identified by the <code>pipelineBindPoint</code> member of the source subpass"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo-pDependencies-00838",
|
|
"text": " For any element of <code>pDependencies</code>, if the <code>dstSubpass</code> is not <code>VK_SUBPASS_EXTERNAL</code>, all stage flags included in the <code>dstStageMask</code> member of that dependency <strong class=\"purple\">must</strong> be a pipeline stage supported by the <a href=\"#synchronization-pipeline-stages-types\">pipeline</a> identified by the <code>pipelineBindPoint</code> member of the destination subpass"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo-pDependencies-06866",
|
|
"text": " For any element of <code>pDependencies</code>, if its <code>srcSubpass</code> is not <code>VK_SUBPASS_EXTERNAL</code>, it <strong class=\"purple\">must</strong> be less than <code>subpassCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo-pDependencies-06867",
|
|
"text": " For any element of <code>pDependencies</code>, if its <code>dstSubpass</code> is not <code>VK_SUBPASS_EXTERNAL</code>, it <strong class=\"purple\">must</strong> be less than <code>subpassCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_RENDER_PASS_CREATE_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo-pNext-pNext",
|
|
"text": " Each <code>pNext</code> member of any structure (including this one) in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be either <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkRenderPassFragmentDensityMapCreateInfoEXT\">VkRenderPassFragmentDensityMapCreateInfoEXT</a>, <a href=\"#VkRenderPassInputAttachmentAspectCreateInfo\">VkRenderPassInputAttachmentAspectCreateInfo</a>, or <a href=\"#VkRenderPassMultiviewCreateInfo\">VkRenderPassMultiviewCreateInfo</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkRenderPassCreateFlagBits\">VkRenderPassCreateFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo-pAttachments-parameter",
|
|
"text": " If <code>attachmentCount</code> is not <code>0</code>, <code>pAttachments</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>attachmentCount</code> valid <a href=\"#VkAttachmentDescription\">VkAttachmentDescription</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo-pSubpasses-parameter",
|
|
"text": " <code>pSubpasses</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>subpassCount</code> valid <a href=\"#VkSubpassDescription\">VkSubpassDescription</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo-pDependencies-parameter",
|
|
"text": " If <code>dependencyCount</code> is not <code>0</code>, <code>pDependencies</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>dependencyCount</code> valid <a href=\"#VkSubpassDependency\">VkSubpassDependency</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo-subpassCount-arraylength",
|
|
"text": " <code>subpassCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_fragment_density_map)": [
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo-fragmentDensityMapAttachment-06471",
|
|
"text": " If the pNext chain includes a <a href=\"#VkRenderPassFragmentDensityMapCreateInfoEXT\">VkRenderPassFragmentDensityMapCreateInfoEXT</a> structure and the <code>fragmentDensityMapAttachment</code> member is not <code>VK_ATTACHMENT_UNUSED</code>, then <code>attachment</code> <strong class=\"purple\">must</strong> be less than <code>attachmentCount</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_maintenance2)": [
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo-pAttachments-01566",
|
|
"text": " For any member of <code>pAttachments</code> with a <code>loadOp</code> equal to <code>VK_ATTACHMENT_LOAD_OP_CLEAR</code>, the first use of that attachment <strong class=\"purple\">must</strong> not specify a <code>layout</code> equal to <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_STENCIL_ATTACHMENT_OPTIMAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo-pAttachments-01567",
|
|
"text": " For any member of <code>pAttachments</code> with a <code>stencilLoadOp</code> equal to <code>VK_ATTACHMENT_LOAD_OP_CLEAR</code>, the first use of that attachment <strong class=\"purple\">must</strong> not specify a <code>layout</code> equal to <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_STENCIL_READ_ONLY_OPTIMAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo-pNext-01926",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkRenderPassInputAttachmentAspectCreateInfo\">VkRenderPassInputAttachmentAspectCreateInfo</a> structure, the <code>subpass</code> member of each element of its <code>pAspectReferences</code> member <strong class=\"purple\">must</strong> be less than <code>subpassCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo-pNext-01927",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkRenderPassInputAttachmentAspectCreateInfo\">VkRenderPassInputAttachmentAspectCreateInfo</a> structure, the <code>inputAttachmentIndex</code> member of each element of its <code>pAspectReferences</code> member <strong class=\"purple\">must</strong> be less than the value of <code>inputAttachmentCount</code> in the element of <code>pSubpasses</code> identified by its <code>subpass</code> member"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo-pNext-01963",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkRenderPassInputAttachmentAspectCreateInfo\">VkRenderPassInputAttachmentAspectCreateInfo</a> structure, for any element of the <code>pInputAttachments</code> member of any element of <code>pSubpasses</code> where the <code>attachment</code> member is not <code>VK_ATTACHMENT_UNUSED</code>, the <code>aspectMask</code> member of the corresponding element of <a href=\"#VkRenderPassInputAttachmentAspectCreateInfo\">VkRenderPassInputAttachmentAspectCreateInfo</a>::<code>pAspectReferences</code> <strong class=\"purple\">must</strong> only include aspects that are present in images of the format specified by the element of <code>pAttachments</code> at <code>attachment</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_multiview)": [
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo-pNext-01928",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkRenderPassMultiviewCreateInfo\">VkRenderPassMultiviewCreateInfo</a> structure, and its <code>subpassCount</code> member is not zero, that member <strong class=\"purple\">must</strong> be equal to the value of <code>subpassCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo-pNext-01929",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkRenderPassMultiviewCreateInfo\">VkRenderPassMultiviewCreateInfo</a> structure, if its <code>dependencyCount</code> member is not zero, it <strong class=\"purple\">must</strong> be equal to <code>dependencyCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo-pNext-01930",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkRenderPassMultiviewCreateInfo\">VkRenderPassMultiviewCreateInfo</a> structure, for each non-zero element of <code>pViewOffsets</code>, the <code>srcSubpass</code> and <code>dstSubpass</code> members of <code>pDependencies</code> at the same index <strong class=\"purple\">must</strong> not be equal"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo-pNext-02512",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkRenderPassMultiviewCreateInfo\">VkRenderPassMultiviewCreateInfo</a> structure, for any element of <code>pDependencies</code> with a <code>dependencyFlags</code> member that does not include <code>VK_DEPENDENCY_VIEW_LOCAL_BIT</code>, the corresponding element of the <code>pViewOffsets</code> member of that <a href=\"#VkRenderPassMultiviewCreateInfo\">VkRenderPassMultiviewCreateInfo</a> instance <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo-pNext-02513",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkRenderPassMultiviewCreateInfo\">VkRenderPassMultiviewCreateInfo</a> structure, elements of its <code>pViewMasks</code> member <strong class=\"purple\">must</strong> either all be <code>0</code>, or all not be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo-pNext-02514",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkRenderPassMultiviewCreateInfo\">VkRenderPassMultiviewCreateInfo</a> structure, and each element of its <code>pViewMasks</code> member is <code>0</code>, the <code>dependencyFlags</code> member of each element of <code>pDependencies</code> <strong class=\"purple\">must</strong> not include <code>VK_DEPENDENCY_VIEW_LOCAL_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo-pNext-02515",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkRenderPassMultiviewCreateInfo\">VkRenderPassMultiviewCreateInfo</a> structure, and each element of its <code>pViewMasks</code> member is <code>0</code>, its <code>correlationMaskCount</code> member <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkRenderPassMultiviewCreateInfo": {
|
|
"(VK_VERSION_1_1,VK_KHR_multiview)": [
|
|
{
|
|
"vuid": "VUID-VkRenderPassMultiviewCreateInfo-pCorrelationMasks-00841",
|
|
"text": " Each view index <strong class=\"purple\">must</strong> not be set in more than one element of <code>pCorrelationMasks</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassMultiviewCreateInfo-multiview-06555",
|
|
"text": " If the <a href=\"#features-multiview\"><code>multiview</code></a> feature is not enabled, each element of <code>pViewMasks</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassMultiviewCreateInfo-pViewMasks-06697",
|
|
"text": " The index of the most significant bit in each element of <code>pViewMasks</code> <strong class=\"purple\">must</strong> be less than <a href=\"#limits-maxMultiviewViewCount\"><code>maxMultiviewViewCount</code></a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassMultiviewCreateInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_RENDER_PASS_MULTIVIEW_CREATE_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassMultiviewCreateInfo-pViewMasks-parameter",
|
|
"text": " If <code>subpassCount</code> is not <code>0</code>, <code>pViewMasks</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>subpassCount</code> <code>uint32_t</code> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassMultiviewCreateInfo-pViewOffsets-parameter",
|
|
"text": " If <code>dependencyCount</code> is not <code>0</code>, <code>pViewOffsets</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>dependencyCount</code> <code>int32_t</code> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassMultiviewCreateInfo-pCorrelationMasks-parameter",
|
|
"text": " If <code>correlationMaskCount</code> is not <code>0</code>, <code>pCorrelationMasks</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>correlationMaskCount</code> <code>uint32_t</code> values"
|
|
}
|
|
]
|
|
},
|
|
"VkMultiviewPerViewAttributesInfoNVX": {
|
|
"(VK_NVX_multiview_per_view_attributes)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)": [
|
|
{
|
|
"vuid": "VUID-VkMultiviewPerViewAttributesInfoNVX-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_MULTIVIEW_PER_VIEW_ATTRIBUTES_INFO_NVX</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkRenderPassFragmentDensityMapCreateInfoEXT": {
|
|
"(VK_EXT_fragment_density_map)": [
|
|
{
|
|
"vuid": "VUID-VkRenderPassFragmentDensityMapCreateInfoEXT-fragmentDensityMapAttachment-02548",
|
|
"text": " If <code>fragmentDensityMapAttachment</code> is not <code>VK_ATTACHMENT_UNUSED</code>, <code>fragmentDensityMapAttachment</code> <strong class=\"purple\">must</strong> not be an element of <code>VkSubpassDescription</code>::<code>pInputAttachments</code>, <code>VkSubpassDescription</code>::<code>pColorAttachments</code>, <code>VkSubpassDescription</code>::<code>pResolveAttachments</code>, <code>VkSubpassDescription</code>::<code>pDepthStencilAttachment</code>, or <code>VkSubpassDescription</code>::<code>pPreserveAttachments</code> for any subpass"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassFragmentDensityMapCreateInfoEXT-fragmentDensityMapAttachment-02549",
|
|
"text": " If <code>fragmentDensityMapAttachment</code> is not <code>VK_ATTACHMENT_UNUSED</code>, <code>layout</code> <strong class=\"purple\">must</strong> be equal to <code>VK_IMAGE_LAYOUT_FRAGMENT_DENSITY_MAP_OPTIMAL_EXT</code>, or <code>VK_IMAGE_LAYOUT_GENERAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassFragmentDensityMapCreateInfoEXT-fragmentDensityMapAttachment-02550",
|
|
"text": " If <code>fragmentDensityMapAttachment</code> is not <code>VK_ATTACHMENT_UNUSED</code>, <code>fragmentDensityMapAttachment</code> <strong class=\"purple\">must</strong> reference an attachment with a <code>loadOp</code> equal to <code>VK_ATTACHMENT_LOAD_OP_LOAD</code> or <code>VK_ATTACHMENT_LOAD_OP_DONT_CARE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassFragmentDensityMapCreateInfoEXT-fragmentDensityMapAttachment-02551",
|
|
"text": " If <code>fragmentDensityMapAttachment</code> is not <code>VK_ATTACHMENT_UNUSED</code>, <code>fragmentDensityMapAttachment</code> <strong class=\"purple\">must</strong> reference an attachment with a <code>storeOp</code> equal to <code>VK_ATTACHMENT_STORE_OP_DONT_CARE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassFragmentDensityMapCreateInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_RENDER_PASS_FRAGMENT_DENSITY_MAP_CREATE_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassFragmentDensityMapCreateInfoEXT-fragmentDensityMapAttachment-parameter",
|
|
"text": " <code>fragmentDensityMapAttachment</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkAttachmentReference\">VkAttachmentReference</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkAttachmentDescription": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription-format-06698",
|
|
"text": " <code>format</code> <strong class=\"purple\">must</strong> not be VK_FORMAT_UNDEFINED"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription-format-06699",
|
|
"text": " If <code>format</code> includes a color or depth aspect and <code>loadOp</code> is <code>VK_ATTACHMENT_LOAD_OP_LOAD</code>, then <code>initialLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_UNDEFINED</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription-finalLayout-00843",
|
|
"text": " <code>finalLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_UNDEFINED</code> or <code>VK_IMAGE_LAYOUT_PREINITIALIZED</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription-format-03280",
|
|
"text": " If <code>format</code> is a color format, <code>initialLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_ATTACHMENT_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription-format-03281",
|
|
"text": " If <code>format</code> is a depth/stencil format, <code>initialLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_COLOR_ATTACHMENT_OPTIMAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription-format-03282",
|
|
"text": " If <code>format</code> is a color format, <code>finalLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_ATTACHMENT_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription-format-03283",
|
|
"text": " If <code>format</code> is a depth/stencil format, <code>finalLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_COLOR_ATTACHMENT_OPTIMAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription-format-06700",
|
|
"text": " If <code>format</code> includes a stencil aspect and <code>stencilLoadOp</code> is <code>VK_ATTACHMENT_LOAD_OP_LOAD</code>, then <code>initialLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_UNDEFINED</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription-format-03292",
|
|
"text": " If <code>format</code> is a depth/stencil format which includes only the stencil aspect, <code>initialLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription-format-03293",
|
|
"text": " If <code>format</code> is a depth/stencil format which includes only the stencil aspect, <code>finalLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription-format-06242",
|
|
"text": " If <code>format</code> is a depth/stencil format which includes both depth and stencil aspects, <code>initialLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription-format-06243",
|
|
"text": " If <code>format</code> is a depth/stencil format which includes both depth and stencil aspects, <code>finalLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkAttachmentDescriptionFlagBits\">VkAttachmentDescriptionFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription-format-parameter",
|
|
"text": " <code>format</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkFormat\">VkFormat</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription-samples-parameter",
|
|
"text": " <code>samples</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSampleCountFlagBits\">VkSampleCountFlagBits</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription-loadOp-parameter",
|
|
"text": " <code>loadOp</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkAttachmentLoadOp\">VkAttachmentLoadOp</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription-storeOp-parameter",
|
|
"text": " <code>storeOp</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkAttachmentStoreOp\">VkAttachmentStoreOp</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription-stencilLoadOp-parameter",
|
|
"text": " <code>stencilLoadOp</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkAttachmentLoadOp\">VkAttachmentLoadOp</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription-stencilStoreOp-parameter",
|
|
"text": " <code>stencilStoreOp</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkAttachmentStoreOp\">VkAttachmentStoreOp</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription-initialLayout-parameter",
|
|
"text": " <code>initialLayout</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageLayout\">VkImageLayout</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription-finalLayout-parameter",
|
|
"text": " <code>finalLayout</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageLayout\">VkImageLayout</a> value"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_maintenance2)": [
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription-format-06487",
|
|
"text": " If <code>format</code> is a color format, <code>initialLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_STENCIL_READ_ONLY_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_STENCIL_ATTACHMENT_OPTIMAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription-format-06488",
|
|
"text": " If <code>format</code> is a color format, <code>finalLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_STENCIL_READ_ONLY_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_STENCIL_ATTACHMENT_OPTIMAL</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_separate_depth_stencil_layouts)": [
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription-separateDepthStencilLayouts-03284",
|
|
"text": " If the <a href=\"#features-separateDepthStencilLayouts\"><code>separateDepthStencilLayouts</code></a> feature is not enabled, <code>initialLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_STENCIL_ATTACHMENT_OPTIMAL</code>, or <code>VK_IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL</code>,"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription-separateDepthStencilLayouts-03285",
|
|
"text": " If the <a href=\"#features-separateDepthStencilLayouts\"><code>separateDepthStencilLayouts</code></a> feature is not enabled, <code>finalLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_STENCIL_ATTACHMENT_OPTIMAL</code>, or <code>VK_IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL</code>,"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription-format-03286",
|
|
"text": " If <code>format</code> is a color format, <code>initialLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_STENCIL_ATTACHMENT_OPTIMAL</code>, or <code>VK_IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription-format-03287",
|
|
"text": " If <code>format</code> is a color format, <code>finalLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_STENCIL_ATTACHMENT_OPTIMAL</code>, or <code>VK_IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription-format-06906",
|
|
"text": " If <code>format</code> is a depth/stencil format which includes both depth and stencil aspects, <code>initialLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_STENCIL_ATTACHMENT_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription-format-06907",
|
|
"text": " If <code>format</code> is a depth/stencil format which includes both depth and stencil aspects, <code>finalLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_STENCIL_ATTACHMENT_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription-format-03290",
|
|
"text": " If <code>format</code> is a depth/stencil format which includes only the depth aspect, <code>initialLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_STENCIL_ATTACHMENT_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription-format-03291",
|
|
"text": " If <code>format</code> is a depth/stencil format which includes only the depth aspect, <code>finalLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_STENCIL_ATTACHMENT_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL</code>"
|
|
}
|
|
],
|
|
"(VK_KHR_synchronization2)": [
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription-synchronization2-06908",
|
|
"text": " If the <a href=\"#features-synchronization2\"><code>synchronization2</code></a> feature is not enabled, <code>initialLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_ATTACHMENT_OPTIMAL_KHR</code> or <code>VK_IMAGE_LAYOUT_READ_ONLY_OPTIMAL_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription-synchronization2-06909",
|
|
"text": " If the <a href=\"#features-synchronization2\"><code>synchronization2</code></a> feature is not enabled, <code>finalLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_ATTACHMENT_OPTIMAL_KHR</code> or <code>VK_IMAGE_LAYOUT_READ_ONLY_OPTIMAL_KHR</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkRenderPassInputAttachmentAspectCreateInfo": {
|
|
"(VK_VERSION_1_1,VK_KHR_maintenance2)": [
|
|
{
|
|
"vuid": "VUID-VkRenderPassInputAttachmentAspectCreateInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_RENDER_PASS_INPUT_ATTACHMENT_ASPECT_CREATE_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassInputAttachmentAspectCreateInfo-pAspectReferences-parameter",
|
|
"text": " <code>pAspectReferences</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>aspectReferenceCount</code> valid <a href=\"#VkInputAttachmentAspectReference\">VkInputAttachmentAspectReference</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassInputAttachmentAspectCreateInfo-aspectReferenceCount-arraylength",
|
|
"text": " <code>aspectReferenceCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkInputAttachmentAspectReference": {
|
|
"(VK_VERSION_1_1,VK_KHR_maintenance2)": [
|
|
{
|
|
"vuid": "VUID-VkInputAttachmentAspectReference-aspectMask-01964",
|
|
"text": " <code>aspectMask</code> <strong class=\"purple\">must</strong> not include <code>VK_IMAGE_ASPECT_METADATA_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkInputAttachmentAspectReference-aspectMask-parameter",
|
|
"text": " <code>aspectMask</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkImageAspectFlagBits\">VkImageAspectFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkInputAttachmentAspectReference-aspectMask-requiredbitmask",
|
|
"text": " <code>aspectMask</code> <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_maintenance2)+(VK_EXT_image_drm_format_modifier)": [
|
|
{
|
|
"vuid": "VUID-VkInputAttachmentAspectReference-aspectMask-02250",
|
|
"text": " <code>aspectMask</code> <strong class=\"purple\">must</strong> not include <code>VK_IMAGE_ASPECT_MEMORY_PLANE<em>{ibit}</em>BIT_EXT</code> for any index <em>i</em>"
|
|
}
|
|
]
|
|
},
|
|
"VkSubpassDescription": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription-attachment-06912",
|
|
"text": " If the <code>attachment</code> member of an element of <code>pInputAttachments</code> is not <code>VK_ATTACHMENT_UNUSED</code>, its <code>layout</code> member <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_COLOR_ATTACHMENT_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_ATTACHMENT_OPTIMAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription-attachment-06913",
|
|
"text": " If the <code>attachment</code> member of an element of <code>pColorAttachments</code> is not <code>VK_ATTACHMENT_UNUSED</code>, its <code>layout</code> member <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_ATTACHMENT_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_SHADER_READ_ONLY_OPTIMAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription-attachment-06914",
|
|
"text": " If the <code>attachment</code> member of an element of <code>pResolveAttachments</code> is not <code>VK_ATTACHMENT_UNUSED</code>, its <code>layout</code> member <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_ATTACHMENT_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_SHADER_READ_ONLY_OPTIMAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription-attachment-06915",
|
|
"text": " If the <code>attachment</code> member of <code>pDepthStencilAttachment</code> is not <code>VK_ATTACHMENT_UNUSED</code>, ts <code>layout</code> member <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_COLOR_ATTACHMENT_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_SHADER_READ_ONLY_OPTIMAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription-colorAttachmentCount-00845",
|
|
"text": " <code>colorAttachmentCount</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxColorAttachments</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription-loadOp-00846",
|
|
"text": " If the first use of an attachment in this render pass is as an input attachment, and the attachment is not also used as a color or depth/stencil attachment in the same subpass, then <code>loadOp</code> <strong class=\"purple\">must</strong> not be <code>VK_ATTACHMENT_LOAD_OP_CLEAR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription-pResolveAttachments-00847",
|
|
"text": " If <code>pResolveAttachments</code> is not <code>NULL</code>, for each resolve attachment that is not <code>VK_ATTACHMENT_UNUSED</code>, the corresponding color attachment <strong class=\"purple\">must</strong> not be <code>VK_ATTACHMENT_UNUSED</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription-pResolveAttachments-00848",
|
|
"text": " If <code>pResolveAttachments</code> is not <code>NULL</code>, for each resolve attachment that is not <code>VK_ATTACHMENT_UNUSED</code>, the corresponding color attachment <strong class=\"purple\">must</strong> not have a sample count of <code>VK_SAMPLE_COUNT_1_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription-pResolveAttachments-00849",
|
|
"text": " If <code>pResolveAttachments</code> is not <code>NULL</code>, each resolve attachment that is not <code>VK_ATTACHMENT_UNUSED</code> <strong class=\"purple\">must</strong> have a sample count of <code>VK_SAMPLE_COUNT_1_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription-pResolveAttachments-00850",
|
|
"text": " If <code>pResolveAttachments</code> is not <code>NULL</code>, each resolve attachment that is not <code>VK_ATTACHMENT_UNUSED</code> <strong class=\"purple\">must</strong> have the same <a href=\"#VkFormat\">VkFormat</a> as its corresponding color attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription-pColorAttachments-06868",
|
|
"text": " If neither the <code><a href=\"#VK_AMD_mixed_attachment_samples\">VK_AMD_mixed_attachment_samples</a></code> extension nor the <code><a href=\"#VK_NV_framebuffer_mixed_samples\">VK_NV_framebuffer_mixed_samples</a></code> extension is enabled, all attachments in <code>pColorAttachments</code> that are not <code>VK_ATTACHMENT_UNUSED</code> <strong class=\"purple\">must</strong> have the same sample count"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription-pInputAttachments-02647",
|
|
"text": " All attachments in <code>pInputAttachments</code> that are not <code>VK_ATTACHMENT_UNUSED</code> <strong class=\"purple\">must</strong> have image formats whose <a href=\"#potential-format-features\">potential format features</a> contain at least <code>VK_FORMAT_FEATURE_COLOR_ATTACHMENT_BIT</code> or <code>VK_FORMAT_FEATURE_DEPTH_STENCIL_ATTACHMENT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription-pColorAttachments-02648",
|
|
"text": " All attachments in <code>pColorAttachments</code> that are not <code>VK_ATTACHMENT_UNUSED</code> <strong class=\"purple\">must</strong> have image formats whose <a href=\"#potential-format-features\">potential format features</a> contain <code>VK_FORMAT_FEATURE_COLOR_ATTACHMENT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription-pResolveAttachments-02649",
|
|
"text": " All attachments in <code>pResolveAttachments</code> that are not <code>VK_ATTACHMENT_UNUSED</code> <strong class=\"purple\">must</strong> have image formats whose <a href=\"#potential-format-features\">potential format features</a> contain <code>VK_FORMAT_FEATURE_COLOR_ATTACHMENT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription-pDepthStencilAttachment-02650",
|
|
"text": " If <code>pDepthStencilAttachment</code> is not <code>NULL</code> and the attachment is not <code>VK_ATTACHMENT_UNUSED</code> then it <strong class=\"purple\">must</strong> have an image format whose <a href=\"#potential-format-features\">potential format features</a> contain <code>VK_FORMAT_FEATURE_DEPTH_STENCIL_ATTACHMENT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription-pDepthStencilAttachment-01418",
|
|
"text": " If neither the <code><a href=\"#VK_AMD_mixed_attachment_samples\">VK_AMD_mixed_attachment_samples</a></code> nor the <code><a href=\"#VK_NV_framebuffer_mixed_samples\">VK_NV_framebuffer_mixed_samples</a></code> extensions are enabled, and if <code>pDepthStencilAttachment</code> is not <code>VK_ATTACHMENT_UNUSED</code> and any attachments in <code>pColorAttachments</code> are not <code>VK_ATTACHMENT_UNUSED</code>, they <strong class=\"purple\">must</strong> have the same sample count"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription-attachment-00853",
|
|
"text": " Each element of <code>pPreserveAttachments</code> <strong class=\"purple\">must</strong> not be <code>VK_ATTACHMENT_UNUSED</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription-pPreserveAttachments-00854",
|
|
"text": " Each element of <code>pPreserveAttachments</code> <strong class=\"purple\">must</strong> not also be an element of any other member of the subpass description"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription-layout-02519",
|
|
"text": " If any attachment is used by more than one <a href=\"#VkAttachmentReference\">VkAttachmentReference</a> member, then each use <strong class=\"purple\">must</strong> use the same <code>layout</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription-pDepthStencilAttachment-04438",
|
|
"text": " <code>pDepthStencilAttachment</code> and <code>pColorAttachments</code> must not contain references to the same attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkSubpassDescriptionFlagBits\">VkSubpassDescriptionFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription-pipelineBindPoint-parameter",
|
|
"text": " <code>pipelineBindPoint</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPipelineBindPoint\">VkPipelineBindPoint</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription-pInputAttachments-parameter",
|
|
"text": " If <code>inputAttachmentCount</code> is not <code>0</code>, <code>pInputAttachments</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>inputAttachmentCount</code> valid <a href=\"#VkAttachmentReference\">VkAttachmentReference</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription-pColorAttachments-parameter",
|
|
"text": " If <code>colorAttachmentCount</code> is not <code>0</code>, <code>pColorAttachments</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>colorAttachmentCount</code> valid <a href=\"#VkAttachmentReference\">VkAttachmentReference</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription-pResolveAttachments-parameter",
|
|
"text": " If <code>colorAttachmentCount</code> is not <code>0</code>, and <code>pResolveAttachments</code> is not <code>NULL</code>, <code>pResolveAttachments</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>colorAttachmentCount</code> valid <a href=\"#VkAttachmentReference\">VkAttachmentReference</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription-pDepthStencilAttachment-parameter",
|
|
"text": " If <code>pDepthStencilAttachment</code> is not <code>NULL</code>, <code>pDepthStencilAttachment</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAttachmentReference\">VkAttachmentReference</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription-pPreserveAttachments-parameter",
|
|
"text": " If <code>preserveAttachmentCount</code> is not <code>0</code>, <code>pPreserveAttachments</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>preserveAttachmentCount</code> <code>uint32_t</code> values"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_maintenance2)": [
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription-attachment-06916",
|
|
"text": " If the <code>attachment</code> member of an element of <code>pColorAttachments</code> is not <code>VK_ATTACHMENT_UNUSED</code>, its <code>layout</code> member <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_STENCIL_READ_ONLY_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_STENCIL_ATTACHMENT_OPTIMAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription-attachment-06917",
|
|
"text": " If the <code>attachment</code> member of an element of <code>pResolveAttachments</code> is not <code>VK_ATTACHMENT_UNUSED</code>, its <code>layout</code> member <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_STENCIL_READ_ONLY_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_STENCIL_ATTACHMENT_OPTIMAL</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_separate_depth_stencil_layouts)": [
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription-attachment-06918",
|
|
"text": " If the <code>attachment</code> member of an element of <code>pInputAttachments</code> is not <code>VK_ATTACHMENT_UNUSED</code>, its <code>layout</code> member <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_STENCIL_ATTACHMENT_OPTIMAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription-attachment-06919",
|
|
"text": " If the <code>attachment</code> member of an element of <code>pColorAttachments</code> is not <code>VK_ATTACHMENT_UNUSED</code>, its <code>layout</code> member <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_STENCIL_ATTACHMENT_OPTIMAL</code>, or <code>VK_IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription-attachment-06920",
|
|
"text": " If the <code>attachment</code> member of an element of <code>pResolveAttachments</code> is not <code>VK_ATTACHMENT_UNUSED</code>, its <code>layout</code> member <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_STENCIL_ATTACHMENT_OPTIMAL</code>, or <code>VK_IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL</code>"
|
|
}
|
|
],
|
|
"(VK_KHR_synchronization2)": [
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription-attachment-06921",
|
|
"text": " If the <code>attachment</code> member of an element of <code>pInputAttachments</code> is not <code>VK_ATTACHMENT_UNUSED</code>, its <code>layout</code> member <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_ATTACHMENT_OPTIMAL_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription-attachment-06922",
|
|
"text": " If the <code>attachment</code> member of an element of <code>pColorAttachments</code> is not <code>VK_ATTACHMENT_UNUSED</code>, its <code>layout</code> member <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_READ_ONLY_OPTIMAL_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription-attachment-06923",
|
|
"text": " If the <code>attachment</code> member of an element of <code>pResolveAttachments</code> is not <code>VK_ATTACHMENT_UNUSED</code>, its <code>layout</code> member <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_READ_ONLY_OPTIMAL_KHR</code>"
|
|
}
|
|
],
|
|
"!(VK_HUAWEI_subpass_shading)": [
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription-pipelineBindPoint-00844",
|
|
"text": " <code>pipelineBindPoint</code> <strong class=\"purple\">must</strong> be <code>VK_PIPELINE_BIND_POINT_GRAPHICS</code>"
|
|
}
|
|
],
|
|
"(VK_HUAWEI_subpass_shading)": [
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription-pipelineBindPoint-04952",
|
|
"text": " <code>pipelineBindPoint</code> <strong class=\"purple\">must</strong> be <code>VK_PIPELINE_BIND_POINT_GRAPHICS</code> or <code>VK_PIPELINE_BIND_POINT_SUBPASS_SHADING_HUAWEI</code>"
|
|
}
|
|
],
|
|
"(VK_NV_linear_color_attachment)": [
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription-linearColorAttachment-06496",
|
|
"text": " If the <a href=\"#features-linearColorAttachment\"><code>linearColorAttachment</code></a> feature is enabled and the image is created with <code>VK_IMAGE_TILING_LINEAR</code>, all attachments in <code>pInputAttachments</code> that are not <code>VK_ATTACHMENT_UNUSED</code> <strong class=\"purple\">must</strong> have image formats whose <a href=\"#potential-format-features\">potential format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_LINEAR_COLOR_ATTACHMENT_BIT_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription-linearColorAttachment-06497",
|
|
"text": " If the <a href=\"#features-linearColorAttachment\"><code>linearColorAttachment</code></a> feature is enabled and the image is created with <code>VK_IMAGE_TILING_LINEAR</code>, all attachments in <code>pColorAttachments</code> that are not <code>VK_ATTACHMENT_UNUSED</code> <strong class=\"purple\">must</strong> have image formats whose <a href=\"#potential-format-features\">potential format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_LINEAR_COLOR_ATTACHMENT_BIT_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription-linearColorAttachment-06498",
|
|
"text": " If the <a href=\"#features-linearColorAttachment\"><code>linearColorAttachment</code></a> feature is enabled and the image is created with <code>VK_IMAGE_TILING_LINEAR</code>, all attachments in <code>pResolveAttachments</code> that are not <code>VK_ATTACHMENT_UNUSED</code> <strong class=\"purple\">must</strong> have image formats whose <a href=\"#potential-format-features\">potential format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_LINEAR_COLOR_ATTACHMENT_BIT_NV</code>"
|
|
}
|
|
],
|
|
"(VK_AMD_mixed_attachment_samples)": [
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription-pColorAttachments-01506",
|
|
"text": " If the <code><a href=\"#VK_AMD_mixed_attachment_samples\">VK_AMD_mixed_attachment_samples</a></code> extension is enabled, all attachments in <code>pColorAttachments</code> that are not <code>VK_ATTACHMENT_UNUSED</code> <strong class=\"purple\">must</strong> have a sample count that is smaller than or equal to the sample count of <code>pDepthStencilAttachment</code> if it is not <code>VK_ATTACHMENT_UNUSED</code>"
|
|
}
|
|
],
|
|
"(VK_NVX_multiview_per_view_attributes)": [
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription-flags-00856",
|
|
"text": " If <code>flags</code> includes <code>VK_SUBPASS_DESCRIPTION_PER_VIEW_POSITION_X_ONLY_BIT_NVX</code>, it <strong class=\"purple\">must</strong> also include <code>VK_SUBPASS_DESCRIPTION_PER_VIEW_ATTRIBUTES_BIT_NVX</code>"
|
|
}
|
|
],
|
|
"(VK_QCOM_render_pass_shader_resolve)": [
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription-flags-03341",
|
|
"text": " If <code>flags</code> includes <code>VK_SUBPASS_DESCRIPTION_SHADER_RESOLVE_BIT_QCOM</code>, and if <code>pResolveAttachments</code> is not <code>NULL</code>, then each resolve attachment <strong class=\"purple\">must</strong> be <code>VK_ATTACHMENT_UNUSED</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription-flags-03343",
|
|
"text": " If <code>flags</code> includes <code>VK_SUBPASS_DESCRIPTION_SHADER_RESOLVE_BIT_QCOM</code>, then the subpass <strong class=\"purple\">must</strong> be the last subpass in a subpass dependency chain"
|
|
}
|
|
],
|
|
"(VK_QCOM_render_pass_transform)": [
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription-pInputAttachments-02868",
|
|
"text": " If the render pass is created with <code>VK_RENDER_PASS_CREATE_TRANSFORM_BIT_QCOM</code> each of the elements of <code>pInputAttachments</code> <strong class=\"purple\">must</strong> be <code>VK_ATTACHMENT_UNUSED</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkAttachmentReference": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkAttachmentReference-layout-03077",
|
|
"text": " If <code>attachment</code> is not <code>VK_ATTACHMENT_UNUSED</code>, <code>layout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_UNDEFINED</code>, <code>VK_IMAGE_LAYOUT_PREINITIALIZED</code>, or <code>VK_IMAGE_LAYOUT_PRESENT_SRC_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentReference-layout-parameter",
|
|
"text": " <code>layout</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageLayout\">VkImageLayout</a> value"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_separate_depth_stencil_layouts)": [
|
|
{
|
|
"vuid": "VUID-VkAttachmentReference-separateDepthStencilLayouts-03313",
|
|
"text": " If the <a href=\"#features-separateDepthStencilLayouts\"><code>separateDepthStencilLayouts</code></a> feature is not enabled, and <code>attachment</code> is not <code>VK_ATTACHMENT_UNUSED</code>, <code>layout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_STENCIL_ATTACHMENT_OPTIMAL</code>, or <code>VK_IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL</code>,"
|
|
}
|
|
],
|
|
"(VK_KHR_synchronization2)": [
|
|
{
|
|
"vuid": "VUID-VkAttachmentReference-synchronization2-06910",
|
|
"text": " If the <a href=\"#features-synchronization2\"><code>synchronization2</code></a> feature is not enabled, <code>layout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_ATTACHMENT_OPTIMAL_KHR</code> or <code>VK_IMAGE_LAYOUT_READ_ONLY_OPTIMAL_KHR</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkSubpassDependency": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency-srcStageMask-04090",
|
|
"text": " If the <a href=\"#features-geometryShader\"><code>geometryShader</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_GEOMETRY_SHADER_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency-srcStageMask-04091",
|
|
"text": " If the <a href=\"#features-tessellationShader\"><code>tessellationShader</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_TESSELLATION_CONTROL_SHADER_BIT</code> or <code>VK_PIPELINE_STAGE_TESSELLATION_EVALUATION_SHADER_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency-dstStageMask-04090",
|
|
"text": " If the <a href=\"#features-geometryShader\"><code>geometryShader</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_GEOMETRY_SHADER_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency-dstStageMask-04091",
|
|
"text": " If the <a href=\"#features-tessellationShader\"><code>tessellationShader</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_TESSELLATION_CONTROL_SHADER_BIT</code> or <code>VK_PIPELINE_STAGE_TESSELLATION_EVALUATION_SHADER_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency-srcSubpass-00864",
|
|
"text": " <code>srcSubpass</code> <strong class=\"purple\">must</strong> be less than or equal to <code>dstSubpass</code>, unless one of them is <code>VK_SUBPASS_EXTERNAL</code>, to avoid cyclic dependencies and ensure a valid execution order"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency-srcSubpass-00865",
|
|
"text": " <code>srcSubpass</code> and <code>dstSubpass</code> <strong class=\"purple\">must</strong> not both be equal to <code>VK_SUBPASS_EXTERNAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency-srcSubpass-06809",
|
|
"text": " If <code>srcSubpass</code> is equal to <code>dstSubpass</code> and <code>srcStageMask</code> includes a <a href=\"#synchronization-framebuffer-regions\">framebuffer-space stage</a>, <code>dstStageMask</code> <strong class=\"purple\">must</strong> only contain <a href=\"#synchronization-framebuffer-regions\">framebuffer-space stages</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency-srcAccessMask-00868",
|
|
"text": " Any access flag included in <code>srcAccessMask</code> <strong class=\"purple\">must</strong> be supported by one of the pipeline stages in <code>srcStageMask</code>, as specified in the <a href=\"#synchronization-access-types-supported\">table of supported access types</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency-dstAccessMask-00869",
|
|
"text": " Any access flag included in <code>dstAccessMask</code> <strong class=\"purple\">must</strong> be supported by one of the pipeline stages in <code>dstStageMask</code>, as specified in the <a href=\"#synchronization-access-types-supported\">table of supported access types</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency-srcSubpass-02243",
|
|
"text": " If <code>srcSubpass</code> equals <code>dstSubpass</code>, and <code>srcStageMask</code> and <code>dstStageMask</code> both include a <a href=\"#synchronization-framebuffer-regions\">framebuffer-space stage</a>, then <code>dependencyFlags</code> <strong class=\"purple\">must</strong> include <code>VK_DEPENDENCY_BY_REGION_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency-srcStageMask-parameter",
|
|
"text": " <code>srcStageMask</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkPipelineStageFlagBits\">VkPipelineStageFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency-dstStageMask-parameter",
|
|
"text": " <code>dstStageMask</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkPipelineStageFlagBits\">VkPipelineStageFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency-srcAccessMask-parameter",
|
|
"text": " <code>srcAccessMask</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkAccessFlagBits\">VkAccessFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency-dstAccessMask-parameter",
|
|
"text": " <code>dstAccessMask</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkAccessFlagBits\">VkAccessFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency-dependencyFlags-parameter",
|
|
"text": " <code>dependencyFlags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkDependencyFlagBits\">VkDependencyFlagBits</a> values"
|
|
}
|
|
],
|
|
"(VK_EXT_conditional_rendering)": [
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency-srcStageMask-04092",
|
|
"text": " If the <a href=\"#features-conditionalRendering\"><code>conditionalRendering</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_CONDITIONAL_RENDERING_BIT_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency-dstStageMask-04092",
|
|
"text": " If the <a href=\"#features-conditionalRendering\"><code>conditionalRendering</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_CONDITIONAL_RENDERING_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_fragment_density_map)": [
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency-srcStageMask-04093",
|
|
"text": " If the <a href=\"#features-fragmentDensityMap\"><code>fragmentDensityMap</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_FRAGMENT_DENSITY_PROCESS_BIT_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency-dstStageMask-04093",
|
|
"text": " If the <a href=\"#features-fragmentDensityMap\"><code>fragmentDensityMap</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_FRAGMENT_DENSITY_PROCESS_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)": [
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency-srcStageMask-04094",
|
|
"text": " If the <a href=\"#features-transformFeedback\"><code>transformFeedback</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_TRANSFORM_FEEDBACK_BIT_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency-dstStageMask-04094",
|
|
"text": " If the <a href=\"#features-transformFeedback\"><code>transformFeedback</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_TRANSFORM_FEEDBACK_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)": [
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency-srcStageMask-04095",
|
|
"text": " If the <a href=\"#features-meshShader\"><code>meshShader</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_MESH_SHADER_BIT_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency-srcStageMask-04096",
|
|
"text": " If the <a href=\"#features-taskShader\"><code>taskShader</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_TASK_SHADER_BIT_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency-dstStageMask-04095",
|
|
"text": " If the <a href=\"#features-meshShader\"><code>meshShader</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_MESH_SHADER_BIT_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency-dstStageMask-04096",
|
|
"text": " If the <a href=\"#features-taskShader\"><code>taskShader</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_TASK_SHADER_BIT_NV</code>"
|
|
}
|
|
],
|
|
"(VK_NV_shading_rate_image)": [
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency-srcStageMask-04097",
|
|
"text": " If the <a href=\"#features-shadingRateImage\"><code>shadingRateImage</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_SHADING_RATE_IMAGE_BIT_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency-dstStageMask-04097",
|
|
"text": " If the <a href=\"#features-shadingRateImage\"><code>shadingRateImage</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_SHADING_RATE_IMAGE_BIT_NV</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)": [
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency-srcStageMask-03937",
|
|
"text": " If the <a href=\"#features-synchronization2\"><code>synchronization2</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency-dstStageMask-03937",
|
|
"text": " If the <a href=\"#features-synchronization2\"><code>synchronization2</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
}
|
|
],
|
|
"!(VK_VERSION_1_3,VK_KHR_synchronization2)": [
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency-srcStageMask-04996",
|
|
"text": " pname:srcStageMask <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency-dstStageMask-04996",
|
|
"text": " pname:dstStageMask <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_multiview)": [
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency-dependencyFlags-02520",
|
|
"text": " If <code>dependencyFlags</code> includes <code>VK_DEPENDENCY_VIEW_LOCAL_BIT</code>, <code>srcSubpass</code> <strong class=\"purple\">must</strong> not be equal to <code>VK_SUBPASS_EXTERNAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency-dependencyFlags-02521",
|
|
"text": " If <code>dependencyFlags</code> includes <code>VK_DEPENDENCY_VIEW_LOCAL_BIT</code>, <code>dstSubpass</code> <strong class=\"purple\">must</strong> not be equal to <code>VK_SUBPASS_EXTERNAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency-srcSubpass-00872",
|
|
"text": " If <code>srcSubpass</code> equals <code>dstSubpass</code> and that subpass has more than one bit set in the view mask, then <code>dependencyFlags</code> <strong class=\"purple\">must</strong> include <code>VK_DEPENDENCY_VIEW_LOCAL_BIT</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCreateRenderPass2": {
|
|
"(VK_VERSION_1_2,VK_KHR_create_renderpass2)": [
|
|
{
|
|
"vuid": "VUID-vkCreateRenderPass2-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateRenderPass2-pCreateInfo-parameter",
|
|
"text": " <code>pCreateInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkRenderPassCreateInfo2\">VkRenderPassCreateInfo2</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateRenderPass2-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateRenderPass2-pRenderPass-parameter",
|
|
"text": " <code>pRenderPass</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkRenderPass\">VkRenderPass</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkRenderPassCreateInfo2": {
|
|
"(VK_VERSION_1_2,VK_KHR_create_renderpass2)": [
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo2-None-03049",
|
|
"text": " If any two subpasses operate on attachments with overlapping ranges of the same <code>VkDeviceMemory</code> object, and at least one subpass writes to that area of <code>VkDeviceMemory</code>, a subpass dependency <strong class=\"purple\">must</strong> be included (either directly or via some intermediate subpasses) between them"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo2-attachment-03050",
|
|
"text": " If the <code>attachment</code> member of any element of <code>pInputAttachments</code>, <code>pColorAttachments</code>, <code>pResolveAttachments</code> or <code>pDepthStencilAttachment</code>, or the attachment indexed by any element of <code>pPreserveAttachments</code> in any given element of <code>pSubpasses</code> is bound to a range of a <code>VkDeviceMemory</code> object that overlaps with any other attachment in any subpass (including the same subpass), the <code>VkAttachmentDescription2</code> structures describing them <strong class=\"purple\">must</strong> include <code>VK_ATTACHMENT_DESCRIPTION_MAY_ALIAS_BIT</code> in <code>flags</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo2-attachment-03051",
|
|
"text": " If the <code>attachment</code> member of any element of <code>pInputAttachments</code>, <code>pColorAttachments</code>, <code>pResolveAttachments</code> or <code>pDepthStencilAttachment</code>, or any element of <code>pPreserveAttachments</code> in any given element of <code>pSubpasses</code> is not <code>VK_ATTACHMENT_UNUSED</code>, then it <strong class=\"purple\">must</strong> be less than <code>attachmentCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo2-pAttachments-02522",
|
|
"text": " For any member of <code>pAttachments</code> with a <code>loadOp</code> equal to <code>VK_ATTACHMENT_LOAD_OP_CLEAR</code>, the first use of that attachment <strong class=\"purple\">must</strong> not specify a <code>layout</code> equal to <code>VK_IMAGE_LAYOUT_SHADER_READ_ONLY_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL</code>, or <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_STENCIL_ATTACHMENT_OPTIMAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo2-pAttachments-02523",
|
|
"text": " For any member of <code>pAttachments</code> with a <code>stencilLoadOp</code> equal to <code>VK_ATTACHMENT_LOAD_OP_CLEAR</code>, the first use of that attachment <strong class=\"purple\">must</strong> not specify a <code>layout</code> equal to <code>VK_IMAGE_LAYOUT_SHADER_READ_ONLY_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL</code>, or <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_STENCIL_READ_ONLY_OPTIMAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo2-pDependencies-03054",
|
|
"text": " For any element of <code>pDependencies</code>, if the <code>srcSubpass</code> is not <code>VK_SUBPASS_EXTERNAL</code>, all stage flags included in the <code>srcStageMask</code> member of that dependency <strong class=\"purple\">must</strong> be a pipeline stage supported by the <a href=\"#synchronization-pipeline-stages-types\">pipeline</a> identified by the <code>pipelineBindPoint</code> member of the source subpass"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo2-pDependencies-03055",
|
|
"text": " For any element of <code>pDependencies</code>, if the <code>dstSubpass</code> is not <code>VK_SUBPASS_EXTERNAL</code>, all stage flags included in the <code>dstStageMask</code> member of that dependency <strong class=\"purple\">must</strong> be a pipeline stage supported by the <a href=\"#synchronization-pipeline-stages-types\">pipeline</a> identified by the <code>pipelineBindPoint</code> member of the destination subpass"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo2-pCorrelatedViewMasks-03056",
|
|
"text": " The set of bits included in any element of <code>pCorrelatedViewMasks</code> <strong class=\"purple\">must</strong> not overlap with the set of bits included in any other element of <code>pCorrelatedViewMasks</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo2-viewMask-03057",
|
|
"text": " If the <a href=\"#VkSubpassDescription2\">VkSubpassDescription2</a>::<code>viewMask</code> member of all elements of <code>pSubpasses</code> is <code>0</code>, <code>correlatedViewMaskCount</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo2-viewMask-03058",
|
|
"text": " The <a href=\"#VkSubpassDescription2\">VkSubpassDescription2</a>::<code>viewMask</code> member of all elements of <code>pSubpasses</code> <strong class=\"purple\">must</strong> either all be <code>0</code>, or all not be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo2-viewMask-03059",
|
|
"text": " If the <a href=\"#VkSubpassDescription2\">VkSubpassDescription2</a>::<code>viewMask</code> member of all elements of <code>pSubpasses</code> is <code>0</code>, the <code>dependencyFlags</code> member of any element of <code>pDependencies</code> <strong class=\"purple\">must</strong> not include <code>VK_DEPENDENCY_VIEW_LOCAL_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo2-pDependencies-03060",
|
|
"text": " For any element of <code>pDependencies</code> where its <code>srcSubpass</code> member equals its <code>dstSubpass</code> member, if the <code>viewMask</code> member of the corresponding element of <code>pSubpasses</code> includes more than one bit, its <code>dependencyFlags</code> member <strong class=\"purple\">must</strong> include <code>VK_DEPENDENCY_VIEW_LOCAL_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo2-attachment-02525",
|
|
"text": " If the <code>attachment</code> member of any element of the <code>pInputAttachments</code> member of any element of <code>pSubpasses</code> is not <code>VK_ATTACHMENT_UNUSED</code>, the <code>aspectMask</code> member of that element of <code>pInputAttachments</code> <strong class=\"purple\">must</strong> only include aspects that are present in images of the format specified by the element of <code>pAttachments</code> specified by <code>attachment</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo2-srcSubpass-02526",
|
|
"text": " The <code>srcSubpass</code> member of each element of <code>pDependencies</code> <strong class=\"purple\">must</strong> be less than <code>subpassCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo2-dstSubpass-02527",
|
|
"text": " The <code>dstSubpass</code> member of each element of <code>pDependencies</code> <strong class=\"purple\">must</strong> be less than <code>subpassCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo2-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_RENDER_PASS_CREATE_INFO_2</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo2-pNext-pNext",
|
|
"text": " Each <code>pNext</code> member of any structure (including this one) in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be either <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkRenderPassCreationControlEXT\">VkRenderPassCreationControlEXT</a>, <a href=\"#VkRenderPassCreationFeedbackCreateInfoEXT\">VkRenderPassCreationFeedbackCreateInfoEXT</a>, or <a href=\"#VkRenderPassFragmentDensityMapCreateInfoEXT\">VkRenderPassFragmentDensityMapCreateInfoEXT</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo2-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo2-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkRenderPassCreateFlagBits\">VkRenderPassCreateFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo2-pAttachments-parameter",
|
|
"text": " If <code>attachmentCount</code> is not <code>0</code>, <code>pAttachments</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>attachmentCount</code> valid <a href=\"#VkAttachmentDescription2\">VkAttachmentDescription2</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo2-pSubpasses-parameter",
|
|
"text": " <code>pSubpasses</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>subpassCount</code> valid <a href=\"#VkSubpassDescription2\">VkSubpassDescription2</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo2-pDependencies-parameter",
|
|
"text": " If <code>dependencyCount</code> is not <code>0</code>, <code>pDependencies</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>dependencyCount</code> valid <a href=\"#VkSubpassDependency2\">VkSubpassDependency2</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo2-pCorrelatedViewMasks-parameter",
|
|
"text": " If <code>correlatedViewMaskCount</code> is not <code>0</code>, <code>pCorrelatedViewMasks</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>correlatedViewMaskCount</code> <code>uint32_t</code> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo2-subpassCount-arraylength",
|
|
"text": " <code>subpassCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_create_renderpass2)+(VK_EXT_fragment_density_map)": [
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo2-fragmentDensityMapAttachment-06472",
|
|
"text": " If the pNext chain includes a <a href=\"#VkRenderPassFragmentDensityMapCreateInfoEXT\">VkRenderPassFragmentDensityMapCreateInfoEXT</a> structure and the <code>fragmentDensityMapAttachment</code> member is not <code>VK_ATTACHMENT_UNUSED</code>, then <code>attachment</code> <strong class=\"purple\">must</strong> be less than <code>attachmentCount</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_create_renderpass2)+(VK_VERSION_1_2,VK_KHR_depth_stencil_resolve)": [
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo2-pSubpasses-06473",
|
|
"text": " If the <code>pSubpasses</code> pNext chain includes a <a href=\"#VkSubpassDescriptionDepthStencilResolve\">VkSubpassDescriptionDepthStencilResolve</a> structure and the <code>pDepthStencilResolveAttachment</code> member is not <code>NULL</code> and does not have the value <code>VK_ATTACHMENT_UNUSED</code>, then <code>attachment</code> <strong class=\"purple\">must</strong> be less than <code>attachmentCount</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_create_renderpass2)+(VK_KHR_fragment_shading_rate)": [
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo2-pAttachments-04585",
|
|
"text": " If any element of <code>pAttachments</code> is used as a fragment shading rate attachment in any subpass, it <strong class=\"purple\">must</strong> not be used as any other attachment in the render pass"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo2-pAttachments-04586",
|
|
"text": " If any element of <code>pAttachments</code> is used as a fragment shading rate attachment in any subpass, it <strong class=\"purple\">must</strong> have an image format whose <a href=\"#potential-format-features\">potential format features</a> contain <code>VK_FORMAT_FEATURE_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_create_renderpass2)+(VK_KHR_fragment_shading_rate)+(VK_QCOM_render_pass_transform)": [
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo2-flags-04521",
|
|
"text": " If <code>flags</code> includes <code>VK_RENDER_PASS_CREATE_TRANSFORM_BIT_QCOM</code>, an element of <code>pSubpasses</code> includes an instance of <a href=\"#VkFragmentShadingRateAttachmentInfoKHR\">VkFragmentShadingRateAttachmentInfoKHR</a> in its <code>pNext</code> chain, and the <code>pFragmentShadingRateAttachment</code> member of that structure is not equal to <code>NULL</code>, the <code>attachment</code> member of <code>pFragmentShadingRateAttachment</code> <strong class=\"purple\">must</strong> be <code>VK_ATTACHMENT_UNUSED</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_create_renderpass2)+(VK_QCOM_render_pass_shader_resolve)": [
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo2-rasterizationSamples-04905",
|
|
"text": " If the pipeline is being created with fragment shader state, and the <code><a href=\"#VK_QCOM_render_pass_shader_resolve\">VK_QCOM_render_pass_shader_resolve</a> extension</code> is enabled, and if subpass has any input attachments, and if the subpass description contains <code>VK_SUBPASS_DESCRIPTION_FRAGMENT_REGION_BIT_QCOM</code>, then the sample count of the input attachments <strong class=\"purple\">must</strong> equal <code>rasterizationSamples</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo2-sampleShadingEnable-04906",
|
|
"text": " If the pipeline is being created with fragment shader state, and the <code><a href=\"#VK_QCOM_render_pass_shader_resolve\">VK_QCOM_render_pass_shader_resolve</a></code> extension is enabled, and if the subpass description contains <code>VK_SUBPASS_DESCRIPTION_FRAGMENT_REGION_BIT_QCOM</code>, then <code>sampleShadingEnable</code> <strong class=\"purple\">must</strong> be false"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo2-flags-04907",
|
|
"text": " If <code>flags</code> includes <code>VK_SUBPASS_DESCRIPTION_SHADER_RESOLVE_BIT_QCOM</code>, and if <code>pResolveAttachments</code> is not <code>NULL</code>, then each resolve attachment <strong class=\"purple\">must</strong> be <code>VK_ATTACHMENT_UNUSED</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo2-flags-04908",
|
|
"text": " If <code>flags</code> includes <code>VK_SUBPASS_DESCRIPTION_SHADER_RESOLVE_BIT_QCOM</code>, and if <code>pDepthStencilResolveAttachment</code> is not <code>NULL</code>, then the depth/stencil resolve attachment <strong class=\"purple\">must</strong> be <code>VK_ATTACHMENT_UNUSED</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo2-flags-04909",
|
|
"text": " If <code>flags</code> includes <code>VK_SUBPASS_DESCRIPTION_SHADER_RESOLVE_BIT_QCOM</code>, then the subpass <strong class=\"purple\">must</strong> be the last subpass in a subpass dependency chain"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_create_renderpass2)+(VK_VERSION_1_2,VK_KHR_separate_depth_stencil_layouts)": [
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo2-attachment-06244",
|
|
"text": " If the <code>attachment</code> member of the <code>pDepthStencilAttachment</code> member of an element of <code>pSubpasses</code> is not <code>VK_ATTACHMENT_UNUSED</code>, the <code>layout</code> member of that same structure is either <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL</code>, and the <code>pNext</code> chain of that structure does not include a <a href=\"#VkAttachmentReferenceStencilLayout\">VkAttachmentReferenceStencilLayout</a> structure, then the element of <code>pAttachments</code> with an index equal to <code>attachment</code> <strong class=\"purple\">must</strong> not have a <code>format</code> that includes both depth and stencil aspects"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo2-attachment-06245",
|
|
"text": " If the <code>attachment</code> member of the <code>pDepthStencilAttachment</code> member of an element of <code>pSubpasses</code> is not <code>VK_ATTACHMENT_UNUSED</code> and the <code>layout</code> member of that same structure is either <code>VK_IMAGE_LAYOUT_STENCIL_ATTACHMENT_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL</code>, then the element of <code>pAttachments</code> with an index equal to <code>attachment</code> <strong class=\"purple\">must</strong> have a <code>format</code> that includes only a stencil aspect"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreateInfo2-attachment-06246",
|
|
"text": " If the <code>attachment</code> member of the <code>pDepthStencilAttachment</code> member of an element of <code>pSubpasses</code> is not <code>VK_ATTACHMENT_UNUSED</code> and the <code>layout</code> member of that same structure is either <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL</code>, then the element of <code>pAttachments</code> with an index equal to <code>attachment</code> <strong class=\"purple\">must</strong> not have a <code>format</code> that includes only a stencil aspect"
|
|
}
|
|
]
|
|
},
|
|
"VkAttachmentDescription2": {
|
|
"(VK_VERSION_1_2,VK_KHR_create_renderpass2)": [
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription2-format-06698",
|
|
"text": " <code>format</code> <strong class=\"purple\">must</strong> not be VK_FORMAT_UNDEFINED"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription2-format-06699",
|
|
"text": " If <code>format</code> includes a color or depth aspect and <code>loadOp</code> is <code>VK_ATTACHMENT_LOAD_OP_LOAD</code>, then <code>initialLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_UNDEFINED</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription2-finalLayout-00843",
|
|
"text": " <code>finalLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_UNDEFINED</code> or <code>VK_IMAGE_LAYOUT_PREINITIALIZED</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription2-format-03280",
|
|
"text": " If <code>format</code> is a color format, <code>initialLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_ATTACHMENT_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription2-format-03281",
|
|
"text": " If <code>format</code> is a depth/stencil format, <code>initialLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_COLOR_ATTACHMENT_OPTIMAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription2-format-03282",
|
|
"text": " If <code>format</code> is a color format, <code>finalLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_ATTACHMENT_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription2-format-03283",
|
|
"text": " If <code>format</code> is a depth/stencil format, <code>finalLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_COLOR_ATTACHMENT_OPTIMAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription2-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_ATTACHMENT_DESCRIPTION_2</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription2-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkAttachmentDescriptionStencilLayout\">VkAttachmentDescriptionStencilLayout</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription2-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription2-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkAttachmentDescriptionFlagBits\">VkAttachmentDescriptionFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription2-format-parameter",
|
|
"text": " <code>format</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkFormat\">VkFormat</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription2-samples-parameter",
|
|
"text": " <code>samples</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSampleCountFlagBits\">VkSampleCountFlagBits</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription2-loadOp-parameter",
|
|
"text": " <code>loadOp</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkAttachmentLoadOp\">VkAttachmentLoadOp</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription2-storeOp-parameter",
|
|
"text": " <code>storeOp</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkAttachmentStoreOp\">VkAttachmentStoreOp</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription2-stencilLoadOp-parameter",
|
|
"text": " <code>stencilLoadOp</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkAttachmentLoadOp\">VkAttachmentLoadOp</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription2-stencilStoreOp-parameter",
|
|
"text": " <code>stencilStoreOp</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkAttachmentStoreOp\">VkAttachmentStoreOp</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription2-initialLayout-parameter",
|
|
"text": " <code>initialLayout</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageLayout\">VkImageLayout</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription2-finalLayout-parameter",
|
|
"text": " <code>finalLayout</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageLayout\">VkImageLayout</a> value"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_create_renderpass2)+(VK_VERSION_1_1,VK_KHR_maintenance2)": [
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription2-format-06487",
|
|
"text": " If <code>format</code> is a color format, <code>initialLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_STENCIL_READ_ONLY_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_STENCIL_ATTACHMENT_OPTIMAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription2-format-06488",
|
|
"text": " If <code>format</code> is a color format, <code>finalLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_STENCIL_READ_ONLY_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_STENCIL_ATTACHMENT_OPTIMAL</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_create_renderpass2)+(VK_VERSION_1_2,VK_KHR_separate_depth_stencil_layouts)": [
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription2-separateDepthStencilLayouts-03284",
|
|
"text": " If the <a href=\"#features-separateDepthStencilLayouts\"><code>separateDepthStencilLayouts</code></a> feature is not enabled, <code>initialLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_STENCIL_ATTACHMENT_OPTIMAL</code>, or <code>VK_IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL</code>,"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription2-separateDepthStencilLayouts-03285",
|
|
"text": " If the <a href=\"#features-separateDepthStencilLayouts\"><code>separateDepthStencilLayouts</code></a> feature is not enabled, <code>finalLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_STENCIL_ATTACHMENT_OPTIMAL</code>, or <code>VK_IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL</code>,"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription2-format-03286",
|
|
"text": " If <code>format</code> is a color format, <code>initialLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_STENCIL_ATTACHMENT_OPTIMAL</code>, or <code>VK_IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription2-format-03287",
|
|
"text": " If <code>format</code> is a color format, <code>finalLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_STENCIL_ATTACHMENT_OPTIMAL</code>, or <code>VK_IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription2-format-06906",
|
|
"text": " If <code>format</code> is a depth/stencil format which includes both depth and stencil aspects, <code>initialLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_STENCIL_ATTACHMENT_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription2-format-06907",
|
|
"text": " If <code>format</code> is a depth/stencil format which includes both depth and stencil aspects, <code>finalLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_STENCIL_ATTACHMENT_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription2-format-03290",
|
|
"text": " If <code>format</code> is a depth/stencil format which includes only the depth aspect, <code>initialLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_STENCIL_ATTACHMENT_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription2-format-03291",
|
|
"text": " If <code>format</code> is a depth/stencil format which includes only the depth aspect, <code>finalLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_STENCIL_ATTACHMENT_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription2-pNext-06704",
|
|
"text": " If the <code>pNext</code> chain does not include a <a href=\"#VkAttachmentDescriptionStencilLayout\">VkAttachmentDescriptionStencilLayout</a> structure, <code>format</code> includes a stencil aspect, and <code>stencilLoadOp</code> is <code>VK_ATTACHMENT_LOAD_OP_LOAD</code>, then <code>initialLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_UNDEFINED</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription2-pNext-06705",
|
|
"text": " If the <code>pNext</code> chain does includes a <a href=\"#VkAttachmentDescriptionStencilLayout\">VkAttachmentDescriptionStencilLayout</a> structure, <code>format</code> includes a stencil aspect, and <code>stencilLoadOp</code> is <code>VK_ATTACHMENT_LOAD_OP_LOAD</code>, then <a href=\"#VkAttachmentDescriptionStencilLayout\">VkAttachmentDescriptionStencilLayout</a>::stencilInitialLayout <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_UNDEFINED</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription2-format-06249",
|
|
"text": " If <code>format</code> is a depth/stencil format which includes both depth and stencil aspects, and <code>initialLayout</code> is <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL</code>, the <code>pNext</code> chain <strong class=\"purple\">must</strong> include a <a href=\"#VkAttachmentDescriptionStencilLayout\">VkAttachmentDescriptionStencilLayout</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription2-format-06250",
|
|
"text": " If <code>format</code> is a depth/stencil format which includes both depth and stencil aspects, and <code>finalLayout</code> is <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL</code>, the <code>pNext</code> chain <strong class=\"purple\">must</strong> include a <a href=\"#VkAttachmentDescriptionStencilLayout\">VkAttachmentDescriptionStencilLayout</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription2-format-06247",
|
|
"text": " If the <code>pNext</code> chain does not include a <a href=\"#VkAttachmentDescriptionStencilLayout\">VkAttachmentDescriptionStencilLayout</a> structure and <code>format</code> only includes a stencil aspect, <code>initialLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription2-format-06248",
|
|
"text": " If the <code>pNext</code> chain does not include a <a href=\"#VkAttachmentDescriptionStencilLayout\">VkAttachmentDescriptionStencilLayout</a> structure and <code>format</code> only includes a stencil aspect, <code>finalLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_create_renderpass2)+(VK_KHR_synchronization2)": [
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription2-synchronization2-06908",
|
|
"text": " If the <a href=\"#features-synchronization2\"><code>synchronization2</code></a> feature is not enabled, <code>initialLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_ATTACHMENT_OPTIMAL_KHR</code> or <code>VK_IMAGE_LAYOUT_READ_ONLY_OPTIMAL_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription2-synchronization2-06909",
|
|
"text": " If the <a href=\"#features-synchronization2\"><code>synchronization2</code></a> feature is not enabled, <code>finalLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_ATTACHMENT_OPTIMAL_KHR</code> or <code>VK_IMAGE_LAYOUT_READ_ONLY_OPTIMAL_KHR</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_create_renderpass2)+!(VK_VERSION_1_2,VK_KHR_separate_depth_stencil_layouts)": [
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescription2-format-06703",
|
|
"text": " If <code>format</code> includes a stencil aspect and <code>stencilLoadOp</code> is <code>VK_ATTACHMENT_LOAD_OP_LOAD</code>, then <code>initialLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_UNDEFINED</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkAttachmentDescriptionStencilLayout": {
|
|
"(VK_VERSION_1_2,VK_KHR_create_renderpass2)+(VK_VERSION_1_2,VK_KHR_separate_depth_stencil_layouts)": [
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescriptionStencilLayout-stencilInitialLayout-03308",
|
|
"text": " <code>stencilInitialLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_COLOR_ATTACHMENT_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_ATTACHMENT_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_STENCIL_READ_ONLY_OPTIMAL</code>, or <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_STENCIL_ATTACHMENT_OPTIMAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescriptionStencilLayout-stencilFinalLayout-03309",
|
|
"text": " <code>stencilFinalLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_COLOR_ATTACHMENT_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_ATTACHMENT_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_STENCIL_READ_ONLY_OPTIMAL</code>, or <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_STENCIL_ATTACHMENT_OPTIMAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescriptionStencilLayout-stencilFinalLayout-03310",
|
|
"text": " <code>stencilFinalLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_UNDEFINED</code> or <code>VK_IMAGE_LAYOUT_PREINITIALIZED</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescriptionStencilLayout-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_ATTACHMENT_DESCRIPTION_STENCIL_LAYOUT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescriptionStencilLayout-stencilInitialLayout-parameter",
|
|
"text": " <code>stencilInitialLayout</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageLayout\">VkImageLayout</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentDescriptionStencilLayout-stencilFinalLayout-parameter",
|
|
"text": " <code>stencilFinalLayout</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageLayout\">VkImageLayout</a> value"
|
|
}
|
|
]
|
|
},
|
|
"VkSubpassDescription2": {
|
|
"(VK_VERSION_1_2,VK_KHR_create_renderpass2)": [
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription2-attachment-06912",
|
|
"text": " If the <code>attachment</code> member of an element of <code>pInputAttachments</code> is not <code>VK_ATTACHMENT_UNUSED</code>, its <code>layout</code> member <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_COLOR_ATTACHMENT_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_ATTACHMENT_OPTIMAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription2-attachment-06913",
|
|
"text": " If the <code>attachment</code> member of an element of <code>pColorAttachments</code> is not <code>VK_ATTACHMENT_UNUSED</code>, its <code>layout</code> member <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_ATTACHMENT_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_SHADER_READ_ONLY_OPTIMAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription2-attachment-06914",
|
|
"text": " If the <code>attachment</code> member of an element of <code>pResolveAttachments</code> is not <code>VK_ATTACHMENT_UNUSED</code>, its <code>layout</code> member <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_ATTACHMENT_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_SHADER_READ_ONLY_OPTIMAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription2-attachment-06915",
|
|
"text": " If the <code>attachment</code> member of <code>pDepthStencilAttachment</code> is not <code>VK_ATTACHMENT_UNUSED</code>, ts <code>layout</code> member <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_COLOR_ATTACHMENT_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_SHADER_READ_ONLY_OPTIMAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription2-colorAttachmentCount-03063",
|
|
"text": " <code>colorAttachmentCount</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxColorAttachments</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription2-loadOp-03064",
|
|
"text": " If the first use of an attachment in this render pass is as an input attachment, and the attachment is not also used as a color or depth/stencil attachment in the same subpass, then <code>loadOp</code> <strong class=\"purple\">must</strong> not be <code>VK_ATTACHMENT_LOAD_OP_CLEAR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription2-pResolveAttachments-03065",
|
|
"text": " If <code>pResolveAttachments</code> is not <code>NULL</code>, for each resolve attachment that does not have the value <code>VK_ATTACHMENT_UNUSED</code>, the corresponding color attachment <strong class=\"purple\">must</strong> not have the value <code>VK_ATTACHMENT_UNUSED</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription2-pResolveAttachments-03066",
|
|
"text": " If <code>pResolveAttachments</code> is not <code>NULL</code>, for each resolve attachment that is not <code>VK_ATTACHMENT_UNUSED</code>, the corresponding color attachment <strong class=\"purple\">must</strong> not have a sample count of <code>VK_SAMPLE_COUNT_1_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription2-pResolveAttachments-03067",
|
|
"text": " If <code>pResolveAttachments</code> is not <code>NULL</code>, each resolve attachment that is not <code>VK_ATTACHMENT_UNUSED</code> <strong class=\"purple\">must</strong> have a sample count of <code>VK_SAMPLE_COUNT_1_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription2-pResolveAttachments-03068",
|
|
"text": " Any given element of <code>pResolveAttachments</code> <strong class=\"purple\">must</strong> have the same <a href=\"#VkFormat\">VkFormat</a> as its corresponding color attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription2-multisampledRenderToSingleSampled-06869",
|
|
"text": " If none of the <code><a href=\"#VK_AMD_mixed_attachment_samples\">VK_AMD_mixed_attachment_samples</a></code> extension, the <code><a href=\"#VK_NV_framebuffer_mixed_samples\">VK_NV_framebuffer_mixed_samples</a></code> extension, or the <a href=\"#features-multisampledRenderToSingleSampled\"><code>multisampledRenderToSingleSampled</code></a> feature are enabled, all attachments in <code>pColorAttachments</code> that are not <code>VK_ATTACHMENT_UNUSED</code> <strong class=\"purple\">must</strong> have the same sample count"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription2-pInputAttachments-02897",
|
|
"text": " All attachments in <code>pInputAttachments</code> that are not <code>VK_ATTACHMENT_UNUSED</code> <strong class=\"purple\">must</strong> have image formats whose <a href=\"#potential-format-features\">potential format features</a> contain at least <code>VK_FORMAT_FEATURE_COLOR_ATTACHMENT_BIT</code> or <code>VK_FORMAT_FEATURE_DEPTH_STENCIL_ATTACHMENT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription2-pColorAttachments-02898",
|
|
"text": " All attachments in <code>pColorAttachments</code> that are not <code>VK_ATTACHMENT_UNUSED</code> <strong class=\"purple\">must</strong> have image formats whose <a href=\"#potential-format-features\">potential format features</a> contain <code>VK_FORMAT_FEATURE_COLOR_ATTACHMENT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription2-pResolveAttachments-02899",
|
|
"text": " All attachments in <code>pResolveAttachments</code> that are not <code>VK_ATTACHMENT_UNUSED</code> <strong class=\"purple\">must</strong> have image formats whose <a href=\"#potential-format-features\">potential format features</a> contain <code>VK_FORMAT_FEATURE_COLOR_ATTACHMENT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription2-pDepthStencilAttachment-02900",
|
|
"text": " If <code>pDepthStencilAttachment</code> is not <code>NULL</code> and the attachment is not <code>VK_ATTACHMENT_UNUSED</code> then it <strong class=\"purple\">must</strong> have an image format whose <a href=\"#potential-format-features\">potential format features</a> contain <code>VK_FORMAT_FEATURE_DEPTH_STENCIL_ATTACHMENT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription2-multisampledRenderToSingleSampled-06872",
|
|
"text": " If none of the <code><a href=\"#VK_AMD_mixed_attachment_samples\">VK_AMD_mixed_attachment_samples</a></code> extension, the <code><a href=\"#VK_NV_framebuffer_mixed_samples\">VK_NV_framebuffer_mixed_samples</a></code> extension, or the <a href=\"#features-multisampledRenderToSingleSampled\"><code>multisampledRenderToSingleSampled</code></a> feature are enabled, all attachments in <code>pDepthStencilAttachment</code> or <code>pColorAttachments</code> that are not <code>VK_ATTACHMENT_UNUSED</code> <strong class=\"purple\">must</strong> have the same sample count"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription2-attachment-03073",
|
|
"text": " Each element of <code>pPreserveAttachments</code> <strong class=\"purple\">must</strong> not be <code>VK_ATTACHMENT_UNUSED</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription2-pPreserveAttachments-03074",
|
|
"text": " Any given element of <code>pPreserveAttachments</code> <strong class=\"purple\">must</strong> not also be an element of any other member of the subpass description"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription2-layout-02528",
|
|
"text": " If any attachment is used by more than one <a href=\"#VkAttachmentReference2\">VkAttachmentReference2</a> member, then each use <strong class=\"purple\">must</strong> use the same <code>layout</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription2-attachment-02799",
|
|
"text": " If the <code>attachment</code> member of any element of <code>pInputAttachments</code> is not <code>VK_ATTACHMENT_UNUSED</code>, then the <code>aspectMask</code> member <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkImageAspectFlagBits\">VkImageAspectFlagBits</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription2-attachment-02800",
|
|
"text": " If the <code>attachment</code> member of any element of <code>pInputAttachments</code> is not <code>VK_ATTACHMENT_UNUSED</code>, then the <code>aspectMask</code> member <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription2-attachment-02801",
|
|
"text": " If the <code>attachment</code> member of any element of <code>pInputAttachments</code> is not <code>VK_ATTACHMENT_UNUSED</code>, then the <code>aspectMask</code> member <strong class=\"purple\">must</strong> not include <code>VK_IMAGE_ASPECT_METADATA_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription2-pDepthStencilAttachment-04440",
|
|
"text": " An attachment <strong class=\"purple\">must</strong> not be used in both <code>pDepthStencilAttachment</code> and <code>pColorAttachments</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription2-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_SUBPASS_DESCRIPTION_2</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription2-pNext-pNext",
|
|
"text": " Each <code>pNext</code> member of any structure (including this one) in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be either <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkFragmentShadingRateAttachmentInfoKHR\">VkFragmentShadingRateAttachmentInfoKHR</a>, <a href=\"#VkMultisampledRenderToSingleSampledInfoEXT\">VkMultisampledRenderToSingleSampledInfoEXT</a>, <a href=\"#VkRenderPassCreationControlEXT\">VkRenderPassCreationControlEXT</a>, <a href=\"#VkRenderPassSubpassFeedbackCreateInfoEXT\">VkRenderPassSubpassFeedbackCreateInfoEXT</a>, or <a href=\"#VkSubpassDescriptionDepthStencilResolve\">VkSubpassDescriptionDepthStencilResolve</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription2-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription2-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkSubpassDescriptionFlagBits\">VkSubpassDescriptionFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription2-pipelineBindPoint-parameter",
|
|
"text": " <code>pipelineBindPoint</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPipelineBindPoint\">VkPipelineBindPoint</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription2-pInputAttachments-parameter",
|
|
"text": " If <code>inputAttachmentCount</code> is not <code>0</code>, <code>pInputAttachments</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>inputAttachmentCount</code> valid <a href=\"#VkAttachmentReference2\">VkAttachmentReference2</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription2-pColorAttachments-parameter",
|
|
"text": " If <code>colorAttachmentCount</code> is not <code>0</code>, <code>pColorAttachments</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>colorAttachmentCount</code> valid <a href=\"#VkAttachmentReference2\">VkAttachmentReference2</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription2-pResolveAttachments-parameter",
|
|
"text": " If <code>colorAttachmentCount</code> is not <code>0</code>, and <code>pResolveAttachments</code> is not <code>NULL</code>, <code>pResolveAttachments</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>colorAttachmentCount</code> valid <a href=\"#VkAttachmentReference2\">VkAttachmentReference2</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription2-pDepthStencilAttachment-parameter",
|
|
"text": " If <code>pDepthStencilAttachment</code> is not <code>NULL</code>, <code>pDepthStencilAttachment</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAttachmentReference2\">VkAttachmentReference2</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription2-pPreserveAttachments-parameter",
|
|
"text": " If <code>preserveAttachmentCount</code> is not <code>0</code>, <code>pPreserveAttachments</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>preserveAttachmentCount</code> <code>uint32_t</code> values"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_create_renderpass2)+(VK_VERSION_1_1,VK_KHR_maintenance2)": [
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription2-attachment-06916",
|
|
"text": " If the <code>attachment</code> member of an element of <code>pColorAttachments</code> is not <code>VK_ATTACHMENT_UNUSED</code>, its <code>layout</code> member <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_STENCIL_READ_ONLY_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_STENCIL_ATTACHMENT_OPTIMAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription2-attachment-06917",
|
|
"text": " If the <code>attachment</code> member of an element of <code>pResolveAttachments</code> is not <code>VK_ATTACHMENT_UNUSED</code>, its <code>layout</code> member <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_STENCIL_READ_ONLY_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_STENCIL_ATTACHMENT_OPTIMAL</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_create_renderpass2)+(VK_VERSION_1_2,VK_KHR_separate_depth_stencil_layouts)": [
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription2-attachment-06918",
|
|
"text": " If the <code>attachment</code> member of an element of <code>pInputAttachments</code> is not <code>VK_ATTACHMENT_UNUSED</code>, its <code>layout</code> member <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_STENCIL_ATTACHMENT_OPTIMAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription2-attachment-06919",
|
|
"text": " If the <code>attachment</code> member of an element of <code>pColorAttachments</code> is not <code>VK_ATTACHMENT_UNUSED</code>, its <code>layout</code> member <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_STENCIL_ATTACHMENT_OPTIMAL</code>, or <code>VK_IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription2-attachment-06920",
|
|
"text": " If the <code>attachment</code> member of an element of <code>pResolveAttachments</code> is not <code>VK_ATTACHMENT_UNUSED</code>, its <code>layout</code> member <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_STENCIL_ATTACHMENT_OPTIMAL</code>, or <code>VK_IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription2-attachment-06251",
|
|
"text": " If the <code>attachment</code> member of <code>pDepthStencilAttachment</code> is not <code>VK_ATTACHMENT_UNUSED</code> and its <code>pNext</code> chain includes a <a href=\"#VkAttachmentDescriptionStencilLayout\">VkAttachmentDescriptionStencilLayout</a> structure, the <code>layout</code> member of <code>pDepthStencilAttachment</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_STENCIL_ATTACHMENT_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_create_renderpass2)+(VK_KHR_synchronization2)": [
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription2-attachment-06921",
|
|
"text": " If the <code>attachment</code> member of an element of <code>pInputAttachments</code> is not <code>VK_ATTACHMENT_UNUSED</code>, its <code>layout</code> member <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_ATTACHMENT_OPTIMAL_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription2-attachment-06922",
|
|
"text": " If the <code>attachment</code> member of an element of <code>pColorAttachments</code> is not <code>VK_ATTACHMENT_UNUSED</code>, its <code>layout</code> member <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_READ_ONLY_OPTIMAL_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription2-attachment-06923",
|
|
"text": " If the <code>attachment</code> member of an element of <code>pResolveAttachments</code> is not <code>VK_ATTACHMENT_UNUSED</code>, its <code>layout</code> member <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_READ_ONLY_OPTIMAL_KHR</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_create_renderpass2)+!(VK_HUAWEI_subpass_shading)": [
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription2-pipelineBindPoint-03062",
|
|
"text": " <code>pipelineBindPoint</code> <strong class=\"purple\">must</strong> be <code>VK_PIPELINE_BIND_POINT_GRAPHICS</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_create_renderpass2)+(VK_HUAWEI_subpass_shading)": [
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription2-pipelineBindPoint-04953",
|
|
"text": " <code>pipelineBindPoint</code> <strong class=\"purple\">must</strong> be <code>VK_PIPELINE_BIND_POINT_GRAPHICS</code> or <code>VK_PIPELINE_BIND_POINT_SUBPASS_SHADING_HUAWEI</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_create_renderpass2)+(VK_NV_linear_color_attachment)": [
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription2-linearColorAttachment-06499",
|
|
"text": " If the <a href=\"#features-linearColorAttachment\"><code>linearColorAttachment</code></a> feature is enabled and the image is created with <code>VK_IMAGE_TILING_LINEAR</code>, all attachments in <code>pInputAttachments</code> that are not <code>VK_ATTACHMENT_UNUSED</code> <strong class=\"purple\">must</strong> have image formats whose <a href=\"#potential-format-features\">potential format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_LINEAR_COLOR_ATTACHMENT_BIT_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription2-linearColorAttachment-06500",
|
|
"text": " If the <a href=\"#features-linearColorAttachment\"><code>linearColorAttachment</code></a> feature is enabled and the image is created with <code>VK_IMAGE_TILING_LINEAR</code>, all attachments in <code>pColorAttachments</code> that are not <code>VK_ATTACHMENT_UNUSED</code> <strong class=\"purple\">must</strong> have image formats whose <a href=\"#potential-format-features\">potential format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_LINEAR_COLOR_ATTACHMENT_BIT_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription2-linearColorAttachment-06501",
|
|
"text": " If the <a href=\"#features-linearColorAttachment\"><code>linearColorAttachment</code></a> feature is enabled and the image is created with <code>VK_IMAGE_TILING_LINEAR</code>, all attachments in <code>pResolveAttachments</code> that are not <code>VK_ATTACHMENT_UNUSED</code> <strong class=\"purple\">must</strong> have image formats whose <a href=\"#potential-format-features\">potential format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_LINEAR_COLOR_ATTACHMENT_BIT_NV</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_create_renderpass2)+(VK_AMD_mixed_attachment_samples)": [
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription2-pColorAttachments-03070",
|
|
"text": " If the <code><a href=\"#VK_AMD_mixed_attachment_samples\">VK_AMD_mixed_attachment_samples</a></code> extension is enabled, all attachments in <code>pColorAttachments</code> that are not <code>VK_ATTACHMENT_UNUSED</code> <strong class=\"purple\">must</strong> have a sample count that is smaller than or equal to the sample count of <code>pDepthStencilAttachment</code> if it is not <code>VK_ATTACHMENT_UNUSED</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_create_renderpass2)+(VK_EXT_multisampled_render_to_single_sampled)": [
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription2-pNext-06870",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkMultisampledRenderToSingleSampledInfoEXT\">VkMultisampledRenderToSingleSampledInfoEXT</a> structure with <code>multisampledRenderToSingleSampledEnable</code> equal to <code>VK_TRUE</code>, then all attachments in <code>pColorAttachments</code> and <code>pDepthStencilAttachment</code> that are not <code>VK_ATTACHMENT_UNUSED</code> <strong class=\"purple\">must</strong> have a sample count that is either <code>VK_SAMPLE_COUNT_1_BIT</code> or equal to <a href=\"#VkMultisampledRenderToSingleSampledInfoEXT\">VkMultisampledRenderToSingleSampledInfoEXT</a>::<code>rasterizationSamples</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription2-pNext-06871",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkMultisampledRenderToSingleSampledInfoEXT\">VkMultisampledRenderToSingleSampledInfoEXT</a> structure with <code>multisampledRenderToSingleSampledEnable</code> equal to <code>VK_TRUE</code>, and <code>pDepthStencilAttachment</code> is not <code>NULL</code>, does not have the value <code>VK_ATTACHMENT_UNUSED</code>, and has a sample count of <code>VK_SAMPLE_COUNT_1_BIT</code>, the <code>pNext</code> chain <strong class=\"purple\">must</strong> also include a <a href=\"#VkSubpassDescriptionDepthStencilResolve\">VkSubpassDescriptionDepthStencilResolve</a> structure with <code>pDepthStencilResolveAttachment</code> that is either <code>NULL</code> or has the value <code>VK_ATTACHMENT_UNUSED</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_create_renderpass2)+(VK_NVX_multiview_per_view_attributes)": [
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription2-flags-03076",
|
|
"text": " If <code>flags</code> includes <code>VK_SUBPASS_DESCRIPTION_PER_VIEW_POSITION_X_ONLY_BIT_NVX</code>, it <strong class=\"purple\">must</strong> also include <code>VK_SUBPASS_DESCRIPTION_PER_VIEW_ATTRIBUTES_BIT_NVX</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_create_renderpass2)+(VK_EXT_image_drm_format_modifier)": [
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription2-attachment-04563",
|
|
"text": " If the <code>attachment</code> member of any element of <code>pInputAttachments</code> is not <code>VK_ATTACHMENT_UNUSED</code>, then the <code>aspectMask</code> member <strong class=\"purple\">must</strong> not include <code>VK_IMAGE_ASPECT_MEMORY_PLANE<em>{ibit}</em>BIT_EXT</code> for any index <em>i</em>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_create_renderpass2)+(VK_VERSION_1_1,VK_KHR_multiview)": [
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription2-multiview-06558",
|
|
"text": " If the <a href=\"#features-multiview\"><code>multiview</code></a> feature is not enabled, <code>viewMask</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescription2-viewMask-06706",
|
|
"text": " The index of the most significant bit in <code>viewMask</code> <strong class=\"purple\">must</strong> be less than <a href=\"#limits-maxMultiviewViewCount\"><code>maxMultiviewViewCount</code></a>"
|
|
}
|
|
]
|
|
},
|
|
"VkSubpassDescriptionDepthStencilResolve": {
|
|
"(VK_VERSION_1_2,VK_KHR_create_renderpass2)+(VK_VERSION_1_2,VK_KHR_depth_stencil_resolve)": [
|
|
{
|
|
"vuid": "VUID-VkSubpassDescriptionDepthStencilResolve-pDepthStencilResolveAttachment-03177",
|
|
"text": " If <code>pDepthStencilResolveAttachment</code> is not <code>NULL</code> and does not have the value <code>VK_ATTACHMENT_UNUSED</code>, <code>pDepthStencilAttachment</code> <strong class=\"purple\">must</strong> not be <code>NULL</code> or have the value <code>VK_ATTACHMENT_UNUSED</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescriptionDepthStencilResolve-pDepthStencilResolveAttachment-03179",
|
|
"text": " If <code>pDepthStencilResolveAttachment</code> is not <code>NULL</code> and does not have the value <code>VK_ATTACHMENT_UNUSED</code>, <code>pDepthStencilAttachment</code> <strong class=\"purple\">must</strong> not have a sample count of <code>VK_SAMPLE_COUNT_1_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescriptionDepthStencilResolve-pDepthStencilResolveAttachment-03180",
|
|
"text": " If <code>pDepthStencilResolveAttachment</code> is not <code>NULL</code> and does not have the value <code>VK_ATTACHMENT_UNUSED</code>, <code>pDepthStencilResolveAttachment</code> <strong class=\"purple\">must</strong> have a sample count of <code>VK_SAMPLE_COUNT_1_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescriptionDepthStencilResolve-pDepthStencilResolveAttachment-02651",
|
|
"text": " If <code>pDepthStencilResolveAttachment</code> is not <code>NULL</code> and does not have the value <code>VK_ATTACHMENT_UNUSED</code> then it <strong class=\"purple\">must</strong> have an image format whose <a href=\"#potential-format-features\">potential format features</a> contain <code>VK_FORMAT_FEATURE_DEPTH_STENCIL_ATTACHMENT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescriptionDepthStencilResolve-pDepthStencilResolveAttachment-03181",
|
|
"text": " If <code>pDepthStencilResolveAttachment</code> is not <code>NULL</code> and does not have the value <code>VK_ATTACHMENT_UNUSED</code> and <a href=\"#VkFormat\">VkFormat</a> of <code>pDepthStencilResolveAttachment</code> has a depth component, then the <a href=\"#VkFormat\">VkFormat</a> of <code>pDepthStencilAttachment</code> <strong class=\"purple\">must</strong> have a depth component with the same number of bits and numerical type"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescriptionDepthStencilResolve-pDepthStencilResolveAttachment-03182",
|
|
"text": " If <code>pDepthStencilResolveAttachment</code> is not <code>NULL</code> and does not have the value <code>VK_ATTACHMENT_UNUSED</code>, and <a href=\"#VkFormat\">VkFormat</a> of <code>pDepthStencilResolveAttachment</code> has a stencil component, then the <a href=\"#VkFormat\">VkFormat</a> of <code>pDepthStencilAttachment</code> <strong class=\"purple\">must</strong> have a stencil component with the same number of bits and numerical type"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescriptionDepthStencilResolve-pDepthStencilResolveAttachment-03178",
|
|
"text": " If <code>pDepthStencilResolveAttachment</code> is not <code>NULL</code> and does not have the value <code>VK_ATTACHMENT_UNUSED</code>, <code>depthResolveMode</code> and <code>stencilResolveMode</code> <strong class=\"purple\">must</strong> not both be <code>VK_RESOLVE_MODE_NONE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescriptionDepthStencilResolve-depthResolveMode-03183",
|
|
"text": " If <code>pDepthStencilResolveAttachment</code> is not <code>NULL</code> and does not have the value <code>VK_ATTACHMENT_UNUSED</code> and the <a href=\"#VkFormat\">VkFormat</a> of <code>pDepthStencilResolveAttachment</code> has a depth component, then the value of <code>depthResolveMode</code> <strong class=\"purple\">must</strong> be one of the bits set in <a href=\"#VkPhysicalDeviceDepthStencilResolveProperties\">VkPhysicalDeviceDepthStencilResolveProperties</a>::<code>supportedDepthResolveModes</code> or <code>VK_RESOLVE_MODE_NONE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescriptionDepthStencilResolve-stencilResolveMode-03184",
|
|
"text": " If <code>pDepthStencilResolveAttachment</code> is not <code>NULL</code> and does not have the value <code>VK_ATTACHMENT_UNUSED</code> and the <a href=\"#VkFormat\">VkFormat</a> of <code>pDepthStencilResolveAttachment</code> has a stencil component, then the value of <code>stencilResolveMode</code> <strong class=\"purple\">must</strong> be one of the bits set in <a href=\"#VkPhysicalDeviceDepthStencilResolveProperties\">VkPhysicalDeviceDepthStencilResolveProperties</a>::<code>supportedStencilResolveModes</code> or <code>VK_RESOLVE_MODE_NONE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescriptionDepthStencilResolve-pDepthStencilResolveAttachment-03185",
|
|
"text": " If <code>pDepthStencilResolveAttachment</code> is not <code>NULL</code> and does not have the value <code>VK_ATTACHMENT_UNUSED</code>, the <a href=\"#VkFormat\">VkFormat</a> of <code>pDepthStencilResolveAttachment</code> has both depth and stencil components, <a href=\"#VkPhysicalDeviceDepthStencilResolveProperties\">VkPhysicalDeviceDepthStencilResolveProperties</a>::<code>independentResolve</code> is <code>VK_FALSE</code>, and <a href=\"#VkPhysicalDeviceDepthStencilResolveProperties\">VkPhysicalDeviceDepthStencilResolveProperties</a>::<code>independentResolveNone</code> is <code>VK_FALSE</code>, then the values of <code>depthResolveMode</code> and <code>stencilResolveMode</code> <strong class=\"purple\">must</strong> be identical"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescriptionDepthStencilResolve-pDepthStencilResolveAttachment-03186",
|
|
"text": " If <code>pDepthStencilResolveAttachment</code> is not <code>NULL</code> and does not have the value <code>VK_ATTACHMENT_UNUSED</code>, the <a href=\"#VkFormat\">VkFormat</a> of <code>pDepthStencilResolveAttachment</code> has both depth and stencil components, <a href=\"#VkPhysicalDeviceDepthStencilResolveProperties\">VkPhysicalDeviceDepthStencilResolveProperties</a>::<code>independentResolve</code> is <code>VK_FALSE</code> and <a href=\"#VkPhysicalDeviceDepthStencilResolveProperties\">VkPhysicalDeviceDepthStencilResolveProperties</a>::<code>independentResolveNone</code> is <code>VK_TRUE</code>, then the values of <code>depthResolveMode</code> and <code>stencilResolveMode</code> <strong class=\"purple\">must</strong> be identical or one of them <strong class=\"purple\">must</strong> be <code>VK_RESOLVE_MODE_NONE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescriptionDepthStencilResolve-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_SUBPASS_DESCRIPTION_DEPTH_STENCIL_RESOLVE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescriptionDepthStencilResolve-pDepthStencilResolveAttachment-parameter",
|
|
"text": " If <code>pDepthStencilResolveAttachment</code> is not <code>NULL</code>, <code>pDepthStencilResolveAttachment</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAttachmentReference2\">VkAttachmentReference2</a> structure"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_create_renderpass2)+(VK_VERSION_1_2,VK_KHR_depth_stencil_resolve)+(VK_EXT_multisampled_render_to_single_sampled)": [
|
|
{
|
|
"vuid": "VUID-VkSubpassDescriptionDepthStencilResolve-pNext-06873",
|
|
"text": " If the <code>pNext</code> chain of <a href=\"#VkSubpassDescription2\">VkSubpassDescription2</a> includes a <code>VkMultisampledRenderToSingleSampledInfoEXT</code> structure, the <code>multisampledRenderToSingleSampledEnable</code> field is <code>VK_TRUE</code>, and <code>pDepthStencilAttachment</code> is not <code>NULL</code> and does not have the value <code>VK_ATTACHMENT_UNUSED</code>, <code>depthResolveMode</code> and <code>stencilResolveMode</code> <strong class=\"purple\">must</strong> not both be <code>VK_RESOLVE_MODE_NONE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescriptionDepthStencilResolve-pNext-06874",
|
|
"text": " If the <code>pNext</code> chain of <a href=\"#VkSubpassDescription2\">VkSubpassDescription2</a> includes a <code>VkMultisampledRenderToSingleSampledInfoEXT</code> structure whose <code>multisampledRenderToSingleSampledEnable</code> field is <code>VK_TRUE</code>, and <code>pDepthStencilAttachment</code> is not <code>NULL</code>, does not have the value <code>VK_ATTACHMENT_UNUSED</code>, and has a <a href=\"#VkFormat\">VkFormat</a> that has a depth component, then the value of <code>depthResolveMode</code> <strong class=\"purple\">must</strong> be one of the bits set in <a href=\"#VkPhysicalDeviceDepthStencilResolveProperties\">VkPhysicalDeviceDepthStencilResolveProperties</a>::<code>supportedDepthResolveModes</code> or <code>VK_RESOLVE_MODE_NONE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescriptionDepthStencilResolve-pNext-06875",
|
|
"text": " If the <code>pNext</code> chain of <a href=\"#VkSubpassDescription2\">VkSubpassDescription2</a> includes a <code>VkMultisampledRenderToSingleSampledInfoEXT</code> structure whose <code>multisampledRenderToSingleSampledEnable</code> field is <code>VK_TRUE</code>, and <code>pDepthStencilAttachment</code> is not <code>NULL</code>, does not have the value <code>VK_ATTACHMENT_UNUSED</code>, and has a <a href=\"#VkFormat\">VkFormat</a> with a stencil component, then the value of <code>stencilResolveMode</code> <strong class=\"purple\">must</strong> be one of the bits set in <a href=\"#VkPhysicalDeviceDepthStencilResolveProperties\">VkPhysicalDeviceDepthStencilResolveProperties</a>::<code>supportedStencilResolveModes</code> or <code>VK_RESOLVE_MODE_NONE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescriptionDepthStencilResolve-pNext-06876",
|
|
"text": " If the <code>pNext</code> chain of <a href=\"#VkSubpassDescription2\">VkSubpassDescription2</a> includes a <code>VkMultisampledRenderToSingleSampledInfoEXT</code> structure whose <code>multisampledRenderToSingleSampledEnable</code> field is <code>VK_TRUE</code>, <code>pDepthStencilAttachment</code> is not <code>NULL</code>, does not have the value <code>VK_ATTACHMENT_UNUSED</code>, and has a <a href=\"#VkFormat\">VkFormat</a> with both depth and stencil components, and both <a href=\"#VkPhysicalDeviceDepthStencilResolveProperties\">VkPhysicalDeviceDepthStencilResolveProperties</a>::<code>independentResolve</code> and <a href=\"#VkPhysicalDeviceDepthStencilResolveProperties\">VkPhysicalDeviceDepthStencilResolveProperties</a>::<code>independentResolveNone</code> are <code>VK_FALSE</code>, then the values of <code>depthResolveMode</code> and <code>stencilResolveMode</code> <strong class=\"purple\">must</strong> be identical"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDescriptionDepthStencilResolve-pNext-06877",
|
|
"text": " If the <code>pNext</code> chain of <a href=\"#VkSubpassDescription2\">VkSubpassDescription2</a> includes a <code>VkMultisampledRenderToSingleSampledInfoEXT</code> structure whose <code>multisampledRenderToSingleSampledEnable</code> field is <code>VK_TRUE</code>, <code>pDepthStencilAttachment</code> is not <code>NULL</code>, does not have the value <code>VK_ATTACHMENT_UNUSED</code>, and has a <a href=\"#VkFormat\">VkFormat</a> with both depth and stencil components, <a href=\"#VkPhysicalDeviceDepthStencilResolveProperties\">VkPhysicalDeviceDepthStencilResolveProperties</a>::<code>independentResolve</code> is <code>VK_FALSE</code>, and <a href=\"#VkPhysicalDeviceDepthStencilResolveProperties\">VkPhysicalDeviceDepthStencilResolveProperties</a>::<code>independentResolveNone</code> is <code>VK_TRUE</code>, then the values of <code>depthResolveMode</code> and <code>stencilResolveMode</code> <strong class=\"purple\">must</strong> be identical or one of them <strong class=\"purple\">must</strong> be <code>VK_RESOLVE_MODE_NONE</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkFragmentShadingRateAttachmentInfoKHR": {
|
|
"(VK_VERSION_1_2,VK_KHR_create_renderpass2)+(VK_KHR_fragment_shading_rate)": [
|
|
{
|
|
"vuid": "VUID-VkFragmentShadingRateAttachmentInfoKHR-pFragmentShadingRateAttachment-04524",
|
|
"text": " If <code>pFragmentShadingRateAttachment</code> is not <code>NULL</code> and its <code>attachment</code> member is not <code>VK_ATTACHMENT_UNUSED</code>, its <code>layout</code> member <strong class=\"purple\">must</strong> be equal to <code>VK_IMAGE_LAYOUT_GENERAL</code> or <code>VK_IMAGE_LAYOUT_FRAGMENT_SHADING_RATE_ATTACHMENT_OPTIMAL_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFragmentShadingRateAttachmentInfoKHR-pFragmentShadingRateAttachment-04525",
|
|
"text": " If <code>pFragmentShadingRateAttachment</code> is not <code>NULL</code> and its <code>attachment</code> member is not <code>VK_ATTACHMENT_UNUSED</code>, <code>shadingRateAttachmentTexelSize.width</code> <strong class=\"purple\">must</strong> be a power of two value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFragmentShadingRateAttachmentInfoKHR-pFragmentShadingRateAttachment-04526",
|
|
"text": " If <code>pFragmentShadingRateAttachment</code> is not <code>NULL</code> and its <code>attachment</code> member is not <code>VK_ATTACHMENT_UNUSED</code>, <code>shadingRateAttachmentTexelSize.width</code> <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#limits-maxFragmentShadingRateAttachmentTexelSize\"><code>maxFragmentShadingRateAttachmentTexelSize.width</code></a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFragmentShadingRateAttachmentInfoKHR-pFragmentShadingRateAttachment-04527",
|
|
"text": " If <code>pFragmentShadingRateAttachment</code> is not <code>NULL</code> and its <code>attachment</code> member is not <code>VK_ATTACHMENT_UNUSED</code>, <code>shadingRateAttachmentTexelSize.width</code> <strong class=\"purple\">must</strong> be greater than or equal to <a href=\"#limits-minFragmentShadingRateAttachmentTexelSize\"><code>minFragmentShadingRateAttachmentTexelSize.width</code></a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFragmentShadingRateAttachmentInfoKHR-pFragmentShadingRateAttachment-04528",
|
|
"text": " If <code>pFragmentShadingRateAttachment</code> is not <code>NULL</code> and its <code>attachment</code> member is not <code>VK_ATTACHMENT_UNUSED</code>, <code>shadingRateAttachmentTexelSize.height</code> <strong class=\"purple\">must</strong> be a power of two value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFragmentShadingRateAttachmentInfoKHR-pFragmentShadingRateAttachment-04529",
|
|
"text": " If <code>pFragmentShadingRateAttachment</code> is not <code>NULL</code> and its <code>attachment</code> member is not <code>VK_ATTACHMENT_UNUSED</code>, <code>shadingRateAttachmentTexelSize.height</code> <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#limits-maxFragmentShadingRateAttachmentTexelSize\"><code>maxFragmentShadingRateAttachmentTexelSize.height</code></a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFragmentShadingRateAttachmentInfoKHR-pFragmentShadingRateAttachment-04530",
|
|
"text": " If <code>pFragmentShadingRateAttachment</code> is not <code>NULL</code> and its <code>attachment</code> member is not <code>VK_ATTACHMENT_UNUSED</code>, <code>shadingRateAttachmentTexelSize.height</code> <strong class=\"purple\">must</strong> be greater than or equal to <a href=\"#limits-minFragmentShadingRateAttachmentTexelSize\"><code>minFragmentShadingRateAttachmentTexelSize.height</code></a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFragmentShadingRateAttachmentInfoKHR-pFragmentShadingRateAttachment-04531",
|
|
"text": " If <code>pFragmentShadingRateAttachment</code> is not <code>NULL</code> and its <code>attachment</code> member is not <code>VK_ATTACHMENT_UNUSED</code>, the quotient of <code>shadingRateAttachmentTexelSize.width</code> and <code>shadingRateAttachmentTexelSize.height</code> <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#limits-maxFragmentShadingRateAttachmentTexelSizeAspectRatio\"><code>maxFragmentShadingRateAttachmentTexelSizeAspectRatio</code></a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFragmentShadingRateAttachmentInfoKHR-pFragmentShadingRateAttachment-04532",
|
|
"text": " If <code>pFragmentShadingRateAttachment</code> is not <code>NULL</code> and its <code>attachment</code> member is not <code>VK_ATTACHMENT_UNUSED</code>, the quotient of <code>shadingRateAttachmentTexelSize.height</code> and <code>shadingRateAttachmentTexelSize.width</code> <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#limits-maxFragmentShadingRateAttachmentTexelSizeAspectRatio\"><code>maxFragmentShadingRateAttachmentTexelSizeAspectRatio</code></a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFragmentShadingRateAttachmentInfoKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_FRAGMENT_SHADING_RATE_ATTACHMENT_INFO_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFragmentShadingRateAttachmentInfoKHR-pFragmentShadingRateAttachment-parameter",
|
|
"text": " If <code>pFragmentShadingRateAttachment</code> is not <code>NULL</code>, <code>pFragmentShadingRateAttachment</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAttachmentReference2\">VkAttachmentReference2</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkMultisampledRenderToSingleSampledInfoEXT": {
|
|
"(VK_VERSION_1_2,VK_KHR_create_renderpass2)+(VK_EXT_multisampled_render_to_single_sampled)": [
|
|
{
|
|
"vuid": "VUID-VkMultisampledRenderToSingleSampledInfoEXT-rasterizationSamples-06878",
|
|
"text": " The value of <code>rasterizationSamples</code> <strong class=\"purple\">must</strong> not be <code>VK_SAMPLE_COUNT_1_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMultisampledRenderToSingleSampledInfoEXT-pNext-06879",
|
|
"text": " If added to the <code>pNext</code> chain of <a href=\"#VkSubpassDescription2\">VkSubpassDescription2</a>, each render pass attachment in <a href=\"#VkRenderPassCreateInfo2\">VkRenderPassCreateInfo2</a>::<code>pAttachments</code> that is referenced by this subpass <strong class=\"purple\">must</strong> have a format that supports the sample count specified in <code>rasterizationSamples</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMultisampledRenderToSingleSampledInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_MULTISAMPLED_RENDER_TO_SINGLE_SAMPLED_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMultisampledRenderToSingleSampledInfoEXT-rasterizationSamples-parameter",
|
|
"text": " <code>rasterizationSamples</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSampleCountFlagBits\">VkSampleCountFlagBits</a> value"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_create_renderpass2)+(VK_EXT_multisampled_render_to_single_sampled)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)": [
|
|
{
|
|
"vuid": "VUID-VkMultisampledRenderToSingleSampledInfoEXT-pNext-06880",
|
|
"text": " If added to the <code>pNext</code> chain of <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>, each <code>imageView</code> member of any element of <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pColorAttachments</code>, <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment</code>, or <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment</code> that is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> <strong class=\"purple\">must</strong> have a format that supports the sample count specified in <code>rasterizationSamples</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkAttachmentReference2": {
|
|
"(VK_VERSION_1_2,VK_KHR_create_renderpass2)": [
|
|
{
|
|
"vuid": "VUID-VkAttachmentReference2-layout-03077",
|
|
"text": " If <code>attachment</code> is not <code>VK_ATTACHMENT_UNUSED</code>, <code>layout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_UNDEFINED</code>, <code>VK_IMAGE_LAYOUT_PREINITIALIZED</code>, or <code>VK_IMAGE_LAYOUT_PRESENT_SRC_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentReference2-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_ATTACHMENT_REFERENCE_2</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentReference2-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkAttachmentReferenceStencilLayout\">VkAttachmentReferenceStencilLayout</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentReference2-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentReference2-layout-parameter",
|
|
"text": " <code>layout</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageLayout\">VkImageLayout</a> value"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_create_renderpass2)+(VK_VERSION_1_2,VK_KHR_separate_depth_stencil_layouts)": [
|
|
{
|
|
"vuid": "VUID-VkAttachmentReference2-separateDepthStencilLayouts-03313",
|
|
"text": " If the <a href=\"#features-separateDepthStencilLayouts\"><code>separateDepthStencilLayouts</code></a> feature is not enabled, and <code>attachment</code> is not <code>VK_ATTACHMENT_UNUSED</code>, <code>layout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_STENCIL_ATTACHMENT_OPTIMAL</code>, or <code>VK_IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL</code>,"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_create_renderpass2)+(VK_KHR_synchronization2)": [
|
|
{
|
|
"vuid": "VUID-VkAttachmentReference2-synchronization2-06910",
|
|
"text": " If the <a href=\"#features-synchronization2\"><code>synchronization2</code></a> feature is not enabled, <code>layout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_ATTACHMENT_OPTIMAL_KHR</code> or <code>VK_IMAGE_LAYOUT_READ_ONLY_OPTIMAL_KHR</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkAttachmentReferenceStencilLayout": {
|
|
"(VK_VERSION_1_2,VK_KHR_create_renderpass2)+(VK_VERSION_1_2,VK_KHR_separate_depth_stencil_layouts)": [
|
|
{
|
|
"vuid": "VUID-VkAttachmentReferenceStencilLayout-stencilLayout-03318",
|
|
"text": " <code>stencilLayout</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_LAYOUT_UNDEFINED</code>, <code>VK_IMAGE_LAYOUT_PREINITIALIZED</code>, <code>VK_IMAGE_LAYOUT_COLOR_ATTACHMENT_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_ATTACHMENT_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_STENCIL_READ_ONLY_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_STENCIL_ATTACHMENT_OPTIMAL</code>, or <code>VK_IMAGE_LAYOUT_PRESENT_SRC_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentReferenceStencilLayout-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_ATTACHMENT_REFERENCE_STENCIL_LAYOUT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentReferenceStencilLayout-stencilLayout-parameter",
|
|
"text": " <code>stencilLayout</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageLayout\">VkImageLayout</a> value"
|
|
}
|
|
]
|
|
},
|
|
"VkSubpassDependency2": {
|
|
"(VK_VERSION_1_2,VK_KHR_create_renderpass2)": [
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency2-srcStageMask-04090",
|
|
"text": " If the <a href=\"#features-geometryShader\"><code>geometryShader</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_GEOMETRY_SHADER_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency2-srcStageMask-04091",
|
|
"text": " If the <a href=\"#features-tessellationShader\"><code>tessellationShader</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_TESSELLATION_CONTROL_SHADER_BIT</code> or <code>VK_PIPELINE_STAGE_TESSELLATION_EVALUATION_SHADER_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency2-dstStageMask-04090",
|
|
"text": " If the <a href=\"#features-geometryShader\"><code>geometryShader</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_GEOMETRY_SHADER_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency2-dstStageMask-04091",
|
|
"text": " If the <a href=\"#features-tessellationShader\"><code>tessellationShader</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_TESSELLATION_CONTROL_SHADER_BIT</code> or <code>VK_PIPELINE_STAGE_TESSELLATION_EVALUATION_SHADER_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency2-srcSubpass-03084",
|
|
"text": " <code>srcSubpass</code> <strong class=\"purple\">must</strong> be less than or equal to <code>dstSubpass</code>, unless one of them is <code>VK_SUBPASS_EXTERNAL</code>, to avoid cyclic dependencies and ensure a valid execution order"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency2-srcSubpass-03085",
|
|
"text": " <code>srcSubpass</code> and <code>dstSubpass</code> <strong class=\"purple\">must</strong> not both be equal to <code>VK_SUBPASS_EXTERNAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency2-srcSubpass-06810",
|
|
"text": " If <code>srcSubpass</code> is equal to <code>dstSubpass</code> and <code>srcStageMask</code> includes a <a href=\"#synchronization-framebuffer-regions\">framebuffer-space stage</a>, <code>dstStageMask</code> <strong class=\"purple\">must</strong> only contain <a href=\"#synchronization-framebuffer-regions\">framebuffer-space stages</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency2-srcAccessMask-03088",
|
|
"text": " Any access flag included in <code>srcAccessMask</code> <strong class=\"purple\">must</strong> be supported by one of the pipeline stages in <code>srcStageMask</code>, as specified in the <a href=\"#synchronization-access-types-supported\">table of supported access types</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency2-dstAccessMask-03089",
|
|
"text": " Any access flag included in <code>dstAccessMask</code> <strong class=\"purple\">must</strong> be supported by one of the pipeline stages in <code>dstStageMask</code>, as specified in the <a href=\"#synchronization-access-types-supported\">table of supported access types</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency2-dependencyFlags-03090",
|
|
"text": " If <code>dependencyFlags</code> includes <code>VK_DEPENDENCY_VIEW_LOCAL_BIT</code>, <code>srcSubpass</code> <strong class=\"purple\">must</strong> not be equal to <code>VK_SUBPASS_EXTERNAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency2-dependencyFlags-03091",
|
|
"text": " If <code>dependencyFlags</code> includes <code>VK_DEPENDENCY_VIEW_LOCAL_BIT</code>, <code>dstSubpass</code> <strong class=\"purple\">must</strong> not be equal to <code>VK_SUBPASS_EXTERNAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency2-srcSubpass-02245",
|
|
"text": " If <code>srcSubpass</code> equals <code>dstSubpass</code>, and <code>srcStageMask</code> and <code>dstStageMask</code> both include a <a href=\"#synchronization-framebuffer-regions\">framebuffer-space stage</a>, then <code>dependencyFlags</code> <strong class=\"purple\">must</strong> include <code>VK_DEPENDENCY_BY_REGION_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency2-viewOffset-02530",
|
|
"text": " If <code>viewOffset</code> is not equal to <code>0</code>, <code>srcSubpass</code> <strong class=\"purple\">must</strong> not be equal to <code>dstSubpass</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency2-dependencyFlags-03092",
|
|
"text": " If <code>dependencyFlags</code> does not include <code>VK_DEPENDENCY_VIEW_LOCAL_BIT</code>, <code>viewOffset</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency2-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_SUBPASS_DEPENDENCY_2</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency2-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkMemoryBarrier2\">VkMemoryBarrier2</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency2-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency2-srcStageMask-parameter",
|
|
"text": " <code>srcStageMask</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkPipelineStageFlagBits\">VkPipelineStageFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency2-dstStageMask-parameter",
|
|
"text": " <code>dstStageMask</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkPipelineStageFlagBits\">VkPipelineStageFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency2-srcAccessMask-parameter",
|
|
"text": " <code>srcAccessMask</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkAccessFlagBits\">VkAccessFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency2-dstAccessMask-parameter",
|
|
"text": " <code>dstAccessMask</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkAccessFlagBits\">VkAccessFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency2-dependencyFlags-parameter",
|
|
"text": " <code>dependencyFlags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkDependencyFlagBits\">VkDependencyFlagBits</a> values"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_create_renderpass2)+(VK_EXT_conditional_rendering)": [
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency2-srcStageMask-04092",
|
|
"text": " If the <a href=\"#features-conditionalRendering\"><code>conditionalRendering</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_CONDITIONAL_RENDERING_BIT_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency2-dstStageMask-04092",
|
|
"text": " If the <a href=\"#features-conditionalRendering\"><code>conditionalRendering</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_CONDITIONAL_RENDERING_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_create_renderpass2)+(VK_EXT_fragment_density_map)": [
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency2-srcStageMask-04093",
|
|
"text": " If the <a href=\"#features-fragmentDensityMap\"><code>fragmentDensityMap</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_FRAGMENT_DENSITY_PROCESS_BIT_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency2-dstStageMask-04093",
|
|
"text": " If the <a href=\"#features-fragmentDensityMap\"><code>fragmentDensityMap</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_FRAGMENT_DENSITY_PROCESS_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_create_renderpass2)+(VK_EXT_transform_feedback)": [
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency2-srcStageMask-04094",
|
|
"text": " If the <a href=\"#features-transformFeedback\"><code>transformFeedback</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_TRANSFORM_FEEDBACK_BIT_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency2-dstStageMask-04094",
|
|
"text": " If the <a href=\"#features-transformFeedback\"><code>transformFeedback</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_TRANSFORM_FEEDBACK_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_create_renderpass2)+(VK_NV_mesh_shader)": [
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency2-srcStageMask-04095",
|
|
"text": " If the <a href=\"#features-meshShader\"><code>meshShader</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_MESH_SHADER_BIT_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency2-srcStageMask-04096",
|
|
"text": " If the <a href=\"#features-taskShader\"><code>taskShader</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_TASK_SHADER_BIT_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency2-dstStageMask-04095",
|
|
"text": " If the <a href=\"#features-meshShader\"><code>meshShader</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_MESH_SHADER_BIT_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency2-dstStageMask-04096",
|
|
"text": " If the <a href=\"#features-taskShader\"><code>taskShader</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_TASK_SHADER_BIT_NV</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_create_renderpass2)+(VK_NV_shading_rate_image)": [
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency2-srcStageMask-04097",
|
|
"text": " If the <a href=\"#features-shadingRateImage\"><code>shadingRateImage</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_SHADING_RATE_IMAGE_BIT_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency2-dstStageMask-04097",
|
|
"text": " If the <a href=\"#features-shadingRateImage\"><code>shadingRateImage</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_SHADING_RATE_IMAGE_BIT_NV</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_create_renderpass2)+(VK_VERSION_1_3,VK_KHR_synchronization2)": [
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency2-srcStageMask-03937",
|
|
"text": " If the <a href=\"#features-synchronization2\"><code>synchronization2</code></a> feature is not enabled, pname:srcStageMask <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency2-dstStageMask-03937",
|
|
"text": " If the <a href=\"#features-synchronization2\"><code>synchronization2</code></a> feature is not enabled, pname:dstStageMask <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_create_renderpass2)+!(VK_VERSION_1_3,VK_KHR_synchronization2)": [
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency2-srcStageMask-04996",
|
|
"text": " pname:srcStageMask <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassDependency2-dstStageMask-04996",
|
|
"text": " pname:dstStageMask <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkDestroyRenderPass": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkDestroyRenderPass-renderPass-00873",
|
|
"text": " All submitted commands that refer to <code>renderPass</code> <strong class=\"purple\">must</strong> have completed execution"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyRenderPass-renderPass-00874",
|
|
"text": " If <code>VkAllocationCallbacks</code> were provided when <code>renderPass</code> was created, a compatible set of callbacks <strong class=\"purple\">must</strong> be provided here"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyRenderPass-renderPass-00875",
|
|
"text": " If no <code>VkAllocationCallbacks</code> were provided when <code>renderPass</code> was created, <code>pAllocator</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyRenderPass-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyRenderPass-renderPass-parameter",
|
|
"text": " If <code>renderPass</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>renderPass</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkRenderPass\">VkRenderPass</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyRenderPass-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyRenderPass-renderPass-parent",
|
|
"text": " If <code>renderPass</code> is a valid handle, it <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCreateFramebuffer": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCreateFramebuffer-pCreateInfo-02777",
|
|
"text": " If <code>pCreateInfo->flags</code> does not include <code>VK_FRAMEBUFFER_CREATE_IMAGELESS_BIT</code>, and <code>attachmentCount</code> is not <code>0</code>, each element of <code>pCreateInfo->pAttachments</code> <strong class=\"purple\">must</strong> have been created on <code>device</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateFramebuffer-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateFramebuffer-pCreateInfo-parameter",
|
|
"text": " <code>pCreateInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkFramebufferCreateInfo\">VkFramebufferCreateInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateFramebuffer-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateFramebuffer-pFramebuffer-parameter",
|
|
"text": " <code>pFramebuffer</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkFramebuffer\">VkFramebuffer</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkFramebufferCreateInfo": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkFramebufferCreateInfo-attachmentCount-00876",
|
|
"text": " <code>attachmentCount</code> <strong class=\"purple\">must</strong> be equal to the attachment count specified in <code>renderPass</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFramebufferCreateInfo-flags-02778",
|
|
"text": " If <code>flags</code> does not include <code>VK_FRAMEBUFFER_CREATE_IMAGELESS_BIT</code> and <code>attachmentCount</code> is not <code>0</code>, <code>pAttachments</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>attachmentCount</code> valid <a href=\"#VkImageView\">VkImageView</a> handles"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFramebufferCreateInfo-pAttachments-00877",
|
|
"text": " If <code>flags</code> does not include <code>VK_FRAMEBUFFER_CREATE_IMAGELESS_BIT</code>, each element of <code>pAttachments</code> that is used as a color attachment or resolve attachment by <code>renderPass</code> <strong class=\"purple\">must</strong> have been created with a <code>usage</code> value including <code>VK_IMAGE_USAGE_COLOR_ATTACHMENT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFramebufferCreateInfo-pAttachments-02633",
|
|
"text": " If <code>flags</code> does not include <code>VK_FRAMEBUFFER_CREATE_IMAGELESS_BIT</code>, each element of <code>pAttachments</code> that is used as a depth/stencil attachment by <code>renderPass</code> <strong class=\"purple\">must</strong> have been created with a <code>usage</code> value including <code>VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFramebufferCreateInfo-pAttachments-00879",
|
|
"text": " If <code>renderpass</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>flags</code> does not include <code>VK_FRAMEBUFFER_CREATE_IMAGELESS_BIT</code>, each element of <code>pAttachments</code> that is used as an input attachment by <code>renderPass</code> <strong class=\"purple\">must</strong> have been created with a <code>usage</code> value including <code>VK_IMAGE_USAGE_INPUT_ATTACHMENT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFramebufferCreateInfo-pAttachments-00880",
|
|
"text": " If <code>flags</code> does not include <code>VK_FRAMEBUFFER_CREATE_IMAGELESS_BIT</code>, each element of <code>pAttachments</code> <strong class=\"purple\">must</strong> have been created with a <a href=\"#VkFormat\">VkFormat</a> value that matches the <a href=\"#VkFormat\">VkFormat</a> specified by the corresponding <code>VkAttachmentDescription</code> in <code>renderPass</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFramebufferCreateInfo-pAttachments-00881",
|
|
"text": " If <code>flags</code> does not include <code>VK_FRAMEBUFFER_CREATE_IMAGELESS_BIT</code>, each element of <code>pAttachments</code> <strong class=\"purple\">must</strong> have been created with a <code>samples</code> value that matches the <code>samples</code> value specified by the corresponding <code>VkAttachmentDescription</code> in <code>renderPass</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFramebufferCreateInfo-flags-04533",
|
|
"text": " If <code>flags</code> does not include <code>VK_FRAMEBUFFER_CREATE_IMAGELESS_BIT</code>, each element of <code>pAttachments</code> that is used as an input, color, resolve, or depth/stencil attachment by <code>renderPass</code> <strong class=\"purple\">must</strong> have been created with a <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a>::<code>extent.width</code> greater than or equal to <code>width</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFramebufferCreateInfo-flags-04534",
|
|
"text": " If <code>flags</code> does not include <code>VK_FRAMEBUFFER_CREATE_IMAGELESS_BIT</code>, each element of <code>pAttachments</code> that is used as an input, color, resolve, or depth/stencil attachment by <code>renderPass</code> <strong class=\"purple\">must</strong> have been created with a <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a>::<code>extent.height</code> greater than or equal to <code>height</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFramebufferCreateInfo-flags-04535",
|
|
"text": " If <code>flags</code> does not include <code>VK_FRAMEBUFFER_CREATE_IMAGELESS_BIT</code>, each element of <code>pAttachments</code> that is used as an input, color, resolve, or depth/stencil attachment by <code>renderPass</code> <strong class=\"purple\">must</strong> have been created with a <a href=\"#VkImageViewCreateInfo\">VkImageViewCreateInfo</a>::<code>subresourceRange.layerCount</code> greater than or equal to <code>layers</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFramebufferCreateInfo-pAttachments-00883",
|
|
"text": " If <code>flags</code> does not include <code>VK_FRAMEBUFFER_CREATE_IMAGELESS_BIT</code>, each element of <code>pAttachments</code> <strong class=\"purple\">must</strong> only specify a single mip level"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFramebufferCreateInfo-pAttachments-00884",
|
|
"text": " If <code>flags</code> does not include <code>VK_FRAMEBUFFER_CREATE_IMAGELESS_BIT</code>, each element of <code>pAttachments</code> <strong class=\"purple\">must</strong> have been created with the identity swizzle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFramebufferCreateInfo-width-00885",
|
|
"text": " <code>width</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFramebufferCreateInfo-width-00886",
|
|
"text": " <code>width</code> <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#limits-maxFramebufferWidth\"><code>maxFramebufferWidth</code></a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFramebufferCreateInfo-height-00887",
|
|
"text": " <code>height</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFramebufferCreateInfo-height-00888",
|
|
"text": " <code>height</code> <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#limits-maxFramebufferHeight\"><code>maxFramebufferHeight</code></a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFramebufferCreateInfo-layers-00889",
|
|
"text": " <code>layers</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFramebufferCreateInfo-layers-00890",
|
|
"text": " <code>layers</code> <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#limits-maxFramebufferLayers\"><code>maxFramebufferLayers</code></a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFramebufferCreateInfo-flags-04113",
|
|
"text": " If <code>flags</code> does not include <code>VK_FRAMEBUFFER_CREATE_IMAGELESS_BIT</code>, each element of <code>pAttachments</code> <strong class=\"purple\">must</strong> have been created with <a href=\"#VkImageViewCreateInfo\">VkImageViewCreateInfo</a>::<code>viewType</code> not equal to <code>VK_IMAGE_VIEW_TYPE_3D</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFramebufferCreateInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_FRAMEBUFFER_CREATE_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFramebufferCreateInfo-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkFramebufferAttachmentsCreateInfo\">VkFramebufferAttachmentsCreateInfo</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFramebufferCreateInfo-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFramebufferCreateInfo-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkFramebufferCreateFlagBits\">VkFramebufferCreateFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFramebufferCreateInfo-renderPass-parameter",
|
|
"text": " <code>renderPass</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkRenderPass\">VkRenderPass</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFramebufferCreateInfo-commonparent",
|
|
"text": " Both of <code>renderPass</code>, and the elements of <code>pAttachments</code> that are valid handles of non-ignored parameters <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_depth_stencil_resolve)": [
|
|
{
|
|
"vuid": "VUID-VkFramebufferCreateInfo-pAttachments-02634",
|
|
"text": " If <code>flags</code> does not include <code>VK_FRAMEBUFFER_CREATE_IMAGELESS_BIT</code>, each element of <code>pAttachments</code> that is used as a depth/stencil resolve attachment by <code>renderPass</code> <strong class=\"purple\">must</strong> have been created with a <code>usage</code> value including <code>VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_fragment_density_map)": [
|
|
{
|
|
"vuid": "VUID-VkFramebufferCreateInfo-pAttachments-02552",
|
|
"text": " Each element of <code>pAttachments</code> that is used as a fragment density map attachment by <code>renderPass</code> <strong class=\"purple\">must</strong> not have been created with a <code>flags</code> value including <code>VK_IMAGE_CREATE_SUBSAMPLED_BIT_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFramebufferCreateInfo-renderPass-02553",
|
|
"text": " If <code>renderPass</code> has a fragment density map attachment and the <a href=\"#features-fragmentDensityMapNonSubsampledImages\"><code>fragmentDensityMapNonSubsampledImages</code></a> feature is not enabled, each element of <code>pAttachments</code> <strong class=\"purple\">must</strong> have been created with a <code>flags</code> value including <code>VK_IMAGE_CREATE_SUBSAMPLED_BIT_EXT</code> unless that element is the fragment density map attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFramebufferCreateInfo-pAttachments-02555",
|
|
"text": " If <code>flags</code> does not include <code>VK_FRAMEBUFFER_CREATE_IMAGELESS_BIT</code>, an element of <code>pAttachments</code> that is referenced by <code>fragmentDensityMapAttachment</code> <strong class=\"purple\">must</strong> have a width at least as large as \\(\\left\\lceil{\\frac{width}{maxFragmentDensityTexelSize_{width}}}\\right\\rceil\\)"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFramebufferCreateInfo-pAttachments-02556",
|
|
"text": " If <code>flags</code> does not include <code>VK_FRAMEBUFFER_CREATE_IMAGELESS_BIT</code>, an element of <code>pAttachments</code> that is referenced by <code>fragmentDensityMapAttachment</code> <strong class=\"purple\">must</strong> have a height at least as large as \\(\\left\\lceil{\\frac{height}{maxFragmentDensityTexelSize_{height}}}\\right\\rceil\\)"
|
|
}
|
|
],
|
|
"(VK_EXT_fragment_density_map)+(VK_QCOM_fragment_density_map_offset)": [
|
|
{
|
|
"vuid": "VUID-VkFramebufferCreateInfo-renderPass-06502",
|
|
"text": " If <code>renderPass</code> was created with <a href=\"#renderpass-fragmentdensitymapoffsets\">fragment density map offsets</a> other than <span class=\"eq\">(0,0)</span>, each element of <code>pAttachments</code> <strong class=\"purple\">must</strong> have been created with a <code>flags</code> value including <code>VK_IMAGE_CREATE_FRAGMENT_DENSITY_MAP_OFFSET_BIT_QCOM</code>."
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_multiview)": [
|
|
{
|
|
"vuid": "VUID-VkFramebufferCreateInfo-renderPass-04536",
|
|
"text": " If <code>renderPass</code> was specified with non-zero view masks, each element of <code>pAttachments</code> that is used as an input, color, resolve, or depth/stencil attachment by <code>renderPass</code> <strong class=\"purple\">must</strong> have a <code>layerCount</code> greater than the index of the most significant bit set in any of those view masks"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFramebufferCreateInfo-renderPass-02531",
|
|
"text": " If <code>renderPass</code> was specified with non-zero view masks, <code>layers</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_fragment_density_map)+!(VK_VERSION_1_1,VK_KHR_multiview)": [
|
|
{
|
|
"vuid": "VUID-VkFramebufferCreateInfo-pAttachments-02744",
|
|
"text": " Each element of <code>pAttachments</code> that is referenced by <code>fragmentDensityMapAttachment</code> <strong class=\"purple\">must</strong> have a <code>layerCount</code> equal to <code>1</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_fragment_density_map)+(VK_VERSION_1_1,VK_KHR_multiview)": [
|
|
{
|
|
"vuid": "VUID-VkFramebufferCreateInfo-renderPass-02746",
|
|
"text": " If <code>renderPass</code> was specified with non-zero view masks, each element of <code>pAttachments</code> that is referenced by <code>fragmentDensityMapAttachment</code> <strong class=\"purple\">must</strong> have a <code>layerCount</code> equal to <code>1</code> or greater than the index of the most significant bit set in any of those view masks"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFramebufferCreateInfo-renderPass-02747",
|
|
"text": " If <code>renderPass</code> was not specified with non-zero view masks, each element of <code>pAttachments</code> that is referenced by <code>fragmentDensityMapAttachment</code> <strong class=\"purple\">must</strong> have a <code>layerCount</code> equal to <code>1</code>"
|
|
}
|
|
],
|
|
"(VK_KHR_fragment_shading_rate)+(VK_VERSION_1_1,VK_KHR_multiview)": [
|
|
{
|
|
"vuid": "VUID-VkFramebufferCreateInfo-flags-04537",
|
|
"text": " If <code>flags</code> does not include <code>VK_FRAMEBUFFER_CREATE_IMAGELESS_BIT</code>, and <code>renderPass</code> was specified with non-zero view masks, each element of <code>pAttachments</code> that is used as a <a href=\"#primsrast-fragment-shading-rate-attachment\">fragment shading rate attachment</a> by <code>renderPass</code> <strong class=\"purple\">must</strong> have a <code>layerCount</code> that is either <code>1</code>, or greater than the index of the most significant bit set in any of those view masks"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFramebufferCreateInfo-flags-04538",
|
|
"text": " If <code>flags</code> does not include <code>VK_FRAMEBUFFER_CREATE_IMAGELESS_BIT</code>, and <code>renderPass</code> was not specified with non-zero view masks, each element of <code>pAttachments</code> that is used as a <a href=\"#primsrast-fragment-shading-rate-attachment\">fragment shading rate attachment</a> by <code>renderPass</code> <strong class=\"purple\">must</strong> have a <code>layerCount</code> that is either <code>1</code>, or greater than <code>layers</code>"
|
|
}
|
|
],
|
|
"(VK_KHR_fragment_shading_rate)": [
|
|
{
|
|
"vuid": "VUID-VkFramebufferCreateInfo-flags-04539",
|
|
"text": " If <code>flags</code> does not include <code>VK_FRAMEBUFFER_CREATE_IMAGELESS_BIT</code>, an element of <code>pAttachments</code> that is used as a <a href=\"#primsrast-fragment-shading-rate-attachment\">fragment shading rate attachment</a> <strong class=\"purple\">must</strong> have a width at least as large as <span class=\"eq\">{lceil}<code>width</code> / <code>texelWidth</code>{rceil}</span>, where <code>texelWidth</code> is the largest value of <code>shadingRateAttachmentTexelSize.width</code> in a <a href=\"#VkFragmentShadingRateAttachmentInfoKHR\">VkFragmentShadingRateAttachmentInfoKHR</a> which references that attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFramebufferCreateInfo-flags-04540",
|
|
"text": " If <code>flags</code> does not include <code>VK_FRAMEBUFFER_CREATE_IMAGELESS_BIT</code>, an element of <code>pAttachments</code> that is used as a <a href=\"#primsrast-fragment-shading-rate-attachment\">fragment shading rate attachment</a> <strong class=\"purple\">must</strong> have a height at least as large as <span class=\"eq\">{lceil}<code>height</code> / <code>texelHeight</code>{rceil}</span>, where <code>texelHeight</code> is the largest value of <code>shadingRateAttachmentTexelSize.height</code> in a <a href=\"#VkFragmentShadingRateAttachmentInfoKHR\">VkFragmentShadingRateAttachmentInfoKHR</a> which references that attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFramebufferCreateInfo-flags-04548",
|
|
"text": " If <code>flags</code> does not include <code>VK_FRAMEBUFFER_CREATE_IMAGELESS_BIT</code>, each element of <code>pAttachments</code> that is used as a fragment shading rate attachment by <code>renderPass</code> <strong class=\"purple\">must</strong> have been created with a <code>usage</code> value including <code>VK_IMAGE_USAGE_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_maintenance1)": [
|
|
{
|
|
"vuid": "VUID-VkFramebufferCreateInfo-pAttachments-00891",
|
|
"text": " If <code>flags</code> does not include <code>VK_FRAMEBUFFER_CREATE_IMAGELESS_BIT</code>, each element of <code>pAttachments</code> that is a 2D or 2D array image view taken from a 3D image <strong class=\"purple\">must</strong> not be a depth/stencil format"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_imageless_framebuffer)": [
|
|
{
|
|
"vuid": "VUID-VkFramebufferCreateInfo-flags-03189",
|
|
"text": " If the <a href=\"#features-imagelessFramebuffer\"><code>imagelessFramebuffer</code></a> feature is not enabled, <code>flags</code> <strong class=\"purple\">must</strong> not include <code>VK_FRAMEBUFFER_CREATE_IMAGELESS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFramebufferCreateInfo-flags-03190",
|
|
"text": " If <code>flags</code> includes <code>VK_FRAMEBUFFER_CREATE_IMAGELESS_BIT</code>, the <code>pNext</code> chain <strong class=\"purple\">must</strong> include a <a href=\"#VkFramebufferAttachmentsCreateInfo\">VkFramebufferAttachmentsCreateInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFramebufferCreateInfo-flags-03191",
|
|
"text": " If <code>flags</code> includes <code>VK_FRAMEBUFFER_CREATE_IMAGELESS_BIT</code>, the <code>attachmentImageInfoCount</code> member of a <a href=\"#VkFramebufferAttachmentsCreateInfo\">VkFramebufferAttachmentsCreateInfo</a> structure in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be equal to either zero or <code>attachmentCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFramebufferCreateInfo-flags-04541",
|
|
"text": " If <code>flags</code> includes <code>VK_FRAMEBUFFER_CREATE_IMAGELESS_BIT</code>, the <code>width</code> member of any element of the <code>pAttachmentImageInfos</code> member of a <a href=\"#VkFramebufferAttachmentsCreateInfo\">VkFramebufferAttachmentsCreateInfo</a> structure in the <code>pNext</code> chain that is used as an input, color, resolve or depth/stencil attachment in <code>renderPass</code> <strong class=\"purple\">must</strong> be greater than or equal to <code>width</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFramebufferCreateInfo-flags-04542",
|
|
"text": " If <code>flags</code> includes <code>VK_FRAMEBUFFER_CREATE_IMAGELESS_BIT</code>, the <code>height</code> member of any element of the <code>pAttachmentImageInfos</code> member of a <a href=\"#VkFramebufferAttachmentsCreateInfo\">VkFramebufferAttachmentsCreateInfo</a> structure in the <code>pNext</code> chain that is used as an input, color, resolve or depth/stencil attachment in <code>renderPass</code> <strong class=\"purple\">must</strong> be greater than or equal to <code>height</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFramebufferCreateInfo-flags-03201",
|
|
"text": " If <code>flags</code> includes <code>VK_FRAMEBUFFER_CREATE_IMAGELESS_BIT</code>, the <code>usage</code> member of any element of the <code>pAttachmentImageInfos</code> member of a <a href=\"#VkFramebufferAttachmentsCreateInfo\">VkFramebufferAttachmentsCreateInfo</a> structure included in the <code>pNext</code> chain that refers to an attachment used as a color attachment or resolve attachment by <code>renderPass</code> <strong class=\"purple\">must</strong> include <code>VK_IMAGE_USAGE_COLOR_ATTACHMENT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFramebufferCreateInfo-flags-03202",
|
|
"text": " If <code>flags</code> includes <code>VK_FRAMEBUFFER_CREATE_IMAGELESS_BIT</code>, the <code>usage</code> member of any element of the <code>pAttachmentImageInfos</code> member of a <a href=\"#VkFramebufferAttachmentsCreateInfo\">VkFramebufferAttachmentsCreateInfo</a> structure included in the <code>pNext</code> chain that refers to an attachment used as a depth/stencil attachment by <code>renderPass</code> <strong class=\"purple\">must</strong> include <code>VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFramebufferCreateInfo-flags-03204",
|
|
"text": " If <code>flags</code> includes <code>VK_FRAMEBUFFER_CREATE_IMAGELESS_BIT</code>, the <code>usage</code> member of any element of the <code>pAttachmentImageInfos</code> member of a <a href=\"#VkFramebufferAttachmentsCreateInfo\">VkFramebufferAttachmentsCreateInfo</a> structure included in the <code>pNext</code> chain that refers to an attachment used as an input attachment by <code>renderPass</code> <strong class=\"purple\">must</strong> include <code>VK_IMAGE_USAGE_INPUT_ATTACHMENT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFramebufferCreateInfo-flags-03205",
|
|
"text": " If <code>flags</code> includes <code>VK_FRAMEBUFFER_CREATE_IMAGELESS_BIT</code>, at least one element of the <code>pViewFormats</code> member of any element of the <code>pAttachmentImageInfos</code> member of a <a href=\"#VkFramebufferAttachmentsCreateInfo\">VkFramebufferAttachmentsCreateInfo</a> structure included in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be equal to the corresponding value of <a href=\"#VkAttachmentDescription\">VkAttachmentDescription</a>::<code>format</code> used to create <code>renderPass</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_imageless_framebuffer)+(VK_EXT_fragment_density_map)": [
|
|
{
|
|
"vuid": "VUID-VkFramebufferCreateInfo-flags-03196",
|
|
"text": " If <code>flags</code> includes <code>VK_FRAMEBUFFER_CREATE_IMAGELESS_BIT</code>, the <code>width</code> member of any element of the <code>pAttachmentImageInfos</code> member of a <a href=\"#VkFramebufferAttachmentsCreateInfo\">VkFramebufferAttachmentsCreateInfo</a> structure in the <code>pNext</code> chain that is referenced by <a href=\"#VkRenderPassFragmentDensityMapCreateInfoEXT\">VkRenderPassFragmentDensityMapCreateInfoEXT</a>::<code>fragmentDensityMapAttachment</code> in <code>renderPass</code> <strong class=\"purple\">must</strong> be greater than or equal to \\(\\left\\lceil{\\frac{width}{maxFragmentDensityTexelSize_{width}}}\\right\\rceil\\)"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFramebufferCreateInfo-flags-03197",
|
|
"text": " If <code>flags</code> includes <code>VK_FRAMEBUFFER_CREATE_IMAGELESS_BIT</code>, the <code>height</code> member of any element of the <code>pAttachmentImageInfos</code> member of a <a href=\"#VkFramebufferAttachmentsCreateInfo\">VkFramebufferAttachmentsCreateInfo</a> structure included in the <code>pNext</code> chain that is referenced by <a href=\"#VkRenderPassFragmentDensityMapCreateInfoEXT\">VkRenderPassFragmentDensityMapCreateInfoEXT</a>::<code>fragmentDensityMapAttachment</code> in <code>renderPass</code> <strong class=\"purple\">must</strong> be greater than or equal to \\(\\left\\lceil{\\frac{height}{maxFragmentDensityTexelSize_{height}}}\\right\\rceil\\)"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_imageless_framebuffer)+(VK_KHR_fragment_shading_rate)": [
|
|
{
|
|
"vuid": "VUID-VkFramebufferCreateInfo-flags-04543",
|
|
"text": " If <code>flags</code> includes <code>VK_FRAMEBUFFER_CREATE_IMAGELESS_BIT</code>, the <code>width</code> member of any element of the <code>pAttachmentImageInfos</code> member of a <a href=\"#VkFramebufferAttachmentsCreateInfo\">VkFramebufferAttachmentsCreateInfo</a> structure in the <code>pNext</code> chain that is used as a <a href=\"#primsrast-fragment-shading-rate-attachment\">fragment shading rate attachment</a> <strong class=\"purple\">must</strong> be greater than or equal to <span class=\"eq\">{lceil}<code>width</code> / <code>texelWidth</code>{rceil}</span>, where <code>texelWidth</code> is the largest value of <code>shadingRateAttachmentTexelSize.width</code> in a <a href=\"#VkFragmentShadingRateAttachmentInfoKHR\">VkFragmentShadingRateAttachmentInfoKHR</a> which references that attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFramebufferCreateInfo-flags-04544",
|
|
"text": " If <code>flags</code> includes <code>VK_FRAMEBUFFER_CREATE_IMAGELESS_BIT</code>, the <code>height</code> member of any element of the <code>pAttachmentImageInfos</code> member of a <a href=\"#VkFramebufferAttachmentsCreateInfo\">VkFramebufferAttachmentsCreateInfo</a> structure in the <code>pNext</code> chain that is used as a <a href=\"#primsrast-fragment-shading-rate-attachment\">fragment shading rate attachment</a> <strong class=\"purple\">must</strong> be greater than or equal to <span class=\"eq\">{lceil}<code>height</code> / <code>texelHeight</code>{rceil}</span>, where <code>texelHeight</code> is the largest value of <code>shadingRateAttachmentTexelSize.height</code> in a <a href=\"#VkFragmentShadingRateAttachmentInfoKHR\">VkFragmentShadingRateAttachmentInfoKHR</a> which references that attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFramebufferCreateInfo-flags-04545",
|
|
"text": " If <code>flags</code> includes <code>VK_FRAMEBUFFER_CREATE_IMAGELESS_BIT</code>, the <code>layerCount</code> member of any element of the <code>pAttachmentImageInfos</code> member of a <a href=\"#VkFramebufferAttachmentsCreateInfo\">VkFramebufferAttachmentsCreateInfo</a> structure in the <code>pNext</code> chain that is used as a <a href=\"#primsrast-fragment-shading-rate-attachment\">fragment shading rate attachment</a> <strong class=\"purple\">must</strong> be either <code>1</code>, or greater than or equal to <code>layers</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFramebufferCreateInfo-flags-04587",
|
|
"text": " If <code>flags</code> includes <code>VK_FRAMEBUFFER_CREATE_IMAGELESS_BIT</code> and <code>renderPass</code> was specified with non-zero view masks, each element of <code>pAttachments</code> that is used as a <a href=\"#primsrast-fragment-shading-rate-attachment\">fragment shading rate attachment</a> by <code>renderPass</code> <strong class=\"purple\">must</strong> have a <code>layerCount</code> that is either <code>1</code>, or greater than the index of the most significant bit set in any of those view masks"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_imageless_framebuffer)+(VK_VERSION_1_1,VK_KHR_multiview)": [
|
|
{
|
|
"vuid": "VUID-VkFramebufferCreateInfo-renderPass-03198",
|
|
"text": " If multiview is enabled for <code>renderPass</code> and <code>flags</code> includes <code>VK_FRAMEBUFFER_CREATE_IMAGELESS_BIT</code>, the <code>layerCount</code> member of any element of the <code>pAttachmentImageInfos</code> member of a <a href=\"#VkFramebufferAttachmentsCreateInfo\">VkFramebufferAttachmentsCreateInfo</a> structure included in the <code>pNext</code> chain used as an input, color, resolve, or depth/stencil attachment in <code>renderPass</code> <strong class=\"purple\">must</strong> be greater than the maximum bit index set in the view mask in the subpasses in which it is used in <code>renderPass</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFramebufferCreateInfo-renderPass-04546",
|
|
"text": " If multiview is not enabled for <code>renderPass</code> and <code>flags</code> includes <code>VK_FRAMEBUFFER_CREATE_IMAGELESS_BIT</code>, the <code>layerCount</code> member of any element of the <code>pAttachmentImageInfos</code> member of a <a href=\"#VkFramebufferAttachmentsCreateInfo\">VkFramebufferAttachmentsCreateInfo</a> structure included in the <code>pNext</code> chain used as an input, color, resolve, or depth/stencil attachment in <code>renderPass</code> <strong class=\"purple\">must</strong> be greater than or equal to <code>layers</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_imageless_framebuffer)+!(VK_VERSION_1_1,VK_KHR_multiview)": [
|
|
{
|
|
"vuid": "VUID-VkFramebufferCreateInfo-flags-04547",
|
|
"text": " If <code>flags</code> includes <code>VK_FRAMEBUFFER_CREATE_IMAGELESS_BIT</code>, the <code>layerCount</code> member of any element of the <code>pAttachmentImageInfos</code> member of a <a href=\"#VkFramebufferAttachmentsCreateInfo\">VkFramebufferAttachmentsCreateInfo</a> structure included in the <code>pNext</code> chain used as an input, color, resolve, or depth/stencil attachment in <code>pRenderPass</code> <strong class=\"purple\">must</strong> be greater than or equal to <code>layers</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_imageless_framebuffer)+(VK_KHR_depth_stencil_resolve)": [
|
|
{
|
|
"vuid": "VUID-VkFramebufferCreateInfo-flags-03203",
|
|
"text": " If <code>flags</code> includes <code>VK_FRAMEBUFFER_CREATE_IMAGELESS_BIT</code>, the <code>usage</code> member of any element of the <code>pAttachmentImageInfos</code> member of a <a href=\"#VkFramebufferAttachmentsCreateInfo\">VkFramebufferAttachmentsCreateInfo</a> structure included in the <code>pNext</code> chain that refers to an attachment used as a depth/stencil resolve attachment by <code>renderPass</code> <strong class=\"purple\">must</strong> include <code>VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_KHR_fragment_shading_rate)+(VK_VERSION_1_2,VK_KHR_imageless_framebuffer)": [
|
|
{
|
|
"vuid": "VUID-VkFramebufferCreateInfo-flags-04549",
|
|
"text": " If <code>flags</code> includes <code>VK_FRAMEBUFFER_CREATE_IMAGELESS_BIT</code>, the <code>usage</code> member of any element of the <code>pAttachmentImageInfos</code> member of a <a href=\"#VkFramebufferAttachmentsCreateInfo\">VkFramebufferAttachmentsCreateInfo</a> structure included in the <code>pNext</code> chain that refers to an attachment used as a fragment shading rate attachment by <code>renderPass</code> <strong class=\"purple\">must</strong> include <code>VK_IMAGE_USAGE_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_multisampled_render_to_single_sampled)": [
|
|
{
|
|
"vuid": "VUID-VkFramebufferCreateInfo-samples-06881",
|
|
"text": " If <a href=\"#subpass-multisampledrendertosinglesampled\">multisampled-render-to-single-sampled</a> is enabled for any subpass, all color, depth/stencil and input attachments used in that subpass which have <code>VkAttachmentDescription</code>::<code>samples</code> or <code>VkAttachmentDescription2</code>::<code>samples</code> equal to <code>VK_SAMPLE_COUNT_1_BIT</code> <strong class=\"purple\">must</strong> have been created with <code>VK_IMAGE_CREATE_MULTISAMPLED_RENDER_TO_SINGLE_SAMPLED_BIT_EXT</code> in their <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a>::<code>flags</code>."
|
|
}
|
|
]
|
|
},
|
|
"VkFramebufferAttachmentsCreateInfo": {
|
|
"(VK_VERSION_1_2,VK_KHR_imageless_framebuffer)": [
|
|
{
|
|
"vuid": "VUID-VkFramebufferAttachmentsCreateInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_FRAMEBUFFER_ATTACHMENTS_CREATE_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFramebufferAttachmentsCreateInfo-pAttachmentImageInfos-parameter",
|
|
"text": " If <code>attachmentImageInfoCount</code> is not <code>0</code>, <code>pAttachmentImageInfos</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>attachmentImageInfoCount</code> valid <a href=\"#VkFramebufferAttachmentImageInfo\">VkFramebufferAttachmentImageInfo</a> structures"
|
|
}
|
|
]
|
|
},
|
|
"VkFramebufferAttachmentImageInfo": {
|
|
"(VK_VERSION_1_2,VK_KHR_imageless_framebuffer)": [
|
|
{
|
|
"vuid": "VUID-VkFramebufferAttachmentImageInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_FRAMEBUFFER_ATTACHMENT_IMAGE_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFramebufferAttachmentImageInfo-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFramebufferAttachmentImageInfo-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkImageCreateFlagBits\">VkImageCreateFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFramebufferAttachmentImageInfo-usage-parameter",
|
|
"text": " <code>usage</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkImageUsageFlagBits\">VkImageUsageFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFramebufferAttachmentImageInfo-usage-requiredbitmask",
|
|
"text": " <code>usage</code> <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFramebufferAttachmentImageInfo-pViewFormats-parameter",
|
|
"text": " If <code>viewFormatCount</code> is not <code>0</code>, <code>pViewFormats</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>viewFormatCount</code> valid <a href=\"#VkFormat\">VkFormat</a> values"
|
|
}
|
|
]
|
|
},
|
|
"vkDestroyFramebuffer": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkDestroyFramebuffer-framebuffer-00892",
|
|
"text": " All submitted commands that refer to <code>framebuffer</code> <strong class=\"purple\">must</strong> have completed execution"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyFramebuffer-framebuffer-00893",
|
|
"text": " If <code>VkAllocationCallbacks</code> were provided when <code>framebuffer</code> was created, a compatible set of callbacks <strong class=\"purple\">must</strong> be provided here"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyFramebuffer-framebuffer-00894",
|
|
"text": " If no <code>VkAllocationCallbacks</code> were provided when <code>framebuffer</code> was created, <code>pAllocator</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyFramebuffer-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyFramebuffer-framebuffer-parameter",
|
|
"text": " If <code>framebuffer</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>framebuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkFramebuffer\">VkFramebuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyFramebuffer-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyFramebuffer-framebuffer-parent",
|
|
"text": " If <code>framebuffer</code> is a valid handle, it <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdBeginRenderPass": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCmdBeginRenderPass-initialLayout-00895",
|
|
"text": " If any of the <code>initialLayout</code> or <code>finalLayout</code> member of the <code>VkAttachmentDescription</code> structures or the <code>layout</code> member of the <code>VkAttachmentReference</code> structures specified when creating the render pass specified in the <code>renderPass</code> member of <code>pRenderPassBegin</code> is <code>VK_IMAGE_LAYOUT_COLOR_ATTACHMENT_OPTIMAL</code> then the corresponding attachment image view of the framebuffer specified in the <code>framebuffer</code> member of <code>pRenderPassBegin</code> <strong class=\"purple\">must</strong> have been created with a <code>usage</code> value including <code>VK_IMAGE_USAGE_COLOR_ATTACHMENT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginRenderPass-initialLayout-00897",
|
|
"text": " If any of the <code>initialLayout</code> or <code>finalLayout</code> member of the <code>VkAttachmentDescription</code> structures or the <code>layout</code> member of the <code>VkAttachmentReference</code> structures specified when creating the render pass specified in the <code>renderPass</code> member of <code>pRenderPassBegin</code> is <code>VK_IMAGE_LAYOUT_SHADER_READ_ONLY_OPTIMAL</code> then the corresponding attachment image view of the framebuffer specified in the <code>framebuffer</code> member of <code>pRenderPassBegin</code> <strong class=\"purple\">must</strong> have been created with a <code>usage</code> value including <code>VK_IMAGE_USAGE_SAMPLED_BIT</code> or <code>VK_IMAGE_USAGE_INPUT_ATTACHMENT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginRenderPass-initialLayout-00898",
|
|
"text": " If any of the <code>initialLayout</code> or <code>finalLayout</code> member of the <code>VkAttachmentDescription</code> structures or the <code>layout</code> member of the <code>VkAttachmentReference</code> structures specified when creating the render pass specified in the <code>renderPass</code> member of <code>pRenderPassBegin</code> is <code>VK_IMAGE_LAYOUT_TRANSFER_SRC_OPTIMAL</code> then the corresponding attachment image view of the framebuffer specified in the <code>framebuffer</code> member of <code>pRenderPassBegin</code> <strong class=\"purple\">must</strong> have been created with a <code>usage</code> value including <code>VK_IMAGE_USAGE_TRANSFER_SRC_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginRenderPass-initialLayout-00899",
|
|
"text": " If any of the <code>initialLayout</code> or <code>finalLayout</code> member of the <code>VkAttachmentDescription</code> structures or the <code>layout</code> member of the <code>VkAttachmentReference</code> structures specified when creating the render pass specified in the <code>renderPass</code> member of <code>pRenderPassBegin</code> is <code>VK_IMAGE_LAYOUT_TRANSFER_DST_OPTIMAL</code> then the corresponding attachment image view of the framebuffer specified in the <code>framebuffer</code> member of <code>pRenderPassBegin</code> <strong class=\"purple\">must</strong> have been created with a <code>usage</code> value including <code>VK_IMAGE_USAGE_TRANSFER_DST_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginRenderPass-initialLayout-00900",
|
|
"text": " If the <code>initialLayout</code> member of any of the <code>VkAttachmentDescription</code> structures specified when creating the render pass specified in the <code>renderPass</code> member of <code>pRenderPassBegin</code> is not <code>VK_IMAGE_LAYOUT_UNDEFINED</code>, then each such <code>initialLayout</code> <strong class=\"purple\">must</strong> be equal to the current layout of the corresponding attachment image subresource of the framebuffer specified in the <code>framebuffer</code> member of <code>pRenderPassBegin</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginRenderPass-srcStageMask-06451",
|
|
"text": " The <code>srcStageMask</code> members of any element of the <code>pDependencies</code> member of <a href=\"#VkRenderPassCreateInfo\">VkRenderPassCreateInfo</a> used to create <code>renderPass</code> <strong class=\"purple\">must</strong> be supported by the capabilities of the queue family identified by the <code>queueFamilyIndex</code> member of the <a href=\"#VkCommandPoolCreateInfo\">VkCommandPoolCreateInfo</a> used to create the command pool which <code>commandBuffer</code> was allocated from"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginRenderPass-dstStageMask-06452",
|
|
"text": " The <code>dstStageMask</code> members of any element of the <code>pDependencies</code> member of <a href=\"#VkRenderPassCreateInfo\">VkRenderPassCreateInfo</a> used to create <code>renderPass</code> <strong class=\"purple\">must</strong> be supported by the capabilities of the queue family identified by the <code>queueFamilyIndex</code> member of the <a href=\"#VkCommandPoolCreateInfo\">VkCommandPoolCreateInfo</a> used to create the command pool which <code>commandBuffer</code> was allocated from"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginRenderPass-framebuffer-02532",
|
|
"text": " For any attachment in <code>framebuffer</code> that is used by <code>renderPass</code> and is bound to memory locations that are also bound to another attachment used by <code>renderPass</code>, and if at least one of those uses causes either attachment to be written to, both attachments <strong class=\"purple\">must</strong> have had the <code>VK_ATTACHMENT_DESCRIPTION_MAY_ALIAS_BIT</code> set"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginRenderPass-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginRenderPass-pRenderPassBegin-parameter",
|
|
"text": " <code>pRenderPassBegin</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkRenderPassBeginInfo\">VkRenderPassBeginInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginRenderPass-contents-parameter",
|
|
"text": " <code>contents</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSubpassContents\">VkSubpassContents</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginRenderPass-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginRenderPass-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginRenderPass-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginRenderPass-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginRenderPass-bufferlevel",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a primary <code>VkCommandBuffer</code>"
|
|
}
|
|
],
|
|
"!(VK_VERSION_1_1,VK_KHR_maintenance2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBeginRenderPass-initialLayout-00896",
|
|
"text": " If any of the <code>initialLayout</code> or <code>finalLayout</code> member of the <code>VkAttachmentDescription</code> structures or the <code>layout</code> member of the <code>VkAttachmentReference</code> structures specified when creating the render pass specified in the <code>renderPass</code> member of <code>pRenderPassBegin</code> is <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_ATTACHMENT_OPTIMAL</code>, or <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL</code> then the corresponding attachment image view of the framebuffer specified in the <code>framebuffer</code> member of <code>pRenderPassBegin</code> <strong class=\"purple\">must</strong> have been created with a <code>usage</code> value including <code>VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_maintenance2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBeginRenderPass-initialLayout-01758",
|
|
"text": " If any of the <code>initialLayout</code> or <code>finalLayout</code> member of the <code>VkAttachmentDescription</code> structures or the <code>layout</code> member of the <code>VkAttachmentReference</code> structures specified when creating the render pass specified in the <code>renderPass</code> member of <code>pRenderPassBegin</code> is <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_STENCIL_ATTACHMENT_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_STENCIL_READ_ONLY_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_ATTACHMENT_OPTIMAL</code>, or <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL</code> then the corresponding attachment image view of the framebuffer specified in the <code>framebuffer</code> member of <code>pRenderPassBegin</code> <strong class=\"purple\">must</strong> have been created with a <code>usage</code> value including <code>VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_maintenance2)+(VK_VERSION_1_2,VK_KHR_separate_depth_stencil_layouts)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBeginRenderPass-initialLayout-02842",
|
|
"text": " If any of the <code>initialLayout</code> or <code>finalLayout</code> member of the <code>VkAttachmentDescription</code> structures or the <code>layout</code> member of the <code>VkAttachmentReference</code> structures specified when creating the render pass specified in the <code>renderPass</code> member of <code>pRenderPassBegin</code> is <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_OPTIMAL</code>, or <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_STENCIL_ATTACHMENT_OPTIMAL</code>, or <code>VK_IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL</code> then the corresponding attachment image view of the framebuffer specified in the <code>framebuffer</code> member of <code>pRenderPassBegin</code> <strong class=\"purple\">must</strong> have been created with a <code>usage</code> value including <code>VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginRenderPass-stencilInitialLayout-02843",
|
|
"text": " If any of the <code>stencilInitialLayout</code> or <code>stencilFinalLayout</code> member of the <code>VkAttachmentDescriptionStencilLayout</code> structures or the <code>stencilLayout</code> member of the <code>VkAttachmentReferenceStencilLayout</code> structures specified when creating the render pass specified in the <code>renderPass</code> member of <code>pRenderPassBegin</code> is <code>VK_IMAGE_LAYOUT_STENCIL_ATTACHMENT_OPTIMAL</code>, or <code>VK_IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL</code> then the corresponding attachment image view of the framebuffer specified in the <code>framebuffer</code> member of <code>pRenderPassBegin</code> <strong class=\"purple\">must</strong> have been created with a <code>usage</code> value including <code>VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_attachment_feedback_loop_layout)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBeginRenderPass-initialLayout-07000",
|
|
"text": " If any of the <code>initialLayout</code> or <code>finalLayout</code> member of the <code>VkAttachmentDescription</code> structures or the <code>layout</code> member of the <code>VkAttachmentReference</code> structures specified when creating the render pass specified in the <code>renderPass</code> member of <code>pRenderPassBegin</code> is <code>VK_IMAGE_LAYOUT_ATTACHMENT_FEEDBACK_LOOP_OPTIMAL_EXT</code> then the corresponding attachment image view of the framebuffer specified in the <code>framebuffer</code> member of <code>pRenderPassBegin</code> <strong class=\"purple\">must</strong> have been created with a <code>usage</code> value including either the <code>VK_IMAGE_USAGE_COLOR_ATTACHMENT_BIT</code> or <code>VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT</code> and either the <code>VK_IMAGE_USAGE_INPUT_ATTACHMENT_BIT</code> or <code>VK_IMAGE_USAGE_SAMPLED_BIT</code> usage bits."
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginRenderPass-initialLayout-07001",
|
|
"text": " If any of the <code>initialLayout</code> or <code>finalLayout</code> member of the <code>VkAttachmentDescription</code> structures or the <code>layout</code> member of the <code>VkAttachmentReference</code> structures specified when creating the render pass specified in the <code>renderPass</code> member of <code>pRenderPassBegin</code> is <code>VK_IMAGE_LAYOUT_ATTACHMENT_FEEDBACK_LOOP_OPTIMAL_EXT</code> then the corresponding attachment image view of the framebuffer specified in the <code>framebuffer</code> member of <code>pRenderPassBegin</code> <strong class=\"purple\">must</strong> have been created with a <code>usage</code> value the <code>VK_IMAGE_USAGE_ATTACHMENT_FEEDBACK_LOOP_BIT_EXT</code> usage bit."
|
|
}
|
|
]
|
|
},
|
|
"vkCmdBeginRenderPass2": {
|
|
"(VK_VERSION_1_2,VK_KHR_create_renderpass2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBeginRenderPass2-framebuffer-02779",
|
|
"text": " Both the <code>framebuffer</code> and <code>renderPass</code> members of <code>pRenderPassBegin</code> <strong class=\"purple\">must</strong> have been created on the same <a href=\"#VkDevice\">VkDevice</a> that <code>commandBuffer</code> was allocated on"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginRenderPass2-initialLayout-03094",
|
|
"text": " If any of the <code>initialLayout</code> or <code>finalLayout</code> member of the <code>VkAttachmentDescription</code> structures or the <code>layout</code> member of the <code>VkAttachmentReference</code> structures specified when creating the render pass specified in the <code>renderPass</code> member of <code>pRenderPassBegin</code> is <code>VK_IMAGE_LAYOUT_COLOR_ATTACHMENT_OPTIMAL</code> then the corresponding attachment image view of the framebuffer specified in the <code>framebuffer</code> member of <code>pRenderPassBegin</code> <strong class=\"purple\">must</strong> have been created with a <code>usage</code> value including <code>VK_IMAGE_USAGE_COLOR_ATTACHMENT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginRenderPass2-initialLayout-03096",
|
|
"text": " If any of the <code>initialLayout</code> or <code>finalLayout</code> member of the <code>VkAttachmentDescription</code> structures or the <code>layout</code> member of the <code>VkAttachmentReference</code> structures specified when creating the render pass specified in the <code>renderPass</code> member of <code>pRenderPassBegin</code> is <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_STENCIL_ATTACHMENT_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_STENCIL_READ_ONLY_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_ATTACHMENT_OPTIMAL</code>, or <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL</code> then the corresponding attachment image view of the framebuffer specified in the <code>framebuffer</code> member of <code>pRenderPassBegin</code> <strong class=\"purple\">must</strong> have been created with a <code>usage</code> value including <code>VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginRenderPass2-initialLayout-03097",
|
|
"text": " If any of the <code>initialLayout</code> or <code>finalLayout</code> member of the <code>VkAttachmentDescription</code> structures or the <code>layout</code> member of the <code>VkAttachmentReference</code> structures specified when creating the render pass specified in the <code>renderPass</code> member of <code>pRenderPassBegin</code> is <code>VK_IMAGE_LAYOUT_SHADER_READ_ONLY_OPTIMAL</code> then the corresponding attachment image view of the framebuffer specified in the <code>framebuffer</code> member of <code>pRenderPassBegin</code> <strong class=\"purple\">must</strong> have been created with a <code>usage</code> value including <code>VK_IMAGE_USAGE_SAMPLED_BIT</code> or <code>VK_IMAGE_USAGE_INPUT_ATTACHMENT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginRenderPass2-initialLayout-03098",
|
|
"text": " If any of the <code>initialLayout</code> or <code>finalLayout</code> member of the <code>VkAttachmentDescription</code> structures or the <code>layout</code> member of the <code>VkAttachmentReference</code> structures specified when creating the render pass specified in the <code>renderPass</code> member of <code>pRenderPassBegin</code> is <code>VK_IMAGE_LAYOUT_TRANSFER_SRC_OPTIMAL</code> then the corresponding attachment image view of the framebuffer specified in the <code>framebuffer</code> member of <code>pRenderPassBegin</code> <strong class=\"purple\">must</strong> have been created with a <code>usage</code> value including <code>VK_IMAGE_USAGE_TRANSFER_SRC_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginRenderPass2-initialLayout-03099",
|
|
"text": " If any of the <code>initialLayout</code> or <code>finalLayout</code> member of the <code>VkAttachmentDescription</code> structures or the <code>layout</code> member of the <code>VkAttachmentReference</code> structures specified when creating the render pass specified in the <code>renderPass</code> member of <code>pRenderPassBegin</code> is <code>VK_IMAGE_LAYOUT_TRANSFER_DST_OPTIMAL</code> then the corresponding attachment image view of the framebuffer specified in the <code>framebuffer</code> member of <code>pRenderPassBegin</code> <strong class=\"purple\">must</strong> have been created with a <code>usage</code> value including <code>VK_IMAGE_USAGE_TRANSFER_DST_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginRenderPass2-initialLayout-03100",
|
|
"text": " If the <code>initialLayout</code> member of any of the <code>VkAttachmentDescription</code> structures specified when creating the render pass specified in the <code>renderPass</code> member of <code>pRenderPassBegin</code> is not <code>VK_IMAGE_LAYOUT_UNDEFINED</code>, then each such <code>initialLayout</code> <strong class=\"purple\">must</strong> be equal to the current layout of the corresponding attachment image subresource of the framebuffer specified in the <code>framebuffer</code> member of <code>pRenderPassBegin</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginRenderPass2-srcStageMask-06453",
|
|
"text": " The <code>srcStageMask</code> members of any element of the <code>pDependencies</code> member of <a href=\"#VkRenderPassCreateInfo\">VkRenderPassCreateInfo</a> used to create <code>renderPass</code> <strong class=\"purple\">must</strong> be supported by the capabilities of the queue family identified by the <code>queueFamilyIndex</code> member of the <a href=\"#VkCommandPoolCreateInfo\">VkCommandPoolCreateInfo</a> used to create the command pool which <code>commandBuffer</code> was allocated from"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginRenderPass2-dstStageMask-06454",
|
|
"text": " The <code>dstStageMask</code> members of any element of the <code>pDependencies</code> member of <a href=\"#VkRenderPassCreateInfo\">VkRenderPassCreateInfo</a> used to create <code>renderPass</code> <strong class=\"purple\">must</strong> be supported by the capabilities of the queue family identified by the <code>queueFamilyIndex</code> member of the <a href=\"#VkCommandPoolCreateInfo\">VkCommandPoolCreateInfo</a> used to create the command pool which <code>commandBuffer</code> was allocated from"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginRenderPass2-framebuffer-02533",
|
|
"text": " For any attachment in <code>framebuffer</code> that is used by <code>renderPass</code> and is bound to memory locations that are also bound to another attachment used by <code>renderPass</code>, and if at least one of those uses causes either attachment to be written to, both attachments <strong class=\"purple\">must</strong> have had the <code>VK_ATTACHMENT_DESCRIPTION_MAY_ALIAS_BIT</code> set"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginRenderPass2-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginRenderPass2-pRenderPassBegin-parameter",
|
|
"text": " <code>pRenderPassBegin</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkRenderPassBeginInfo\">VkRenderPassBeginInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginRenderPass2-pSubpassBeginInfo-parameter",
|
|
"text": " <code>pSubpassBeginInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkSubpassBeginInfo\">VkSubpassBeginInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginRenderPass2-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginRenderPass2-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginRenderPass2-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginRenderPass2-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginRenderPass2-bufferlevel",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a primary <code>VkCommandBuffer</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_create_renderpass2)+(VK_VERSION_1_2,VK_KHR_separate_depth_stencil_layouts)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBeginRenderPass2-initialLayout-02844",
|
|
"text": " If any of the <code>initialLayout</code> or <code>finalLayout</code> member of the <code>VkAttachmentDescription</code> structures or the <code>layout</code> member of the <code>VkAttachmentReference</code> structures specified when creating the render pass specified in the <code>renderPass</code> member of <code>pRenderPassBegin</code> is <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_OPTIMAL</code>, or <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_STENCIL_ATTACHMENT_OPTIMAL</code>, or <code>VK_IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL</code> then the corresponding attachment image view of the framebuffer specified in the <code>framebuffer</code> member of <code>pRenderPassBegin</code> <strong class=\"purple\">must</strong> have been created with a <code>usage</code> value including <code>VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginRenderPass2-stencilInitialLayout-02845",
|
|
"text": " If any of the <code>stencilInitialLayout</code> or <code>stencilFinalLayout</code> member of the <code>VkAttachmentDescriptionStencilLayout</code> structures or the <code>stencilLayout</code> member of the <code>VkAttachmentReferenceStencilLayout</code> structures specified when creating the render pass specified in the <code>renderPass</code> member of <code>pRenderPassBegin</code> is <code>VK_IMAGE_LAYOUT_STENCIL_ATTACHMENT_OPTIMAL</code>, or <code>VK_IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL</code> then the corresponding attachment image view of the framebuffer specified in the <code>framebuffer</code> member of <code>pRenderPassBegin</code> <strong class=\"purple\">must</strong> have been created with a <code>usage</code> value including <code>VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_create_renderpass2)+(VK_EXT_attachment_feedback_loop_layout)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBeginRenderPass2-initialLayout-07002",
|
|
"text": " If any of the <code>initialLayout</code> or <code>finalLayout</code> member of the <code>VkAttachmentDescription</code> structures or the <code>layout</code> member of the <code>VkAttachmentReference</code> structures specified when creating the render pass specified in the <code>renderPass</code> member of <code>pRenderPassBegin</code> is <code>VK_IMAGE_LAYOUT_ATTACHMENT_FEEDBACK_LOOP_OPTIMAL_EXT</code> then the corresponding attachment image view of the framebuffer specified in the <code>framebuffer</code> member of <code>pRenderPassBegin</code> <strong class=\"purple\">must</strong> have been created with a <code>usage</code> value including either the <code>VK_IMAGE_USAGE_COLOR_ATTACHMENT_BIT</code> or <code>VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT</code> and either the <code>VK_IMAGE_USAGE_INPUT_ATTACHMENT_BIT</code> or <code>VK_IMAGE_USAGE_SAMPLED_BIT</code> usage bits."
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginRenderPass2-initialLayout-07003",
|
|
"text": " If any of the <code>initialLayout</code> or <code>finalLayout</code> member of the <code>VkAttachmentDescription</code> structures or the <code>layout</code> member of the <code>VkAttachmentReference</code> structures specified when creating the render pass specified in the <code>renderPass</code> member of <code>pRenderPassBegin</code> is <code>VK_IMAGE_LAYOUT_ATTACHMENT_FEEDBACK_LOOP_OPTIMAL_EXT</code> then the corresponding attachment image view of the framebuffer specified in the <code>framebuffer</code> member of <code>pRenderPassBegin</code> <strong class=\"purple\">must</strong> have been created with a <code>usage</code> value the <code>VK_IMAGE_USAGE_ATTACHMENT_FEEDBACK_LOOP_BIT_EXT</code> usage bit."
|
|
}
|
|
]
|
|
},
|
|
"VkRenderPassBeginInfo": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkRenderPassBeginInfo-clearValueCount-00902",
|
|
"text": " <code>clearValueCount</code> <strong class=\"purple\">must</strong> be greater than the largest attachment index in <code>renderPass</code> specifying a <code>loadOp</code> (or <code>stencilLoadOp</code>, if the attachment has a depth/stencil format) of <code>VK_ATTACHMENT_LOAD_OP_CLEAR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassBeginInfo-clearValueCount-04962",
|
|
"text": " If <code>clearValueCount</code> is not <code>0</code>, <code>pClearValues</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>clearValueCount</code> <a href=\"#VkClearValue\">VkClearValue</a> unions"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassBeginInfo-renderPass-00904",
|
|
"text": " <code>renderPass</code> <strong class=\"purple\">must</strong> be <a href=\"#renderpass-compatibility\">compatible</a> with the <code>renderPass</code> member of the <a href=\"#VkFramebufferCreateInfo\">VkFramebufferCreateInfo</a> structure specified when creating <code>framebuffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassBeginInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_RENDER_PASS_BEGIN_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassBeginInfo-pNext-pNext",
|
|
"text": " Each <code>pNext</code> member of any structure (including this one) in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be either <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkDeviceGroupRenderPassBeginInfo\">VkDeviceGroupRenderPassBeginInfo</a>, <a href=\"#VkRenderPassAttachmentBeginInfo\">VkRenderPassAttachmentBeginInfo</a>, <a href=\"#VkRenderPassSampleLocationsBeginInfoEXT\">VkRenderPassSampleLocationsBeginInfoEXT</a>, or <a href=\"#VkRenderPassTransformBeginInfoQCOM\">VkRenderPassTransformBeginInfoQCOM</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassBeginInfo-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassBeginInfo-renderPass-parameter",
|
|
"text": " <code>renderPass</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkRenderPass\">VkRenderPass</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassBeginInfo-framebuffer-parameter",
|
|
"text": " <code>framebuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkFramebuffer\">VkFramebuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassBeginInfo-commonparent",
|
|
"text": " Both of <code>framebuffer</code>, and <code>renderPass</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"!(VK_VERSION_1_1,VK_KHR_device_group)": [
|
|
{
|
|
"vuid": "VUID-VkRenderPassBeginInfo-renderArea-02846",
|
|
"text": " <code>renderArea.offset.x</code> <strong class=\"purple\">must</strong> be greater than or equal to 0"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassBeginInfo-renderArea-02847",
|
|
"text": " <code>renderArea.offset.y</code> <strong class=\"purple\">must</strong> be greater than or equal to 0"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassBeginInfo-renderArea-02848",
|
|
"text": " <span class=\"eq\"><code>renderArea.offset.x</code> + <code>renderArea.extent.width</code></span> <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#VkFramebufferCreateInfo\">VkFramebufferCreateInfo</a>::<code>width</code> the <code>framebuffer</code> was created with"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassBeginInfo-renderArea-02849",
|
|
"text": " <span class=\"eq\"><code>renderArea.offset.y</code> + <code>renderArea.extent.height</code></span> <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#VkFramebufferCreateInfo\">VkFramebufferCreateInfo</a>::<code>height</code> the <code>framebuffer</code> was created with"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_device_group)": [
|
|
{
|
|
"vuid": "VUID-VkRenderPassBeginInfo-pNext-02850",
|
|
"text": " If the <code>pNext</code> chain does not contain <a href=\"#VkDeviceGroupRenderPassBeginInfo\">VkDeviceGroupRenderPassBeginInfo</a> or its <code>deviceRenderAreaCount</code> member is equal to 0, <code>renderArea.offset.x</code> <strong class=\"purple\">must</strong> be greater than or equal to 0"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassBeginInfo-pNext-02851",
|
|
"text": " If the <code>pNext</code> chain does not contain <a href=\"#VkDeviceGroupRenderPassBeginInfo\">VkDeviceGroupRenderPassBeginInfo</a> or its <code>deviceRenderAreaCount</code> member is equal to 0, <code>renderArea.offset.y</code> <strong class=\"purple\">must</strong> be greater than or equal to 0"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassBeginInfo-pNext-02852",
|
|
"text": " If the <code>pNext</code> chain does not contain <a href=\"#VkDeviceGroupRenderPassBeginInfo\">VkDeviceGroupRenderPassBeginInfo</a> or its <code>deviceRenderAreaCount</code> member is equal to 0, <span class=\"eq\"><code>renderArea.offset.x</code> + <code>renderArea.extent.width</code></span> <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#VkFramebufferCreateInfo\">VkFramebufferCreateInfo</a>::<code>width</code> the <code>framebuffer</code> was created with"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassBeginInfo-pNext-02853",
|
|
"text": " If the <code>pNext</code> chain does not contain <a href=\"#VkDeviceGroupRenderPassBeginInfo\">VkDeviceGroupRenderPassBeginInfo</a> or its <code>deviceRenderAreaCount</code> member is equal to 0, <span class=\"eq\"><code>renderArea.offset.y</code> + <code>renderArea.extent.height</code></span> <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#VkFramebufferCreateInfo\">VkFramebufferCreateInfo</a>::<code>height</code> the <code>framebuffer</code> was created with"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassBeginInfo-pNext-02856",
|
|
"text": " If the <code>pNext</code> chain contains <a href=\"#VkDeviceGroupRenderPassBeginInfo\">VkDeviceGroupRenderPassBeginInfo</a>, <span class=\"eq\"><code>offset.x</code> + <code>extent.width</code></span> of each element of <code>pDeviceRenderAreas</code> <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#VkFramebufferCreateInfo\">VkFramebufferCreateInfo</a>::<code>width</code> the <code>framebuffer</code> was created with"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassBeginInfo-pNext-02857",
|
|
"text": " If the <code>pNext</code> chain contains <a href=\"#VkDeviceGroupRenderPassBeginInfo\">VkDeviceGroupRenderPassBeginInfo</a>, <span class=\"eq\"><code>offset.y</code> + <code>extent.height</code></span> of each element of <code>pDeviceRenderAreas</code> <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#VkFramebufferCreateInfo\">VkFramebufferCreateInfo</a>::<code>height</code> the <code>framebuffer</code> was created with"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_imageless_framebuffer)": [
|
|
{
|
|
"vuid": "VUID-VkRenderPassBeginInfo-framebuffer-03207",
|
|
"text": " If <code>framebuffer</code> was created with a <a href=\"#VkFramebufferCreateInfo\">VkFramebufferCreateInfo</a>::<code>flags</code> value that did not include <code>VK_FRAMEBUFFER_CREATE_IMAGELESS_BIT</code>, and the <code>pNext</code> chain includes a <a href=\"#VkRenderPassAttachmentBeginInfo\">VkRenderPassAttachmentBeginInfo</a> structure, its <code>attachmentCount</code> <strong class=\"purple\">must</strong> be zero"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassBeginInfo-framebuffer-03208",
|
|
"text": " If <code>framebuffer</code> was created with a <a href=\"#VkFramebufferCreateInfo\">VkFramebufferCreateInfo</a>::<code>flags</code> value that included <code>VK_FRAMEBUFFER_CREATE_IMAGELESS_BIT</code>, the <code>attachmentCount</code> of a <a href=\"#VkRenderPassAttachmentBeginInfo\">VkRenderPassAttachmentBeginInfo</a> structure included in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be equal to the value of <a href=\"#VkFramebufferAttachmentsCreateInfo\">VkFramebufferAttachmentsCreateInfo</a>::<code>attachmentImageInfoCount</code> used to create <code>framebuffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassBeginInfo-framebuffer-02780",
|
|
"text": " If <code>framebuffer</code> was created with a <a href=\"#VkFramebufferCreateInfo\">VkFramebufferCreateInfo</a>::<code>flags</code> value that included <code>VK_FRAMEBUFFER_CREATE_IMAGELESS_BIT</code>, each element of the <code>pAttachments</code> member of a <a href=\"#VkRenderPassAttachmentBeginInfo\">VkRenderPassAttachmentBeginInfo</a> structure included in the <code>pNext</code> chain <strong class=\"purple\">must</strong> have been created on the same <a href=\"#VkDevice\">VkDevice</a> as <code>framebuffer</code> and <code>renderPass</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassBeginInfo-framebuffer-03209",
|
|
"text": " If <code>framebuffer</code> was created with a <a href=\"#VkFramebufferCreateInfo\">VkFramebufferCreateInfo</a>::<code>flags</code> value that included <code>VK_FRAMEBUFFER_CREATE_IMAGELESS_BIT</code>, each element of the <code>pAttachments</code> member of a <a href=\"#VkRenderPassAttachmentBeginInfo\">VkRenderPassAttachmentBeginInfo</a> structure included in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be a <a href=\"#VkImageView\">VkImageView</a> of an image created with a value of <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a>::<code>flags</code> equal to the <code>flags</code> member of the corresponding element of <a href=\"#VkFramebufferAttachmentsCreateInfo\">VkFramebufferAttachmentsCreateInfo</a>::<code>pAttachmentImageInfos</code> used to create <code>framebuffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassBeginInfo-framebuffer-04627",
|
|
"text": " If <code>framebuffer</code> was created with a <a href=\"#VkFramebufferCreateInfo\">VkFramebufferCreateInfo</a>::<code>flags</code> value that included <code>VK_FRAMEBUFFER_CREATE_IMAGELESS_BIT</code>, each element of the <code>pAttachments</code> member of a <a href=\"#VkRenderPassAttachmentBeginInfo\">VkRenderPassAttachmentBeginInfo</a> structure included in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be a <a href=\"#VkImageView\">VkImageView</a> with <a href=\"#resources-image-inherited-usage\">an inherited usage</a> equal to the <code>usage</code> member of the corresponding element of <a href=\"#VkFramebufferAttachmentsCreateInfo\">VkFramebufferAttachmentsCreateInfo</a>::<code>pAttachmentImageInfos</code> used to create <code>framebuffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassBeginInfo-framebuffer-03211",
|
|
"text": " If <code>framebuffer</code> was created with a <a href=\"#VkFramebufferCreateInfo\">VkFramebufferCreateInfo</a>::<code>flags</code> value that included <code>VK_FRAMEBUFFER_CREATE_IMAGELESS_BIT</code>, each element of the <code>pAttachments</code> member of a <a href=\"#VkRenderPassAttachmentBeginInfo\">VkRenderPassAttachmentBeginInfo</a> structure included in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be a <a href=\"#VkImageView\">VkImageView</a> with a width equal to the <code>width</code> member of the corresponding element of <a href=\"#VkFramebufferAttachmentsCreateInfo\">VkFramebufferAttachmentsCreateInfo</a>::<code>pAttachmentImageInfos</code> used to create <code>framebuffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassBeginInfo-framebuffer-03212",
|
|
"text": " If <code>framebuffer</code> was created with a <a href=\"#VkFramebufferCreateInfo\">VkFramebufferCreateInfo</a>::<code>flags</code> value that included <code>VK_FRAMEBUFFER_CREATE_IMAGELESS_BIT</code>, each element of the <code>pAttachments</code> member of a <a href=\"#VkRenderPassAttachmentBeginInfo\">VkRenderPassAttachmentBeginInfo</a> structure included in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be a <a href=\"#VkImageView\">VkImageView</a> with a height equal to the <code>height</code> member of the corresponding element of <a href=\"#VkFramebufferAttachmentsCreateInfo\">VkFramebufferAttachmentsCreateInfo</a>::<code>pAttachmentImageInfos</code> used to create <code>framebuffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassBeginInfo-framebuffer-03213",
|
|
"text": " If <code>framebuffer</code> was created with a <a href=\"#VkFramebufferCreateInfo\">VkFramebufferCreateInfo</a>::<code>flags</code> value that included <code>VK_FRAMEBUFFER_CREATE_IMAGELESS_BIT</code>, each element of the <code>pAttachments</code> member of a <a href=\"#VkRenderPassAttachmentBeginInfo\">VkRenderPassAttachmentBeginInfo</a> structure included in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be a <a href=\"#VkImageView\">VkImageView</a> of an image created with a value of <a href=\"#VkImageViewCreateInfo\">VkImageViewCreateInfo</a>::<code>subresourceRange.layerCount</code> equal to the <code>layerCount</code> member of the corresponding element of <a href=\"#VkFramebufferAttachmentsCreateInfo\">VkFramebufferAttachmentsCreateInfo</a>::<code>pAttachmentImageInfos</code> used to create <code>framebuffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassBeginInfo-framebuffer-03214",
|
|
"text": " If <code>framebuffer</code> was created with a <a href=\"#VkFramebufferCreateInfo\">VkFramebufferCreateInfo</a>::<code>flags</code> value that included <code>VK_FRAMEBUFFER_CREATE_IMAGELESS_BIT</code>, each element of the <code>pAttachments</code> member of a <a href=\"#VkRenderPassAttachmentBeginInfo\">VkRenderPassAttachmentBeginInfo</a> structure included in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be a <a href=\"#VkImageView\">VkImageView</a> of an image created with a value of <a href=\"#VkImageFormatListCreateInfo\">VkImageFormatListCreateInfo</a>::<code>viewFormatCount</code> equal to the <code>viewFormatCount</code> member of the corresponding element of <a href=\"#VkFramebufferAttachmentsCreateInfo\">VkFramebufferAttachmentsCreateInfo</a>::<code>pAttachmentImageInfos</code> used to create <code>framebuffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassBeginInfo-framebuffer-03215",
|
|
"text": " If <code>framebuffer</code> was created with a <a href=\"#VkFramebufferCreateInfo\">VkFramebufferCreateInfo</a>::<code>flags</code> value that included <code>VK_FRAMEBUFFER_CREATE_IMAGELESS_BIT</code>, each element of the <code>pAttachments</code> member of a <a href=\"#VkRenderPassAttachmentBeginInfo\">VkRenderPassAttachmentBeginInfo</a> structure included in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be a <a href=\"#VkImageView\">VkImageView</a> of an image created with a set of elements in <a href=\"#VkImageFormatListCreateInfo\">VkImageFormatListCreateInfo</a>::<code>pViewFormats</code> equal to the set of elements in the <code>pViewFormats</code> member of the corresponding element of <a href=\"#VkFramebufferAttachmentsCreateInfo\">VkFramebufferAttachmentsCreateInfo</a>::<code>pAttachmentImageInfos</code> used to create <code>framebuffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassBeginInfo-framebuffer-03216",
|
|
"text": " If <code>framebuffer</code> was created with a <a href=\"#VkFramebufferCreateInfo\">VkFramebufferCreateInfo</a>::<code>flags</code> value that included <code>VK_FRAMEBUFFER_CREATE_IMAGELESS_BIT</code>, each element of the <code>pAttachments</code> member of a <a href=\"#VkRenderPassAttachmentBeginInfo\">VkRenderPassAttachmentBeginInfo</a> structure included in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be a <a href=\"#VkImageView\">VkImageView</a> of an image created with a value of <a href=\"#VkImageViewCreateInfo\">VkImageViewCreateInfo</a>::<code>format</code> equal to the corresponding value of <a href=\"#VkAttachmentDescription\">VkAttachmentDescription</a>::<code>format</code> in <code>renderPass</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassBeginInfo-framebuffer-03217",
|
|
"text": " If <code>framebuffer</code> was created with a <a href=\"#VkFramebufferCreateInfo\">VkFramebufferCreateInfo</a>::<code>flags</code> value that included <code>VK_FRAMEBUFFER_CREATE_IMAGELESS_BIT</code>, each element of the <code>pAttachments</code> member of a <a href=\"#VkRenderPassAttachmentBeginInfo\">VkRenderPassAttachmentBeginInfo</a> structure included in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be a <a href=\"#VkImageView\">VkImageView</a> of an image created with a value of <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a>::<code>samples</code> equal to the corresponding value of <a href=\"#VkAttachmentDescription\">VkAttachmentDescription</a>::<code>samples</code> in <code>renderPass</code>"
|
|
}
|
|
],
|
|
"(VK_QCOM_render_pass_transform)": [
|
|
{
|
|
"vuid": "VUID-VkRenderPassBeginInfo-pNext-02869",
|
|
"text": " If the <code>pNext</code> chain includes <a href=\"#VkRenderPassTransformBeginInfoQCOM\">VkRenderPassTransformBeginInfoQCOM</a>, <code>renderArea.offset</code> <strong class=\"purple\">must</strong> equal <span class=\"eq\">(0,0)</span>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassBeginInfo-pNext-02870",
|
|
"text": " If the <code>pNext</code> chain includes <a href=\"#VkRenderPassTransformBeginInfoQCOM\">VkRenderPassTransformBeginInfoQCOM</a>, <code>renderArea.extent</code> transformed by <a href=\"#VkRenderPassTransformBeginInfoQCOM\">VkRenderPassTransformBeginInfoQCOM</a>::<code>transform</code> <strong class=\"purple\">must</strong> equal the <code>framebuffer</code> dimensions"
|
|
}
|
|
]
|
|
},
|
|
"VkRenderPassSampleLocationsBeginInfoEXT": {
|
|
"(VK_EXT_sample_locations)": [
|
|
{
|
|
"vuid": "VUID-VkRenderPassSampleLocationsBeginInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_RENDER_PASS_SAMPLE_LOCATIONS_BEGIN_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassSampleLocationsBeginInfoEXT-pAttachmentInitialSampleLocations-parameter",
|
|
"text": " If <code>attachmentInitialSampleLocationsCount</code> is not <code>0</code>, <code>pAttachmentInitialSampleLocations</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>attachmentInitialSampleLocationsCount</code> valid <a href=\"#VkAttachmentSampleLocationsEXT\">VkAttachmentSampleLocationsEXT</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassSampleLocationsBeginInfoEXT-pPostSubpassSampleLocations-parameter",
|
|
"text": " If <code>postSubpassSampleLocationsCount</code> is not <code>0</code>, <code>pPostSubpassSampleLocations</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>postSubpassSampleLocationsCount</code> valid <a href=\"#VkSubpassSampleLocationsEXT\">VkSubpassSampleLocationsEXT</a> structures"
|
|
}
|
|
]
|
|
},
|
|
"VkAttachmentSampleLocationsEXT": {
|
|
"(VK_EXT_sample_locations)": [
|
|
{
|
|
"vuid": "VUID-VkAttachmentSampleLocationsEXT-attachmentIndex-01531",
|
|
"text": " <code>attachmentIndex</code> <strong class=\"purple\">must</strong> be less than the <code>attachmentCount</code> specified in <a href=\"#VkRenderPassCreateInfo\">VkRenderPassCreateInfo</a> the render pass specified by <a href=\"#VkRenderPassBeginInfo\">VkRenderPassBeginInfo</a>::<code>renderPass</code> was created with"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAttachmentSampleLocationsEXT-sampleLocationsInfo-parameter",
|
|
"text": " <code>sampleLocationsInfo</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSampleLocationsInfoEXT\">VkSampleLocationsInfoEXT</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkSubpassSampleLocationsEXT": {
|
|
"(VK_EXT_sample_locations)": [
|
|
{
|
|
"vuid": "VUID-VkSubpassSampleLocationsEXT-subpassIndex-01532",
|
|
"text": " <code>subpassIndex</code> <strong class=\"purple\">must</strong> be less than the <code>subpassCount</code> specified in <a href=\"#VkRenderPassCreateInfo\">VkRenderPassCreateInfo</a> the render pass specified by <a href=\"#VkRenderPassBeginInfo\">VkRenderPassBeginInfo</a>::<code>renderPass</code> was created with"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassSampleLocationsEXT-sampleLocationsInfo-parameter",
|
|
"text": " <code>sampleLocationsInfo</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSampleLocationsInfoEXT\">VkSampleLocationsInfoEXT</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkRenderPassTransformBeginInfoQCOM": {
|
|
"(VK_QCOM_render_pass_transform)": [
|
|
{
|
|
"vuid": "VUID-VkRenderPassTransformBeginInfoQCOM-transform-02871",
|
|
"text": " <code>transform</code> <strong class=\"purple\">must</strong> be <code>VK_SURFACE_TRANSFORM_IDENTITY_BIT_KHR</code>, <code>VK_SURFACE_TRANSFORM_ROTATE_90_BIT_KHR</code>, <code>VK_SURFACE_TRANSFORM_ROTATE_180_BIT_KHR</code>, or <code>VK_SURFACE_TRANSFORM_ROTATE_270_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassTransformBeginInfoQCOM-flags-02872",
|
|
"text": " The <code>renderpass</code> <strong class=\"purple\">must</strong> have been created with <a href=\"#VkRenderPassCreateInfo\">VkRenderPassCreateInfo</a>::<code>flags</code> containing <code>VK_RENDER_PASS_CREATE_TRANSFORM_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassTransformBeginInfoQCOM-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_RENDER_PASS_TRANSFORM_BEGIN_INFO_QCOM</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkSubpassBeginInfo": {
|
|
"(VK_VERSION_1_2,VK_KHR_create_renderpass2)": [
|
|
{
|
|
"vuid": "VUID-VkSubpassBeginInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_SUBPASS_BEGIN_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassBeginInfo-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassBeginInfo-contents-parameter",
|
|
"text": " <code>contents</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSubpassContents\">VkSubpassContents</a> value"
|
|
}
|
|
]
|
|
},
|
|
"VkDeviceGroupRenderPassBeginInfo": {
|
|
"(VK_VERSION_1_1,VK_KHR_device_group)": [
|
|
{
|
|
"vuid": "VUID-VkDeviceGroupRenderPassBeginInfo-deviceMask-00905",
|
|
"text": " <code>deviceMask</code> <strong class=\"purple\">must</strong> be a valid device mask value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceGroupRenderPassBeginInfo-deviceMask-00906",
|
|
"text": " <code>deviceMask</code> <strong class=\"purple\">must</strong> not be zero"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceGroupRenderPassBeginInfo-deviceMask-00907",
|
|
"text": " <code>deviceMask</code> <strong class=\"purple\">must</strong> be a subset of the command buffer’s initial device mask"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceGroupRenderPassBeginInfo-deviceRenderAreaCount-00908",
|
|
"text": " <code>deviceRenderAreaCount</code> <strong class=\"purple\">must</strong> either be zero or equal to the number of physical devices in the logical device"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceGroupRenderPassBeginInfo-offset-06166",
|
|
"text": " The <code>offset.x</code> member of any element of <code>pDeviceRenderAreas</code> <strong class=\"purple\">must</strong> be greater than or equal to 0"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceGroupRenderPassBeginInfo-offset-06167",
|
|
"text": " The <code>offset.y</code> member of any element of <code>pDeviceRenderAreas</code> <strong class=\"purple\">must</strong> be greater than or equal to 0"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceGroupRenderPassBeginInfo-offset-06168",
|
|
"text": " The sum of the <code>offset.x</code> and <code>extent.width</code> members of any element of <code>pDeviceRenderAreas</code> <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#limits-maxFramebufferWidth\"><code>maxFramebufferWidth</code></a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceGroupRenderPassBeginInfo-offset-06169",
|
|
"text": " The sum of the <code>offset.y</code> and <code>extent.height</code> members of any element of <code>pDeviceRenderAreas</code> <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#limits-maxFramebufferHeight\"><code>maxFramebufferHeight</code></a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceGroupRenderPassBeginInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_DEVICE_GROUP_RENDER_PASS_BEGIN_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceGroupRenderPassBeginInfo-pDeviceRenderAreas-parameter",
|
|
"text": " If <code>deviceRenderAreaCount</code> is not <code>0</code>, <code>pDeviceRenderAreas</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>deviceRenderAreaCount</code> <a href=\"#VkRect2D\">VkRect2D</a> structures"
|
|
}
|
|
]
|
|
},
|
|
"VkRenderPassAttachmentBeginInfo": {
|
|
"(VK_VERSION_1_2,VK_KHR_imageless_framebuffer)": [
|
|
{
|
|
"vuid": "VUID-VkRenderPassAttachmentBeginInfo-pAttachments-03218",
|
|
"text": " Each element of <code>pAttachments</code> <strong class=\"purple\">must</strong> only specify a single mip level"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassAttachmentBeginInfo-pAttachments-03219",
|
|
"text": " Each element of <code>pAttachments</code> <strong class=\"purple\">must</strong> have been created with the identity swizzle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassAttachmentBeginInfo-pAttachments-04114",
|
|
"text": " Each element of <code>pAttachments</code> <strong class=\"purple\">must</strong> have been created with <a href=\"#VkImageViewCreateInfo\">VkImageViewCreateInfo</a>::<code>viewType</code> not equal to <code>VK_IMAGE_VIEW_TYPE_3D</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassAttachmentBeginInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_RENDER_PASS_ATTACHMENT_BEGIN_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassAttachmentBeginInfo-pAttachments-parameter",
|
|
"text": " If <code>attachmentCount</code> is not <code>0</code>, <code>pAttachments</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>attachmentCount</code> valid <a href=\"#VkImageView\">VkImageView</a> handles"
|
|
}
|
|
]
|
|
},
|
|
"vkGetRenderAreaGranularity": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkGetRenderAreaGranularity-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetRenderAreaGranularity-renderPass-parameter",
|
|
"text": " <code>renderPass</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkRenderPass\">VkRenderPass</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetRenderAreaGranularity-pGranularity-parameter",
|
|
"text": " <code>pGranularity</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkExtent2D\">VkExtent2D</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetRenderAreaGranularity-renderPass-parent",
|
|
"text": " <code>renderPass</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdNextSubpass": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCmdNextSubpass-None-00909",
|
|
"text": " The current subpass index <strong class=\"purple\">must</strong> be less than the number of subpasses in the render pass minus one"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdNextSubpass-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdNextSubpass-contents-parameter",
|
|
"text": " <code>contents</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSubpassContents\">VkSubpassContents</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdNextSubpass-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdNextSubpass-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdNextSubpass-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called inside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdNextSubpass-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdNextSubpass-bufferlevel",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a primary <code>VkCommandBuffer</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)": [
|
|
{
|
|
"vuid": "VUID-vkCmdNextSubpass-None-02349",
|
|
"text": " This command <strong class=\"purple\">must</strong> not be recorded when transform feedback is active"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdNextSubpass2": {
|
|
"(VK_VERSION_1_2,VK_KHR_create_renderpass2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdNextSubpass2-None-03102",
|
|
"text": " The current subpass index <strong class=\"purple\">must</strong> be less than the number of subpasses in the render pass minus one"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdNextSubpass2-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdNextSubpass2-pSubpassBeginInfo-parameter",
|
|
"text": " <code>pSubpassBeginInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkSubpassBeginInfo\">VkSubpassBeginInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdNextSubpass2-pSubpassEndInfo-parameter",
|
|
"text": " <code>pSubpassEndInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkSubpassEndInfo\">VkSubpassEndInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdNextSubpass2-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdNextSubpass2-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdNextSubpass2-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called inside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdNextSubpass2-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdNextSubpass2-bufferlevel",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a primary <code>VkCommandBuffer</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_create_renderpass2)+(VK_EXT_transform_feedback)": [
|
|
{
|
|
"vuid": "VUID-vkCmdNextSubpass2-None-02350",
|
|
"text": " This command <strong class=\"purple\">must</strong> not be recorded when transform feedback is active"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdEndRenderPass": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCmdEndRenderPass-None-00910",
|
|
"text": " The current subpass index <strong class=\"purple\">must</strong> be equal to the number of subpasses in the render pass minus one"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndRenderPass-None-07004",
|
|
"text": " If <code>vkCmdBeginQuery</code>* was called within a subpass of the render pass, the corresponding <code>vkCmdEndQuery</code>* <strong class=\"purple\">must</strong> have been called subsequently within the same subpass."
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndRenderPass-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndRenderPass-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndRenderPass-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndRenderPass-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called inside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndRenderPass-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndRenderPass-bufferlevel",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a primary <code>VkCommandBuffer</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)": [
|
|
{
|
|
"vuid": "VUID-vkCmdEndRenderPass-None-02351",
|
|
"text": " This command <strong class=\"purple\">must</strong> not be recorded when transform feedback is active"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)": [
|
|
{
|
|
"vuid": "VUID-vkCmdEndRenderPass-None-06170",
|
|
"text": " The current render pass instance <strong class=\"purple\">must</strong> not have been begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdEndRenderPass2": {
|
|
"(VK_VERSION_1_2,VK_KHR_create_renderpass2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdEndRenderPass2-None-03103",
|
|
"text": " The current subpass index <strong class=\"purple\">must</strong> be equal to the number of subpasses in the render pass minus one"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndRenderPass2-None-07005",
|
|
"text": " If <code>vkCmdBeginQuery</code>* was called within a subpass of the render pass, the corresponding <code>vkCmdEndQuery</code>* <strong class=\"purple\">must</strong> have been called subsequently within the same subpass."
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndRenderPass2-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndRenderPass2-pSubpassEndInfo-parameter",
|
|
"text": " <code>pSubpassEndInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkSubpassEndInfo\">VkSubpassEndInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndRenderPass2-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndRenderPass2-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndRenderPass2-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called inside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndRenderPass2-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndRenderPass2-bufferlevel",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a primary <code>VkCommandBuffer</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_create_renderpass2)+(VK_EXT_transform_feedback)": [
|
|
{
|
|
"vuid": "VUID-vkCmdEndRenderPass2-None-02352",
|
|
"text": " This command <strong class=\"purple\">must</strong> not be recorded when transform feedback is active"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_create_renderpass2)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)": [
|
|
{
|
|
"vuid": "VUID-vkCmdEndRenderPass2-None-06171",
|
|
"text": " The current render pass instance <strong class=\"purple\">must</strong> not have been begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>"
|
|
}
|
|
]
|
|
},
|
|
"VkSubpassEndInfo": {
|
|
"(VK_VERSION_1_2,VK_KHR_create_renderpass2)": [
|
|
{
|
|
"vuid": "VUID-VkSubpassEndInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_SUBPASS_END_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassEndInfo-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkSubpassFragmentDensityMapOffsetEndInfoQCOM\">VkSubpassFragmentDensityMapOffsetEndInfoQCOM</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassEndInfo-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
}
|
|
]
|
|
},
|
|
"VkSubpassFragmentDensityMapOffsetEndInfoQCOM": {
|
|
"(VK_VERSION_1_2,VK_KHR_create_renderpass2)+(VK_QCOM_fragment_density_map_offset)": [
|
|
{
|
|
"vuid": "VUID-VkSubpassFragmentDensityMapOffsetEndInfoQCOM-fragmentDensityMapOffsets-06503",
|
|
"text": " If the <a href=\"#features-fragmentDensityMapOffsets\"><code>fragmentDensityMapOffsets</code></a> feature is not enabled or fragment density map is not enabled in the render pass, <code>fragmentDensityOffsetCount</code> <strong class=\"purple\">must</strong> equal <code>0</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassFragmentDensityMapOffsetEndInfoQCOM-fragmentDensityMapAttachment-06504",
|
|
"text": " If <code>VkSubpassDescription</code>::<code>fragmentDensityMapAttachment</code> is not is not <code>VK_ATTACHMENT_UNUSED</code> and was not created with <code>VK_IMAGE_CREATE_FRAGMENT_DENSITY_MAP_OFFSET_BIT_QCOM</code>, <code>fragmentDensityOffsetCount</code> <strong class=\"purple\">must</strong> equal <code>0</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassFragmentDensityMapOffsetEndInfoQCOM-pDepthStencilAttachment-06505",
|
|
"text": " If <code>VkSubpassDescription</code>::<code>pDepthStencilAttachment</code> is not is not <code>VK_ATTACHMENT_UNUSED</code> and was not created with <code>VK_IMAGE_CREATE_FRAGMENT_DENSITY_MAP_OFFSET_BIT_QCOM</code>, <code>fragmentDensityOffsetCount</code> <strong class=\"purple\">must</strong> equal <code>0</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassFragmentDensityMapOffsetEndInfoQCOM-pInputAttachments-06506",
|
|
"text": " If any element of <code>VkSubpassDescription</code>::<code>pInputAttachments</code> is not is not <code>VK_ATTACHMENT_UNUSED</code> and was not created with <code>VK_IMAGE_CREATE_FRAGMENT_DENSITY_MAP_OFFSET_BIT_QCOM</code>, <code>fragmentDensityOffsetCount</code> <strong class=\"purple\">must</strong> equal <code>0</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassFragmentDensityMapOffsetEndInfoQCOM-pColorAttachments-06507",
|
|
"text": " If any element of <code>VkSubpassDescription</code>::<code>pColorAttachments</code> is not is not <code>VK_ATTACHMENT_UNUSED</code> and was not created with <code>VK_IMAGE_CREATE_FRAGMENT_DENSITY_MAP_OFFSET_BIT_QCOM</code>, <code>fragmentDensityOffsetCount</code> <strong class=\"purple\">must</strong> equal <code>0</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassFragmentDensityMapOffsetEndInfoQCOM-pResolveAttachments-06508",
|
|
"text": " If any element of <code>VkSubpassDescription</code>::<code>pResolveAttachments</code> is not is not <code>VK_ATTACHMENT_UNUSED</code> and was not created with <code>VK_IMAGE_CREATE_FRAGMENT_DENSITY_MAP_OFFSET_BIT_QCOM</code>, <code>fragmentDensityOffsetCount</code> <strong class=\"purple\">must</strong> equal <code>0</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassFragmentDensityMapOffsetEndInfoQCOM-pPreserveAttachments-06509",
|
|
"text": " If any element of <code>VkSubpassDescription</code>::<code>pPreserveAttachments</code> is not is not <code>VK_ATTACHMENT_UNUSED</code> and was not created with <code>VK_IMAGE_CREATE_FRAGMENT_DENSITY_MAP_OFFSET_BIT_QCOM</code>, <code>fragmentDensityOffsetCount</code> <strong class=\"purple\">must</strong> equal <code>0</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassFragmentDensityMapOffsetEndInfoQCOM-fragmentDensityOffsetCount-06510",
|
|
"text": " If <code>fragmentDensityOffsetCount</code> is not <code>0</code> and multiview is enabled for the render pass, <code>fragmentDensityOffsetCount</code> <strong class=\"purple\">must</strong> equal the <code>layerCount</code> that was specified in creating the fragment density map attachment view."
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassFragmentDensityMapOffsetEndInfoQCOM-fragmentDensityOffsetCount-06511",
|
|
"text": " If <code>fragmentDensityOffsetCount</code> is not <code>0</code> and multiview is not enabled for the render pass, <code>fragmentDensityOffsetCount</code> <strong class=\"purple\">must</strong> equal <code>1</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassFragmentDensityMapOffsetEndInfoQCOM-x-06512",
|
|
"text": " The <code>x</code> component of each element of <code>pFragmentDensityOffsets</code> <strong class=\"purple\">must</strong> be an integer multiple of <code>fragmentDensityOffsetGranularity.width</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassFragmentDensityMapOffsetEndInfoQCOM-y-06513",
|
|
"text": " The <code>y</code> component of each element of <code>pFragmentDensityOffsets</code> <strong class=\"purple\">must</strong> be an integer multiple of <code>fragmentDensityOffsetGranularity.height</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassFragmentDensityMapOffsetEndInfoQCOM-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_SUBPASS_FRAGMENT_DENSITY_MAP_OFFSET_END_INFO_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassFragmentDensityMapOffsetEndInfoQCOM-pFragmentDensityOffsets-parameter",
|
|
"text": " If <code>fragmentDensityOffsetCount</code> is not <code>0</code>, <code>pFragmentDensityOffsets</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>fragmentDensityOffsetCount</code> <a href=\"#VkOffset2D\">VkOffset2D</a> structures"
|
|
}
|
|
]
|
|
},
|
|
"VkRenderPassCreationControlEXT": {
|
|
"(VK_EXT_subpass_merge_feedback)": [
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreationControlEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_RENDER_PASS_CREATION_CONTROL_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkRenderPassCreationFeedbackCreateInfoEXT": {
|
|
"(VK_EXT_subpass_merge_feedback)": [
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreationFeedbackCreateInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_RENDER_PASS_CREATION_FEEDBACK_CREATE_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassCreationFeedbackCreateInfoEXT-pRenderPassFeedback-parameter",
|
|
"text": " <code>pRenderPassFeedback</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkRenderPassCreationFeedbackInfoEXT\">VkRenderPassCreationFeedbackInfoEXT</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkRenderPassSubpassFeedbackCreateInfoEXT": {
|
|
"(VK_EXT_subpass_merge_feedback)": [
|
|
{
|
|
"vuid": "VUID-VkRenderPassSubpassFeedbackCreateInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_RENDER_PASS_SUBPASS_FEEDBACK_CREATE_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRenderPassSubpassFeedbackCreateInfoEXT-pSubpassFeedback-parameter",
|
|
"text": " <code>pSubpassFeedback</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkRenderPassSubpassFeedbackInfoEXT\">VkRenderPassSubpassFeedbackInfoEXT</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"vkCreateShaderModule": {
|
|
"(VK_EXT_validation_cache)": [
|
|
{
|
|
"vuid": "VUID-vkCreateShaderModule-pCreateInfo-06904",
|
|
"text": " If <code>pCreateInfo</code> is not <code>NULL</code>, <code>pCreateInfo->pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code> or a pointer to a <a href=\"#VkShaderModuleValidationCacheCreateInfoEXT\">VkShaderModuleValidationCacheCreateInfoEXT</a> structure"
|
|
}
|
|
],
|
|
"!(VK_EXT_validation_cache)": [
|
|
{
|
|
"vuid": "VUID-vkCreateShaderModule-pCreateInfo-06905",
|
|
"text": " If <code>pCreateInfo</code> is not <code>NULL</code>, <code>pCreateInfo->pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
}
|
|
],
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCreateShaderModule-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateShaderModule-pCreateInfo-parameter",
|
|
"text": " <code>pCreateInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkShaderModuleCreateInfo\">VkShaderModuleCreateInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateShaderModule-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateShaderModule-pShaderModule-parameter",
|
|
"text": " <code>pShaderModule</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkShaderModule\">VkShaderModule</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkShaderModuleCreateInfo": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkShaderModuleCreateInfo-codeSize-01085",
|
|
"text": " <code>codeSize</code> <strong class=\"purple\">must</strong> be greater than 0"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkShaderModuleCreateInfo-pCode-01089",
|
|
"text": " <code>pCode</code> <strong class=\"purple\">must</strong> declare the <code>Shader</code> capability for SPIR-V code"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkShaderModuleCreateInfo-pCode-01090",
|
|
"text": " <code>pCode</code> <strong class=\"purple\">must</strong> not declare any capability that is not supported by the API, as described by the <a href=\"#spirvenv-module-validation\">Capabilities</a> section of the <a href=\"#spirvenv-capabilities\">SPIR-V Environment</a> appendix"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkShaderModuleCreateInfo-pCode-01091",
|
|
"text": " If <code>pCode</code> declares any of the capabilities listed in the <a href=\"#spirvenv-capabilities-table\">SPIR-V Environment</a> appendix, one of the corresponding requirements <strong class=\"purple\">must</strong> be satisfied"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkShaderModuleCreateInfo-pCode-04146",
|
|
"text": " <code>pCode</code> <strong class=\"purple\">must</strong> not declare any SPIR-V extension that is not supported by the API, as described by the <a href=\"#spirvenv-extensions\">Extension</a> section of the <a href=\"#spirvenv-capabilities\">SPIR-V Environment</a> appendix"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkShaderModuleCreateInfo-pCode-04147",
|
|
"text": " If <code>pCode</code> declares any of the SPIR-V extensions listed in the <a href=\"#spirvenv-extensions-table\">SPIR-V Environment</a> appendix, one of the corresponding requirements <strong class=\"purple\">must</strong> be satisfied"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkShaderModuleCreateInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_SHADER_MODULE_CREATE_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkShaderModuleCreateInfo-flags-zerobitmask",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkShaderModuleCreateInfo-pCode-parameter",
|
|
"text": " <code>pCode</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of \\(\\textrm{codeSize} \\over 4\\) <code>uint32_t</code> values"
|
|
}
|
|
],
|
|
"!(VK_NV_glsl_shader)": [
|
|
{
|
|
"vuid": "VUID-VkShaderModuleCreateInfo-codeSize-01086",
|
|
"text": " <code>codeSize</code> <strong class=\"purple\">must</strong> be a multiple of 4"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkShaderModuleCreateInfo-pCode-01087",
|
|
"text": " <code>pCode</code> <strong class=\"purple\">must</strong> point to valid SPIR-V code, formatted and packed as described by the <a href=\"#spirv-spec\">Khronos SPIR-V Specification</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkShaderModuleCreateInfo-pCode-01088",
|
|
"text": " <code>pCode</code> <strong class=\"purple\">must</strong> adhere to the validation rules described by the <a href=\"#spirvenv-module-validation\">Validation Rules within a Module</a> section of the <a href=\"#spirvenv-capabilities\">SPIR-V Environment</a> appendix"
|
|
}
|
|
],
|
|
"(VK_NV_glsl_shader)": [
|
|
{
|
|
"vuid": "VUID-VkShaderModuleCreateInfo-pCode-01376",
|
|
"text": " If <code>pCode</code> is a pointer to SPIR-V code, <code>codeSize</code> <strong class=\"purple\">must</strong> be a multiple of 4"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkShaderModuleCreateInfo-pCode-01377",
|
|
"text": " <code>pCode</code> <strong class=\"purple\">must</strong> point to either valid SPIR-V code, formatted and packed as described by the <a href=\"#spirv-spec\">Khronos SPIR-V Specification</a> or valid GLSL code which <strong class=\"purple\">must</strong> be written to the <code>GL_KHR_vulkan_glsl</code> extension specification"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkShaderModuleCreateInfo-pCode-01378",
|
|
"text": " If <code>pCode</code> is a pointer to SPIR-V code, that code <strong class=\"purple\">must</strong> adhere to the validation rules described by the <a href=\"#spirvenv-module-validation\">Validation Rules within a Module</a> section of the <a href=\"#spirvenv-capabilities\">SPIR-V Environment</a> appendix"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkShaderModuleCreateInfo-pCode-01379",
|
|
"text": " If <code>pCode</code> is a pointer to GLSL code, it <strong class=\"purple\">must</strong> be valid GLSL code written to the <code>GL_KHR_vulkan_glsl</code> GLSL extension specification"
|
|
}
|
|
]
|
|
},
|
|
"VkShaderModuleValidationCacheCreateInfoEXT": {
|
|
"(VK_EXT_validation_cache)": [
|
|
{
|
|
"vuid": "VUID-VkShaderModuleValidationCacheCreateInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_SHADER_MODULE_VALIDATION_CACHE_CREATE_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkShaderModuleValidationCacheCreateInfoEXT-validationCache-parameter",
|
|
"text": " <code>validationCache</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkValidationCacheEXT\">VkValidationCacheEXT</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"vkDestroyShaderModule": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkDestroyShaderModule-shaderModule-01092",
|
|
"text": " If <code>VkAllocationCallbacks</code> were provided when <code>shaderModule</code> was created, a compatible set of callbacks <strong class=\"purple\">must</strong> be provided here"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyShaderModule-shaderModule-01093",
|
|
"text": " If no <code>VkAllocationCallbacks</code> were provided when <code>shaderModule</code> was created, <code>pAllocator</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyShaderModule-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyShaderModule-shaderModule-parameter",
|
|
"text": " If <code>shaderModule</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>shaderModule</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkShaderModule\">VkShaderModule</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyShaderModule-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyShaderModule-shaderModule-parent",
|
|
"text": " If <code>shaderModule</code> is a valid handle, it <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetShaderModuleIdentifierEXT": {
|
|
"(VK_EXT_shader_module_identifier)": [
|
|
{
|
|
"vuid": "VUID-vkGetShaderModuleIdentifierEXT-shaderModuleIdentifier-06884",
|
|
"text": " <a href=\"#features-shaderModuleIdentifier\"><code>shaderModuleIdentifier</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetShaderModuleIdentifierEXT-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetShaderModuleIdentifierEXT-shaderModule-parameter",
|
|
"text": " <code>shaderModule</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkShaderModule\">VkShaderModule</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetShaderModuleIdentifierEXT-pIdentifier-parameter",
|
|
"text": " <code>pIdentifier</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkShaderModuleIdentifierEXT\">VkShaderModuleIdentifierEXT</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetShaderModuleIdentifierEXT-shaderModule-parent",
|
|
"text": " <code>shaderModule</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetShaderModuleCreateInfoIdentifierEXT": {
|
|
"(VK_EXT_shader_module_identifier)": [
|
|
{
|
|
"vuid": "VUID-vkGetShaderModuleCreateInfoIdentifierEXT-shaderModuleIdentifier-06885",
|
|
"text": " <a href=\"#features-shaderModuleIdentifier\"><code>shaderModuleIdentifier</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetShaderModuleCreateInfoIdentifierEXT-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetShaderModuleCreateInfoIdentifierEXT-pCreateInfo-parameter",
|
|
"text": " <code>pCreateInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkShaderModuleCreateInfo\">VkShaderModuleCreateInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetShaderModuleCreateInfoIdentifierEXT-pIdentifier-parameter",
|
|
"text": " <code>pIdentifier</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkShaderModuleIdentifierEXT\">VkShaderModuleIdentifierEXT</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkShaderModuleIdentifierEXT": {
|
|
"(VK_EXT_shader_module_identifier)": [
|
|
{
|
|
"vuid": "VUID-VkShaderModuleIdentifierEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_SHADER_MODULE_IDENTIFIER_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkShaderModuleIdentifierEXT-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdSetPatchControlPointsEXT": {
|
|
"(VK_EXT_extended_dynamic_state2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetPatchControlPointsEXT-None-04873",
|
|
"text": " The <a href=\"#features-extendedDynamicState2PatchControlPoints\"><code>extendedDynamicState2PatchControlPoints</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetPatchControlPointsEXT-patchControlPoints-04874",
|
|
"text": " <code>patchControlPoints</code> <strong class=\"purple\">must</strong> be greater than zero and less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxTessellationPatchSize</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetPatchControlPointsEXT-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetPatchControlPointsEXT-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetPatchControlPointsEXT-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetPatchControlPointsEXT-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
]
|
|
},
|
|
"vkGetPhysicalDeviceCooperativeMatrixPropertiesNV": {
|
|
"(VK_NV_cooperative_matrix)": [
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceCooperativeMatrixPropertiesNV-physicalDevice-parameter",
|
|
"text": " <code>physicalDevice</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceCooperativeMatrixPropertiesNV-pPropertyCount-parameter",
|
|
"text": " <code>pPropertyCount</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>uint32_t</code> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceCooperativeMatrixPropertiesNV-pProperties-parameter",
|
|
"text": " If the value referenced by <code>pPropertyCount</code> is not <code>0</code>, and <code>pProperties</code> is not <code>NULL</code>, <code>pProperties</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>pPropertyCount</code> <a href=\"#VkCooperativeMatrixPropertiesNV\">VkCooperativeMatrixPropertiesNV</a> structures"
|
|
}
|
|
]
|
|
},
|
|
"VkCooperativeMatrixPropertiesNV": {
|
|
"(VK_NV_cooperative_matrix)": [
|
|
{
|
|
"vuid": "VUID-VkCooperativeMatrixPropertiesNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_COOPERATIVE_MATRIX_PROPERTIES_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCooperativeMatrixPropertiesNV-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCooperativeMatrixPropertiesNV-AType-parameter",
|
|
"text": " <code>AType</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkComponentTypeNV\">VkComponentTypeNV</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCooperativeMatrixPropertiesNV-BType-parameter",
|
|
"text": " <code>BType</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkComponentTypeNV\">VkComponentTypeNV</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCooperativeMatrixPropertiesNV-CType-parameter",
|
|
"text": " <code>CType</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkComponentTypeNV\">VkComponentTypeNV</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCooperativeMatrixPropertiesNV-DType-parameter",
|
|
"text": " <code>DType</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkComponentTypeNV\">VkComponentTypeNV</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCooperativeMatrixPropertiesNV-scope-parameter",
|
|
"text": " <code>scope</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkScopeNV\">VkScopeNV</a> value"
|
|
}
|
|
]
|
|
},
|
|
"vkCreateValidationCacheEXT": {
|
|
"(VK_EXT_validation_cache)": [
|
|
{
|
|
"vuid": "VUID-vkCreateValidationCacheEXT-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateValidationCacheEXT-pCreateInfo-parameter",
|
|
"text": " <code>pCreateInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkValidationCacheCreateInfoEXT\">VkValidationCacheCreateInfoEXT</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateValidationCacheEXT-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateValidationCacheEXT-pValidationCache-parameter",
|
|
"text": " <code>pValidationCache</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkValidationCacheEXT\">VkValidationCacheEXT</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkValidationCacheCreateInfoEXT": {
|
|
"(VK_EXT_validation_cache)": [
|
|
{
|
|
"vuid": "VUID-VkValidationCacheCreateInfoEXT-initialDataSize-01534",
|
|
"text": " If <code>initialDataSize</code> is not <code>0</code>, it <strong class=\"purple\">must</strong> be equal to the size of <code>pInitialData</code>, as returned by <code>vkGetValidationCacheDataEXT</code> when <code>pInitialData</code> was originally retrieved"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkValidationCacheCreateInfoEXT-initialDataSize-01535",
|
|
"text": " If <code>initialDataSize</code> is not <code>0</code>, <code>pInitialData</code> <strong class=\"purple\">must</strong> have been retrieved from a previous call to <code>vkGetValidationCacheDataEXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkValidationCacheCreateInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_VALIDATION_CACHE_CREATE_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkValidationCacheCreateInfoEXT-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkValidationCacheCreateInfoEXT-flags-zerobitmask",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkValidationCacheCreateInfoEXT-pInitialData-parameter",
|
|
"text": " If <code>initialDataSize</code> is not <code>0</code>, <code>pInitialData</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>initialDataSize</code> bytes"
|
|
}
|
|
]
|
|
},
|
|
"vkMergeValidationCachesEXT": {
|
|
"(VK_EXT_validation_cache)": [
|
|
{
|
|
"vuid": "VUID-vkMergeValidationCachesEXT-dstCache-01536",
|
|
"text": " <code>dstCache</code> <strong class=\"purple\">must</strong> not appear in the list of source caches"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkMergeValidationCachesEXT-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkMergeValidationCachesEXT-dstCache-parameter",
|
|
"text": " <code>dstCache</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkValidationCacheEXT\">VkValidationCacheEXT</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkMergeValidationCachesEXT-pSrcCaches-parameter",
|
|
"text": " <code>pSrcCaches</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>srcCacheCount</code> valid <a href=\"#VkValidationCacheEXT\">VkValidationCacheEXT</a> handles"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkMergeValidationCachesEXT-srcCacheCount-arraylength",
|
|
"text": " <code>srcCacheCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkMergeValidationCachesEXT-dstCache-parent",
|
|
"text": " <code>dstCache</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkMergeValidationCachesEXT-pSrcCaches-parent",
|
|
"text": " Each element of <code>pSrcCaches</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetValidationCacheDataEXT": {
|
|
"(VK_EXT_validation_cache)": [
|
|
{
|
|
"vuid": "VUID-vkGetValidationCacheDataEXT-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetValidationCacheDataEXT-validationCache-parameter",
|
|
"text": " <code>validationCache</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkValidationCacheEXT\">VkValidationCacheEXT</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetValidationCacheDataEXT-pDataSize-parameter",
|
|
"text": " <code>pDataSize</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>size_t</code> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetValidationCacheDataEXT-pData-parameter",
|
|
"text": " If the value referenced by <code>pDataSize</code> is not <code>0</code>, and <code>pData</code> is not <code>NULL</code>, <code>pData</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>pDataSize</code> bytes"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetValidationCacheDataEXT-validationCache-parent",
|
|
"text": " <code>validationCache</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkDestroyValidationCacheEXT": {
|
|
"(VK_EXT_validation_cache)": [
|
|
{
|
|
"vuid": "VUID-vkDestroyValidationCacheEXT-validationCache-01537",
|
|
"text": " If <code>VkAllocationCallbacks</code> were provided when <code>validationCache</code> was created, a compatible set of callbacks <strong class=\"purple\">must</strong> be provided here"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyValidationCacheEXT-validationCache-01538",
|
|
"text": " If no <code>VkAllocationCallbacks</code> were provided when <code>validationCache</code> was created, <code>pAllocator</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyValidationCacheEXT-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyValidationCacheEXT-validationCache-parameter",
|
|
"text": " If <code>validationCache</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>validationCache</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkValidationCacheEXT\">VkValidationCacheEXT</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyValidationCacheEXT-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyValidationCacheEXT-validationCache-parent",
|
|
"text": " If <code>validationCache</code> is a valid handle, it <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCreateComputePipelines": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCreateComputePipelines-flags-00695",
|
|
"text": " If the <code>flags</code> member of any element of <code>pCreateInfos</code> contains the <code>VK_PIPELINE_CREATE_DERIVATIVE_BIT</code> flag, and the <code>basePipelineIndex</code> member of that same element is not <code>-1</code>, <code>basePipelineIndex</code> <strong class=\"purple\">must</strong> be less than the index into <code>pCreateInfos</code> that corresponds to that element"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateComputePipelines-flags-00696",
|
|
"text": " If the <code>flags</code> member of any element of <code>pCreateInfos</code> contains the <code>VK_PIPELINE_CREATE_DERIVATIVE_BIT</code> flag, the base pipeline <strong class=\"purple\">must</strong> have been created with the <code>VK_PIPELINE_CREATE_ALLOW_DERIVATIVES_BIT</code> flag set"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateComputePipelines-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateComputePipelines-pipelineCache-parameter",
|
|
"text": " If <code>pipelineCache</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>pipelineCache</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPipelineCache\">VkPipelineCache</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateComputePipelines-pCreateInfos-parameter",
|
|
"text": " <code>pCreateInfos</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>createInfoCount</code> valid <a href=\"#VkComputePipelineCreateInfo\">VkComputePipelineCreateInfo</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateComputePipelines-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateComputePipelines-pPipelines-parameter",
|
|
"text": " <code>pPipelines</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>createInfoCount</code> <a href=\"#VkPipeline\">VkPipeline</a> handles"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateComputePipelines-createInfoCount-arraylength",
|
|
"text": " <code>createInfoCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateComputePipelines-pipelineCache-parent",
|
|
"text": " If <code>pipelineCache</code> is a valid handle, it <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_pipeline_creation_cache_control)": [
|
|
{
|
|
"vuid": "VUID-vkCreateComputePipelines-pipelineCache-02873",
|
|
"text": " If <code>pipelineCache</code> was created with <code>VK_PIPELINE_CACHE_CREATE_EXTERNALLY_SYNCHRONIZED_BIT</code>, host access to <code>pipelineCache</code> <strong class=\"purple\">must</strong> be <a href=\"#fundamentals-threadingbehavior\">externally synchronized</a>"
|
|
}
|
|
]
|
|
},
|
|
"VkComputePipelineCreateInfo": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkComputePipelineCreateInfo-flags-00697",
|
|
"text": " If <code>flags</code> contains the <code>VK_PIPELINE_CREATE_DERIVATIVE_BIT</code> flag, and <code>basePipelineIndex</code> is -1, <code>basePipelineHandle</code> <strong class=\"purple\">must</strong> be a valid handle to a compute <code>VkPipeline</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkComputePipelineCreateInfo-flags-00698",
|
|
"text": " If <code>flags</code> contains the <code>VK_PIPELINE_CREATE_DERIVATIVE_BIT</code> flag, and <code>basePipelineHandle</code> is <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>basePipelineIndex</code> <strong class=\"purple\">must</strong> be a valid index into the calling command’s <code>pCreateInfos</code> parameter"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkComputePipelineCreateInfo-flags-00699",
|
|
"text": " If <code>flags</code> contains the <code>VK_PIPELINE_CREATE_DERIVATIVE_BIT</code> flag, and <code>basePipelineIndex</code> is not -1, <code>basePipelineHandle</code> <strong class=\"purple\">must</strong> be <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkComputePipelineCreateInfo-flags-00700",
|
|
"text": " If <code>flags</code> contains the <code>VK_PIPELINE_CREATE_DERIVATIVE_BIT</code> flag, and <code>basePipelineHandle</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>basePipelineIndex</code> <strong class=\"purple\">must</strong> be -1"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkComputePipelineCreateInfo-stage-00701",
|
|
"text": " The <code>stage</code> member of <code>stage</code> <strong class=\"purple\">must</strong> be <code>VK_SHADER_STAGE_COMPUTE_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkComputePipelineCreateInfo-stage-00702",
|
|
"text": " The shader code for the entry point identified by <code>stage</code> and the rest of the state identified by this structure <strong class=\"purple\">must</strong> adhere to the pipeline linking rules described in the <a href=\"#interfaces\">Shader Interfaces</a> chapter"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkComputePipelineCreateInfo-layout-00703",
|
|
"text": " <code>layout</code> <strong class=\"purple\">must</strong> be <a href=\"#descriptorsets-pipelinelayout-consistency\">consistent</a> with the layout of the compute shader specified in <code>stage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkComputePipelineCreateInfo-layout-01687",
|
|
"text": " The number of resources in <code>layout</code> accessible to the compute shader stage <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxPerStageResources</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkComputePipelineCreateInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_COMPUTE_PIPELINE_CREATE_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkComputePipelineCreateInfo-pNext-pNext",
|
|
"text": " Each <code>pNext</code> member of any structure (including this one) in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be either <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkPipelineCompilerControlCreateInfoAMD\">VkPipelineCompilerControlCreateInfoAMD</a>, <a href=\"#VkPipelineCreationFeedbackCreateInfo\">VkPipelineCreationFeedbackCreateInfo</a>, <a href=\"#VkPipelineRobustnessCreateInfoEXT\">VkPipelineRobustnessCreateInfoEXT</a>, or <a href=\"#VkSubpassShadingPipelineCreateInfoHUAWEI\">VkSubpassShadingPipelineCreateInfoHUAWEI</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkComputePipelineCreateInfo-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkComputePipelineCreateInfo-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkPipelineCreateFlagBits\">VkPipelineCreateFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkComputePipelineCreateInfo-stage-parameter",
|
|
"text": " <code>stage</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPipelineShaderStageCreateInfo\">VkPipelineShaderStageCreateInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkComputePipelineCreateInfo-layout-parameter",
|
|
"text": " <code>layout</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPipelineLayout\">VkPipelineLayout</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkComputePipelineCreateInfo-commonparent",
|
|
"text": " Both of <code>basePipelineHandle</code>, and <code>layout</code> that are valid handles of non-ignored parameters <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"(VK_KHR_pipeline_library)": [
|
|
{
|
|
"vuid": "VUID-VkComputePipelineCreateInfo-flags-03364",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> not include <code>VK_PIPELINE_CREATE_LIBRARY_BIT_KHR</code>"
|
|
}
|
|
],
|
|
"(VK_KHR_ray_tracing_pipeline)": [
|
|
{
|
|
"vuid": "VUID-VkComputePipelineCreateInfo-flags-03365",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> not include <code>VK_PIPELINE_CREATE_RAY_TRACING_NO_NULL_ANY_HIT_SHADERS_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkComputePipelineCreateInfo-flags-03366",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> not include <code>VK_PIPELINE_CREATE_RAY_TRACING_NO_NULL_CLOSEST_HIT_SHADERS_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkComputePipelineCreateInfo-flags-03367",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> not include <code>VK_PIPELINE_CREATE_RAY_TRACING_NO_NULL_MISS_SHADERS_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkComputePipelineCreateInfo-flags-03368",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> not include <code>VK_PIPELINE_CREATE_RAY_TRACING_NO_NULL_INTERSECTION_SHADERS_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkComputePipelineCreateInfo-flags-03369",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> not include <code>VK_PIPELINE_CREATE_RAY_TRACING_SKIP_TRIANGLES_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkComputePipelineCreateInfo-flags-03370",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> not include <code>VK_PIPELINE_CREATE_RAY_TRACING_SKIP_AABBS_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkComputePipelineCreateInfo-flags-03576",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> not include <code>VK_PIPELINE_CREATE_RAY_TRACING_SHADER_GROUP_HANDLE_CAPTURE_REPLAY_BIT_KHR</code>"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing_motion_blur)": [
|
|
{
|
|
"vuid": "VUID-VkComputePipelineCreateInfo-flags-04945",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> not include <code>VK_PIPELINE_CREATE_RAY_TRACING_ALLOW_MOTION_BIT_NV</code>"
|
|
}
|
|
],
|
|
"(VK_NV_device_generated_commands)": [
|
|
{
|
|
"vuid": "VUID-VkComputePipelineCreateInfo-flags-02874",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> not include <code>VK_PIPELINE_CREATE_INDIRECT_BINDABLE_BIT_NV</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_pipeline_creation_cache_control)": [
|
|
{
|
|
"vuid": "VUID-VkComputePipelineCreateInfo-pipelineCreationCacheControl-02875",
|
|
"text": " If the <a href=\"#features-pipelineCreationCacheControl\"><code>pipelineCreationCacheControl</code></a> feature is not enabled, <code>flags</code> <strong class=\"purple\">must</strong> not include <code>VK_PIPELINE_CREATE_FAIL_ON_PIPELINE_COMPILE_REQUIRED_BIT</code> or <code>VK_PIPELINE_CREATE_EARLY_RETURN_ON_FAILURE_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_pipeline_creation_feedback,VK_VERSION_1_3)": [
|
|
{
|
|
"vuid": "VUID-VkComputePipelineCreateInfo-pipelineStageCreationFeedbackCount-06566",
|
|
"text": " If <a href=\"#VkPipelineCreationFeedbackCreateInfo\">VkPipelineCreationFeedbackCreateInfo</a>::<code>pipelineStageCreationFeedbackCount</code> is not <code>0</code>, it <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPipelineShaderStageCreateInfo": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkPipelineShaderStageCreateInfo-stage-00704",
|
|
"text": " If the <a href=\"#features-geometryShader\"><code>geometryShader</code></a> feature is not enabled, <code>stage</code> <strong class=\"purple\">must</strong> not be <code>VK_SHADER_STAGE_GEOMETRY_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineShaderStageCreateInfo-stage-00705",
|
|
"text": " If the <a href=\"#features-tessellationShader\"><code>tessellationShader</code></a> feature is not enabled, <code>stage</code> <strong class=\"purple\">must</strong> not be <code>VK_SHADER_STAGE_TESSELLATION_CONTROL_BIT</code> or <code>VK_SHADER_STAGE_TESSELLATION_EVALUATION_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineShaderStageCreateInfo-stage-00706",
|
|
"text": " <code>stage</code> <strong class=\"purple\">must</strong> not be <code>VK_SHADER_STAGE_ALL_GRAPHICS</code>, or <code>VK_SHADER_STAGE_ALL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineShaderStageCreateInfo-pName-00707",
|
|
"text": " <code>pName</code> <strong class=\"purple\">must</strong> be the name of an <code>OpEntryPoint</code> in <code>module</code> with an execution model that matches <code>stage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineShaderStageCreateInfo-maxClipDistances-00708",
|
|
"text": " If the identified entry point includes any variable in its interface that is declared with the <code>ClipDistance</code> <code>BuiltIn</code> decoration, that variable <strong class=\"purple\">must</strong> not have an array size greater than <code>VkPhysicalDeviceLimits</code>::<code>maxClipDistances</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineShaderStageCreateInfo-maxCullDistances-00709",
|
|
"text": " If the identified entry point includes any variable in its interface that is declared with the <code>CullDistance</code> <code>BuiltIn</code> decoration, that variable <strong class=\"purple\">must</strong> not have an array size greater than <code>VkPhysicalDeviceLimits</code>::<code>maxCullDistances</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineShaderStageCreateInfo-maxCombinedClipAndCullDistances-00710",
|
|
"text": " If the identified entry point includes any variables in its interface that are declared with the <code>ClipDistance</code> or <code>CullDistance</code> <code>BuiltIn</code> decoration, those variables <strong class=\"purple\">must</strong> not have array sizes which sum to more than <code>VkPhysicalDeviceLimits</code>::<code>maxCombinedClipAndCullDistances</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineShaderStageCreateInfo-maxSampleMaskWords-00711",
|
|
"text": " If the identified entry point includes any variable in its interface that is declared with the <code>SampleMask</code> <code>BuiltIn</code> decoration, that variable <strong class=\"purple\">must</strong> not have an array size greater than <code>VkPhysicalDeviceLimits</code>::<code>maxSampleMaskWords</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineShaderStageCreateInfo-stage-00712",
|
|
"text": " If <code>stage</code> is <code>VK_SHADER_STAGE_VERTEX_BIT</code>, the identified entry point <strong class=\"purple\">must</strong> not include any input variable in its interface that is decorated with <code>CullDistance</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineShaderStageCreateInfo-stage-00713",
|
|
"text": " If <code>stage</code> is <code>VK_SHADER_STAGE_TESSELLATION_CONTROL_BIT</code> or <code>VK_SHADER_STAGE_TESSELLATION_EVALUATION_BIT</code>, and the identified entry point has an <code>OpExecutionMode</code> instruction specifying a patch size with <code>OutputVertices</code>, the patch size <strong class=\"purple\">must</strong> be greater than <code>0</code> and less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxTessellationPatchSize</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineShaderStageCreateInfo-stage-00714",
|
|
"text": " If <code>stage</code> is <code>VK_SHADER_STAGE_GEOMETRY_BIT</code>, the identified entry point <strong class=\"purple\">must</strong> have an <code>OpExecutionMode</code> instruction specifying a maximum output vertex count that is greater than <code>0</code> and less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxGeometryOutputVertices</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineShaderStageCreateInfo-stage-00715",
|
|
"text": " If <code>stage</code> is <code>VK_SHADER_STAGE_GEOMETRY_BIT</code>, the identified entry point <strong class=\"purple\">must</strong> have an <code>OpExecutionMode</code> instruction specifying an invocation count that is greater than <code>0</code> and less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxGeometryShaderInvocations</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineShaderStageCreateInfo-stage-02596",
|
|
"text": " If <code>stage</code> is a <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader stage</a>, and the identified entry point writes to <code>Layer</code> for any primitive, it <strong class=\"purple\">must</strong> write the same value to <code>Layer</code> for all vertices of a given primitive"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineShaderStageCreateInfo-stage-02597",
|
|
"text": " If <code>stage</code> is a <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader stage</a>, and the identified entry point writes to <code>ViewportIndex</code> for any primitive, it <strong class=\"purple\">must</strong> write the same value to <code>ViewportIndex</code> for all vertices of a given primitive"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineShaderStageCreateInfo-stage-00718",
|
|
"text": " If <code>stage</code> is <code>VK_SHADER_STAGE_FRAGMENT_BIT</code>, the identified entry point <strong class=\"purple\">must</strong> not include any output variables in its interface decorated with <code>CullDistance</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineShaderStageCreateInfo-stage-06685",
|
|
"text": " If <code>stage</code> is <code>VK_SHADER_STAGE_FRAGMENT_BIT</code>, and the identified entry point writes to <code>FragDepth</code> in any execution path, all execution paths that are not exclusive to helper invocations <strong class=\"purple\">must</strong> either discard the fragment, or write or initialize the value of <code>FragDepth</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineShaderStageCreateInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PIPELINE_SHADER_STAGE_CREATE_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineShaderStageCreateInfo-pNext-pNext",
|
|
"text": " Each <code>pNext</code> member of any structure (including this one) in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be either <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkDebugUtilsObjectNameInfoEXT\">VkDebugUtilsObjectNameInfoEXT</a>, <a href=\"#VkPipelineRobustnessCreateInfoEXT\">VkPipelineRobustnessCreateInfoEXT</a>, <a href=\"#VkPipelineShaderStageModuleIdentifierCreateInfoEXT\">VkPipelineShaderStageModuleIdentifierCreateInfoEXT</a>, <a href=\"#VkPipelineShaderStageRequiredSubgroupSizeCreateInfo\">VkPipelineShaderStageRequiredSubgroupSizeCreateInfo</a>, <a href=\"#VkShaderModuleCreateInfo\">VkShaderModuleCreateInfo</a>, or <a href=\"#VkShaderModuleValidationCacheCreateInfoEXT\">VkShaderModuleValidationCacheCreateInfoEXT</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineShaderStageCreateInfo-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineShaderStageCreateInfo-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkPipelineShaderStageCreateFlagBits\">VkPipelineShaderStageCreateFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineShaderStageCreateInfo-stage-parameter",
|
|
"text": " <code>stage</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkShaderStageFlagBits\">VkShaderStageFlagBits</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineShaderStageCreateInfo-module-parameter",
|
|
"text": " If <code>module</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>module</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkShaderModule\">VkShaderModule</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineShaderStageCreateInfo-pName-parameter",
|
|
"text": " <code>pName</code> <strong class=\"purple\">must</strong> be a null-terminated UTF-8 string"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineShaderStageCreateInfo-pSpecializationInfo-parameter",
|
|
"text": " If <code>pSpecializationInfo</code> is not <code>NULL</code>, <code>pSpecializationInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkSpecializationInfo\">VkSpecializationInfo</a> structure"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineShaderStageCreateInfo-stage-02091",
|
|
"text": " If the <a href=\"#features-meshShader\"><code>meshShader</code></a> feature is not enabled, <code>stage</code> <strong class=\"purple\">must</strong> not be <code>VK_SHADER_STAGE_MESH_BIT_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineShaderStageCreateInfo-stage-02092",
|
|
"text": " If the <a href=\"#features-taskShader\"><code>taskShader</code></a> feature is not enabled, <code>stage</code> <strong class=\"purple\">must</strong> not be <code>VK_SHADER_STAGE_TASK_BIT_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineShaderStageCreateInfo-stage-02093",
|
|
"text": " If <code>stage</code> is <code>VK_SHADER_STAGE_MESH_BIT_NV</code>, the identified entry point <strong class=\"purple\">must</strong> have an <code>OpExecutionMode</code> instruction specifying a maximum output vertex count, <code>OutputVertices</code>, that is greater than <code>0</code> and less than or equal to <code>VkPhysicalDeviceMeshShaderPropertiesNV</code>::<code>maxMeshOutputVertices</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineShaderStageCreateInfo-stage-02094",
|
|
"text": " If <code>stage</code> is <code>VK_SHADER_STAGE_MESH_BIT_NV</code>, the identified entry point <strong class=\"purple\">must</strong> have an <code>OpExecutionMode</code> instruction specifying a maximum output primitive count, <code>OutputPrimitivesNV</code>, that is greater than <code>0</code> and less than or equal to <code>VkPhysicalDeviceMeshShaderPropertiesNV</code>::<code>maxMeshOutputPrimitives</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_shader_stencil_export)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineShaderStageCreateInfo-stage-06686",
|
|
"text": " If <code>stage</code> is <code>VK_SHADER_STAGE_FRAGMENT_BIT</code>, and the identified entry point writes to <code>FragStencilRefEXT</code> in any execution path, all execution paths that are not exclusive to helper invocations <strong class=\"purple\">must</strong> either discard the fragment, or write or initialize the value of <code>FragStencilRefEXT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_subgroup_size_control)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineShaderStageCreateInfo-flags-02784",
|
|
"text": " If <code>flags</code> has the <code>VK_PIPELINE_SHADER_STAGE_CREATE_ALLOW_VARYING_SUBGROUP_SIZE_BIT</code> flag set, the <a href=\"#features-subgroupSizeControl\"><code>subgroupSizeControl</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineShaderStageCreateInfo-flags-02785",
|
|
"text": " If <code>flags</code> has the <code>VK_PIPELINE_SHADER_STAGE_CREATE_REQUIRE_FULL_SUBGROUPS_BIT</code> flag set, the <a href=\"#features-computeFullSubgroups\"><code>computeFullSubgroups</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineShaderStageCreateInfo-pNext-02754",
|
|
"text": " If a <a href=\"#VkPipelineShaderStageRequiredSubgroupSizeCreateInfo\">VkPipelineShaderStageRequiredSubgroupSizeCreateInfo</a> structure is included in the <code>pNext</code> chain, <code>flags</code> <strong class=\"purple\">must</strong> not have the <code>VK_PIPELINE_SHADER_STAGE_CREATE_ALLOW_VARYING_SUBGROUP_SIZE_BIT</code> flag set"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineShaderStageCreateInfo-pNext-02755",
|
|
"text": " If a <a href=\"#VkPipelineShaderStageRequiredSubgroupSizeCreateInfo\">VkPipelineShaderStageRequiredSubgroupSizeCreateInfo</a> structure is included in the <code>pNext</code> chain, the <a href=\"#features-subgroupSizeControl\"><code>subgroupSizeControl</code></a> feature <strong class=\"purple\">must</strong> be enabled, and <code>stage</code> <strong class=\"purple\">must</strong> be a valid bit specified in <a href=\"#limits-requiredSubgroupSizeStages\"><code>requiredSubgroupSizeStages</code></a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineShaderStageCreateInfo-pNext-02756",
|
|
"text": " If a <a href=\"#VkPipelineShaderStageRequiredSubgroupSizeCreateInfo\">VkPipelineShaderStageRequiredSubgroupSizeCreateInfo</a> structure is included in the <code>pNext</code> chain and <code>stage</code> is <code>VK_SHADER_STAGE_COMPUTE_BIT</code>, the local workgroup size of the shader <strong class=\"purple\">must</strong> be less than or equal to the product of <a href=\"#VkPipelineShaderStageRequiredSubgroupSizeCreateInfo\">VkPipelineShaderStageRequiredSubgroupSizeCreateInfo</a>::<code>requiredSubgroupSize</code> and <a href=\"#limits-maxComputeWorkgroupSubgroups\"><code>maxComputeWorkgroupSubgroups</code></a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineShaderStageCreateInfo-pNext-02757",
|
|
"text": " If a <a href=\"#VkPipelineShaderStageRequiredSubgroupSizeCreateInfo\">VkPipelineShaderStageRequiredSubgroupSizeCreateInfo</a> structure is included in the <code>pNext</code> chain, and <code>flags</code> has the <code>VK_PIPELINE_SHADER_STAGE_CREATE_REQUIRE_FULL_SUBGROUPS_BIT</code> flag set, the local workgroup size in the X dimension of the pipeline <strong class=\"purple\">must</strong> be a multiple of <a href=\"#VkPipelineShaderStageRequiredSubgroupSizeCreateInfo\">VkPipelineShaderStageRequiredSubgroupSizeCreateInfo</a>::<code>requiredSubgroupSize</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineShaderStageCreateInfo-flags-02758",
|
|
"text": " If <code>flags</code> has both the <code>VK_PIPELINE_SHADER_STAGE_CREATE_REQUIRE_FULL_SUBGROUPS_BIT</code> and <code>VK_PIPELINE_SHADER_STAGE_CREATE_ALLOW_VARYING_SUBGROUP_SIZE_BIT</code> flags set, the local workgroup size in the X dimension of the pipeline <strong class=\"purple\">must</strong> be a multiple of <a href=\"#limits-maxSubgroupSize\"><code>maxSubgroupSize</code></a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineShaderStageCreateInfo-flags-02759",
|
|
"text": " If <code>flags</code> has the <code>VK_PIPELINE_SHADER_STAGE_CREATE_REQUIRE_FULL_SUBGROUPS_BIT</code> flag set and <code>flags</code> does not have the <code>VK_PIPELINE_SHADER_STAGE_CREATE_ALLOW_VARYING_SUBGROUP_SIZE_BIT</code> flag set and no <a href=\"#VkPipelineShaderStageRequiredSubgroupSizeCreateInfo\">VkPipelineShaderStageRequiredSubgroupSizeCreateInfo</a> structure is included in the <code>pNext</code> chain, the local workgroup size in the X dimension of the pipeline <strong class=\"purple\">must</strong> be a multiple of <a href=\"#limits-subgroup-size\"><code>subgroupSize</code></a>"
|
|
}
|
|
],
|
|
"!(VK_EXT_graphics_pipeline_library+VK_EXT_shader_module_identifier)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineShaderStageCreateInfo-module-06716",
|
|
"text": " <code>module</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkShaderModule\">VkShaderModule</a>"
|
|
}
|
|
],
|
|
"(VK_EXT_shader_module_identifier)+(VK_EXT_graphics_pipeline_library)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineShaderStageCreateInfo-stage-06844",
|
|
"text": " If a shader module identifier is specified for this <code>stage</code>, a <a href=\"#VkShaderModuleCreateInfo\">VkShaderModuleCreateInfo</a> structure <strong class=\"purple\">must</strong> not be present in the <code>pNext</code> chain"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineShaderStageCreateInfo-stage-06845",
|
|
"text": " If a shader module identifier is not specified for this <code>stage</code>, <code>module</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkShaderModule\">VkShaderModule</a> or there <strong class=\"purple\">must</strong> be a valid <a href=\"#VkShaderModuleCreateInfo\">VkShaderModuleCreateInfo</a> structure in the <code>pNext</code> chain"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineShaderStageCreateInfo-stage-06846",
|
|
"text": " If a shader module identifier is not specified for this <code>stage</code>, and the <a href=\"#features-graphicsPipelineLibrary\"><code>graphicsPipelineLibrary</code></a> feature is not enabled, <code>module</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkShaderModule\">VkShaderModule</a>"
|
|
}
|
|
],
|
|
"(VK_EXT_shader_module_identifier)+!(VK_EXT_graphics_pipeline_library)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineShaderStageCreateInfo-stage-06847",
|
|
"text": " If a shader identifier is not specified for this <code>stage</code>, <code>module</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkShaderModule\">VkShaderModule</a>"
|
|
}
|
|
],
|
|
"(VK_EXT_shader_module_identifier)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineShaderStageCreateInfo-stage-06848",
|
|
"text": " If a shader module identifier is specified for this <code>stage</code>, <code>module</code> <strong class=\"purple\">must</strong> be <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineShaderStageCreateInfo-pSpecializationInfo-06849",
|
|
"text": " If a shader module identifier is not specified, the shader code used by the pipeline <strong class=\"purple\">must</strong> be valid as described by the <a href=\"#spirv-spec\">Khronos SPIR-V Specification</a> after applying the specializations provided in <code>pSpecializationInfo</code>, if any, and then converting all specialization constants into fixed constants"
|
|
}
|
|
],
|
|
"!(VK_EXT_shader_module_identifier)+(VK_EXT_graphics_pipeline_library)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineShaderStageCreateInfo-graphicsPipelineLibrary-06717",
|
|
"text": " If the <a href=\"#features-graphicsPipelineLibrary\"><code>graphicsPipelineLibrary</code></a> feature is not enabled, <code>module</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkShaderModule\">VkShaderModule</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineShaderStageCreateInfo-module-06718",
|
|
"text": " If <code>module</code> is <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, there <strong class=\"purple\">must</strong> be a valid <a href=\"#VkShaderModuleCreateInfo\">VkShaderModuleCreateInfo</a> structure in the <code>pNext</code> chain"
|
|
}
|
|
],
|
|
"!(VK_EXT_shader_module_identifier)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineShaderStageCreateInfo-pSpecializationInfo-06719",
|
|
"text": " The shader code used by the pipeline <strong class=\"purple\">must</strong> be valid as described by the <a href=\"#spirv-spec\">Khronos SPIR-V Specification</a> after applying the specializations provided in <code>pSpecializationInfo</code>, if any, and then converting all specialization constants into fixed constants"
|
|
}
|
|
]
|
|
},
|
|
"VkPipelineShaderStageRequiredSubgroupSizeCreateInfo": {
|
|
"(VK_VERSION_1_3,VK_EXT_subgroup_size_control)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineShaderStageRequiredSubgroupSizeCreateInfo-requiredSubgroupSize-02760",
|
|
"text": " <code>requiredSubgroupSize</code> <strong class=\"purple\">must</strong> be a power-of-two integer"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineShaderStageRequiredSubgroupSizeCreateInfo-requiredSubgroupSize-02761",
|
|
"text": " <code>requiredSubgroupSize</code> <strong class=\"purple\">must</strong> be greater or equal to <a href=\"#limits-minSubgroupSize\"><code>minSubgroupSize</code></a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineShaderStageRequiredSubgroupSizeCreateInfo-requiredSubgroupSize-02762",
|
|
"text": " <code>requiredSubgroupSize</code> <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#limits-maxSubgroupSize\"><code>maxSubgroupSize</code></a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineShaderStageRequiredSubgroupSizeCreateInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PIPELINE_SHADER_STAGE_REQUIRED_SUBGROUP_SIZE_CREATE_INFO</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkSubpassShadingPipelineCreateInfoHUAWEI": {
|
|
"(VK_HUAWEI_subpass_shading)": [
|
|
{
|
|
"vuid": "VUID-VkSubpassShadingPipelineCreateInfoHUAWEI-subpass-04946",
|
|
"text": " <code>subpass</code> <strong class=\"purple\">must</strong> be created with <code>VK_PIPELINE_BIND_POINT_SUBPASS_SHADING_HUAWEI</code> bind point"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubpassShadingPipelineCreateInfoHUAWEI-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_SUBPASS_SHADING_PIPELINE_CREATE_INFO_HUAWEI</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetDeviceSubpassShadingMaxWorkgroupSizeHUAWEI": {
|
|
"(VK_HUAWEI_subpass_shading)": [
|
|
{
|
|
"vuid": "VUID-vkGetDeviceSubpassShadingMaxWorkgroupSizeHUAWEI-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDeviceSubpassShadingMaxWorkgroupSizeHUAWEI-renderpass-parameter",
|
|
"text": " <code>renderpass</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkRenderPass\">VkRenderPass</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDeviceSubpassShadingMaxWorkgroupSizeHUAWEI-pMaxWorkgroupSize-parameter",
|
|
"text": " <code>pMaxWorkgroupSize</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkExtent2D\">VkExtent2D</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDeviceSubpassShadingMaxWorkgroupSizeHUAWEI-renderpass-parent",
|
|
"text": " <code>renderpass</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPipelineRobustnessCreateInfoEXT": {
|
|
"(VK_EXT_pipeline_robustness)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineRobustnessCreateInfoEXT-pipelineRobustness-06926",
|
|
"text": " If the <a href=\"#features-pipelineRobustness\"><code>pipelineRobustness</code></a> feature is not enabled, <code>storageBuffers</code> <strong class=\"purple\">must</strong> be <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_DEVICE_DEFAULT_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineRobustnessCreateInfoEXT-pipelineRobustness-06927",
|
|
"text": " If the <a href=\"#features-pipelineRobustness\"><code>pipelineRobustness</code></a> feature is not enabled, <code>uniformBuffers</code> <strong class=\"purple\">must</strong> be <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_DEVICE_DEFAULT_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineRobustnessCreateInfoEXT-pipelineRobustness-06928",
|
|
"text": " If the <a href=\"#features-pipelineRobustness\"><code>pipelineRobustness</code></a> feature is not enabled, <code>vertexInputs</code> <strong class=\"purple\">must</strong> be <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_DEVICE_DEFAULT_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineRobustnessCreateInfoEXT-pipelineRobustness-06929",
|
|
"text": " If the <a href=\"#features-pipelineRobustness\"><code>pipelineRobustness</code></a> feature is not enabled, <code>images</code> <strong class=\"purple\">must</strong> be <code>VK_PIPELINE_ROBUSTNESS_IMAGE_BEHAVIOR_DEVICE_DEFAULT_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineRobustnessCreateInfoEXT-robustImageAccess-06930",
|
|
"text": " If the <a href=\"#features-robustImageAccess\"><code>robustImageAccess</code></a> feature is not supported, <code>images</code> <strong class=\"purple\">must</strong> not be <code>VK_PIPELINE_ROBUSTNESS_IMAGE_BEHAVIOR_ROBUST_IMAGE_ACCESS_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineRobustnessCreateInfoEXT-robustBufferAccess2-06931",
|
|
"text": " If the <a href=\"#features-robustBufferAccess2\"><code>robustBufferAccess2</code></a> feature is not supported, <code>storageBuffers</code> <strong class=\"purple\">must</strong> not be <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineRobustnessCreateInfoEXT-robustBufferAccess2-06932",
|
|
"text": " If the <a href=\"#features-robustBufferAccess2\"><code>robustBufferAccess2</code></a> feature is not supported, <code>uniformBuffers</code> <strong class=\"purple\">must</strong> not be <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineRobustnessCreateInfoEXT-robustBufferAccess2-06933",
|
|
"text": " If the <a href=\"#features-robustBufferAccess2\"><code>robustBufferAccess2</code></a> feature is not supported, <code>vertexInputs</code> <strong class=\"purple\">must</strong> not be <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineRobustnessCreateInfoEXT-robustImageAccess2-06934",
|
|
"text": " If the <a href=\"#features-robustImageAccess2\"><code>robustImageAccess2</code></a> feature is not supported, <code>images</code> <strong class=\"purple\">must</strong> not be <code>VK_PIPELINE_ROBUSTNESS_IMAGE_BEHAVIOR_ROBUST_IMAGE_ACCESS_2_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineRobustnessCreateInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PIPELINE_ROBUSTNESS_CREATE_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineRobustnessCreateInfoEXT-storageBuffers-parameter",
|
|
"text": " <code>storageBuffers</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPipelineRobustnessBufferBehaviorEXT\">VkPipelineRobustnessBufferBehaviorEXT</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineRobustnessCreateInfoEXT-uniformBuffers-parameter",
|
|
"text": " <code>uniformBuffers</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPipelineRobustnessBufferBehaviorEXT\">VkPipelineRobustnessBufferBehaviorEXT</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineRobustnessCreateInfoEXT-vertexInputs-parameter",
|
|
"text": " <code>vertexInputs</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPipelineRobustnessBufferBehaviorEXT\">VkPipelineRobustnessBufferBehaviorEXT</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineRobustnessCreateInfoEXT-images-parameter",
|
|
"text": " <code>images</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPipelineRobustnessImageBehaviorEXT\">VkPipelineRobustnessImageBehaviorEXT</a> value"
|
|
}
|
|
]
|
|
},
|
|
"VkPipelineShaderStageModuleIdentifierCreateInfoEXT": {
|
|
"(VK_EXT_shader_module_identifier)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineShaderStageModuleIdentifierCreateInfoEXT-pNext-06850",
|
|
"text": " If this structure is included in a <code>pNext</code> chain and <code>identifierSize</code> is not equal to 0, the <a href=\"#features-shaderModuleIdentifier\"><code>shaderModuleIdentifier</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineShaderStageModuleIdentifierCreateInfoEXT-pNext-06851",
|
|
"text": " If this struct is included in a <code>pNext</code> chain of <a href=\"#VkPipelineShaderStageCreateInfo\">VkPipelineShaderStageCreateInfo</a> and <code>identifierSize</code> is not equal to 0, the pipeline <strong class=\"purple\">must</strong> be created with the <code>VK_PIPELINE_CREATE_FAIL_ON_PIPELINE_COMPILE_REQUIRED_BIT</code> flag set"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineShaderStageModuleIdentifierCreateInfoEXT-identifierSize-06852",
|
|
"text": " <code>identifierSize</code> <strong class=\"purple\">must</strong> be less-or-equal to <code>VK_MAX_SHADER_MODULE_IDENTIFIER_SIZE_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineShaderStageModuleIdentifierCreateInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PIPELINE_SHADER_STAGE_MODULE_IDENTIFIER_CREATE_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineShaderStageModuleIdentifierCreateInfoEXT-pIdentifier-parameter",
|
|
"text": " If <code>identifierSize</code> is not <code>0</code>, <code>pIdentifier</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>identifierSize</code> <code>uint8_t</code> values"
|
|
}
|
|
]
|
|
},
|
|
"vkCreateGraphicsPipelines": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCreateGraphicsPipelines-flags-00720",
|
|
"text": " If the <code>flags</code> member of any element of <code>pCreateInfos</code> contains the <code>VK_PIPELINE_CREATE_DERIVATIVE_BIT</code> flag, and the <code>basePipelineIndex</code> member of that same element is not <code>-1</code>, <code>basePipelineIndex</code> <strong class=\"purple\">must</strong> be less than the index into <code>pCreateInfos</code> that corresponds to that element"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateGraphicsPipelines-flags-00721",
|
|
"text": " If the <code>flags</code> member of any element of <code>pCreateInfos</code> contains the <code>VK_PIPELINE_CREATE_DERIVATIVE_BIT</code> flag, the base pipeline <strong class=\"purple\">must</strong> have been created with the <code>VK_PIPELINE_CREATE_ALLOW_DERIVATIVES_BIT</code> flag set"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateGraphicsPipelines-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateGraphicsPipelines-pipelineCache-parameter",
|
|
"text": " If <code>pipelineCache</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>pipelineCache</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPipelineCache\">VkPipelineCache</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateGraphicsPipelines-pCreateInfos-parameter",
|
|
"text": " <code>pCreateInfos</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>createInfoCount</code> valid <a href=\"#VkGraphicsPipelineCreateInfo\">VkGraphicsPipelineCreateInfo</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateGraphicsPipelines-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateGraphicsPipelines-pPipelines-parameter",
|
|
"text": " <code>pPipelines</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>createInfoCount</code> <a href=\"#VkPipeline\">VkPipeline</a> handles"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateGraphicsPipelines-createInfoCount-arraylength",
|
|
"text": " <code>createInfoCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateGraphicsPipelines-pipelineCache-parent",
|
|
"text": " If <code>pipelineCache</code> is a valid handle, it <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_pipeline_creation_cache_control)": [
|
|
{
|
|
"vuid": "VUID-vkCreateGraphicsPipelines-pipelineCache-02876",
|
|
"text": " If <code>pipelineCache</code> was created with <code>VK_PIPELINE_CACHE_CREATE_EXTERNALLY_SYNCHRONIZED_BIT</code>, host access to <code>pipelineCache</code> <strong class=\"purple\">must</strong> be <a href=\"#fundamentals-threadingbehavior\">externally synchronized</a>"
|
|
}
|
|
]
|
|
},
|
|
"VkGraphicsPipelineCreateInfo": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-flags-00722",
|
|
"text": " If <code>flags</code> contains the <code>VK_PIPELINE_CREATE_DERIVATIVE_BIT</code> flag, and <code>basePipelineIndex</code> is -1, <code>basePipelineHandle</code> <strong class=\"purple\">must</strong> be a valid handle to a graphics <code>VkPipeline</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-flags-00723",
|
|
"text": " If <code>flags</code> contains the <code>VK_PIPELINE_CREATE_DERIVATIVE_BIT</code> flag, and <code>basePipelineHandle</code> is <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>basePipelineIndex</code> <strong class=\"purple\">must</strong> be a valid index into the calling command’s <code>pCreateInfos</code> parameter"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-flags-00724",
|
|
"text": " If <code>flags</code> contains the <code>VK_PIPELINE_CREATE_DERIVATIVE_BIT</code> flag, and <code>basePipelineIndex</code> is not -1, <code>basePipelineHandle</code> <strong class=\"purple\">must</strong> be <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-flags-00725",
|
|
"text": " If <code>flags</code> contains the <code>VK_PIPELINE_CREATE_DERIVATIVE_BIT</code> flag, and <code>basePipelineHandle</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>basePipelineIndex</code> <strong class=\"purple\">must</strong> be -1"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pStages-00729",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a> and <code>pStages</code> includes a tessellation control shader stage, it <strong class=\"purple\">must</strong> include a tessellation evaluation shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pStages-00730",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a> and <code>pStages</code> includes a tessellation evaluation shader stage, it <strong class=\"purple\">must</strong> include a tessellation control shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pStages-00731",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a> and <code>pStages</code> includes a tessellation control shader stage and a tessellation evaluation shader stage, <code>pTessellationState</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkPipelineTessellationStateCreateInfo\">VkPipelineTessellationStateCreateInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pStages-00732",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a> and <code>pStages</code> includes tessellation shader stages, the shader code of at least one stage <strong class=\"purple\">must</strong> contain an <code>OpExecutionMode</code> instruction specifying the type of subdivision in the pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pStages-00733",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a> and <code>pStages</code> includes tessellation shader stages, and the shader code of both stages contain an <code>OpExecutionMode</code> instruction specifying the type of subdivision in the pipeline, they <strong class=\"purple\">must</strong> both specify the same subdivision mode"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pStages-00734",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a> and <code>pStages</code> includes tessellation shader stages, the shader code of at least one stage <strong class=\"purple\">must</strong> contain an <code>OpExecutionMode</code> instruction specifying the output patch size in the pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pStages-00735",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a> and <code>pStages</code> includes tessellation shader stages, and the shader code of both contain an <code>OpExecutionMode</code> instruction specifying the out patch size in the pipeline, they <strong class=\"purple\">must</strong> both specify the same patch size"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pStages-00736",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a> and <code>pStages</code> includes tessellation shader stages, the <code>topology</code> member of <code>pInputAssembly</code> <strong class=\"purple\">must</strong> be <code>VK_PRIMITIVE_TOPOLOGY_PATCH_LIST</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-topology-00737",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a> and the <code>topology</code> member of <code>pInputAssembly</code> is <code>VK_PRIMITIVE_TOPOLOGY_PATCH_LIST</code>, <code>pStages</code> <strong class=\"purple\">must</strong> include tessellation shader stages"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pStages-00738",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a> and <code>pStages</code> includes a geometry shader stage, and does not include any tessellation shader stages, its shader code <strong class=\"purple\">must</strong> contain an <code>OpExecutionMode</code> instruction specifying an input primitive type that is <a href=\"#shaders-geometry-execution\">compatible</a> with the primitive topology specified in <code>pInputAssembly</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pStages-00739",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a> and <code>pStages</code> includes a geometry shader stage, and also includes tessellation shader stages, its shader code <strong class=\"purple\">must</strong> contain an <code>OpExecutionMode</code> instruction specifying an input primitive type that is <a href=\"#shaders-geometry-execution\">compatible</a> with the primitive topology that is output by the tessellation stages"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pStages-00740",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a> and <a href=\"#pipeline-graphics-subsets-fragment-shader\">fragment shader state</a>, it includes both a fragment shader and a geometry shader, and the fragment shader code reads from an input variable that is decorated with <code>PrimitiveId</code>, then the geometry shader code <strong class=\"purple\">must</strong> write to a matching output variable, decorated with <code>PrimitiveId</code>, in all execution paths"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-renderPass-06038",
|
|
"text": " If <code>renderPass</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> and the pipeline is being created with <a href=\"#pipeline-graphics-subsets-fragment-shader\">fragment shader state</a> the fragment shader <strong class=\"purple\">must</strong> not read from any input attachment that is defined as <code>VK_ATTACHMENT_UNUSED</code> in <code>subpass</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pStages-00742",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a> and multiple pre-rasterization shader stages are included in <code>pStages</code>, the shader code for the entry points identified by those <code>pStages</code> and the rest of the state identified by this structure <strong class=\"purple\">must</strong> adhere to the pipeline linking rules described in the <a href=\"#interfaces\">Shader Interfaces</a> chapter"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-None-04889",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a> and <a href=\"#pipeline-graphics-subsets-fragment-shader\">fragment shader state</a>, the fragment shader and last <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader stage</a> and any relevant state <strong class=\"purple\">must</strong> adhere to the pipeline linking rules described in the <a href=\"#interfaces\">Shader Interfaces</a> chapter"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-renderPass-06041",
|
|
"text": " If <code>renderPass</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the pipeline is being created with <a href=\"#pipeline-graphics-subsets-fragment-output\">fragment output interface state</a>, then for each color attachment in the subpass, if the <a href=\"#potential-format-features\">potential format features</a> of the format of the corresponding attachment description do not contain <code>VK_FORMAT_FEATURE_COLOR_ATTACHMENT_BLEND_BIT</code>, then the <code>blendEnable</code> member of the corresponding element of the <code>pAttachments</code> member of <code>pColorBlendState</code> <strong class=\"purple\">must</strong> be <code>VK_FALSE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-renderPass-06042",
|
|
"text": " If <code>renderPass</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the pipeline is being created with <a href=\"#pipeline-graphics-subsets-fragment-output\">fragment output interface state</a>, and the subpass uses color attachments, the <code>attachmentCount</code> member of <code>pColorBlendState</code> <strong class=\"purple\">must</strong> be equal to the <code>colorAttachmentCount</code> used to create <code>subpass</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pDynamicStates-00749",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a>, and the <a href=\"#features-wideLines\"><code>wideLines</code></a> feature is not enabled, and no element of the <code>pDynamicStates</code> member of <code>pDynamicState</code> is <code>VK_DYNAMIC_STATE_LINE_WIDTH</code>, the <code>lineWidth</code> member of <code>pRasterizationState</code> <strong class=\"purple\">must</strong> be <code>1.0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-rasterizerDiscardEnable-00750",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a>, and the <code>rasterizerDiscardEnable</code> member of <code>pRasterizationState</code> is <code>VK_FALSE</code>, <code>pViewportState</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkPipelineViewportStateCreateInfo\">VkPipelineViewportStateCreateInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-rasterizerDiscardEnable-00751",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-fragment-output\">fragment output interface state</a>, <code>pMultisampleState</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkPipelineMultisampleStateCreateInfo\">VkPipelineMultisampleStateCreateInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-renderPass-06043",
|
|
"text": " If <code>renderPass</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the pipeline is being created with <a href=\"#pipeline-graphics-subsets-fragment-shader\">fragment shader state</a>, and <code>subpass</code> uses a depth/stencil attachment, <code>pDepthStencilState</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkPipelineDepthStencilStateCreateInfo\">VkPipelineDepthStencilStateCreateInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-renderPass-06044",
|
|
"text": " If <code>renderPass</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the pipeline is being created with <a href=\"#pipeline-graphics-subsets-fragment-output\">fragment output interface state</a>, and <code>subpass</code> uses color attachments, <code>pColorBlendState</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkPipelineColorBlendStateCreateInfo\">VkPipelineColorBlendStateCreateInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pDynamicStates-00754",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a>, the <a href=\"#features-depthBiasClamp\"><code>depthBiasClamp</code></a> feature is not enabled, no element of the <code>pDynamicStates</code> member of <code>pDynamicState</code> is <code>VK_DYNAMIC_STATE_DEPTH_BIAS</code>, and the <code>depthBiasEnable</code> member of <code>pRasterizationState</code> is <code>VK_TRUE</code>, the <code>depthBiasClamp</code> member of <code>pRasterizationState</code> <strong class=\"purple\">must</strong> be <code>0.0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-layout-00756",
|
|
"text": " <code>layout</code> <strong class=\"purple\">must</strong> be <a href=\"#descriptorsets-pipelinelayout-consistency\">consistent</a> with all shaders specified in <code>pStages</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-multisampledRenderToSingleSampled-06853",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-fragment-output\">fragment output interface state</a>, and none of the <code><a href=\"#VK_AMD_mixed_attachment_samples\">VK_AMD_mixed_attachment_samples</a></code> extension, the <code><a href=\"#VK_NV_framebuffer_mixed_samples\">VK_NV_framebuffer_mixed_samples</a></code> extension, or the <a href=\"#features-multisampledRenderToSingleSampled\"><code>multisampledRenderToSingleSampled</code></a> feature are enabled, and if <code>subpass</code> uses color and/or depth/stencil attachments, then the <code>rasterizationSamples</code> member of <code>pMultisampleState</code> <strong class=\"purple\">must</strong> be the same as the sample count for those subpass attachments"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-subpass-00758",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-fragment-output\">fragment output interface state</a>, and <code>subpass</code> does not use any color and/or depth/stencil attachments, then the <code>rasterizationSamples</code> member of <code>pMultisampleState</code> <strong class=\"purple\">must</strong> follow the rules for a <a href=\"#renderpass-noattachments\">zero-attachment subpass</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-renderPass-06046",
|
|
"text": " If <code>renderPass</code> is a valid renderPass, <code>subpass</code> <strong class=\"purple\">must</strong> be a valid subpass within <code>renderPass</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-layout-01688",
|
|
"text": " The number of resources in <code>layout</code> accessible to each shader stage that is used by the pipeline <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxPerStageResources</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pStages-02098",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-vertex-input\">vertex input state</a>, <code>pInputAssemblyState</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkPipelineInputAssemblyStateCreateInfo\">VkPipelineInputAssemblyStateCreateInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pStages-06894",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a> but not <a href=\"#pipeline-graphics-subsets-fragment-shader\">fragment shader state</a>, elements of <code>pStages</code> <strong class=\"purple\">must</strong> not have <code>stage</code> set to <code>VK_SHADER_STAGE_FRAGMENT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pStages-06895",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-fragment-shader\">fragment shader state</a> but not <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a>, elements of <code>pStages</code> <strong class=\"purple\">must</strong> not have <code>stage</code> set to a shader stage which participates in pre-rasterization"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pStages-06896",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-fragment-shader\">fragment shader state</a> and/or <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a>, all elements of <code>pStages</code> <strong class=\"purple\">must</strong> have a <code>stage</code> set to a shader stage which participates in <a href=\"#pipeline-graphics-subsets-fragment-shader\">fragment shader state</a> or <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-stage-06897",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-fragment-shader\">fragment shader state</a> and/or <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a>, any value of <code>stage</code> <strong class=\"purple\">must</strong> not be set in more than one element of <code>pStages</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_GRAPHICS_PIPELINE_CREATE_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pNext-pNext",
|
|
"text": " Each <code>pNext</code> member of any structure (including this one) in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be either <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a>, <a href=\"#VkGraphicsPipelineLibraryCreateInfoEXT\">VkGraphicsPipelineLibraryCreateInfoEXT</a>, <a href=\"#VkGraphicsPipelineShaderGroupsCreateInfoNV\">VkGraphicsPipelineShaderGroupsCreateInfoNV</a>, <a href=\"#VkMultiviewPerViewAttributesInfoNVX\">VkMultiviewPerViewAttributesInfoNVX</a>, <a href=\"#VkPipelineCompilerControlCreateInfoAMD\">VkPipelineCompilerControlCreateInfoAMD</a>, <a href=\"#VkPipelineCreationFeedbackCreateInfo\">VkPipelineCreationFeedbackCreateInfo</a>, <a href=\"#VkPipelineDiscardRectangleStateCreateInfoEXT\">VkPipelineDiscardRectangleStateCreateInfoEXT</a>, <a href=\"#VkPipelineFragmentShadingRateEnumStateCreateInfoNV\">VkPipelineFragmentShadingRateEnumStateCreateInfoNV</a>, <a href=\"#VkPipelineFragmentShadingRateStateCreateInfoKHR\">VkPipelineFragmentShadingRateStateCreateInfoKHR</a>, <a href=\"#VkPipelineLibraryCreateInfoKHR\">VkPipelineLibraryCreateInfoKHR</a>, <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>, <a href=\"#VkPipelineRepresentativeFragmentTestStateCreateInfoNV\">VkPipelineRepresentativeFragmentTestStateCreateInfoNV</a>, or <a href=\"#VkPipelineRobustnessCreateInfoEXT\">VkPipelineRobustnessCreateInfoEXT</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkPipelineCreateFlagBits\">VkPipelineCreateFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pDynamicState-parameter",
|
|
"text": " If <code>pDynamicState</code> is not <code>NULL</code>, <code>pDynamicState</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkPipelineDynamicStateCreateInfo\">VkPipelineDynamicStateCreateInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-commonparent",
|
|
"text": " Each of <code>basePipelineHandle</code>, <code>layout</code>, and <code>renderPass</code> that are valid handles of non-ignored parameters <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"!(VK_NV_mesh_shader)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-stage-00727",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a> the <code>stage</code> member of one element of <code>pStages</code> <strong class=\"purple\">must</strong> be <code>VK_SHADER_STAGE_VERTEX_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pStages-02095",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a> the geometric shader stages provided in <code>pStages</code> <strong class=\"purple\">must</strong> be either from the mesh shading pipeline (<code>stage</code> is <code>VK_SHADER_STAGE_TASK_BIT_NV</code> or <code>VK_SHADER_STAGE_MESH_BIT_NV</code>) or from the primitive shading pipeline (<code>stage</code> is <code>VK_SHADER_STAGE_VERTEX_BIT</code>, <code>VK_SHADER_STAGE_TESSELLATION_CONTROL_BIT</code>, <code>VK_SHADER_STAGE_TESSELLATION_EVALUATION_BIT</code>, or <code>VK_SHADER_STAGE_GEOMETRY_BIT</code>)"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-stage-02096",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a> the <code>stage</code> member of one element of <code>pStages</code> <strong class=\"purple\">must</strong> be either <code>VK_SHADER_STAGE_VERTEX_BIT</code> or <code>VK_SHADER_STAGE_MESH_BIT_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-PrimitiveId-06264",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a>, it includes a mesh shader and the fragment shader code reads from an input variable that is decorated with <code>PrimitiveId</code>, then the mesh shader code <strong class=\"purple\">must</strong> write to a matching output variable, decorated with <code>PrimitiveId</code>, in all execution paths"
|
|
}
|
|
],
|
|
"!(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pDynamicStates-00747",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a>, and no element of the <code>pDynamicStates</code> member of <code>pDynamicState</code> is <code>VK_DYNAMIC_STATE_VIEWPORT</code>, the <code>pViewports</code> member of <code>pViewportState</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>pViewportState->viewportCount</code> valid <code>VkViewport</code> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pDynamicStates-00748",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a>, and no element of the <code>pDynamicStates</code> member of <code>pDynamicState</code> is <code>VK_DYNAMIC_STATE_SCISSOR</code>, the <code>pScissors</code> member of <code>pViewportState</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>pViewportState->scissorCount</code> <code>VkRect2D</code> structures"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pDynamicStates-04130",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a>, and no element of the <code>pDynamicStates</code> member of <code>pDynamicState</code> is <code>VK_DYNAMIC_STATE_VIEWPORT</code> or <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code>, the <code>pViewports</code> member of <code>pViewportState</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>pViewportState->viewportCount</code> valid <code>VkViewport</code> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pDynamicStates-04131",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a>, and no element of the <code>pDynamicStates</code> member of <code>pDynamicState</code> is <code>VK_DYNAMIC_STATE_SCISSOR</code> or <code>VK_DYNAMIC_STATE_SCISSOR_WITH_COUNT</code>, the <code>pScissors</code> member of <code>pViewportState</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>pViewportState->scissorCount</code> <code>VkRect2D</code> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pDynamicStates-03379",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a>, and <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> is included in the <code>pDynamicStates</code> array then <code>viewportCount</code> <strong class=\"purple\">must</strong> be zero"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pDynamicStates-03380",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a>, and <code>VK_DYNAMIC_STATE_SCISSOR_WITH_COUNT</code> is included in the <code>pDynamicStates</code> array then <code>scissorCount</code> <strong class=\"purple\">must</strong> be zero"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pDynamicStates-04132",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a>, and <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> is included in the <code>pDynamicStates</code> array then <code>VK_DYNAMIC_STATE_VIEWPORT</code> <strong class=\"purple\">must</strong> not be present"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pDynamicStates-04133",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a>, and <code>VK_DYNAMIC_STATE_SCISSOR_WITH_COUNT</code> is included in the <code>pDynamicStates</code> array then <code>VK_DYNAMIC_STATE_SCISSOR</code> <strong class=\"purple\">must</strong> not be present"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state2)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pViewportState-04892",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a>, and the graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_RASTERIZER_DISCARD_ENABLE</code> dynamic state enabled, <code>pViewportState</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkPipelineViewportStateCreateInfo\">VkPipelineViewportStateCreateInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pDynamicStates-04869",
|
|
"text": " If the <a href=\"#features-extendedDynamicState2LogicOp\"><code>extendedDynamicState2LogicOp</code></a> feature is not enabled, there <strong class=\"purple\">must</strong> be no element of the <code>pDynamicStates</code> member of <code>pDynamicState</code> set to <code>VK_DYNAMIC_STATE_LOGIC_OP_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pDynamicStates-04870",
|
|
"text": " If the <a href=\"#features-extendedDynamicState2PatchControlPoints\"><code>extendedDynamicState2PatchControlPoints</code></a> feature is not enabled, there <strong class=\"purple\">must</strong> be no element of the <code>pDynamicStates</code> member of <code>pDynamicState</code> set to <code>VK_DYNAMIC_STATE_PATCH_CONTROL_POINTS_EXT</code>"
|
|
}
|
|
],
|
|
"!(VK_EXT_depth_range_unrestricted)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pDynamicStates-00755",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-fragment-shader\">fragment shader state</a>, and no element of the <code>pDynamicStates</code> member of <code>pDynamicState</code> is <code>VK_DYNAMIC_STATE_DEPTH_BOUNDS</code>, and the <code>depthBoundsTestEnable</code> member of <code>pDepthStencilState</code> is <code>VK_TRUE</code>, the <code>minDepthBounds</code> and <code>maxDepthBounds</code> members of <code>pDepthStencilState</code> <strong class=\"purple\">must</strong> be between <code>0.0</code> and <code>1.0</code>, inclusive"
|
|
}
|
|
],
|
|
"(VK_EXT_depth_range_unrestricted)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pDynamicStates-02510",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-fragment-shader\">fragment shader state</a>, and the <code><a href=\"#VK_EXT_depth_range_unrestricted\">VK_EXT_depth_range_unrestricted</a></code> extension is not enabled and no element of the <code>pDynamicStates</code> member of <code>pDynamicState</code> is <code>VK_DYNAMIC_STATE_DEPTH_BOUNDS</code>, and the <code>depthBoundsTestEnable</code> member of <code>pDepthStencilState</code> is <code>VK_TRUE</code>, the <code>minDepthBounds</code> and <code>maxDepthBounds</code> members of <code>pDepthStencilState</code> <strong class=\"purple\">must</strong> be between <code>0.0</code> and <code>1.0</code>, inclusive"
|
|
}
|
|
],
|
|
"(VK_EXT_sample_locations)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pDynamicStates-01521",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-fragment-shader\">fragment shader state</a> or <a href=\"#pipeline-graphics-subsets-fragment-output\">fragment output interface state</a>, and no element of the <code>pDynamicStates</code> member of <code>pDynamicState</code> is <code>VK_DYNAMIC_STATE_SAMPLE_LOCATIONS_EXT</code>, and the <code>sampleLocationsEnable</code> member of a <a href=\"#VkPipelineSampleLocationsStateCreateInfoEXT\">VkPipelineSampleLocationsStateCreateInfoEXT</a> structure included in the <code>pNext</code> chain of <code>pMultisampleState</code> is <code>VK_TRUE</code>, <code>sampleLocationsInfo.sampleLocationGridSize.width</code> <strong class=\"purple\">must</strong> evenly divide <a href=\"#VkMultisamplePropertiesEXT\">VkMultisamplePropertiesEXT</a>::<code>sampleLocationGridSize.width</code> as returned by <a href=\"#vkGetPhysicalDeviceMultisamplePropertiesEXT\">vkGetPhysicalDeviceMultisamplePropertiesEXT</a> with a <code>samples</code> parameter equaling <code>rasterizationSamples</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pDynamicStates-01522",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-fragment-shader\">fragment shader state</a> or <a href=\"#pipeline-graphics-subsets-fragment-output\">fragment output interface state</a>, and no element of the <code>pDynamicStates</code> member of <code>pDynamicState</code> is <code>VK_DYNAMIC_STATE_SAMPLE_LOCATIONS_EXT</code>, and the <code>sampleLocationsEnable</code> member of a <a href=\"#VkPipelineSampleLocationsStateCreateInfoEXT\">VkPipelineSampleLocationsStateCreateInfoEXT</a> structure included in the <code>pNext</code> chain of <code>pMultisampleState</code> is <code>VK_TRUE</code>, <code>sampleLocationsInfo.sampleLocationGridSize.height</code> <strong class=\"purple\">must</strong> evenly divide <a href=\"#VkMultisamplePropertiesEXT\">VkMultisamplePropertiesEXT</a>::<code>sampleLocationGridSize.height</code> as returned by <a href=\"#vkGetPhysicalDeviceMultisamplePropertiesEXT\">vkGetPhysicalDeviceMultisamplePropertiesEXT</a> with a <code>samples</code> parameter equaling <code>rasterizationSamples</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pDynamicStates-01523",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-fragment-shader\">fragment shader state</a> or <a href=\"#pipeline-graphics-subsets-fragment-output\">fragment output interface state</a>, and no element of the <code>pDynamicStates</code> member of <code>pDynamicState</code> is <code>VK_DYNAMIC_STATE_SAMPLE_LOCATIONS_EXT</code>, and the <code>sampleLocationsEnable</code> member of a <a href=\"#VkPipelineSampleLocationsStateCreateInfoEXT\">VkPipelineSampleLocationsStateCreateInfoEXT</a> structure included in the <code>pNext</code> chain of <code>pMultisampleState</code> is <code>VK_TRUE</code>, <code>sampleLocationsInfo.sampleLocationsPerPixel</code> <strong class=\"purple\">must</strong> equal <code>rasterizationSamples</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-sampleLocationsEnable-01524",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-fragment-shader\">fragment shader state</a>, and the <code>sampleLocationsEnable</code> member of a <a href=\"#VkPipelineSampleLocationsStateCreateInfoEXT\">VkPipelineSampleLocationsStateCreateInfoEXT</a> structure included in the <code>pNext</code> chain of <code>pMultisampleState</code> is <code>VK_TRUE</code>, the fragment shader code <strong class=\"purple\">must</strong> not statically use the extended instruction <code>InterpolateAtSample</code>"
|
|
}
|
|
],
|
|
"(VK_AMD_mixed_attachment_samples)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-subpass-01505",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-fragment-output\">fragment output interface state</a>, and the <code><a href=\"#VK_AMD_mixed_attachment_samples\">VK_AMD_mixed_attachment_samples</a></code> extension is enabled, and if <code>subpass</code> uses color and/or depth/stencil attachments, then the <code>rasterizationSamples</code> member of <code>pMultisampleState</code> <strong class=\"purple\">must</strong> equal the maximum of the sample counts of those subpass attachments"
|
|
}
|
|
],
|
|
"(VK_EXT_multisampled_render_to_single_sampled)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-renderPass-06854",
|
|
"text": " If <code>renderPass</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the <code><a href=\"#VK_EXT_multisampled_render_to_single_sampled\">VK_EXT_multisampled_render_to_single_sampled</a></code> extension is enabled, and <code>subpass</code> has a <a href=\"#VkMultisampledRenderToSingleSampledInfoEXT\">VkMultisampledRenderToSingleSampledInfoEXT</a> structure included in the <a href=\"#VkSubpassDescription2\">VkSubpassDescription2</a>::<code>pNext</code> chain with <code>multisampledRenderToSingleSampledEnable</code> equal to <code>VK_TRUE</code>, then the <code>rasterizationSamples</code> member of <code>pMultisampleState</code> <strong class=\"purple\">must</strong> be equal to <a href=\"#VkMultisampledRenderToSingleSampledInfoEXT\">VkMultisampledRenderToSingleSampledInfoEXT</a>::<code>rasterizationSamples</code>."
|
|
}
|
|
],
|
|
"(VK_NV_framebuffer_mixed_samples)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-subpass-01411",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-fragment-output\">fragment output interface state</a>, and the <code><a href=\"#VK_NV_framebuffer_mixed_samples\">VK_NV_framebuffer_mixed_samples</a></code> extension is enabled, and if <code>subpass</code> has a depth/stencil attachment and depth test, stencil test, or depth bounds test are enabled, then the <code>rasterizationSamples</code> member of <code>pMultisampleState</code> <strong class=\"purple\">must</strong> be the same as the sample count of the depth/stencil attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-subpass-01412",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-fragment-output\">fragment output interface state</a>, and the <code><a href=\"#VK_NV_framebuffer_mixed_samples\">VK_NV_framebuffer_mixed_samples</a></code> extension is enabled, and if <code>subpass</code> has any color attachments, then the <code>rasterizationSamples</code> member of <code>pMultisampleState</code> <strong class=\"purple\">must</strong> be greater than or equal to the sample count for those subpass attachments"
|
|
}
|
|
],
|
|
"(VK_NV_coverage_reduction_mode)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-coverageReductionMode-02722",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-fragment-output\">fragment output interface state</a>, and the <code><a href=\"#VK_NV_coverage_reduction_mode\">VK_NV_coverage_reduction_mode</a></code> extension is enabled, the coverage reduction mode specified by <a href=\"#VkPipelineCoverageReductionStateCreateInfoNV\">VkPipelineCoverageReductionStateCreateInfoNV</a>::<code>coverageReductionMode</code>, the <code>rasterizationSamples</code> member of <code>pMultisampleState</code> and the sample counts for the color and depth/stencil attachments (if the subpass has them) <strong class=\"purple\">must</strong> be a valid combination returned by <code>vkGetPhysicalDeviceSupportedFramebufferMixedSamplesCombinationsNV</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_multiview)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-renderPass-06047",
|
|
"text": " If <code>renderPass</code> is a valid renderPass, the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a>, and the <code>renderPass</code> has multiview enabled and <code>subpass</code> has more than one bit set in the view mask and <code>multiviewTessellationShader</code> is not enabled, then <code>pStages</code> <strong class=\"purple\">must</strong> not include tessellation shaders"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-renderPass-06048",
|
|
"text": " If <code>renderPass</code> is a valid renderPass, the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a>, and the <code>renderPass</code> has multiview enabled and <code>subpass</code> has more than one bit set in the view mask and <code>multiviewGeometryShader</code> is not enabled, then <code>pStages</code> <strong class=\"purple\">must</strong> not include a geometry shader"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-renderPass-06049",
|
|
"text": " If <code>renderPass</code> is a valid renderPass, the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a>, and the <code>renderPass</code> has multiview enabled and <code>subpass</code> has more than one bit set in the view mask, shaders in the pipeline <strong class=\"purple\">must</strong> not write to the <code>Layer</code> built-in output"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-renderPass-06050",
|
|
"text": " If <code>renderPass</code> is a valid renderPass and the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a>, and the <code>renderPass</code> has multiview enabled, then all shaders <strong class=\"purple\">must</strong> not include variables decorated with the <code>Layer</code> built-in decoration in their interfaces"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_device_group)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-flags-00764",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> not contain the <code>VK_PIPELINE_CREATE_DISPATCH_BASE</code> flag"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_maintenance2,VK_KHR_create_renderpass2)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pStages-01565",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-fragment-shader\">fragment shader state</a> and an input attachment was referenced by an <code>aspectMask</code> at <code>renderPass</code> creation time, the fragment shader <strong class=\"purple\">must</strong> only read from the aspects that were specified for that input attachment"
|
|
}
|
|
],
|
|
"(VK_NV_clip_space_w_scaling)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pDynamicStates-01715",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a>, and no element of the <code>pDynamicStates</code> member of <code>pDynamicState</code> is <code>VK_DYNAMIC_STATE_VIEWPORT_W_SCALING_NV</code>, and the <code>viewportWScalingEnable</code> member of a <a href=\"#VkPipelineViewportWScalingStateCreateInfoNV\">VkPipelineViewportWScalingStateCreateInfoNV</a> structure, included in the <code>pNext</code> chain of <code>pViewportState</code>, is <code>VK_TRUE</code>, the <code>pViewportWScalings</code> member of the <a href=\"#VkPipelineViewportWScalingStateCreateInfoNV\">VkPipelineViewportWScalingStateCreateInfoNV</a> <strong class=\"purple\">must</strong> be a pointer to an array of <a href=\"#VkPipelineViewportWScalingStateCreateInfoNV\">VkPipelineViewportWScalingStateCreateInfoNV</a>::<code>viewportCount</code> valid <a href=\"#VkViewportWScalingNV\">VkViewportWScalingNV</a> structures"
|
|
}
|
|
],
|
|
"(VK_NV_scissor_exclusive)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pDynamicStates-04056",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a>, and no element of the <code>pDynamicStates</code> member of <code>pDynamicState</code> is <code>VK_DYNAMIC_STATE_EXCLUSIVE_SCISSOR_NV</code>, and if <code>pViewportState->pNext</code> chain includes a <a href=\"#VkPipelineViewportExclusiveScissorStateCreateInfoNV\">VkPipelineViewportExclusiveScissorStateCreateInfoNV</a> structure, and if its <code>exclusiveScissorCount</code> member is not <code>0</code>, then its <code>pExclusiveScissors</code> member <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>exclusiveScissorCount</code> <a href=\"#VkRect2D\">VkRect2D</a> structures"
|
|
}
|
|
],
|
|
"(VK_NV_shading_rate_image)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pDynamicStates-04057",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a>, and no element of the <code>pDynamicStates</code> member of <code>pDynamicState</code> is <code>VK_DYNAMIC_STATE_VIEWPORT_SHADING_RATE_PALETTE_NV</code>, and if <code>pViewportState->pNext</code> chain includes a <a href=\"#VkPipelineViewportShadingRateImageStateCreateInfoNV\">VkPipelineViewportShadingRateImageStateCreateInfoNV</a> structure, then its <code>pShadingRatePalettes</code> member <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>viewportCount</code> valid <a href=\"#VkShadingRatePaletteNV\">VkShadingRatePaletteNV</a> structures"
|
|
}
|
|
],
|
|
"(VK_EXT_discard_rectangles)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pDynamicStates-04058",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a>, and no element of the <code>pDynamicStates</code> member of <code>pDynamicState</code> is <code>VK_DYNAMIC_STATE_DISCARD_RECTANGLE_EXT</code>, and if <code>pNext</code> chain includes a <a href=\"#VkPipelineDiscardRectangleStateCreateInfoEXT\">VkPipelineDiscardRectangleStateCreateInfoEXT</a> structure, and if its <code>discardRectangleCount</code> member is not <code>0</code>, then its <code>pDiscardRectangles</code> member <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>discardRectangleCount</code> <a href=\"#VkRect2D\">VkRect2D</a> structures"
|
|
}
|
|
],
|
|
"!(VK_EXT_vertex_input_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pStages-02097",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-vertex-input\">vertex input state</a>, <code>pVertexInputState</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkPipelineVertexInputStateCreateInfo\">VkPipelineVertexInputStateCreateInfo</a> structure"
|
|
}
|
|
],
|
|
"(VK_EXT_vertex_input_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pVertexInputState-04910",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-vertex-input\">vertex input state</a>, and <code>VK_DYNAMIC_STATE_VERTEX_INPUT_EXT</code> is not set, <code>pVertexInputState</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkPipelineVertexInputStateCreateInfo\">VkPipelineVertexInputStateCreateInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pDynamicStates-04807",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a> and the <a href=\"#features-vertexInputDynamicState\"><code>vertexInputDynamicState</code></a> feature is not enabled, there <strong class=\"purple\">must</strong> be no element of the <code>pDynamicStates</code> member of <code>pDynamicState</code> set to <code>VK_DYNAMIC_STATE_VERTEX_INPUT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pStages-02317",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a>, the <code>Xfb</code> execution mode <strong class=\"purple\">can</strong> be specified by no more than one shader stage in <code>pStages</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pStages-02318",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a>, and any shader stage in <code>pStages</code> specifies <code>Xfb</code> execution mode it <strong class=\"purple\">must</strong> be the last <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader stage</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-rasterizationStream-02319",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a>, and a <a href=\"#VkPipelineRasterizationStateStreamCreateInfoEXT\">VkPipelineRasterizationStateStreamCreateInfoEXT</a>::<code>rasterizationStream</code> value other than zero is specified, all variables in the output interface of the entry point being compiled decorated with <code>Position</code>, <code>PointSize</code>, <code>ClipDistance</code>, or <code>CullDistance</code> <strong class=\"purple\">must</strong> be decorated with identical <code>Stream</code> values that match the <code>rasterizationStream</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-rasterizationStream-02320",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a>, and <a href=\"#VkPipelineRasterizationStateStreamCreateInfoEXT\">VkPipelineRasterizationStateStreamCreateInfoEXT</a>::<code>rasterizationStream</code> is zero, or not specified, all variables in the output interface of the entry point being compiled decorated with <code>Position</code>, <code>PointSize</code>, <code>ClipDistance</code>, or <code>CullDistance</code> <strong class=\"purple\">must</strong> be decorated with a <code>Stream</code> value of zero, or <strong class=\"purple\">must</strong> not specify the <code>Stream</code> decoration"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-geometryStreams-02321",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a>, and the last <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader stage</a> is a geometry shader, and that geometry shader uses the <code>GeometryStreams</code> capability, then <code>VkPhysicalDeviceTransformFeedbackFeaturesEXT</code>::<code>geometryStreams</code> feature <strong class=\"purple\">must</strong> be enabled"
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)+(VK_NV_mesh_shader)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-None-02322",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a>, and there are any mesh shader stages in the pipeline there <strong class=\"purple\">must</strong> not be any shader stage in the pipeline with a <code>Xfb</code> execution mode"
|
|
}
|
|
],
|
|
"(VK_EXT_line_rasterization)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-lineRasterizationMode-02766",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a> and at least one of <a href=\"#pipeline-graphics-subsets-fragment-output\">fragment output interface state</a> or <a href=\"#pipeline-graphics-subsets-fragment-shader\">fragment shader state</a>, and <code>pMultisampleState</code> is not <code>NULL</code>, the <code>lineRasterizationMode</code> member of a <a href=\"#VkPipelineRasterizationLineStateCreateInfoEXT\">VkPipelineRasterizationLineStateCreateInfoEXT</a> structure included in the <code>pNext</code> chain of <code>pRasterizationState</code> is <code>VK_LINE_RASTERIZATION_MODE_BRESENHAM_EXT</code> or <code>VK_LINE_RASTERIZATION_MODE_RECTANGULAR_SMOOTH_EXT</code>, then the <code>alphaToCoverageEnable</code>, <code>alphaToOneEnable</code>, and <code>sampleShadingEnable</code> members of <code>pMultisampleState</code> <strong class=\"purple\">must</strong> all be <code>VK_FALSE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-stippledLineEnable-02767",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a>, the <code>stippledLineEnable</code> member of <a href=\"#VkPipelineRasterizationLineStateCreateInfoEXT\">VkPipelineRasterizationLineStateCreateInfoEXT</a> is <code>VK_TRUE</code>, and no element of the <code>pDynamicStates</code> member of <code>pDynamicState</code> is <code>VK_DYNAMIC_STATE_LINE_STIPPLE_EXT</code>, then the <code>lineStippleFactor</code> member of <a href=\"#VkPipelineRasterizationLineStateCreateInfoEXT\">VkPipelineRasterizationLineStateCreateInfoEXT</a> <strong class=\"purple\">must</strong> be in the range <span class=\"eq\">[1,256]</span>"
|
|
}
|
|
],
|
|
"(VK_KHR_pipeline_library)+!(VK_EXT_graphics_pipeline_library)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-flags-03371",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> not include <code>VK_PIPELINE_CREATE_LIBRARY_BIT_KHR</code>"
|
|
}
|
|
],
|
|
"(VK_KHR_ray_tracing_pipeline)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-flags-03372",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> not include <code>VK_PIPELINE_CREATE_RAY_TRACING_NO_NULL_ANY_HIT_SHADERS_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-flags-03373",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> not include <code>VK_PIPELINE_CREATE_RAY_TRACING_NO_NULL_CLOSEST_HIT_SHADERS_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-flags-03374",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> not include <code>VK_PIPELINE_CREATE_RAY_TRACING_NO_NULL_MISS_SHADERS_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-flags-03375",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> not include <code>VK_PIPELINE_CREATE_RAY_TRACING_NO_NULL_INTERSECTION_SHADERS_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-flags-03376",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> not include <code>VK_PIPELINE_CREATE_RAY_TRACING_SKIP_TRIANGLES_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-flags-03377",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> not include <code>VK_PIPELINE_CREATE_RAY_TRACING_SKIP_AABBS_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-flags-03577",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> not include <code>VK_PIPELINE_CREATE_RAY_TRACING_SHADER_GROUP_HANDLE_CAPTURE_REPLAY_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pDynamicStates-03578",
|
|
"text": " All elements of the <code>pDynamicStates</code> member of <code>pDynamicState</code> <strong class=\"purple\">must</strong> not be <code>VK_DYNAMIC_STATE_RAY_TRACING_PIPELINE_STACK_SIZE_KHR</code>"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing_motion_blur)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-flags-04947",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> not include <code>VK_PIPELINE_CREATE_RAY_TRACING_ALLOW_MOTION_BIT_NV</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+!(VK_VERSION_1_3)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pDynamicStates-03378",
|
|
"text": " If the <a href=\"#features-extendedDynamicState\"><code>extendedDynamicState</code></a> feature is not enabled, there <strong class=\"purple\">must</strong> be no element of the <code>pDynamicStates</code> member of <code>pDynamicState</code> set to <code>VK_DYNAMIC_STATE_CULL_MODE</code>, <code>VK_DYNAMIC_STATE_FRONT_FACE</code>, <code>VK_DYNAMIC_STATE_PRIMITIVE_TOPOLOGY</code>, <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code>, <code>VK_DYNAMIC_STATE_SCISSOR_WITH_COUNT</code>, <code>VK_DYNAMIC_STATE_VERTEX_INPUT_BINDING_STRIDE</code>, <code>VK_DYNAMIC_STATE_DEPTH_TEST_ENABLE</code>, <code>VK_DYNAMIC_STATE_DEPTH_WRITE_ENABLE</code>, <code>VK_DYNAMIC_STATE_DEPTH_COMPARE_OP</code>, <code>VK_DYNAMIC_STATE_DEPTH_BOUNDS_TEST_ENABLE</code>, <code>VK_DYNAMIC_STATE_STENCIL_TEST_ENABLE</code>, or <code>VK_DYNAMIC_STATE_STENCIL_OP</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state2)+!(VK_VERSION_1_3)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pDynamicStates-04868",
|
|
"text": " If the <a href=\"#features-extendedDynamicState2\"><code>extendedDynamicState2</code></a> feature is not enabled, there <strong class=\"purple\">must</strong> be no element of the <code>pDynamicStates</code> member of <code>pDynamicState</code> set to <code>VK_DYNAMIC_STATE_DEPTH_BIAS_ENABLE</code>, <code>VK_DYNAMIC_STATE_PRIMITIVE_RESTART_ENABLE</code>, or <code>VK_DYNAMIC_STATE_RASTERIZER_DISCARD_ENABLE</code>"
|
|
}
|
|
],
|
|
"(VK_NV_device_generated_commands)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-flags-02877",
|
|
"text": " If <code>flags</code> includes <code>VK_PIPELINE_CREATE_INDIRECT_BINDABLE_BIT_NV</code>, then the <a href=\"#features-deviceGeneratedCommands\"><code>deviceGeneratedCommands</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
}
|
|
],
|
|
"(VK_NV_device_generated_commands)+(VK_EXT_transform_feedback)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-flags-02966",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a> and <code>flags</code> includes <code>VK_PIPELINE_CREATE_INDIRECT_BINDABLE_BIT_NV</code>, then all stages <strong class=\"purple\">must</strong> not specify <code>Xfb</code> execution mode"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_pipeline_creation_cache_control)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pipelineCreationCacheControl-02878",
|
|
"text": " If the <a href=\"#features-pipelineCreationCacheControl\"><code>pipelineCreationCacheControl</code></a> feature is not enabled, <code>flags</code> <strong class=\"purple\">must</strong> not include <code>VK_PIPELINE_CREATE_FAIL_ON_PIPELINE_COMPILE_REQUIRED_BIT</code> or <code>VK_PIPELINE_CREATE_EARLY_RETURN_ON_FAILURE_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_KHR_fragment_shading_rate)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pDynamicState-04494",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a> or <a href=\"#pipeline-graphics-subsets-fragment-shader\">fragment shader state</a> and <code>VK_DYNAMIC_STATE_FRAGMENT_SHADING_RATE_KHR</code> is not included in <code>pDynamicState->pDynamicStates</code>, <a href=\"#VkPipelineFragmentShadingRateStateCreateInfoKHR\">VkPipelineFragmentShadingRateStateCreateInfoKHR</a>::<code>fragmentSize.width</code> <strong class=\"purple\">must</strong> be greater than or equal to <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pDynamicState-04495",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a> or <a href=\"#pipeline-graphics-subsets-fragment-shader\">fragment shader state</a> and <code>VK_DYNAMIC_STATE_FRAGMENT_SHADING_RATE_KHR</code> is not included in <code>pDynamicState->pDynamicStates</code>, <a href=\"#VkPipelineFragmentShadingRateStateCreateInfoKHR\">VkPipelineFragmentShadingRateStateCreateInfoKHR</a>::<code>fragmentSize.height</code> <strong class=\"purple\">must</strong> be greater than or equal to <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pDynamicState-04496",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a> or <a href=\"#pipeline-graphics-subsets-fragment-shader\">fragment shader state</a> and <code>VK_DYNAMIC_STATE_FRAGMENT_SHADING_RATE_KHR</code> is not included in <code>pDynamicState->pDynamicStates</code>, <a href=\"#VkPipelineFragmentShadingRateStateCreateInfoKHR\">VkPipelineFragmentShadingRateStateCreateInfoKHR</a>::<code>fragmentSize.width</code> <strong class=\"purple\">must</strong> be a power-of-two value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pDynamicState-04497",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a> or <a href=\"#pipeline-graphics-subsets-fragment-shader\">fragment shader state</a> and <code>VK_DYNAMIC_STATE_FRAGMENT_SHADING_RATE_KHR</code> is not included in <code>pDynamicState->pDynamicStates</code>, <a href=\"#VkPipelineFragmentShadingRateStateCreateInfoKHR\">VkPipelineFragmentShadingRateStateCreateInfoKHR</a>::<code>fragmentSize.height</code> <strong class=\"purple\">must</strong> be a power-of-two value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pDynamicState-04498",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a> or <a href=\"#pipeline-graphics-subsets-fragment-shader\">fragment shader state</a> and <code>VK_DYNAMIC_STATE_FRAGMENT_SHADING_RATE_KHR</code> is not included in <code>pDynamicState->pDynamicStates</code>, <a href=\"#VkPipelineFragmentShadingRateStateCreateInfoKHR\">VkPipelineFragmentShadingRateStateCreateInfoKHR</a>::<code>fragmentSize.width</code> <strong class=\"purple\">must</strong> be less than or equal to <code>4</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pDynamicState-04499",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a> or <a href=\"#pipeline-graphics-subsets-fragment-shader\">fragment shader state</a> and <code>VK_DYNAMIC_STATE_FRAGMENT_SHADING_RATE_KHR</code> is not included in <code>pDynamicState->pDynamicStates</code>, <a href=\"#VkPipelineFragmentShadingRateStateCreateInfoKHR\">VkPipelineFragmentShadingRateStateCreateInfoKHR</a>::<code>fragmentSize.height</code> <strong class=\"purple\">must</strong> be less than or equal to <code>4</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pDynamicState-04500",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a> or <a href=\"#pipeline-graphics-subsets-fragment-shader\">fragment shader state</a> and <code>VK_DYNAMIC_STATE_FRAGMENT_SHADING_RATE_KHR</code> is not included in <code>pDynamicState->pDynamicStates</code>, and the <a href=\"#features-pipelineFragmentShadingRate\"><code>pipelineFragmentShadingRate</code></a> feature is not enabled, <a href=\"#VkPipelineFragmentShadingRateStateCreateInfoKHR\">VkPipelineFragmentShadingRateStateCreateInfoKHR</a>::<code>fragmentSize.width</code> and <a href=\"#VkPipelineFragmentShadingRateStateCreateInfoKHR\">VkPipelineFragmentShadingRateStateCreateInfoKHR</a>::<code>fragmentSize.height</code> <strong class=\"purple\">must</strong> both be equal to <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pDynamicState-06567",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a> or <a href=\"#pipeline-graphics-subsets-fragment-shader\">fragment shader state</a> and <code>VK_DYNAMIC_STATE_FRAGMENT_SHADING_RATE_KHR</code> is not included in <code>pDynamicState->pDynamicStates</code>, <a href=\"#VkPipelineFragmentShadingRateStateCreateInfoKHR\">VkPipelineFragmentShadingRateStateCreateInfoKHR</a>::<code>combinerOps</code>[0] <strong class=\"purple\">must</strong> be a valid <a href=\"#VkFragmentShadingRateCombinerOpKHR\">VkFragmentShadingRateCombinerOpKHR</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pDynamicState-06568",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a> or <a href=\"#pipeline-graphics-subsets-fragment-shader\">fragment shader state</a> and <code>VK_DYNAMIC_STATE_FRAGMENT_SHADING_RATE_KHR</code> is not included in <code>pDynamicState->pDynamicStates</code>, <a href=\"#VkPipelineFragmentShadingRateStateCreateInfoKHR\">VkPipelineFragmentShadingRateStateCreateInfoKHR</a>::<code>combinerOps</code>[1] <strong class=\"purple\">must</strong> be a valid <a href=\"#VkFragmentShadingRateCombinerOpKHR\">VkFragmentShadingRateCombinerOpKHR</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pDynamicState-04501",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a> or <a href=\"#pipeline-graphics-subsets-fragment-shader\">fragment shader state</a> and <code>VK_DYNAMIC_STATE_FRAGMENT_SHADING_RATE_KHR</code> is not included in <code>pDynamicState->pDynamicStates</code>, and the <a href=\"#features-primitiveFragmentShadingRate\"><code>primitiveFragmentShadingRate</code></a> feature is not enabled, <a href=\"#VkPipelineFragmentShadingRateStateCreateInfoKHR\">VkPipelineFragmentShadingRateStateCreateInfoKHR</a>::<code>combinerOps</code>[0] <strong class=\"purple\">must</strong> be <code>VK_FRAGMENT_SHADING_RATE_COMBINER_OP_KEEP_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pDynamicState-04502",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a> or <a href=\"#pipeline-graphics-subsets-fragment-shader\">fragment shader state</a> and <code>VK_DYNAMIC_STATE_FRAGMENT_SHADING_RATE_KHR</code> is not included in <code>pDynamicState->pDynamicStates</code>, and the <a href=\"#features-attachmentFragmentShadingRate\"><code>attachmentFragmentShadingRate</code></a> feature is not enabled, <a href=\"#VkPipelineFragmentShadingRateStateCreateInfoKHR\">VkPipelineFragmentShadingRateStateCreateInfoKHR</a>::<code>combinerOps</code>[1] <strong class=\"purple\">must</strong> be <code>VK_FRAGMENT_SHADING_RATE_COMBINER_OP_KEEP_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-primitiveFragmentShadingRateWithMultipleViewports-04504",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a> and the <a href=\"#limits-primitiveFragmentShadingRateWithMultipleViewports\"><code>primitiveFragmentShadingRateWithMultipleViewports</code></a> limit is not supported, and entry points specified in <code>pStages</code> write to the <code>ViewportIndex</code> built-in, they <strong class=\"purple\">must</strong> not also write to the <code>PrimitiveShadingRateKHR</code> built-in"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-fragmentShadingRateNonTrivialCombinerOps-04506",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a> or <a href=\"#pipeline-graphics-subsets-fragment-shader\">fragment shader state</a>, the <a href=\"#limits-fragmentShadingRateNonTrivialCombinerOps\"><code>fragmentShadingRateNonTrivialCombinerOps</code></a> limit is not supported, and <code>VK_DYNAMIC_STATE_FRAGMENT_SHADING_RATE_KHR</code> is not included in <code>pDynamicState->pDynamicStates</code>, elements of <a href=\"#VkPipelineFragmentShadingRateStateCreateInfoKHR\">VkPipelineFragmentShadingRateStateCreateInfoKHR</a>::<code>combinerOps</code> <strong class=\"purple\">must</strong> be <code>VK_FRAGMENT_SHADING_RATE_COMBINER_OP_KEEP_KHR</code> or <code>VK_FRAGMENT_SHADING_RATE_COMBINER_OP_REPLACE_KHR</code>"
|
|
}
|
|
],
|
|
"(VK_KHR_fragment_shading_rate)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-primitiveFragmentShadingRateWithMultipleViewports-04503",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a> and the <a href=\"#limits-primitiveFragmentShadingRateWithMultipleViewports\"><code>primitiveFragmentShadingRateWithMultipleViewports</code></a> limit is not supported, <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> is not included in <code>pDynamicState->pDynamicStates</code>, and <a href=\"#VkPipelineViewportStateCreateInfo\">VkPipelineViewportStateCreateInfo</a>::<code>viewportCount</code> is greater than <code>1</code>, entry points specified in <code>pStages</code> <strong class=\"purple\">must</strong> not write to the <code>PrimitiveShadingRateKHR</code> built-in"
|
|
}
|
|
],
|
|
"(VK_KHR_fragment_shading_rate)+(VK_NV_viewport_array2)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-primitiveFragmentShadingRateWithMultipleViewports-04505",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a> and the <a href=\"#limits-primitiveFragmentShadingRateWithMultipleViewports\"><code>primitiveFragmentShadingRateWithMultipleViewports</code></a> limit is not supported, and entry points specified in <code>pStages</code> write to the <code>ViewportMaskNV</code> built-in, they <strong class=\"purple\">must</strong> not also write to the <code>PrimitiveShadingRateKHR</code> built-in"
|
|
}
|
|
],
|
|
"(VK_NV_fragment_shading_rate_enums)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-None-06569",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-fragment-shader\">fragment shader state</a> and <code>VK_DYNAMIC_STATE_FRAGMENT_SHADING_RATE_KHR</code> is not included in <code>pDynamicState->pDynamicStates</code>, <a href=\"#VkPipelineFragmentShadingRateEnumStateCreateInfoNV\">VkPipelineFragmentShadingRateEnumStateCreateInfoNV</a>::<code>shadingRateType</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkFragmentShadingRateTypeNV\">VkFragmentShadingRateTypeNV</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pDynamicState-06570",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-fragment-shader\">fragment shader state</a> and <code>VK_DYNAMIC_STATE_FRAGMENT_SHADING_RATE_KHR</code> is not included in <code>pDynamicState->pDynamicStates</code>, <a href=\"#VkPipelineFragmentShadingRateEnumStateCreateInfoNV\">VkPipelineFragmentShadingRateEnumStateCreateInfoNV</a>::<code>shadingRate</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkFragmentShadingRateNV\">VkFragmentShadingRateNV</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pDynamicState-06571",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-fragment-shader\">fragment shader state</a> and <code>VK_DYNAMIC_STATE_FRAGMENT_SHADING_RATE_KHR</code> is not included in <code>pDynamicState->pDynamicStates</code>, <a href=\"#VkPipelineFragmentShadingRateEnumStateCreateInfoNV\">VkPipelineFragmentShadingRateEnumStateCreateInfoNV</a>::<code>combinerOps</code>[0] <strong class=\"purple\">must</strong> be a valid <a href=\"#VkFragmentShadingRateCombinerOpKHR\">VkFragmentShadingRateCombinerOpKHR</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pDynamicState-06572",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-fragment-shader\">fragment shader state</a> and <code>VK_DYNAMIC_STATE_FRAGMENT_SHADING_RATE_KHR</code> is not included in <code>pDynamicState->pDynamicStates</code>, <a href=\"#VkPipelineFragmentShadingRateEnumStateCreateInfoNV\">VkPipelineFragmentShadingRateEnumStateCreateInfoNV</a>::<code>combinerOps</code>[1] <strong class=\"purple\">must</strong> be a valid <a href=\"#VkFragmentShadingRateCombinerOpKHR\">VkFragmentShadingRateCombinerOpKHR</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pDynamicState-04569",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-fragment-shader\">fragment shader state</a> and <code>VK_DYNAMIC_STATE_FRAGMENT_SHADING_RATE_KHR</code> is not included in <code>pDynamicState->pDynamicStates</code>, and the <a href=\"#features-fragmentShadingRateEnums\"><code>fragmentShadingRateEnums</code></a> feature is not enabled, <a href=\"#VkPipelineFragmentShadingRateEnumStateCreateInfoNV\">VkPipelineFragmentShadingRateEnumStateCreateInfoNV</a>::<code>shadingRateType</code> <strong class=\"purple\">must</strong> be equal to <code>VK_FRAGMENT_SHADING_RATE_TYPE_FRAGMENT_SIZE_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pDynamicState-04570",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-fragment-shader\">fragment shader state</a> and <code>VK_DYNAMIC_STATE_FRAGMENT_SHADING_RATE_KHR</code> is not included in <code>pDynamicState->pDynamicStates</code>, and the <a href=\"#features-pipelineFragmentShadingRate\"><code>pipelineFragmentShadingRate</code></a> feature is not enabled, <a href=\"#VkPipelineFragmentShadingRateEnumStateCreateInfoNV\">VkPipelineFragmentShadingRateEnumStateCreateInfoNV</a>::<code>shadingRate</code> <strong class=\"purple\">must</strong> be equal to <code>VK_FRAGMENT_SHADING_RATE_1_INVOCATION_PER_PIXEL_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pDynamicState-04571",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-fragment-shader\">fragment shader state</a> and <code>VK_DYNAMIC_STATE_FRAGMENT_SHADING_RATE_KHR</code> is not included in <code>pDynamicState->pDynamicStates</code>, and the <a href=\"#features-primitiveFragmentShadingRate\"><code>primitiveFragmentShadingRate</code></a> feature is not enabled, <a href=\"#VkPipelineFragmentShadingRateEnumStateCreateInfoNV\">VkPipelineFragmentShadingRateEnumStateCreateInfoNV</a>::<code>combinerOps</code>[0] <strong class=\"purple\">must</strong> be <code>VK_FRAGMENT_SHADING_RATE_COMBINER_OP_KEEP_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pDynamicState-04572",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-fragment-shader\">fragment shader state</a> and <code>VK_DYNAMIC_STATE_FRAGMENT_SHADING_RATE_KHR</code> is not included in <code>pDynamicState->pDynamicStates</code>, and the <a href=\"#features-attachmentFragmentShadingRate\"><code>attachmentFragmentShadingRate</code></a> feature is not enabled, <a href=\"#VkPipelineFragmentShadingRateEnumStateCreateInfoNV\">VkPipelineFragmentShadingRateEnumStateCreateInfoNV</a>::<code>combinerOps</code>[1] <strong class=\"purple\">must</strong> be <code>VK_FRAGMENT_SHADING_RATE_COMBINER_OP_KEEP_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-fragmentShadingRateNonTrivialCombinerOps-04573",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-fragment-shader\">fragment shader state</a>, and the <a href=\"#limits-fragmentShadingRateNonTrivialCombinerOps\"><code>fragmentShadingRateNonTrivialCombinerOps</code></a> limit is not supported and <code>VK_DYNAMIC_STATE_FRAGMENT_SHADING_RATE_KHR</code> is not included in <code>pDynamicState->pDynamicStates</code>, elements of <a href=\"#VkPipelineFragmentShadingRateEnumStateCreateInfoNV\">VkPipelineFragmentShadingRateEnumStateCreateInfoNV</a>::<code>combinerOps</code> <strong class=\"purple\">must</strong> be <code>VK_FRAGMENT_SHADING_RATE_COMBINER_OP_KEEP_KHR</code> or <code>VK_FRAGMENT_SHADING_RATE_COMBINER_OP_REPLACE_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-None-04574",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-fragment-shader\">fragment shader state</a>, and the <a href=\"#features-supersampleFragmentShadingRates\"><code>supersampleFragmentShadingRates</code></a> feature is not enabled, <a href=\"#VkPipelineFragmentShadingRateEnumStateCreateInfoNV\">VkPipelineFragmentShadingRateEnumStateCreateInfoNV</a>::<code>shadingRate</code> <strong class=\"purple\">must</strong> not be equal to <code>VK_FRAGMENT_SHADING_RATE_2_INVOCATIONS_PER_PIXEL_NV</code>, <code>VK_FRAGMENT_SHADING_RATE_4_INVOCATIONS_PER_PIXEL_NV</code>, <code>VK_FRAGMENT_SHADING_RATE_8_INVOCATIONS_PER_PIXEL_NV</code>, or <code>VK_FRAGMENT_SHADING_RATE_16_INVOCATIONS_PER_PIXEL_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-None-04575",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-fragment-shader\">fragment shader state</a>, and the <a href=\"#features-noInvocationFragmentShadingRates\"><code>noInvocationFragmentShadingRates</code></a> feature is not enabled, <a href=\"#VkPipelineFragmentShadingRateEnumStateCreateInfoNV\">VkPipelineFragmentShadingRateEnumStateCreateInfoNV</a>::<code>shadingRate</code> <strong class=\"purple\">must</strong> not be equal to <code>VK_FRAGMENT_SHADING_RATE_NO_INVOCATIONS_NV</code>"
|
|
}
|
|
],
|
|
"!(VK_EXT_graphics_pipeline_library)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-None-06573",
|
|
"text": " The pipeline <strong class=\"purple\">must</strong> be created with a <a href=\"#pipeline-graphics-subsets-complete\">complete set of state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pStages-06600",
|
|
"text": " <code>pStages</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>stageCount</code> valid <a href=\"#VkPipelineShaderStageCreateInfo\">VkPipelineShaderStageCreateInfo</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pRasterizationState-06601",
|
|
"text": " <code>pRasterizationState</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkPipelineRasterizationStateCreateInfo\">VkPipelineRasterizationStateCreateInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-layout-06602",
|
|
"text": " <code>layout</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPipelineLayout\">VkPipelineLayout</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-renderPass-06603",
|
|
"text": " If <code>renderPass</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>renderPass</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkRenderPass\">VkRenderPass</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-stageCount-06604",
|
|
"text": " <code>stageCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_color_write_enable)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pDynamicStates-04800",
|
|
"text": " If the <a href=\"#features-colorWriteEnable\"><code>colorWriteEnable</code></a> feature is not enabled, there <strong class=\"purple\">must</strong> be no element of the <code>pDynamicStates</code> member of <code>pDynamicState</code> set to <code>VK_DYNAMIC_STATE_COLOR_WRITE_ENABLE_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_QCOM_render_pass_shader_resolve)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-rasterizationSamples-04899",
|
|
"text": " If the pipeline is being created with fragment shader state, and the <code><a href=\"#VK_QCOM_render_pass_shader_resolve\">VK_QCOM_render_pass_shader_resolve</a></code> extension is enabled, and if subpass has any input attachments, and if the subpass description contains <code>VK_SUBPASS_DESCRIPTION_FRAGMENT_REGION_BIT_QCOM</code>, then the sample count of the input attachments <strong class=\"purple\">must</strong> equal <code>rasterizationSamples</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-sampleShadingEnable-04900",
|
|
"text": " If the pipeline is being created with fragment shader state, and the <code><a href=\"#VK_QCOM_render_pass_shader_resolve\">VK_QCOM_render_pass_shader_resolve</a></code> extension is enabled, and if the subpass description contains <code>VK_SUBPASS_DESCRIPTION_FRAGMENT_REGION_BIT_QCOM</code>, then <code>sampleShadingEnable</code> <strong class=\"purple\">must</strong> be false"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-flags-04901",
|
|
"text": " If <code>flags</code> includes <code>VK_SUBPASS_DESCRIPTION_SHADER_RESOLVE_BIT_QCOM</code>, then the subpass <strong class=\"purple\">must</strong> be the last subpass in a subpass dependency chain"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-flags-04902",
|
|
"text": " If <code>flags</code> includes <code>VK_SUBPASS_DESCRIPTION_SHADER_RESOLVE_BIT_QCOM</code>, and if <code>pResolveAttachments</code> is not <code>NULL</code>, then each resolve attachment <strong class=\"purple\">must</strong> be <code>VK_ATTACHMENT_UNUSED</code>"
|
|
}
|
|
],
|
|
"!(VK_VERSION_1_3,VK_KHR_dynamic_rendering)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-renderPass-06574",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a>, <a href=\"#pipeline-graphics-subsets-fragment-shader\">fragment shader state</a>, or <a href=\"#pipeline-graphics-subsets-fragment-output\">fragment output interface state</a>, <code>renderPass</code> <strong class=\"purple\">must</strong> be a valid render pass object"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-renderPass-06575",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a>, <a href=\"#pipeline-graphics-subsets-fragment-shader\">fragment shader state</a>, or <a href=\"#pipeline-graphics-subsets-fragment-output\">fragment output interface state</a>, <code>renderPass</code> <strong class=\"purple\">must</strong> be <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> or a valid render pass object"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-dynamicRendering-06576",
|
|
"text": " If the <a href=\"#features-dynamicRendering\"><code>dynamicRendering</code></a> feature is not enabled and the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a>, <a href=\"#pipeline-graphics-subsets-fragment-shader\">fragment shader state</a>, or <a href=\"#pipeline-graphics-subsets-fragment-output\">fragment output interface state</a>, <code>renderPass</code> <strong class=\"purple\">must</strong> not be <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-multiview-06577",
|
|
"text": " If the <a href=\"#features-multiview\"><code>multiview</code></a> feature is not enabled, the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a>, <a href=\"#pipeline-graphics-subsets-fragment-shader\">fragment shader state</a>, or <a href=\"#pipeline-graphics-subsets-fragment-output\">fragment output interface state</a>, and <code>renderPass</code> is <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>viewMask</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-renderPass-06578",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a>, <a href=\"#pipeline-graphics-subsets-fragment-shader\">fragment shader state</a>, or <a href=\"#pipeline-graphics-subsets-fragment-output\">fragment output interface state</a>, and <code>renderPass</code> is <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the index of the most significant bit in <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>viewMask</code> <strong class=\"purple\">must</strong> be less than <a href=\"#limits-maxMultiviewViewCount\"><code>maxMultiviewViewCount</code></a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-renderPass-06579",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-fragment-output\">fragment output interface state</a>, and <code>renderPass</code> is <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>colorAttachmentCount</code> is not 0, <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>pColorAttachmentFormats</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>colorAttachmentCount</code> valid <a href=\"#VkFormat\">VkFormat</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-renderPass-06580",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-fragment-output\">fragment output interface state</a>, and <code>renderPass</code> is <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, each element of <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>pColorAttachmentFormats</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkFormat\">VkFormat</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-renderPass-06583",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-fragment-output\">fragment output interface state</a>, and <code>renderPass</code> is <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>depthAttachmentFormat</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkFormat\">VkFormat</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-renderPass-06584",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-fragment-output\">fragment output interface state</a>, and <code>renderPass</code> is <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>stencilAttachmentFormat</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkFormat\">VkFormat</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-renderPass-06585",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-fragment-output\">fragment output interface state</a>, <code>renderPass</code> is <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>depthAttachmentFormat</code> is not <code>VK_FORMAT_UNDEFINED</code>, it <strong class=\"purple\">must</strong> be a format with <a href=\"#potential-format-features\">potential format features</a> that include <code>VK_FORMAT_FEATURE_DEPTH_STENCIL_ATTACHMENT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-renderPass-06586",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-fragment-output\">fragment output interface state</a>, <code>renderPass</code> is <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>stencilAttachmentFormat</code> is not <code>VK_FORMAT_UNDEFINED</code>, it <strong class=\"purple\">must</strong> be a format with <a href=\"#potential-format-features\">potential format features</a> that include <code>VK_FORMAT_FEATURE_DEPTH_STENCIL_ATTACHMENT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-renderPass-06587",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-fragment-output\">fragment output interface state</a>, <code>renderPass</code> is <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>depthAttachmentFormat</code> is not <code>VK_FORMAT_UNDEFINED</code>, it <strong class=\"purple\">must</strong> be a format that includes a depth aspect"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-renderPass-06588",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-fragment-output\">fragment output interface state</a>, <code>renderPass</code> is <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>stencilAttachmentFormat</code> is not <code>VK_FORMAT_UNDEFINED</code>, it <strong class=\"purple\">must</strong> be a format that includes a stencil aspect"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-renderPass-06589",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-fragment-output\">fragment output interface state</a>, <code>renderPass</code> is <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>depthAttachmentFormat</code> is not <code>VK_FORMAT_UNDEFINED</code>, and <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>stencilAttachmentFormat</code> is not <code>VK_FORMAT_UNDEFINED</code>, <code>depthAttachmentFormat</code> <strong class=\"purple\">must</strong> equal <code>stencilAttachmentFormat</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-renderPass-06053",
|
|
"text": " If <code>renderPass</code> is <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the pipeline is being created with <a href=\"#pipeline-graphics-subsets-fragment-shader\">fragment shader state</a> and <a href=\"#pipeline-graphics-subsets-fragment-output\">fragment output interface state</a>, and either of <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::depthAttachmentFormat or <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::stencilAttachmentFormat are not <code>VK_FORMAT_UNDEFINED</code>, <code>pDepthStencilState</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkPipelineDepthStencilStateCreateInfo\">VkPipelineDepthStencilStateCreateInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-renderPass-06054",
|
|
"text": " If <code>renderPass</code> is <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the pipeline is being created with <a href=\"#pipeline-graphics-subsets-fragment-output\">fragment output interface state</a>, and <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::colorAttachmentCount is not equal to <code>0</code>, <code>pColorBlendState</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkPipelineColorBlendStateCreateInfo\">VkPipelineColorBlendStateCreateInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-renderPass-06055",
|
|
"text": " If <code>renderPass</code> is <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> and the pipeline is being created with <a href=\"#pipeline-graphics-subsets-fragment-output\">fragment output interface state</a>, <code>pColorBlendState->attachmentCount</code> <strong class=\"purple\">must</strong> be equal to <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::colorAttachmentCount"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-renderPass-06056",
|
|
"text": " If <code>renderPass</code> is <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> and the pipeline is being created with <a href=\"#pipeline-graphics-subsets-fragment-shader\">fragment shader state</a> the fragment shader <strong class=\"purple\">must</strong> not read from any input attachment"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+!(VK_NV_linear_color_attachment)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-renderPass-06581",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-fragment-output\">fragment output interface state</a>, <code>renderPass</code> is <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and any element of <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>pColorAttachmentFormats</code> is not <code>VK_FORMAT_UNDEFINED</code>, that format <strong class=\"purple\">must</strong> be a format with <a href=\"#potential-format-features\">potential format features</a> that include <code>VK_FORMAT_FEATURE_COLOR_ATTACHMENT_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_NV_linear_color_attachment)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-renderPass-06582",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-fragment-output\">fragment output interface state</a>, <code>renderPass</code> is <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and any element of <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>pColorAttachmentFormats</code> is not <code>VK_FORMAT_UNDEFINED</code>, that format <strong class=\"purple\">must</strong> be a format with <a href=\"#potential-format-features\">potential format features</a> that include <code>VK_FORMAT_FEATURE_COLOR_ATTACHMENT_BIT</code> or <code>VK_FORMAT_FEATURE_2_LINEAR_COLOR_ATTACHMENT_BIT_NV</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_EXT_graphics_pipeline_library)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-renderPass-06590",
|
|
"text": " If <code>renderPass</code> is <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> and the pipeline is being created with <a href=\"#pipeline-graphics-subsets-fragment-shader\">fragment shader state</a> but not <a href=\"#pipeline-graphics-subsets-fragment-output\">fragment output interface state</a>, <code>pDepthStencilState</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkPipelineDepthStencilStateCreateInfo\">VkPipelineDepthStencilStateCreateInfo</a> structure"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_KHR_multiview,VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-renderPass-06057",
|
|
"text": " If <code>renderPass</code> is <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a>, the <code>viewMask</code> member of a <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a> structure included in the <code>pNext</code> chain is not <code>0</code>, and the <a href=\"#features-multiview-tess\"><code>multiviewTessellationShader</code></a> feature is not enabled, then <code>pStages</code> <strong class=\"purple\">must</strong> not include tessellation shaders"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-renderPass-06058",
|
|
"text": " If <code>renderPass</code> is <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a>, the <code>viewMask</code> member of a <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a> structure included in the <code>pNext</code> chain is not <code>0</code>, and the <a href=\"#features-multiview-gs\"><code>multiviewGeometryShader</code></a> feature is not enabled, then <code>pStages</code> <strong class=\"purple\">must</strong> not include a geometry shader"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-renderPass-06059",
|
|
"text": " If <code>renderPass</code> is <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a>, and the <code>viewMask</code> member of a <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a> structure included in the <code>pNext</code> chain is not <code>0</code>, shaders in <code>pStages</code> <strong class=\"purple\">must</strong> not include variables decorated with the <code>Layer</code> built-in decoration in their interfaces"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-renderPass-06061",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-fragment-shader\">fragment shader state</a> and <code>renderPass</code> is <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, fragment shaders in <code>pStages</code> <strong class=\"purple\">must</strong> not include the <code>InputAttachment</code> capability"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-renderPass-06062",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-fragment-output\">fragment output interface state</a> and <code>renderPass</code> is <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, for each color attachment format defined by the <code>pColorAttachmentFormats</code> member of <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>, if its <a href=\"#potential-format-features\">potential format features</a> do not contain <code>VK_FORMAT_FEATURE_COLOR_ATTACHMENT_BLEND_BIT</code>, then the <code>blendEnable</code> member of the corresponding element of the <code>pAttachments</code> member of <code>pColorBlendState</code> <strong class=\"purple\">must</strong> be <code>VK_FALSE</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_AMD_mixed_attachment_samples,VK_NV_framebuffer_mixed_samples)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-renderPass-06063",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-fragment-output\">fragment output interface state</a> and <code>renderPass</code> is <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, if the <code>pNext</code> chain includes <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <code>VkAttachmentSampleCountInfoNV</code>, the <code>colorAttachmentCount</code> member of that structure <strong class=\"purple\">must</strong> be equal to the value of <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>colorAttachmentCount</code>"
|
|
}
|
|
],
|
|
"(VK_ARM_rasterization_order_attachment_access)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-flags-06591",
|
|
"text": " If <code>pStages</code> includes a fragment shader stage, and the fragment shader declares the <code>EarlyFragmentTests</code> execution mode, the <code>flags</code> member of <a href=\"#VkPipelineDepthStencilStateCreateInfo\">VkPipelineDepthStencilStateCreateInfo</a> <strong class=\"purple\">must</strong> not include <code>VK_PIPELINE_DEPTH_STENCIL_STATE_CREATE_RASTERIZATION_ORDER_ATTACHMENT_DEPTH_ACCESS_BIT_ARM</code> or <code>VK_PIPELINE_DEPTH_STENCIL_STATE_CREATE_RASTERIZATION_ORDER_ATTACHMENT_STENCIL_ACCESS_BIT_ARM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-flags-06484",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-fragment-output\">fragment output interface state</a> and the <code>flags</code> member of <a href=\"#VkPipelineColorBlendStateCreateInfo\">VkPipelineColorBlendStateCreateInfo</a> includes <code>VK_PIPELINE_COLOR_BLEND_STATE_CREATE_RASTERIZATION_ORDER_ATTACHMENT_ACCESS_BIT_ARM</code> <code>subpass</code> <strong class=\"purple\">must</strong> have been created with <code>VK_SUBPASS_DESCRIPTION_RASTERIZATION_ORDER_ATTACHMENT_COLOR_ACCESS_BIT_ARM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-flags-06485",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-fragment-output\">fragment output interface state</a> and the <code>flags</code> member of <a href=\"#VkPipelineDepthStencilStateCreateInfo\">VkPipelineDepthStencilStateCreateInfo</a> includes <code>VK_PIPELINE_DEPTH_STENCIL_STATE_CREATE_RASTERIZATION_ORDER_ATTACHMENT_DEPTH_ACCESS_BIT_ARM</code>, <code>subpass</code> <strong class=\"purple\">must</strong> have been created with <code>VK_SUBPASS_DESCRIPTION_RASTERIZATION_ORDER_ATTACHMENT_DEPTH_ACCESS_BIT_ARM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-flags-06486",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-fragment-output\">fragment output interface state</a> and the <code>flags</code> member of <a href=\"#VkPipelineDepthStencilStateCreateInfo\">VkPipelineDepthStencilStateCreateInfo</a> includes <code>VK_PIPELINE_DEPTH_STENCIL_STATE_CREATE_RASTERIZATION_ORDER_ATTACHMENT_STENCIL_ACCESS_BIT_ARM</code>, <code>subpass</code> <strong class=\"purple\">must</strong> have been created with <code>VK_SUBPASS_DESCRIPTION_RASTERIZATION_ORDER_ATTACHMENT_STENCIL_ACCESS_BIT_ARM</code>"
|
|
}
|
|
],
|
|
"(VK_ARM_rasterization_order_attachment_access)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-flags-06482",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-fragment-output\">fragment output interface state</a> and the <code>flags</code> member of <a href=\"#VkPipelineColorBlendStateCreateInfo\">VkPipelineColorBlendStateCreateInfo</a> includes <code>VK_PIPELINE_COLOR_BLEND_STATE_CREATE_RASTERIZATION_ORDER_ATTACHMENT_ACCESS_BIT_ARM</code>, <code>renderpass</code> <strong class=\"purple\">must</strong> not be <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-flags-06483",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-fragment-output\">fragment output interface state</a> and the <code>flags</code> member of <a href=\"#VkPipelineDepthStencilStateCreateInfo\">VkPipelineDepthStencilStateCreateInfo</a> includes <code>VK_PIPELINE_DEPTH_STENCIL_STATE_CREATE_RASTERIZATION_ORDER_ATTACHMENT_DEPTH_ACCESS_BIT_ARM</code> or <code>VK_PIPELINE_DEPTH_STENCIL_STATE_CREATE_RASTERIZATION_ORDER_ATTACHMENT_STENCIL_ACCESS_BIT_ARM</code>, <code>renderpass</code> <strong class=\"purple\">must</strong> not be <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
}
|
|
],
|
|
"(VK_ARM_rasterization_order_attachment_access)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_AMD_mixed_attachment_samples,VK_NV_framebuffer_mixed_samples)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pColorAttachmentSamples-06592",
|
|
"text": " If the <a href=\"#pipeline-graphics-subsets-fragment-output\">fragment output interface state</a>, elements of the <code>pColorAttachmentSamples</code> member of <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> <strong class=\"purple\">must</strong> be valid <a href=\"#VkSampleCountFlagBits\">VkSampleCountFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-depthStencilAttachmentSamples-06593",
|
|
"text": " If the <a href=\"#pipeline-graphics-subsets-fragment-output\">fragment output interface state</a> and the <code>depthStencilAttachmentSamples</code> member of <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> is not 0, it <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSampleCountFlagBits\">VkSampleCountFlagBits</a> value"
|
|
}
|
|
],
|
|
"(VK_EXT_pipeline_creation_feedback,VK_VERSION_1_3)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pipelineStageCreationFeedbackCount-06594",
|
|
"text": " If <a href=\"#VkPipelineCreationFeedbackCreateInfo\">VkPipelineCreationFeedbackCreateInfo</a>::<code>pipelineStageCreationFeedbackCount</code> is not <code>0</code>, it <strong class=\"purple\">must</strong> be equal to <code>stageCount</code>"
|
|
}
|
|
],
|
|
"(VK_NVX_multiview_per_view_attributes)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-renderPass-06595",
|
|
"text": " If <code>renderPass</code> is <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a> or <a href=\"#pipeline-graphics-subsets-fragment-shader\">fragment shader state</a>, and <a href=\"#VkMultiviewPerViewAttributesInfoNVX\">VkMultiviewPerViewAttributesInfoNVX</a>::<code>perViewAttributesPositionXOnly</code> is <code>VK_TRUE</code> then <a href=\"#VkMultiviewPerViewAttributesInfoNVX\">VkMultiviewPerViewAttributesInfoNVX</a>::<code>perViewAttributes</code> <strong class=\"purple\">must</strong> also be <code>VK_TRUE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-flags-06596",
|
|
"text": " If <a href=\"#VkGraphicsPipelineLibraryCreateInfoEXT\">VkGraphicsPipelineLibraryCreateInfoEXT</a>::<code>flags</code> includes only one of <code>VK_GRAPHICS_PIPELINE_LIBRARY_PRE_RASTERIZATION_SHADERS_BIT_EXT</code> or <code>VK_GRAPHICS_PIPELINE_LIBRARY_FRAGMENT_SHADER_BIT_EXT</code>, and an element of <a href=\"#VkPipelineLibraryCreateInfoKHR\">VkPipelineLibraryCreateInfoKHR</a>::<code>pLibraries</code> includes the other flag, the value of <a href=\"#VkMultiviewPerViewAttributesInfoNVX\">VkMultiviewPerViewAttributesInfoNVX</a>::<code>perViewAttributes</code> specified in both this pipeline and the library <strong class=\"purple\">must</strong> be equal"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pLibraries-06597",
|
|
"text": " If one element of <a href=\"#VkPipelineLibraryCreateInfoKHR\">VkPipelineLibraryCreateInfoKHR</a>::<code>pLibraries</code> includes <code>VK_GRAPHICS_PIPELINE_LIBRARY_PRE_RASTERIZATION_SHADERS_BIT_EXT</code> and another element includes <code>VK_GRAPHICS_PIPELINE_LIBRARY_FRAGMENT_SHADER_BIT_EXT</code>, the value of <a href=\"#VkMultiviewPerViewAttributesInfoNVX\">VkMultiviewPerViewAttributesInfoNVX</a>::<code>perViewAttributes</code> specified in both libraries <strong class=\"purple\">must</strong> be equal"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-flags-06598",
|
|
"text": " If <a href=\"#VkGraphicsPipelineLibraryCreateInfoEXT\">VkGraphicsPipelineLibraryCreateInfoEXT</a>::<code>flags</code> includes only one of <code>VK_GRAPHICS_PIPELINE_LIBRARY_PRE_RASTERIZATION_SHADERS_BIT_EXT</code> or <code>VK_GRAPHICS_PIPELINE_LIBRARY_FRAGMENT_SHADER_BIT_EXT</code>, and an element of <a href=\"#VkPipelineLibraryCreateInfoKHR\">VkPipelineLibraryCreateInfoKHR</a>::<code>pLibraries</code> includes the other flag, the value of <a href=\"#VkMultiviewPerViewAttributesInfoNVX\">VkMultiviewPerViewAttributesInfoNVX</a>::<code>perViewAttributesPositionXOnly</code> specified in both this pipeline and the library <strong class=\"purple\">must</strong> be equal"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pLibraries-06599",
|
|
"text": " If one element of <a href=\"#VkPipelineLibraryCreateInfoKHR\">VkPipelineLibraryCreateInfoKHR</a>::<code>pLibraries</code> includes <code>VK_GRAPHICS_PIPELINE_LIBRARY_PRE_RASTERIZATION_SHADERS_BIT_EXT</code> and another element includes <code>VK_GRAPHICS_PIPELINE_LIBRARY_FRAGMENT_SHADER_BIT_EXT</code>, the value of <a href=\"#VkMultiviewPerViewAttributesInfoNVX\">VkMultiviewPerViewAttributesInfoNVX</a>::<code>perViewAttributesPositionXOnly</code> specified in both libraries <strong class=\"purple\">must</strong> be equal"
|
|
}
|
|
],
|
|
"!(VK_EXT_graphics_pipeline_library)+(VK_NV_device_generated_commands)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pNext-06605",
|
|
"text": " If the <code>pNext</code> chain includes an instance of <a href=\"#VkGraphicsPipelineShaderGroupsCreateInfoNV\">VkGraphicsPipelineShaderGroupsCreateInfoNV</a>, its <code>groupCount</code> member <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_graphics_pipeline_library)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-graphicsPipelineLibrary-06606",
|
|
"text": " If the <a href=\"#features-graphicsPipelineLibrary\"><code>graphicsPipelineLibrary</code></a> feature is not enabled, <code>flags</code> <strong class=\"purple\">must</strong> not include <code>VK_PIPELINE_CREATE_LIBRARY_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-graphicsPipelineLibrary-06607",
|
|
"text": " If the <a href=\"#features-graphicsPipelineLibrary\"><code>graphicsPipelineLibrary</code></a> feature is not enabled, the pipeline <strong class=\"purple\">must</strong> be created with a <a href=\"#pipelines-graphics-subsets-complete\">complete set of state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-flags-06608",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-complete\">all possible state subsets</a>, <code>flags</code> <strong class=\"purple\">must</strong> not include <code>VK_PIPELINE_CREATE_LIBRARY_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-flags-06609",
|
|
"text": " If <code>flags</code> includes <code>VK_PIPELINE_CREATE_LINK_TIME_OPTIMIZATION_BIT_EXT</code>, pipeline libraries included via <a href=\"#VkPipelineLibraryCreateInfoKHR\">VkPipelineLibraryCreateInfoKHR</a> <strong class=\"purple\">must</strong> have been created with <code>VK_PIPELINE_CREATE_RETAIN_LINK_TIME_OPTIMIZATION_INFO_BIT_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-flags-06610",
|
|
"text": " If <code>flags</code> includes <code>VK_PIPELINE_CREATE_RETAIN_LINK_TIME_OPTIMIZATION_INFO_BIT_EXT</code>, pipeline libraries included via <a href=\"#VkPipelineLibraryCreateInfoKHR\">VkPipelineLibraryCreateInfoKHR</a> <strong class=\"purple\">must</strong> have been created with <code>VK_PIPELINE_CREATE_RETAIN_LINK_TIME_OPTIMIZATION_INFO_BIT_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pLibraries-06611",
|
|
"text": " Any pipeline libraries included via <a href=\"#VkPipelineLibraryCreateInfoKHR\">VkPipelineLibraryCreateInfoKHR</a>::<code>pLibraries</code> <strong class=\"purple\">must</strong> not include any <a href=\"#pipeline-graphics-subsets\">state subset</a> already defined by this structure or defined by any other pipeline library in <a href=\"#VkPipelineLibraryCreateInfoKHR\">VkPipelineLibraryCreateInfoKHR</a>::<code>pLibraries</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-flags-06612",
|
|
"text": " If <a href=\"#VkGraphicsPipelineLibraryCreateInfoEXT\">VkGraphicsPipelineLibraryCreateInfoEXT</a>::<code>flags</code> includes only one of <code>VK_GRAPHICS_PIPELINE_LIBRARY_PRE_RASTERIZATION_SHADERS_BIT_EXT</code> or <code>VK_GRAPHICS_PIPELINE_LIBRARY_FRAGMENT_SHADER_BIT_EXT</code>, and an element of <a href=\"#VkPipelineLibraryCreateInfoKHR\">VkPipelineLibraryCreateInfoKHR</a>::<code>pLibraries</code> includes the other flag, and <code>layout</code> was not created with <code>VK_PIPELINE_LAYOUT_CREATE_INDEPENDENT_SETS_BIT_EXT</code>, then the <code>layout</code> used by this pipeline and the library <strong class=\"purple\">must</strong> be <em>identically defined</em>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pLibraries-06613",
|
|
"text": " If one element of <a href=\"#VkPipelineLibraryCreateInfoKHR\">VkPipelineLibraryCreateInfoKHR</a>::<code>pLibraries</code> includes <code>VK_GRAPHICS_PIPELINE_LIBRARY_PRE_RASTERIZATION_SHADERS_BIT_EXT</code> and another element includes <code>VK_GRAPHICS_PIPELINE_LIBRARY_FRAGMENT_SHADER_BIT_EXT</code>, and the <code>layout</code> specified by either library was not created with <code>VK_PIPELINE_LAYOUT_CREATE_INDEPENDENT_SETS_BIT_EXT</code>, then the <code>layout</code> used by each library <strong class=\"purple\">must</strong> be <em>identically defined</em>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-flags-06614",
|
|
"text": " If <a href=\"#VkGraphicsPipelineLibraryCreateInfoEXT\">VkGraphicsPipelineLibraryCreateInfoEXT</a>::<code>flags</code> includes only one of <code>VK_GRAPHICS_PIPELINE_LIBRARY_PRE_RASTERIZATION_SHADERS_BIT_EXT</code> or <code>VK_GRAPHICS_PIPELINE_LIBRARY_FRAGMENT_SHADER_BIT_EXT</code>, an element of <a href=\"#VkPipelineLibraryCreateInfoKHR\">VkPipelineLibraryCreateInfoKHR</a>::<code>pLibraries</code> includes the other subset, and <code>layout</code> was created with <code>VK_PIPELINE_LAYOUT_CREATE_INDEPENDENT_SETS_BIT_EXT</code>, then the <code>layout</code> used by the library <strong class=\"purple\">must</strong> also have been created with <code>VK_PIPELINE_LAYOUT_CREATE_INDEPENDENT_SETS_BIT_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pLibraries-06615",
|
|
"text": " If one element of <a href=\"#VkPipelineLibraryCreateInfoKHR\">VkPipelineLibraryCreateInfoKHR</a>::<code>pLibraries</code> includes <code>VK_GRAPHICS_PIPELINE_LIBRARY_PRE_RASTERIZATION_SHADERS_BIT_EXT</code> and another element includes <code>VK_GRAPHICS_PIPELINE_LIBRARY_FRAGMENT_SHADER_BIT_EXT</code>, and the <code>layout</code> specified by either library was created with <code>VK_PIPELINE_LAYOUT_CREATE_INDEPENDENT_SETS_BIT_EXT</code>, then the <code>layout</code> used by both libraries <strong class=\"purple\">must</strong> have been created with <code>VK_PIPELINE_LAYOUT_CREATE_INDEPENDENT_SETS_BIT_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-flags-06616",
|
|
"text": " If <a href=\"#VkGraphicsPipelineLibraryCreateInfoEXT\">VkGraphicsPipelineLibraryCreateInfoEXT</a>::<code>flags</code> includes only one of <code>VK_GRAPHICS_PIPELINE_LIBRARY_PRE_RASTERIZATION_SHADERS_BIT_EXT</code> or <code>VK_GRAPHICS_PIPELINE_LIBRARY_FRAGMENT_SHADER_BIT_EXT</code>, an element of <a href=\"#VkPipelineLibraryCreateInfoKHR\">VkPipelineLibraryCreateInfoKHR</a>::<code>pLibraries</code> includes the other subset, and <code>layout</code> was created with <code>VK_PIPELINE_LAYOUT_CREATE_INDEPENDENT_SETS_BIT_EXT</code>, elements of the <code>pSetLayouts</code> array which <code>layout</code> was created with that are not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> <strong class=\"purple\">must</strong> be <em>identically defined</em> to the element at the same index of <code>pSetLayouts</code> used to create the library’s <code>layout</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pLibraries-06617",
|
|
"text": " If one element of <a href=\"#VkPipelineLibraryCreateInfoKHR\">VkPipelineLibraryCreateInfoKHR</a>::<code>pLibraries</code> includes <code>VK_GRAPHICS_PIPELINE_LIBRARY_PRE_RASTERIZATION_SHADERS_BIT_EXT</code> and another element includes <code>VK_GRAPHICS_PIPELINE_LIBRARY_FRAGMENT_SHADER_BIT_EXT</code>, and the <code>layout</code> specified by either library was created with <code>VK_PIPELINE_LAYOUT_CREATE_INDEPENDENT_SETS_BIT_EXT</code>, elements of the <code>pSetLayouts</code> array which either <code>layout</code> was created with that are not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> <strong class=\"purple\">must</strong> be <em>identically defined</em> to the element at the same index of <code>pSetLayouts</code> used to create the other library’s <code>layout</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-flags-06618",
|
|
"text": " If <a href=\"#VkGraphicsPipelineLibraryCreateInfoEXT\">VkGraphicsPipelineLibraryCreateInfoEXT</a>::<code>flags</code> includes only one of <code>VK_GRAPHICS_PIPELINE_LIBRARY_PRE_RASTERIZATION_SHADERS_BIT_EXT</code> or <code>VK_GRAPHICS_PIPELINE_LIBRARY_FRAGMENT_SHADER_BIT_EXT</code>, and an element of <a href=\"#VkPipelineLibraryCreateInfoKHR\">VkPipelineLibraryCreateInfoKHR</a>::<code>pLibraries</code> includes the other flag, any descriptor set layout <em>N</em> specified by <code>layout</code> in both this pipeline and the library which include bindings accessed by shader stages in each <strong class=\"purple\">must</strong> be <em>identically defined</em>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pLibraries-06619",
|
|
"text": " If one element of <a href=\"#VkPipelineLibraryCreateInfoKHR\">VkPipelineLibraryCreateInfoKHR</a>::<code>pLibraries</code> includes <code>VK_GRAPHICS_PIPELINE_LIBRARY_PRE_RASTERIZATION_SHADERS_BIT_EXT</code> and another element includes <code>VK_GRAPHICS_PIPELINE_LIBRARY_FRAGMENT_SHADER_BIT_EXT</code>, any descriptor set layout <em>N</em> specified by <code>layout</code> in both libraries which include bindings accessed by shader stages in each <strong class=\"purple\">must</strong> be <em>identically defined</em>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-flags-06620",
|
|
"text": " If <a href=\"#VkGraphicsPipelineLibraryCreateInfoEXT\">VkGraphicsPipelineLibraryCreateInfoEXT</a>::<code>flags</code> includes only one of <code>VK_GRAPHICS_PIPELINE_LIBRARY_PRE_RASTERIZATION_SHADERS_BIT_EXT</code> or <code>VK_GRAPHICS_PIPELINE_LIBRARY_FRAGMENT_SHADER_BIT_EXT</code>, and an element of <a href=\"#VkPipelineLibraryCreateInfoKHR\">VkPipelineLibraryCreateInfoKHR</a>::<code>pLibraries</code> includes the other flag, push constants specified in <code>layout</code> in both this pipeline and the library which are available to shader stages in each <strong class=\"purple\">must</strong> be <em>identically defined</em>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pLibraries-06621",
|
|
"text": " If one element of <a href=\"#VkPipelineLibraryCreateInfoKHR\">VkPipelineLibraryCreateInfoKHR</a>::<code>pLibraries</code> includes <code>VK_GRAPHICS_PIPELINE_LIBRARY_PRE_RASTERIZATION_SHADERS_BIT_EXT</code> and another element includes <code>VK_GRAPHICS_PIPELINE_LIBRARY_FRAGMENT_SHADER_BIT_EXT</code>, push constants specified in <code>layout</code> in both this pipeline and the library which are available to shader stages in each <strong class=\"purple\">must</strong> be <em>identically defined</em>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-flags-06679",
|
|
"text": " If <a href=\"#VkGraphicsPipelineLibraryCreateInfoEXT\">VkGraphicsPipelineLibraryCreateInfoEXT</a>::<code>flags</code> includes only one of <code>VK_GRAPHICS_PIPELINE_LIBRARY_PRE_RASTERIZATION_SHADERS_BIT_EXT</code> or <code>VK_GRAPHICS_PIPELINE_LIBRARY_FRAGMENT_SHADER_BIT_EXT</code>, an element of <a href=\"#VkPipelineLibraryCreateInfoKHR\">VkPipelineLibraryCreateInfoKHR</a>::<code>pLibraries</code> includes the other subset, and any element of the <code>pSetLayouts</code> array which <code>layout</code> was created with was <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, then the corresponding element of the <code>pSetLayouts</code> array used to create the library’s <code>layout</code> <strong class=\"purple\">must</strong> not be <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-flags-06680",
|
|
"text": " If <a href=\"#VkGraphicsPipelineLibraryCreateInfoEXT\">VkGraphicsPipelineLibraryCreateInfoEXT</a>::<code>flags</code> includes only one of <code>VK_GRAPHICS_PIPELINE_LIBRARY_PRE_RASTERIZATION_SHADERS_BIT_EXT</code> or <code>VK_GRAPHICS_PIPELINE_LIBRARY_FRAGMENT_SHADER_BIT_EXT</code>, an element of <a href=\"#VkPipelineLibraryCreateInfoKHR\">VkPipelineLibraryCreateInfoKHR</a>::<code>pLibraries</code> includes the other subset, and any element of the <code>pSetLayouts</code> array used to create the library’s <code>layout</code> was <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, then the corresponding element of the <code>pSetLayouts</code> array used to create this pipeline’s <code>layout</code> <strong class=\"purple\">must</strong> not be <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pLibraries-06681",
|
|
"text": " If one element of <a href=\"#VkPipelineLibraryCreateInfoKHR\">VkPipelineLibraryCreateInfoKHR</a>::<code>pLibraries</code> includes <code>VK_GRAPHICS_PIPELINE_LIBRARY_PRE_RASTERIZATION_SHADERS_BIT_EXT</code> and another element includes <code>VK_GRAPHICS_PIPELINE_LIBRARY_FRAGMENT_SHADER_BIT_EXT</code>, and any element of the <code>pSetLayouts</code> array used to create each library’s <code>layout</code> was <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, then the corresponding element of the <code>pSetLayouts</code> array used to create the other library’s <code>layout</code> <strong class=\"purple\">must</strong> not be <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-flags-06756",
|
|
"text": " If <a href=\"#VkGraphicsPipelineLibraryCreateInfoEXT\">VkGraphicsPipelineLibraryCreateInfoEXT</a>::<code>flags</code> includes only one of <code>VK_GRAPHICS_PIPELINE_LIBRARY_PRE_RASTERIZATION_SHADERS_BIT_EXT</code> or <code>VK_GRAPHICS_PIPELINE_LIBRARY_FRAGMENT_SHADER_BIT_EXT</code>, an element of <a href=\"#VkPipelineLibraryCreateInfoKHR\">VkPipelineLibraryCreateInfoKHR</a>::<code>pLibraries</code> includes the other subset, and any element of the <code>pSetLayouts</code> array which <code>layout</code> was created with was <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, then the corresponding element of the <code>pSetLayouts</code> array used to create the library’s <code>layout</code> <strong class=\"purple\">must</strong> not have shader bindings for shaders in the other subset"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-flags-06757",
|
|
"text": " If <a href=\"#VkGraphicsPipelineLibraryCreateInfoEXT\">VkGraphicsPipelineLibraryCreateInfoEXT</a>::<code>flags</code> includes only one of <code>VK_GRAPHICS_PIPELINE_LIBRARY_PRE_RASTERIZATION_SHADERS_BIT_EXT</code> or <code>VK_GRAPHICS_PIPELINE_LIBRARY_FRAGMENT_SHADER_BIT_EXT</code>, an element of <a href=\"#VkPipelineLibraryCreateInfoKHR\">VkPipelineLibraryCreateInfoKHR</a>::<code>pLibraries</code> includes the other subset, and any element of the <code>pSetLayouts</code> array used to create the library’s <code>layout</code> was <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, then the corresponding element of the <code>pSetLayouts</code> array used to create this pipeline’s <code>layout</code> <strong class=\"purple\">must</strong> not have shader bindings for shaders in the other subset"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pLibraries-06758",
|
|
"text": " If one element of <a href=\"#VkPipelineLibraryCreateInfoKHR\">VkPipelineLibraryCreateInfoKHR</a>::<code>pLibraries</code> includes <code>VK_GRAPHICS_PIPELINE_LIBRARY_PRE_RASTERIZATION_SHADERS_BIT_EXT</code> and another element includes <code>VK_GRAPHICS_PIPELINE_LIBRARY_FRAGMENT_SHADER_BIT_EXT</code>, and any element of the <code>pSetLayouts</code> array used to create each library’s <code>layout</code> was <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, then the corresponding element of the <code>pSetLayouts</code> array used to create the other library’s <code>layout</code> <strong class=\"purple\">must</strong> not have shader bindings for shaders in the other subset"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-flags-06682",
|
|
"text": " If <a href=\"#VkGraphicsPipelineLibraryCreateInfoEXT\">VkGraphicsPipelineLibraryCreateInfoEXT</a>::<code>flags</code> includes both <code>VK_GRAPHICS_PIPELINE_LIBRARY_PRE_RASTERIZATION_SHADERS_BIT_EXT</code> and <code>VK_GRAPHICS_PIPELINE_LIBRARY_FRAGMENT_SHADER_BIT_EXT</code>, <code>layout</code> <strong class=\"purple\">must</strong> have been created with no elements of the <code>pSetLayouts</code> array set to <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-flags-06683",
|
|
"text": " If <a href=\"#VkGraphicsPipelineLibraryCreateInfoEXT\">VkGraphicsPipelineLibraryCreateInfoEXT</a>::<code>flags</code> includes <code>VK_GRAPHICS_PIPELINE_LIBRARY_PRE_RASTERIZATION_SHADERS_BIT_EXT</code> and <code>pRasterizationState</code>-><code>rasterizerDiscardEnable</code> is <code>VK_TRUE</code>, <code>layout</code> <strong class=\"purple\">must</strong> have been created with no elements of the <code>pSetLayouts</code> array set to <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-flags-06684",
|
|
"text": " If <a href=\"#VkGraphicsPipelineLibraryCreateInfoEXT\">VkGraphicsPipelineLibraryCreateInfoEXT</a>::<code>flags</code> includes at least one of and no more than two of <code>VK_GRAPHICS_PIPELINE_LIBRARY_PRE_RASTERIZATION_SHADERS_BIT_EXT</code>, <code>VK_GRAPHICS_PIPELINE_LIBRARY_FRAGMENT_SHADER_BIT_EXT</code>, or <code>VK_GRAPHICS_PIPELINE_LIBRARY_FRAGMENT_OUTPUT_INTERFACE_BIT_EXT</code>, and an element of <a href=\"#VkPipelineLibraryCreateInfoKHR\">VkPipelineLibraryCreateInfoKHR</a>::<code>pLibraries</code> includes one of the other flags, the value of <code>subpass</code> <strong class=\"purple\">must</strong> be equal to that used to create the library"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pLibraries-06623",
|
|
"text": " If one element of <a href=\"#VkPipelineLibraryCreateInfoKHR\">VkPipelineLibraryCreateInfoKHR</a>::<code>pLibraries</code> includes at least one of and no more than two of <code>VK_GRAPHICS_PIPELINE_LIBRARY_PRE_RASTERIZATION_SHADERS_BIT_EXT</code>, <code>VK_GRAPHICS_PIPELINE_LIBRARY_FRAGMENT_SHADER_BIT_EXT</code>, or <code>VK_GRAPHICS_PIPELINE_LIBRARY_FRAGMENT_OUTPUT_INTERFACE_BIT_EXT</code>, and another element of <a href=\"#VkPipelineLibraryCreateInfoKHR\">VkPipelineLibraryCreateInfoKHR</a>::<code>pLibraries</code> includes one of the other flags, the value of <code>subpass</code> used to create each library <strong class=\"purple\">must</strong> be identical"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-renderpass-06624",
|
|
"text": " If <code>renderpass</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <a href=\"#VkGraphicsPipelineLibraryCreateInfoEXT\">VkGraphicsPipelineLibraryCreateInfoEXT</a>::<code>flags</code> includes at least one of and no more than two of <code>VK_GRAPHICS_PIPELINE_LIBRARY_PRE_RASTERIZATION_SHADERS_BIT_EXT</code>, <code>VK_GRAPHICS_PIPELINE_LIBRARY_FRAGMENT_SHADER_BIT_EXT</code>, or <code>VK_GRAPHICS_PIPELINE_LIBRARY_FRAGMENT_OUTPUT_INTERFACE_BIT_EXT</code>, and an element of <a href=\"#VkPipelineLibraryCreateInfoKHR\">VkPipelineLibraryCreateInfoKHR</a>::<code>pLibraries</code> includes one of the other flags, <code>renderPass</code> <strong class=\"purple\">must</strong> be compatible with that used to create the library"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pLibraries-06628",
|
|
"text": " If one element of <a href=\"#VkPipelineLibraryCreateInfoKHR\">VkPipelineLibraryCreateInfoKHR</a>::<code>pLibraries</code> includes at least one of and no more than two of <code>VK_GRAPHICS_PIPELINE_LIBRARY_PRE_RASTERIZATION_SHADERS_BIT_EXT</code>, <code>VK_GRAPHICS_PIPELINE_LIBRARY_FRAGMENT_SHADER_BIT_EXT</code>, or <code>VK_GRAPHICS_PIPELINE_LIBRARY_FRAGMENT_OUTPUT_INTERFACE_BIT_EXT</code>, and another element of <a href=\"#VkPipelineLibraryCreateInfoKHR\">VkPipelineLibraryCreateInfoKHR</a>::<code>pLibraries</code> includes one of the other flags, the <code>renderPass</code> objects used to create each library <strong class=\"purple\">must</strong> be compatible or all equal to <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pMultisampleState-06629",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-fragment-shader\">fragment shader state</a> <code>pMultisampleState</code> <strong class=\"purple\">must</strong> be <code>NULL</code> or a valid pointer to a valid <a href=\"#VkPipelineMultisampleStateCreateInfo\">VkPipelineMultisampleStateCreateInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-flags-06633",
|
|
"text": " If <a href=\"#VkGraphicsPipelineLibraryCreateInfoEXT\">VkGraphicsPipelineLibraryCreateInfoEXT</a>::<code>flags</code> includes <code>VK_GRAPHICS_PIPELINE_LIBRARY_FRAGMENT_SHADER_BIT_EXT</code> with a <code>pMultisampleState</code> that was not <code>NULL</code>, and an element of <a href=\"#VkPipelineLibraryCreateInfoKHR\">VkPipelineLibraryCreateInfoKHR</a>::<code>pLibraries</code> was created with <code>VK_GRAPHICS_PIPELINE_LIBRARY_FRAGMENT_OUTPUT_INTERFACE_BIT_EXT</code>, <code>pMultisampleState</code> <strong class=\"purple\">must</strong> be <em>identically defined</em> to that used to create the library"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pLibraries-06634",
|
|
"text": " If an element of <a href=\"#VkPipelineLibraryCreateInfoKHR\">VkPipelineLibraryCreateInfoKHR</a>::<code>pLibraries</code> was created with <code>VK_GRAPHICS_PIPELINE_LIBRARY_FRAGMENT_SHADER_BIT_EXT</code> with a <code>pMultisampleState</code> that was not <code>NULL</code>, and if <a href=\"#VkGraphicsPipelineLibraryCreateInfoEXT\">VkGraphicsPipelineLibraryCreateInfoEXT</a>::<code>flags</code> includes <code>VK_GRAPHICS_PIPELINE_LIBRARY_FRAGMENT_OUTPUT_INTERFACE_BIT_EXT</code>, <code>pMultisampleState</code> <strong class=\"purple\">must</strong> be <em>identically defined</em> to that used to create the library"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pLibraries-06635",
|
|
"text": " If one element of <a href=\"#VkPipelineLibraryCreateInfoKHR\">VkPipelineLibraryCreateInfoKHR</a>::<code>pLibraries</code> was created with <code>VK_GRAPHICS_PIPELINE_LIBRARY_FRAGMENT_SHADER_BIT_EXT</code> with a <code>pMultisampleState</code> that was not <code>NULL</code>, and if a different element of <a href=\"#VkPipelineLibraryCreateInfoKHR\">VkPipelineLibraryCreateInfoKHR</a>::<code>pLibraries</code> was created with <code>VK_GRAPHICS_PIPELINE_LIBRARY_FRAGMENT_OUTPUT_INTERFACE_BIT_EXT</code>, the <code>pMultisampleState</code> used to create each library <strong class=\"purple\">must</strong> be <em>identically defined</em>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pLibraries-06636",
|
|
"text": " If one element of <a href=\"#VkPipelineLibraryCreateInfoKHR\">VkPipelineLibraryCreateInfoKHR</a>::<code>pLibraries</code> was created with <code>VK_GRAPHICS_PIPELINE_LIBRARY_FRAGMENT_OUTPUT_INTERFACE_BIT_EXT</code> and a value of <code>pMultisampleState->sampleShading</code> equal <code>VK_TRUE</code>, and if a different element of <a href=\"#VkPipelineLibraryCreateInfoKHR\">VkPipelineLibraryCreateInfoKHR</a>::<code>pLibraries</code> was created with <code>VK_GRAPHICS_PIPELINE_LIBRARY_FRAGMENT_SHADER_BIT_EXT</code>, the <code>pMultisampleState</code> used to create each library <strong class=\"purple\">must</strong> be <em>identically defined</em>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-flags-06637",
|
|
"text": " If <a href=\"#VkGraphicsPipelineLibraryCreateInfoEXT\">VkGraphicsPipelineLibraryCreateInfoEXT</a>::<code>flags</code> includes <code>VK_GRAPHICS_PIPELINE_LIBRARY_FRAGMENT_OUTPUT_INTERFACE_BIT_EXT</code>, <code>pMultisampleState->sampleShading</code> is <code>VK_TRUE</code>, and an element of <a href=\"#VkPipelineLibraryCreateInfoKHR\">VkPipelineLibraryCreateInfoKHR</a>::<code>pLibraries</code> was created with <code>VK_GRAPHICS_PIPELINE_LIBRARY_FRAGMENT_SHADER_BIT_EXT</code>, the <code>pMultisampleState</code> used to create that library <strong class=\"purple\">must</strong> be <em>identically defined</em> <code>pMultisampleState</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-flags-06640",
|
|
"text": " If <a href=\"#VkGraphicsPipelineLibraryCreateInfoEXT\">VkGraphicsPipelineLibraryCreateInfoEXT</a>::<code>flags</code> includes <code>VK_GRAPHICS_PIPELINE_LIBRARY_PRE_RASTERIZATION_SHADERS_BIT_EXT</code> or <code>VK_GRAPHICS_PIPELINE_LIBRARY_FRAGMENT_SHADER_BIT_EXT</code>, <code>pStages</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>stageCount</code> valid <a href=\"#VkPipelineShaderStageCreateInfo\">VkPipelineShaderStageCreateInfo</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-flags-06641",
|
|
"text": " If <a href=\"#VkGraphicsPipelineLibraryCreateInfoEXT\">VkGraphicsPipelineLibraryCreateInfoEXT</a>::<code>flags</code> includes <code>VK_GRAPHICS_PIPELINE_LIBRARY_PRE_RASTERIZATION_SHADERS_BIT_EXT</code>, <code>pRasterizationState</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkPipelineRasterizationStateCreateInfo\">VkPipelineRasterizationStateCreateInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-flags-06642",
|
|
"text": " If <a href=\"#VkGraphicsPipelineLibraryCreateInfoEXT\">VkGraphicsPipelineLibraryCreateInfoEXT</a>::<code>flags</code> includes <code>VK_GRAPHICS_PIPELINE_LIBRARY_PRE_RASTERIZATION_SHADERS_BIT_EXT</code> or <code>VK_GRAPHICS_PIPELINE_LIBRARY_FRAGMENT_SHADER_BIT_EXT</code>, <code>layout</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPipelineLayout\">VkPipelineLayout</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-flags-06643",
|
|
"text": " If <a href=\"#VkGraphicsPipelineLibraryCreateInfoEXT\">VkGraphicsPipelineLibraryCreateInfoEXT</a>::<code>flags</code> includes <code>VK_GRAPHICS_PIPELINE_LIBRARY_PRE_RASTERIZATION_SHADERS_BIT_EXT</code>, or <code>VK_GRAPHICS_PIPELINE_LIBRARY_FRAGMENT_SHADER_BIT_EXT</code>, <code>VK_GRAPHICS_PIPELINE_LIBRARY_FRAGMENT_OUTPUT_INTERFACE_BIT_EXT</code>, and <code>renderPass</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>renderPass</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkRenderPass\">VkRenderPass</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-flags-06644",
|
|
"text": " If <a href=\"#VkGraphicsPipelineLibraryCreateInfoEXT\">VkGraphicsPipelineLibraryCreateInfoEXT</a>::<code>flags</code> includes <code>VK_GRAPHICS_PIPELINE_LIBRARY_PRE_RASTERIZATION_SHADERS_BIT_EXT</code> or <code>VK_GRAPHICS_PIPELINE_LIBRARY_FRAGMENT_SHADER_BIT_EXT</code>, <code>stageCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-flags-06729",
|
|
"text": " If <code>flags</code> includes <code>VK_PIPELINE_CREATE_LINK_TIME_OPTIMIZATION_BIT_EXT</code>, the pipeline includes a <a href=\"#pipelines-graphics-subsets-complete\">complete set of state</a> specified entirely by libraries, and each library was created with a <a href=\"#VkPipelineLayout\">VkPipelineLayout</a> created with <code>VK_PIPELINE_LAYOUT_CREATE_INDEPENDENT_SETS_BIT_EXT</code>, then <code>layout</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPipelineLayout\">VkPipelineLayout</a> that is <a href=\"#descriptorsets-compatibility\">compatible</a> with the union of the libraries' pipeline layouts other than the inclusion/exclusion of <code>VK_PIPELINE_LAYOUT_CREATE_INDEPENDENT_SETS_BIT_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-flags-06730",
|
|
"text": " If <code>flags</code> does not include <code>VK_PIPELINE_CREATE_LINK_TIME_OPTIMIZATION_BIT_EXT</code>, the pipeline includes a <a href=\"#pipelines-graphics-subsets-complete\">complete set of state</a> specified entirely by libraries, and each library was created with a <a href=\"#VkPipelineLayout\">VkPipelineLayout</a> created with <code>VK_PIPELINE_LAYOUT_CREATE_INDEPENDENT_SETS_BIT_EXT</code>, then <code>layout</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPipelineLayout\">VkPipelineLayout</a> that is <a href=\"#descriptorsets-compatibility\">compatible</a> with the union of the libraries' pipeline layouts"
|
|
}
|
|
],
|
|
"(VK_EXT_graphics_pipeline_library)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-renderpass-06625",
|
|
"text": " If <code>renderpass</code> is <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <a href=\"#VkGraphicsPipelineLibraryCreateInfoEXT\">VkGraphicsPipelineLibraryCreateInfoEXT</a>::<code>flags</code> includes at least one of and no more than two of <code>VK_GRAPHICS_PIPELINE_LIBRARY_PRE_RASTERIZATION_SHADERS_BIT_EXT</code>, <code>VK_GRAPHICS_PIPELINE_LIBRARY_FRAGMENT_SHADER_BIT_EXT</code>, or <code>VK_GRAPHICS_PIPELINE_LIBRARY_FRAGMENT_OUTPUT_INTERFACE_BIT_EXT</code>, and an element of <a href=\"#VkPipelineLibraryCreateInfoKHR\">VkPipelineLibraryCreateInfoKHR</a>::<code>pLibraries</code> includes one of the other flags, the value of <code>renderPass</code> used to create that library <strong class=\"purple\">must</strong> also be <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-flags-06626",
|
|
"text": " If <a href=\"#VkGraphicsPipelineLibraryCreateInfoEXT\">VkGraphicsPipelineLibraryCreateInfoEXT</a>::<code>flags</code> includes at least one of and no more than two of <code>VK_GRAPHICS_PIPELINE_LIBRARY_PRE_RASTERIZATION_SHADERS_BIT_EXT</code>, <code>VK_GRAPHICS_PIPELINE_LIBRARY_FRAGMENT_SHADER_BIT_EXT</code>, or <code>VK_GRAPHICS_PIPELINE_LIBRARY_FRAGMENT_OUTPUT_INTERFACE_BIT_EXT</code>, an element of <a href=\"#VkPipelineLibraryCreateInfoKHR\">VkPipelineLibraryCreateInfoKHR</a>::<code>pLibraries</code> includes one of the other flags, and <code>renderPass</code> is <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>viewMask</code> used by this pipeline and that specified by the library <strong class=\"purple\">must</strong> be identical"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pLibraries-06627",
|
|
"text": " If one element of <a href=\"#VkPipelineLibraryCreateInfoKHR\">VkPipelineLibraryCreateInfoKHR</a>::<code>pLibraries</code> includes at least one of and no more than two of <code>VK_GRAPHICS_PIPELINE_LIBRARY_PRE_RASTERIZATION_SHADERS_BIT_EXT</code>, <code>VK_GRAPHICS_PIPELINE_LIBRARY_FRAGMENT_SHADER_BIT_EXT</code>, or <code>VK_GRAPHICS_PIPELINE_LIBRARY_FRAGMENT_OUTPUT_INTERFACE_BIT_EXT</code>, another element of <a href=\"#VkPipelineLibraryCreateInfoKHR\">VkPipelineLibraryCreateInfoKHR</a>::<code>pLibraries</code> includes one of the other flags, and <code>renderPass</code> was <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> for both libraries, the value of <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>viewMask</code> set by each library <strong class=\"purple\">must</strong> be identical"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-renderpass-06631",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-fragment-shader\">fragment shader state</a> and <code>renderpass</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, then <code>pMultisampleState</code> <strong class=\"purple\">must</strong> not be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-Input-06632",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-fragment-shader\">fragment shader state</a> with a fragment shader that either enables <a href=\"#primsrast-sampleshading\">sample shading</a> or decorates any variable in the <code>Input</code> storage class with <code>Sample</code>, then <code>pMultisampleState</code> <strong class=\"purple\">must</strong> not be <code>NULL</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_graphics_pipeline_library)+!(VK_VERSION_1_3,VK_KHR_dynamic_rendering)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pMultisampleState-06630",
|
|
"text": " If the pipeline is being created with <a href=\"#pipeline-graphics-subsets-fragment-shader\">fragment shader state</a> <code>pMultisampleState</code> <strong class=\"purple\">must</strong> not be <code>NULL</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_graphics_pipeline_library)+(VK_KHR_fragment_shading_rate)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-flags-06638",
|
|
"text": " If <a href=\"#VkGraphicsPipelineLibraryCreateInfoEXT\">VkGraphicsPipelineLibraryCreateInfoEXT</a>::<code>flags</code> includes only one of <code>VK_GRAPHICS_PIPELINE_LIBRARY_PRE_RASTERIZATION_SHADERS_BIT_EXT</code> or <code>VK_GRAPHICS_PIPELINE_LIBRARY_FRAGMENT_SHADER_BIT_EXT</code>, and an element of <a href=\"#VkPipelineLibraryCreateInfoKHR\">VkPipelineLibraryCreateInfoKHR</a>::<code>pLibraries</code> includes the other flag, values specified in <a href=\"#VkPipelineFragmentShadingRateStateCreateInfoKHR\">VkPipelineFragmentShadingRateStateCreateInfoKHR</a> for both this pipeline and that library <strong class=\"purple\">must</strong> be identical"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pLibraries-06639",
|
|
"text": " If one element of <a href=\"#VkPipelineLibraryCreateInfoKHR\">VkPipelineLibraryCreateInfoKHR</a>::<code>pLibraries</code> includes <code>VK_GRAPHICS_PIPELINE_LIBRARY_PRE_RASTERIZATION_SHADERS_BIT_EXT</code> and another element includes <code>VK_GRAPHICS_PIPELINE_LIBRARY_FRAGMENT_SHADER_BIT_EXT</code>, values specified in <a href=\"#VkPipelineFragmentShadingRateStateCreateInfoKHR\">VkPipelineFragmentShadingRateStateCreateInfoKHR</a> for both this pipeline and that library <strong class=\"purple\">must</strong> be identical"
|
|
}
|
|
],
|
|
"(VK_EXT_graphics_pipeline_library)+(VK_KHR_pipeline_executable_properties)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-flags-06645",
|
|
"text": " If <a href=\"#VkGraphicsPipelineLibraryCreateInfoEXT\">VkGraphicsPipelineLibraryCreateInfoEXT</a>::<code>flags</code> is non-zero, if <code>flags</code> includes <code>VK_PIPELINE_CREATE_CAPTURE_INTERNAL_REPRESENTATIONS_BIT_KHR</code>, any libraries <strong class=\"purple\">must</strong> have also been created with <code>VK_PIPELINE_CREATE_CAPTURE_INTERNAL_REPRESENTATIONS_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pLibraries-06646",
|
|
"text": " If <a href=\"#VkPipelineLibraryCreateInfoKHR\">VkPipelineLibraryCreateInfoKHR</a>::<code>pLibraries</code> includes more than one library, and any library was created with <code>VK_PIPELINE_CREATE_CAPTURE_INTERNAL_REPRESENTATIONS_BIT_KHR</code>, all libraries <strong class=\"purple\">must</strong> have also been created with <code>VK_PIPELINE_CREATE_CAPTURE_INTERNAL_REPRESENTATIONS_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-pLibraries-06647",
|
|
"text": " If <a href=\"#VkPipelineLibraryCreateInfoKHR\">VkPipelineLibraryCreateInfoKHR</a>::<code>pLibraries</code> includes at least one library, <a href=\"#VkGraphicsPipelineLibraryCreateInfoEXT\">VkGraphicsPipelineLibraryCreateInfoEXT</a>::<code>flags</code> is non-zero, and any library was created with <code>VK_PIPELINE_CREATE_CAPTURE_INTERNAL_REPRESENTATIONS_BIT_KHR</code>, <code>flags</code> <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_CREATE_CAPTURE_INTERNAL_REPRESENTATIONS_BIT_KHR</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_graphics_pipeline_library)+(VK_NV_device_generated_commands)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-libraryCount-06648",
|
|
"text": " If the pipeline is not created with a <a href=\"#pipelines-graphics-subsets-complete\">complete set of state</a>, or <a href=\"#VkPipelineLibraryCreateInfoKHR\">VkPipelineLibraryCreateInfoKHR</a>::<code>libraryCount</code> is not <code>0</code>, <a href=\"#VkGraphicsPipelineShaderGroupsCreateInfoNV\">VkGraphicsPipelineShaderGroupsCreateInfoNV</a>::<code>groupCount</code> and <a href=\"#VkGraphicsPipelineShaderGroupsCreateInfoNV\">VkGraphicsPipelineShaderGroupsCreateInfoNV</a>::<code>pipelineCount</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-libraryCount-06649",
|
|
"text": " If the pipeline is created with a <a href=\"#pipelines-graphics-subsets-complete\">complete set of state</a>, <a href=\"#VkPipelineLibraryCreateInfoKHR\">VkPipelineLibraryCreateInfoKHR</a>::<code>libraryCount</code> is <code>0</code>, and the <code>pNext</code> chain includes an instance of <a href=\"#VkGraphicsPipelineShaderGroupsCreateInfoNV\">VkGraphicsPipelineShaderGroupsCreateInfoNV</a>, <a href=\"#VkGraphicsPipelineShaderGroupsCreateInfoNV\">VkGraphicsPipelineShaderGroupsCreateInfoNV</a>::<code>groupCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_conservative_rasterization)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-conservativePointAndLineRasterization-06759",
|
|
"text": " If <a href=\"#limits-conservativePointAndLineRasterization\"><code>conservativePointAndLineRasterization</code></a> is not supported; the pipeline is being created with <a href=\"#pipeline-graphics-subsets-vertex-input\">vertex input state</a> and <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a>; the pipeline does not include a geometry shader; and the value of <a href=\"#VkPipelineInputAssemblyStateCreateInfo\">VkPipelineInputAssemblyStateCreateInfo</a>::<code>topology</code> is <code>VK_PRIMITIVE_TOPOLOGY_POINT_LIST</code>, <code>VK_PRIMITIVE_TOPOLOGY_LINE_LIST</code>, or <code>VK_PRIMITIVE_TOPOLOGY_LINE_STRIP</code>, then <a href=\"#VkPipelineRasterizationConservativeStateCreateInfoEXT\">VkPipelineRasterizationConservativeStateCreateInfoEXT</a>::<code>conservativeRasterizationMode</code> <strong class=\"purple\">must</strong> be <code>VK_CONSERVATIVE_RASTERIZATION_MODE_DISABLED_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-conservativePointAndLineRasterization-06760",
|
|
"text": " If <a href=\"#limits-conservativePointAndLineRasterization\"><code>conservativePointAndLineRasterization</code></a> is not supported, the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a>, and the pipeline includes a geometry shader with either the <code>OutputPoints</code> or <code>OutputLineStrip</code> execution modes, <a href=\"#VkPipelineRasterizationConservativeStateCreateInfoEXT\">VkPipelineRasterizationConservativeStateCreateInfoEXT</a>::<code>conservativeRasterizationMode</code> <strong class=\"purple\">must</strong> be <code>VK_CONSERVATIVE_RASTERIZATION_MODE_DISABLED_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_conservative_rasterization)+(VK_NV_mesh_shader)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineCreateInfo-conservativePointAndLineRasterization-06761",
|
|
"text": " If <a href=\"#limits-conservativePointAndLineRasterization\"><code>conservativePointAndLineRasterization</code></a> is not supported, the pipeline is being created with <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader state</a>, and the pipeline includes a mesh shader with either the <code>OutputPoints</code> or <code>OutputLinesNV</code> execution modes, <a href=\"#VkPipelineRasterizationConservativeStateCreateInfoEXT\">VkPipelineRasterizationConservativeStateCreateInfoEXT</a>::<code>conservativeRasterizationMode</code> <strong class=\"purple\">must</strong> be <code>VK_CONSERVATIVE_RASTERIZATION_MODE_DISABLED_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPipelineRenderingCreateInfo": {
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineRenderingCreateInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PIPELINE_RENDERING_CREATE_INFO</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkGraphicsPipelineLibraryCreateInfoEXT": {
|
|
"(VK_EXT_graphics_pipeline_library)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineLibraryCreateInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_GRAPHICS_PIPELINE_LIBRARY_CREATE_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineLibraryCreateInfoEXT-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkGraphicsPipelineLibraryFlagBitsEXT\">VkGraphicsPipelineLibraryFlagBitsEXT</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineLibraryCreateInfoEXT-flags-requiredbitmask",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPipelineDynamicStateCreateInfo": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkPipelineDynamicStateCreateInfo-pDynamicStates-01442",
|
|
"text": " Each element of <code>pDynamicStates</code> <strong class=\"purple\">must</strong> be unique"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineDynamicStateCreateInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PIPELINE_DYNAMIC_STATE_CREATE_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineDynamicStateCreateInfo-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineDynamicStateCreateInfo-flags-zerobitmask",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineDynamicStateCreateInfo-pDynamicStates-parameter",
|
|
"text": " If <code>dynamicStateCount</code> is not <code>0</code>, <code>pDynamicStates</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>dynamicStateCount</code> valid <a href=\"#VkDynamicState\">VkDynamicState</a> values"
|
|
}
|
|
]
|
|
},
|
|
"VkGraphicsPipelineShaderGroupsCreateInfoNV": {
|
|
"(VK_NV_device_generated_commands)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineShaderGroupsCreateInfoNV-groupCount-02879",
|
|
"text": " <code>groupCount</code> <strong class=\"purple\">must</strong> be at least <code>1</code> and as maximum <code>VkPhysicalDeviceDeviceGeneratedCommandsPropertiesNV</code>::<code>maxGraphicsShaderGroupCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineShaderGroupsCreateInfoNV-groupCount-02880",
|
|
"text": " The sum of <code>groupCount</code> including those groups added from referenced <code>pPipelines</code> <strong class=\"purple\">must</strong> also be as maximum <code>VkPhysicalDeviceDeviceGeneratedCommandsPropertiesNV</code>::<code>maxGraphicsShaderGroupCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineShaderGroupsCreateInfoNV-pGroups-02881",
|
|
"text": " The state of the first element of <code>pGroups</code> <strong class=\"purple\">must</strong> match its equivalent within the parent’s <a href=\"#VkGraphicsPipelineCreateInfo\">VkGraphicsPipelineCreateInfo</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineShaderGroupsCreateInfoNV-pGroups-02882",
|
|
"text": " Each element of <code>pGroups</code> <strong class=\"purple\">must</strong> in combination with the rest of the pipeline state yield a valid state configuration"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineShaderGroupsCreateInfoNV-pPipelines-02886",
|
|
"text": " Each element of <code>pPipelines</code> <strong class=\"purple\">must</strong> have been created with identical state to the pipeline currently created except the state that can be overridden by <a href=\"#VkGraphicsShaderGroupCreateInfoNV\">VkGraphicsShaderGroupCreateInfoNV</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineShaderGroupsCreateInfoNV-deviceGeneratedCommands-02887",
|
|
"text": " The <a href=\"#features-deviceGeneratedCommands\"><code>deviceGeneratedCommands</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineShaderGroupsCreateInfoNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_GRAPHICS_PIPELINE_SHADER_GROUPS_CREATE_INFO_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineShaderGroupsCreateInfoNV-pGroups-parameter",
|
|
"text": " If <code>groupCount</code> is not <code>0</code>, <code>pGroups</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>groupCount</code> valid <a href=\"#VkGraphicsShaderGroupCreateInfoNV\">VkGraphicsShaderGroupCreateInfoNV</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineShaderGroupsCreateInfoNV-pPipelines-parameter",
|
|
"text": " If <code>pipelineCount</code> is not <code>0</code>, <code>pPipelines</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>pipelineCount</code> valid <a href=\"#VkPipeline\">VkPipeline</a> handles"
|
|
}
|
|
],
|
|
"(VK_NV_device_generated_commands)+!(VK_NV_mesh_shader)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineShaderGroupsCreateInfoNV-pGroups-02883",
|
|
"text": " All elements of <code>pGroups</code> <strong class=\"purple\">must</strong> use the same shader stage combinations"
|
|
}
|
|
],
|
|
"(VK_NV_device_generated_commands)+(VK_NV_mesh_shader)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineShaderGroupsCreateInfoNV-pGroups-02884",
|
|
"text": " All elements of <code>pGroups</code> <strong class=\"purple\">must</strong> use the same shader stage combinations unless any mesh shader stage is used, then either combination of task and mesh or just mesh shader is valid"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsPipelineShaderGroupsCreateInfoNV-pGroups-02885",
|
|
"text": " Mesh and regular primitive shading stages cannot be mixed across <code>pGroups</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkGraphicsShaderGroupCreateInfoNV": {
|
|
"(VK_NV_device_generated_commands)": [
|
|
{
|
|
"vuid": "VUID-VkGraphicsShaderGroupCreateInfoNV-stageCount-02888",
|
|
"text": " For <code>stageCount</code>, the same restrictions as in <a href=\"#VkGraphicsPipelineCreateInfo\">VkGraphicsPipelineCreateInfo</a>::<code>stageCount</code> apply"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsShaderGroupCreateInfoNV-pStages-02889",
|
|
"text": " For <code>pStages</code>, the same restrictions as in <a href=\"#VkGraphicsPipelineCreateInfo\">VkGraphicsPipelineCreateInfo</a>::<code>pStages</code> apply"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsShaderGroupCreateInfoNV-pVertexInputState-02890",
|
|
"text": " For <code>pVertexInputState</code>, the same restrictions as in <a href=\"#VkGraphicsPipelineCreateInfo\">VkGraphicsPipelineCreateInfo</a>::<code>pVertexInputState</code> apply"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsShaderGroupCreateInfoNV-pTessellationState-02891",
|
|
"text": " For <code>pTessellationState</code>, the same restrictions as in <a href=\"#VkGraphicsPipelineCreateInfo\">VkGraphicsPipelineCreateInfo</a>::<code>pTessellationState</code> apply"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsShaderGroupCreateInfoNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_GRAPHICS_SHADER_GROUP_CREATE_INFO_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsShaderGroupCreateInfoNV-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsShaderGroupCreateInfoNV-pStages-parameter",
|
|
"text": " <code>pStages</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>stageCount</code> valid <a href=\"#VkPipelineShaderStageCreateInfo\">VkPipelineShaderStageCreateInfo</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGraphicsShaderGroupCreateInfoNV-stageCount-arraylength",
|
|
"text": " <code>stageCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCreateRayTracingPipelinesNV": {
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_NV_ray_tracing)": [
|
|
{
|
|
"vuid": "VUID-vkCreateRayTracingPipelinesNV-flags-03415",
|
|
"text": " If the <code>flags</code> member of any element of <code>pCreateInfos</code> contains the <code>VK_PIPELINE_CREATE_DERIVATIVE_BIT</code> flag, and the <code>basePipelineIndex</code> member of that same element is not <code>-1</code>, <code>basePipelineIndex</code> <strong class=\"purple\">must</strong> be less than the index into <code>pCreateInfos</code> that corresponds to that element"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateRayTracingPipelinesNV-flags-03416",
|
|
"text": " If the <code>flags</code> member of any element of <code>pCreateInfos</code> contains the <code>VK_PIPELINE_CREATE_DERIVATIVE_BIT</code> flag, the base pipeline <strong class=\"purple\">must</strong> have been created with the <code>VK_PIPELINE_CREATE_ALLOW_DERIVATIVES_BIT</code> flag set"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateRayTracingPipelinesNV-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateRayTracingPipelinesNV-pipelineCache-parameter",
|
|
"text": " If <code>pipelineCache</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>pipelineCache</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPipelineCache\">VkPipelineCache</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateRayTracingPipelinesNV-pCreateInfos-parameter",
|
|
"text": " <code>pCreateInfos</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>createInfoCount</code> valid <a href=\"#VkRayTracingPipelineCreateInfoNV\">VkRayTracingPipelineCreateInfoNV</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateRayTracingPipelinesNV-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateRayTracingPipelinesNV-pPipelines-parameter",
|
|
"text": " <code>pPipelines</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>createInfoCount</code> <a href=\"#VkPipeline\">VkPipeline</a> handles"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateRayTracingPipelinesNV-createInfoCount-arraylength",
|
|
"text": " <code>createInfoCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateRayTracingPipelinesNV-pipelineCache-parent",
|
|
"text": " If <code>pipelineCache</code> is a valid handle, it <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_NV_ray_tracing)+(VK_VERSION_1_1,VK_KHR_device_group)": [
|
|
{
|
|
"vuid": "VUID-vkCreateRayTracingPipelinesNV-flags-03816",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> not contain the <code>VK_PIPELINE_CREATE_DISPATCH_BASE</code> flag"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_NV_ray_tracing)+(VK_VERSION_1_3,VK_EXT_pipeline_creation_cache_control)": [
|
|
{
|
|
"vuid": "VUID-vkCreateRayTracingPipelinesNV-pipelineCache-02903",
|
|
"text": " If <code>pipelineCache</code> was created with <code>VK_PIPELINE_CACHE_CREATE_EXTERNALLY_SYNCHRONIZED_BIT</code>, host access to <code>pipelineCache</code> <strong class=\"purple\">must</strong> be <a href=\"#fundamentals-threadingbehavior\">externally synchronized</a>"
|
|
}
|
|
]
|
|
},
|
|
"vkCreateRayTracingPipelinesKHR": {
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)": [
|
|
{
|
|
"vuid": "VUID-vkCreateRayTracingPipelinesKHR-flags-03415",
|
|
"text": " If the <code>flags</code> member of any element of <code>pCreateInfos</code> contains the <code>VK_PIPELINE_CREATE_DERIVATIVE_BIT</code> flag, and the <code>basePipelineIndex</code> member of that same element is not <code>-1</code>, <code>basePipelineIndex</code> <strong class=\"purple\">must</strong> be less than the index into <code>pCreateInfos</code> that corresponds to that element"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateRayTracingPipelinesKHR-flags-03416",
|
|
"text": " If the <code>flags</code> member of any element of <code>pCreateInfos</code> contains the <code>VK_PIPELINE_CREATE_DERIVATIVE_BIT</code> flag, the base pipeline <strong class=\"purple\">must</strong> have been created with the <code>VK_PIPELINE_CREATE_ALLOW_DERIVATIVES_BIT</code> flag set"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateRayTracingPipelinesKHR-deferredOperation-03677",
|
|
"text": " If <code>deferredOperation</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, it <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDeferredOperationKHR\">VkDeferredOperationKHR</a> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateRayTracingPipelinesKHR-deferredOperation-03678",
|
|
"text": " Any previous deferred operation that was associated with <code>deferredOperation</code> <strong class=\"purple\">must</strong> be complete"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateRayTracingPipelinesKHR-rayTracingPipeline-03586",
|
|
"text": " The <a href=\"#features-rayTracingPipeline\"><code>rayTracingPipeline</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateRayTracingPipelinesKHR-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateRayTracingPipelinesKHR-deferredOperation-parameter",
|
|
"text": " If <code>deferredOperation</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>deferredOperation</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDeferredOperationKHR\">VkDeferredOperationKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateRayTracingPipelinesKHR-pipelineCache-parameter",
|
|
"text": " If <code>pipelineCache</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>pipelineCache</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPipelineCache\">VkPipelineCache</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateRayTracingPipelinesKHR-pCreateInfos-parameter",
|
|
"text": " <code>pCreateInfos</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>createInfoCount</code> valid <a href=\"#VkRayTracingPipelineCreateInfoKHR\">VkRayTracingPipelineCreateInfoKHR</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateRayTracingPipelinesKHR-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateRayTracingPipelinesKHR-pPipelines-parameter",
|
|
"text": " <code>pPipelines</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>createInfoCount</code> <a href=\"#VkPipeline\">VkPipeline</a> handles"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateRayTracingPipelinesKHR-createInfoCount-arraylength",
|
|
"text": " <code>createInfoCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateRayTracingPipelinesKHR-deferredOperation-parent",
|
|
"text": " If <code>deferredOperation</code> is a valid handle, it <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateRayTracingPipelinesKHR-pipelineCache-parent",
|
|
"text": " If <code>pipelineCache</code> is a valid handle, it <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)+(VK_VERSION_1_1,VK_KHR_device_group)": [
|
|
{
|
|
"vuid": "VUID-vkCreateRayTracingPipelinesKHR-flags-03816",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> not contain the <code>VK_PIPELINE_CREATE_DISPATCH_BASE</code> flag"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)+(VK_VERSION_1_3,VK_EXT_pipeline_creation_cache_control)": [
|
|
{
|
|
"vuid": "VUID-vkCreateRayTracingPipelinesKHR-pipelineCache-02903",
|
|
"text": " If <code>pipelineCache</code> was created with <code>VK_PIPELINE_CACHE_CREATE_EXTERNALLY_SYNCHRONIZED_BIT</code>, host access to <code>pipelineCache</code> <strong class=\"purple\">must</strong> be <a href=\"#fundamentals-threadingbehavior\">externally synchronized</a>"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)+(VK_VERSION_1_3,VK_EXT_pipeline_creation_cache_control)+(VK_KHR_deferred_host_operations)": [
|
|
{
|
|
"vuid": "VUID-vkCreateRayTracingPipelinesKHR-deferredOperation-03587",
|
|
"text": " If <code>deferredOperation</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the <code>flags</code> member of elements of <code>pCreateInfos</code> <strong class=\"purple\">must</strong> not include <code>VK_PIPELINE_CREATE_EARLY_RETURN_ON_FAILURE_BIT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkRayTracingPipelineCreateInfoNV": {
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_NV_ray_tracing)": [
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoNV-flags-03421",
|
|
"text": " If <code>flags</code> contains the <code>VK_PIPELINE_CREATE_DERIVATIVE_BIT</code> flag, and <code>basePipelineIndex</code> is <code>-1</code>, <code>basePipelineHandle</code> <strong class=\"purple\">must</strong> be a valid handle to a ray tracing <code>VkPipeline</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoNV-flags-03422",
|
|
"text": " If <code>flags</code> contains the <code>VK_PIPELINE_CREATE_DERIVATIVE_BIT</code> flag, and <code>basePipelineHandle</code> is <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>basePipelineIndex</code> <strong class=\"purple\">must</strong> be a valid index into the calling command’s <code>pCreateInfos</code> parameter"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoNV-flags-03423",
|
|
"text": " If <code>flags</code> contains the <code>VK_PIPELINE_CREATE_DERIVATIVE_BIT</code> flag, and <code>basePipelineIndex</code> is not <code>-1</code>, <code>basePipelineHandle</code> <strong class=\"purple\">must</strong> be <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoNV-flags-03424",
|
|
"text": " If <code>flags</code> contains the <code>VK_PIPELINE_CREATE_DERIVATIVE_BIT</code> flag, and <code>basePipelineHandle</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>basePipelineIndex</code> <strong class=\"purple\">must</strong> be <code>-1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoNV-pStages-03426",
|
|
"text": " The shader code for the entry points identified by <code>pStages</code>, and the rest of the state identified by this structure <strong class=\"purple\">must</strong> adhere to the pipeline linking rules described in the <a href=\"#interfaces\">Shader Interfaces</a> chapter"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoNV-layout-03427",
|
|
"text": " <code>layout</code> <strong class=\"purple\">must</strong> be <a href=\"#descriptorsets-pipelinelayout-consistency\">consistent</a> with all shaders specified in <code>pStages</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoNV-layout-03428",
|
|
"text": " The number of resources in <code>layout</code> accessible to each shader stage that is used by the pipeline <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#VkPhysicalDeviceLimits\">VkPhysicalDeviceLimits</a>::<code>maxPerStageResources</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoNV-stage-06232",
|
|
"text": " The <code>stage</code> member of at least one element of <code>pStages</code> <strong class=\"purple\">must</strong> be <code>VK_SHADER_STAGE_RAYGEN_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoNV-maxRecursionDepth-03457",
|
|
"text": " <code>maxRecursionDepth</code> <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#VkPhysicalDeviceRayTracingPropertiesNV\">VkPhysicalDeviceRayTracingPropertiesNV</a>::<code>maxRecursionDepth</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoNV-stage-06898",
|
|
"text": " The <code>stage</code> value in all <code>pStages</code> elements <strong class=\"purple\">must</strong> be one of <code>VK_SHADER_STAGE_RAYGEN_BIT_KHR</code>, <code>VK_SHADER_STAGE_ANY_HIT_BIT_KHR</code>, <code>VK_SHADER_STAGE_CLOSEST_HIT_BIT_KHR</code>, <code>VK_SHADER_STAGE_MISS_BIT_KHR</code>, <code>VK_SHADER_STAGE_INTERSECTION_BIT_KHR</code>, or <code>VK_SHADER_STAGE_CALLABLE_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_RAY_TRACING_PIPELINE_CREATE_INFO_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoNV-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkPipelineCreationFeedbackCreateInfo\">VkPipelineCreationFeedbackCreateInfo</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoNV-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoNV-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkPipelineCreateFlagBits\">VkPipelineCreateFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoNV-pStages-parameter",
|
|
"text": " <code>pStages</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>stageCount</code> valid <a href=\"#VkPipelineShaderStageCreateInfo\">VkPipelineShaderStageCreateInfo</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoNV-pGroups-parameter",
|
|
"text": " <code>pGroups</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>groupCount</code> valid <a href=\"#VkRayTracingShaderGroupCreateInfoNV\">VkRayTracingShaderGroupCreateInfoNV</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoNV-layout-parameter",
|
|
"text": " <code>layout</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPipelineLayout\">VkPipelineLayout</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoNV-stageCount-arraylength",
|
|
"text": " <code>stageCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoNV-groupCount-arraylength",
|
|
"text": " <code>groupCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoNV-commonparent",
|
|
"text": " Both of <code>basePipelineHandle</code>, and <code>layout</code> that are valid handles of non-ignored parameters <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_NV_ray_tracing)+(VK_NV_device_generated_commands)": [
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoNV-flags-02904",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> not include <code>VK_PIPELINE_CREATE_INDIRECT_BINDABLE_BIT_NV</code>"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_NV_ray_tracing)+(VK_VERSION_1_3,VK_EXT_pipeline_creation_cache_control)": [
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoNV-pipelineCreationCacheControl-02905",
|
|
"text": " If the <a href=\"#features-pipelineCreationCacheControl\"><code>pipelineCreationCacheControl</code></a> feature is not enabled, <code>flags</code> <strong class=\"purple\">must</strong> not include <code>VK_PIPELINE_CREATE_FAIL_ON_PIPELINE_COMPILE_REQUIRED_BIT</code> or <code>VK_PIPELINE_CREATE_EARLY_RETURN_ON_FAILURE_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoNV-flags-02957",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> not include both <code>VK_PIPELINE_CREATE_DEFER_COMPILE_BIT_NV</code> and <code>VK_PIPELINE_CREATE_FAIL_ON_PIPELINE_COMPILE_REQUIRED_BIT</code> at the same time"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_NV_ray_tracing)+(VK_KHR_pipeline_library)": [
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoNV-flags-03456",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> not include <code>VK_PIPELINE_CREATE_LIBRARY_BIT_KHR</code>"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_NV_ray_tracing)+(VK_KHR_ray_tracing_pipeline)": [
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoNV-flags-03458",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> not include <code>VK_PIPELINE_CREATE_RAY_TRACING_NO_NULL_ANY_HIT_SHADERS_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoNV-flags-03459",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> not include <code>VK_PIPELINE_CREATE_RAY_TRACING_NO_NULL_CLOSEST_HIT_SHADERS_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoNV-flags-03460",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> not include <code>VK_PIPELINE_CREATE_RAY_TRACING_NO_NULL_MISS_SHADERS_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoNV-flags-03461",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> not include <code>VK_PIPELINE_CREATE_RAY_TRACING_NO_NULL_INTERSECTION_SHADERS_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoNV-flags-03462",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> not include <code>VK_PIPELINE_CREATE_RAY_TRACING_SKIP_AABBS_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoNV-flags-03463",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> not include <code>VK_PIPELINE_CREATE_RAY_TRACING_SKIP_TRIANGLES_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoNV-flags-03588",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> not include <code>VK_PIPELINE_CREATE_RAY_TRACING_SHADER_GROUP_HANDLE_CAPTURE_REPLAY_BIT_KHR</code>"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_NV_ray_tracing)+(VK_NV_ray_tracing_motion_blur)": [
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoNV-flags-04948",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> not include <code>VK_PIPELINE_CREATE_RAY_TRACING_ALLOW_MOTION_BIT_NV</code>"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_NV_ray_tracing)+(VK_EXT_pipeline_creation_feedback,VK_VERSION_1_3)": [
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoNV-pipelineStageCreationFeedbackCount-06651",
|
|
"text": " If <a href=\"#VkPipelineCreationFeedbackCreateInfo\">VkPipelineCreationFeedbackCreateInfo</a>::<code>pipelineStageCreationFeedbackCount</code> is not <code>0</code>, it <strong class=\"purple\">must</strong> be equal to <code>stageCount</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkRayTracingPipelineCreateInfoKHR": {
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)": [
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoKHR-flags-03421",
|
|
"text": " If <code>flags</code> contains the <code>VK_PIPELINE_CREATE_DERIVATIVE_BIT</code> flag, and <code>basePipelineIndex</code> is <code>-1</code>, <code>basePipelineHandle</code> <strong class=\"purple\">must</strong> be a valid handle to a ray tracing <code>VkPipeline</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoKHR-flags-03422",
|
|
"text": " If <code>flags</code> contains the <code>VK_PIPELINE_CREATE_DERIVATIVE_BIT</code> flag, and <code>basePipelineHandle</code> is <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>basePipelineIndex</code> <strong class=\"purple\">must</strong> be a valid index into the calling command’s <code>pCreateInfos</code> parameter"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoKHR-flags-03423",
|
|
"text": " If <code>flags</code> contains the <code>VK_PIPELINE_CREATE_DERIVATIVE_BIT</code> flag, and <code>basePipelineIndex</code> is not <code>-1</code>, <code>basePipelineHandle</code> <strong class=\"purple\">must</strong> be <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoKHR-flags-03424",
|
|
"text": " If <code>flags</code> contains the <code>VK_PIPELINE_CREATE_DERIVATIVE_BIT</code> flag, and <code>basePipelineHandle</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>basePipelineIndex</code> <strong class=\"purple\">must</strong> be <code>-1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoKHR-pStages-03426",
|
|
"text": " The shader code for the entry points identified by <code>pStages</code>, and the rest of the state identified by this structure <strong class=\"purple\">must</strong> adhere to the pipeline linking rules described in the <a href=\"#interfaces\">Shader Interfaces</a> chapter"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoKHR-layout-03427",
|
|
"text": " <code>layout</code> <strong class=\"purple\">must</strong> be <a href=\"#descriptorsets-pipelinelayout-consistency\">consistent</a> with all shaders specified in <code>pStages</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoKHR-layout-03428",
|
|
"text": " The number of resources in <code>layout</code> accessible to each shader stage that is used by the pipeline <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#VkPhysicalDeviceLimits\">VkPhysicalDeviceLimits</a>::<code>maxPerStageResources</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoKHR-stage-03425",
|
|
"text": " If <code>flags</code> does not include <code>VK_PIPELINE_CREATE_LIBRARY_BIT_KHR</code>, the <code>stage</code> member of at least one element of <code>pStages</code>, including those implicitly added by <code>pLibraryInfo</code>, <strong class=\"purple\">must</strong> be <code>VK_SHADER_STAGE_RAYGEN_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoKHR-maxPipelineRayRecursionDepth-03589",
|
|
"text": " <code>maxPipelineRayRecursionDepth</code> <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#VkPhysicalDeviceRayTracingPipelinePropertiesKHR\">VkPhysicalDeviceRayTracingPipelinePropertiesKHR</a>::<code>maxRayRecursionDepth</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoKHR-pLibraryInfo-03595",
|
|
"text": " If the <code><a href=\"#VK_KHR_pipeline_library\">VK_KHR_pipeline_library</a></code> extension is not enabled, <code>pLibraryInfo</code> and <code>pLibraryInterface</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoKHR-flags-03470",
|
|
"text": " If <code>flags</code> includes <code>VK_PIPELINE_CREATE_RAY_TRACING_NO_NULL_ANY_HIT_SHADERS_BIT_KHR</code>, for any element of <code>pGroups</code> with a <code>type</code> of <code>VK_RAY_TRACING_SHADER_GROUP_TYPE_TRIANGLES_HIT_GROUP_KHR</code> or <code>VK_RAY_TRACING_SHADER_GROUP_TYPE_PROCEDURAL_HIT_GROUP_KHR</code>, the <code>anyHitShader</code> of that element <strong class=\"purple\">must</strong> not be <code>VK_SHADER_UNUSED_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoKHR-flags-03471",
|
|
"text": " If <code>flags</code> includes <code>VK_PIPELINE_CREATE_RAY_TRACING_NO_NULL_CLOSEST_HIT_SHADERS_BIT_KHR</code>, for any element of <code>pGroups</code> with a <code>type</code> of <code>VK_RAY_TRACING_SHADER_GROUP_TYPE_TRIANGLES_HIT_GROUP_KHR</code> or <code>VK_RAY_TRACING_SHADER_GROUP_TYPE_PROCEDURAL_HIT_GROUP_KHR</code>, the <code>closestHitShader</code> of that element <strong class=\"purple\">must</strong> not be <code>VK_SHADER_UNUSED_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoKHR-rayTraversalPrimitiveCulling-03596",
|
|
"text": " If the <a href=\"#features-rayTraversalPrimitiveCulling\"><code>rayTraversalPrimitiveCulling</code></a> feature is not enabled, <code>flags</code> <strong class=\"purple\">must</strong> not include <code>VK_PIPELINE_CREATE_RAY_TRACING_SKIP_AABBS_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoKHR-rayTraversalPrimitiveCulling-03597",
|
|
"text": " If the <a href=\"#features-rayTraversalPrimitiveCulling\"><code>rayTraversalPrimitiveCulling</code></a> feature is not enabled, <code>flags</code> <strong class=\"purple\">must</strong> not include <code>VK_PIPELINE_CREATE_RAY_TRACING_SKIP_TRIANGLES_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoKHR-flags-06546",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> not include both <code>VK_PIPELINE_CREATE_RAY_TRACING_SKIP_TRIANGLES_BIT_KHR</code> and <code>VK_PIPELINE_CREATE_RAY_TRACING_SKIP_AABBS_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoKHR-flags-03598",
|
|
"text": " If <code>flags</code> includes <code>VK_PIPELINE_CREATE_RAY_TRACING_SHADER_GROUP_HANDLE_CAPTURE_REPLAY_BIT_KHR</code>, <a href=\"#features-rayTracingPipelineShaderGroupHandleCaptureReplay\"><code>rayTracingPipelineShaderGroupHandleCaptureReplay</code></a> <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoKHR-rayTracingPipelineShaderGroupHandleCaptureReplay-03599",
|
|
"text": " If <a href=\"#VkPhysicalDeviceRayTracingPipelineFeaturesKHR\">VkPhysicalDeviceRayTracingPipelineFeaturesKHR</a>::<code>rayTracingPipelineShaderGroupHandleCaptureReplay</code> is <code>VK_TRUE</code> and the <code>pShaderGroupCaptureReplayHandle</code> member of any element of <code>pGroups</code> is not <code>NULL</code>, <code>flags</code> <strong class=\"purple\">must</strong> include <code>VK_PIPELINE_CREATE_RAY_TRACING_SHADER_GROUP_HANDLE_CAPTURE_REPLAY_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoKHR-pLibraryInfo-03600",
|
|
"text": " If <code>pLibraryInfo</code> is not <code>NULL</code> and its <code>libraryCount</code> is <code>0</code>, <code>stageCount</code> <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoKHR-pLibraryInfo-03601",
|
|
"text": " If <code>pLibraryInfo</code> is not <code>NULL</code> and its <code>libraryCount</code> is <code>0</code>, <code>groupCount</code> <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoKHR-pDynamicStates-03602",
|
|
"text": " Any element of the <code>pDynamicStates</code> member of <code>pDynamicState</code> <strong class=\"purple\">must</strong> be <code>VK_DYNAMIC_STATE_RAY_TRACING_PIPELINE_STACK_SIZE_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoKHR-stage-06899",
|
|
"text": " The <code>stage</code> value in all <code>pStages</code> elements <strong class=\"purple\">must</strong> be one of <code>VK_SHADER_STAGE_RAYGEN_BIT_KHR</code>, <code>VK_SHADER_STAGE_ANY_HIT_BIT_KHR</code>, <code>VK_SHADER_STAGE_CLOSEST_HIT_BIT_KHR</code>, <code>VK_SHADER_STAGE_MISS_BIT_KHR</code>, <code>VK_SHADER_STAGE_INTERSECTION_BIT_KHR</code>, or <code>VK_SHADER_STAGE_CALLABLE_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_RAY_TRACING_PIPELINE_CREATE_INFO_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoKHR-pNext-pNext",
|
|
"text": " Each <code>pNext</code> member of any structure (including this one) in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be either <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkPipelineCreationFeedbackCreateInfo\">VkPipelineCreationFeedbackCreateInfo</a> or <a href=\"#VkPipelineRobustnessCreateInfoEXT\">VkPipelineRobustnessCreateInfoEXT</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoKHR-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoKHR-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkPipelineCreateFlagBits\">VkPipelineCreateFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoKHR-pStages-parameter",
|
|
"text": " If <code>stageCount</code> is not <code>0</code>, <code>pStages</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>stageCount</code> valid <a href=\"#VkPipelineShaderStageCreateInfo\">VkPipelineShaderStageCreateInfo</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoKHR-pGroups-parameter",
|
|
"text": " If <code>groupCount</code> is not <code>0</code>, <code>pGroups</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>groupCount</code> valid <a href=\"#VkRayTracingShaderGroupCreateInfoKHR\">VkRayTracingShaderGroupCreateInfoKHR</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoKHR-pLibraryInfo-parameter",
|
|
"text": " If <code>pLibraryInfo</code> is not <code>NULL</code>, <code>pLibraryInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkPipelineLibraryCreateInfoKHR\">VkPipelineLibraryCreateInfoKHR</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoKHR-pLibraryInterface-parameter",
|
|
"text": " If <code>pLibraryInterface</code> is not <code>NULL</code>, <code>pLibraryInterface</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkRayTracingPipelineInterfaceCreateInfoKHR\">VkRayTracingPipelineInterfaceCreateInfoKHR</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoKHR-pDynamicState-parameter",
|
|
"text": " If <code>pDynamicState</code> is not <code>NULL</code>, <code>pDynamicState</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkPipelineDynamicStateCreateInfo\">VkPipelineDynamicStateCreateInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoKHR-layout-parameter",
|
|
"text": " <code>layout</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPipelineLayout\">VkPipelineLayout</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoKHR-commonparent",
|
|
"text": " Both of <code>basePipelineHandle</code>, and <code>layout</code> that are valid handles of non-ignored parameters <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)+(VK_NV_device_generated_commands)": [
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoKHR-flags-02904",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> not include <code>VK_PIPELINE_CREATE_INDIRECT_BINDABLE_BIT_NV</code>"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)+(VK_VERSION_1_3,VK_EXT_pipeline_creation_cache_control)": [
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoKHR-pipelineCreationCacheControl-02905",
|
|
"text": " If the <a href=\"#features-pipelineCreationCacheControl\"><code>pipelineCreationCacheControl</code></a> feature is not enabled, <code>flags</code> <strong class=\"purple\">must</strong> not include <code>VK_PIPELINE_CREATE_FAIL_ON_PIPELINE_COMPILE_REQUIRED_BIT</code> or <code>VK_PIPELINE_CREATE_EARLY_RETURN_ON_FAILURE_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)+(VK_KHR_pipeline_library)": [
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoKHR-flags-03465",
|
|
"text": " If <code>flags</code> includes <code>VK_PIPELINE_CREATE_LIBRARY_BIT_KHR</code>, <code>pLibraryInterface</code> <strong class=\"purple\">must</strong> not be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoKHR-pLibraryInfo-03590",
|
|
"text": " If <code>pLibraryInfo</code> is not <code>NULL</code> and its <code>libraryCount</code> member is greater than <code>0</code>, its <code>pLibraryInterface</code> member <strong class=\"purple\">must</strong> not be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoKHR-pLibraries-03591",
|
|
"text": " Each element of <code>pLibraryInfo->pLibraries</code> <strong class=\"purple\">must</strong> have been created with the value of <code>maxPipelineRayRecursionDepth</code> equal to that in this pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoKHR-pLibraryInfo-03592",
|
|
"text": " If <code>pLibraryInfo</code> is not <code>NULL</code>, each element of its <code>pLibraries</code> member <strong class=\"purple\">must</strong> have been created with a <code>layout</code> that is compatible with the <code>layout</code> in this pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoKHR-pLibraryInfo-03593",
|
|
"text": " If <code>pLibraryInfo</code> is not <code>NULL</code>, each element of its <code>pLibraries</code> member <strong class=\"purple\">must</strong> have been created with values of the <code>maxPipelineRayPayloadSize</code> and <code>maxPipelineRayHitAttributeSize</code> members of <code>pLibraryInterface</code> equal to those in this pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoKHR-flags-03594",
|
|
"text": " If <code>flags</code> includes <code>VK_PIPELINE_CREATE_RAY_TRACING_SHADER_GROUP_HANDLE_CAPTURE_REPLAY_BIT_KHR</code>, each element of <code>pLibraryInfo->pLibraries</code> <strong class=\"purple\">must</strong> have been created with the <code>VK_PIPELINE_CREATE_RAY_TRACING_SHADER_GROUP_HANDLE_CAPTURE_REPLAY_BIT_KHR</code> bit set"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoKHR-flags-04718",
|
|
"text": " If <code>flags</code> includes <code>VK_PIPELINE_CREATE_RAY_TRACING_SKIP_AABBS_BIT_KHR</code>, each element of <code>pLibraryInfo->pLibraries</code> <strong class=\"purple\">must</strong> have been created with the <code>VK_PIPELINE_CREATE_RAY_TRACING_SKIP_AABBS_BIT_KHR</code> bit set"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoKHR-flags-04719",
|
|
"text": " If <code>flags</code> includes <code>VK_PIPELINE_CREATE_RAY_TRACING_SKIP_TRIANGLES_BIT_KHR</code>, each element of <code>pLibraryInfo->pLibraries</code> <strong class=\"purple\">must</strong> have been created with the <code>VK_PIPELINE_CREATE_RAY_TRACING_SKIP_TRIANGLES_BIT_KHR</code> bit set"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoKHR-flags-04720",
|
|
"text": " If <code>flags</code> includes <code>VK_PIPELINE_CREATE_RAY_TRACING_NO_NULL_ANY_HIT_SHADERS_BIT_KHR</code>, each element of <code>pLibraryInfo->pLibraries</code> <strong class=\"purple\">must</strong> have been created with the <code>VK_PIPELINE_CREATE_RAY_TRACING_NO_NULL_ANY_HIT_SHADERS_BIT_KHR</code> bit set"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoKHR-flags-04721",
|
|
"text": " If <code>flags</code> includes <code>VK_PIPELINE_CREATE_RAY_TRACING_NO_NULL_CLOSEST_HIT_SHADERS_BIT_KHR</code>, each element of <code>pLibraryInfo->pLibraries</code> <strong class=\"purple\">must</strong> have been created with the <code>VK_PIPELINE_CREATE_RAY_TRACING_NO_NULL_CLOSEST_HIT_SHADERS_BIT_KHR</code> bit set"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoKHR-flags-04722",
|
|
"text": " If <code>flags</code> includes <code>VK_PIPELINE_CREATE_RAY_TRACING_NO_NULL_INTERSECTION_SHADERS_BIT_KHR</code>, each element of <code>pLibraryInfo->pLibraries</code> <strong class=\"purple\">must</strong> have been created with the <code>VK_PIPELINE_CREATE_RAY_TRACING_NO_NULL_INTERSECTION_SHADERS_BIT_KHR</code> bit set"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoKHR-flags-04723",
|
|
"text": " If <code>flags</code> includes <code>VK_PIPELINE_CREATE_RAY_TRACING_NO_NULL_MISS_SHADERS_BIT_KHR</code>, each element of <code>pLibraryInfo->pLibraries</code> <strong class=\"purple\">must</strong> have been created with the <code>VK_PIPELINE_CREATE_RAY_TRACING_NO_NULL_MISS_SHADERS_BIT_KHR</code> bit set"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)+(VK_EXT_pipeline_creation_feedback,VK_VERSION_1_3)": [
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineCreateInfoKHR-pipelineStageCreationFeedbackCount-06652",
|
|
"text": " If <a href=\"#VkPipelineCreationFeedbackCreateInfo\">VkPipelineCreationFeedbackCreateInfo</a>::<code>pipelineStageCreationFeedbackCount</code> is not <code>0</code>, it <strong class=\"purple\">must</strong> be equal to <code>stageCount</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkRayTracingShaderGroupCreateInfoNV": {
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_NV_ray_tracing)": [
|
|
{
|
|
"vuid": "VUID-VkRayTracingShaderGroupCreateInfoNV-type-02413",
|
|
"text": " If <code>type</code> is <code>VK_RAY_TRACING_SHADER_GROUP_TYPE_GENERAL_NV</code> then <code>generalShader</code> <strong class=\"purple\">must</strong> be a valid index into <a href=\"#VkRayTracingPipelineCreateInfoNV\">VkRayTracingPipelineCreateInfoNV</a>::<code>pStages</code> referring to a shader of <code>VK_SHADER_STAGE_RAYGEN_BIT_NV</code>, <code>VK_SHADER_STAGE_MISS_BIT_NV</code>, or <code>VK_SHADER_STAGE_CALLABLE_BIT_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingShaderGroupCreateInfoNV-type-02414",
|
|
"text": " If <code>type</code> is <code>VK_RAY_TRACING_SHADER_GROUP_TYPE_GENERAL_NV</code> then <code>closestHitShader</code>, <code>anyHitShader</code>, and <code>intersectionShader</code> <strong class=\"purple\">must</strong> be <code>VK_SHADER_UNUSED_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingShaderGroupCreateInfoNV-type-02415",
|
|
"text": " If <code>type</code> is <code>VK_RAY_TRACING_SHADER_GROUP_TYPE_PROCEDURAL_HIT_GROUP_NV</code> then <code>intersectionShader</code> <strong class=\"purple\">must</strong> be a valid index into <a href=\"#VkRayTracingPipelineCreateInfoNV\">VkRayTracingPipelineCreateInfoNV</a>::<code>pStages</code> referring to a shader of <code>VK_SHADER_STAGE_INTERSECTION_BIT_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingShaderGroupCreateInfoNV-type-02416",
|
|
"text": " If <code>type</code> is <code>VK_RAY_TRACING_SHADER_GROUP_TYPE_TRIANGLES_HIT_GROUP_NV</code> then <code>intersectionShader</code> <strong class=\"purple\">must</strong> be <code>VK_SHADER_UNUSED_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingShaderGroupCreateInfoNV-closestHitShader-02417",
|
|
"text": " <code>closestHitShader</code> <strong class=\"purple\">must</strong> be either <code>VK_SHADER_UNUSED_NV</code> or a valid index into <a href=\"#VkRayTracingPipelineCreateInfoNV\">VkRayTracingPipelineCreateInfoNV</a>::<code>pStages</code> referring to a shader of <code>VK_SHADER_STAGE_CLOSEST_HIT_BIT_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingShaderGroupCreateInfoNV-anyHitShader-02418",
|
|
"text": " <code>anyHitShader</code> <strong class=\"purple\">must</strong> be either <code>VK_SHADER_UNUSED_NV</code> or a valid index into <a href=\"#VkRayTracingPipelineCreateInfoNV\">VkRayTracingPipelineCreateInfoNV</a>::<code>pStages</code> referring to a shader of <code>VK_SHADER_STAGE_ANY_HIT_BIT_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingShaderGroupCreateInfoNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_RAY_TRACING_SHADER_GROUP_CREATE_INFO_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingShaderGroupCreateInfoNV-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingShaderGroupCreateInfoNV-type-parameter",
|
|
"text": " <code>type</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkRayTracingShaderGroupTypeKHR\">VkRayTracingShaderGroupTypeKHR</a> value"
|
|
}
|
|
]
|
|
},
|
|
"VkRayTracingShaderGroupCreateInfoKHR": {
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)": [
|
|
{
|
|
"vuid": "VUID-VkRayTracingShaderGroupCreateInfoKHR-type-03474",
|
|
"text": " If <code>type</code> is <code>VK_RAY_TRACING_SHADER_GROUP_TYPE_GENERAL_KHR</code> then <code>generalShader</code> <strong class=\"purple\">must</strong> be a valid index into <a href=\"#VkRayTracingPipelineCreateInfoKHR\">VkRayTracingPipelineCreateInfoKHR</a>::<code>pStages</code> referring to a shader of <code>VK_SHADER_STAGE_RAYGEN_BIT_KHR</code>, <code>VK_SHADER_STAGE_MISS_BIT_KHR</code>, or <code>VK_SHADER_STAGE_CALLABLE_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingShaderGroupCreateInfoKHR-type-03475",
|
|
"text": " If <code>type</code> is <code>VK_RAY_TRACING_SHADER_GROUP_TYPE_GENERAL_KHR</code> then <code>closestHitShader</code>, <code>anyHitShader</code>, and <code>intersectionShader</code> <strong class=\"purple\">must</strong> be <code>VK_SHADER_UNUSED_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingShaderGroupCreateInfoKHR-type-03476",
|
|
"text": " If <code>type</code> is <code>VK_RAY_TRACING_SHADER_GROUP_TYPE_PROCEDURAL_HIT_GROUP_KHR</code> then <code>intersectionShader</code> <strong class=\"purple\">must</strong> be a valid index into <a href=\"#VkRayTracingPipelineCreateInfoKHR\">VkRayTracingPipelineCreateInfoKHR</a>::<code>pStages</code> referring to a shader of <code>VK_SHADER_STAGE_INTERSECTION_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingShaderGroupCreateInfoKHR-type-03477",
|
|
"text": " If <code>type</code> is <code>VK_RAY_TRACING_SHADER_GROUP_TYPE_TRIANGLES_HIT_GROUP_KHR</code> then <code>intersectionShader</code> <strong class=\"purple\">must</strong> be <code>VK_SHADER_UNUSED_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingShaderGroupCreateInfoKHR-closestHitShader-03478",
|
|
"text": " <code>closestHitShader</code> <strong class=\"purple\">must</strong> be either <code>VK_SHADER_UNUSED_KHR</code> or a valid index into <a href=\"#VkRayTracingPipelineCreateInfoKHR\">VkRayTracingPipelineCreateInfoKHR</a>::<code>pStages</code> referring to a shader of <code>VK_SHADER_STAGE_CLOSEST_HIT_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingShaderGroupCreateInfoKHR-anyHitShader-03479",
|
|
"text": " <code>anyHitShader</code> <strong class=\"purple\">must</strong> be either <code>VK_SHADER_UNUSED_KHR</code> or a valid index into <a href=\"#VkRayTracingPipelineCreateInfoKHR\">VkRayTracingPipelineCreateInfoKHR</a>::<code>pStages</code> referring to a shader of <code>VK_SHADER_STAGE_ANY_HIT_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingShaderGroupCreateInfoKHR-rayTracingPipelineShaderGroupHandleCaptureReplayMixed-03603",
|
|
"text": " If <a href=\"#VkPhysicalDeviceRayTracingPipelineFeaturesKHR\">VkPhysicalDeviceRayTracingPipelineFeaturesKHR</a>::<code>rayTracingPipelineShaderGroupHandleCaptureReplayMixed</code> is <code>VK_FALSE</code> then <code>pShaderGroupCaptureReplayHandle</code> <strong class=\"purple\">must</strong> not be provided if it has not been provided on a previous call to ray tracing pipeline creation"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingShaderGroupCreateInfoKHR-rayTracingPipelineShaderGroupHandleCaptureReplayMixed-03604",
|
|
"text": " If <a href=\"#VkPhysicalDeviceRayTracingPipelineFeaturesKHR\">VkPhysicalDeviceRayTracingPipelineFeaturesKHR</a>::<code>rayTracingPipelineShaderGroupHandleCaptureReplayMixed</code> is <code>VK_FALSE</code> then the caller <strong class=\"purple\">must</strong> guarantee that no ray tracing pipeline creation commands with <code>pShaderGroupCaptureReplayHandle</code> provided execute simultaneously with ray tracing pipeline creation commands without <code>pShaderGroupCaptureReplayHandle</code> provided"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingShaderGroupCreateInfoKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_RAY_TRACING_SHADER_GROUP_CREATE_INFO_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingShaderGroupCreateInfoKHR-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingShaderGroupCreateInfoKHR-type-parameter",
|
|
"text": " <code>type</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkRayTracingShaderGroupTypeKHR\">VkRayTracingShaderGroupTypeKHR</a> value"
|
|
}
|
|
]
|
|
},
|
|
"VkRayTracingPipelineInterfaceCreateInfoKHR": {
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)": [
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineInterfaceCreateInfoKHR-maxPipelineRayHitAttributeSize-03605",
|
|
"text": " <code>maxPipelineRayHitAttributeSize</code> <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#VkPhysicalDeviceRayTracingPipelinePropertiesKHR\">VkPhysicalDeviceRayTracingPipelinePropertiesKHR</a>::<code>maxRayHitAttributeSize</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineInterfaceCreateInfoKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_RAY_TRACING_PIPELINE_INTERFACE_CREATE_INFO_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRayTracingPipelineInterfaceCreateInfoKHR-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetRayTracingShaderGroupHandlesKHR": {
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)": [
|
|
{
|
|
"vuid": "VUID-vkGetRayTracingShaderGroupHandlesKHR-pipeline-04619",
|
|
"text": " <code>pipeline</code> <strong class=\"purple\">must</strong> be a ray tracing pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetRayTracingShaderGroupHandlesKHR-firstGroup-04050",
|
|
"text": " <code>firstGroup</code> <strong class=\"purple\">must</strong> be less than the number of shader groups in <code>pipeline</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetRayTracingShaderGroupHandlesKHR-firstGroup-02419",
|
|
"text": " The sum of <code>firstGroup</code> and <code>groupCount</code> <strong class=\"purple\">must</strong> be less than or equal to the number of shader groups in <code>pipeline</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetRayTracingShaderGroupHandlesKHR-dataSize-02420",
|
|
"text": " <code>dataSize</code> <strong class=\"purple\">must</strong> be at least <span class=\"eq\"><a href=\"#VkPhysicalDeviceRayTracingPipelinePropertiesKHR\">VkPhysicalDeviceRayTracingPipelinePropertiesKHR</a>::<code>shaderGroupHandleSize</code> {times} <code>groupCount</code></span>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetRayTracingShaderGroupHandlesKHR-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetRayTracingShaderGroupHandlesKHR-pipeline-parameter",
|
|
"text": " <code>pipeline</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPipeline\">VkPipeline</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetRayTracingShaderGroupHandlesKHR-pData-parameter",
|
|
"text": " <code>pData</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>dataSize</code> bytes"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetRayTracingShaderGroupHandlesKHR-dataSize-arraylength",
|
|
"text": " <code>dataSize</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetRayTracingShaderGroupHandlesKHR-pipeline-parent",
|
|
"text": " <code>pipeline</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_pipeline_library)": [
|
|
{
|
|
"vuid": "VUID-vkGetRayTracingShaderGroupHandlesKHR-pipeline-03482",
|
|
"text": " <code>pipeline</code> <strong class=\"purple\">must</strong> not have been created with <code>VK_PIPELINE_CREATE_LIBRARY_BIT_KHR</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetRayTracingCaptureReplayShaderGroupHandlesKHR": {
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)": [
|
|
{
|
|
"vuid": "VUID-vkGetRayTracingCaptureReplayShaderGroupHandlesKHR-pipeline-04620",
|
|
"text": " <code>pipeline</code> <strong class=\"purple\">must</strong> be a ray tracing pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetRayTracingCaptureReplayShaderGroupHandlesKHR-firstGroup-04051",
|
|
"text": " <code>firstGroup</code> <strong class=\"purple\">must</strong> be less than the number of shader groups in <code>pipeline</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetRayTracingCaptureReplayShaderGroupHandlesKHR-firstGroup-03483",
|
|
"text": " The sum of <code>firstGroup</code> and <code>groupCount</code> <strong class=\"purple\">must</strong> be less than or equal to the number of shader groups in <code>pipeline</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetRayTracingCaptureReplayShaderGroupHandlesKHR-dataSize-03484",
|
|
"text": " <code>dataSize</code> <strong class=\"purple\">must</strong> be at least <span class=\"eq\"><a href=\"#VkPhysicalDeviceRayTracingPipelinePropertiesKHR\">VkPhysicalDeviceRayTracingPipelinePropertiesKHR</a>::<code>shaderGroupHandleCaptureReplaySize</code> {times} <code>groupCount</code></span>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetRayTracingCaptureReplayShaderGroupHandlesKHR-rayTracingPipelineShaderGroupHandleCaptureReplay-03606",
|
|
"text": " <code>VkPhysicalDeviceRayTracingPipelineFeaturesKHR</code>::<code>rayTracingPipelineShaderGroupHandleCaptureReplay</code> <strong class=\"purple\">must</strong> be enabled to call this function"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetRayTracingCaptureReplayShaderGroupHandlesKHR-pipeline-03607",
|
|
"text": " <code>pipeline</code> <strong class=\"purple\">must</strong> have been created with a <code>flags</code> that included <code>VK_PIPELINE_CREATE_RAY_TRACING_SHADER_GROUP_HANDLE_CAPTURE_REPLAY_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetRayTracingCaptureReplayShaderGroupHandlesKHR-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetRayTracingCaptureReplayShaderGroupHandlesKHR-pipeline-parameter",
|
|
"text": " <code>pipeline</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPipeline\">VkPipeline</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetRayTracingCaptureReplayShaderGroupHandlesKHR-pData-parameter",
|
|
"text": " <code>pData</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>dataSize</code> bytes"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetRayTracingCaptureReplayShaderGroupHandlesKHR-dataSize-arraylength",
|
|
"text": " <code>dataSize</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetRayTracingCaptureReplayShaderGroupHandlesKHR-pipeline-parent",
|
|
"text": " <code>pipeline</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)+(VK_KHR_pipeline_library)": [
|
|
{
|
|
"vuid": "VUID-vkGetRayTracingCaptureReplayShaderGroupHandlesKHR-pipeline-06720",
|
|
"text": " <code>pipeline</code> <strong class=\"purple\">must</strong> not have been created with <code>VK_PIPELINE_CREATE_LIBRARY_BIT_KHR</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCompileDeferredNV": {
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_NV_ray_tracing)": [
|
|
{
|
|
"vuid": "VUID-vkCompileDeferredNV-pipeline-04621",
|
|
"text": " <code>pipeline</code> <strong class=\"purple\">must</strong> be a ray tracing pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCompileDeferredNV-pipeline-02237",
|
|
"text": " <code>pipeline</code> <strong class=\"purple\">must</strong> have been created with <code>VK_PIPELINE_CREATE_DEFER_COMPILE_BIT_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCompileDeferredNV-shader-02238",
|
|
"text": " <code>shader</code> <strong class=\"purple\">must</strong> not have been called as a deferred compile before"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCompileDeferredNV-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCompileDeferredNV-pipeline-parameter",
|
|
"text": " <code>pipeline</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPipeline\">VkPipeline</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCompileDeferredNV-pipeline-parent",
|
|
"text": " <code>pipeline</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetRayTracingShaderGroupStackSizeKHR": {
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)": [
|
|
{
|
|
"vuid": "VUID-vkGetRayTracingShaderGroupStackSizeKHR-pipeline-04622",
|
|
"text": " <code>pipeline</code> <strong class=\"purple\">must</strong> be a ray tracing pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetRayTracingShaderGroupStackSizeKHR-group-03608",
|
|
"text": " The value of <code>group</code> must be less than the number of shader groups in <code>pipeline</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetRayTracingShaderGroupStackSizeKHR-groupShader-03609",
|
|
"text": " The shader identified by <code>groupShader</code> in <code>group</code> <strong class=\"purple\">must</strong> not be <code>VK_SHADER_UNUSED_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetRayTracingShaderGroupStackSizeKHR-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetRayTracingShaderGroupStackSizeKHR-pipeline-parameter",
|
|
"text": " <code>pipeline</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPipeline\">VkPipeline</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetRayTracingShaderGroupStackSizeKHR-groupShader-parameter",
|
|
"text": " <code>groupShader</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkShaderGroupShaderKHR\">VkShaderGroupShaderKHR</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetRayTracingShaderGroupStackSizeKHR-pipeline-parent",
|
|
"text": " <code>pipeline</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdSetRayTracingPipelineStackSizeKHR": {
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetRayTracingPipelineStackSizeKHR-pipelineStackSize-03610",
|
|
"text": " <code>pipelineStackSize</code> <strong class=\"purple\">must</strong> be large enough for any dynamic execution through the shaders in the ray tracing pipeline used by a subsequent trace call"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetRayTracingPipelineStackSizeKHR-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetRayTracingPipelineStackSizeKHR-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetRayTracingPipelineStackSizeKHR-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support compute operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetRayTracingPipelineStackSizeKHR-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetRayTracingPipelineStackSizeKHR-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
]
|
|
},
|
|
"vkDestroyPipeline": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkDestroyPipeline-pipeline-00765",
|
|
"text": " All submitted commands that refer to <code>pipeline</code> <strong class=\"purple\">must</strong> have completed execution"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyPipeline-pipeline-00766",
|
|
"text": " If <code>VkAllocationCallbacks</code> were provided when <code>pipeline</code> was created, a compatible set of callbacks <strong class=\"purple\">must</strong> be provided here"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyPipeline-pipeline-00767",
|
|
"text": " If no <code>VkAllocationCallbacks</code> were provided when <code>pipeline</code> was created, <code>pAllocator</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyPipeline-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyPipeline-pipeline-parameter",
|
|
"text": " If <code>pipeline</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>pipeline</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPipeline\">VkPipeline</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyPipeline-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyPipeline-pipeline-parent",
|
|
"text": " If <code>pipeline</code> is a valid handle, it <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCreatePipelineCache": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCreatePipelineCache-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreatePipelineCache-pCreateInfo-parameter",
|
|
"text": " <code>pCreateInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkPipelineCacheCreateInfo\">VkPipelineCacheCreateInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreatePipelineCache-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreatePipelineCache-pPipelineCache-parameter",
|
|
"text": " <code>pPipelineCache</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkPipelineCache\">VkPipelineCache</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkPipelineCacheCreateInfo": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkPipelineCacheCreateInfo-initialDataSize-00768",
|
|
"text": " If <code>initialDataSize</code> is not <code>0</code>, it <strong class=\"purple\">must</strong> be equal to the size of <code>pInitialData</code>, as returned by <code>vkGetPipelineCacheData</code> when <code>pInitialData</code> was originally retrieved"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineCacheCreateInfo-initialDataSize-00769",
|
|
"text": " If <code>initialDataSize</code> is not <code>0</code>, <code>pInitialData</code> <strong class=\"purple\">must</strong> have been retrieved from a previous call to <code>vkGetPipelineCacheData</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineCacheCreateInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PIPELINE_CACHE_CREATE_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineCacheCreateInfo-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineCacheCreateInfo-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkPipelineCacheCreateFlagBits\">VkPipelineCacheCreateFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineCacheCreateInfo-pInitialData-parameter",
|
|
"text": " If <code>initialDataSize</code> is not <code>0</code>, <code>pInitialData</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>initialDataSize</code> bytes"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_pipeline_creation_cache_control)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineCacheCreateInfo-pipelineCreationCacheControl-02892",
|
|
"text": " If the <a href=\"#features-pipelineCreationCacheControl\"><code>pipelineCreationCacheControl</code></a> feature is not enabled, <code>flags</code> <strong class=\"purple\">must</strong> not include <code>VK_PIPELINE_CACHE_CREATE_EXTERNALLY_SYNCHRONIZED_BIT</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkMergePipelineCaches": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkMergePipelineCaches-dstCache-00770",
|
|
"text": " <code>dstCache</code> <strong class=\"purple\">must</strong> not appear in the list of source caches"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkMergePipelineCaches-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkMergePipelineCaches-dstCache-parameter",
|
|
"text": " <code>dstCache</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPipelineCache\">VkPipelineCache</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkMergePipelineCaches-pSrcCaches-parameter",
|
|
"text": " <code>pSrcCaches</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>srcCacheCount</code> valid <a href=\"#VkPipelineCache\">VkPipelineCache</a> handles"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkMergePipelineCaches-srcCacheCount-arraylength",
|
|
"text": " <code>srcCacheCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkMergePipelineCaches-dstCache-parent",
|
|
"text": " <code>dstCache</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkMergePipelineCaches-pSrcCaches-parent",
|
|
"text": " Each element of <code>pSrcCaches</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetPipelineCacheData": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkGetPipelineCacheData-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPipelineCacheData-pipelineCache-parameter",
|
|
"text": " <code>pipelineCache</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPipelineCache\">VkPipelineCache</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPipelineCacheData-pDataSize-parameter",
|
|
"text": " <code>pDataSize</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>size_t</code> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPipelineCacheData-pData-parameter",
|
|
"text": " If the value referenced by <code>pDataSize</code> is not <code>0</code>, and <code>pData</code> is not <code>NULL</code>, <code>pData</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>pDataSize</code> bytes"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPipelineCacheData-pipelineCache-parent",
|
|
"text": " <code>pipelineCache</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPipelineCacheHeaderVersionOne": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkPipelineCacheHeaderVersionOne-headerSize-04967",
|
|
"text": " <code>headerSize</code> <strong class=\"purple\">must</strong> be 32"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineCacheHeaderVersionOne-headerVersion-04968",
|
|
"text": " <code>headerVersion</code> <strong class=\"purple\">must</strong> be <code>VK_PIPELINE_CACHE_HEADER_VERSION_ONE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineCacheHeaderVersionOne-headerVersion-parameter",
|
|
"text": " <code>headerVersion</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPipelineCacheHeaderVersion\">VkPipelineCacheHeaderVersion</a> value"
|
|
}
|
|
]
|
|
},
|
|
"vkDestroyPipelineCache": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkDestroyPipelineCache-pipelineCache-00771",
|
|
"text": " If <code>VkAllocationCallbacks</code> were provided when <code>pipelineCache</code> was created, a compatible set of callbacks <strong class=\"purple\">must</strong> be provided here"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyPipelineCache-pipelineCache-00772",
|
|
"text": " If no <code>VkAllocationCallbacks</code> were provided when <code>pipelineCache</code> was created, <code>pAllocator</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyPipelineCache-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyPipelineCache-pipelineCache-parameter",
|
|
"text": " If <code>pipelineCache</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>pipelineCache</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPipelineCache\">VkPipelineCache</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyPipelineCache-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyPipelineCache-pipelineCache-parent",
|
|
"text": " If <code>pipelineCache</code> is a valid handle, it <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkSpecializationInfo": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkSpecializationInfo-offset-00773",
|
|
"text": " The <code>offset</code> member of each element of <code>pMapEntries</code> <strong class=\"purple\">must</strong> be less than <code>dataSize</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSpecializationInfo-pMapEntries-00774",
|
|
"text": " The <code>size</code> member of each element of <code>pMapEntries</code> <strong class=\"purple\">must</strong> be less than or equal to <code>dataSize</code> minus <code>offset</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSpecializationInfo-constantID-04911",
|
|
"text": " The <code>constantID</code> value of each element of <code>pMapEntries</code> <strong class=\"purple\">must</strong> be unique within <code>pMapEntries</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSpecializationInfo-pMapEntries-parameter",
|
|
"text": " If <code>mapEntryCount</code> is not <code>0</code>, <code>pMapEntries</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>mapEntryCount</code> valid <a href=\"#VkSpecializationMapEntry\">VkSpecializationMapEntry</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSpecializationInfo-pData-parameter",
|
|
"text": " If <code>dataSize</code> is not <code>0</code>, <code>pData</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>dataSize</code> bytes"
|
|
}
|
|
]
|
|
},
|
|
"VkSpecializationMapEntry": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkSpecializationMapEntry-constantID-00776",
|
|
"text": " For a <code>constantID</code> specialization constant declared in a shader, <code>size</code> <strong class=\"purple\">must</strong> match the byte size of the <code>constantID</code>. If the specialization constant is of type <code>boolean</code>, <code>size</code> <strong class=\"purple\">must</strong> be the byte size of <code>VkBool32</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPipelineLibraryCreateInfoKHR": {
|
|
"(VK_KHR_pipeline_library)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineLibraryCreateInfoKHR-pLibraries-03381",
|
|
"text": " Each element of <code>pLibraries</code> <strong class=\"purple\">must</strong> have been created with <code>VK_PIPELINE_CREATE_LIBRARY_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineLibraryCreateInfoKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PIPELINE_LIBRARY_CREATE_INFO_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineLibraryCreateInfoKHR-pLibraries-parameter",
|
|
"text": " If <code>libraryCount</code> is not <code>0</code>, <code>pLibraries</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>libraryCount</code> valid <a href=\"#VkPipeline\">VkPipeline</a> handles"
|
|
}
|
|
],
|
|
"(VK_KHR_pipeline_library)+(VK_EXT_shader_module_identifier)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineLibraryCreateInfoKHR-pLibraries-06855",
|
|
"text": " If any library in <code>pLibraries</code> was created with a shader stage with <a href=\"#VkPipelineShaderStageModuleIdentifierCreateInfoEXT\">VkPipelineShaderStageModuleIdentifierCreateInfoEXT</a> and <code>identifierSize</code> not equal to 0, the pipeline <strong class=\"purple\">must</strong> be created with the <code>VK_PIPELINE_CREATE_FAIL_ON_PIPELINE_COMPILE_REQUIRED_BIT</code> flag set"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdBindPipeline": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCmdBindPipeline-pipelineBindPoint-00777",
|
|
"text": " If <code>pipelineBindPoint</code> is <code>VK_PIPELINE_BIND_POINT_COMPUTE</code>, the <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support compute operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindPipeline-pipelineBindPoint-00778",
|
|
"text": " If <code>pipelineBindPoint</code> is <code>VK_PIPELINE_BIND_POINT_GRAPHICS</code>, the <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindPipeline-pipelineBindPoint-00779",
|
|
"text": " If <code>pipelineBindPoint</code> is <code>VK_PIPELINE_BIND_POINT_COMPUTE</code>, <code>pipeline</code> <strong class=\"purple\">must</strong> be a compute pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindPipeline-pipelineBindPoint-00780",
|
|
"text": " If <code>pipelineBindPoint</code> is <code>VK_PIPELINE_BIND_POINT_GRAPHICS</code>, <code>pipeline</code> <strong class=\"purple\">must</strong> be a graphics pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindPipeline-pipeline-00781",
|
|
"text": " If the <a href=\"#features-variableMultisampleRate\"><code>variableMultisampleRate</code></a> feature is not supported, <code>pipeline</code> is a graphics pipeline, the current subpass <a href=\"#renderpass-noattachments\">uses no attachments</a>, and this is not the first call to this function with a graphics pipeline after transitioning to the current subpass, then the sample count specified by this pipeline <strong class=\"purple\">must</strong> match that set in the previous pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindPipeline-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindPipeline-pipelineBindPoint-parameter",
|
|
"text": " <code>pipelineBindPoint</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPipelineBindPoint\">VkPipelineBindPoint</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindPipeline-pipeline-parameter",
|
|
"text": " <code>pipeline</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPipeline\">VkPipeline</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindPipeline-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindPipeline-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics, or compute operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindPipeline-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindPipeline-commonparent",
|
|
"text": " Both of <code>commandBuffer</code>, and <code>pipeline</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"(VK_EXT_sample_locations)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBindPipeline-variableSampleLocations-01525",
|
|
"text": " If <a href=\"#VkPhysicalDeviceSampleLocationsPropertiesEXT\">VkPhysicalDeviceSampleLocationsPropertiesEXT</a>::<code>variableSampleLocations</code> is <code>VK_FALSE</code>, and <code>pipeline</code> is a graphics pipeline created with a <a href=\"#VkPipelineSampleLocationsStateCreateInfoEXT\">VkPipelineSampleLocationsStateCreateInfoEXT</a> structure having its <code>sampleLocationsEnable</code> member set to <code>VK_TRUE</code> but without <code>VK_DYNAMIC_STATE_SAMPLE_LOCATIONS_EXT</code> enabled then the current render pass instance <strong class=\"purple\">must</strong> have been begun by specifying a <a href=\"#VkRenderPassSampleLocationsBeginInfoEXT\">VkRenderPassSampleLocationsBeginInfoEXT</a> structure whose <code>pPostSubpassSampleLocations</code> member contains an element with a <code>subpassIndex</code> matching the current subpass index and the <code>sampleLocationsInfo</code> member of that element <strong class=\"purple\">must</strong> match the <code>sampleLocationsInfo</code> specified in <a href=\"#VkPipelineSampleLocationsStateCreateInfoEXT\">VkPipelineSampleLocationsStateCreateInfoEXT</a> when the pipeline was created"
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBindPipeline-None-02323",
|
|
"text": " This command <strong class=\"purple\">must</strong> not be recorded when transform feedback is active"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBindPipeline-pipelineBindPoint-02391",
|
|
"text": " If <code>pipelineBindPoint</code> is <code>VK_PIPELINE_BIND_POINT_RAY_TRACING_KHR</code>, the <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support compute operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindPipeline-pipelineBindPoint-02392",
|
|
"text": " If <code>pipelineBindPoint</code> is <code>VK_PIPELINE_BIND_POINT_RAY_TRACING_KHR</code>, <code>pipeline</code> <strong class=\"purple\">must</strong> be a ray tracing pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindPipeline-pipelineBindPoint-06721",
|
|
"text": " If <code>pipelineBindPoint</code> is <code>VK_PIPELINE_BIND_POINT_RAY_TRACING_KHR</code>, <code>commandBuffer</code> <strong class=\"purple\">must</strong> not be a protected command buffer"
|
|
}
|
|
],
|
|
"(VK_KHR_pipeline_library)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBindPipeline-pipeline-03382",
|
|
"text": " <code>pipeline</code> <strong class=\"purple\">must</strong> not have been created with <code>VK_PIPELINE_CREATE_LIBRARY_BIT_KHR</code> set"
|
|
}
|
|
],
|
|
"(VK_NV_inherited_viewport_scissor)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBindPipeline-commandBuffer-04808",
|
|
"text": " If <code>commandBuffer</code> is a secondary command buffer with <a href=\"#VkCommandBufferInheritanceViewportScissorInfoNV\">VkCommandBufferInheritanceViewportScissorInfoNV</a>::<code>viewportScissor2D</code> enabled and <code>pipelineBindPoint</code> is <code>VK_PIPELINE_BIND_POINT_GRAPHICS</code>, then the <code>pipeline</code> <strong class=\"purple\">must</strong> have been created with <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> or <code>VK_DYNAMIC_STATE_VIEWPORT</code>, and <code>VK_DYNAMIC_STATE_SCISSOR_WITH_COUNT</code> or <code>VK_DYNAMIC_STATE_SCISSOR</code> enabled"
|
|
}
|
|
],
|
|
"(VK_NV_inherited_viewport_scissor,VK_EXT_discard_rectangles)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBindPipeline-commandBuffer-04809",
|
|
"text": " If <code>commandBuffer</code> is a secondary command buffer with <a href=\"#VkCommandBufferInheritanceViewportScissorInfoNV\">VkCommandBufferInheritanceViewportScissorInfoNV</a>::<code>viewportScissor2D</code> enabled and <code>pipelineBindPoint</code> is <code>VK_PIPELINE_BIND_POINT_GRAPHICS</code> and <code>pipeline</code> was created with <a href=\"#VkPipelineDiscardRectangleStateCreateInfoEXT\">VkPipelineDiscardRectangleStateCreateInfoEXT</a> structure and its <code>discardRectangleCount</code> member is not <code>0</code>, then the pipeline <strong class=\"purple\">must</strong> have been created with <code>VK_DYNAMIC_STATE_DISCARD_RECTANGLE_EXT</code> enabled"
|
|
}
|
|
],
|
|
"(VK_EXT_provoking_vertex)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBindPipeline-pipelineBindPoint-04881",
|
|
"text": " If <code>pipelineBindPoint</code> is <code>VK_PIPELINE_BIND_POINT_GRAPHICS</code> and the <a href=\"#limits-provokingVertexModePerPipeline\"><code>provokingVertexModePerPipeline</code></a> limit is <code>VK_FALSE</code>, then pipeline’s <a href=\"#VkPipelineRasterizationProvokingVertexStateCreateInfoEXT\">VkPipelineRasterizationProvokingVertexStateCreateInfoEXT</a>::<code>provokingVertexMode</code> <strong class=\"purple\">must</strong> be the same as that of any other pipelines previously bound to this bind point within the current render pass instance, including any pipeline already bound when beginning the render pass instance"
|
|
}
|
|
],
|
|
"(VK_HUAWEI_subpass_shading)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBindPipeline-pipelineBindPoint-04949",
|
|
"text": " If <code>pipelineBindPoint</code> is <code>VK_PIPELINE_BIND_POINT_SUBPASS_SHADING_HUAWEI</code>, the <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support compute operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindPipeline-pipelineBindPoint-04950",
|
|
"text": " If <code>pipelineBindPoint</code> is <code>VK_PIPELINE_BIND_POINT_SUBPASS_SHADING_HUAWEI</code>, <code>pipeline</code> <strong class=\"purple\">must</strong> be a subpass shading pipeline"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBindPipeline-pipeline-06195",
|
|
"text": " If <code>pipeline</code> is a graphics pipeline, this command has been called inside a render pass instance started with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, and commands using the previously bound graphics pipeline have been recorded within the render pass instance, then the value of <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>colorAttachmentCount</code> specified by this pipeline <strong class=\"purple\">must</strong> match that set in the previous pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindPipeline-pipeline-06196",
|
|
"text": " If <code>pipeline</code> is a graphics pipeline, this command has been called inside a render pass instance started with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, and commands using the previously bound graphics pipeline have been recorded within the render pass instance, then the elements of <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>pColorAttachmentFormats</code> specified by this pipeline <strong class=\"purple\">must</strong> match that set in the previous pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindPipeline-pipeline-06197",
|
|
"text": " If <code>pipeline</code> is a graphics pipeline, this command has been called inside a render pass instance started with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, and commands using the previously bound graphics pipeline have been recorded within the render pass instance, then the value of <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>depthAttachmentFormat</code> specified by this pipeline <strong class=\"purple\">must</strong> match that set in the previous pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindPipeline-pipeline-06194",
|
|
"text": " If <code>pipeline</code> is a graphics pipeline, this command has been called inside a render pass instance started with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, and commands using the previously bound graphics pipeline have been recorded within the render pass instance, then the value of <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>stencilAttachmentFormat</code> specified by this pipeline <strong class=\"purple\">must</strong> match that set in the previous pipeline"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_EXT_multisampled_render_to_single_sampled)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBindPipeline-pipeline-06856",
|
|
"text": " If <code>pipeline</code> is a graphics pipeline, this command has been called inside a render pass instance started with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, and the <code>pNext</code> chain of <a href=\"#VkRenderingInfo\">VkRenderingInfo</a> includes a <a href=\"#VkMultisampledRenderToSingleSampledInfoEXT\">VkMultisampledRenderToSingleSampledInfoEXT</a> structure with <code>multisampledRenderToSingleSampledEnable</code> equal to <code>VK_TRUE</code>, then the value of <a href=\"#VkGraphicsPipelineCreateInfo\">VkGraphicsPipelineCreateInfo</a>::<code>pMultisampleState</code>::<code>rasterizationSamples</code> <strong class=\"purple\">must</strong> be equal to <a href=\"#VkMultisampledRenderToSingleSampledInfoEXT\">VkMultisampledRenderToSingleSampledInfoEXT</a>::<code>rasterizationSamples</code>."
|
|
}
|
|
],
|
|
"(VK_EXT_graphics_pipeline_library)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBindPipeline-pipelineBindPoint-06653",
|
|
"text": " If <code>pipelineBindPoint</code> is <code>VK_PIPELINE_BIND_POINT_GRAPHICS</code>, <code>pipeline</code> <strong class=\"purple\">must</strong> have been created without <code>VK_PIPELINE_CREATE_LIBRARY_BIT_KHR</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdBindPipelineShaderGroupNV": {
|
|
"(VK_NV_device_generated_commands)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBindPipelineShaderGroupNV-groupIndex-02893",
|
|
"text": " <code>groupIndex</code> <strong class=\"purple\">must</strong> be <code>0</code> or less than the effective <a href=\"#VkGraphicsPipelineShaderGroupsCreateInfoNV\">VkGraphicsPipelineShaderGroupsCreateInfoNV</a>::<code>groupCount</code> including the referenced pipelines"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindPipelineShaderGroupNV-pipelineBindPoint-02894",
|
|
"text": " The <code>pipelineBindPoint</code> <strong class=\"purple\">must</strong> be <code>VK_PIPELINE_BIND_POINT_GRAPHICS</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindPipelineShaderGroupNV-groupIndex-02895",
|
|
"text": " The same restrictions as <a href=\"#vkCmdBindPipeline\">vkCmdBindPipeline</a> apply as if the bound pipeline was created only with the Shader Group from the <code>groupIndex</code> information"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindPipelineShaderGroupNV-deviceGeneratedCommands-02896",
|
|
"text": " The <a href=\"#features-deviceGeneratedCommands\"><code>deviceGeneratedCommands</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindPipelineShaderGroupNV-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindPipelineShaderGroupNV-pipelineBindPoint-parameter",
|
|
"text": " <code>pipelineBindPoint</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPipelineBindPoint\">VkPipelineBindPoint</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindPipelineShaderGroupNV-pipeline-parameter",
|
|
"text": " <code>pipeline</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPipeline\">VkPipeline</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindPipelineShaderGroupNV-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindPipelineShaderGroupNV-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics, or compute operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindPipelineShaderGroupNV-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindPipelineShaderGroupNV-commonparent",
|
|
"text": " Both of <code>commandBuffer</code>, and <code>pipeline</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetPipelineExecutablePropertiesKHR": {
|
|
"(VK_KHR_pipeline_executable_properties)": [
|
|
{
|
|
"vuid": "VUID-vkGetPipelineExecutablePropertiesKHR-pipelineExecutableInfo-03270",
|
|
"text": " The <a href=\"#features-pipelineExecutableInfo\"><code>pipelineExecutableInfo</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPipelineExecutablePropertiesKHR-pipeline-03271",
|
|
"text": " The <code>pipeline</code> member of <code>pPipelineInfo</code> <strong class=\"purple\">must</strong> have been created with <code>device</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPipelineExecutablePropertiesKHR-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPipelineExecutablePropertiesKHR-pPipelineInfo-parameter",
|
|
"text": " <code>pPipelineInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkPipelineInfoKHR\">VkPipelineInfoKHR</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPipelineExecutablePropertiesKHR-pExecutableCount-parameter",
|
|
"text": " <code>pExecutableCount</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>uint32_t</code> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPipelineExecutablePropertiesKHR-pProperties-parameter",
|
|
"text": " If the value referenced by <code>pExecutableCount</code> is not <code>0</code>, and <code>pProperties</code> is not <code>NULL</code>, <code>pProperties</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>pExecutableCount</code> <a href=\"#VkPipelineExecutablePropertiesKHR\">VkPipelineExecutablePropertiesKHR</a> structures"
|
|
}
|
|
]
|
|
},
|
|
"VkPipelineExecutablePropertiesKHR": {
|
|
"(VK_KHR_pipeline_executable_properties)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineExecutablePropertiesKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PIPELINE_EXECUTABLE_PROPERTIES_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineExecutablePropertiesKHR-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetPipelinePropertiesEXT": {
|
|
"(VK_EXT_pipeline_properties)": [
|
|
{
|
|
"vuid": "VUID-vkGetPipelinePropertiesEXT-pipeline-06738",
|
|
"text": " The <code>pipeline</code> member of <code>pPipelineInfo</code> must have been created with <code>device</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPipelinePropertiesEXT-pPipelineProperties-06739",
|
|
"text": " <code>pPipelineProperties</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkPipelinePropertiesIdentifierEXT\">VkPipelinePropertiesIdentifierEXT</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPipelinePropertiesEXT-None-06766",
|
|
"text": " The <a href=\"#features-pipelinePropertiesIdentifier\"><code>pipelinePropertiesIdentifier</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPipelinePropertiesEXT-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPipelinePropertiesEXT-pPipelineInfo-parameter",
|
|
"text": " <code>pPipelineInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkPipelineInfoEXT\">VkPipelineInfoEXT</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkPipelinePropertiesIdentifierEXT": {
|
|
"(VK_EXT_pipeline_properties)": [
|
|
{
|
|
"vuid": "VUID-VkPipelinePropertiesIdentifierEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PIPELINE_PROPERTIES_IDENTIFIER_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelinePropertiesIdentifierEXT-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPipelineInfoKHR": {
|
|
"(VK_KHR_pipeline_executable_properties,VK_EXT_pipeline_properties)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineInfoKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PIPELINE_INFO_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineInfoKHR-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineInfoKHR-pipeline-parameter",
|
|
"text": " <code>pipeline</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPipeline\">VkPipeline</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"vkGetPipelineExecutableStatisticsKHR": {
|
|
"(VK_KHR_pipeline_executable_properties)": [
|
|
{
|
|
"vuid": "VUID-vkGetPipelineExecutableStatisticsKHR-pipelineExecutableInfo-03272",
|
|
"text": " The <a href=\"#features-pipelineExecutableInfo\"><code>pipelineExecutableInfo</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPipelineExecutableStatisticsKHR-pipeline-03273",
|
|
"text": " The <code>pipeline</code> member of <code>pExecutableInfo</code> <strong class=\"purple\">must</strong> have been created with <code>device</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPipelineExecutableStatisticsKHR-pipeline-03274",
|
|
"text": " The <code>pipeline</code> member of <code>pExecutableInfo</code> <strong class=\"purple\">must</strong> have been created with <code>VK_PIPELINE_CREATE_CAPTURE_STATISTICS_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPipelineExecutableStatisticsKHR-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPipelineExecutableStatisticsKHR-pExecutableInfo-parameter",
|
|
"text": " <code>pExecutableInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkPipelineExecutableInfoKHR\">VkPipelineExecutableInfoKHR</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPipelineExecutableStatisticsKHR-pStatisticCount-parameter",
|
|
"text": " <code>pStatisticCount</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>uint32_t</code> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPipelineExecutableStatisticsKHR-pStatistics-parameter",
|
|
"text": " If the value referenced by <code>pStatisticCount</code> is not <code>0</code>, and <code>pStatistics</code> is not <code>NULL</code>, <code>pStatistics</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>pStatisticCount</code> <a href=\"#VkPipelineExecutableStatisticKHR\">VkPipelineExecutableStatisticKHR</a> structures"
|
|
}
|
|
]
|
|
},
|
|
"VkPipelineExecutableInfoKHR": {
|
|
"(VK_KHR_pipeline_executable_properties)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineExecutableInfoKHR-executableIndex-03275",
|
|
"text": " <code>executableIndex</code> <strong class=\"purple\">must</strong> be less than the number of pipeline executables associated with <code>pipeline</code> as returned in the <code>pExecutableCount</code> parameter of <code>vkGetPipelineExecutablePropertiesKHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineExecutableInfoKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PIPELINE_EXECUTABLE_INFO_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineExecutableInfoKHR-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineExecutableInfoKHR-pipeline-parameter",
|
|
"text": " <code>pipeline</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPipeline\">VkPipeline</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkPipelineExecutableStatisticKHR": {
|
|
"(VK_KHR_pipeline_executable_properties)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineExecutableStatisticKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PIPELINE_EXECUTABLE_STATISTIC_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineExecutableStatisticKHR-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetPipelineExecutableInternalRepresentationsKHR": {
|
|
"(VK_KHR_pipeline_executable_properties)": [
|
|
{
|
|
"vuid": "VUID-vkGetPipelineExecutableInternalRepresentationsKHR-pipelineExecutableInfo-03276",
|
|
"text": " The <a href=\"#features-pipelineExecutableInfo\"><code>pipelineExecutableInfo</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPipelineExecutableInternalRepresentationsKHR-pipeline-03277",
|
|
"text": " The <code>pipeline</code> member of <code>pExecutableInfo</code> <strong class=\"purple\">must</strong> have been created with <code>device</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPipelineExecutableInternalRepresentationsKHR-pipeline-03278",
|
|
"text": " The <code>pipeline</code> member of <code>pExecutableInfo</code> <strong class=\"purple\">must</strong> have been created with <code>VK_PIPELINE_CREATE_CAPTURE_INTERNAL_REPRESENTATIONS_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPipelineExecutableInternalRepresentationsKHR-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPipelineExecutableInternalRepresentationsKHR-pExecutableInfo-parameter",
|
|
"text": " <code>pExecutableInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkPipelineExecutableInfoKHR\">VkPipelineExecutableInfoKHR</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPipelineExecutableInternalRepresentationsKHR-pInternalRepresentationCount-parameter",
|
|
"text": " <code>pInternalRepresentationCount</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>uint32_t</code> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPipelineExecutableInternalRepresentationsKHR-pInternalRepresentations-parameter",
|
|
"text": " If the value referenced by <code>pInternalRepresentationCount</code> is not <code>0</code>, and <code>pInternalRepresentations</code> is not <code>NULL</code>, <code>pInternalRepresentations</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>pInternalRepresentationCount</code> <a href=\"#VkPipelineExecutableInternalRepresentationKHR\">VkPipelineExecutableInternalRepresentationKHR</a> structures"
|
|
}
|
|
]
|
|
},
|
|
"VkPipelineExecutableInternalRepresentationKHR": {
|
|
"(VK_KHR_pipeline_executable_properties)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineExecutableInternalRepresentationKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PIPELINE_EXECUTABLE_INTERNAL_REPRESENTATION_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineExecutableInternalRepresentationKHR-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetShaderInfoAMD": {
|
|
"(VK_AMD_shader_info)": [
|
|
{
|
|
"vuid": "VUID-vkGetShaderInfoAMD-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetShaderInfoAMD-pipeline-parameter",
|
|
"text": " <code>pipeline</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPipeline\">VkPipeline</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetShaderInfoAMD-shaderStage-parameter",
|
|
"text": " <code>shaderStage</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkShaderStageFlagBits\">VkShaderStageFlagBits</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetShaderInfoAMD-infoType-parameter",
|
|
"text": " <code>infoType</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkShaderInfoTypeAMD\">VkShaderInfoTypeAMD</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetShaderInfoAMD-pInfoSize-parameter",
|
|
"text": " <code>pInfoSize</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>size_t</code> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetShaderInfoAMD-pInfo-parameter",
|
|
"text": " If the value referenced by <code>pInfoSize</code> is not <code>0</code>, and <code>pInfo</code> is not <code>NULL</code>, <code>pInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>pInfoSize</code> bytes"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetShaderInfoAMD-pipeline-parent",
|
|
"text": " <code>pipeline</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPipelineCompilerControlCreateInfoAMD": {
|
|
"(VK_AMD_pipeline_compiler_control)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineCompilerControlCreateInfoAMD-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PIPELINE_COMPILER_CONTROL_CREATE_INFO_AMD</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineCompilerControlCreateInfoAMD-compilerControlFlags-zerobitmask",
|
|
"text": " <code>compilerControlFlags</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPipelineCreationFeedbackCreateInfo": {
|
|
"(VK_VERSION_1_3,VK_EXT_pipeline_creation_feedback)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineCreationFeedbackCreateInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PIPELINE_CREATION_FEEDBACK_CREATE_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineCreationFeedbackCreateInfo-pPipelineCreationFeedback-parameter",
|
|
"text": " <code>pPipelineCreationFeedback</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkPipelineCreationFeedback\">VkPipelineCreationFeedback</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineCreationFeedbackCreateInfo-pPipelineStageCreationFeedbacks-parameter",
|
|
"text": " If <code>pipelineStageCreationFeedbackCount</code> is not <code>0</code>, <code>pPipelineStageCreationFeedbacks</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>pipelineStageCreationFeedbackCount</code> <a href=\"#VkPipelineCreationFeedback\">VkPipelineCreationFeedback</a> structures"
|
|
}
|
|
]
|
|
},
|
|
"VkAllocationCallbacks": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkAllocationCallbacks-pfnAllocation-00632",
|
|
"text": " <code>pfnAllocation</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid user-defined <a href=\"#PFN_vkAllocationFunction\">PFN_vkAllocationFunction</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAllocationCallbacks-pfnReallocation-00633",
|
|
"text": " <code>pfnReallocation</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid user-defined <a href=\"#PFN_vkReallocationFunction\">PFN_vkReallocationFunction</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAllocationCallbacks-pfnFree-00634",
|
|
"text": " <code>pfnFree</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid user-defined <a href=\"#PFN_vkFreeFunction\">PFN_vkFreeFunction</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAllocationCallbacks-pfnInternalAllocation-00635",
|
|
"text": " If either of <code>pfnInternalAllocation</code> or <code>pfnInternalFree</code> is not <code>NULL</code>, both <strong class=\"purple\">must</strong> be valid callbacks"
|
|
}
|
|
]
|
|
},
|
|
"vkGetPhysicalDeviceMemoryProperties": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceMemoryProperties-physicalDevice-parameter",
|
|
"text": " <code>physicalDevice</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceMemoryProperties-pMemoryProperties-parameter",
|
|
"text": " <code>pMemoryProperties</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkPhysicalDeviceMemoryProperties\">VkPhysicalDeviceMemoryProperties</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"vkGetPhysicalDeviceMemoryProperties2": {
|
|
"(VK_VERSION_1_1,VK_KHR_get_physical_device_properties2)": [
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceMemoryProperties2-physicalDevice-parameter",
|
|
"text": " <code>physicalDevice</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceMemoryProperties2-pMemoryProperties-parameter",
|
|
"text": " <code>pMemoryProperties</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkPhysicalDeviceMemoryProperties2\">VkPhysicalDeviceMemoryProperties2</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceMemoryProperties2": {
|
|
"(VK_VERSION_1_1,VK_KHR_get_physical_device_properties2)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceMemoryProperties2-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_MEMORY_PROPERTIES_2</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceMemoryProperties2-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkPhysicalDeviceMemoryBudgetPropertiesEXT\">VkPhysicalDeviceMemoryBudgetPropertiesEXT</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceMemoryProperties2-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceMemoryBudgetPropertiesEXT": {
|
|
"(VK_EXT_memory_budget)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceMemoryBudgetPropertiesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_MEMORY_BUDGET_PROPERTIES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkAllocateMemory": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkAllocateMemory-pAllocateInfo-01713",
|
|
"text": " <code>pAllocateInfo->allocationSize</code> <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#VkPhysicalDeviceMemoryProperties\">VkPhysicalDeviceMemoryProperties</a>::<code>memoryHeaps</code>[<code>memindex</code>].<code>size</code> where <code>memindex</code> = <a href=\"#VkPhysicalDeviceMemoryProperties\">VkPhysicalDeviceMemoryProperties</a>::<code>memoryTypes</code>[<code>pAllocateInfo->memoryTypeIndex</code>].<code>heapIndex</code> as returned by <a href=\"#vkGetPhysicalDeviceMemoryProperties\">vkGetPhysicalDeviceMemoryProperties</a> for the <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> that <code>device</code> was created from"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkAllocateMemory-pAllocateInfo-01714",
|
|
"text": " <code>pAllocateInfo->memoryTypeIndex</code> <strong class=\"purple\">must</strong> be less than <a href=\"#VkPhysicalDeviceMemoryProperties\">VkPhysicalDeviceMemoryProperties</a>::<code>memoryTypeCount</code> as returned by <a href=\"#vkGetPhysicalDeviceMemoryProperties\">vkGetPhysicalDeviceMemoryProperties</a> for the <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> that <code>device</code> was created from"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkAllocateMemory-maxMemoryAllocationCount-04101",
|
|
"text": " There <strong class=\"purple\">must</strong> be less than <code>VkPhysicalDeviceLimits</code>::<code>maxMemoryAllocationCount</code> device memory allocations currently allocated on the device"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkAllocateMemory-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkAllocateMemory-pAllocateInfo-parameter",
|
|
"text": " <code>pAllocateInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkMemoryAllocateInfo\">VkMemoryAllocateInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkAllocateMemory-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkAllocateMemory-pMemory-parameter",
|
|
"text": " <code>pMemory</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkDeviceMemory\">VkDeviceMemory</a> handle"
|
|
}
|
|
],
|
|
"(VK_AMD_device_coherent_memory)": [
|
|
{
|
|
"vuid": "VUID-vkAllocateMemory-deviceCoherentMemory-02790",
|
|
"text": " If the <a href=\"#features-deviceCoherentMemory\"><code>deviceCoherentMemory</code></a> feature is not enabled, <code>pAllocateInfo->memoryTypeIndex</code> <strong class=\"purple\">must</strong> not identify a memory type supporting <code>VK_MEMORY_PROPERTY_DEVICE_COHERENT_BIT_AMD</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkMemoryAllocateInfo": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkMemoryAllocateInfo-None-06657",
|
|
"text": " The parameters <strong class=\"purple\">must</strong> not define more than one <a href=\"#memory-import-operation\">import operation</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryAllocateInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_MEMORY_ALLOCATE_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryAllocateInfo-pNext-pNext",
|
|
"text": " Each <code>pNext</code> member of any structure (including this one) in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be either <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkDedicatedAllocationMemoryAllocateInfoNV\">VkDedicatedAllocationMemoryAllocateInfoNV</a>, <a href=\"#VkExportMemoryAllocateInfo\">VkExportMemoryAllocateInfo</a>, <a href=\"#VkExportMemoryAllocateInfoNV\">VkExportMemoryAllocateInfoNV</a>, <a href=\"#VkExportMemoryWin32HandleInfoKHR\">VkExportMemoryWin32HandleInfoKHR</a>, <a href=\"#VkExportMemoryWin32HandleInfoNV\">VkExportMemoryWin32HandleInfoNV</a>, <a href=\"#VkExportMetalObjectCreateInfoEXT\">VkExportMetalObjectCreateInfoEXT</a>, <a href=\"#VkImportAndroidHardwareBufferInfoANDROID\">VkImportAndroidHardwareBufferInfoANDROID</a>, <a href=\"#VkImportMemoryBufferCollectionFUCHSIA\">VkImportMemoryBufferCollectionFUCHSIA</a>, <a href=\"#VkImportMemoryFdInfoKHR\">VkImportMemoryFdInfoKHR</a>, <a href=\"#VkImportMemoryHostPointerInfoEXT\">VkImportMemoryHostPointerInfoEXT</a>, <a href=\"#VkImportMemoryWin32HandleInfoKHR\">VkImportMemoryWin32HandleInfoKHR</a>, <a href=\"#VkImportMemoryWin32HandleInfoNV\">VkImportMemoryWin32HandleInfoNV</a>, <a href=\"#VkImportMemoryZirconHandleInfoFUCHSIA\">VkImportMemoryZirconHandleInfoFUCHSIA</a>, <a href=\"#VkImportMetalBufferInfoEXT\">VkImportMetalBufferInfoEXT</a>, <a href=\"#VkMemoryAllocateFlagsInfo\">VkMemoryAllocateFlagsInfo</a>, <a href=\"#VkMemoryDedicatedAllocateInfo\">VkMemoryDedicatedAllocateInfo</a>, <a href=\"#VkMemoryOpaqueCaptureAddressAllocateInfo\">VkMemoryOpaqueCaptureAddressAllocateInfo</a>, or <a href=\"#VkMemoryPriorityAllocateInfoEXT\">VkMemoryPriorityAllocateInfoEXT</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryAllocateInfo-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique, with the exception of structures of type <a href=\"#VkExportMetalObjectCreateInfoEXT\">VkExportMetalObjectCreateInfoEXT</a>"
|
|
}
|
|
],
|
|
"!(VK_ANDROID_external_memory_android_hardware_buffer)": [
|
|
{
|
|
"vuid": "VUID-VkMemoryAllocateInfo-allocationSize-00638",
|
|
"text": " <code>allocationSize</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
],
|
|
"(VK_FUCHSIA_buffer_collection)": [
|
|
{
|
|
"vuid": "VUID-VkMemoryAllocateInfo-buffer-06380",
|
|
"text": " If the parameters define an import operation from an <a href=\"#VkBufferCollectionFUCHSIA\">VkBufferCollectionFUCHSIA</a>, and <a href=\"#VkMemoryDedicatedAllocateInfo\">VkMemoryDedicatedAllocateInfo</a>::<code>buffer</code> is present and non-NULL, <a href=\"#VkImportMemoryBufferCollectionFUCHSIA\">VkImportMemoryBufferCollectionFUCHSIA</a>::<code>collection</code> and <a href=\"#VkImportMemoryBufferCollectionFUCHSIA\">VkImportMemoryBufferCollectionFUCHSIA</a>::<code>index</code> must match <a href=\"#VkBufferCollectionBufferCreateInfoFUCHSIA\">VkBufferCollectionBufferCreateInfoFUCHSIA</a>::<code>collection</code> and <a href=\"#VkBufferCollectionBufferCreateInfoFUCHSIA\">VkBufferCollectionBufferCreateInfoFUCHSIA</a>::<code>index</code>, respectively, of the <a href=\"#VkBufferCollectionBufferCreateInfoFUCHSIA\">VkBufferCollectionBufferCreateInfoFUCHSIA</a> structure used to create the <a href=\"#VkMemoryDedicatedAllocateInfo\">VkMemoryDedicatedAllocateInfo</a>::<code>buffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryAllocateInfo-image-06381",
|
|
"text": " If the parameters define an import operation from an <a href=\"#VkBufferCollectionFUCHSIA\">VkBufferCollectionFUCHSIA</a>, and <a href=\"#VkMemoryDedicatedAllocateInfo\">VkMemoryDedicatedAllocateInfo</a>::<code>image</code> is present and non-NULL, <a href=\"#VkImportMemoryBufferCollectionFUCHSIA\">VkImportMemoryBufferCollectionFUCHSIA</a>::<code>collection</code> and <a href=\"#VkImportMemoryBufferCollectionFUCHSIA\">VkImportMemoryBufferCollectionFUCHSIA</a>::<code>index</code> must match <a href=\"#VkBufferCollectionImageCreateInfoFUCHSIA\">VkBufferCollectionImageCreateInfoFUCHSIA</a>::<code>collection</code> and <a href=\"#VkBufferCollectionImageCreateInfoFUCHSIA\">VkBufferCollectionImageCreateInfoFUCHSIA</a>::<code>index</code>, respectively, of the <a href=\"#VkBufferCollectionImageCreateInfoFUCHSIA\">VkBufferCollectionImageCreateInfoFUCHSIA</a> structure used to create the <a href=\"#VkMemoryDedicatedAllocateInfo\">VkMemoryDedicatedAllocateInfo</a>::<code>image</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryAllocateInfo-allocationSize-06382",
|
|
"text": " If the parameters define an import operation from an <a href=\"#VkBufferCollectionFUCHSIA\">VkBufferCollectionFUCHSIA</a>, <code>allocationSize</code> <strong class=\"purple\">must</strong> match <a href=\"#VkMemoryRequirements\">VkMemoryRequirements</a>::<code>size</code> value retrieved by <a href=\"#vkGetImageMemoryRequirements\">vkGetImageMemoryRequirements</a> or <a href=\"#vkGetBufferMemoryRequirements\">vkGetBufferMemoryRequirements</a> for image-based or buffer-based collections respectively"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryAllocateInfo-pNext-06383",
|
|
"text": " If the parameters define an import operation from an <a href=\"#VkBufferCollectionFUCHSIA\">VkBufferCollectionFUCHSIA</a>, the <code>pNext</code> chain <strong class=\"purple\">must</strong> include a <a href=\"#VkMemoryDedicatedAllocateInfo\">VkMemoryDedicatedAllocateInfo</a> structure with either its <code>image</code> or <code>buffer</code> field set to a value other than <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>."
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryAllocateInfo-image-06384",
|
|
"text": " If the parameters define an import operation from an <a href=\"#VkBufferCollectionFUCHSIA\">VkBufferCollectionFUCHSIA</a> and <a href=\"#VkMemoryDedicatedAllocateInfo\">VkMemoryDedicatedAllocateInfo</a>::<code>image</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the <code>image</code> <strong class=\"purple\">must</strong> be created with a <a href=\"#VkBufferCollectionImageCreateInfoFUCHSIA\">VkBufferCollectionImageCreateInfoFUCHSIA</a> structure chained to its <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a>::<code>pNext</code> pointer"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryAllocateInfo-buffer-06385",
|
|
"text": " If the parameters define an import operation from an <a href=\"#VkBufferCollectionFUCHSIA\">VkBufferCollectionFUCHSIA</a> and <a href=\"#VkMemoryDedicatedAllocateInfo\">VkMemoryDedicatedAllocateInfo</a>::<code>buffer</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the <code>buffer</code> <strong class=\"purple\">must</strong> be created with a <a href=\"#VkBufferCollectionBufferCreateInfoFUCHSIA\">VkBufferCollectionBufferCreateInfoFUCHSIA</a> structure chained to its <a href=\"#VkBufferCreateInfo\">VkBufferCreateInfo</a>::<code>pNext</code> pointer"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryAllocateInfo-memoryTypeIndex-06386",
|
|
"text": " If the parameters define an import operation from an <a href=\"#VkBufferCollectionFUCHSIA\">VkBufferCollectionFUCHSIA</a>, <code>memoryTypeIndex</code> <strong class=\"purple\">must</strong> be from <a href=\"#VkBufferCollectionPropertiesFUCHSIA\">VkBufferCollectionPropertiesFUCHSIA</a> as retrieved by <a href=\"#vkGetBufferCollectionPropertiesFUCHSIA\">vkGetBufferCollectionPropertiesFUCHSIA</a>."
|
|
}
|
|
],
|
|
"(VK_KHR_external_memory)+(VK_KHR_dedicated_allocation,VK_NV_dedicated_allocation)": [
|
|
{
|
|
"vuid": "VUID-VkMemoryAllocateInfo-pNext-00639",
|
|
"text": " If the <code>pNext</code> chain includes a <code>VkExportMemoryAllocateInfo</code> structure, and any of the handle types specified in <code>VkExportMemoryAllocateInfo</code>::<code>handleTypes</code> require a dedicated allocation, as reported by <a href=\"#vkGetPhysicalDeviceImageFormatProperties2\">vkGetPhysicalDeviceImageFormatProperties2</a> in <code>VkExternalImageFormatProperties</code>::<code>externalMemoryProperties.externalMemoryFeatures</code> or <code>VkExternalBufferProperties</code>::<code>externalMemoryProperties.externalMemoryFeatures</code>, the <code>pNext</code> chain <strong class=\"purple\">must</strong> include a <code>VkMemoryDedicatedAllocateInfo</code> or <code>VkDedicatedAllocationMemoryAllocateInfoNV</code> structure with either its <code>image</code> or <code>buffer</code> member set to a value other than <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
}
|
|
],
|
|
"(VK_KHR_external_memory)+(VK_NV_external_memory)": [
|
|
{
|
|
"vuid": "VUID-VkMemoryAllocateInfo-pNext-00640",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkExportMemoryAllocateInfo\">VkExportMemoryAllocateInfo</a> structure, it <strong class=\"purple\">must</strong> not include a <a href=\"#VkExportMemoryAllocateInfoNV\">VkExportMemoryAllocateInfoNV</a> or <a href=\"#VkExportMemoryWin32HandleInfoNV\">VkExportMemoryWin32HandleInfoNV</a> structure"
|
|
}
|
|
],
|
|
"(VK_KHR_external_memory_win32+VK_NV_external_memory_win32)": [
|
|
{
|
|
"vuid": "VUID-VkMemoryAllocateInfo-pNext-00641",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkImportMemoryWin32HandleInfoKHR\">VkImportMemoryWin32HandleInfoKHR</a> structure, it <strong class=\"purple\">must</strong> not include a <a href=\"#VkImportMemoryWin32HandleInfoNV\">VkImportMemoryWin32HandleInfoNV</a> structure"
|
|
}
|
|
],
|
|
"(VK_KHR_external_memory_fd)": [
|
|
{
|
|
"vuid": "VUID-VkMemoryAllocateInfo-allocationSize-01742",
|
|
"text": " If the parameters define an import operation, the external handle specified was created by the Vulkan API, and the external handle type is <code>VK_EXTERNAL_MEMORY_HANDLE_TYPE_OPAQUE_FD_BIT</code>, then the values of <code>allocationSize</code> and <code>memoryTypeIndex</code> <strong class=\"purple\">must</strong> match those specified when the payload being imported was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryAllocateInfo-memoryTypeIndex-00648",
|
|
"text": " If the parameters define an import operation and the external handle is a POSIX file descriptor created outside of the Vulkan API, the value of <code>memoryTypeIndex</code> <strong class=\"purple\">must</strong> be one of those returned by <a href=\"#vkGetMemoryFdPropertiesKHR\">vkGetMemoryFdPropertiesKHR</a>"
|
|
}
|
|
],
|
|
"(VK_KHR_external_memory+VK_KHR_device_group)": [
|
|
{
|
|
"vuid": "VUID-VkMemoryAllocateInfo-None-00643",
|
|
"text": " If the parameters define an import operation and the external handle specified was created by the Vulkan API, the device mask specified by <a href=\"#VkMemoryAllocateFlagsInfo\">VkMemoryAllocateFlagsInfo</a> <strong class=\"purple\">must</strong> match the mask specified when the payload being imported was allocated"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryAllocateInfo-None-00644",
|
|
"text": " If the parameters define an import operation and the external handle specified was created by the Vulkan API, the list of physical devices that comprise the logical device passed to <a href=\"#vkAllocateMemory\">vkAllocateMemory</a> <strong class=\"purple\">must</strong> match the list of physical devices that comprise the logical device on which the payload was originally allocated"
|
|
}
|
|
],
|
|
"(VK_KHR_external_memory_win32)": [
|
|
{
|
|
"vuid": "VUID-VkMemoryAllocateInfo-memoryTypeIndex-00645",
|
|
"text": " If the parameters define an import operation and the external handle is an NT handle or a global share handle created outside of the Vulkan API, the value of <code>memoryTypeIndex</code> <strong class=\"purple\">must</strong> be one of those returned by <a href=\"#vkGetMemoryWin32HandlePropertiesKHR\">vkGetMemoryWin32HandlePropertiesKHR</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryAllocateInfo-allocationSize-01743",
|
|
"text": " If the parameters define an import operation, the external handle was created by the Vulkan API, and the external handle type is <code>VK_EXTERNAL_MEMORY_HANDLE_TYPE_OPAQUE_WIN32_BIT</code> or <code>VK_EXTERNAL_MEMORY_HANDLE_TYPE_OPAQUE_WIN32_KMT_BIT</code>, then the values of <code>allocationSize</code> and <code>memoryTypeIndex</code> <strong class=\"purple\">must</strong> match those specified when the payload being imported was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryAllocateInfo-allocationSize-00647",
|
|
"text": " If the parameters define an import operation and the external handle type is <code>VK_EXTERNAL_MEMORY_HANDLE_TYPE_D3D12_HEAP_BIT</code>, <code>allocationSize</code> <strong class=\"purple\">must</strong> match the size specified when creating the Direct3D 12 heap from which the payload was extracted"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-VkMemoryAllocateInfo-memoryTypeIndex-01872",
|
|
"text": " If the <a href=\"#features-protectedMemory\"><code>protectedMemory</code></a> feature is not enabled, the <code>VkMemoryAllocateInfo</code>::<code>memoryTypeIndex</code> <strong class=\"purple\">must</strong> not indicate a memory type that reports <code>VK_MEMORY_PROPERTY_PROTECTED_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_external_memory_host)": [
|
|
{
|
|
"vuid": "VUID-VkMemoryAllocateInfo-memoryTypeIndex-01744",
|
|
"text": " If the parameters define an import operation and the external handle is a host pointer, the value of <code>memoryTypeIndex</code> <strong class=\"purple\">must</strong> be one of those returned by <a href=\"#vkGetMemoryHostPointerPropertiesEXT\">vkGetMemoryHostPointerPropertiesEXT</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryAllocateInfo-allocationSize-01745",
|
|
"text": " If the parameters define an import operation and the external handle is a host pointer, <code>allocationSize</code> <strong class=\"purple\">must</strong> be an integer multiple of <code>VkPhysicalDeviceExternalMemoryHostPropertiesEXT</code>::<code>minImportedHostPointerAlignment</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_external_memory_host)+(VK_NV_dedicated_allocation)": [
|
|
{
|
|
"vuid": "VUID-VkMemoryAllocateInfo-pNext-02805",
|
|
"text": " If the parameters define an import operation and the external handle is a host pointer, the <code>pNext</code> chain <strong class=\"purple\">must</strong> not include a <a href=\"#VkDedicatedAllocationMemoryAllocateInfoNV\">VkDedicatedAllocationMemoryAllocateInfoNV</a> structure with either its <code>image</code> or <code>buffer</code> field set to a value other than <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
}
|
|
],
|
|
"(VK_EXT_external_memory_host)+(VK_KHR_dedicated_allocation)": [
|
|
{
|
|
"vuid": "VUID-VkMemoryAllocateInfo-pNext-02806",
|
|
"text": " If the parameters define an import operation and the external handle is a host pointer, the <code>pNext</code> chain <strong class=\"purple\">must</strong> not include a <a href=\"#VkMemoryDedicatedAllocateInfo\">VkMemoryDedicatedAllocateInfo</a> structure with either its <code>image</code> or <code>buffer</code> field set to a value other than <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
}
|
|
],
|
|
"(VK_ANDROID_external_memory_android_hardware_buffer)": [
|
|
{
|
|
"vuid": "VUID-VkMemoryAllocateInfo-allocationSize-02383",
|
|
"text": " If the parameters define an import operation and the external handle type is <code>VK_EXTERNAL_MEMORY_HANDLE_TYPE_ANDROID_HARDWARE_BUFFER_BIT_ANDROID</code>, <code>allocationSize</code> <strong class=\"purple\">must</strong> be the size returned by <a href=\"#vkGetAndroidHardwareBufferPropertiesANDROID\">vkGetAndroidHardwareBufferPropertiesANDROID</a> for the Android hardware buffer"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryAllocateInfo-pNext-02384",
|
|
"text": " If the parameters define an import operation and the external handle type is <code>VK_EXTERNAL_MEMORY_HANDLE_TYPE_ANDROID_HARDWARE_BUFFER_BIT_ANDROID</code>, and the <code>pNext</code> chain does not include a <a href=\"#VkMemoryDedicatedAllocateInfo\">VkMemoryDedicatedAllocateInfo</a> structure or <a href=\"#VkMemoryDedicatedAllocateInfo\">VkMemoryDedicatedAllocateInfo</a>::<code>image</code> is <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the Android hardware buffer <strong class=\"purple\">must</strong> have a <code>AHardwareBuffer_Desc</code>::<code>format</code> of <code>AHARDWAREBUFFER_FORMAT_BLOB</code> and a <code>AHardwareBuffer_Desc</code>::<code>usage</code> that includes <code>AHARDWAREBUFFER_USAGE_GPU_DATA_BUFFER</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryAllocateInfo-memoryTypeIndex-02385",
|
|
"text": " If the parameters define an import operation and the external handle type is <code>VK_EXTERNAL_MEMORY_HANDLE_TYPE_ANDROID_HARDWARE_BUFFER_BIT_ANDROID</code>, <code>memoryTypeIndex</code> <strong class=\"purple\">must</strong> be one of those returned by <a href=\"#vkGetAndroidHardwareBufferPropertiesANDROID\">vkGetAndroidHardwareBufferPropertiesANDROID</a> for the Android hardware buffer"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryAllocateInfo-pNext-01874",
|
|
"text": " If the parameters do not define an import operation, and the <code>pNext</code> chain includes a <code>VkExportMemoryAllocateInfo</code> structure with <code>VK_EXTERNAL_MEMORY_HANDLE_TYPE_ANDROID_HARDWARE_BUFFER_BIT_ANDROID</code> included in its <code>handleTypes</code> member, and the <code>pNext</code> chain includes a <a href=\"#VkMemoryDedicatedAllocateInfo\">VkMemoryDedicatedAllocateInfo</a> structure with <code>image</code> not equal to <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, then <code>allocationSize</code> <strong class=\"purple\">must</strong> be <code>0</code>, otherwise <code>allocationSize</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryAllocateInfo-pNext-02386",
|
|
"text": " If the parameters define an import operation, the external handle is an Android hardware buffer, and the <code>pNext</code> chain includes a <a href=\"#VkMemoryDedicatedAllocateInfo\">VkMemoryDedicatedAllocateInfo</a> with <code>image</code> that is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the Android hardware buffer’s <code>AHardwareBuffer</code>::<code>usage</code> <strong class=\"purple\">must</strong> include at least one of <code>AHARDWAREBUFFER_USAGE_GPU_FRAMEBUFFER</code>, <code>AHARDWAREBUFFER_USAGE_GPU_SAMPLED_IMAGE</code> or <code>AHARDWAREBUFFER_USAGE_GPU_DATA_BUFFER</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryAllocateInfo-pNext-02387",
|
|
"text": " If the parameters define an import operation, the external handle is an Android hardware buffer, and the <code>pNext</code> chain includes a <a href=\"#VkMemoryDedicatedAllocateInfo\">VkMemoryDedicatedAllocateInfo</a> with <code>image</code> that is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the format of <code>image</code> <strong class=\"purple\">must</strong> be <code>VK_FORMAT_UNDEFINED</code> or the format returned by <a href=\"#vkGetAndroidHardwareBufferPropertiesANDROID\">vkGetAndroidHardwareBufferPropertiesANDROID</a> in <a href=\"#VkAndroidHardwareBufferFormatPropertiesANDROID\">VkAndroidHardwareBufferFormatPropertiesANDROID</a>::<code>format</code> for the Android hardware buffer"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryAllocateInfo-pNext-02388",
|
|
"text": " If the parameters define an import operation, the external handle is an Android hardware buffer, and the <code>pNext</code> chain includes a <a href=\"#VkMemoryDedicatedAllocateInfo\">VkMemoryDedicatedAllocateInfo</a> structure with <code>image</code> that is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the width, height, and array layer dimensions of <code>image</code> and the Android hardware buffer’s <code>AHardwareBuffer_Desc</code> <strong class=\"purple\">must</strong> be identical"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryAllocateInfo-pNext-02389",
|
|
"text": " If the parameters define an import operation, the external handle is an Android hardware buffer, and the <code>pNext</code> chain includes a <a href=\"#VkMemoryDedicatedAllocateInfo\">VkMemoryDedicatedAllocateInfo</a> structure with <code>image</code> that is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the Android hardware buffer’s <code>AHardwareBuffer</code>::<code>usage</code> includes <code>AHARDWAREBUFFER_USAGE_GPU_MIPMAP_COMPLETE</code>, the <code>image</code> <strong class=\"purple\">must</strong> have a complete mipmap chain"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryAllocateInfo-pNext-02586",
|
|
"text": " If the parameters define an import operation, the external handle is an Android hardware buffer, and the <code>pNext</code> chain includes a <a href=\"#VkMemoryDedicatedAllocateInfo\">VkMemoryDedicatedAllocateInfo</a> structure with <code>image</code> that is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the Android hardware buffer’s <code>AHardwareBuffer</code>::<code>usage</code> does not include <code>AHARDWAREBUFFER_USAGE_GPU_MIPMAP_COMPLETE</code>, the <code>image</code> <strong class=\"purple\">must</strong> have exactly one mipmap level"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryAllocateInfo-pNext-02390",
|
|
"text": " If the parameters define an import operation, the external handle is an Android hardware buffer, and the <code>pNext</code> chain includes a <a href=\"#VkMemoryDedicatedAllocateInfo\">VkMemoryDedicatedAllocateInfo</a> structure with <code>image</code> that is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, each bit set in the usage of <code>image</code> <strong class=\"purple\">must</strong> be listed in <a href=\"#memory-external-android-hardware-buffer-usage\">AHardwareBuffer Usage Equivalence</a>, and if there is a corresponding <code>AHARDWAREBUFFER_USAGE</code> bit listed that bit <strong class=\"purple\">must</strong> be included in the Android hardware buffer’s <code>AHardwareBuffer_Desc</code>::<code>usage</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_buffer_device_address)": [
|
|
{
|
|
"vuid": "VUID-VkMemoryAllocateInfo-opaqueCaptureAddress-03329",
|
|
"text": " If <a href=\"#VkMemoryOpaqueCaptureAddressAllocateInfo\">VkMemoryOpaqueCaptureAddressAllocateInfo</a>::<code>opaqueCaptureAddress</code> is not zero, <code>VkMemoryAllocateFlagsInfo</code>::<code>flags</code> <strong class=\"purple\">must</strong> include <code>VK_MEMORY_ALLOCATE_DEVICE_ADDRESS_CAPTURE_REPLAY_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryAllocateInfo-flags-03330",
|
|
"text": " If <code>VkMemoryAllocateFlagsInfo</code>::<code>flags</code> includes <code>VK_MEMORY_ALLOCATE_DEVICE_ADDRESS_CAPTURE_REPLAY_BIT</code>, the <a href=\"#features-bufferDeviceAddressCaptureReplay\"><code>bufferDeviceAddressCaptureReplay</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryAllocateInfo-flags-03331",
|
|
"text": " If <code>VkMemoryAllocateFlagsInfo</code>::<code>flags</code> includes <code>VK_MEMORY_ALLOCATE_DEVICE_ADDRESS_BIT</code>, the <a href=\"#features-bufferDeviceAddress\"><code>bufferDeviceAddress</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryAllocateInfo-opaqueCaptureAddress-03333",
|
|
"text": " If the parameters define an import operation, <a href=\"#VkMemoryOpaqueCaptureAddressAllocateInfo\">VkMemoryOpaqueCaptureAddressAllocateInfo</a>::<code>opaqueCaptureAddress</code> <strong class=\"purple\">must</strong> be zero"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_buffer_device_address)+(VK_EXT_external_memory_host)": [
|
|
{
|
|
"vuid": "VUID-VkMemoryAllocateInfo-pNext-03332",
|
|
"text": " If the <code>pNext</code> chain includes a <code>VkImportMemoryHostPointerInfoEXT</code> structure, <a href=\"#VkMemoryOpaqueCaptureAddressAllocateInfo\">VkMemoryOpaqueCaptureAddressAllocateInfo</a>::<code>opaqueCaptureAddress</code> <strong class=\"purple\">must</strong> be zero"
|
|
}
|
|
],
|
|
"(VK_FUCHSIA_external_memory)": [
|
|
{
|
|
"vuid": "VUID-VkMemoryAllocateInfo-None-04749",
|
|
"text": " If the parameters define an import operation and the external handle type is <code>VK_EXTERNAL_MEMORY_HANDLE_TYPE_ZIRCON_VMO_BIT_FUCHSIA</code>, the value of <code>memoryTypeIndex</code> <strong class=\"purple\">must</strong> be an index identifying a memory type from the <code>memoryTypeBits</code> field of the <a href=\"#VkMemoryZirconHandlePropertiesFUCHSIA\">VkMemoryZirconHandlePropertiesFUCHSIA</a> structure populated by a call to <a href=\"#vkGetMemoryZirconHandlePropertiesFUCHSIA\">vkGetMemoryZirconHandlePropertiesFUCHSIA</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryAllocateInfo-allocationSize-04750",
|
|
"text": " If the parameters define an import operation and the external handle type is <code>VK_EXTERNAL_MEMORY_HANDLE_TYPE_ZIRCON_VMO_BIT_FUCHSIA</code>, the value of <code>allocationSize</code> <strong class=\"purple\">must</strong> be greater than <code>0</code> and <strong class=\"purple\">must</strong> be less than or equal to the size of the VMO as determined by <code>zx_vmo_get_size</code>(<code>handle</code>) where <code>handle</code> is the VMO handle to the imported external memory"
|
|
}
|
|
],
|
|
"(VK_EXT_metal_objects)": [
|
|
{
|
|
"vuid": "VUID-VkMemoryAllocateInfo-pNext-06780",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkExportMetalObjectCreateInfoEXT\">VkExportMetalObjectCreateInfoEXT</a> structure, its <code>exportObjectType</code> member <strong class=\"purple\">must</strong> be <code>VK_EXPORT_METAL_OBJECT_TYPE_METAL_BUFFER_BIT_EXT</code>."
|
|
}
|
|
]
|
|
},
|
|
"VkMemoryDedicatedAllocateInfo": {
|
|
"(VK_VERSION_1_1,VK_KHR_dedicated_allocation)": [
|
|
{
|
|
"vuid": "VUID-VkMemoryDedicatedAllocateInfo-image-01432",
|
|
"text": " At least one of <code>image</code> and <code>buffer</code> <strong class=\"purple\">must</strong> be <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryDedicatedAllocateInfo-image-01434",
|
|
"text": " If <code>image</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>image</code> <strong class=\"purple\">must</strong> have been created without <code>VK_IMAGE_CREATE_SPARSE_BINDING_BIT</code> set in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a>::<code>flags</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryDedicatedAllocateInfo-buffer-01436",
|
|
"text": " If <code>buffer</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>buffer</code> <strong class=\"purple\">must</strong> have been created without <code>VK_BUFFER_CREATE_SPARSE_BINDING_BIT</code> set in <a href=\"#VkBufferCreateInfo\">VkBufferCreateInfo</a>::<code>flags</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryDedicatedAllocateInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_MEMORY_DEDICATED_ALLOCATE_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryDedicatedAllocateInfo-image-parameter",
|
|
"text": " If <code>image</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>image</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImage\">VkImage</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryDedicatedAllocateInfo-buffer-parameter",
|
|
"text": " If <code>buffer</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>buffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBuffer\">VkBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryDedicatedAllocateInfo-commonparent",
|
|
"text": " Both of <code>buffer</code>, and <code>image</code> that are valid handles of non-ignored parameters <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_dedicated_allocation)+!(VK_ANDROID_external_memory_android_hardware_buffer)": [
|
|
{
|
|
"vuid": "VUID-VkMemoryDedicatedAllocateInfo-image-01433",
|
|
"text": " If <code>image</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>VkMemoryAllocateInfo</code>::<code>allocationSize</code> <strong class=\"purple\">must</strong> equal the <code>VkMemoryRequirements</code>::<code>size</code> of the image"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryDedicatedAllocateInfo-buffer-01435",
|
|
"text": " If <code>buffer</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>VkMemoryAllocateInfo</code>::<code>allocationSize</code> <strong class=\"purple\">must</strong> equal the <code>VkMemoryRequirements</code>::<code>size</code> of the buffer"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_dedicated_allocation)+(VK_ANDROID_external_memory_android_hardware_buffer)": [
|
|
{
|
|
"vuid": "VUID-VkMemoryDedicatedAllocateInfo-image-02964",
|
|
"text": " If <code>image</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> and the memory is not an imported Android Hardware Buffer, <code>VkMemoryAllocateInfo</code>::<code>allocationSize</code> <strong class=\"purple\">must</strong> equal the <code>VkMemoryRequirements</code>::<code>size</code> of the image"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryDedicatedAllocateInfo-buffer-02965",
|
|
"text": " If <code>buffer</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> and the memory is not an imported Android Hardware Buffer, <code>VkMemoryAllocateInfo</code>::<code>allocationSize</code> <strong class=\"purple\">must</strong> equal the <code>VkMemoryRequirements</code>::<code>size</code> of the buffer"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_dedicated_allocation)+(VK_KHR_external_memory_win32)": [
|
|
{
|
|
"vuid": "VUID-VkMemoryDedicatedAllocateInfo-image-01876",
|
|
"text": " If <code>image</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> and <a href=\"#VkMemoryAllocateInfo\">VkMemoryAllocateInfo</a> defines a memory import operation with handle type <code>VK_EXTERNAL_MEMORY_HANDLE_TYPE_OPAQUE_WIN32_BIT</code>, <code>VK_EXTERNAL_MEMORY_HANDLE_TYPE_OPAQUE_WIN32_KMT_BIT</code>, <code>VK_EXTERNAL_MEMORY_HANDLE_TYPE_D3D11_TEXTURE_BIT</code>, <code>VK_EXTERNAL_MEMORY_HANDLE_TYPE_D3D11_TEXTURE_KMT_BIT</code>, <code>VK_EXTERNAL_MEMORY_HANDLE_TYPE_D3D12_HEAP_BIT</code>, or <code>VK_EXTERNAL_MEMORY_HANDLE_TYPE_D3D12_RESOURCE_BIT</code>, and the external handle was created by the Vulkan API, then the memory being imported <strong class=\"purple\">must</strong> also be a dedicated image allocation and <code>image</code> must be identical to the image associated with the imported memory"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryDedicatedAllocateInfo-buffer-01877",
|
|
"text": " If <code>buffer</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> and <a href=\"#VkMemoryAllocateInfo\">VkMemoryAllocateInfo</a> defines a memory import operation with handle type <code>VK_EXTERNAL_MEMORY_HANDLE_TYPE_OPAQUE_WIN32_BIT</code>, <code>VK_EXTERNAL_MEMORY_HANDLE_TYPE_OPAQUE_WIN32_KMT_BIT</code>, <code>VK_EXTERNAL_MEMORY_HANDLE_TYPE_D3D11_TEXTURE_BIT</code>, <code>VK_EXTERNAL_MEMORY_HANDLE_TYPE_D3D11_TEXTURE_KMT_BIT</code>, <code>VK_EXTERNAL_MEMORY_HANDLE_TYPE_D3D12_HEAP_BIT</code>, or <code>VK_EXTERNAL_MEMORY_HANDLE_TYPE_D3D12_RESOURCE_BIT</code>, and the external handle was created by the Vulkan API, then the memory being imported <strong class=\"purple\">must</strong> also be a dedicated buffer allocation and <code>buffer</code> <strong class=\"purple\">must</strong> be identical to the buffer associated with the imported memory"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_dedicated_allocation)+(VK_KHR_external_memory_fd)": [
|
|
{
|
|
"vuid": "VUID-VkMemoryDedicatedAllocateInfo-image-01878",
|
|
"text": " If <code>image</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> and <a href=\"#VkMemoryAllocateInfo\">VkMemoryAllocateInfo</a> defines a memory import operation with handle type <code>VK_EXTERNAL_MEMORY_HANDLE_TYPE_OPAQUE_FD_BIT</code>, the memory being imported <strong class=\"purple\">must</strong> also be a dedicated image allocation and <code>image</code> <strong class=\"purple\">must</strong> be identical to the image associated with the imported memory"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryDedicatedAllocateInfo-buffer-01879",
|
|
"text": " If <code>buffer</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> and <a href=\"#VkMemoryAllocateInfo\">VkMemoryAllocateInfo</a> defines a memory import operation with handle type <code>VK_EXTERNAL_MEMORY_HANDLE_TYPE_OPAQUE_FD_BIT</code>, the memory being imported <strong class=\"purple\">must</strong> also be a dedicated buffer allocation and <code>buffer</code> <strong class=\"purple\">must</strong> be identical to the buffer associated with the imported memory"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_dedicated_allocation)+(VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-VkMemoryDedicatedAllocateInfo-image-01797",
|
|
"text": " If <code>image</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>image</code> <strong class=\"purple\">must</strong> not have been created with <code>VK_IMAGE_CREATE_DISJOINT_BIT</code> set in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a>::<code>flags</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_dedicated_allocation)+(VK_FUCHSIA_external_memory)": [
|
|
{
|
|
"vuid": "VUID-VkMemoryDedicatedAllocateInfo-image-04751",
|
|
"text": " If <code>image</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> and <a href=\"#VkMemoryAllocateInfo\">VkMemoryAllocateInfo</a> defines a memory import operation with handle type <code>VK_EXTERNAL_MEMORY_HANDLE_TYPE_ZIRCON_VMO_BIT_FUCHSIA</code>, the memory being imported <strong class=\"purple\">must</strong> also be a dedicated image allocation and <code>image</code> <strong class=\"purple\">must</strong> be identical to the image associated with the imported memory"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryDedicatedAllocateInfo-buffer-04752",
|
|
"text": " If <code>buffer</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> and <a href=\"#VkMemoryAllocateInfo\">VkMemoryAllocateInfo</a> defines a memory import operation with handle type <code>VK_EXTERNAL_MEMORY_HANDLE_TYPE_ZIRCON_VMO_BIT_FUCHSIA</code>, the memory being imported <strong class=\"purple\">must</strong> also be a dedicated buffer allocation and <code>buffer</code> <strong class=\"purple\">must</strong> be identical to the buffer associated with the imported memory"
|
|
}
|
|
]
|
|
},
|
|
"VkDedicatedAllocationMemoryAllocateInfoNV": {
|
|
"(VK_NV_dedicated_allocation)": [
|
|
{
|
|
"vuid": "VUID-VkDedicatedAllocationMemoryAllocateInfoNV-image-00649",
|
|
"text": " At least one of <code>image</code> and <code>buffer</code> <strong class=\"purple\">must</strong> be <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDedicatedAllocationMemoryAllocateInfoNV-image-00650",
|
|
"text": " If <code>image</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the image <strong class=\"purple\">must</strong> have been created with <a href=\"#VkDedicatedAllocationImageCreateInfoNV\">VkDedicatedAllocationImageCreateInfoNV</a>::<code>dedicatedAllocation</code> equal to <code>VK_TRUE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDedicatedAllocationMemoryAllocateInfoNV-buffer-00651",
|
|
"text": " If <code>buffer</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the buffer <strong class=\"purple\">must</strong> have been created with <a href=\"#VkDedicatedAllocationBufferCreateInfoNV\">VkDedicatedAllocationBufferCreateInfoNV</a>::<code>dedicatedAllocation</code> equal to <code>VK_TRUE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDedicatedAllocationMemoryAllocateInfoNV-image-00652",
|
|
"text": " If <code>image</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>VkMemoryAllocateInfo</code>::<code>allocationSize</code> <strong class=\"purple\">must</strong> equal the <code>VkMemoryRequirements</code>::<code>size</code> of the image"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDedicatedAllocationMemoryAllocateInfoNV-buffer-00653",
|
|
"text": " If <code>buffer</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>VkMemoryAllocateInfo</code>::<code>allocationSize</code> <strong class=\"purple\">must</strong> equal the <code>VkMemoryRequirements</code>::<code>size</code> of the buffer"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDedicatedAllocationMemoryAllocateInfoNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_DEDICATED_ALLOCATION_MEMORY_ALLOCATE_INFO_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDedicatedAllocationMemoryAllocateInfoNV-image-parameter",
|
|
"text": " If <code>image</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>image</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImage\">VkImage</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDedicatedAllocationMemoryAllocateInfoNV-buffer-parameter",
|
|
"text": " If <code>buffer</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>buffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBuffer\">VkBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDedicatedAllocationMemoryAllocateInfoNV-commonparent",
|
|
"text": " Both of <code>buffer</code>, and <code>image</code> that are valid handles of non-ignored parameters <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"(VK_NV_dedicated_allocation)+(VK_KHR_external_memory_win32,VK_KHR_external_memory_fd)": [
|
|
{
|
|
"vuid": "VUID-VkDedicatedAllocationMemoryAllocateInfoNV-image-00654",
|
|
"text": " If <code>image</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> and <a href=\"#VkMemoryAllocateInfo\">VkMemoryAllocateInfo</a> defines a memory import operation, the memory being imported <strong class=\"purple\">must</strong> also be a dedicated image allocation and <code>image</code> <strong class=\"purple\">must</strong> be identical to the image associated with the imported memory"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDedicatedAllocationMemoryAllocateInfoNV-buffer-00655",
|
|
"text": " If <code>buffer</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> and <a href=\"#VkMemoryAllocateInfo\">VkMemoryAllocateInfo</a> defines a memory import operation, the memory being imported <strong class=\"purple\">must</strong> also be a dedicated buffer allocation and <code>buffer</code> <strong class=\"purple\">must</strong> be identical to the buffer associated with the imported memory"
|
|
}
|
|
]
|
|
},
|
|
"VkMemoryPriorityAllocateInfoEXT": {
|
|
"(VK_EXT_memory_priority)": [
|
|
{
|
|
"vuid": "VUID-VkMemoryPriorityAllocateInfoEXT-priority-02602",
|
|
"text": " <code>priority</code> <strong class=\"purple\">must</strong> be between <code>0</code> and <code>1</code>, inclusive"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryPriorityAllocateInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_MEMORY_PRIORITY_ALLOCATE_INFO_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkSetDeviceMemoryPriorityEXT": {
|
|
"(VK_EXT_pageable_device_local_memory)": [
|
|
{
|
|
"vuid": "VUID-vkSetDeviceMemoryPriorityEXT-priority-06258",
|
|
"text": " <code>priority</code> <strong class=\"purple\">must</strong> be between <code>0</code> and <code>1</code>, inclusive"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkSetDeviceMemoryPriorityEXT-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkSetDeviceMemoryPriorityEXT-memory-parameter",
|
|
"text": " <code>memory</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDeviceMemory\">VkDeviceMemory</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkSetDeviceMemoryPriorityEXT-memory-parent",
|
|
"text": " <code>memory</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkExportMemoryAllocateInfo": {
|
|
"(VK_VERSION_1_1,VK_KHR_external_memory)": [
|
|
{
|
|
"vuid": "VUID-VkExportMemoryAllocateInfo-handleTypes-00656",
|
|
"text": " The bits in <code>handleTypes</code> <strong class=\"purple\">must</strong> be supported and compatible, as reported by <a href=\"#VkExternalImageFormatProperties\">VkExternalImageFormatProperties</a> or <a href=\"#VkExternalBufferProperties\">VkExternalBufferProperties</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkExportMemoryAllocateInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_EXPORT_MEMORY_ALLOCATE_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkExportMemoryAllocateInfo-handleTypes-parameter",
|
|
"text": " <code>handleTypes</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkExternalMemoryHandleTypeFlagBits\">VkExternalMemoryHandleTypeFlagBits</a> values"
|
|
}
|
|
]
|
|
},
|
|
"VkExportMemoryAllocateInfoNV": {
|
|
"(VK_NV_external_memory)": [
|
|
{
|
|
"vuid": "VUID-VkExportMemoryAllocateInfoNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_EXPORT_MEMORY_ALLOCATE_INFO_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkExportMemoryAllocateInfoNV-handleTypes-parameter",
|
|
"text": " <code>handleTypes</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkExternalMemoryHandleTypeFlagBitsNV\">VkExternalMemoryHandleTypeFlagBitsNV</a> values"
|
|
}
|
|
]
|
|
},
|
|
"VkExportMemoryWin32HandleInfoKHR": {
|
|
"(VK_KHR_external_memory_win32)": [
|
|
{
|
|
"vuid": "VUID-VkExportMemoryWin32HandleInfoKHR-handleTypes-00657",
|
|
"text": " If <a href=\"#VkExportMemoryAllocateInfo\">VkExportMemoryAllocateInfo</a>::<code>handleTypes</code> does not include <code>VK_EXTERNAL_MEMORY_HANDLE_TYPE_OPAQUE_WIN32_BIT</code>, a <code>VkExportMemoryWin32HandleInfoKHR</code> structure <strong class=\"purple\">must</strong> not be included in the <code>pNext</code> chain of <a href=\"#VkMemoryAllocateInfo\">VkMemoryAllocateInfo</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkExportMemoryWin32HandleInfoKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_EXPORT_MEMORY_WIN32_HANDLE_INFO_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkExportMemoryWin32HandleInfoKHR-pAttributes-parameter",
|
|
"text": " If <code>pAttributes</code> is not <code>NULL</code>, <code>pAttributes</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <code>SECURITY_ATTRIBUTES</code> value"
|
|
}
|
|
]
|
|
},
|
|
"VkImportMemoryWin32HandleInfoKHR": {
|
|
"(VK_KHR_external_memory_win32)": [
|
|
{
|
|
"vuid": "VUID-VkImportMemoryWin32HandleInfoKHR-handleType-00658",
|
|
"text": " If <code>handleType</code> is not <code>0</code>, it <strong class=\"purple\">must</strong> be supported for import, as reported by <a href=\"#VkExternalImageFormatProperties\">VkExternalImageFormatProperties</a> or <a href=\"#VkExternalBufferProperties\">VkExternalBufferProperties</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportMemoryWin32HandleInfoKHR-handle-00659",
|
|
"text": " The memory from which <code>handle</code> was exported, or the memory named by <code>name</code> <strong class=\"purple\">must</strong> have been created on the same underlying physical device as <code>device</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportMemoryWin32HandleInfoKHR-handleType-00660",
|
|
"text": " If <code>handleType</code> is not <code>0</code>, it <strong class=\"purple\">must</strong> be defined as an NT handle or a global share handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportMemoryWin32HandleInfoKHR-handleType-01439",
|
|
"text": " If <code>handleType</code> is not <code>VK_EXTERNAL_MEMORY_HANDLE_TYPE_OPAQUE_WIN32_BIT</code>, <code>VK_EXTERNAL_MEMORY_HANDLE_TYPE_D3D11_TEXTURE_BIT</code>, <code>VK_EXTERNAL_MEMORY_HANDLE_TYPE_D3D12_HEAP_BIT</code>, or <code>VK_EXTERNAL_MEMORY_HANDLE_TYPE_D3D12_RESOURCE_BIT</code>, <code>name</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportMemoryWin32HandleInfoKHR-handleType-01440",
|
|
"text": " If <code>handleType</code> is not <code>0</code> and <code>handle</code> is <code>NULL</code>, <code>name</code> <strong class=\"purple\">must</strong> name a valid memory resource of the type specified by <code>handleType</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportMemoryWin32HandleInfoKHR-handleType-00661",
|
|
"text": " If <code>handleType</code> is not <code>0</code> and <code>name</code> is <code>NULL</code>, <code>handle</code> <strong class=\"purple\">must</strong> be a valid handle of the type specified by <code>handleType</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportMemoryWin32HandleInfoKHR-handle-01441",
|
|
"text": " if <code>handle</code> is not <code>NULL</code>, <code>name</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportMemoryWin32HandleInfoKHR-handle-01518",
|
|
"text": " If <code>handle</code> is not <code>NULL</code>, it <strong class=\"purple\">must</strong> obey any requirements listed for <code>handleType</code> in <a href=\"#external-memory-handle-types-compatibility\">external memory handle types compatibility</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportMemoryWin32HandleInfoKHR-name-01519",
|
|
"text": " If <code>name</code> is not <code>NULL</code>, it <strong class=\"purple\">must</strong> obey any requirements listed for <code>handleType</code> in <a href=\"#external-memory-handle-types-compatibility\">external memory handle types compatibility</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportMemoryWin32HandleInfoKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_IMPORT_MEMORY_WIN32_HANDLE_INFO_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportMemoryWin32HandleInfoKHR-handleType-parameter",
|
|
"text": " If <code>handleType</code> is not <code>0</code>, <code>handleType</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkExternalMemoryHandleTypeFlagBits\">VkExternalMemoryHandleTypeFlagBits</a> value"
|
|
}
|
|
]
|
|
},
|
|
"vkGetMemoryWin32HandleKHR": {
|
|
"(VK_KHR_external_memory_win32)": [
|
|
{
|
|
"vuid": "VUID-vkGetMemoryWin32HandleKHR-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetMemoryWin32HandleKHR-pGetWin32HandleInfo-parameter",
|
|
"text": " <code>pGetWin32HandleInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkMemoryGetWin32HandleInfoKHR\">VkMemoryGetWin32HandleInfoKHR</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetMemoryWin32HandleKHR-pHandle-parameter",
|
|
"text": " <code>pHandle</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>HANDLE</code> value"
|
|
}
|
|
]
|
|
},
|
|
"VkMemoryGetWin32HandleInfoKHR": {
|
|
"(VK_KHR_external_memory_win32)": [
|
|
{
|
|
"vuid": "VUID-VkMemoryGetWin32HandleInfoKHR-handleType-00662",
|
|
"text": " <code>handleType</code> <strong class=\"purple\">must</strong> have been included in <a href=\"#VkExportMemoryAllocateInfo\">VkExportMemoryAllocateInfo</a>::<code>handleTypes</code> when <code>memory</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryGetWin32HandleInfoKHR-handleType-00663",
|
|
"text": " If <code>handleType</code> is defined as an NT handle, <a href=\"#vkGetMemoryWin32HandleKHR\">vkGetMemoryWin32HandleKHR</a> <strong class=\"purple\">must</strong> be called no more than once for each valid unique combination of <code>memory</code> and <code>handleType</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryGetWin32HandleInfoKHR-handleType-00664",
|
|
"text": " <code>handleType</code> <strong class=\"purple\">must</strong> be defined as an NT handle or a global share handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryGetWin32HandleInfoKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_MEMORY_GET_WIN32_HANDLE_INFO_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryGetWin32HandleInfoKHR-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryGetWin32HandleInfoKHR-memory-parameter",
|
|
"text": " <code>memory</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDeviceMemory\">VkDeviceMemory</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryGetWin32HandleInfoKHR-handleType-parameter",
|
|
"text": " <code>handleType</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkExternalMemoryHandleTypeFlagBits\">VkExternalMemoryHandleTypeFlagBits</a> value"
|
|
}
|
|
]
|
|
},
|
|
"vkGetMemoryWin32HandlePropertiesKHR": {
|
|
"(VK_KHR_external_memory_win32)": [
|
|
{
|
|
"vuid": "VUID-vkGetMemoryWin32HandlePropertiesKHR-handle-00665",
|
|
"text": " <code>handle</code> <strong class=\"purple\">must</strong> be an external memory handle created outside of the Vulkan API"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetMemoryWin32HandlePropertiesKHR-handleType-00666",
|
|
"text": " <code>handleType</code> <strong class=\"purple\">must</strong> not be one of the handle types defined as opaque"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetMemoryWin32HandlePropertiesKHR-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetMemoryWin32HandlePropertiesKHR-handleType-parameter",
|
|
"text": " <code>handleType</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkExternalMemoryHandleTypeFlagBits\">VkExternalMemoryHandleTypeFlagBits</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetMemoryWin32HandlePropertiesKHR-pMemoryWin32HandleProperties-parameter",
|
|
"text": " <code>pMemoryWin32HandleProperties</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkMemoryWin32HandlePropertiesKHR\">VkMemoryWin32HandlePropertiesKHR</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkMemoryWin32HandlePropertiesKHR": {
|
|
"(VK_KHR_external_memory_win32)": [
|
|
{
|
|
"vuid": "VUID-VkMemoryWin32HandlePropertiesKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_MEMORY_WIN32_HANDLE_PROPERTIES_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryWin32HandlePropertiesKHR-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkExportMemoryWin32HandleInfoNV": {
|
|
"(VK_NV_external_memory_win32)": [
|
|
{
|
|
"vuid": "VUID-VkExportMemoryWin32HandleInfoNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_EXPORT_MEMORY_WIN32_HANDLE_INFO_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkExportMemoryWin32HandleInfoNV-pAttributes-parameter",
|
|
"text": " If <code>pAttributes</code> is not <code>NULL</code>, <code>pAttributes</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <code>SECURITY_ATTRIBUTES</code> value"
|
|
}
|
|
]
|
|
},
|
|
"VkImportMemoryWin32HandleInfoNV": {
|
|
"(VK_NV_external_memory_win32)": [
|
|
{
|
|
"vuid": "VUID-VkImportMemoryWin32HandleInfoNV-handleType-01327",
|
|
"text": " <code>handleType</code> <strong class=\"purple\">must</strong> not have more than one bit set"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportMemoryWin32HandleInfoNV-handle-01328",
|
|
"text": " <code>handle</code> <strong class=\"purple\">must</strong> be a valid handle to memory, obtained as specified by <code>handleType</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportMemoryWin32HandleInfoNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_IMPORT_MEMORY_WIN32_HANDLE_INFO_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportMemoryWin32HandleInfoNV-handleType-parameter",
|
|
"text": " <code>handleType</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkExternalMemoryHandleTypeFlagBitsNV\">VkExternalMemoryHandleTypeFlagBitsNV</a> values"
|
|
}
|
|
]
|
|
},
|
|
"vkGetMemoryWin32HandleNV": {
|
|
"(VK_NV_external_memory_win32)": [
|
|
{
|
|
"vuid": "VUID-vkGetMemoryWin32HandleNV-handleType-01326",
|
|
"text": " <code>handleType</code> <strong class=\"purple\">must</strong> be a flag specified in <a href=\"#VkExportMemoryAllocateInfoNV\">VkExportMemoryAllocateInfoNV</a>::<code>handleTypes</code> when allocating <code>memory</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetMemoryWin32HandleNV-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetMemoryWin32HandleNV-memory-parameter",
|
|
"text": " <code>memory</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDeviceMemory\">VkDeviceMemory</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetMemoryWin32HandleNV-handleType-parameter",
|
|
"text": " <code>handleType</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkExternalMemoryHandleTypeFlagBitsNV\">VkExternalMemoryHandleTypeFlagBitsNV</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetMemoryWin32HandleNV-handleType-requiredbitmask",
|
|
"text": " <code>handleType</code> <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetMemoryWin32HandleNV-pHandle-parameter",
|
|
"text": " <code>pHandle</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>HANDLE</code> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetMemoryWin32HandleNV-memory-parent",
|
|
"text": " <code>memory</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkImportMemoryFdInfoKHR": {
|
|
"(VK_KHR_external_memory_fd)": [
|
|
{
|
|
"vuid": "VUID-VkImportMemoryFdInfoKHR-handleType-00667",
|
|
"text": " If <code>handleType</code> is not <code>0</code>, it <strong class=\"purple\">must</strong> be supported for import, as reported by <a href=\"#VkExternalImageFormatProperties\">VkExternalImageFormatProperties</a> or <a href=\"#VkExternalBufferProperties\">VkExternalBufferProperties</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportMemoryFdInfoKHR-fd-00668",
|
|
"text": " The memory from which <code>fd</code> was exported <strong class=\"purple\">must</strong> have been created on the same underlying physical device as <code>device</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportMemoryFdInfoKHR-handleType-00669",
|
|
"text": " If <code>handleType</code> is not <code>0</code>, it <strong class=\"purple\">must</strong> be <code>VK_EXTERNAL_MEMORY_HANDLE_TYPE_OPAQUE_FD_BIT</code> or <code>VK_EXTERNAL_MEMORY_HANDLE_TYPE_DMA_BUF_BIT_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportMemoryFdInfoKHR-handleType-00670",
|
|
"text": " If <code>handleType</code> is not <code>0</code>, <code>fd</code> <strong class=\"purple\">must</strong> be a valid handle of the type specified by <code>handleType</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportMemoryFdInfoKHR-fd-01746",
|
|
"text": " The memory represented by <code>fd</code> <strong class=\"purple\">must</strong> have been created from a physical device and driver that is compatible with <code>device</code> and <code>handleType</code>, as described in <a href=\"#external-memory-handle-types-compatibility\">External memory handle types compatibility</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportMemoryFdInfoKHR-fd-01520",
|
|
"text": " <code>fd</code> <strong class=\"purple\">must</strong> obey any requirements listed for <code>handleType</code> in <a href=\"#external-memory-handle-types-compatibility\">external memory handle types compatibility</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportMemoryFdInfoKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_IMPORT_MEMORY_FD_INFO_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportMemoryFdInfoKHR-handleType-parameter",
|
|
"text": " If <code>handleType</code> is not <code>0</code>, <code>handleType</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkExternalMemoryHandleTypeFlagBits\">VkExternalMemoryHandleTypeFlagBits</a> value"
|
|
}
|
|
]
|
|
},
|
|
"vkGetMemoryFdKHR": {
|
|
"(VK_KHR_external_memory_fd)": [
|
|
{
|
|
"vuid": "VUID-vkGetMemoryFdKHR-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetMemoryFdKHR-pGetFdInfo-parameter",
|
|
"text": " <code>pGetFdInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkMemoryGetFdInfoKHR\">VkMemoryGetFdInfoKHR</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetMemoryFdKHR-pFd-parameter",
|
|
"text": " <code>pFd</code> <strong class=\"purple\">must</strong> be a valid pointer to an <code>int</code> value"
|
|
}
|
|
]
|
|
},
|
|
"VkMemoryGetFdInfoKHR": {
|
|
"(VK_KHR_external_memory_fd)": [
|
|
{
|
|
"vuid": "VUID-VkMemoryGetFdInfoKHR-handleType-00671",
|
|
"text": " <code>handleType</code> <strong class=\"purple\">must</strong> have been included in <a href=\"#VkExportMemoryAllocateInfo\">VkExportMemoryAllocateInfo</a>::<code>handleTypes</code> when <code>memory</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryGetFdInfoKHR-handleType-00672",
|
|
"text": " <code>handleType</code> <strong class=\"purple\">must</strong> be <code>VK_EXTERNAL_MEMORY_HANDLE_TYPE_OPAQUE_FD_BIT</code> or <code>VK_EXTERNAL_MEMORY_HANDLE_TYPE_DMA_BUF_BIT_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryGetFdInfoKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_MEMORY_GET_FD_INFO_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryGetFdInfoKHR-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryGetFdInfoKHR-memory-parameter",
|
|
"text": " <code>memory</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDeviceMemory\">VkDeviceMemory</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryGetFdInfoKHR-handleType-parameter",
|
|
"text": " <code>handleType</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkExternalMemoryHandleTypeFlagBits\">VkExternalMemoryHandleTypeFlagBits</a> value"
|
|
}
|
|
]
|
|
},
|
|
"vkGetMemoryFdPropertiesKHR": {
|
|
"(VK_KHR_external_memory_fd)": [
|
|
{
|
|
"vuid": "VUID-vkGetMemoryFdPropertiesKHR-fd-00673",
|
|
"text": " <code>fd</code> <strong class=\"purple\">must</strong> be an external memory handle created outside of the Vulkan API"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetMemoryFdPropertiesKHR-handleType-00674",
|
|
"text": " <code>handleType</code> <strong class=\"purple\">must</strong> not be <code>VK_EXTERNAL_MEMORY_HANDLE_TYPE_OPAQUE_FD_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetMemoryFdPropertiesKHR-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetMemoryFdPropertiesKHR-handleType-parameter",
|
|
"text": " <code>handleType</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkExternalMemoryHandleTypeFlagBits\">VkExternalMemoryHandleTypeFlagBits</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetMemoryFdPropertiesKHR-pMemoryFdProperties-parameter",
|
|
"text": " <code>pMemoryFdProperties</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkMemoryFdPropertiesKHR\">VkMemoryFdPropertiesKHR</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkMemoryFdPropertiesKHR": {
|
|
"(VK_KHR_external_memory_fd)": [
|
|
{
|
|
"vuid": "VUID-VkMemoryFdPropertiesKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_MEMORY_FD_PROPERTIES_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryFdPropertiesKHR-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkImportMemoryHostPointerInfoEXT": {
|
|
"(VK_EXT_external_memory_host)": [
|
|
{
|
|
"vuid": "VUID-VkImportMemoryHostPointerInfoEXT-handleType-01747",
|
|
"text": " If <code>handleType</code> is not <code>0</code>, it <strong class=\"purple\">must</strong> be supported for import, as reported in <a href=\"#VkExternalMemoryProperties\">VkExternalMemoryProperties</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportMemoryHostPointerInfoEXT-handleType-01748",
|
|
"text": " If <code>handleType</code> is not <code>0</code>, it <strong class=\"purple\">must</strong> be <code>VK_EXTERNAL_MEMORY_HANDLE_TYPE_HOST_ALLOCATION_BIT_EXT</code> or <code>VK_EXTERNAL_MEMORY_HANDLE_TYPE_HOST_MAPPED_FOREIGN_MEMORY_BIT_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportMemoryHostPointerInfoEXT-pHostPointer-01749",
|
|
"text": " <code>pHostPointer</code> <strong class=\"purple\">must</strong> be a pointer aligned to an integer multiple of <code>VkPhysicalDeviceExternalMemoryHostPropertiesEXT</code>::<code>minImportedHostPointerAlignment</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportMemoryHostPointerInfoEXT-handleType-01750",
|
|
"text": " If <code>handleType</code> is <code>VK_EXTERNAL_MEMORY_HANDLE_TYPE_HOST_ALLOCATION_BIT_EXT</code>, <code>pHostPointer</code> <strong class=\"purple\">must</strong> be a pointer to <code>allocationSize</code> number of bytes of host memory, where <code>allocationSize</code> is the member of the <code>VkMemoryAllocateInfo</code> structure this structure is chained to"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportMemoryHostPointerInfoEXT-handleType-01751",
|
|
"text": " If <code>handleType</code> is <code>VK_EXTERNAL_MEMORY_HANDLE_TYPE_HOST_MAPPED_FOREIGN_MEMORY_BIT_EXT</code>, <code>pHostPointer</code> <strong class=\"purple\">must</strong> be a pointer to <code>allocationSize</code> number of bytes of host mapped foreign memory, where <code>allocationSize</code> is the member of the <code>VkMemoryAllocateInfo</code> structure this structure is chained to"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportMemoryHostPointerInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_IMPORT_MEMORY_HOST_POINTER_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportMemoryHostPointerInfoEXT-handleType-parameter",
|
|
"text": " <code>handleType</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkExternalMemoryHandleTypeFlagBits\">VkExternalMemoryHandleTypeFlagBits</a> value"
|
|
}
|
|
]
|
|
},
|
|
"vkGetMemoryHostPointerPropertiesEXT": {
|
|
"(VK_EXT_external_memory_host)": [
|
|
{
|
|
"vuid": "VUID-vkGetMemoryHostPointerPropertiesEXT-handleType-01752",
|
|
"text": " <code>handleType</code> <strong class=\"purple\">must</strong> be <code>VK_EXTERNAL_MEMORY_HANDLE_TYPE_HOST_ALLOCATION_BIT_EXT</code> or <code>VK_EXTERNAL_MEMORY_HANDLE_TYPE_HOST_MAPPED_FOREIGN_MEMORY_BIT_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetMemoryHostPointerPropertiesEXT-pHostPointer-01753",
|
|
"text": " <code>pHostPointer</code> <strong class=\"purple\">must</strong> be a pointer aligned to an integer multiple of <code>VkPhysicalDeviceExternalMemoryHostPropertiesEXT</code>::<code>minImportedHostPointerAlignment</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetMemoryHostPointerPropertiesEXT-handleType-01754",
|
|
"text": " If <code>handleType</code> is <code>VK_EXTERNAL_MEMORY_HANDLE_TYPE_HOST_ALLOCATION_BIT_EXT</code>, <code>pHostPointer</code> <strong class=\"purple\">must</strong> be a pointer to host memory"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetMemoryHostPointerPropertiesEXT-handleType-01755",
|
|
"text": " If <code>handleType</code> is <code>VK_EXTERNAL_MEMORY_HANDLE_TYPE_HOST_MAPPED_FOREIGN_MEMORY_BIT_EXT</code>, <code>pHostPointer</code> <strong class=\"purple\">must</strong> be a pointer to host mapped foreign memory"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetMemoryHostPointerPropertiesEXT-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetMemoryHostPointerPropertiesEXT-handleType-parameter",
|
|
"text": " <code>handleType</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkExternalMemoryHandleTypeFlagBits\">VkExternalMemoryHandleTypeFlagBits</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetMemoryHostPointerPropertiesEXT-pMemoryHostPointerProperties-parameter",
|
|
"text": " <code>pMemoryHostPointerProperties</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkMemoryHostPointerPropertiesEXT\">VkMemoryHostPointerPropertiesEXT</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkMemoryHostPointerPropertiesEXT": {
|
|
"(VK_EXT_external_memory_host)": [
|
|
{
|
|
"vuid": "VUID-VkMemoryHostPointerPropertiesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_MEMORY_HOST_POINTER_PROPERTIES_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryHostPointerPropertiesEXT-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkImportAndroidHardwareBufferInfoANDROID": {
|
|
"(VK_ANDROID_external_memory_android_hardware_buffer)": [
|
|
{
|
|
"vuid": "VUID-VkImportAndroidHardwareBufferInfoANDROID-buffer-01880",
|
|
"text": " If <code>buffer</code> is not <code>NULL</code>, Android hardware buffers <strong class=\"purple\">must</strong> be supported for import, as reported by <a href=\"#VkExternalImageFormatProperties\">VkExternalImageFormatProperties</a> or <a href=\"#VkExternalBufferProperties\">VkExternalBufferProperties</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportAndroidHardwareBufferInfoANDROID-buffer-01881",
|
|
"text": " If <code>buffer</code> is not <code>NULL</code>, it <strong class=\"purple\">must</strong> be a valid Android hardware buffer object with <code>AHardwareBuffer_Desc</code>::<code>usage</code> compatible with Vulkan as described in <a href=\"#memory-external-android-hardware-buffer\">Android Hardware Buffers</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportAndroidHardwareBufferInfoANDROID-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_IMPORT_ANDROID_HARDWARE_BUFFER_INFO_ANDROID</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportAndroidHardwareBufferInfoANDROID-buffer-parameter",
|
|
"text": " <code>buffer</code> <strong class=\"purple\">must</strong> be a valid pointer to an <code>AHardwareBuffer</code> value"
|
|
}
|
|
]
|
|
},
|
|
"vkGetMemoryAndroidHardwareBufferANDROID": {
|
|
"(VK_ANDROID_external_memory_android_hardware_buffer)": [
|
|
{
|
|
"vuid": "VUID-vkGetMemoryAndroidHardwareBufferANDROID-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetMemoryAndroidHardwareBufferANDROID-pInfo-parameter",
|
|
"text": " <code>pInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkMemoryGetAndroidHardwareBufferInfoANDROID\">VkMemoryGetAndroidHardwareBufferInfoANDROID</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetMemoryAndroidHardwareBufferANDROID-pBuffer-parameter",
|
|
"text": " <code>pBuffer</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid pointer to an <code>AHardwareBuffer</code> value"
|
|
}
|
|
]
|
|
},
|
|
"VkMemoryGetAndroidHardwareBufferInfoANDROID": {
|
|
"(VK_ANDROID_external_memory_android_hardware_buffer)": [
|
|
{
|
|
"vuid": "VUID-VkMemoryGetAndroidHardwareBufferInfoANDROID-handleTypes-01882",
|
|
"text": " <code>VK_EXTERNAL_MEMORY_HANDLE_TYPE_ANDROID_HARDWARE_BUFFER_BIT_ANDROID</code> <strong class=\"purple\">must</strong> have been included in <a href=\"#VkExportMemoryAllocateInfo\">VkExportMemoryAllocateInfo</a>::<code>handleTypes</code> when <code>memory</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryGetAndroidHardwareBufferInfoANDROID-pNext-01883",
|
|
"text": " If the <code>pNext</code> chain of the <a href=\"#VkMemoryAllocateInfo\">VkMemoryAllocateInfo</a> used to allocate <code>memory</code> included a <a href=\"#VkMemoryDedicatedAllocateInfo\">VkMemoryDedicatedAllocateInfo</a> with non-<code>NULL</code> <code>image</code> member, then that <code>image</code> <strong class=\"purple\">must</strong> already be bound to <code>memory</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryGetAndroidHardwareBufferInfoANDROID-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_MEMORY_GET_ANDROID_HARDWARE_BUFFER_INFO_ANDROID</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryGetAndroidHardwareBufferInfoANDROID-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryGetAndroidHardwareBufferInfoANDROID-memory-parameter",
|
|
"text": " <code>memory</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDeviceMemory\">VkDeviceMemory</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"vkGetAndroidHardwareBufferPropertiesANDROID": {
|
|
"(VK_ANDROID_external_memory_android_hardware_buffer)": [
|
|
{
|
|
"vuid": "VUID-vkGetAndroidHardwareBufferPropertiesANDROID-buffer-01884",
|
|
"text": " <code>buffer</code> <strong class=\"purple\">must</strong> be a valid Android hardware buffer object with at least one of the <code>AHARDWAREBUFFER_USAGE_GPU_*</code> flags in its <code>AHardwareBuffer_Desc</code>::<code>usage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetAndroidHardwareBufferPropertiesANDROID-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetAndroidHardwareBufferPropertiesANDROID-buffer-parameter",
|
|
"text": " <code>buffer</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <code>AHardwareBuffer</code> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetAndroidHardwareBufferPropertiesANDROID-pProperties-parameter",
|
|
"text": " <code>pProperties</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkAndroidHardwareBufferPropertiesANDROID\">VkAndroidHardwareBufferPropertiesANDROID</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkAndroidHardwareBufferPropertiesANDROID": {
|
|
"(VK_ANDROID_external_memory_android_hardware_buffer)": [
|
|
{
|
|
"vuid": "VUID-VkAndroidHardwareBufferPropertiesANDROID-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_ANDROID_HARDWARE_BUFFER_PROPERTIES_ANDROID</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAndroidHardwareBufferPropertiesANDROID-pNext-pNext",
|
|
"text": " Each <code>pNext</code> member of any structure (including this one) in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be either <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkAndroidHardwareBufferFormatProperties2ANDROID\">VkAndroidHardwareBufferFormatProperties2ANDROID</a> or <a href=\"#VkAndroidHardwareBufferFormatPropertiesANDROID\">VkAndroidHardwareBufferFormatPropertiesANDROID</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAndroidHardwareBufferPropertiesANDROID-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
}
|
|
]
|
|
},
|
|
"VkAndroidHardwareBufferFormatPropertiesANDROID": {
|
|
"(VK_ANDROID_external_memory_android_hardware_buffer)": [
|
|
{
|
|
"vuid": "VUID-VkAndroidHardwareBufferFormatPropertiesANDROID-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_ANDROID_HARDWARE_BUFFER_FORMAT_PROPERTIES_ANDROID</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkAndroidHardwareBufferFormatProperties2ANDROID": {
|
|
"(VK_ANDROID_external_memory_android_hardware_buffer)+(VK_VERSION_1_3,VK_KHR_format_feature_flags2)": [
|
|
{
|
|
"vuid": "VUID-VkAndroidHardwareBufferFormatProperties2ANDROID-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_ANDROID_HARDWARE_BUFFER_FORMAT_PROPERTIES_2_ANDROID</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetMemoryRemoteAddressNV": {
|
|
"(VK_NV_external_memory_rdma)": [
|
|
{
|
|
"vuid": "VUID-vkGetMemoryRemoteAddressNV-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetMemoryRemoteAddressNV-pMemoryGetRemoteAddressInfo-parameter",
|
|
"text": " <code>pMemoryGetRemoteAddressInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkMemoryGetRemoteAddressInfoNV\">VkMemoryGetRemoteAddressInfoNV</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetMemoryRemoteAddressNV-pAddress-parameter",
|
|
"text": " <code>pAddress</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>VkRemoteAddressNV</code> value"
|
|
}
|
|
]
|
|
},
|
|
"VkMemoryGetRemoteAddressInfoNV": {
|
|
"(VK_NV_external_memory_rdma)": [
|
|
{
|
|
"vuid": "VUID-VkMemoryGetRemoteAddressInfoNV-handleType-04966",
|
|
"text": " <code>handleType</code> <strong class=\"purple\">must</strong> have been included in <a href=\"#VkExportMemoryAllocateInfo\">VkExportMemoryAllocateInfo</a>::<code>handleTypes</code> when <code>memory</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryGetRemoteAddressInfoNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_MEMORY_GET_REMOTE_ADDRESS_INFO_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryGetRemoteAddressInfoNV-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryGetRemoteAddressInfoNV-memory-parameter",
|
|
"text": " <code>memory</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDeviceMemory\">VkDeviceMemory</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryGetRemoteAddressInfoNV-handleType-parameter",
|
|
"text": " <code>handleType</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkExternalMemoryHandleTypeFlagBits\">VkExternalMemoryHandleTypeFlagBits</a> value"
|
|
}
|
|
]
|
|
},
|
|
"VkImportMemoryZirconHandleInfoFUCHSIA": {
|
|
"(VK_FUCHSIA_external_memory)": [
|
|
{
|
|
"vuid": "VUID-VkImportMemoryZirconHandleInfoFUCHSIA-handleType-04771",
|
|
"text": " <code>handleType</code> <strong class=\"purple\">must</strong> be <code>VK_EXTERNAL_MEMORY_HANDLE_TYPE_ZIRCON_VMO_BIT_FUCHSIA</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportMemoryZirconHandleInfoFUCHSIA-handle-04772",
|
|
"text": " <code>handle</code> must be a valid VMO handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportMemoryZirconHandleInfoFUCHSIA-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_IMPORT_MEMORY_ZIRCON_HANDLE_INFO_FUCHSIA</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportMemoryZirconHandleInfoFUCHSIA-handleType-parameter",
|
|
"text": " If <code>handleType</code> is not <code>0</code>, <code>handleType</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkExternalMemoryHandleTypeFlagBits\">VkExternalMemoryHandleTypeFlagBits</a> value"
|
|
}
|
|
]
|
|
},
|
|
"vkGetMemoryZirconHandlePropertiesFUCHSIA": {
|
|
"(VK_FUCHSIA_external_memory)": [
|
|
{
|
|
"vuid": "VUID-vkGetMemoryZirconHandlePropertiesFUCHSIA-handleType-04773",
|
|
"text": " <code>handleType</code> <strong class=\"purple\">must</strong> be <code>VK_EXTERNAL_MEMORY_HANDLE_TYPE_ZIRCON_VMO_BIT_FUCHSIA</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetMemoryZirconHandlePropertiesFUCHSIA-zirconHandle-04774",
|
|
"text": " <code>zirconHandle</code> must reference a valid VMO"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetMemoryZirconHandlePropertiesFUCHSIA-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetMemoryZirconHandlePropertiesFUCHSIA-handleType-parameter",
|
|
"text": " <code>handleType</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkExternalMemoryHandleTypeFlagBits\">VkExternalMemoryHandleTypeFlagBits</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetMemoryZirconHandlePropertiesFUCHSIA-pMemoryZirconHandleProperties-parameter",
|
|
"text": " <code>pMemoryZirconHandleProperties</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkMemoryZirconHandlePropertiesFUCHSIA\">VkMemoryZirconHandlePropertiesFUCHSIA</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkMemoryZirconHandlePropertiesFUCHSIA": {
|
|
"(VK_FUCHSIA_external_memory)": [
|
|
{
|
|
"vuid": "VUID-VkMemoryZirconHandlePropertiesFUCHSIA-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_MEMORY_ZIRCON_HANDLE_PROPERTIES_FUCHSIA</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryZirconHandlePropertiesFUCHSIA-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetMemoryZirconHandleFUCHSIA": {
|
|
"(VK_FUCHSIA_external_memory)": [
|
|
{
|
|
"vuid": "VUID-vkGetMemoryZirconHandleFUCHSIA-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetMemoryZirconHandleFUCHSIA-pGetZirconHandleInfo-parameter",
|
|
"text": " <code>pGetZirconHandleInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkMemoryGetZirconHandleInfoFUCHSIA\">VkMemoryGetZirconHandleInfoFUCHSIA</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetMemoryZirconHandleFUCHSIA-pZirconHandle-parameter",
|
|
"text": " <code>pZirconHandle</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>zx_handle_t</code> value"
|
|
}
|
|
]
|
|
},
|
|
"VkMemoryGetZirconHandleInfoFUCHSIA": {
|
|
"(VK_FUCHSIA_external_memory)": [
|
|
{
|
|
"vuid": "VUID-VkMemoryGetZirconHandleInfoFUCHSIA-handleType-04775",
|
|
"text": " <code>handleType</code> <strong class=\"purple\">must</strong> be <code>VK_EXTERNAL_MEMORY_HANDLE_TYPE_ZIRCON_VMO_BIT_FUCHSIA</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryGetZirconHandleInfoFUCHSIA-handleType-04776",
|
|
"text": " <code>handleType</code> <strong class=\"purple\">must</strong> have been included in the <code>handleTypes</code> field of the <code>VkExportMemoryAllocateInfo</code> structure when the external memory was allocated"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryGetZirconHandleInfoFUCHSIA-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_MEMORY_GET_ZIRCON_HANDLE_INFO_FUCHSIA</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryGetZirconHandleInfoFUCHSIA-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryGetZirconHandleInfoFUCHSIA-memory-parameter",
|
|
"text": " <code>memory</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDeviceMemory\">VkDeviceMemory</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryGetZirconHandleInfoFUCHSIA-handleType-parameter",
|
|
"text": " <code>handleType</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkExternalMemoryHandleTypeFlagBits\">VkExternalMemoryHandleTypeFlagBits</a> value"
|
|
}
|
|
]
|
|
},
|
|
"VkExportMetalObjectCreateInfoEXT": {
|
|
"(VK_EXT_metal_objects)": [
|
|
{
|
|
"vuid": "VUID-VkExportMetalObjectCreateInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_EXPORT_METAL_OBJECT_CREATE_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkExportMetalObjectCreateInfoEXT-exportObjectType-parameter",
|
|
"text": " If <code>exportObjectType</code> is not <code>0</code>, <code>exportObjectType</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkExportMetalObjectTypeFlagBitsEXT\">VkExportMetalObjectTypeFlagBitsEXT</a> value"
|
|
}
|
|
]
|
|
},
|
|
"vkExportMetalObjectsEXT": {
|
|
"(VK_EXT_metal_objects)": [
|
|
{
|
|
"vuid": "VUID-vkExportMetalObjectsEXT-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkExportMetalObjectsEXT-pMetalObjectsInfo-parameter",
|
|
"text": " <code>pMetalObjectsInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkExportMetalObjectsInfoEXT\">VkExportMetalObjectsInfoEXT</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkExportMetalObjectsInfoEXT": {
|
|
"(VK_EXT_metal_objects)": [
|
|
{
|
|
"vuid": "VUID-VkExportMetalObjectsInfoEXT-pNext-06791",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkExportMetalDeviceInfoEXT\">VkExportMetalDeviceInfoEXT</a> structure, the <a href=\"#VkInstance\">VkInstance</a> <strong class=\"purple\">must</strong> have been created with <code>VK_EXPORT_METAL_OBJECT_TYPE_METAL_DEVICE_BIT_EXT</code> in the <code>exportObjectType</code> member of a <a href=\"#VkExportMetalObjectCreateInfoEXT\">VkExportMetalObjectCreateInfoEXT</a> structure in the <code>pNext</code> chain of the <a href=\"#VkInstanceCreateInfo\">VkInstanceCreateInfo</a> structure in the <a href=\"#vkCreateInstance\">vkCreateInstance</a> command."
|
|
},
|
|
{
|
|
"vuid": "VUID-VkExportMetalObjectsInfoEXT-pNext-06792",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkExportMetalCommandQueueInfoEXT\">VkExportMetalCommandQueueInfoEXT</a> structure, the <a href=\"#VkInstance\">VkInstance</a> <strong class=\"purple\">must</strong> have been created with <code>VK_EXPORT_METAL_OBJECT_TYPE_METAL_COMMAND_QUEUE_BIT_EXT</code> in the <code>exportObjectType</code> member of a <a href=\"#VkExportMetalObjectCreateInfoEXT\">VkExportMetalObjectCreateInfoEXT</a> structure in the <code>pNext</code> chain of the <a href=\"#VkInstanceCreateInfo\">VkInstanceCreateInfo</a> structure in the <a href=\"#vkCreateInstance\">vkCreateInstance</a> command."
|
|
},
|
|
{
|
|
"vuid": "VUID-VkExportMetalObjectsInfoEXT-pNext-06793",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkExportMetalBufferInfoEXT\">VkExportMetalBufferInfoEXT</a> structure, the <a href=\"#VkDeviceMemory\">VkDeviceMemory</a> in its <code>memory</code> member <strong class=\"purple\">must</strong> have been allocated with <code>VK_EXPORT_METAL_OBJECT_TYPE_METAL_BUFFER_BIT_EXT</code> in the <code>exportObjectType</code> member of a <a href=\"#VkExportMetalObjectCreateInfoEXT\">VkExportMetalObjectCreateInfoEXT</a> structure in the <code>pNext</code> chain of the <a href=\"#VkMemoryAllocateInfo\">VkMemoryAllocateInfo</a> structure in the <a href=\"#vkAllocateMemory\">vkAllocateMemory</a> command."
|
|
},
|
|
{
|
|
"vuid": "VUID-VkExportMetalObjectsInfoEXT-pNext-06794",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkExportMetalTextureInfoEXT\">VkExportMetalTextureInfoEXT</a> structure, exactly one of its <code>image</code>, <code>imageView</code>, or <code>bufferView</code> members <strong class=\"purple\">must</strong> not be <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>."
|
|
},
|
|
{
|
|
"vuid": "VUID-VkExportMetalObjectsInfoEXT-pNext-06795",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkExportMetalTextureInfoEXT\">VkExportMetalTextureInfoEXT</a> structure, and its <code>image</code> member is not <code>VK_NULL_HANDLE</code>, the <a href=\"#VkImage\">VkImage</a> in its <code>image</code> member <strong class=\"purple\">must</strong> have been created with <code>VK_EXPORT_METAL_OBJECT_TYPE_METAL_TEXTURE_BIT_EXT</code> in the <code>exportObjectType</code> member of a <a href=\"#VkExportMetalObjectCreateInfoEXT\">VkExportMetalObjectCreateInfoEXT</a> structure in the <code>pNext</code> chain of the <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> structure in the <a href=\"#vkCreateImage\">vkCreateImage</a> command."
|
|
},
|
|
{
|
|
"vuid": "VUID-VkExportMetalObjectsInfoEXT-pNext-06796",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkExportMetalTextureInfoEXT\">VkExportMetalTextureInfoEXT</a> structure, and its <code>imageView</code> member is not <code>VK_NULL_HANDLE</code>, the <a href=\"#VkImageView\">VkImageView</a> in its <code>imageView</code> member <strong class=\"purple\">must</strong> have been created with <code>VK_EXPORT_METAL_OBJECT_TYPE_METAL_TEXTURE_BIT_EXT</code> in the <code>exportObjectType</code> member of a <a href=\"#VkExportMetalObjectCreateInfoEXT\">VkExportMetalObjectCreateInfoEXT</a> structure in the <code>pNext</code> chain of the <a href=\"#VkImageViewCreateInfo\">VkImageViewCreateInfo</a> structure in the <a href=\"#vkCreateImageView\">vkCreateImageView</a> command."
|
|
},
|
|
{
|
|
"vuid": "VUID-VkExportMetalObjectsInfoEXT-pNext-06797",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkExportMetalTextureInfoEXT\">VkExportMetalTextureInfoEXT</a> structure, and its <code>bufferView</code> member is not <code>VK_NULL_HANDLE</code>, the <a href=\"#VkBufferView\">VkBufferView</a> in its <code>bufferView</code> member <strong class=\"purple\">must</strong> have been created with <code>VK_EXPORT_METAL_OBJECT_TYPE_METAL_TEXTURE_BIT_EXT</code> in the <code>exportObjectType</code> member of a <a href=\"#VkExportMetalObjectCreateInfoEXT\">VkExportMetalObjectCreateInfoEXT</a> structure in the <code>pNext</code> chain of the <a href=\"#VkBufferViewCreateInfo\">VkBufferViewCreateInfo</a> structure in the <a href=\"#vkCreateBufferView\">vkCreateBufferView</a> command."
|
|
},
|
|
{
|
|
"vuid": "VUID-VkExportMetalObjectsInfoEXT-pNext-06798",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkExportMetalTextureInfoEXT\">VkExportMetalTextureInfoEXT</a> structure, and if either its <code>image</code> or <code>imageView</code> member is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, then <code>plane</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_ASPECT_PLANE_0_BIT</code>, <code>VK_IMAGE_ASPECT_PLANE_1_BIT</code>, or <code>VK_IMAGE_ASPECT_PLANE_2_BIT</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-VkExportMetalObjectsInfoEXT-pNext-06799",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkExportMetalTextureInfoEXT\">VkExportMetalTextureInfoEXT</a> structure, and if the <a href=\"#VkImage\">VkImage</a> in its <code>image</code> member does not have a multi-planar format, then its <code>plane</code> member <strong class=\"purple\">must</strong> be <code>VK_IMAGE_ASPECT_PLANE_0_BIT</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-VkExportMetalObjectsInfoEXT-pNext-06800",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkExportMetalTextureInfoEXT\">VkExportMetalTextureInfoEXT</a> structure, and if the <a href=\"#VkImage\">VkImage</a> in its <code>image</code> member has a multi-planar format with only two planes, then its <code>plane</code> member <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_ASPECT_PLANE_2_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkExportMetalObjectsInfoEXT-pNext-06801",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkExportMetalTextureInfoEXT\">VkExportMetalTextureInfoEXT</a> structure, and if the <a href=\"#VkImageView\">VkImageView</a> in its <code>imageView</code> member does not have a multi-planar format, then its <code>plane</code> member <strong class=\"purple\">must</strong> be <code>VK_IMAGE_ASPECT_PLANE_0_BIT</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-VkExportMetalObjectsInfoEXT-pNext-06802",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkExportMetalTextureInfoEXT\">VkExportMetalTextureInfoEXT</a> structure, and if the <a href=\"#VkImageView\">VkImageView</a> in its <code>imageView</code> member has a multi-planar format with only two planes, then its <code>plane</code> member <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_ASPECT_PLANE_2_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkExportMetalObjectsInfoEXT-pNext-06803",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkExportMetalIOSurfaceInfoEXT\">VkExportMetalIOSurfaceInfoEXT</a> structure, the <a href=\"#VkImage\">VkImage</a> in its <code>image</code> member <strong class=\"purple\">must</strong> have been created with <code>VK_EXPORT_METAL_OBJECT_TYPE_METAL_IOSURFACE_BIT_EXT</code> in the <code>exportObjectType</code> member of a <a href=\"#VkExportMetalObjectCreateInfoEXT\">VkExportMetalObjectCreateInfoEXT</a> structure in the <code>pNext</code> chain of the <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> structure in the <a href=\"#vkCreateImage\">vkCreateImage</a> command."
|
|
},
|
|
{
|
|
"vuid": "VUID-VkExportMetalObjectsInfoEXT-pNext-06804",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkExportMetalSharedEventInfoEXT\">VkExportMetalSharedEventInfoEXT</a> structure, exactly one of its <code>semaphore</code> or <code>event</code> members <strong class=\"purple\">must</strong> not be <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>."
|
|
},
|
|
{
|
|
"vuid": "VUID-VkExportMetalObjectsInfoEXT-pNext-06805",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkExportMetalSharedEventInfoEXT\">VkExportMetalSharedEventInfoEXT</a> structure, and its <code>semaphore</code> member is not <code>VK_NULL_HANDLE</code>, the <a href=\"#VkSemaphore\">VkSemaphore</a> in its <code>semaphore</code> member <strong class=\"purple\">must</strong> have been created with <code>VK_EXPORT_METAL_OBJECT_TYPE_METAL_SHARED_EVENT_BIT_EXT</code> in the <code>exportObjectType</code> member of a <a href=\"#VkExportMetalObjectCreateInfoEXT\">VkExportMetalObjectCreateInfoEXT</a> structure in the <code>pNext</code> chain of the <a href=\"#VkSemaphoreCreateInfo\">VkSemaphoreCreateInfo</a> structure in the <a href=\"#vkCreateSemaphore\">vkCreateSemaphore</a> command."
|
|
},
|
|
{
|
|
"vuid": "VUID-VkExportMetalObjectsInfoEXT-pNext-06806",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkExportMetalSharedEventInfoEXT\">VkExportMetalSharedEventInfoEXT</a> structure, and its <code>event</code> member is not <code>VK_NULL_HANDLE</code>, the <a href=\"#VkEvent\">VkEvent</a> in its <code>event</code> member <strong class=\"purple\">must</strong> have been created with <code>VK_EXPORT_METAL_OBJECT_TYPE_METAL_SHARED_EVENT_BIT_EXT</code> in the <code>exportObjectType</code> member of a <a href=\"#VkExportMetalObjectCreateInfoEXT\">VkExportMetalObjectCreateInfoEXT</a> structure in the <code>pNext</code> chain of the <a href=\"#VkEventCreateInfo\">VkEventCreateInfo</a> structure in the <a href=\"#vkCreateEvent\">vkCreateEvent</a> command."
|
|
},
|
|
{
|
|
"vuid": "VUID-VkExportMetalObjectsInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_EXPORT_METAL_OBJECTS_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkExportMetalObjectsInfoEXT-pNext-pNext",
|
|
"text": " Each <code>pNext</code> member of any structure (including this one) in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be either <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkExportMetalBufferInfoEXT\">VkExportMetalBufferInfoEXT</a>, <a href=\"#VkExportMetalCommandQueueInfoEXT\">VkExportMetalCommandQueueInfoEXT</a>, <a href=\"#VkExportMetalDeviceInfoEXT\">VkExportMetalDeviceInfoEXT</a>, <a href=\"#VkExportMetalIOSurfaceInfoEXT\">VkExportMetalIOSurfaceInfoEXT</a>, <a href=\"#VkExportMetalSharedEventInfoEXT\">VkExportMetalSharedEventInfoEXT</a>, or <a href=\"#VkExportMetalTextureInfoEXT\">VkExportMetalTextureInfoEXT</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkExportMetalObjectsInfoEXT-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique, with the exception of structures of type <a href=\"#VkExportMetalBufferInfoEXT\">VkExportMetalBufferInfoEXT</a>, <a href=\"#VkExportMetalCommandQueueInfoEXT\">VkExportMetalCommandQueueInfoEXT</a>, <a href=\"#VkExportMetalIOSurfaceInfoEXT\">VkExportMetalIOSurfaceInfoEXT</a>, <a href=\"#VkExportMetalSharedEventInfoEXT\">VkExportMetalSharedEventInfoEXT</a>, or <a href=\"#VkExportMetalTextureInfoEXT\">VkExportMetalTextureInfoEXT</a>"
|
|
}
|
|
]
|
|
},
|
|
"VkExportMetalDeviceInfoEXT": {
|
|
"(VK_EXT_metal_objects)": [
|
|
{
|
|
"vuid": "VUID-VkExportMetalDeviceInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_EXPORT_METAL_DEVICE_INFO_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkExportMetalCommandQueueInfoEXT": {
|
|
"(VK_EXT_metal_objects)": [
|
|
{
|
|
"vuid": "VUID-VkExportMetalCommandQueueInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_EXPORT_METAL_COMMAND_QUEUE_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkExportMetalCommandQueueInfoEXT-queue-parameter",
|
|
"text": " <code>queue</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkQueue\">VkQueue</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkExportMetalBufferInfoEXT": {
|
|
"(VK_EXT_metal_objects)": [
|
|
{
|
|
"vuid": "VUID-VkExportMetalBufferInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_EXPORT_METAL_BUFFER_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkExportMetalBufferInfoEXT-memory-parameter",
|
|
"text": " <code>memory</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDeviceMemory\">VkDeviceMemory</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkImportMetalBufferInfoEXT": {
|
|
"(VK_EXT_metal_objects)": [
|
|
{
|
|
"vuid": "VUID-VkImportMetalBufferInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_IMPORT_METAL_BUFFER_INFO_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkExportMetalTextureInfoEXT": {
|
|
"(VK_EXT_metal_objects)": [
|
|
{
|
|
"vuid": "VUID-VkExportMetalTextureInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_EXPORT_METAL_TEXTURE_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkExportMetalTextureInfoEXT-image-parameter",
|
|
"text": " If <code>image</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>image</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImage\">VkImage</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkExportMetalTextureInfoEXT-imageView-parameter",
|
|
"text": " If <code>imageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>imageView</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageView\">VkImageView</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkExportMetalTextureInfoEXT-bufferView-parameter",
|
|
"text": " If <code>bufferView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>bufferView</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBufferView\">VkBufferView</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkExportMetalTextureInfoEXT-plane-parameter",
|
|
"text": " <code>plane</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageAspectFlagBits\">VkImageAspectFlagBits</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkExportMetalTextureInfoEXT-commonparent",
|
|
"text": " Each of <code>bufferView</code>, <code>image</code>, and <code>imageView</code> that are valid handles of non-ignored parameters <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
]
|
|
},
|
|
"VkImportMetalTextureInfoEXT": {
|
|
"(VK_EXT_metal_objects)": [
|
|
{
|
|
"vuid": "VUID-VkImportMetalTextureInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_IMPORT_METAL_TEXTURE_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportMetalTextureInfoEXT-plane-parameter",
|
|
"text": " <code>plane</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageAspectFlagBits\">VkImageAspectFlagBits</a> value"
|
|
}
|
|
]
|
|
},
|
|
"VkExportMetalIOSurfaceInfoEXT": {
|
|
"(VK_EXT_metal_objects)": [
|
|
{
|
|
"vuid": "VUID-VkExportMetalIOSurfaceInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_EXPORT_METAL_IO_SURFACE_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkExportMetalIOSurfaceInfoEXT-image-parameter",
|
|
"text": " <code>image</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImage\">VkImage</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkImportMetalIOSurfaceInfoEXT": {
|
|
"(VK_EXT_metal_objects)": [
|
|
{
|
|
"vuid": "VUID-VkImportMetalIOSurfaceInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_IMPORT_METAL_IO_SURFACE_INFO_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkExportMetalSharedEventInfoEXT": {
|
|
"(VK_EXT_metal_objects)": [
|
|
{
|
|
"vuid": "VUID-VkExportMetalSharedEventInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_EXPORT_METAL_SHARED_EVENT_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkExportMetalSharedEventInfoEXT-semaphore-parameter",
|
|
"text": " If <code>semaphore</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>semaphore</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSemaphore\">VkSemaphore</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkExportMetalSharedEventInfoEXT-event-parameter",
|
|
"text": " If <code>event</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>event</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkEvent\">VkEvent</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkExportMetalSharedEventInfoEXT-commonparent",
|
|
"text": " Both of <code>event</code>, and <code>semaphore</code> that are valid handles of non-ignored parameters <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
]
|
|
},
|
|
"VkImportMetalSharedEventInfoEXT": {
|
|
"(VK_EXT_metal_objects)": [
|
|
{
|
|
"vuid": "VUID-VkImportMetalSharedEventInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_IMPORT_METAL_SHARED_EVENT_INFO_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkMemoryAllocateFlagsInfo": {
|
|
"(VK_VERSION_1_1,VK_KHR_device_group)": [
|
|
{
|
|
"vuid": "VUID-VkMemoryAllocateFlagsInfo-deviceMask-00675",
|
|
"text": " If <code>VK_MEMORY_ALLOCATE_DEVICE_MASK_BIT</code> is set, <code>deviceMask</code> <strong class=\"purple\">must</strong> be a valid device mask"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryAllocateFlagsInfo-deviceMask-00676",
|
|
"text": " If <code>VK_MEMORY_ALLOCATE_DEVICE_MASK_BIT</code> is set, <code>deviceMask</code> <strong class=\"purple\">must</strong> not be zero"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryAllocateFlagsInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_MEMORY_ALLOCATE_FLAGS_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryAllocateFlagsInfo-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkMemoryAllocateFlagBits\">VkMemoryAllocateFlagBits</a> values"
|
|
}
|
|
]
|
|
},
|
|
"VkMemoryOpaqueCaptureAddressAllocateInfo": {
|
|
"(VK_VERSION_1_2,VK_KHR_buffer_device_address)": [
|
|
{
|
|
"vuid": "VUID-VkMemoryOpaqueCaptureAddressAllocateInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_MEMORY_OPAQUE_CAPTURE_ADDRESS_ALLOCATE_INFO</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkFreeMemory": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkFreeMemory-memory-00677",
|
|
"text": " All submitted commands that refer to <code>memory</code> (via images or buffers) <strong class=\"purple\">must</strong> have completed execution"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkFreeMemory-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkFreeMemory-memory-parameter",
|
|
"text": " If <code>memory</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>memory</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDeviceMemory\">VkDeviceMemory</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkFreeMemory-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkFreeMemory-memory-parent",
|
|
"text": " If <code>memory</code> is a valid handle, it <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkMapMemory": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkMapMemory-memory-00678",
|
|
"text": " <code>memory</code> <strong class=\"purple\">must</strong> not be currently host mapped"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkMapMemory-offset-00679",
|
|
"text": " <code>offset</code> <strong class=\"purple\">must</strong> be less than the size of <code>memory</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkMapMemory-size-00680",
|
|
"text": " If <code>size</code> is not equal to <code>VK_WHOLE_SIZE</code>, <code>size</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkMapMemory-size-00681",
|
|
"text": " If <code>size</code> is not equal to <code>VK_WHOLE_SIZE</code>, <code>size</code> <strong class=\"purple\">must</strong> be less than or equal to the size of the <code>memory</code> minus <code>offset</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkMapMemory-memory-00682",
|
|
"text": " <code>memory</code> <strong class=\"purple\">must</strong> have been created with a memory type that reports <code>VK_MEMORY_PROPERTY_HOST_VISIBLE_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkMapMemory-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkMapMemory-memory-parameter",
|
|
"text": " <code>memory</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDeviceMemory\">VkDeviceMemory</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkMapMemory-flags-zerobitmask",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkMapMemory-ppData-parameter",
|
|
"text": " <code>ppData</code> <strong class=\"purple\">must</strong> be a valid pointer to a pointer value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkMapMemory-memory-parent",
|
|
"text": " <code>memory</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
],
|
|
"(VK_KHR_device_group)": [
|
|
{
|
|
"vuid": "VUID-vkMapMemory-memory-00683",
|
|
"text": " <code>memory</code> <strong class=\"purple\">must</strong> not have been allocated with multiple instances"
|
|
}
|
|
]
|
|
},
|
|
"vkFlushMappedMemoryRanges": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkFlushMappedMemoryRanges-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkFlushMappedMemoryRanges-pMemoryRanges-parameter",
|
|
"text": " <code>pMemoryRanges</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>memoryRangeCount</code> valid <a href=\"#VkMappedMemoryRange\">VkMappedMemoryRange</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkFlushMappedMemoryRanges-memoryRangeCount-arraylength",
|
|
"text": " <code>memoryRangeCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkInvalidateMappedMemoryRanges": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkInvalidateMappedMemoryRanges-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkInvalidateMappedMemoryRanges-pMemoryRanges-parameter",
|
|
"text": " <code>pMemoryRanges</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>memoryRangeCount</code> valid <a href=\"#VkMappedMemoryRange\">VkMappedMemoryRange</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkInvalidateMappedMemoryRanges-memoryRangeCount-arraylength",
|
|
"text": " <code>memoryRangeCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkMappedMemoryRange": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkMappedMemoryRange-memory-00684",
|
|
"text": " <code>memory</code> <strong class=\"purple\">must</strong> be currently host mapped"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMappedMemoryRange-size-00685",
|
|
"text": " If <code>size</code> is not equal to <code>VK_WHOLE_SIZE</code>, <code>offset</code> and <code>size</code> <strong class=\"purple\">must</strong> specify a range contained within the currently mapped range of <code>memory</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMappedMemoryRange-size-00686",
|
|
"text": " If <code>size</code> is equal to <code>VK_WHOLE_SIZE</code>, <code>offset</code> <strong class=\"purple\">must</strong> be within the currently mapped range of <code>memory</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMappedMemoryRange-offset-00687",
|
|
"text": " <code>offset</code> <strong class=\"purple\">must</strong> be a multiple of <a href=\"#VkPhysicalDeviceLimits\">VkPhysicalDeviceLimits</a>::<code>nonCoherentAtomSize</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMappedMemoryRange-size-01389",
|
|
"text": " If <code>size</code> is equal to <code>VK_WHOLE_SIZE</code>, the end of the current mapping of <code>memory</code> <strong class=\"purple\">must</strong> either be a multiple of <a href=\"#VkPhysicalDeviceLimits\">VkPhysicalDeviceLimits</a>::<code>nonCoherentAtomSize</code> bytes from the beginning of the memory object, or be equal to the end of the memory object"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMappedMemoryRange-size-01390",
|
|
"text": " If <code>size</code> is not equal to <code>VK_WHOLE_SIZE</code>, <code>size</code> <strong class=\"purple\">must</strong> either be a multiple of <a href=\"#VkPhysicalDeviceLimits\">VkPhysicalDeviceLimits</a>::<code>nonCoherentAtomSize</code>, or <code>offset</code> plus <code>size</code> <strong class=\"purple\">must</strong> equal the size of <code>memory</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMappedMemoryRange-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_MAPPED_MEMORY_RANGE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMappedMemoryRange-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMappedMemoryRange-memory-parameter",
|
|
"text": " <code>memory</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDeviceMemory\">VkDeviceMemory</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"vkUnmapMemory": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkUnmapMemory-memory-00689",
|
|
"text": " <code>memory</code> <strong class=\"purple\">must</strong> be currently host mapped"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkUnmapMemory-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkUnmapMemory-memory-parameter",
|
|
"text": " <code>memory</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDeviceMemory\">VkDeviceMemory</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkUnmapMemory-memory-parent",
|
|
"text": " <code>memory</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetDeviceMemoryCommitment": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkGetDeviceMemoryCommitment-memory-00690",
|
|
"text": " <code>memory</code> <strong class=\"purple\">must</strong> have been created with a memory type that reports <code>VK_MEMORY_PROPERTY_LAZILY_ALLOCATED_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDeviceMemoryCommitment-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDeviceMemoryCommitment-memory-parameter",
|
|
"text": " <code>memory</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDeviceMemory\">VkDeviceMemory</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDeviceMemoryCommitment-pCommittedMemoryInBytes-parameter",
|
|
"text": " <code>pCommittedMemoryInBytes</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>VkDeviceSize</code> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDeviceMemoryCommitment-memory-parent",
|
|
"text": " <code>memory</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetDeviceGroupPeerMemoryFeatures": {
|
|
"(VK_VERSION_1_1,VK_KHR_device_group)": [
|
|
{
|
|
"vuid": "VUID-vkGetDeviceGroupPeerMemoryFeatures-heapIndex-00691",
|
|
"text": " <code>heapIndex</code> <strong class=\"purple\">must</strong> be less than <code>memoryHeapCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDeviceGroupPeerMemoryFeatures-localDeviceIndex-00692",
|
|
"text": " <code>localDeviceIndex</code> <strong class=\"purple\">must</strong> be a valid device index"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDeviceGroupPeerMemoryFeatures-remoteDeviceIndex-00693",
|
|
"text": " <code>remoteDeviceIndex</code> <strong class=\"purple\">must</strong> be a valid device index"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDeviceGroupPeerMemoryFeatures-localDeviceIndex-00694",
|
|
"text": " <code>localDeviceIndex</code> <strong class=\"purple\">must</strong> not equal <code>remoteDeviceIndex</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDeviceGroupPeerMemoryFeatures-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDeviceGroupPeerMemoryFeatures-pPeerMemoryFeatures-parameter",
|
|
"text": " <code>pPeerMemoryFeatures</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkPeerMemoryFeatureFlags\">VkPeerMemoryFeatureFlags</a> value"
|
|
}
|
|
]
|
|
},
|
|
"vkGetDeviceMemoryOpaqueCaptureAddress": {
|
|
"(VK_VERSION_1_2,VK_KHR_buffer_device_address)": [
|
|
{
|
|
"vuid": "VUID-vkGetDeviceMemoryOpaqueCaptureAddress-None-03334",
|
|
"text": " The <a href=\"#features-bufferDeviceAddress\"><code>bufferDeviceAddress</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDeviceMemoryOpaqueCaptureAddress-device-03335",
|
|
"text": " If <code>device</code> was created with multiple physical devices, then the <a href=\"#features-bufferDeviceAddressMultiDevice\"><code>bufferDeviceAddressMultiDevice</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDeviceMemoryOpaqueCaptureAddress-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDeviceMemoryOpaqueCaptureAddress-pInfo-parameter",
|
|
"text": " <code>pInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkDeviceMemoryOpaqueCaptureAddressInfo\">VkDeviceMemoryOpaqueCaptureAddressInfo</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkDeviceMemoryOpaqueCaptureAddressInfo": {
|
|
"(VK_VERSION_1_2,VK_KHR_buffer_device_address)": [
|
|
{
|
|
"vuid": "VUID-VkDeviceMemoryOpaqueCaptureAddressInfo-memory-03336",
|
|
"text": " <code>memory</code> <strong class=\"purple\">must</strong> have been allocated with <code>VK_MEMORY_ALLOCATE_DEVICE_ADDRESS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceMemoryOpaqueCaptureAddressInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_DEVICE_MEMORY_OPAQUE_CAPTURE_ADDRESS_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceMemoryOpaqueCaptureAddressInfo-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceMemoryOpaqueCaptureAddressInfo-memory-parameter",
|
|
"text": " <code>memory</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDeviceMemory\">VkDeviceMemory</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"vkCreateBuffer": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCreateBuffer-flags-00911",
|
|
"text": " If the <code>flags</code> member of <code>pCreateInfo</code> includes <code>VK_BUFFER_CREATE_SPARSE_BINDING_BIT</code>, creating this <code>VkBuffer</code> <strong class=\"purple\">must</strong> not cause the total required sparse memory for all currently valid sparse resources on the device to exceed <code>VkPhysicalDeviceLimits</code>::<code>sparseAddressSpaceSize</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateBuffer-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateBuffer-pCreateInfo-parameter",
|
|
"text": " <code>pCreateInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkBufferCreateInfo\">VkBufferCreateInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateBuffer-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateBuffer-pBuffer-parameter",
|
|
"text": " <code>pBuffer</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkBuffer\">VkBuffer</a> handle"
|
|
}
|
|
],
|
|
"(VK_FUCHSIA_buffer_collection)": [
|
|
{
|
|
"vuid": "VUID-vkCreateBuffer-pNext-06387",
|
|
"text": " If using the <a href=\"#VkBuffer\">VkBuffer</a> for an import operation from a <a href=\"#VkBufferCollectionFUCHSIA\">VkBufferCollectionFUCHSIA</a> where a <a href=\"#VkBufferCollectionBufferCreateInfoFUCHSIA\">VkBufferCollectionBufferCreateInfoFUCHSIA</a> has been chained to <code>pNext</code>, <code>pCreateInfo</code> <strong class=\"purple\">must</strong> match the <a href=\"#VkBufferConstraintsInfoFUCHSIA\">VkBufferConstraintsInfoFUCHSIA</a>::<code>createInfo</code> used when setting the constraints on the buffer collection with <a href=\"#vkSetBufferCollectionBufferConstraintsFUCHSIA\">vkSetBufferCollectionBufferConstraintsFUCHSIA</a>"
|
|
}
|
|
]
|
|
},
|
|
"VkBufferCreateInfo": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkBufferCreateInfo-size-00912",
|
|
"text": " <code>size</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferCreateInfo-sharingMode-00913",
|
|
"text": " If <code>sharingMode</code> is <code>VK_SHARING_MODE_CONCURRENT</code>, <code>pQueueFamilyIndices</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>queueFamilyIndexCount</code> <code>uint32_t</code> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferCreateInfo-sharingMode-00914",
|
|
"text": " If <code>sharingMode</code> is <code>VK_SHARING_MODE_CONCURRENT</code>, <code>queueFamilyIndexCount</code> <strong class=\"purple\">must</strong> be greater than <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferCreateInfo-flags-00915",
|
|
"text": " If the <a href=\"#features-sparseBinding\"><code>sparseBinding</code></a> feature is not enabled, <code>flags</code> <strong class=\"purple\">must</strong> not contain <code>VK_BUFFER_CREATE_SPARSE_BINDING_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferCreateInfo-flags-00916",
|
|
"text": " If the <a href=\"#features-sparseResidencyBuffer\"><code>sparseResidencyBuffer</code></a> feature is not enabled, <code>flags</code> <strong class=\"purple\">must</strong> not contain <code>VK_BUFFER_CREATE_SPARSE_RESIDENCY_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferCreateInfo-flags-00917",
|
|
"text": " If the <a href=\"#features-sparseResidencyAliased\"><code>sparseResidencyAliased</code></a> feature is not enabled, <code>flags</code> <strong class=\"purple\">must</strong> not contain <code>VK_BUFFER_CREATE_SPARSE_ALIASED_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferCreateInfo-flags-00918",
|
|
"text": " If <code>flags</code> contains <code>VK_BUFFER_CREATE_SPARSE_RESIDENCY_BIT</code> or <code>VK_BUFFER_CREATE_SPARSE_ALIASED_BIT</code>, it <strong class=\"purple\">must</strong> also contain <code>VK_BUFFER_CREATE_SPARSE_BINDING_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferCreateInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_BUFFER_CREATE_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferCreateInfo-pNext-pNext",
|
|
"text": " Each <code>pNext</code> member of any structure (including this one) in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be either <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkBufferCollectionBufferCreateInfoFUCHSIA\">VkBufferCollectionBufferCreateInfoFUCHSIA</a>, <a href=\"#VkBufferDeviceAddressCreateInfoEXT\">VkBufferDeviceAddressCreateInfoEXT</a>, <a href=\"#VkBufferOpaqueCaptureAddressCreateInfo\">VkBufferOpaqueCaptureAddressCreateInfo</a>, <a href=\"#VkDedicatedAllocationBufferCreateInfoNV\">VkDedicatedAllocationBufferCreateInfoNV</a>, <a href=\"#VkExternalMemoryBufferCreateInfo\">VkExternalMemoryBufferCreateInfo</a>, or <a href=\"#VkVideoProfilesKHR\">VkVideoProfilesKHR</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferCreateInfo-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferCreateInfo-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkBufferCreateFlagBits\">VkBufferCreateFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferCreateInfo-usage-parameter",
|
|
"text": " <code>usage</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkBufferUsageFlagBits\">VkBufferUsageFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferCreateInfo-usage-requiredbitmask",
|
|
"text": " <code>usage</code> <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferCreateInfo-sharingMode-parameter",
|
|
"text": " <code>sharingMode</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSharingMode\">VkSharingMode</a> value"
|
|
}
|
|
],
|
|
"!(VK_VERSION_1_1,VK_KHR_get_physical_device_properties2)": [
|
|
{
|
|
"vuid": "VUID-VkBufferCreateInfo-sharingMode-01391",
|
|
"text": " If <code>sharingMode</code> is <code>VK_SHARING_MODE_CONCURRENT</code>, each element of <code>pQueueFamilyIndices</code> <strong class=\"purple\">must</strong> be unique and <strong class=\"purple\">must</strong> be less than <code>pQueueFamilyPropertyCount</code> returned by <a href=\"#vkGetPhysicalDeviceQueueFamilyProperties\">vkGetPhysicalDeviceQueueFamilyProperties</a> for the <code>physicalDevice</code> that was used to create <code>device</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_get_physical_device_properties2)": [
|
|
{
|
|
"vuid": "VUID-VkBufferCreateInfo-sharingMode-01419",
|
|
"text": " If <code>sharingMode</code> is <code>VK_SHARING_MODE_CONCURRENT</code>, each element of <code>pQueueFamilyIndices</code> <strong class=\"purple\">must</strong> be unique and <strong class=\"purple\">must</strong> be less than <code>pQueueFamilyPropertyCount</code> returned by either <a href=\"#vkGetPhysicalDeviceQueueFamilyProperties\">vkGetPhysicalDeviceQueueFamilyProperties</a> or <a href=\"#vkGetPhysicalDeviceQueueFamilyProperties2\">vkGetPhysicalDeviceQueueFamilyProperties2</a> for the <code>physicalDevice</code> that was used to create <code>device</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_external_memory)": [
|
|
{
|
|
"vuid": "VUID-VkBufferCreateInfo-pNext-00920",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkExternalMemoryBufferCreateInfo\">VkExternalMemoryBufferCreateInfo</a> structure, its <code>handleTypes</code> member <strong class=\"purple\">must</strong> only contain bits that are also in <a href=\"#VkExternalBufferProperties\">VkExternalBufferProperties</a>::<code>externalMemoryProperties.compatibleHandleTypes</code>, as returned by <a href=\"#vkGetPhysicalDeviceExternalBufferProperties\">vkGetPhysicalDeviceExternalBufferProperties</a> with <code>pExternalBufferInfo->handleType</code> equal to any one of the handle types specified in <a href=\"#VkExternalMemoryBufferCreateInfo\">VkExternalMemoryBufferCreateInfo</a>::<code>handleTypes</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-VkBufferCreateInfo-flags-01887",
|
|
"text": " If the <a href=\"#features-protectedMemory\"><code>protectedMemory</code></a> feature is not enabled, <code>flags</code> <strong class=\"purple\">must</strong> not contain <code>VK_BUFFER_CREATE_PROTECTED_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferCreateInfo-None-01888",
|
|
"text": " If any of the bits <code>VK_BUFFER_CREATE_SPARSE_BINDING_BIT</code>, <code>VK_BUFFER_CREATE_SPARSE_RESIDENCY_BIT</code>, or <code>VK_BUFFER_CREATE_SPARSE_ALIASED_BIT</code> are set, <code>VK_BUFFER_CREATE_PROTECTED_BIT</code> <strong class=\"purple\">must</strong> not also be set"
|
|
}
|
|
],
|
|
"(VK_NV_dedicated_allocation)": [
|
|
{
|
|
"vuid": "VUID-VkBufferCreateInfo-pNext-01571",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkDedicatedAllocationBufferCreateInfoNV\">VkDedicatedAllocationBufferCreateInfoNV</a> structure, and the <code>dedicatedAllocation</code> member of the chained structure is <code>VK_TRUE</code>, then <code>flags</code> <strong class=\"purple\">must</strong> not include <code>VK_BUFFER_CREATE_SPARSE_BINDING_BIT</code>, <code>VK_BUFFER_CREATE_SPARSE_RESIDENCY_BIT</code>, or <code>VK_BUFFER_CREATE_SPARSE_ALIASED_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_EXT_buffer_device_address,VK_KHR_buffer_device_address)+(VK_EXT_buffer_device_address)": [
|
|
{
|
|
"vuid": "VUID-VkBufferCreateInfo-deviceAddress-02604",
|
|
"text": " If <a href=\"#VkBufferDeviceAddressCreateInfoEXT\">VkBufferDeviceAddressCreateInfoEXT</a>::<code>deviceAddress</code> is not zero, <code>flags</code> <strong class=\"purple\">must</strong> include <code>VK_BUFFER_CREATE_DEVICE_ADDRESS_CAPTURE_REPLAY_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferCreateInfo-flags-03338",
|
|
"text": " If <code>flags</code> includes <code>VK_BUFFER_CREATE_DEVICE_ADDRESS_CAPTURE_REPLAY_BIT</code>, the <a href=\"#features-bufferDeviceAddressCaptureReplay\"><code>bufferDeviceAddressCaptureReplay</code></a> or <a href=\"#features-bufferDeviceAddressCaptureReplayEXT\"><code>bufferDeviceAddressCaptureReplayEXT</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_EXT_buffer_device_address,VK_KHR_buffer_device_address)+(VK_VERSION_1_2,VK_KHR_buffer_device_address)": [
|
|
{
|
|
"vuid": "VUID-VkBufferCreateInfo-opaqueCaptureAddress-03337",
|
|
"text": " If <a href=\"#VkBufferOpaqueCaptureAddressCreateInfo\">VkBufferOpaqueCaptureAddressCreateInfo</a>::<code>opaqueCaptureAddress</code> is not zero, <code>flags</code> <strong class=\"purple\">must</strong> include <code>VK_BUFFER_CREATE_DEVICE_ADDRESS_CAPTURE_REPLAY_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_EXT_buffer_device_address,VK_KHR_buffer_device_address)+!(VK_EXT_buffer_device_address)": [
|
|
{
|
|
"vuid": "VUID-VkBufferCreateInfo-flags-06549",
|
|
"text": " If <code>flags</code> includes <code>VK_BUFFER_CREATE_DEVICE_ADDRESS_CAPTURE_REPLAY_BIT</code>, the <a href=\"#features-bufferDeviceAddressCaptureReplay\"><code>bufferDeviceAddressCaptureReplay</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
}
|
|
],
|
|
"(VK_KHR_video_decode_queue)": [
|
|
{
|
|
"vuid": "VUID-VkBufferCreateInfo-usage-04813",
|
|
"text": " If <code>usage</code> includes <code>VK_BUFFER_USAGE_VIDEO_DECODE_SRC_BIT_KHR</code>, <code>VK_BUFFER_USAGE_VIDEO_DECODE_DST_BIT_KHR</code>, then the <code>pNext</code> chain <strong class=\"purple\">must</strong> include a valid <a href=\"#VkVideoProfilesKHR\">VkVideoProfilesKHR</a> structure with <code>profileCount</code> greater than <code>0</code> and <code>pProfiles</code> including at least one <a href=\"#VkVideoProfileKHR\">VkVideoProfileKHR</a>::<code>videoCodecOperation</code> specifying a decode operation"
|
|
}
|
|
],
|
|
"(VK_KHR_video_encode_queue)": [
|
|
{
|
|
"vuid": "VUID-VkBufferCreateInfo-usage-04814",
|
|
"text": " If <code>usage</code> includes <code>VK_BUFFER_USAGE_VIDEO_ENCODE_SRC_BIT_KHR</code>, <code>VK_BUFFER_USAGE_VIDEO_ENCODE_DST_BIT_KHR</code>, then the <code>pNext</code> chain <strong class=\"purple\">must</strong> include a valid <a href=\"#VkVideoProfilesKHR\">VkVideoProfilesKHR</a> structure with <code>profileCount</code> greater than <code>0</code> and <code>pProfiles</code> including at least one <a href=\"#VkVideoProfileKHR\">VkVideoProfileKHR</a>::<code>videoCodecOperation</code> specifying an encode operation"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_maintenance4)": [
|
|
{
|
|
"vuid": "VUID-VkBufferCreateInfo-size-06409",
|
|
"text": " <code>size</code> <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#VkPhysicalDeviceMaintenance4Properties\">VkPhysicalDeviceMaintenance4Properties</a>::<code>maxBufferSize</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkDedicatedAllocationBufferCreateInfoNV": {
|
|
"(VK_NV_dedicated_allocation)": [
|
|
{
|
|
"vuid": "VUID-VkDedicatedAllocationBufferCreateInfoNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_DEDICATED_ALLOCATION_BUFFER_CREATE_INFO_NV</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkExternalMemoryBufferCreateInfo": {
|
|
"(VK_VERSION_1_1,VK_KHR_external_memory)": [
|
|
{
|
|
"vuid": "VUID-VkExternalMemoryBufferCreateInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_EXTERNAL_MEMORY_BUFFER_CREATE_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkExternalMemoryBufferCreateInfo-handleTypes-parameter",
|
|
"text": " <code>handleTypes</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkExternalMemoryHandleTypeFlagBits\">VkExternalMemoryHandleTypeFlagBits</a> values"
|
|
}
|
|
]
|
|
},
|
|
"VkBufferOpaqueCaptureAddressCreateInfo": {
|
|
"(VK_VERSION_1_2,VK_KHR_buffer_device_address)": [
|
|
{
|
|
"vuid": "VUID-VkBufferOpaqueCaptureAddressCreateInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_BUFFER_OPAQUE_CAPTURE_ADDRESS_CREATE_INFO</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkBufferDeviceAddressCreateInfoEXT": {
|
|
"(VK_EXT_buffer_device_address)": [
|
|
{
|
|
"vuid": "VUID-VkBufferDeviceAddressCreateInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_BUFFER_DEVICE_ADDRESS_CREATE_INFO_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkBufferCollectionBufferCreateInfoFUCHSIA": {
|
|
"(VK_FUCHSIA_buffer_collection)": [
|
|
{
|
|
"vuid": "VUID-VkBufferCollectionBufferCreateInfoFUCHSIA-index-06388",
|
|
"text": " <code>index</code> <strong class=\"purple\">must</strong> be less than <a href=\"#VkBufferCollectionPropertiesFUCHSIA\">VkBufferCollectionPropertiesFUCHSIA</a>::<code>bufferCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferCollectionBufferCreateInfoFUCHSIA-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_BUFFER_COLLECTION_BUFFER_CREATE_INFO_FUCHSIA</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferCollectionBufferCreateInfoFUCHSIA-collection-parameter",
|
|
"text": " <code>collection</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBufferCollectionFUCHSIA\">VkBufferCollectionFUCHSIA</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"vkDestroyBuffer": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkDestroyBuffer-buffer-00922",
|
|
"text": " All submitted commands that refer to <code>buffer</code>, either directly or via a <code>VkBufferView</code>, <strong class=\"purple\">must</strong> have completed execution"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyBuffer-buffer-00923",
|
|
"text": " If <code>VkAllocationCallbacks</code> were provided when <code>buffer</code> was created, a compatible set of callbacks <strong class=\"purple\">must</strong> be provided here"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyBuffer-buffer-00924",
|
|
"text": " If no <code>VkAllocationCallbacks</code> were provided when <code>buffer</code> was created, <code>pAllocator</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyBuffer-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyBuffer-buffer-parameter",
|
|
"text": " If <code>buffer</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>buffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBuffer\">VkBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyBuffer-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyBuffer-buffer-parent",
|
|
"text": " If <code>buffer</code> is a valid handle, it <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCreateBufferView": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCreateBufferView-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateBufferView-pCreateInfo-parameter",
|
|
"text": " <code>pCreateInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkBufferViewCreateInfo\">VkBufferViewCreateInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateBufferView-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateBufferView-pView-parameter",
|
|
"text": " <code>pView</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkBufferView\">VkBufferView</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkBufferViewCreateInfo": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkBufferViewCreateInfo-offset-00925",
|
|
"text": " <code>offset</code> <strong class=\"purple\">must</strong> be less than the size of <code>buffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferViewCreateInfo-range-00928",
|
|
"text": " If <code>range</code> is not equal to <code>VK_WHOLE_SIZE</code>, <code>range</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferViewCreateInfo-range-00929",
|
|
"text": " If <code>range</code> is not equal to <code>VK_WHOLE_SIZE</code>, <code>range</code> <strong class=\"purple\">must</strong> be an integer multiple of the texel block size of <code>format</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferViewCreateInfo-range-00930",
|
|
"text": " If <code>range</code> is not equal to <code>VK_WHOLE_SIZE</code>, the number of texel buffer elements given by <span class=\"eq\">({lfloor}<code>range</code> / (texel block size){rfloor} {times} (texels per block))</span> where texel block size and texels per block are as defined in the <a href=\"#formats-compatibility\">Compatible Formats</a> table for <code>format</code>, <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxTexelBufferElements</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferViewCreateInfo-offset-00931",
|
|
"text": " If <code>range</code> is not equal to <code>VK_WHOLE_SIZE</code>, the sum of <code>offset</code> and <code>range</code> <strong class=\"purple\">must</strong> be less than or equal to the size of <code>buffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferViewCreateInfo-range-04059",
|
|
"text": " If <code>range</code> is equal to <code>VK_WHOLE_SIZE</code>, the number of texel buffer elements given by <span class=\"eq\">({lfloor}(size - <code>offset</code>) / (texel block size){rfloor} {times} (texels per block))</span> where size is the size of <code>buffer</code>, and texel block size and texels per block are as defined in the <a href=\"#formats-compatibility\">Compatible Formats</a> table for <code>format</code>, <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxTexelBufferElements</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferViewCreateInfo-buffer-00932",
|
|
"text": " <code>buffer</code> <strong class=\"purple\">must</strong> have been created with a <code>usage</code> value containing at least one of <code>VK_BUFFER_USAGE_UNIFORM_TEXEL_BUFFER_BIT</code> or <code>VK_BUFFER_USAGE_STORAGE_TEXEL_BUFFER_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferViewCreateInfo-buffer-00933",
|
|
"text": " If <code>buffer</code> was created with <code>usage</code> containing <code>VK_BUFFER_USAGE_UNIFORM_TEXEL_BUFFER_BIT</code>, <code>format</code> <strong class=\"purple\">must</strong> be supported for uniform texel buffers, as specified by the <code>VK_FORMAT_FEATURE_UNIFORM_TEXEL_BUFFER_BIT</code> flag in <code>VkFormatProperties</code>::<code>bufferFeatures</code> returned by <a href=\"#vkGetPhysicalDeviceFormatProperties\">vkGetPhysicalDeviceFormatProperties</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferViewCreateInfo-buffer-00934",
|
|
"text": " If <code>buffer</code> was created with <code>usage</code> containing <code>VK_BUFFER_USAGE_STORAGE_TEXEL_BUFFER_BIT</code>, <code>format</code> <strong class=\"purple\">must</strong> be supported for storage texel buffers, as specified by the <code>VK_FORMAT_FEATURE_STORAGE_TEXEL_BUFFER_BIT</code> flag in <code>VkFormatProperties</code>::<code>bufferFeatures</code> returned by <a href=\"#vkGetPhysicalDeviceFormatProperties\">vkGetPhysicalDeviceFormatProperties</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferViewCreateInfo-buffer-00935",
|
|
"text": " If <code>buffer</code> is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferViewCreateInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_BUFFER_VIEW_CREATE_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferViewCreateInfo-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkExportMetalObjectCreateInfoEXT\">VkExportMetalObjectCreateInfoEXT</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferViewCreateInfo-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique, with the exception of structures of type <a href=\"#VkExportMetalObjectCreateInfoEXT\">VkExportMetalObjectCreateInfoEXT</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferViewCreateInfo-flags-zerobitmask",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferViewCreateInfo-buffer-parameter",
|
|
"text": " <code>buffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBuffer\">VkBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferViewCreateInfo-format-parameter",
|
|
"text": " <code>format</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkFormat\">VkFormat</a> value"
|
|
}
|
|
],
|
|
"!(VK_VERSION_1_3,VK_EXT_texel_buffer_alignment)": [
|
|
{
|
|
"vuid": "VUID-VkBufferViewCreateInfo-offset-00926",
|
|
"text": " <code>offset</code> <strong class=\"purple\">must</strong> be a multiple of <code>VkPhysicalDeviceLimits</code>::<code>minTexelBufferOffsetAlignment</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_texel_buffer_alignment)": [
|
|
{
|
|
"vuid": "VUID-VkBufferViewCreateInfo-offset-02749",
|
|
"text": " If the <a href=\"#features-texelBufferAlignment\"><code>texelBufferAlignment</code></a> feature is not enabled, <code>offset</code> <strong class=\"purple\">must</strong> be a multiple of <code>VkPhysicalDeviceLimits</code>::<code>minTexelBufferOffsetAlignment</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferViewCreateInfo-buffer-02750",
|
|
"text": " If the <a href=\"#features-texelBufferAlignment\"><code>texelBufferAlignment</code></a> feature is enabled and if <code>buffer</code> was created with <code>usage</code> containing <code>VK_BUFFER_USAGE_STORAGE_TEXEL_BUFFER_BIT</code>, <code>offset</code> <strong class=\"purple\">must</strong> be a multiple of the lesser of <a href=\"#VkPhysicalDeviceTexelBufferAlignmentProperties\">VkPhysicalDeviceTexelBufferAlignmentProperties</a>::<code>storageTexelBufferOffsetAlignmentBytes</code> or, if <a href=\"#VkPhysicalDeviceTexelBufferAlignmentProperties\">VkPhysicalDeviceTexelBufferAlignmentProperties</a>::<code>storageTexelBufferOffsetSingleTexelAlignment</code> is <code>VK_TRUE</code>, the size of a texel of the requested <code>format</code>. If the size of a texel is a multiple of three bytes, then the size of a single component of <code>format</code> is used instead"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferViewCreateInfo-buffer-02751",
|
|
"text": " If the <a href=\"#features-texelBufferAlignment\"><code>texelBufferAlignment</code></a> feature is enabled and if <code>buffer</code> was created with <code>usage</code> containing <code>VK_BUFFER_USAGE_UNIFORM_TEXEL_BUFFER_BIT</code>, <code>offset</code> <strong class=\"purple\">must</strong> be a multiple of the lesser of <a href=\"#VkPhysicalDeviceTexelBufferAlignmentProperties\">VkPhysicalDeviceTexelBufferAlignmentProperties</a>::<code>uniformTexelBufferOffsetAlignmentBytes</code> or, if <a href=\"#VkPhysicalDeviceTexelBufferAlignmentProperties\">VkPhysicalDeviceTexelBufferAlignmentProperties</a>::<code>uniformTexelBufferOffsetSingleTexelAlignment</code> is <code>VK_TRUE</code>, the size of a texel of the requested <code>format</code>. If the size of a texel is a multiple of three bytes, then the size of a single component of <code>format</code> is used instead"
|
|
}
|
|
],
|
|
"(VK_EXT_metal_objects)": [
|
|
{
|
|
"vuid": "VUID-VkBufferViewCreateInfo-pNext-06782",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkExportMetalObjectCreateInfoEXT\">VkExportMetalObjectCreateInfoEXT</a> structure, its <code>exportObjectType</code> member <strong class=\"purple\">must</strong> be <code>VK_EXPORT_METAL_OBJECT_TYPE_METAL_TEXTURE_BIT_EXT</code>."
|
|
}
|
|
]
|
|
},
|
|
"vkDestroyBufferView": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkDestroyBufferView-bufferView-00936",
|
|
"text": " All submitted commands that refer to <code>bufferView</code> <strong class=\"purple\">must</strong> have completed execution"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyBufferView-bufferView-00937",
|
|
"text": " If <code>VkAllocationCallbacks</code> were provided when <code>bufferView</code> was created, a compatible set of callbacks <strong class=\"purple\">must</strong> be provided here"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyBufferView-bufferView-00938",
|
|
"text": " If no <code>VkAllocationCallbacks</code> were provided when <code>bufferView</code> was created, <code>pAllocator</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyBufferView-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyBufferView-bufferView-parameter",
|
|
"text": " If <code>bufferView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>bufferView</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBufferView\">VkBufferView</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyBufferView-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyBufferView-bufferView-parent",
|
|
"text": " If <code>bufferView</code> is a valid handle, it <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCreateImage": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCreateImage-flags-00939",
|
|
"text": " If the <code>flags</code> member of <code>pCreateInfo</code> includes <code>VK_IMAGE_CREATE_SPARSE_BINDING_BIT</code>, creating this <code>VkImage</code> <strong class=\"purple\">must</strong> not cause the total required sparse memory for all currently valid sparse resources on the device to exceed <code>VkPhysicalDeviceLimits</code>::<code>sparseAddressSpaceSize</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateImage-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateImage-pCreateInfo-parameter",
|
|
"text": " <code>pCreateInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateImage-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateImage-pImage-parameter",
|
|
"text": " <code>pImage</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkImage\">VkImage</a> handle"
|
|
}
|
|
],
|
|
"(VK_FUCHSIA_buffer_collection)": [
|
|
{
|
|
"vuid": "VUID-vkCreateImage-pNext-06389",
|
|
"text": " If a <a href=\"#VkBufferCollectionImageCreateInfoFUCHSIA\">VkBufferCollectionImageCreateInfoFUCHSIA</a> has been chained to <code>pNext</code>, <code>pCreateInfo</code> <strong class=\"purple\">must</strong> match the <a href=\"#sysmem-chosen-create-infos\">Sysmem chosen <code>VkImageCreateInfo</code></a> excepting members <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a>::<code>extent</code> and <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a>::<code>usage</code> in the match criteria"
|
|
}
|
|
]
|
|
},
|
|
"VkImageCreateInfo": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-imageCreateMaxMipLevels-02251",
|
|
"text": " Each of the following values (as described in <a href=\"#resources-image-creation-limits\">Image Creation Limits</a>) <strong class=\"purple\">must</strong> not be undefined : <code>imageCreateMaxMipLevels</code>, <code>imageCreateMaxArrayLayers</code>, <code>imageCreateMaxExtent</code>, and <code>imageCreateSampleCounts</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-sharingMode-00941",
|
|
"text": " If <code>sharingMode</code> is <code>VK_SHARING_MODE_CONCURRENT</code>, <code>pQueueFamilyIndices</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>queueFamilyIndexCount</code> <code>uint32_t</code> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-sharingMode-00942",
|
|
"text": " If <code>sharingMode</code> is <code>VK_SHARING_MODE_CONCURRENT</code>, <code>queueFamilyIndexCount</code> <strong class=\"purple\">must</strong> be greater than <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-extent-00944",
|
|
"text": " <code>extent.width</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-extent-00945",
|
|
"text": " <code>extent.height</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-extent-00946",
|
|
"text": " <code>extent.depth</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-mipLevels-00947",
|
|
"text": " <code>mipLevels</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-arrayLayers-00948",
|
|
"text": " <code>arrayLayers</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-flags-00949",
|
|
"text": " If <code>flags</code> contains <code>VK_IMAGE_CREATE_CUBE_COMPATIBLE_BIT</code>, <code>imageType</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_TYPE_2D</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-extent-02252",
|
|
"text": " <code>extent.width</code> <strong class=\"purple\">must</strong> be less than or equal to <code>imageCreateMaxExtent.width</code> (as defined in <a href=\"#resources-image-creation-limits\">Image Creation Limits</a>)"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-extent-02253",
|
|
"text": " <code>extent.height</code> <strong class=\"purple\">must</strong> be less than or equal to <code>imageCreateMaxExtent.height</code> (as defined in <a href=\"#resources-image-creation-limits\">Image Creation Limits</a>)"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-extent-02254",
|
|
"text": " <code>extent.depth</code> <strong class=\"purple\">must</strong> be less than or equal to <code>imageCreateMaxExtent.depth</code> (as defined in <a href=\"#resources-image-creation-limits\">Image Creation Limits</a>)"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-imageType-00954",
|
|
"text": " If <code>imageType</code> is <code>VK_IMAGE_TYPE_2D</code> and <code>flags</code> contains <code>VK_IMAGE_CREATE_CUBE_COMPATIBLE_BIT</code>, <code>extent.width</code> and <code>extent.height</code> <strong class=\"purple\">must</strong> be equal and <code>arrayLayers</code> <strong class=\"purple\">must</strong> be greater than or equal to 6"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-imageType-00956",
|
|
"text": " If <code>imageType</code> is <code>VK_IMAGE_TYPE_1D</code>, both <code>extent.height</code> and <code>extent.depth</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-imageType-00957",
|
|
"text": " If <code>imageType</code> is <code>VK_IMAGE_TYPE_2D</code>, <code>extent.depth</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-mipLevels-00958",
|
|
"text": " <code>mipLevels</code> <strong class=\"purple\">must</strong> be less than or equal to the number of levels in the complete mipmap chain based on <span class=\"eq\"><code>extent.width</code></span>, <span class=\"eq\"><code>extent.height</code></span>, and <span class=\"eq\"><code>extent.depth</code></span>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-mipLevels-02255",
|
|
"text": " <code>mipLevels</code> <strong class=\"purple\">must</strong> be less than or equal to <code>imageCreateMaxMipLevels</code> (as defined in <a href=\"#resources-image-creation-limits\">Image Creation Limits</a>)"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-arrayLayers-02256",
|
|
"text": " <code>arrayLayers</code> <strong class=\"purple\">must</strong> be less than or equal to <code>imageCreateMaxArrayLayers</code> (as defined in <a href=\"#resources-image-creation-limits\">Image Creation Limits</a>)"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-imageType-00961",
|
|
"text": " If <code>imageType</code> is <code>VK_IMAGE_TYPE_3D</code>, <code>arrayLayers</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-samples-02257",
|
|
"text": " If <code>samples</code> is not <code>VK_SAMPLE_COUNT_1_BIT</code>, then <code>imageType</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_TYPE_2D</code>, <code>flags</code> <strong class=\"purple\">must</strong> not contain <code>VK_IMAGE_CREATE_CUBE_COMPATIBLE_BIT</code>, <code>mipLevels</code> <strong class=\"purple\">must</strong> be equal to <code>1</code>, and <code>imageCreateMaybeLinear</code> (as defined in <a href=\"#resources-image-creation-limits\">Image Creation Limits</a>) <strong class=\"purple\">must</strong> be <code>VK_FALSE</code>,"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-usage-00963",
|
|
"text": " If <code>usage</code> includes <code>VK_IMAGE_USAGE_TRANSIENT_ATTACHMENT_BIT</code>, then bits other than <code>VK_IMAGE_USAGE_COLOR_ATTACHMENT_BIT</code>, <code>VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT</code>, and <code>VK_IMAGE_USAGE_INPUT_ATTACHMENT_BIT</code> <strong class=\"purple\">must</strong> not be set"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-usage-00964",
|
|
"text": " If <code>usage</code> includes <code>VK_IMAGE_USAGE_COLOR_ATTACHMENT_BIT</code>, <code>VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT</code>, <code>VK_IMAGE_USAGE_TRANSIENT_ATTACHMENT_BIT</code>, or <code>VK_IMAGE_USAGE_INPUT_ATTACHMENT_BIT</code>, <code>extent.width</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxFramebufferWidth</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-usage-00965",
|
|
"text": " If <code>usage</code> includes <code>VK_IMAGE_USAGE_COLOR_ATTACHMENT_BIT</code>, <code>VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT</code>, <code>VK_IMAGE_USAGE_TRANSIENT_ATTACHMENT_BIT</code>, or <code>VK_IMAGE_USAGE_INPUT_ATTACHMENT_BIT</code>, <code>extent.height</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxFramebufferHeight</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-usage-00966",
|
|
"text": " If <code>usage</code> includes <code>VK_IMAGE_USAGE_TRANSIENT_ATTACHMENT_BIT</code>, <code>usage</code> <strong class=\"purple\">must</strong> also contain at least one of <code>VK_IMAGE_USAGE_COLOR_ATTACHMENT_BIT</code>, <code>VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT</code>, or <code>VK_IMAGE_USAGE_INPUT_ATTACHMENT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-samples-02258",
|
|
"text": " <code>samples</code> <strong class=\"purple\">must</strong> be a bit value that is set in <code>imageCreateSampleCounts</code> (as defined in <a href=\"#resources-image-creation-limits\">Image Creation Limits</a>)"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-usage-00968",
|
|
"text": " If the <a href=\"#features-shaderStorageImageMultisample\"><code>shaderStorageImageMultisample</code></a> feature is not enabled, and <code>usage</code> contains <code>VK_IMAGE_USAGE_STORAGE_BIT</code>, <code>samples</code> <strong class=\"purple\">must</strong> be <code>VK_SAMPLE_COUNT_1_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-flags-00969",
|
|
"text": " If the <a href=\"#features-sparseBinding\"><code>sparseBinding</code></a> feature is not enabled, <code>flags</code> <strong class=\"purple\">must</strong> not contain <code>VK_IMAGE_CREATE_SPARSE_BINDING_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-flags-01924",
|
|
"text": " If the <a href=\"#features-sparseResidencyAliased\"><code>sparseResidencyAliased</code></a> feature is not enabled, <code>flags</code> <strong class=\"purple\">must</strong> not contain <code>VK_IMAGE_CREATE_SPARSE_ALIASED_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-tiling-04121",
|
|
"text": " If <code>tiling</code> is <code>VK_IMAGE_TILING_LINEAR</code>, <code>flags</code> <strong class=\"purple\">must</strong> not contain <code>VK_IMAGE_CREATE_SPARSE_RESIDENCY_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-imageType-00970",
|
|
"text": " If <code>imageType</code> is <code>VK_IMAGE_TYPE_1D</code>, <code>flags</code> <strong class=\"purple\">must</strong> not contain <code>VK_IMAGE_CREATE_SPARSE_RESIDENCY_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-imageType-00971",
|
|
"text": " If the <a href=\"#features-sparseResidencyImage2D\"><code>sparseResidencyImage2D</code></a> feature is not enabled, and <code>imageType</code> is <code>VK_IMAGE_TYPE_2D</code>, <code>flags</code> <strong class=\"purple\">must</strong> not contain <code>VK_IMAGE_CREATE_SPARSE_RESIDENCY_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-imageType-00972",
|
|
"text": " If the <a href=\"#features-sparseResidencyImage3D\"><code>sparseResidencyImage3D</code></a> feature is not enabled, and <code>imageType</code> is <code>VK_IMAGE_TYPE_3D</code>, <code>flags</code> <strong class=\"purple\">must</strong> not contain <code>VK_IMAGE_CREATE_SPARSE_RESIDENCY_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-imageType-00973",
|
|
"text": " If the <a href=\"#features-sparseResidency2Samples\"><code>sparseResidency2Samples</code></a> feature is not enabled, <code>imageType</code> is <code>VK_IMAGE_TYPE_2D</code>, and <code>samples</code> is <code>VK_SAMPLE_COUNT_2_BIT</code>, <code>flags</code> <strong class=\"purple\">must</strong> not contain <code>VK_IMAGE_CREATE_SPARSE_RESIDENCY_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-imageType-00974",
|
|
"text": " If the <a href=\"#features-sparseResidency4Samples\"><code>sparseResidency4Samples</code></a> feature is not enabled, <code>imageType</code> is <code>VK_IMAGE_TYPE_2D</code>, and <code>samples</code> is <code>VK_SAMPLE_COUNT_4_BIT</code>, <code>flags</code> <strong class=\"purple\">must</strong> not contain <code>VK_IMAGE_CREATE_SPARSE_RESIDENCY_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-imageType-00975",
|
|
"text": " If the <a href=\"#features-sparseResidency8Samples\"><code>sparseResidency8Samples</code></a> feature is not enabled, <code>imageType</code> is <code>VK_IMAGE_TYPE_2D</code>, and <code>samples</code> is <code>VK_SAMPLE_COUNT_8_BIT</code>, <code>flags</code> <strong class=\"purple\">must</strong> not contain <code>VK_IMAGE_CREATE_SPARSE_RESIDENCY_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-imageType-00976",
|
|
"text": " If the <a href=\"#features-sparseResidency16Samples\"><code>sparseResidency16Samples</code></a> feature is not enabled, <code>imageType</code> is <code>VK_IMAGE_TYPE_2D</code>, and <code>samples</code> is <code>VK_SAMPLE_COUNT_16_BIT</code>, <code>flags</code> <strong class=\"purple\">must</strong> not contain <code>VK_IMAGE_CREATE_SPARSE_RESIDENCY_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-flags-00987",
|
|
"text": " If <code>flags</code> contains <code>VK_IMAGE_CREATE_SPARSE_RESIDENCY_BIT</code> or <code>VK_IMAGE_CREATE_SPARSE_ALIASED_BIT</code>, it <strong class=\"purple\">must</strong> also contain <code>VK_IMAGE_CREATE_SPARSE_BINDING_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-None-01925",
|
|
"text": " If any of the bits <code>VK_IMAGE_CREATE_SPARSE_BINDING_BIT</code>, <code>VK_IMAGE_CREATE_SPARSE_RESIDENCY_BIT</code>, or <code>VK_IMAGE_CREATE_SPARSE_ALIASED_BIT</code> are set, <code>VK_IMAGE_USAGE_TRANSIENT_ATTACHMENT_BIT</code> <strong class=\"purple\">must</strong> not also be set"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-initialLayout-00993",
|
|
"text": " <code>initialLayout</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_LAYOUT_UNDEFINED</code> or <code>VK_IMAGE_LAYOUT_PREINITIALIZED</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_IMAGE_CREATE_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-pNext-pNext",
|
|
"text": " Each <code>pNext</code> member of any structure (including this one) in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be either <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkBufferCollectionImageCreateInfoFUCHSIA\">VkBufferCollectionImageCreateInfoFUCHSIA</a>, <a href=\"#VkDedicatedAllocationImageCreateInfoNV\">VkDedicatedAllocationImageCreateInfoNV</a>, <a href=\"#VkExportMetalObjectCreateInfoEXT\">VkExportMetalObjectCreateInfoEXT</a>, <a href=\"#VkExternalFormatANDROID\">VkExternalFormatANDROID</a>, <a href=\"#VkExternalMemoryImageCreateInfo\">VkExternalMemoryImageCreateInfo</a>, <a href=\"#VkExternalMemoryImageCreateInfoNV\">VkExternalMemoryImageCreateInfoNV</a>, <a href=\"#VkImageCompressionControlEXT\">VkImageCompressionControlEXT</a>, <a href=\"#VkImageDrmFormatModifierExplicitCreateInfoEXT\">VkImageDrmFormatModifierExplicitCreateInfoEXT</a>, <a href=\"#VkImageDrmFormatModifierListCreateInfoEXT\">VkImageDrmFormatModifierListCreateInfoEXT</a>, <a href=\"#VkImageFormatListCreateInfo\">VkImageFormatListCreateInfo</a>, <a href=\"#VkImageStencilUsageCreateInfo\">VkImageStencilUsageCreateInfo</a>, <a href=\"#VkImageSwapchainCreateInfoKHR\">VkImageSwapchainCreateInfoKHR</a>, <a href=\"#VkImportMetalIOSurfaceInfoEXT\">VkImportMetalIOSurfaceInfoEXT</a>, <a href=\"#VkImportMetalTextureInfoEXT\">VkImportMetalTextureInfoEXT</a>, or <a href=\"#VkVideoProfilesKHR\">VkVideoProfilesKHR</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique, with the exception of structures of type <a href=\"#VkExportMetalObjectCreateInfoEXT\">VkExportMetalObjectCreateInfoEXT</a> or <a href=\"#VkImportMetalTextureInfoEXT\">VkImportMetalTextureInfoEXT</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkImageCreateFlagBits\">VkImageCreateFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-imageType-parameter",
|
|
"text": " <code>imageType</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageType\">VkImageType</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-format-parameter",
|
|
"text": " <code>format</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkFormat\">VkFormat</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-samples-parameter",
|
|
"text": " <code>samples</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSampleCountFlagBits\">VkSampleCountFlagBits</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-tiling-parameter",
|
|
"text": " <code>tiling</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageTiling\">VkImageTiling</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-usage-parameter",
|
|
"text": " <code>usage</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkImageUsageFlagBits\">VkImageUsageFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-usage-requiredbitmask",
|
|
"text": " <code>usage</code> <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-sharingMode-parameter",
|
|
"text": " <code>sharingMode</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSharingMode\">VkSharingMode</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-initialLayout-parameter",
|
|
"text": " <code>initialLayout</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageLayout\">VkImageLayout</a> value"
|
|
}
|
|
],
|
|
"!(VK_VERSION_1_1,VK_KHR_get_physical_device_properties2)": [
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-sharingMode-01392",
|
|
"text": " If <code>sharingMode</code> is <code>VK_SHARING_MODE_CONCURRENT</code>, each element of <code>pQueueFamilyIndices</code> <strong class=\"purple\">must</strong> be unique and <strong class=\"purple\">must</strong> be less than <code>pQueueFamilyPropertyCount</code> returned by <a href=\"#vkGetPhysicalDeviceQueueFamilyProperties\">vkGetPhysicalDeviceQueueFamilyProperties</a> for the <code>physicalDevice</code> that was used to create <code>device</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_get_physical_device_properties2)": [
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-sharingMode-01420",
|
|
"text": " If <code>sharingMode</code> is <code>VK_SHARING_MODE_CONCURRENT</code>, each element of <code>pQueueFamilyIndices</code> <strong class=\"purple\">must</strong> be unique and <strong class=\"purple\">must</strong> be less than <code>pQueueFamilyPropertyCount</code> returned by either <a href=\"#vkGetPhysicalDeviceQueueFamilyProperties\">vkGetPhysicalDeviceQueueFamilyProperties</a> or <a href=\"#vkGetPhysicalDeviceQueueFamilyProperties2\">vkGetPhysicalDeviceQueueFamilyProperties2</a> for the <code>physicalDevice</code> that was used to create <code>device</code>"
|
|
}
|
|
],
|
|
"!(VK_ANDROID_external_memory_android_hardware_buffer)": [
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-format-00943",
|
|
"text": " <code>format</code> <strong class=\"purple\">must</strong> not be <code>VK_FORMAT_UNDEFINED</code>"
|
|
}
|
|
],
|
|
"(VK_ANDROID_external_memory_android_hardware_buffer)": [
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-pNext-01974",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkExternalFormatANDROID\">VkExternalFormatANDROID</a> structure, and its <code>externalFormat</code> member is non-zero the <code>format</code> <strong class=\"purple\">must</strong> be <code>VK_FORMAT_UNDEFINED</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-pNext-01975",
|
|
"text": " If the <code>pNext</code> chain does not include a <a href=\"#VkExternalFormatANDROID\">VkExternalFormatANDROID</a> structure, or does and its <code>externalFormat</code> member is <code>0</code>, the <code>format</code> <strong class=\"purple\">must</strong> not be <code>VK_FORMAT_UNDEFINED</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-pNext-02393",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkExternalMemoryImageCreateInfo\">VkExternalMemoryImageCreateInfo</a> structure whose <code>handleTypes</code> member includes <code>VK_EXTERNAL_MEMORY_HANDLE_TYPE_ANDROID_HARDWARE_BUFFER_BIT_ANDROID</code>, <code>imageType</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_TYPE_2D</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-pNext-02394",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkExternalMemoryImageCreateInfo\">VkExternalMemoryImageCreateInfo</a> structure whose <code>handleTypes</code> member includes <code>VK_EXTERNAL_MEMORY_HANDLE_TYPE_ANDROID_HARDWARE_BUFFER_BIT_ANDROID</code>, <code>mipLevels</code> <strong class=\"purple\">must</strong> either be <code>1</code> or equal to the number of levels in the complete mipmap chain based on <span class=\"eq\"><code>extent.width</code></span>, <span class=\"eq\"><code>extent.height</code></span>, and <span class=\"eq\"><code>extent.depth</code></span>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-pNext-02396",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkExternalFormatANDROID\">VkExternalFormatANDROID</a> structure whose <code>externalFormat</code> member is not <code>0</code>, <code>flags</code> <strong class=\"purple\">must</strong> not include <code>VK_IMAGE_CREATE_MUTABLE_FORMAT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-pNext-02397",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkExternalFormatANDROID\">VkExternalFormatANDROID</a> structure whose <code>externalFormat</code> member is not <code>0</code>, <code>usage</code> <strong class=\"purple\">must</strong> not include any usages except <code>VK_IMAGE_USAGE_SAMPLED_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-pNext-02398",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkExternalFormatANDROID\">VkExternalFormatANDROID</a> structure whose <code>externalFormat</code> member is not <code>0</code>, <code>tiling</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_TILING_OPTIMAL</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_fragment_density_map)": [
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-flags-02557",
|
|
"text": " If <code>flags</code> contains <code>VK_IMAGE_USAGE_FRAGMENT_DENSITY_MAP_BIT_EXT</code>, <code>imageType</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_TYPE_2D</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-samples-02558",
|
|
"text": " If <code>samples</code> is not <code>VK_SAMPLE_COUNT_1_BIT</code>, <code>usage</code> <strong class=\"purple\">must</strong> not contain <code>VK_IMAGE_USAGE_FRAGMENT_DENSITY_MAP_BIT_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-flags-02565",
|
|
"text": " If <code>flags</code> contains <code>VK_IMAGE_CREATE_SUBSAMPLED_BIT_EXT</code>, <code>tiling</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_TILING_OPTIMAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-flags-02566",
|
|
"text": " If <code>flags</code> contains <code>VK_IMAGE_CREATE_SUBSAMPLED_BIT_EXT</code>, <code>imageType</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_TYPE_2D</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-flags-02567",
|
|
"text": " If <code>flags</code> contains <code>VK_IMAGE_CREATE_SUBSAMPLED_BIT_EXT</code>, <code>flags</code> <strong class=\"purple\">must</strong> not contain <code>VK_IMAGE_CREATE_CUBE_COMPATIBLE_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-flags-02568",
|
|
"text": " If <code>flags</code> contains <code>VK_IMAGE_CREATE_SUBSAMPLED_BIT_EXT</code>, <code>mipLevels</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_maintenance1)": [
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-flags-00950",
|
|
"text": " If <code>flags</code> contains <code>VK_IMAGE_CREATE_2D_ARRAY_COMPATIBLE_BIT</code>, <code>imageType</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_TYPE_3D</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_fragment_density_map)+!(VK_QCOM_fragment_density_map_offset)": [
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-usage-02559",
|
|
"text": " If <code>usage</code> includes <code>VK_IMAGE_USAGE_FRAGMENT_DENSITY_MAP_BIT_EXT</code>, <code>extent.width</code> <strong class=\"purple\">must</strong> be less than or equal to \\(\\left\\lceil{\\frac{maxFramebufferWidth}{minFragmentDensityTexelSize_{width}}}\\right\\rceil\\)"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-usage-02560",
|
|
"text": " If <code>usage</code> includes <code>VK_IMAGE_USAGE_FRAGMENT_DENSITY_MAP_BIT_EXT</code>, <code>extent.height</code> <strong class=\"purple\">must</strong> be less than or equal to \\(\\left\\lceil{\\frac{maxFramebufferHeight}{minFragmentDensityTexelSize_{height}}}\\right\\rceil\\)"
|
|
}
|
|
],
|
|
"(VK_EXT_fragment_density_map)+(VK_QCOM_fragment_density_map_offset)": [
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-fragmentDensityMapOffset-06514",
|
|
"text": " If the <a href=\"#features-fragmentDensityMapOffset\"><code>fragmentDensityMapOffset</code></a> feature is not enabled and <code>usage</code> includes <code>VK_IMAGE_USAGE_FRAGMENT_DENSITY_MAP_BIT_EXT</code>, <code>extent.width</code> <strong class=\"purple\">must</strong> be less than or equal to \\(\\left\\lceil{\\frac{maxFramebufferWidth}{minFragmentDensityTexelSize_{width}}}\\right\\rceil\\)"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-fragmentDensityMapOffset-06515",
|
|
"text": " If the <a href=\"#features-fragmentDensityMapOffset\"><code>fragmentDensityMapOffset</code></a> feature is not enabled and <code>usage</code> includes <code>VK_IMAGE_USAGE_FRAGMENT_DENSITY_MAP_BIT_EXT</code>, <code>extent.height</code> <strong class=\"purple\">must</strong> be less than or equal to \\(\\left\\lceil{\\frac{maxFramebufferHeight}{minFragmentDensityTexelSize_{height}}}\\right\\rceil\\)"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-flags-01890",
|
|
"text": " If the <a href=\"#features-protectedMemory\"><code>protectedMemory</code></a> feature is not enabled, <code>flags</code> <strong class=\"purple\">must</strong> not contain <code>VK_IMAGE_CREATE_PROTECTED_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-None-01891",
|
|
"text": " If any of the bits <code>VK_IMAGE_CREATE_SPARSE_BINDING_BIT</code>, <code>VK_IMAGE_CREATE_SPARSE_RESIDENCY_BIT</code>, or <code>VK_IMAGE_CREATE_SPARSE_ALIASED_BIT</code> are set, <code>VK_IMAGE_CREATE_PROTECTED_BIT</code> <strong class=\"purple\">must</strong> not also be set"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_external_memory)+(VK_NV_external_memory)": [
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-pNext-00988",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkExternalMemoryImageCreateInfoNV\">VkExternalMemoryImageCreateInfoNV</a> structure, it <strong class=\"purple\">must</strong> not contain a <a href=\"#VkExternalMemoryImageCreateInfo\">VkExternalMemoryImageCreateInfo</a> structure"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_external_memory)": [
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-pNext-00990",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkExternalMemoryImageCreateInfo\">VkExternalMemoryImageCreateInfo</a> structure, its <code>handleTypes</code> member <strong class=\"purple\">must</strong> only contain bits that are also in <a href=\"#VkExternalImageFormatProperties\">VkExternalImageFormatProperties</a>::<code>externalMemoryProperties.compatibleHandleTypes</code>, as returned by <a href=\"#vkGetPhysicalDeviceImageFormatProperties2\">vkGetPhysicalDeviceImageFormatProperties2</a> with <code>format</code>, <code>imageType</code>, <code>tiling</code>, <code>usage</code>, and <code>flags</code> equal to those in this structure, and with a <a href=\"#VkPhysicalDeviceExternalImageFormatInfo\">VkPhysicalDeviceExternalImageFormatInfo</a> structure included in the <code>pNext</code> chain, with a <code>handleType</code> equal to any one of the handle types specified in <a href=\"#VkExternalMemoryImageCreateInfo\">VkExternalMemoryImageCreateInfo</a>::<code>handleTypes</code>"
|
|
}
|
|
],
|
|
"(VK_NV_external_memory+VK_NV_external_memory_capabilities)": [
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-pNext-00991",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkExternalMemoryImageCreateInfoNV\">VkExternalMemoryImageCreateInfoNV</a> structure, its <code>handleTypes</code> member <strong class=\"purple\">must</strong> only contain bits that are also in <a href=\"#VkExternalImageFormatPropertiesNV\">VkExternalImageFormatPropertiesNV</a>::<code>externalMemoryProperties.compatibleHandleTypes</code>, as returned by <a href=\"#vkGetPhysicalDeviceExternalImageFormatPropertiesNV\">vkGetPhysicalDeviceExternalImageFormatPropertiesNV</a> with <code>format</code>, <code>imageType</code>, <code>tiling</code>, <code>usage</code>, and <code>flags</code> equal to those in this structure, and with <code>externalHandleType</code> equal to any one of the handle types specified in <a href=\"#VkExternalMemoryImageCreateInfoNV\">VkExternalMemoryImageCreateInfoNV</a>::<code>handleTypes</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_device_group)": [
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-physicalDeviceCount-01421",
|
|
"text": " If the logical device was created with <a href=\"#VkDeviceGroupDeviceCreateInfo\">VkDeviceGroupDeviceCreateInfo</a>::<code>physicalDeviceCount</code> equal to 1, <code>flags</code> <strong class=\"purple\">must</strong> not contain <code>VK_IMAGE_CREATE_SPLIT_INSTANCE_BIND_REGIONS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-flags-02259",
|
|
"text": " If <code>flags</code> contains <code>VK_IMAGE_CREATE_SPLIT_INSTANCE_BIND_REGIONS_BIT</code>, then <code>mipLevels</code> <strong class=\"purple\">must</strong> be one, <code>arrayLayers</code> <strong class=\"purple\">must</strong> be one, <code>imageType</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_TYPE_2D</code>. and <code>imageCreateMaybeLinear</code> (as defined in <a href=\"#resources-image-creation-limits\">Image Creation Limits</a>) <strong class=\"purple\">must</strong> be <code>VK_FALSE</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_maintenance2)": [
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-flags-01572",
|
|
"text": " If <code>flags</code> contains <code>VK_IMAGE_CREATE_BLOCK_TEXEL_VIEW_COMPATIBLE_BIT</code>, then <code>format</code> <strong class=\"purple\">must</strong> be a <a href=\"#compressed_image_formats\">compressed image format</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-flags-01573",
|
|
"text": " If <code>flags</code> contains <code>VK_IMAGE_CREATE_BLOCK_TEXEL_VIEW_COMPATIBLE_BIT</code>, then <code>flags</code> <strong class=\"purple\">must</strong> also contain <code>VK_IMAGE_CREATE_MUTABLE_FORMAT_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_external_memory,VK_NV_external_memory)": [
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-pNext-01443",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkExternalMemoryImageCreateInfo\">VkExternalMemoryImageCreateInfo</a> or <code>VkExternalMemoryImageCreateInfoNV</code> structure whose <code>handleTypes</code> member is not <code>0</code>, <code>initialLayout</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_LAYOUT_UNDEFINED</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-format-06410",
|
|
"text": " If the image <code>format</code> is one of the <a href=\"#formats-requiring-sampler-ycbcr-conversion\">formats that require a sampler {YCbCr} conversion</a>, <code>mipLevels</code> <strong class=\"purple\">must</strong> be 1"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-format-06411",
|
|
"text": " If the image <code>format</code> is one of the <a href=\"#formats-requiring-sampler-ycbcr-conversion\">formats that require a sampler {YCbCr} conversion</a>, <code>samples</code> <strong class=\"purple\">must</strong> be <code>VK_SAMPLE_COUNT_1_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-format-06412",
|
|
"text": " If the image <code>format</code> is one of the <a href=\"#formats-requiring-sampler-ycbcr-conversion\">formats that require a sampler {YCbCr} conversion</a>, <code>imageType</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_TYPE_2D</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-imageCreateFormatFeatures-02260",
|
|
"text": " If <code>format</code> is a <em>multi-planar</em> format, and if <code>imageCreateFormatFeatures</code> (as defined in <a href=\"#resources-image-creation-limits\">Image Creation Limits</a>) does not contain <code>VK_FORMAT_FEATURE_DISJOINT_BIT</code>, then <code>flags</code> <strong class=\"purple\">must</strong> not contain <code>VK_IMAGE_CREATE_DISJOINT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-format-01577",
|
|
"text": " If <code>format</code> is not a <em>multi-planar</em> format, and <code>flags</code> does not include <code>VK_IMAGE_CREATE_ALIAS_BIT</code>, <code>flags</code> <strong class=\"purple\">must</strong> not contain <code>VK_IMAGE_CREATE_DISJOINT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-format-04712",
|
|
"text": " If <code>format</code> has a <code>_422</code> or <code>_420</code> suffix, <code>width</code> <strong class=\"purple\">must</strong> be a multiple of 2"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-format-04713",
|
|
"text": " If <code>format</code> has a <code>_420</code> suffix, <code>height</code> <strong class=\"purple\">must</strong> be a multiple of 2"
|
|
}
|
|
],
|
|
"(VK_EXT_image_drm_format_modifier)": [
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-tiling-02261",
|
|
"text": " If <code>tiling</code> is <code>VK_IMAGE_TILING_DRM_FORMAT_MODIFIER_EXT</code>, then the <code>pNext</code> chain <strong class=\"purple\">must</strong> include exactly one of <a href=\"#VkImageDrmFormatModifierListCreateInfoEXT\">VkImageDrmFormatModifierListCreateInfoEXT</a> or <a href=\"#VkImageDrmFormatModifierExplicitCreateInfoEXT\">VkImageDrmFormatModifierExplicitCreateInfoEXT</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-pNext-02262",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkImageDrmFormatModifierListCreateInfoEXT\">VkImageDrmFormatModifierListCreateInfoEXT</a> or <a href=\"#VkImageDrmFormatModifierExplicitCreateInfoEXT\">VkImageDrmFormatModifierExplicitCreateInfoEXT</a> structure, then <code>tiling</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_TILING_DRM_FORMAT_MODIFIER_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-tiling-02353",
|
|
"text": " If <code>tiling</code> is <code>VK_IMAGE_TILING_DRM_FORMAT_MODIFIER_EXT</code> and <code>flags</code> contains <code>VK_IMAGE_CREATE_MUTABLE_FORMAT_BIT</code>, then the <code>pNext</code> chain <strong class=\"purple\">must</strong> include a <a href=\"#VkImageFormatListCreateInfo\">VkImageFormatListCreateInfo</a> structure with non-zero <code>viewFormatCount</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_sample_locations)": [
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-flags-01533",
|
|
"text": " If <code>flags</code> contains <code>VK_IMAGE_CREATE_SAMPLE_LOCATIONS_COMPATIBLE_DEPTH_BIT_EXT</code> <code>format</code> <strong class=\"purple\">must</strong> be a depth or depth/stencil format"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_EXT_separate_stencil_usage)": [
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-format-02795",
|
|
"text": " If <code>format</code> is a depth-stencil format, <code>usage</code> includes <code>VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT</code>, and the <code>pNext</code> chain includes a <a href=\"#VkImageStencilUsageCreateInfo\">VkImageStencilUsageCreateInfo</a> structure, then its <a href=\"#VkImageStencilUsageCreateInfo\">VkImageStencilUsageCreateInfo</a>::<code>stencilUsage</code> member <strong class=\"purple\">must</strong> also include <code>VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-format-02796",
|
|
"text": " If <code>format</code> is a depth-stencil format, <code>usage</code> does not include <code>VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT</code>, and the <code>pNext</code> chain includes a <a href=\"#VkImageStencilUsageCreateInfo\">VkImageStencilUsageCreateInfo</a> structure, then its <a href=\"#VkImageStencilUsageCreateInfo\">VkImageStencilUsageCreateInfo</a>::<code>stencilUsage</code> member <strong class=\"purple\">must</strong> also not include <code>VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-format-02797",
|
|
"text": " If <code>format</code> is a depth-stencil format, <code>usage</code> includes <code>VK_IMAGE_USAGE_TRANSIENT_ATTACHMENT_BIT</code>, and the <code>pNext</code> chain includes a <a href=\"#VkImageStencilUsageCreateInfo\">VkImageStencilUsageCreateInfo</a> structure, then its <a href=\"#VkImageStencilUsageCreateInfo\">VkImageStencilUsageCreateInfo</a>::<code>stencilUsage</code> member <strong class=\"purple\">must</strong> also include <code>VK_IMAGE_USAGE_TRANSIENT_ATTACHMENT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-format-02798",
|
|
"text": " If <code>format</code> is a depth-stencil format, <code>usage</code> does not include <code>VK_IMAGE_USAGE_TRANSIENT_ATTACHMENT_BIT</code>, and the <code>pNext</code> chain includes a <a href=\"#VkImageStencilUsageCreateInfo\">VkImageStencilUsageCreateInfo</a> structure, then its <a href=\"#VkImageStencilUsageCreateInfo\">VkImageStencilUsageCreateInfo</a>::<code>stencilUsage</code> member <strong class=\"purple\">must</strong> also not include <code>VK_IMAGE_USAGE_TRANSIENT_ATTACHMENT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-Format-02536",
|
|
"text": " If <code>Format</code> is a depth-stencil format and the <code>pNext</code> chain includes a <a href=\"#VkImageStencilUsageCreateInfo\">VkImageStencilUsageCreateInfo</a> structure with its <code>stencilUsage</code> member including <code>VK_IMAGE_USAGE_INPUT_ATTACHMENT_BIT</code>, <code>extent.width</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxFramebufferWidth</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-format-02537",
|
|
"text": " If <code>format</code> is a depth-stencil format and the <code>pNext</code> chain includes a <a href=\"#VkImageStencilUsageCreateInfo\">VkImageStencilUsageCreateInfo</a> structure with its <code>stencilUsage</code> member including <code>VK_IMAGE_USAGE_INPUT_ATTACHMENT_BIT</code>, <code>extent.height</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxFramebufferHeight</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-format-02538",
|
|
"text": " If the <a href=\"#features-shaderStorageImageMultisample\"><code>shaderStorageImageMultisample</code></a> feature is not enabled, <code>format</code> is a depth-stencil format and the <code>pNext</code> chain includes a <a href=\"#VkImageStencilUsageCreateInfo\">VkImageStencilUsageCreateInfo</a> structure with its <code>stencilUsage</code> including <code>VK_IMAGE_USAGE_STORAGE_BIT</code>, <code>samples</code> <strong class=\"purple\">must</strong> be <code>VK_SAMPLE_COUNT_1_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_NV_corner_sampled_image)": [
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-flags-02050",
|
|
"text": " If <code>flags</code> contains <code>VK_IMAGE_CREATE_CORNER_SAMPLED_BIT_NV</code>, <code>imageType</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_TYPE_2D</code> or <code>VK_IMAGE_TYPE_3D</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-flags-02051",
|
|
"text": " If <code>flags</code> contains <code>VK_IMAGE_CREATE_CORNER_SAMPLED_BIT_NV</code>, it <strong class=\"purple\">must</strong> not contain <code>VK_IMAGE_CREATE_CUBE_COMPATIBLE_BIT</code> and the <code>format</code> <strong class=\"purple\">must</strong> not be a depth/stencil format"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-flags-02052",
|
|
"text": " If <code>flags</code> contains <code>VK_IMAGE_CREATE_CORNER_SAMPLED_BIT_NV</code> and <code>imageType</code> is <code>VK_IMAGE_TYPE_2D</code>, <code>extent.width</code> and <code>extent.height</code> <strong class=\"purple\">must</strong> be greater than <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-flags-02053",
|
|
"text": " If <code>flags</code> contains <code>VK_IMAGE_CREATE_CORNER_SAMPLED_BIT_NV</code> and <code>imageType</code> is <code>VK_IMAGE_TYPE_3D</code>, <code>extent.width</code>, <code>extent.height</code>, and <code>extent.depth</code> <strong class=\"purple\">must</strong> be greater than <code>1</code>"
|
|
}
|
|
],
|
|
"(VK_KHR_fragment_shading_rate,VK_NV_shading_rate_image)": [
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-imageType-02082",
|
|
"text": " If <code>usage</code> includes <code>VK_IMAGE_USAGE_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR</code>, <code>imageType</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_TYPE_2D</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-samples-02083",
|
|
"text": " If <code>usage</code> includes <code>VK_IMAGE_USAGE_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR</code>, <code>samples</code> <strong class=\"purple\">must</strong> be <code>VK_SAMPLE_COUNT_1_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_NV_shading_rate_image)": [
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-tiling-02084",
|
|
"text": " If <code>usage</code> includes <code>VK_IMAGE_USAGE_SHADING_RATE_IMAGE_BIT_NV</code>, <code>tiling</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_TILING_OPTIMAL</code>"
|
|
}
|
|
],
|
|
"(VK_HUAWEI_invocation_mask)": [
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-usage-04992",
|
|
"text": " If <code>usage</code> includes <code>VK_IMAGE_USAGE_INVOCATION_MASK_BIT_HUAWEI</code>, <code>tiling</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_TILING_LINEAR</code>"
|
|
}
|
|
],
|
|
"(VK_KHR_portability_subset)": [
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-imageView2DOn3DImage-04459",
|
|
"text": " If the <code><a href=\"#VK_KHR_portability_subset\">VK_KHR_portability_subset</a></code> extension is enabled, and <a href=\"#VkPhysicalDevicePortabilitySubsetFeaturesKHR\">VkPhysicalDevicePortabilitySubsetFeaturesKHR</a>::<code>imageView2DOn3DImage</code> is <code>VK_FALSE</code>, <code>flags</code> <strong class=\"purple\">must</strong> not contain <code>VK_IMAGE_CREATE_2D_ARRAY_COMPATIBLE_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-multisampleArrayImage-04460",
|
|
"text": " If the <code><a href=\"#VK_KHR_portability_subset\">VK_KHR_portability_subset</a></code> extension is enabled, and <a href=\"#VkPhysicalDevicePortabilitySubsetFeaturesKHR\">VkPhysicalDevicePortabilitySubsetFeaturesKHR</a>::<code>multisampleArrayImage</code> is <code>VK_FALSE</code>, and <code>samples</code> is not <code>VK_SAMPLE_COUNT_1_BIT</code>, then <code>arrayLayers</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_image_format_list)": [
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-pNext-06722",
|
|
"text": " If a <a href=\"#VkImageFormatListCreateInfo\">VkImageFormatListCreateInfo</a> structure was included in the <code>pNext</code> chain and <a href=\"#VkImageFormatListCreateInfo\">VkImageFormatListCreateInfo</a>::<code>viewFormatCount</code> is not zero, then each format in <a href=\"#VkImageFormatListCreateInfo\">VkImageFormatListCreateInfo</a>::<code>pViewFormats</code> <strong class=\"purple\">must</strong> either be compatible with the <code>format</code> as described in the <a href=\"#formats-compatibility\">compatibility table</a> or, if <code>flags</code> contains <code>VK_IMAGE_CREATE_BLOCK_TEXEL_VIEW_COMPATIBLE_BIT</code>, be an uncompressed format that is size-compatible with <code>format</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-flags-04738",
|
|
"text": " If <code>flags</code> does not contain <code>VK_IMAGE_CREATE_MUTABLE_FORMAT_BIT</code> and the <code>pNext</code> chain includes a <a href=\"#VkImageFormatListCreateInfo\">VkImageFormatListCreateInfo</a> structure, then <a href=\"#VkImageFormatListCreateInfo\">VkImageFormatListCreateInfo</a>::<code>viewFormatCount</code> <strong class=\"purple\">must</strong> be <code>0</code> or <code>1</code>"
|
|
}
|
|
],
|
|
"(VK_KHR_video_decode_queue)": [
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-usage-04815",
|
|
"text": " If <code>usage</code> includes <code>VK_IMAGE_USAGE_VIDEO_DECODE_DST_BIT_KHR</code>, <code>VK_IMAGE_USAGE_VIDEO_DECODE_DPB_BIT_KHR</code>, then the <code>pNext</code> chain <strong class=\"purple\">must</strong> include a valid <a href=\"#VkVideoProfilesKHR\">VkVideoProfilesKHR</a> structure with <code>profileCount</code> greater than <code>0</code> and <code>pProfiles</code> including at least one <a href=\"#VkVideoProfileKHR\">VkVideoProfileKHR</a>::<code>videoCodecOperation</code> specifying a decode operation"
|
|
}
|
|
],
|
|
"(VK_KHR_video_encode_queue)": [
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-usage-04816",
|
|
"text": " If <code>usage</code> includes <code>VK_IMAGE_USAGE_VIDEO_ENCODE_DST_BIT_KHR</code>, <code>VK_IMAGE_USAGE_VIDEO_ENCODE_SRC_BIT_KHR</code>, <code>VK_IMAGE_USAGE_VIDEO_ENCODE_DPB_BIT_KHR</code>, then the <code>pNext</code> chain <strong class=\"purple\">must</strong> include a valid <a href=\"#VkVideoProfilesKHR\">VkVideoProfilesKHR</a> structure with <code>profileCount</code> greater than <code>0</code> and <code>pProfiles</code> including at least one <a href=\"#VkVideoProfileKHR\">VkVideoProfileKHR</a>::<code>videoCodecOperation</code> specifying an encode operation"
|
|
}
|
|
],
|
|
"(VK_KHR_video_queue)": [
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-pNext-06811",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkVideoProfilesKHR\">VkVideoProfilesKHR</a> structure then <code>supportedVideoFormat</code> <strong class=\"purple\">must</strong> be <code>VK_TRUE</code>"
|
|
}
|
|
],
|
|
"(VK_FUCHSIA_buffer_collection)": [
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-pNext-06390",
|
|
"text": " If the <a href=\"#VkImage\">VkImage</a> is to be used to import memory from a <a href=\"#VkBufferCollectionFUCHSIA\">VkBufferCollectionFUCHSIA</a>, a <a href=\"#VkBufferCollectionImageCreateInfoFUCHSIA\">VkBufferCollectionImageCreateInfoFUCHSIA</a> structure <strong class=\"purple\">must</strong> be chained to <code>pNext</code>."
|
|
}
|
|
],
|
|
"(VK_EXT_multisampled_render_to_single_sampled)": [
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-multisampledRenderToSingleSampled-06882",
|
|
"text": " If the <a href=\"#features-multisampledRenderToSingleSampled\"><code>multisampledRenderToSingleSampled</code></a> feature is not enabled, <code>flags</code> <strong class=\"purple\">must</strong> not contain <code>VK_IMAGE_CREATE_MULTISAMPLED_RENDER_TO_SINGLE_SAMPLED_BIT_EXT</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-flags-06883",
|
|
"text": " If <code>flags</code> contains <code>VK_IMAGE_CREATE_MULTISAMPLED_RENDER_TO_SINGLE_SAMPLED_BIT_EXT</code>, <code>samples</code> <strong class=\"purple\">must</strong> be <code>VK_SAMPLE_COUNT_1_BIT</code>."
|
|
}
|
|
],
|
|
"(VK_EXT_image_compression_control)+(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-pNext-06743",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkImageCompressionControlEXT\">VkImageCompressionControlEXT</a> structure, <code>format</code> is a <a href=\"#formats-requiring-sampler-ycbcr-conversion\">multi-planar</a> format, and <a href=\"#VkImageCompressionControlEXT\">VkImageCompressionControlEXT</a>::<code>flags</code> includes <code>VK_IMAGE_COMPRESSION_FIXED_RATE_EXPLICIT_EXT</code>, then <a href=\"#VkImageCompressionControlEXT\">VkImageCompressionControlEXT</a>::<code>compressionControlPlaneCount</code> <strong class=\"purple\">must</strong> be equal to the number of planes in <code>format</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-pNext-06744",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkImageCompressionControlEXT\">VkImageCompressionControlEXT</a> structure, <code>format</code> is a not <a href=\"#formats-requiring-sampler-ycbcr-conversion\">multi-planar</a> format, and <a href=\"#VkImageCompressionControlEXT\">VkImageCompressionControlEXT</a>::<code>flags</code> includes <code>VK_IMAGE_COMPRESSION_FIXED_RATE_EXPLICIT_EXT</code>, then <a href=\"#VkImageCompressionControlEXT\">VkImageCompressionControlEXT</a>::<code>compressionControlPlaneCount</code> <strong class=\"purple\">must</strong> be 1"
|
|
}
|
|
],
|
|
"(VK_EXT_image_compression_control)+!(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-pNext-06745",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkImageCompressionControlEXT\">VkImageCompressionControlEXT</a> structure, and <a href=\"#VkImageCompressionControlEXT\">VkImageCompressionControlEXT</a>::<code>flags</code> includes <code>VK_IMAGE_COMPRESSION_FIXED_RATE_EXPLICIT_EXT</code>, then <a href=\"#VkImageCompressionControlEXT\">VkImageCompressionControlEXT</a>::<code>compressionControlPlaneCount</code> <strong class=\"purple\">must</strong> be 1"
|
|
}
|
|
],
|
|
"(VK_EXT_image_compression_control)+(VK_EXT_image_drm_format_modifier)": [
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-pNext-06746",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkImageCompressionControlEXT\">VkImageCompressionControlEXT</a> structure, it <strong class=\"purple\">must</strong> not contain a <a href=\"#VkImageDrmFormatModifierExplicitCreateInfoEXT\">VkImageDrmFormatModifierExplicitCreateInfoEXT</a> structure"
|
|
}
|
|
],
|
|
"(VK_EXT_metal_objects)": [
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-pNext-06783",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkExportMetalObjectCreateInfoEXT\">VkExportMetalObjectCreateInfoEXT</a> structure, its <code>exportObjectType</code> member <strong class=\"purple\">must</strong> be either <code>VK_EXPORT_METAL_OBJECT_TYPE_METAL_TEXTURE_BIT_EXT</code> or <code>VK_EXPORT_METAL_OBJECT_TYPE_METAL_IOSURFACE_BIT_EXT</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-pNext-06784",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkImportMetalTextureInfoEXT\">VkImportMetalTextureInfoEXT</a> structure its <code>plane</code> member <strong class=\"purple\">must</strong> be <code>VK_IMAGE_ASPECT_PLANE_0_BIT</code>, <code>VK_IMAGE_ASPECT_PLANE_1_BIT</code>, or <code>VK_IMAGE_ASPECT_PLANE_2_BIT</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-pNext-06785",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkImportMetalTextureInfoEXT\">VkImportMetalTextureInfoEXT</a> structure and the image does not have a multi-planar format, then <a href=\"#VkImportMetalTextureInfoEXT\">VkImportMetalTextureInfoEXT</a>::<code>plane</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_ASPECT_PLANE_0_BIT</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCreateInfo-pNext-06786",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkImportMetalTextureInfoEXT\">VkImportMetalTextureInfoEXT</a> structure and the image has a multi-planar format with only two planes, then <a href=\"#VkImportMetalTextureInfoEXT\">VkImportMetalTextureInfoEXT</a>::<code>plane</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_ASPECT_PLANE_2_BIT</code>."
|
|
}
|
|
]
|
|
},
|
|
"VkBufferCollectionImageCreateInfoFUCHSIA": {
|
|
"(VK_FUCHSIA_buffer_collection)": [
|
|
{
|
|
"vuid": "VUID-VkBufferCollectionImageCreateInfoFUCHSIA-index-06391",
|
|
"text": " <code>index</code> <strong class=\"purple\">must</strong> be less than <a href=\"#VkBufferCollectionPropertiesFUCHSIA\">VkBufferCollectionPropertiesFUCHSIA</a>::<code>bufferCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferCollectionImageCreateInfoFUCHSIA-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_BUFFER_COLLECTION_IMAGE_CREATE_INFO_FUCHSIA</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferCollectionImageCreateInfoFUCHSIA-collection-parameter",
|
|
"text": " <code>collection</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBufferCollectionFUCHSIA\">VkBufferCollectionFUCHSIA</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkImageStencilUsageCreateInfo": {
|
|
"(VK_VERSION_1_2,VK_EXT_separate_stencil_usage)": [
|
|
{
|
|
"vuid": "VUID-VkImageStencilUsageCreateInfo-stencilUsage-02539",
|
|
"text": " If <code>stencilUsage</code> includes <code>VK_IMAGE_USAGE_TRANSIENT_ATTACHMENT_BIT</code>, it <strong class=\"purple\">must</strong> not include bits other than <code>VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT</code> or <code>VK_IMAGE_USAGE_INPUT_ATTACHMENT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageStencilUsageCreateInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_IMAGE_STENCIL_USAGE_CREATE_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageStencilUsageCreateInfo-stencilUsage-parameter",
|
|
"text": " <code>stencilUsage</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkImageUsageFlagBits\">VkImageUsageFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageStencilUsageCreateInfo-stencilUsage-requiredbitmask",
|
|
"text": " <code>stencilUsage</code> <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkDedicatedAllocationImageCreateInfoNV": {
|
|
"(VK_NV_dedicated_allocation)": [
|
|
{
|
|
"vuid": "VUID-VkDedicatedAllocationImageCreateInfoNV-dedicatedAllocation-00994",
|
|
"text": " If <code>dedicatedAllocation</code> is <code>VK_TRUE</code>, <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a>::<code>flags</code> <strong class=\"purple\">must</strong> not include <code>VK_IMAGE_CREATE_SPARSE_BINDING_BIT</code>, <code>VK_IMAGE_CREATE_SPARSE_RESIDENCY_BIT</code>, or <code>VK_IMAGE_CREATE_SPARSE_ALIASED_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDedicatedAllocationImageCreateInfoNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_DEDICATED_ALLOCATION_IMAGE_CREATE_INFO_NV</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkExternalMemoryImageCreateInfo": {
|
|
"(VK_VERSION_1_1,VK_KHR_external_memory)": [
|
|
{
|
|
"vuid": "VUID-VkExternalMemoryImageCreateInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_EXTERNAL_MEMORY_IMAGE_CREATE_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkExternalMemoryImageCreateInfo-handleTypes-parameter",
|
|
"text": " <code>handleTypes</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkExternalMemoryHandleTypeFlagBits\">VkExternalMemoryHandleTypeFlagBits</a> values"
|
|
}
|
|
]
|
|
},
|
|
"VkExternalMemoryImageCreateInfoNV": {
|
|
"(VK_NV_external_memory)": [
|
|
{
|
|
"vuid": "VUID-VkExternalMemoryImageCreateInfoNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_EXTERNAL_MEMORY_IMAGE_CREATE_INFO_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkExternalMemoryImageCreateInfoNV-handleTypes-parameter",
|
|
"text": " <code>handleTypes</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkExternalMemoryHandleTypeFlagBitsNV\">VkExternalMemoryHandleTypeFlagBitsNV</a> values"
|
|
}
|
|
]
|
|
},
|
|
"VkExternalFormatANDROID": {
|
|
"(VK_ANDROID_external_memory_android_hardware_buffer)": [
|
|
{
|
|
"vuid": "VUID-VkExternalFormatANDROID-externalFormat-01894",
|
|
"text": " <code>externalFormat</code> <strong class=\"purple\">must</strong> be <code>0</code> or a value returned in the <code>externalFormat</code> member of <a href=\"#VkAndroidHardwareBufferFormatPropertiesANDROID\">VkAndroidHardwareBufferFormatPropertiesANDROID</a> by an earlier call to <a href=\"#vkGetAndroidHardwareBufferPropertiesANDROID\">vkGetAndroidHardwareBufferPropertiesANDROID</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkExternalFormatANDROID-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_EXTERNAL_FORMAT_ANDROID</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkImageSwapchainCreateInfoKHR": {
|
|
"(VK_VERSION_1_1,VK_KHR_device_group)+(VK_KHR_swapchain)": [
|
|
{
|
|
"vuid": "VUID-VkImageSwapchainCreateInfoKHR-swapchain-00995",
|
|
"text": " If <code>swapchain</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the fields of <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> <strong class=\"purple\">must</strong> match the <a href=\"#swapchain-wsi-image-create-info\">implied image creation parameters</a> of the swapchain"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageSwapchainCreateInfoKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_IMAGE_SWAPCHAIN_CREATE_INFO_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageSwapchainCreateInfoKHR-swapchain-parameter",
|
|
"text": " If <code>swapchain</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>swapchain</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSwapchainKHR\">VkSwapchainKHR</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkImageFormatListCreateInfo": {
|
|
"(VK_VERSION_1_2,VK_KHR_image_format_list)": [
|
|
{
|
|
"vuid": "VUID-VkImageFormatListCreateInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_IMAGE_FORMAT_LIST_CREATE_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageFormatListCreateInfo-pViewFormats-parameter",
|
|
"text": " If <code>viewFormatCount</code> is not <code>0</code>, <code>pViewFormats</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>viewFormatCount</code> valid <a href=\"#VkFormat\">VkFormat</a> values"
|
|
}
|
|
]
|
|
},
|
|
"VkImageDrmFormatModifierListCreateInfoEXT": {
|
|
"(VK_EXT_image_drm_format_modifier)": [
|
|
{
|
|
"vuid": "VUID-VkImageDrmFormatModifierListCreateInfoEXT-pDrmFormatModifiers-02263",
|
|
"text": " Each <em>modifier</em> in <code>pDrmFormatModifiers</code> <strong class=\"purple\">must</strong> be compatible with the parameters in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> and its <code>pNext</code> chain, as determined by querying <a href=\"#VkPhysicalDeviceImageFormatInfo2\">VkPhysicalDeviceImageFormatInfo2</a> extended with <a href=\"#VkPhysicalDeviceImageDrmFormatModifierInfoEXT\">VkPhysicalDeviceImageDrmFormatModifierInfoEXT</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageDrmFormatModifierListCreateInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_IMAGE_DRM_FORMAT_MODIFIER_LIST_CREATE_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageDrmFormatModifierListCreateInfoEXT-pDrmFormatModifiers-parameter",
|
|
"text": " <code>pDrmFormatModifiers</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>drmFormatModifierCount</code> <code>uint64_t</code> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageDrmFormatModifierListCreateInfoEXT-drmFormatModifierCount-arraylength",
|
|
"text": " <code>drmFormatModifierCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkImageDrmFormatModifierExplicitCreateInfoEXT": {
|
|
"(VK_EXT_image_drm_format_modifier)": [
|
|
{
|
|
"vuid": "VUID-VkImageDrmFormatModifierExplicitCreateInfoEXT-drmFormatModifier-02264",
|
|
"text": " <code>drmFormatModifier</code> <strong class=\"purple\">must</strong> be compatible with the parameters in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> and its <code>pNext</code> chain, as determined by querying <a href=\"#VkPhysicalDeviceImageFormatInfo2\">VkPhysicalDeviceImageFormatInfo2</a> extended with <a href=\"#VkPhysicalDeviceImageDrmFormatModifierInfoEXT\">VkPhysicalDeviceImageDrmFormatModifierInfoEXT</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageDrmFormatModifierExplicitCreateInfoEXT-drmFormatModifierPlaneCount-02265",
|
|
"text": " <code>drmFormatModifierPlaneCount</code> <strong class=\"purple\">must</strong> be equal to the <a href=\"#VkDrmFormatModifierPropertiesEXT\">VkDrmFormatModifierPropertiesEXT</a>::<code>drmFormatModifierPlaneCount</code> associated with <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a>::<code>format</code> and <code>drmFormatModifier</code>, as found by querying <a href=\"#VkDrmFormatModifierPropertiesListEXT\">VkDrmFormatModifierPropertiesListEXT</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageDrmFormatModifierExplicitCreateInfoEXT-size-02267",
|
|
"text": " For each element of <code>pPlaneLayouts</code>, <code>size</code> <strong class=\"purple\">must</strong> be 0"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageDrmFormatModifierExplicitCreateInfoEXT-arrayPitch-02268",
|
|
"text": " For each element of <code>pPlaneLayouts</code>, <code>arrayPitch</code> <strong class=\"purple\">must</strong> be 0 if <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a>::<code>arrayLayers</code> is 1"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageDrmFormatModifierExplicitCreateInfoEXT-depthPitch-02269",
|
|
"text": " For each element of <code>pPlaneLayouts</code>, <code>depthPitch</code> <strong class=\"purple\">must</strong> be 0 if <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a>::<code>extent.depth</code> is 1"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageDrmFormatModifierExplicitCreateInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_IMAGE_DRM_FORMAT_MODIFIER_EXPLICIT_CREATE_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageDrmFormatModifierExplicitCreateInfoEXT-pPlaneLayouts-parameter",
|
|
"text": " If <code>drmFormatModifierPlaneCount</code> is not <code>0</code>, <code>pPlaneLayouts</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>drmFormatModifierPlaneCount</code> <a href=\"#VkSubresourceLayout\">VkSubresourceLayout</a> structures"
|
|
}
|
|
]
|
|
},
|
|
"VkImageCompressionControlEXT": {
|
|
"(VK_EXT_image_compression_control)": [
|
|
{
|
|
"vuid": "VUID-VkImageCompressionControlEXT-flags-06747",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be one of <code>VK_IMAGE_COMPRESSION_DEFAULT_EXT</code>, <code>VK_IMAGE_COMPRESSION_FIXED_RATE_DEFAULT_EXT</code>, <code>VK_IMAGE_COMPRESSION_FIXED_RATE_EXPLICIT_EXT</code>, or <code>VK_IMAGE_COMPRESSION_DISABLED_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCompressionControlEXT-flags-06748",
|
|
"text": " If <code>flags</code> includes <code>VK_IMAGE_COMPRESSION_FIXED_RATE_EXPLICIT_EXT</code>, <code>pFixedRateFlags</code> <strong class=\"purple\">must</strong> not be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCompressionControlEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_IMAGE_COMPRESSION_CONTROL_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkImageCompressionPropertiesEXT": {
|
|
"(VK_EXT_image_compression_control)": [
|
|
{
|
|
"vuid": "VUID-VkImageCompressionPropertiesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_IMAGE_COMPRESSION_PROPERTIES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetImageSubresourceLayout": {
|
|
"!(VK_EXT_image_drm_format_modifier)": [
|
|
{
|
|
"vuid": "VUID-vkGetImageSubresourceLayout-image-00996",
|
|
"text": " <code>image</code> <strong class=\"purple\">must</strong> have been created with <code>tiling</code> equal to <code>VK_IMAGE_TILING_LINEAR</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_image_drm_format_modifier)": [
|
|
{
|
|
"vuid": "VUID-vkGetImageSubresourceLayout-image-02270",
|
|
"text": " <code>image</code> <strong class=\"purple\">must</strong> have been created with <code>tiling</code> equal to <code>VK_IMAGE_TILING_LINEAR</code> or <code>VK_IMAGE_TILING_DRM_FORMAT_MODIFIER_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetImageSubresourceLayout-tiling-02271",
|
|
"text": " If the <code>tiling</code> of the <code>image</code> is <code>VK_IMAGE_TILING_DRM_FORMAT_MODIFIER_EXT</code>, then the <code>aspectMask</code> member of <code>pSubresource</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_ASPECT_MEMORY_PLANE<em>{ibit}</em>BIT_EXT</code> and the index <em>i</em> <strong class=\"purple\">must</strong> be less than the <a href=\"#VkDrmFormatModifierPropertiesEXT\">VkDrmFormatModifierPropertiesEXT</a>::<code>drmFormatModifierPlaneCount</code> associated with the image’s <code>format</code> and <a href=\"#VkImageDrmFormatModifierPropertiesEXT\">VkImageDrmFormatModifierPropertiesEXT</a>::<code>drmFormatModifier</code>"
|
|
}
|
|
],
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkGetImageSubresourceLayout-aspectMask-00997",
|
|
"text": " The <code>aspectMask</code> member of <code>pSubresource</code> <strong class=\"purple\">must</strong> only have a single bit set"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetImageSubresourceLayout-mipLevel-01716",
|
|
"text": " The <code>mipLevel</code> member of <code>pSubresource</code> <strong class=\"purple\">must</strong> be less than the <code>mipLevels</code> specified in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> when <code>image</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetImageSubresourceLayout-arrayLayer-01717",
|
|
"text": " The <code>arrayLayer</code> member of <code>pSubresource</code> <strong class=\"purple\">must</strong> be less than the <code>arrayLayers</code> specified in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> when <code>image</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetImageSubresourceLayout-format-04461",
|
|
"text": " If <code>format</code> is a color format, the <code>aspectMask</code> member of <code>pSubresource</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_ASPECT_COLOR_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetImageSubresourceLayout-format-04462",
|
|
"text": " If <code>format</code> has a depth component, the <code>aspectMask</code> member of <code>pSubresource</code> <strong class=\"purple\">must</strong> contain <code>VK_IMAGE_ASPECT_DEPTH_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetImageSubresourceLayout-format-04463",
|
|
"text": " If <code>format</code> has a stencil component, the <code>aspectMask</code> member of <code>pSubresource</code> <strong class=\"purple\">must</strong> contain <code>VK_IMAGE_ASPECT_STENCIL_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetImageSubresourceLayout-format-04464",
|
|
"text": " If <code>format</code> does not contain a stencil or depth component, the <code>aspectMask</code> member of <code>pSubresource</code> <strong class=\"purple\">must</strong> not contain <code>VK_IMAGE_ASPECT_DEPTH_BIT</code> or <code>VK_IMAGE_ASPECT_STENCIL_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetImageSubresourceLayout-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetImageSubresourceLayout-image-parameter",
|
|
"text": " <code>image</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImage\">VkImage</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetImageSubresourceLayout-pSubresource-parameter",
|
|
"text": " <code>pSubresource</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkImageSubresource\">VkImageSubresource</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetImageSubresourceLayout-pLayout-parameter",
|
|
"text": " <code>pLayout</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkSubresourceLayout\">VkSubresourceLayout</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetImageSubresourceLayout-image-parent",
|
|
"text": " <code>image</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-vkGetImageSubresourceLayout-format-01581",
|
|
"text": " If the <code>tiling</code> of the <code>image</code> is <code>VK_IMAGE_TILING_LINEAR</code> and its <code>format</code> is a <a href=\"#formats-requiring-sampler-ycbcr-conversion\">multi-planar format</a> with two planes, the <code>aspectMask</code> member of <code>pSubresource</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_ASPECT_PLANE_0_BIT</code> or <code>VK_IMAGE_ASPECT_PLANE_1_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetImageSubresourceLayout-format-01582",
|
|
"text": " If the <code>tiling</code> of the <code>image</code> is <code>VK_IMAGE_TILING_LINEAR</code> and its <code>format</code> is a <a href=\"#formats-requiring-sampler-ycbcr-conversion\">multi-planar format</a> with three planes, the <code>aspectMask</code> member of <code>pSubresource</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_ASPECT_PLANE_0_BIT</code>, <code>VK_IMAGE_ASPECT_PLANE_1_BIT</code> or <code>VK_IMAGE_ASPECT_PLANE_2_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_ANDROID_external_memory_android_hardware_buffer)": [
|
|
{
|
|
"vuid": "VUID-vkGetImageSubresourceLayout-image-01895",
|
|
"text": " If <code>image</code> was created with the <code>VK_EXTERNAL_MEMORY_HANDLE_TYPE_ANDROID_HARDWARE_BUFFER_BIT_ANDROID</code> external memory handle type, then <code>image</code> <strong class=\"purple\">must</strong> be bound to memory"
|
|
}
|
|
]
|
|
},
|
|
"VkImageSubresource": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkImageSubresource-aspectMask-parameter",
|
|
"text": " <code>aspectMask</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkImageAspectFlagBits\">VkImageAspectFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageSubresource-aspectMask-requiredbitmask",
|
|
"text": " <code>aspectMask</code> <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetImageSubresourceLayout2EXT": {
|
|
"(VK_EXT_image_compression_control)+!(VK_EXT_image_drm_format_modifier)": [
|
|
{
|
|
"vuid": "VUID-vkGetImageSubresourceLayout2EXT-image-00996",
|
|
"text": " <code>image</code> <strong class=\"purple\">must</strong> have been created with <code>tiling</code> equal to <code>VK_IMAGE_TILING_LINEAR</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_image_compression_control)+(VK_EXT_image_drm_format_modifier)": [
|
|
{
|
|
"vuid": "VUID-vkGetImageSubresourceLayout2EXT-image-02270",
|
|
"text": " <code>image</code> <strong class=\"purple\">must</strong> have been created with <code>tiling</code> equal to <code>VK_IMAGE_TILING_LINEAR</code> or <code>VK_IMAGE_TILING_DRM_FORMAT_MODIFIER_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetImageSubresourceLayout2EXT-tiling-02271",
|
|
"text": " If the <code>tiling</code> of the <code>image</code> is <code>VK_IMAGE_TILING_DRM_FORMAT_MODIFIER_EXT</code>, then the <code>aspectMask</code> member of <code>pSubresource</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_ASPECT_MEMORY_PLANE<em>{ibit}</em>BIT_EXT</code> and the index <em>i</em> <strong class=\"purple\">must</strong> be less than the <a href=\"#VkDrmFormatModifierPropertiesEXT\">VkDrmFormatModifierPropertiesEXT</a>::<code>drmFormatModifierPlaneCount</code> associated with the image’s <code>format</code> and <a href=\"#VkImageDrmFormatModifierPropertiesEXT\">VkImageDrmFormatModifierPropertiesEXT</a>::<code>drmFormatModifier</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_image_compression_control)": [
|
|
{
|
|
"vuid": "VUID-vkGetImageSubresourceLayout2EXT-aspectMask-00997",
|
|
"text": " The <code>aspectMask</code> member of <code>pSubresource</code> <strong class=\"purple\">must</strong> only have a single bit set"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetImageSubresourceLayout2EXT-mipLevel-01716",
|
|
"text": " The <code>mipLevel</code> member of <code>pSubresource</code> <strong class=\"purple\">must</strong> be less than the <code>mipLevels</code> specified in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> when <code>image</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetImageSubresourceLayout2EXT-arrayLayer-01717",
|
|
"text": " The <code>arrayLayer</code> member of <code>pSubresource</code> <strong class=\"purple\">must</strong> be less than the <code>arrayLayers</code> specified in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> when <code>image</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetImageSubresourceLayout2EXT-format-04461",
|
|
"text": " If <code>format</code> is a color format, the <code>aspectMask</code> member of <code>pSubresource</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_ASPECT_COLOR_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetImageSubresourceLayout2EXT-format-04462",
|
|
"text": " If <code>format</code> has a depth component, the <code>aspectMask</code> member of <code>pSubresource</code> <strong class=\"purple\">must</strong> contain <code>VK_IMAGE_ASPECT_DEPTH_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetImageSubresourceLayout2EXT-format-04463",
|
|
"text": " If <code>format</code> has a stencil component, the <code>aspectMask</code> member of <code>pSubresource</code> <strong class=\"purple\">must</strong> contain <code>VK_IMAGE_ASPECT_STENCIL_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetImageSubresourceLayout2EXT-format-04464",
|
|
"text": " If <code>format</code> does not contain a stencil or depth component, the <code>aspectMask</code> member of <code>pSubresource</code> <strong class=\"purple\">must</strong> not contain <code>VK_IMAGE_ASPECT_DEPTH_BIT</code> or <code>VK_IMAGE_ASPECT_STENCIL_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetImageSubresourceLayout2EXT-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetImageSubresourceLayout2EXT-image-parameter",
|
|
"text": " <code>image</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImage\">VkImage</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetImageSubresourceLayout2EXT-pSubresource-parameter",
|
|
"text": " <code>pSubresource</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkImageSubresource2EXT\">VkImageSubresource2EXT</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetImageSubresourceLayout2EXT-pLayout-parameter",
|
|
"text": " <code>pLayout</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkSubresourceLayout2EXT\">VkSubresourceLayout2EXT</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetImageSubresourceLayout2EXT-image-parent",
|
|
"text": " <code>image</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_image_compression_control)+(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-vkGetImageSubresourceLayout2EXT-format-01581",
|
|
"text": " If the <code>tiling</code> of the <code>image</code> is <code>VK_IMAGE_TILING_LINEAR</code> and its <code>format</code> is a <a href=\"#formats-requiring-sampler-ycbcr-conversion\">multi-planar format</a> with two planes, the <code>aspectMask</code> member of <code>pSubresource</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_ASPECT_PLANE_0_BIT</code> or <code>VK_IMAGE_ASPECT_PLANE_1_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetImageSubresourceLayout2EXT-format-01582",
|
|
"text": " If the <code>tiling</code> of the <code>image</code> is <code>VK_IMAGE_TILING_LINEAR</code> and its <code>format</code> is a <a href=\"#formats-requiring-sampler-ycbcr-conversion\">multi-planar format</a> with three planes, the <code>aspectMask</code> member of <code>pSubresource</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_ASPECT_PLANE_0_BIT</code>, <code>VK_IMAGE_ASPECT_PLANE_1_BIT</code> or <code>VK_IMAGE_ASPECT_PLANE_2_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_image_compression_control)+(VK_ANDROID_external_memory_android_hardware_buffer)": [
|
|
{
|
|
"vuid": "VUID-vkGetImageSubresourceLayout2EXT-image-01895",
|
|
"text": " If <code>image</code> was created with the <code>VK_EXTERNAL_MEMORY_HANDLE_TYPE_ANDROID_HARDWARE_BUFFER_BIT_ANDROID</code> external memory handle type, then <code>image</code> <strong class=\"purple\">must</strong> be bound to memory"
|
|
}
|
|
]
|
|
},
|
|
"VkImageSubresource2EXT": {
|
|
"(VK_EXT_image_compression_control)": [
|
|
{
|
|
"vuid": "VUID-VkImageSubresource2EXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_IMAGE_SUBRESOURCE_2_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageSubresource2EXT-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageSubresource2EXT-imageSubresource-parameter",
|
|
"text": " <code>imageSubresource</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageSubresource\">VkImageSubresource</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkSubresourceLayout2EXT": {
|
|
"(VK_EXT_image_compression_control)": [
|
|
{
|
|
"vuid": "VUID-VkSubresourceLayout2EXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_SUBRESOURCE_LAYOUT_2_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubresourceLayout2EXT-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkImageCompressionPropertiesEXT\">VkImageCompressionPropertiesEXT</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSubresourceLayout2EXT-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
}
|
|
]
|
|
},
|
|
"vkGetImageDrmFormatModifierPropertiesEXT": {
|
|
"(VK_EXT_image_drm_format_modifier)": [
|
|
{
|
|
"vuid": "VUID-vkGetImageDrmFormatModifierPropertiesEXT-image-02272",
|
|
"text": " <code>image</code> <strong class=\"purple\">must</strong> have been created with <a href=\"#VkImageCreateInfo\"><code>tiling</code></a> equal to <code>VK_IMAGE_TILING_DRM_FORMAT_MODIFIER_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetImageDrmFormatModifierPropertiesEXT-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetImageDrmFormatModifierPropertiesEXT-image-parameter",
|
|
"text": " <code>image</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImage\">VkImage</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetImageDrmFormatModifierPropertiesEXT-pProperties-parameter",
|
|
"text": " <code>pProperties</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkImageDrmFormatModifierPropertiesEXT\">VkImageDrmFormatModifierPropertiesEXT</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetImageDrmFormatModifierPropertiesEXT-image-parent",
|
|
"text": " <code>image</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkImageDrmFormatModifierPropertiesEXT": {
|
|
"(VK_EXT_image_drm_format_modifier)": [
|
|
{
|
|
"vuid": "VUID-VkImageDrmFormatModifierPropertiesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_IMAGE_DRM_FORMAT_MODIFIER_PROPERTIES_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageDrmFormatModifierPropertiesEXT-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkDestroyImage": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkDestroyImage-image-01000",
|
|
"text": " All submitted commands that refer to <code>image</code>, either directly or via a <code>VkImageView</code>, <strong class=\"purple\">must</strong> have completed execution"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyImage-image-01001",
|
|
"text": " If <code>VkAllocationCallbacks</code> were provided when <code>image</code> was created, a compatible set of callbacks <strong class=\"purple\">must</strong> be provided here"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyImage-image-01002",
|
|
"text": " If no <code>VkAllocationCallbacks</code> were provided when <code>image</code> was created, <code>pAllocator</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyImage-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyImage-image-parameter",
|
|
"text": " If <code>image</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>image</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImage\">VkImage</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyImage-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyImage-image-parent",
|
|
"text": " If <code>image</code> is a valid handle, it <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
],
|
|
"(VK_KHR_swapchain)": [
|
|
{
|
|
"vuid": "VUID-vkDestroyImage-image-04882",
|
|
"text": " <code>image</code> <strong class=\"purple\">must</strong> not have been acquired from <a href=\"#vkGetSwapchainImagesKHR\">vkGetSwapchainImagesKHR</a>"
|
|
}
|
|
]
|
|
},
|
|
"vkCreateImageView": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCreateImageView-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateImageView-pCreateInfo-parameter",
|
|
"text": " <code>pCreateInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkImageViewCreateInfo\">VkImageViewCreateInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateImageView-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateImageView-pView-parameter",
|
|
"text": " <code>pView</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkImageView\">VkImageView</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkImageViewCreateInfo": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-image-01003",
|
|
"text": " If <code>image</code> was not created with <code>VK_IMAGE_CREATE_CUBE_COMPATIBLE_BIT</code> then <code>viewType</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_VIEW_TYPE_CUBE</code> or <code>VK_IMAGE_VIEW_TYPE_CUBE_ARRAY</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-viewType-01004",
|
|
"text": " If the <a href=\"#features-imageCubeArray\"><code>imageCubeArray</code></a> feature is not enabled, <code>viewType</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_VIEW_TYPE_CUBE_ARRAY</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-image-04441",
|
|
"text": " <code>image</code> <strong class=\"purple\">must</strong> have been created with a <code>usage</code> value containing at least one of the usages defined in the <a href=\"#valid-imageview-imageusage\">valid image usage</a> list for image views"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-None-02273",
|
|
"text": " The <a href=\"#resources-image-view-format-features\">format features</a> of the resultant image view <strong class=\"purple\">must</strong> contain at least one bit"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-usage-02274",
|
|
"text": " If <code>usage</code> contains <code>VK_IMAGE_USAGE_SAMPLED_BIT</code>, then the <a href=\"#resources-image-view-format-features\">format features</a> of the resultant image view <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-usage-02275",
|
|
"text": " If <code>usage</code> contains <code>VK_IMAGE_USAGE_STORAGE_BIT</code>, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_STORAGE_IMAGE_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-usage-02276",
|
|
"text": " If <code>usage</code> contains <code>VK_IMAGE_USAGE_COLOR_ATTACHMENT_BIT</code>, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_COLOR_ATTACHMENT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-usage-02277",
|
|
"text": " If <code>usage</code> contains <code>VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT</code>, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_DEPTH_STENCIL_ATTACHMENT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-usage-02652",
|
|
"text": " If <code>usage</code> contains <code>VK_IMAGE_USAGE_INPUT_ATTACHMENT_BIT</code>, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain at least one of <code>VK_FORMAT_FEATURE_COLOR_ATTACHMENT_BIT</code> or <code>VK_FORMAT_FEATURE_DEPTH_STENCIL_ATTACHMENT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-subresourceRange-01478",
|
|
"text": " <code>subresourceRange.baseMipLevel</code> <strong class=\"purple\">must</strong> be less than the <code>mipLevels</code> specified in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> when <code>image</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-subresourceRange-01718",
|
|
"text": " If <code>subresourceRange.levelCount</code> is not <code>VK_REMAINING_MIP_LEVELS</code>, <span class=\"eq\"><code>subresourceRange.baseMipLevel</code> + <code>subresourceRange.levelCount</code></span> <strong class=\"purple\">must</strong> be less than or equal to the <code>mipLevels</code> specified in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> when <code>image</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-image-01020",
|
|
"text": " If <code>image</code> is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-subResourceRange-01021",
|
|
"text": " <code>viewType</code> <strong class=\"purple\">must</strong> be compatible with the type of <code>image</code> as shown in the <a href=\"#resources-image-views-compatibility\">view type compatibility table</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-imageViewType-04973",
|
|
"text": " If <code>viewType</code> is <code>VK_IMAGE_VIEW_TYPE_1D</code>, <code>VK_IMAGE_VIEW_TYPE_2D</code>, or <code>VK_IMAGE_VIEW_TYPE_3D</code>; and <code>subresourceRange.layerCount</code> is not <code>VK_REMAINING_ARRAY_LAYERS</code>, then <code>subresourceRange.layerCount</code> <strong class=\"purple\">must</strong> be 1"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-imageViewType-04974",
|
|
"text": " If <code>viewType</code> is <code>VK_IMAGE_VIEW_TYPE_1D</code>, <code>VK_IMAGE_VIEW_TYPE_2D</code>, or <code>VK_IMAGE_VIEW_TYPE_3D</code>; and <code>subresourceRange.layerCount</code> is <code>VK_REMAINING_ARRAY_LAYERS</code>, then the remaining number of layers <strong class=\"purple\">must</strong> be 1"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-viewType-02960",
|
|
"text": " If <code>viewType</code> is <code>VK_IMAGE_VIEW_TYPE_CUBE</code> and <code>subresourceRange.layerCount</code> is not <code>VK_REMAINING_ARRAY_LAYERS</code>, <code>subresourceRange.layerCount</code> <strong class=\"purple\">must</strong> be <code>6</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-viewType-02961",
|
|
"text": " If <code>viewType</code> is <code>VK_IMAGE_VIEW_TYPE_CUBE_ARRAY</code> and <code>subresourceRange.layerCount</code> is not <code>VK_REMAINING_ARRAY_LAYERS</code>, <code>subresourceRange.layerCount</code> <strong class=\"purple\">must</strong> be a multiple of <code>6</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-viewType-02962",
|
|
"text": " If <code>viewType</code> is <code>VK_IMAGE_VIEW_TYPE_CUBE</code> and <code>subresourceRange.layerCount</code> is <code>VK_REMAINING_ARRAY_LAYERS</code>, the remaining number of layers <strong class=\"purple\">must</strong> be <code>6</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-viewType-02963",
|
|
"text": " If <code>viewType</code> is <code>VK_IMAGE_VIEW_TYPE_CUBE_ARRAY</code> and <code>subresourceRange.layerCount</code> is <code>VK_REMAINING_ARRAY_LAYERS</code>, the remaining number of layers <strong class=\"purple\">must</strong> be a multiple of <code>6</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_IMAGE_VIEW_CREATE_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-pNext-pNext",
|
|
"text": " Each <code>pNext</code> member of any structure (including this one) in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be either <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkExportMetalObjectCreateInfoEXT\">VkExportMetalObjectCreateInfoEXT</a>, <a href=\"#VkImageViewASTCDecodeModeEXT\">VkImageViewASTCDecodeModeEXT</a>, <a href=\"#VkImageViewMinLodCreateInfoEXT\">VkImageViewMinLodCreateInfoEXT</a>, <a href=\"#VkImageViewSampleWeightCreateInfoQCOM\">VkImageViewSampleWeightCreateInfoQCOM</a>, <a href=\"#VkImageViewUsageCreateInfo\">VkImageViewUsageCreateInfo</a>, or <a href=\"#VkSamplerYcbcrConversionInfo\">VkSamplerYcbcrConversionInfo</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique, with the exception of structures of type <a href=\"#VkExportMetalObjectCreateInfoEXT\">VkExportMetalObjectCreateInfoEXT</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkImageViewCreateFlagBits\">VkImageViewCreateFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-image-parameter",
|
|
"text": " <code>image</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImage\">VkImage</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-viewType-parameter",
|
|
"text": " <code>viewType</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageViewType\">VkImageViewType</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-format-parameter",
|
|
"text": " <code>format</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkFormat\">VkFormat</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-components-parameter",
|
|
"text": " <code>components</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkComponentMapping\">VkComponentMapping</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-subresourceRange-parameter",
|
|
"text": " <code>subresourceRange</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageSubresourceRange\">VkImageSubresourceRange</a> structure"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_maintenance1)": [
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-image-06723",
|
|
"text": " If <code>image</code> was created with <code>VK_IMAGE_TYPE_3D</code> but without <code>VK_IMAGE_CREATE_2D_ARRAY_COMPATIBLE_BIT</code> set then <code>viewType</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_VIEW_TYPE_2D_ARRAY</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-image-04970",
|
|
"text": " If <code>image</code> was created with <code>VK_IMAGE_TYPE_3D</code> and <code>viewType</code> is <code>VK_IMAGE_VIEW_TYPE_2D</code> or <code>VK_IMAGE_VIEW_TYPE_2D_ARRAY</code> then <code>subresourceRange.levelCount</code> <strong class=\"purple\">must</strong> be 1"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-image-04971",
|
|
"text": " If <code>image</code> was created with <code>VK_IMAGE_TYPE_3D</code> and <code>viewType</code> is <code>VK_IMAGE_VIEW_TYPE_2D</code> or <code>VK_IMAGE_VIEW_TYPE_2D_ARRAY</code> then <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a>::<code>flags</code> <strong class=\"purple\">must</strong> not contain any of <code>VK_IMAGE_CREATE_SPARSE_BINDING_BIT</code>, <code>VK_IMAGE_CREATE_SPARSE_RESIDENCY_BIT</code>, and <code>VK_IMAGE_CREATE_SPARSE_ALIASED_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-image-04972",
|
|
"text": " If <code>image</code> was created with a <code>samples</code> value not equal to <code>VK_SAMPLE_COUNT_1_BIT</code> then <code>viewType</code> <strong class=\"purple\">must</strong> be either <code>VK_IMAGE_VIEW_TYPE_2D</code> or <code>VK_IMAGE_VIEW_TYPE_2D_ARRAY</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-image-02724",
|
|
"text": " If <code>image</code> is a 3D image created with <code>VK_IMAGE_CREATE_2D_ARRAY_COMPATIBLE_BIT</code> set, and <code>viewType</code> is <code>VK_IMAGE_VIEW_TYPE_2D</code> or <code>VK_IMAGE_VIEW_TYPE_2D_ARRAY</code>, <code>subresourceRange.baseArrayLayer</code> <strong class=\"purple\">must</strong> be less than the depth computed from <code>baseMipLevel</code> and <code>extent.depth</code> specified in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> when <code>image</code> was created, according to the formula defined in <a href=\"#resources-image-miplevel-sizing\">Image Miplevel Sizing</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-subresourceRange-02725",
|
|
"text": " If <code>subresourceRange.layerCount</code> is not <code>VK_REMAINING_ARRAY_LAYERS</code>, <code>image</code> is a 3D image created with <code>VK_IMAGE_CREATE_2D_ARRAY_COMPATIBLE_BIT</code> set, and <code>viewType</code> is <code>VK_IMAGE_VIEW_TYPE_2D</code> or <code>VK_IMAGE_VIEW_TYPE_2D_ARRAY</code>, <code>subresourceRange.layerCount</code> <strong class=\"purple\">must</strong> be non-zero and <span class=\"eq\"><code>subresourceRange.baseArrayLayer</code> + <code>subresourceRange.layerCount</code></span> <strong class=\"purple\">must</strong> be less than or equal to the depth computed from <code>baseMipLevel</code> and <code>extent.depth</code> specified in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> when <code>image</code> was created, according to the formula defined in <a href=\"#resources-image-miplevel-sizing\">Image Miplevel Sizing</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_maintenance1)+!(VK_EXT_image_2d_view_of_3d)": [
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-image-06727",
|
|
"text": " If <code>image</code> was created with <code>VK_IMAGE_TYPE_3D</code> but without <code>VK_IMAGE_CREATE_2D_ARRAY_COMPATIBLE_BIT</code> set then <code>viewType</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_VIEW_TYPE_2D</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-image-01482",
|
|
"text": " If <code>image</code> is not a 3D image created with <code>VK_IMAGE_CREATE_2D_ARRAY_COMPATIBLE_BIT</code> set, or <code>viewType</code> is not <code>VK_IMAGE_VIEW_TYPE_2D</code> or <code>VK_IMAGE_VIEW_TYPE_2D_ARRAY</code>, <code>subresourceRange.baseArrayLayer</code> <strong class=\"purple\">must</strong> be less than the <code>arrayLayers</code> specified in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> when <code>image</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-subresourceRange-01483",
|
|
"text": " If <code>subresourceRange.layerCount</code> is not <code>VK_REMAINING_ARRAY_LAYERS</code>, <code>image</code> is not a 3D image created with <code>VK_IMAGE_CREATE_2D_ARRAY_COMPATIBLE_BIT</code> set, or <code>viewType</code> is not <code>VK_IMAGE_VIEW_TYPE_2D</code> or <code>VK_IMAGE_VIEW_TYPE_2D_ARRAY</code>, <code>subresourceRange.layerCount</code> <strong class=\"purple\">must</strong> be non-zero and <span class=\"eq\"><code>subresourceRange.baseArrayLayer</code> + <code>subresourceRange.layerCount</code></span> <strong class=\"purple\">must</strong> be less than or equal to the <code>arrayLayers</code> specified in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> when <code>image</code> was created"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_maintenance1)+(VK_EXT_image_2d_view_of_3d)": [
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-image-06728",
|
|
"text": " If <code>image</code> was created with <code>VK_IMAGE_TYPE_3D</code> but without <code>VK_IMAGE_CREATE_2D_ARRAY_COMPATIBLE_BIT</code> or <code>VK_IMAGE_CREATE_2D_VIEW_COMPATIBLE_BIT_EXT</code> set, then <code>viewType</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_VIEW_TYPE_2D</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-image-06724",
|
|
"text": " If <code>image</code> is not a 3D image created with <code>VK_IMAGE_CREATE_2D_ARRAY_COMPATIBLE_BIT</code> or <code>VK_IMAGE_CREATE_2D_VIEW_COMPATIBLE_BIT_EXT</code> set, or <code>viewType</code> is not <code>VK_IMAGE_VIEW_TYPE_2D</code> or <code>VK_IMAGE_VIEW_TYPE_2D_ARRAY</code>, <code>subresourceRange.baseArrayLayer</code> <strong class=\"purple\">must</strong> be less than the <code>arrayLayers</code> specified in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> when <code>image</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-subresourceRange-06725",
|
|
"text": " If <code>subresourceRange.layerCount</code> is not <code>VK_REMAINING_ARRAY_LAYERS</code>, <code>image</code> is not a 3D image created with <code>VK_IMAGE_CREATE_2D_ARRAY_COMPATIBLE_BIT</code> or <code>VK_IMAGE_CREATE_2D_VIEW_COMPATIBLE_BIT_EXT</code> set, or <code>viewType</code> is not <code>VK_IMAGE_VIEW_TYPE_2D</code> or <code>VK_IMAGE_VIEW_TYPE_2D_ARRAY</code>, <code>subresourceRange.layerCount</code> <strong class=\"purple\">must</strong> be non-zero and <span class=\"eq\"><code>subresourceRange.baseArrayLayer</code> + <code>subresourceRange.layerCount</code></span> <strong class=\"purple\">must</strong> be less than or equal to the <code>arrayLayers</code> specified in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> when <code>image</code> was created"
|
|
}
|
|
],
|
|
"(VK_NV_linear_color_attachment)": [
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-usage-06516",
|
|
"text": " If <code>usage</code> contains <code>VK_IMAGE_USAGE_COLOR_ATTACHMENT_BIT</code>, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_LINEAR_COLOR_ATTACHMENT_BIT_NV</code>, if the image is created with <code>VK_IMAGE_TILING_LINEAR</code> and the <a href=\"#features-linearColorAttachment\"><code>linearColorAttachment</code></a> feature is enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-usage-06517",
|
|
"text": " If <code>usage</code> contains <code>VK_IMAGE_USAGE_INPUT_ATTACHMENT_BIT</code>, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> must contain <code>VK_FORMAT_FEATURE_2_LINEAR_COLOR_ATTACHMENT_BIT_NV</code>, if the image is created with <code>VK_IMAGE_TILING_LINEAR</code> and the <a href=\"#features-linearColorAttachment\"><code>linearColorAttachment</code></a> feature is enabled"
|
|
}
|
|
],
|
|
"(VK_EXT_fragment_density_map)": [
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-image-02571",
|
|
"text": " If <code>image</code> was created with <code>usage</code> containing <code>VK_IMAGE_USAGE_FRAGMENT_DENSITY_MAP_BIT_EXT</code>, <code>subresourceRange.levelCount</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-flags-02572",
|
|
"text": " If the <a href=\"#features-fragmentDensityMapDynamic\"><code>fragmentDensityMapDynamic</code></a> feature is not enabled, <code>flags</code> <strong class=\"purple\">must</strong> not contain <code>VK_IMAGE_VIEW_CREATE_FRAGMENT_DENSITY_MAP_DYNAMIC_BIT_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-flags-04116",
|
|
"text": " If <code>flags</code> does not contain <code>VK_IMAGE_VIEW_CREATE_FRAGMENT_DENSITY_MAP_DYNAMIC_BIT_EXT</code> and <code>image</code> was created with <code>usage</code> containing <code>VK_IMAGE_USAGE_FRAGMENT_DENSITY_MAP_BIT_EXT</code>, its <code>flags</code> <strong class=\"purple\">must</strong> not contain any of <code>VK_IMAGE_CREATE_PROTECTED_BIT</code>, <code>VK_IMAGE_CREATE_SPARSE_BINDING_BIT</code>, <code>VK_IMAGE_CREATE_SPARSE_RESIDENCY_BIT</code>, or <code>VK_IMAGE_CREATE_SPARSE_ALIASED_BIT</code>"
|
|
}
|
|
],
|
|
"!(VK_VERSION_1_1,VK_KHR_maintenance1)": [
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-subresourceRange-01480",
|
|
"text": " <code>subresourceRange.baseArrayLayer</code> <strong class=\"purple\">must</strong> be less than the <code>arrayLayers</code> specified in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> when <code>image</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-subresourceRange-01719",
|
|
"text": " If <code>subresourceRange.layerCount</code> is not <code>VK_REMAINING_ARRAY_LAYERS</code>, <span class=\"eq\"><code>subresourceRange.baseArrayLayer</code> + <code>subresourceRange.layerCount</code></span> <strong class=\"purple\">must</strong> be less than or equal to the <code>arrayLayers</code> specified in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> when <code>image</code> was created"
|
|
}
|
|
],
|
|
"!(VK_VERSION_1_1,VK_KHR_maintenance2)+!(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-image-01018",
|
|
"text": " If <code>image</code> was created with the <code>VK_IMAGE_CREATE_MUTABLE_FORMAT_BIT</code> flag, <code>format</code> <strong class=\"purple\">must</strong> be compatible with the <code>format</code> used to create <code>image</code>, as defined in <a href=\"#formats-compatibility-classes\">Format Compatibility Classes</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_maintenance2)+!(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-image-01759",
|
|
"text": " If <code>image</code> was created with the <code>VK_IMAGE_CREATE_MUTABLE_FORMAT_BIT</code> flag, but without the <code>VK_IMAGE_CREATE_BLOCK_TEXEL_VIEW_COMPATIBLE_BIT</code> flag, <code>format</code> <strong class=\"purple\">must</strong> be compatible with the <code>format</code> used to create <code>image</code>, as defined in <a href=\"#formats-compatibility-classes\">Format Compatibility Classes</a>"
|
|
}
|
|
],
|
|
"!(VK_VERSION_1_1,VK_KHR_maintenance2)+(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-image-01760",
|
|
"text": " If <code>image</code> was created with the <code>VK_IMAGE_CREATE_MUTABLE_FORMAT_BIT</code> flag, and if the <code>format</code> of the <code>image</code> is not a <a href=\"#formats-requiring-sampler-ycbcr-conversion\">multi-planar</a> format, <code>format</code> <strong class=\"purple\">must</strong> be compatible with the <code>format</code> used to create <code>image</code>, as defined in <a href=\"#formats-compatibility-classes\">Format Compatibility Classes</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_maintenance2)+(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-image-01761",
|
|
"text": " If <code>image</code> was created with the <code>VK_IMAGE_CREATE_MUTABLE_FORMAT_BIT</code> flag, but without the <code>VK_IMAGE_CREATE_BLOCK_TEXEL_VIEW_COMPATIBLE_BIT</code> flag, and if the <code>format</code> of the <code>image</code> is not a <a href=\"#formats-requiring-sampler-ycbcr-conversion\">multi-planar</a> format, <code>format</code> <strong class=\"purple\">must</strong> be compatible with the <code>format</code> used to create <code>image</code>, as defined in <a href=\"#formats-compatibility-classes\">Format Compatibility Classes</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_maintenance2)": [
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-image-01583",
|
|
"text": " If <code>image</code> was created with the <code>VK_IMAGE_CREATE_BLOCK_TEXEL_VIEW_COMPATIBLE_BIT</code> flag, <code>format</code> <strong class=\"purple\">must</strong> be compatible with, or <strong class=\"purple\">must</strong> be an uncompressed format that is size-compatible with, the <code>format</code> used to create <code>image</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-image-01584",
|
|
"text": " If <code>image</code> was created with the <code>VK_IMAGE_CREATE_BLOCK_TEXEL_VIEW_COMPATIBLE_BIT</code> flag, the <code>levelCount</code> and <code>layerCount</code> members of <code>subresourceRange</code> <strong class=\"purple\">must</strong> both be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-image-04739",
|
|
"text": " If <code>image</code> was created with the <code>VK_IMAGE_CREATE_BLOCK_TEXEL_VIEW_COMPATIBLE_BIT</code> flag and <code>format</code> is a non-compressed format, <code>viewType</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_VIEW_TYPE_3D</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_image_format_list)": [
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-pNext-01585",
|
|
"text": " If a <a href=\"#VkImageFormatListCreateInfo\">VkImageFormatListCreateInfo</a> structure was included in the <code>pNext</code> chain of the <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> structure used when creating <code>image</code> and <a href=\"#VkImageFormatListCreateInfo\">VkImageFormatListCreateInfo</a>::<code>viewFormatCount</code> is not zero then <code>format</code> <strong class=\"purple\">must</strong> be one of the formats in <a href=\"#VkImageFormatListCreateInfo\">VkImageFormatListCreateInfo</a>::<code>pViewFormats</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-image-01586",
|
|
"text": " If <code>image</code> was created with the <code>VK_IMAGE_CREATE_MUTABLE_FORMAT_BIT</code> flag, if the <code>format</code> of the <code>image</code> is a <a href=\"#formats-requiring-sampler-ycbcr-conversion\">multi-planar</a> format, and if <code>subresourceRange.aspectMask</code> is one of <code>VK_IMAGE_ASPECT_PLANE_0_BIT</code>, <code>VK_IMAGE_ASPECT_PLANE_1_BIT</code>, or <code>VK_IMAGE_ASPECT_PLANE_2_BIT</code>, then <code>format</code> <strong class=\"purple\">must</strong> be compatible with the <a href=\"#VkFormat\">VkFormat</a> for the plane of the <code>image</code> <code>format</code> indicated by <code>subresourceRange.aspectMask</code>, as defined in <a href=\"#formats-compatible-planes\">Compatible formats of planes of multi-planar formats</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-image-01762",
|
|
"text": " If <code>image</code> was not created with the <code>VK_IMAGE_CREATE_MUTABLE_FORMAT_BIT</code> flag, or if the <code>format</code> of the <code>image</code> is a <a href=\"#formats-requiring-sampler-ycbcr-conversion\">multi-planar</a> format and if <code>subresourceRange.aspectMask</code> is <code>VK_IMAGE_ASPECT_COLOR_BIT</code>, <code>format</code> <strong class=\"purple\">must</strong> be identical to the <code>format</code> used to create <code>image</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-format-06415",
|
|
"text": " If the image view <a href=\"#image-views-requiring-sampler-ycbcr-conversion\">requires a sampler {YCbCr} conversion</a> and <code>usage</code> contains <code>VK_IMAGE_USAGE_SAMPLED_BIT</code>, then the <code>pNext</code> chain <strong class=\"purple\">must</strong> include a <a href=\"#VkSamplerYcbcrConversionInfo\">VkSamplerYcbcrConversionInfo</a> structure with a conversion value other than <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-format-04714",
|
|
"text": " If <code>format</code> has a <code>_422</code> or <code>_420</code> suffix then <code>image</code> <strong class=\"purple\">must</strong> have been created with a width that is a multiple of 2"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-format-04715",
|
|
"text": " If <code>format</code> has a <code>_420</code> suffix then <code>image</code> <strong class=\"purple\">must</strong> have been created with a height that is a multiple of 2"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-pNext-01970",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkSamplerYcbcrConversionInfo\">VkSamplerYcbcrConversionInfo</a> structure with a <code>conversion</code> value other than <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, all members of <code>components</code> <strong class=\"purple\">must</strong> have the <a href=\"#resources-image-views-identity-mappings\">identity swizzle</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-pNext-06658",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkSamplerYcbcrConversionInfo\">VkSamplerYcbcrConversionInfo</a> structure with a <code>conversion</code> value other than <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>format</code> <strong class=\"purple\">must</strong> be the same used in <a href=\"#VkSamplerYcbcrConversionCreateInfo\">VkSamplerYcbcrConversionCreateInfo</a>::<code>format</code>"
|
|
}
|
|
],
|
|
"!(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-image-01019",
|
|
"text": " If <code>image</code> was not created with the <code>VK_IMAGE_CREATE_MUTABLE_FORMAT_BIT</code> flag, <code>format</code> <strong class=\"purple\">must</strong> be identical to the <code>format</code> used to create <code>image</code>"
|
|
}
|
|
],
|
|
"(VK_ANDROID_external_memory_android_hardware_buffer)": [
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-image-02399",
|
|
"text": " If <code>image</code> has an <a href=\"#memory-external-android-hardware-buffer-external-formats\">external format</a>, <code>format</code> <strong class=\"purple\">must</strong> be <code>VK_FORMAT_UNDEFINED</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-image-02400",
|
|
"text": " If <code>image</code> has an <a href=\"#memory-external-android-hardware-buffer-external-formats\">external format</a>, the <code>pNext</code> chain <strong class=\"purple\">must</strong> include a <a href=\"#VkSamplerYcbcrConversionInfo\">VkSamplerYcbcrConversionInfo</a> structure with a <code>conversion</code> object created with the same external format as <code>image</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-image-02401",
|
|
"text": " If <code>image</code> has an <a href=\"#memory-external-android-hardware-buffer-external-formats\">external format</a>, all members of <code>components</code> <strong class=\"purple\">must</strong> be the <a href=\"#resources-image-views-identity-mappings\">identity swizzle</a>"
|
|
}
|
|
],
|
|
"(VK_KHR_fragment_shading_rate,VK_NV_shading_rate_image)": [
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-image-02086",
|
|
"text": " If <code>image</code> was created with <code>usage</code> containing <code>VK_IMAGE_USAGE_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR</code>, <code>viewType</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_VIEW_TYPE_2D</code> or <code>VK_IMAGE_VIEW_TYPE_2D_ARRAY</code>"
|
|
}
|
|
],
|
|
"(VK_NV_shading_rate_image)": [
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-image-02087",
|
|
"text": " If the <a href=\"#features-shadingRateImage\"><code>shadingRateImage</code></a> feature is enabled, and If <code>image</code> was created with <code>usage</code> containing <code>VK_IMAGE_USAGE_SHADING_RATE_IMAGE_BIT_NV</code>, <code>format</code> <strong class=\"purple\">must</strong> be <code>VK_FORMAT_R8_UINT</code>"
|
|
}
|
|
],
|
|
"(VK_KHR_fragment_shading_rate)": [
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-usage-04550",
|
|
"text": " If the <a href=\"#features-attachmentFragmentShadingRate\"><code>attachmentFragmentShadingRate</code></a> feature is enabled, and the <code>usage</code> for the image view includes <code>VK_IMAGE_USAGE_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR</code>, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-usage-04551",
|
|
"text": " If the <a href=\"#features-attachmentFragmentShadingRate\"><code>attachmentFragmentShadingRate</code></a> feature is enabled, the <code>usage</code> for the image view includes <code>VK_IMAGE_USAGE_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR</code>, and <a href=\"#limits-layeredShadingRateAttachments\"><code>layeredShadingRateAttachments</code></a> is <code>VK_FALSE</code>, <code>subresourceRange.layerCount</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_fragment_density_map)+(VK_EXT_fragment_density_map2)": [
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-flags-03567",
|
|
"text": " If the <a href=\"#features-fragmentDensityMapDeferred\"><code>fragmentDensityMapDeferred</code></a> feature is not enabled, <code>flags</code> <strong class=\"purple\">must</strong> not contain <code>VK_IMAGE_VIEW_CREATE_FRAGMENT_DENSITY_MAP_DEFERRED_BIT_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-flags-03568",
|
|
"text": " If <code>flags</code> contains <code>VK_IMAGE_VIEW_CREATE_FRAGMENT_DENSITY_MAP_DEFERRED_BIT_EXT</code>, <code>flags</code> <strong class=\"purple\">must</strong> not contain <code>VK_IMAGE_VIEW_CREATE_FRAGMENT_DENSITY_MAP_DYNAMIC_BIT_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-image-03569",
|
|
"text": " If <code>image</code> was created with <code>flags</code> containing <code>VK_IMAGE_CREATE_SUBSAMPLED_BIT_EXT</code> and <code>usage</code> containing <code>VK_IMAGE_USAGE_SAMPLED_BIT</code>, <code>subresourceRange.layerCount</code> <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#limits-maxSubsampledArrayLayers\"><code>VkPhysicalDeviceFragmentDensityMap2PropertiesEXT</code>::<code>maxSubsampledArrayLayers</code></a>"
|
|
}
|
|
],
|
|
"(VK_EXT_fragment_density_map)+(VK_HUAWEI_invocation_mask)": [
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-invocationMask-04993",
|
|
"text": " If the <a href=\"#features-invocationMask\"><code>invocationMask</code></a> feature is enabled, and if <code>image</code> was created with <code>usage</code> containing <code>VK_IMAGE_USAGE_INVOCATION_MASK_BIT_HUAWEI</code>, <code>format</code> <strong class=\"purple\">must</strong> be <code>VK_FORMAT_R8_UINT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_maintenance2)+!(VK_VERSION_1_2,VK_EXT_separate_stencil_usage)": [
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-pNext-02661",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkImageViewUsageCreateInfo\">VkImageViewUsageCreateInfo</a> structure, its <code>usage</code> member <strong class=\"purple\">must</strong> not include any bits that were not set in the <code>usage</code> member of the <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> structure used to create <code>image</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_maintenance2)+(VK_VERSION_1_2,VK_EXT_separate_stencil_usage)": [
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-pNext-02662",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkImageViewUsageCreateInfo\">VkImageViewUsageCreateInfo</a> structure, and <code>image</code> was not created with a <a href=\"#VkImageStencilUsageCreateInfo\">VkImageStencilUsageCreateInfo</a> structure included in the <code>pNext</code> chain of <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a>, its <code>usage</code> member <strong class=\"purple\">must</strong> not include any bits that were not set in the <code>usage</code> member of the <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> structure used to create <code>image</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-pNext-02663",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkImageViewUsageCreateInfo\">VkImageViewUsageCreateInfo</a> structure, <code>image</code> was created with a <a href=\"#VkImageStencilUsageCreateInfo\">VkImageStencilUsageCreateInfo</a> structure included in the <code>pNext</code> chain of <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a>, and <code>subresourceRange.aspectMask</code> includes <code>VK_IMAGE_ASPECT_STENCIL_BIT</code>, the <code>usage</code> member of the <a href=\"#VkImageViewUsageCreateInfo\">VkImageViewUsageCreateInfo</a> structure <strong class=\"purple\">must</strong> not include any bits that were not set in the <code>usage</code> member of the <a href=\"#VkImageStencilUsageCreateInfo\">VkImageStencilUsageCreateInfo</a> structure used to create <code>image</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-pNext-02664",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkImageViewUsageCreateInfo\">VkImageViewUsageCreateInfo</a> structure, <code>image</code> was created with a <a href=\"#VkImageStencilUsageCreateInfo\">VkImageStencilUsageCreateInfo</a> structure included in the <code>pNext</code> chain of <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a>, and <code>subresourceRange.aspectMask</code> includes bits other than <code>VK_IMAGE_ASPECT_STENCIL_BIT</code>, the <code>usage</code> member of the <a href=\"#VkImageViewUsageCreateInfo\">VkImageViewUsageCreateInfo</a> structure <strong class=\"purple\">must</strong> not include any bits that were not set in the <code>usage</code> member of the <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> structure used to create <code>image</code>"
|
|
}
|
|
],
|
|
"(VK_KHR_portability_subset)": [
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-imageViewFormatSwizzle-04465",
|
|
"text": " If the <code><a href=\"#VK_KHR_portability_subset\">VK_KHR_portability_subset</a></code> extension is enabled, and <a href=\"#VkPhysicalDevicePortabilitySubsetFeaturesKHR\">VkPhysicalDevicePortabilitySubsetFeaturesKHR</a>::<code>imageViewFormatSwizzle</code> is <code>VK_FALSE</code>, all elements of <code>components</code> <strong class=\"purple\">must</strong> have the <a href=\"#resources-image-views-identity-mappings\">identity swizzle</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-imageViewFormatReinterpretation-04466",
|
|
"text": " If the <code><a href=\"#VK_KHR_portability_subset\">VK_KHR_portability_subset</a></code> extension is enabled, and <a href=\"#VkPhysicalDevicePortabilitySubsetFeaturesKHR\">VkPhysicalDevicePortabilitySubsetFeaturesKHR</a>::<code>imageViewFormatReinterpretation</code> is <code>VK_FALSE</code>, the <a href=\"#VkFormat\">VkFormat</a> in <code>format</code> <strong class=\"purple\">must</strong> not contain a different number of components, or a different number of bits in each component, than the format of the <code>VkImage</code> in <code>image</code>"
|
|
}
|
|
],
|
|
"(VK_KHR_video_decode_queue)": [
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-image-04817",
|
|
"text": " If <code>image</code> was created with <code>usage</code> containing <code>VK_IMAGE_USAGE_VIDEO_DECODE_DST_BIT_KHR</code>, <code>VK_IMAGE_USAGE_VIDEO_DECODE_SRC_BIT_KHR</code>, <code>VK_IMAGE_USAGE_VIDEO_DECODE_DPB_BIT_KHR</code>, then the <code>viewType</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_VIEW_TYPE_2D</code> or <code>VK_IMAGE_VIEW_TYPE_2D_ARRAY</code> and all members of <code>components</code> <strong class=\"purple\">must</strong> have the <a href=\"#resources-image-views-identity-mappings\">identity swizzle</a>"
|
|
}
|
|
],
|
|
"(VK_KHR_video_encode_queue)": [
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-image-04818",
|
|
"text": " If <code>image</code> was created with <code>usage</code> containing <code>VK_IMAGE_USAGE_VIDEO_ENCODE_DST_BIT_KHR</code>, <code>VK_IMAGE_USAGE_VIDEO_ENCODE_SRC_BIT_KHR</code>, <code>VK_IMAGE_USAGE_VIDEO_ENCODE_DPB_BIT_KHR</code>, then the <code>viewType</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_VIEW_TYPE_2D</code> or <code>VK_IMAGE_VIEW_TYPE_2D_ARRAY</code> and all members of <code>components</code> <strong class=\"purple\">must</strong> have the <a href=\"#resources-image-views-identity-mappings\">identity swizzle</a>"
|
|
}
|
|
],
|
|
"(VK_EXT_metal_objects)": [
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-pNext-06787",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkExportMetalObjectCreateInfoEXT\">VkExportMetalObjectCreateInfoEXT</a> structure, its <code>exportObjectType</code> member <strong class=\"purple\">must</strong> be <code>VK_EXPORT_METAL_OBJECT_TYPE_METAL_TEXTURE_BIT_EXT</code>."
|
|
}
|
|
],
|
|
"(VK_QCOM_image_processing)": [
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-pNext-06944",
|
|
"text": " If the <code>pNext</code> chain includes <a href=\"#VkImageViewSampleWeightCreateInfoQCOM\">VkImageViewSampleWeightCreateInfoQCOM</a> structure, then <a href=\"#features-textureSampleWeighted\"><code>textureSampleWeighted</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-pNext-06945",
|
|
"text": " If the <code>pNext</code> chain includes <a href=\"#VkImageViewSampleWeightCreateInfoQCOM\">VkImageViewSampleWeightCreateInfoQCOM</a> structure, then <code>image</code> <strong class=\"purple\">must</strong> have been created with <code>usage</code> containing <code>VK_IMAGE_USAGE_SAMPLE_WEIGHT_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-pNext-06946",
|
|
"text": " If the <code>pNext</code> chain includes <a href=\"#VkImageViewSampleWeightCreateInfoQCOM\">VkImageViewSampleWeightCreateInfoQCOM</a> structure, then <code>components</code> <strong class=\"purple\">must</strong> be <code>VK_COMPONENT_SWIZZLE_IDENTITY</code> for all components"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-pNext-06947",
|
|
"text": " If the <code>pNext</code> chain includes <a href=\"#VkImageViewSampleWeightCreateInfoQCOM\">VkImageViewSampleWeightCreateInfoQCOM</a> structure, then <code>subresourceRange.aspectMask</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_ASPECT_COLOR_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-pNext-06948",
|
|
"text": " If the <code>pNext</code> chain includes <a href=\"#VkImageViewSampleWeightCreateInfoQCOM\">VkImageViewSampleWeightCreateInfoQCOM</a> structure, then <code>subresourceRange.levelCount</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-pNext-06949",
|
|
"text": " If the <code>pNext</code> chain includes <a href=\"#VkImageViewSampleWeightCreateInfoQCOM\">VkImageViewSampleWeightCreateInfoQCOM</a> structure, then <code>viewType</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_VIEW_TYPE_1D_ARRAY</code> or <code>VK_IMAGE_VIEW_TYPE_2D_ARRAY</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-pNext-06950",
|
|
"text": " If the <code>pNext</code> chain includes <a href=\"#VkImageViewSampleWeightCreateInfoQCOM\">VkImageViewSampleWeightCreateInfoQCOM</a> structure and if <code>viewType</code> is <code>VK_IMAGE_VIEW_TYPE_1D_ARRAY</code>, then <code>image</code> <strong class=\"purple\">must</strong> have been created with <code>imageType</code> <code>VK_IMAGE_TYPE_1D</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-pNext-06951",
|
|
"text": " If the <code>pNext</code> chain includes <a href=\"#VkImageViewSampleWeightCreateInfoQCOM\">VkImageViewSampleWeightCreateInfoQCOM</a> structure and <code>viewType</code> is <code>VK_IMAGE_VIEW_TYPE_1D_ARRAY</code>, then <code>subresourceRange.layerCount</code> <strong class=\"purple\">must</strong> be equal to <code>2</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-pNext-06952",
|
|
"text": " If the <code>pNext</code> chain includes <a href=\"#VkImageViewSampleWeightCreateInfoQCOM\">VkImageViewSampleWeightCreateInfoQCOM</a> structure and <code>viewType</code> is <code>VK_IMAGE_VIEW_TYPE_1D_ARRAY</code>, then <code>image</code> <strong class=\"purple\">must</strong> have been created with <code>width</code> equal to or greater than \\((numPhases \\times \\mathbin{max}\\left( \\mathbin{align}\\left(filterSize.width,4\\right), filterSize.height\\right))\\)"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-pNext-06953",
|
|
"text": " If the <code>pNext</code> chain includes <a href=\"#VkImageViewSampleWeightCreateInfoQCOM\">VkImageViewSampleWeightCreateInfoQCOM</a> structure and if <code>viewType</code> is <code>VK_IMAGE_VIEW_TYPE_2D_ARRAY</code>, then <code>image</code> <strong class=\"purple\">must</strong> have been created with <code>imageType</code> <code>VK_IMAGE_TYPE_2D</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-pNext-06954",
|
|
"text": " If the <code>pNext</code> chain includes <a href=\"#VkImageViewSampleWeightCreateInfoQCOM\">VkImageViewSampleWeightCreateInfoQCOM</a> structure and <code>viewType</code> is <code>VK_IMAGE_VIEW_TYPE_2D_ARRAY</code>, then <code>subresourceRange.layerCount</code> <strong class=\"purple\">must</strong> be equal or greater than <span class=\"eq\">numPhases</span>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-pNext-06955",
|
|
"text": " If the <code>pNext</code> chain includes <a href=\"#VkImageViewSampleWeightCreateInfoQCOM\">VkImageViewSampleWeightCreateInfoQCOM</a> structure and <code>viewType</code> is <code>VK_IMAGE_VIEW_TYPE_2D_ARRAY</code>, then <code>image</code> <strong class=\"purple\">must</strong> have been created with <code>width</code> equal to or greater than <code>filterSize.width</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-pNext-06956",
|
|
"text": " If the <code>pNext</code> chain includes <a href=\"#VkImageViewSampleWeightCreateInfoQCOM\">VkImageViewSampleWeightCreateInfoQCOM</a> structure and <code>viewType</code> is <code>VK_IMAGE_VIEW_TYPE_2D_ARRAY</code>, then <code>image</code> <strong class=\"purple\">must</strong> have been created with <code>height</code> equal to or greater than <code>filterSize.height</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewCreateInfo-pNext-06957",
|
|
"text": " If the <code>pNext</code> chain includes <a href=\"#VkImageViewSampleWeightCreateInfoQCOM\">VkImageViewSampleWeightCreateInfoQCOM</a> structure then <a href=\"#VkImageViewSampleWeightCreateInfoQCOM\">VkImageViewSampleWeightCreateInfoQCOM</a>::<code>filterSize.height</code> <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#limits-weightfilter-maxdimension\"><code>VkPhysicalDeviceImageProcessingPropertiesQCOM</code>::<code>maxWeightFilterDimension.height</code></a>"
|
|
}
|
|
]
|
|
},
|
|
"VkImageViewUsageCreateInfo": {
|
|
"(VK_VERSION_1_1,VK_KHR_maintenance2)": [
|
|
{
|
|
"vuid": "VUID-VkImageViewUsageCreateInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_IMAGE_VIEW_USAGE_CREATE_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewUsageCreateInfo-usage-parameter",
|
|
"text": " <code>usage</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkImageUsageFlagBits\">VkImageUsageFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewUsageCreateInfo-usage-requiredbitmask",
|
|
"text": " <code>usage</code> <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkImageSubresourceRange": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkImageSubresourceRange-levelCount-01720",
|
|
"text": " If <code>levelCount</code> is not <code>VK_REMAINING_MIP_LEVELS</code>, it <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageSubresourceRange-layerCount-01721",
|
|
"text": " If <code>layerCount</code> is not <code>VK_REMAINING_ARRAY_LAYERS</code>, it <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageSubresourceRange-aspectMask-parameter",
|
|
"text": " <code>aspectMask</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkImageAspectFlagBits\">VkImageAspectFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageSubresourceRange-aspectMask-requiredbitmask",
|
|
"text": " <code>aspectMask</code> <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-VkImageSubresourceRange-aspectMask-01670",
|
|
"text": " If <code>aspectMask</code> includes <code>VK_IMAGE_ASPECT_COLOR_BIT</code>, then it <strong class=\"purple\">must</strong> not include any of <code>VK_IMAGE_ASPECT_PLANE_0_BIT</code>, <code>VK_IMAGE_ASPECT_PLANE_1_BIT</code>, or <code>VK_IMAGE_ASPECT_PLANE_2_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_image_drm_format_modifier)": [
|
|
{
|
|
"vuid": "VUID-VkImageSubresourceRange-aspectMask-02278",
|
|
"text": " <code>aspectMask</code> <strong class=\"purple\">must</strong> not include <code>VK_IMAGE_ASPECT_MEMORY_PLANE<em>{ibit}</em>BIT_EXT</code> for any index <em>i</em>"
|
|
}
|
|
]
|
|
},
|
|
"VkComponentMapping": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkComponentMapping-r-parameter",
|
|
"text": " <code>r</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkComponentSwizzle\">VkComponentSwizzle</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkComponentMapping-g-parameter",
|
|
"text": " <code>g</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkComponentSwizzle\">VkComponentSwizzle</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkComponentMapping-b-parameter",
|
|
"text": " <code>b</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkComponentSwizzle\">VkComponentSwizzle</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkComponentMapping-a-parameter",
|
|
"text": " <code>a</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkComponentSwizzle\">VkComponentSwizzle</a> value"
|
|
}
|
|
]
|
|
},
|
|
"VkImageViewASTCDecodeModeEXT": {
|
|
"(VK_EXT_astc_decode_mode)": [
|
|
{
|
|
"vuid": "VUID-VkImageViewASTCDecodeModeEXT-decodeMode-02230",
|
|
"text": " <code>decodeMode</code> <strong class=\"purple\">must</strong> be one of <code>VK_FORMAT_R16G16B16A16_SFLOAT</code>, <code>VK_FORMAT_R8G8B8A8_UNORM</code>, or <code>VK_FORMAT_E5B9G9R9_UFLOAT_PACK32</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewASTCDecodeModeEXT-decodeMode-02231",
|
|
"text": " If the <a href=\"#features-astc-decodeModeSharedExponent\"><code>decodeModeSharedExponent</code></a> feature is not enabled, <code>decodeMode</code> <strong class=\"purple\">must</strong> not be <code>VK_FORMAT_E5B9G9R9_UFLOAT_PACK32</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewASTCDecodeModeEXT-decodeMode-02232",
|
|
"text": " If <code>decodeMode</code> is <code>VK_FORMAT_R8G8B8A8_UNORM</code> the image view <strong class=\"purple\">must</strong> not include blocks using any of the ASTC HDR modes"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewASTCDecodeModeEXT-format-04084",
|
|
"text": " <code>format</code> of the image view <strong class=\"purple\">must</strong> be one of the <a href=\"#appendix-compressedtex-astc\">ASTC Compressed Image Formats</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewASTCDecodeModeEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_IMAGE_VIEW_ASTC_DECODE_MODE_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewASTCDecodeModeEXT-decodeMode-parameter",
|
|
"text": " <code>decodeMode</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkFormat\">VkFormat</a> value"
|
|
}
|
|
]
|
|
},
|
|
"VkImageViewSampleWeightCreateInfoQCOM": {
|
|
"(VK_QCOM_image_processing)": [
|
|
{
|
|
"vuid": "VUID-VkImageViewSampleWeightCreateInfoQCOM-filterSize-06958",
|
|
"text": " <code>filterSize.width</code> <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#limits-weightfilter-maxdimension\"><code>VkPhysicalDeviceImageProcessingPropertiesQCOM</code>::<code>maxWeightFilterDimension.width</code></a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewSampleWeightCreateInfoQCOM-filterSize-06959",
|
|
"text": " <code>filterSize.height</code> <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#limits-weightfilter-maxdimension\"><code>VkPhysicalDeviceImageProcessingPropertiesQCOM</code>::<code>maxWeightFilterDimension.height</code></a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewSampleWeightCreateInfoQCOM-filterCenter-06960",
|
|
"text": " <code>filterCenter.x</code> <strong class=\"purple\">must</strong> be less than or equal to <span class=\"eq\">(filterSize.width - 1)</span>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewSampleWeightCreateInfoQCOM-filterCenter-06961",
|
|
"text": " <code>filterCenter.y</code> <strong class=\"purple\">must</strong> be less than or equal to <span class=\"eq\">(filterSize.height - 1)</span>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewSampleWeightCreateInfoQCOM-numPhases-06962",
|
|
"text": " <code>numPhases</code> <strong class=\"purple\">must</strong> be a power of two squared value (i.e., 1, 4, 16, 64, 256, etc.)"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewSampleWeightCreateInfoQCOM-numPhases-06963",
|
|
"text": " <code>numPhases</code> <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#limits-weightfilter-phases\"><code>VkPhysicalDeviceImageProcessingPropertiesQCOM</code>::<code>maxWeightFilterPhases</code></a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewSampleWeightCreateInfoQCOM-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_IMAGE_VIEW_SAMPLE_WEIGHT_CREATE_INFO_QCOM</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkDestroyImageView": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkDestroyImageView-imageView-01026",
|
|
"text": " All submitted commands that refer to <code>imageView</code> <strong class=\"purple\">must</strong> have completed execution"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyImageView-imageView-01027",
|
|
"text": " If <code>VkAllocationCallbacks</code> were provided when <code>imageView</code> was created, a compatible set of callbacks <strong class=\"purple\">must</strong> be provided here"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyImageView-imageView-01028",
|
|
"text": " If no <code>VkAllocationCallbacks</code> were provided when <code>imageView</code> was created, <code>pAllocator</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyImageView-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyImageView-imageView-parameter",
|
|
"text": " If <code>imageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>imageView</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageView\">VkImageView</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyImageView-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyImageView-imageView-parent",
|
|
"text": " If <code>imageView</code> is a valid handle, it <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetImageViewHandleNVX": {
|
|
"(VK_NVX_image_view_handle)": [
|
|
{
|
|
"vuid": "VUID-vkGetImageViewHandleNVX-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetImageViewHandleNVX-pInfo-parameter",
|
|
"text": " <code>pInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkImageViewHandleInfoNVX\">VkImageViewHandleInfoNVX</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkImageViewHandleInfoNVX": {
|
|
"(VK_NVX_image_view_handle)": [
|
|
{
|
|
"vuid": "VUID-VkImageViewHandleInfoNVX-descriptorType-02654",
|
|
"text": " <code>descriptorType</code> <strong class=\"purple\">must</strong> be <code>VK_DESCRIPTOR_TYPE_SAMPLED_IMAGE</code>, <code>VK_DESCRIPTOR_TYPE_STORAGE_IMAGE</code>, or <code>VK_DESCRIPTOR_TYPE_COMBINED_IMAGE_SAMPLER</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewHandleInfoNVX-sampler-02655",
|
|
"text": " <code>sampler</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSampler\">VkSampler</a> if <code>descriptorType</code> is <code>VK_DESCRIPTOR_TYPE_COMBINED_IMAGE_SAMPLER</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewHandleInfoNVX-imageView-02656",
|
|
"text": " If descriptorType is <code>VK_DESCRIPTOR_TYPE_SAMPLED_IMAGE</code> or <code>VK_DESCRIPTOR_TYPE_COMBINED_IMAGE_SAMPLER</code>, the image that <code>imageView</code> was created from <strong class=\"purple\">must</strong> have been created with the <code>VK_IMAGE_USAGE_SAMPLED_BIT</code> usage bit set"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewHandleInfoNVX-imageView-02657",
|
|
"text": " If descriptorType is <code>VK_DESCRIPTOR_TYPE_STORAGE_IMAGE</code>, the image that <code>imageView</code> was created from <strong class=\"purple\">must</strong> have been created with the <code>VK_IMAGE_USAGE_STORAGE_BIT</code> usage bit set"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewHandleInfoNVX-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_IMAGE_VIEW_HANDLE_INFO_NVX</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewHandleInfoNVX-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewHandleInfoNVX-imageView-parameter",
|
|
"text": " <code>imageView</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageView\">VkImageView</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewHandleInfoNVX-descriptorType-parameter",
|
|
"text": " <code>descriptorType</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDescriptorType\">VkDescriptorType</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewHandleInfoNVX-sampler-parameter",
|
|
"text": " If <code>sampler</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>sampler</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSampler\">VkSampler</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewHandleInfoNVX-commonparent",
|
|
"text": " Both of <code>imageView</code>, and <code>sampler</code> that are valid handles of non-ignored parameters <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetImageViewAddressNVX": {
|
|
"(VK_NVX_image_view_handle)": [
|
|
{
|
|
"vuid": "VUID-vkGetImageViewAddressNVX-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetImageViewAddressNVX-imageView-parameter",
|
|
"text": " <code>imageView</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageView\">VkImageView</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetImageViewAddressNVX-pProperties-parameter",
|
|
"text": " <code>pProperties</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkImageViewAddressPropertiesNVX\">VkImageViewAddressPropertiesNVX</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetImageViewAddressNVX-imageView-parent",
|
|
"text": " <code>imageView</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkImageViewAddressPropertiesNVX": {
|
|
"(VK_NVX_image_view_handle)": [
|
|
{
|
|
"vuid": "VUID-VkImageViewAddressPropertiesNVX-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_IMAGE_VIEW_ADDRESS_PROPERTIES_NVX</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewAddressPropertiesNVX-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkImageViewMinLodCreateInfoEXT": {
|
|
"(VK_EXT_image_view_min_lod)": [
|
|
{
|
|
"vuid": "VUID-VkImageViewMinLodCreateInfoEXT-minLod-06455",
|
|
"text": " If the <a href=\"#features-minLod\"><code>minLod</code></a> feature is not enabled, <code>minLod</code> <strong class=\"purple\">must</strong> be <code>0.0</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewMinLodCreateInfoEXT-minLod-06456",
|
|
"text": " <code>minLod</code> <strong class=\"purple\">must</strong> be less or equal to the index of the last mipmap level accessible to the view."
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageViewMinLodCreateInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_IMAGE_VIEW_MIN_LOD_CREATE_INFO_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCreateAccelerationStructureNV": {
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)+(VK_NV_ray_tracing)": [
|
|
{
|
|
"vuid": "VUID-vkCreateAccelerationStructureNV-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateAccelerationStructureNV-pCreateInfo-parameter",
|
|
"text": " <code>pCreateInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAccelerationStructureCreateInfoNV\">VkAccelerationStructureCreateInfoNV</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateAccelerationStructureNV-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateAccelerationStructureNV-pAccelerationStructure-parameter",
|
|
"text": " <code>pAccelerationStructure</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkAccelerationStructureNV\">VkAccelerationStructureNV</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkAccelerationStructureCreateInfoNV": {
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)+(VK_NV_ray_tracing)": [
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureCreateInfoNV-compactedSize-02421",
|
|
"text": " If <code>compactedSize</code> is not <code>0</code> then both <code>info.geometryCount</code> and <code>info.instanceCount</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureCreateInfoNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_ACCELERATION_STRUCTURE_CREATE_INFO_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureCreateInfoNV-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureCreateInfoNV-info-parameter",
|
|
"text": " <code>info</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkAccelerationStructureInfoNV\">VkAccelerationStructureInfoNV</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkAccelerationStructureInfoNV": {
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)+(VK_NV_ray_tracing)": [
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureInfoNV-geometryCount-02422",
|
|
"text": " <code>geometryCount</code> <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#VkPhysicalDeviceRayTracingPropertiesNV\">VkPhysicalDeviceRayTracingPropertiesNV</a>::<code>maxGeometryCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureInfoNV-instanceCount-02423",
|
|
"text": " <code>instanceCount</code> <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#VkPhysicalDeviceRayTracingPropertiesNV\">VkPhysicalDeviceRayTracingPropertiesNV</a>::<code>maxInstanceCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureInfoNV-maxTriangleCount-02424",
|
|
"text": " The total number of triangles in all geometries <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#VkPhysicalDeviceRayTracingPropertiesNV\">VkPhysicalDeviceRayTracingPropertiesNV</a>::<code>maxTriangleCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureInfoNV-type-02425",
|
|
"text": " If <code>type</code> is <code>VK_ACCELERATION_STRUCTURE_TYPE_TOP_LEVEL_NV</code> then <code>geometryCount</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureInfoNV-type-02426",
|
|
"text": " If <code>type</code> is <code>VK_ACCELERATION_STRUCTURE_TYPE_BOTTOM_LEVEL_NV</code> then <code>instanceCount</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureInfoNV-type-02786",
|
|
"text": " If <code>type</code> is <code>VK_ACCELERATION_STRUCTURE_TYPE_BOTTOM_LEVEL_NV</code> then the <code>geometryType</code> member of each geometry in <code>pGeometries</code> <strong class=\"purple\">must</strong> be the same"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureInfoNV-flags-02592",
|
|
"text": " If <code>flags</code> has the <code>VK_BUILD_ACCELERATION_STRUCTURE_PREFER_FAST_TRACE_BIT_NV</code> bit set, then it <strong class=\"purple\">must</strong> not have the <code>VK_BUILD_ACCELERATION_STRUCTURE_PREFER_FAST_BUILD_BIT_NV</code> bit set"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureInfoNV-scratch-02781",
|
|
"text": " <code>scratch</code> <strong class=\"purple\">must</strong> have been created with <code>VK_BUFFER_USAGE_RAY_TRACING_BIT_NV</code> usage flag"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureInfoNV-instanceData-02782",
|
|
"text": " If <code>instanceData</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>instanceData</code> <strong class=\"purple\">must</strong> have been created with <code>VK_BUFFER_USAGE_RAY_TRACING_BIT_NV</code> usage flag"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureInfoNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_ACCELERATION_STRUCTURE_INFO_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureInfoNV-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureInfoNV-type-parameter",
|
|
"text": " <code>type</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkAccelerationStructureTypeNV\">VkAccelerationStructureTypeNV</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureInfoNV-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkBuildAccelerationStructureFlagBitsNV\">VkBuildAccelerationStructureFlagBitsNV</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureInfoNV-pGeometries-parameter",
|
|
"text": " If <code>geometryCount</code> is not <code>0</code>, <code>pGeometries</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>geometryCount</code> valid <a href=\"#VkGeometryNV\">VkGeometryNV</a> structures"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)+(VK_NV_ray_tracing)+(VK_KHR_acceleration_structure)": [
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureInfoNV-type-04623",
|
|
"text": " <code>type</code> <strong class=\"purple\">must</strong> not be <code>VK_ACCELERATION_STRUCTURE_TYPE_GENERIC_KHR</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCreateAccelerationStructureKHR": {
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)+(VK_KHR_acceleration_structure)": [
|
|
{
|
|
"vuid": "VUID-vkCreateAccelerationStructureKHR-accelerationStructure-03611",
|
|
"text": " The <a href=\"#features-accelerationStructure\"><code>accelerationStructure</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateAccelerationStructureKHR-deviceAddress-03488",
|
|
"text": " If <a href=\"#VkAccelerationStructureCreateInfoKHR\">VkAccelerationStructureCreateInfoKHR</a>::<code>deviceAddress</code> is not zero, the <a href=\"#features-accelerationStructureCaptureReplay\"><code>accelerationStructureCaptureReplay</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateAccelerationStructureKHR-device-03489",
|
|
"text": " If <code>device</code> was created with multiple physical devices, then the <a href=\"#features-bufferDeviceAddressMultiDevice\"><code>bufferDeviceAddressMultiDevice</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateAccelerationStructureKHR-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateAccelerationStructureKHR-pCreateInfo-parameter",
|
|
"text": " <code>pCreateInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAccelerationStructureCreateInfoKHR\">VkAccelerationStructureCreateInfoKHR</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateAccelerationStructureKHR-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateAccelerationStructureKHR-pAccelerationStructure-parameter",
|
|
"text": " <code>pAccelerationStructure</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkAccelerationStructureKHR\">VkAccelerationStructureKHR</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkAccelerationStructureCreateInfoKHR": {
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)+(VK_KHR_acceleration_structure)": [
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureCreateInfoKHR-deviceAddress-03612",
|
|
"text": " If <code>deviceAddress</code> is not zero, <code>createFlags</code> <strong class=\"purple\">must</strong> include <code>VK_ACCELERATION_STRUCTURE_CREATE_DEVICE_ADDRESS_CAPTURE_REPLAY_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureCreateInfoKHR-createFlags-03613",
|
|
"text": " If <code>createFlags</code> includes <code>VK_ACCELERATION_STRUCTURE_CREATE_DEVICE_ADDRESS_CAPTURE_REPLAY_BIT_KHR</code>, <a href=\"#VkPhysicalDeviceAccelerationStructureFeaturesKHR\">VkPhysicalDeviceAccelerationStructureFeaturesKHR</a>::<code>accelerationStructureCaptureReplay</code> <strong class=\"purple\">must</strong> be <code>VK_TRUE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureCreateInfoKHR-buffer-03614",
|
|
"text": " <code>buffer</code> <strong class=\"purple\">must</strong> have been created with a <code>usage</code> value containing <code>VK_BUFFER_USAGE_ACCELERATION_STRUCTURE_STORAGE_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureCreateInfoKHR-buffer-03615",
|
|
"text": " <code>buffer</code> <strong class=\"purple\">must</strong> not have been created with <code>VK_BUFFER_CREATE_SPARSE_RESIDENCY_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureCreateInfoKHR-offset-03616",
|
|
"text": " The sum of <code>offset</code> and <code>size</code> <strong class=\"purple\">must</strong> be less than the size of <code>buffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureCreateInfoKHR-offset-03734",
|
|
"text": " <code>offset</code> <strong class=\"purple\">must</strong> be a multiple of <code>256</code> bytes"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureCreateInfoKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_ACCELERATION_STRUCTURE_CREATE_INFO_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureCreateInfoKHR-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkAccelerationStructureMotionInfoNV\">VkAccelerationStructureMotionInfoNV</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureCreateInfoKHR-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureCreateInfoKHR-createFlags-parameter",
|
|
"text": " <code>createFlags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkAccelerationStructureCreateFlagBitsKHR\">VkAccelerationStructureCreateFlagBitsKHR</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureCreateInfoKHR-buffer-parameter",
|
|
"text": " <code>buffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBuffer\">VkBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureCreateInfoKHR-type-parameter",
|
|
"text": " <code>type</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkAccelerationStructureTypeKHR\">VkAccelerationStructureTypeKHR</a> value"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)+(VK_KHR_acceleration_structure)+(VK_NV_ray_tracing_motion_blur)": [
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureCreateInfoKHR-flags-04954",
|
|
"text": " If <code>VK_ACCELERATION_STRUCTURE_CREATE_MOTION_BIT_NV</code> is set in <code>flags</code> and <code>type</code> is <code>VK_ACCELERATION_STRUCTURE_TYPE_TOP_LEVEL_KHR</code>, one member of the <code>pNext</code> chain <strong class=\"purple\">must</strong> be a pointer to a valid instance of <a href=\"#VkAccelerationStructureMotionInfoNV\">VkAccelerationStructureMotionInfoNV</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureCreateInfoKHR-flags-04955",
|
|
"text": " If any geometry includes <code>VkAccelerationStructureGeometryMotionTrianglesDataNV</code> then <code>flags</code> <strong class=\"purple\">must</strong> contain <code>VK_ACCELERATION_STRUCTURE_CREATE_MOTION_BIT_NV</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkAccelerationStructureMotionInfoNV": {
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)+(VK_KHR_acceleration_structure)+(VK_NV_ray_tracing_motion_blur)": [
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureMotionInfoNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_ACCELERATION_STRUCTURE_MOTION_INFO_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureMotionInfoNV-flags-zerobitmask",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetAccelerationStructureBuildSizesKHR": {
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)+(VK_KHR_acceleration_structure)": [
|
|
{
|
|
"vuid": "VUID-vkGetAccelerationStructureBuildSizesKHR-rayTracingPipeline-03617",
|
|
"text": " The <a href=\"#features-rayTracingPipeline\"><code>rayTracingPipeline</code></a> or <a href=\"#features-rayQuery\"><code>rayQuery</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetAccelerationStructureBuildSizesKHR-device-03618",
|
|
"text": " If <code>device</code> was created with multiple physical devices, then the <a href=\"#features-bufferDeviceAddressMultiDevice\"><code>bufferDeviceAddressMultiDevice</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetAccelerationStructureBuildSizesKHR-pBuildInfo-03619",
|
|
"text": " If <code>pBuildInfo->geometryCount</code> is not <code>0</code>, <code>pMaxPrimitiveCounts</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>pBuildInfo->geometryCount</code> <code>uint32_t</code> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetAccelerationStructureBuildSizesKHR-pBuildInfo-03785",
|
|
"text": " If <code>pBuildInfo->pGeometries</code> or <code>pBuildInfo->ppGeometries</code> has a <code>geometryType</code> of <code>VK_GEOMETRY_TYPE_INSTANCES_KHR</code>, each <code>pMaxPrimitiveCounts</code>[i] <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#VkPhysicalDeviceAccelerationStructurePropertiesKHR\">VkPhysicalDeviceAccelerationStructurePropertiesKHR</a>::<code>maxInstanceCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetAccelerationStructureBuildSizesKHR-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetAccelerationStructureBuildSizesKHR-buildType-parameter",
|
|
"text": " <code>buildType</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkAccelerationStructureBuildTypeKHR\">VkAccelerationStructureBuildTypeKHR</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetAccelerationStructureBuildSizesKHR-pBuildInfo-parameter",
|
|
"text": " <code>pBuildInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAccelerationStructureBuildGeometryInfoKHR\">VkAccelerationStructureBuildGeometryInfoKHR</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetAccelerationStructureBuildSizesKHR-pMaxPrimitiveCounts-parameter",
|
|
"text": " If <code>pMaxPrimitiveCounts</code> is not <code>NULL</code>, <code>pMaxPrimitiveCounts</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>pBuildInfo->geometryCount</code> <code>uint32_t</code> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetAccelerationStructureBuildSizesKHR-pSizeInfo-parameter",
|
|
"text": " <code>pSizeInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkAccelerationStructureBuildSizesInfoKHR\">VkAccelerationStructureBuildSizesInfoKHR</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkAccelerationStructureBuildSizesInfoKHR": {
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)+(VK_KHR_acceleration_structure)": [
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureBuildSizesInfoKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_ACCELERATION_STRUCTURE_BUILD_SIZES_INFO_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureBuildSizesInfoKHR-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkGeometryNV": {
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)+(VK_NV_ray_tracing)": [
|
|
{
|
|
"vuid": "VUID-VkGeometryNV-geometryType-03503",
|
|
"text": " <code>geometryType</code> <strong class=\"purple\">must</strong> be <code>VK_GEOMETRY_TYPE_TRIANGLES_NV</code> or <code>VK_GEOMETRY_TYPE_AABBS_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGeometryNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_GEOMETRY_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGeometryNV-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGeometryNV-geometryType-parameter",
|
|
"text": " <code>geometryType</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkGeometryTypeKHR\">VkGeometryTypeKHR</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGeometryNV-geometry-parameter",
|
|
"text": " <code>geometry</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkGeometryDataNV\">VkGeometryDataNV</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGeometryNV-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkGeometryFlagBitsKHR\">VkGeometryFlagBitsKHR</a> values"
|
|
}
|
|
]
|
|
},
|
|
"VkGeometryDataNV": {
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)+(VK_NV_ray_tracing)": [
|
|
{
|
|
"vuid": "VUID-VkGeometryDataNV-triangles-parameter",
|
|
"text": " <code>triangles</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkGeometryTrianglesNV\">VkGeometryTrianglesNV</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGeometryDataNV-aabbs-parameter",
|
|
"text": " <code>aabbs</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkGeometryAABBNV\">VkGeometryAABBNV</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkGeometryTrianglesNV": {
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)+(VK_NV_ray_tracing)": [
|
|
{
|
|
"vuid": "VUID-VkGeometryTrianglesNV-vertexOffset-02428",
|
|
"text": " <code>vertexOffset</code> <strong class=\"purple\">must</strong> be less than the size of <code>vertexData</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGeometryTrianglesNV-vertexOffset-02429",
|
|
"text": " <code>vertexOffset</code> <strong class=\"purple\">must</strong> be a multiple of the component size of <code>vertexFormat</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGeometryTrianglesNV-vertexFormat-02430",
|
|
"text": " <code>vertexFormat</code> <strong class=\"purple\">must</strong> be one of <code>VK_FORMAT_R32G32B32_SFLOAT</code>, <code>VK_FORMAT_R32G32_SFLOAT</code>, <code>VK_FORMAT_R16G16B16_SFLOAT</code>, <code>VK_FORMAT_R16G16_SFLOAT</code>, <code>VK_FORMAT_R16G16_SNORM</code>, or <code>VK_FORMAT_R16G16B16_SNORM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGeometryTrianglesNV-vertexStride-03818",
|
|
"text": " <code>vertexStride</code> <strong class=\"purple\">must</strong> be less than or equal to <span class=\"eq\">2<sup>32</sup>-1</span>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGeometryTrianglesNV-indexOffset-02431",
|
|
"text": " <code>indexOffset</code> <strong class=\"purple\">must</strong> be less than the size of <code>indexData</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGeometryTrianglesNV-indexOffset-02432",
|
|
"text": " <code>indexOffset</code> <strong class=\"purple\">must</strong> be a multiple of the element size of <code>indexType</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGeometryTrianglesNV-indexType-02433",
|
|
"text": " <code>indexType</code> <strong class=\"purple\">must</strong> be <code>VK_INDEX_TYPE_UINT16</code>, <code>VK_INDEX_TYPE_UINT32</code>, or <code>VK_INDEX_TYPE_NONE_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGeometryTrianglesNV-indexData-02434",
|
|
"text": " <code>indexData</code> <strong class=\"purple\">must</strong> be <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> if <code>indexType</code> is <code>VK_INDEX_TYPE_NONE_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGeometryTrianglesNV-indexData-02435",
|
|
"text": " <code>indexData</code> <strong class=\"purple\">must</strong> be a valid <code>VkBuffer</code> handle if <code>indexType</code> is not <code>VK_INDEX_TYPE_NONE_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGeometryTrianglesNV-indexCount-02436",
|
|
"text": " <code>indexCount</code> <strong class=\"purple\">must</strong> be <code>0</code> if <code>indexType</code> is <code>VK_INDEX_TYPE_NONE_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGeometryTrianglesNV-transformOffset-02437",
|
|
"text": " <code>transformOffset</code> <strong class=\"purple\">must</strong> be less than the size of <code>transformData</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGeometryTrianglesNV-transformOffset-02438",
|
|
"text": " <code>transformOffset</code> <strong class=\"purple\">must</strong> be a multiple of <code>16</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGeometryTrianglesNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_GEOMETRY_TRIANGLES_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGeometryTrianglesNV-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGeometryTrianglesNV-vertexData-parameter",
|
|
"text": " If <code>vertexData</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>vertexData</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBuffer\">VkBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGeometryTrianglesNV-vertexFormat-parameter",
|
|
"text": " <code>vertexFormat</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkFormat\">VkFormat</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGeometryTrianglesNV-indexData-parameter",
|
|
"text": " If <code>indexData</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>indexData</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBuffer\">VkBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGeometryTrianglesNV-indexType-parameter",
|
|
"text": " <code>indexType</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkIndexType\">VkIndexType</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGeometryTrianglesNV-transformData-parameter",
|
|
"text": " If <code>transformData</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>transformData</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBuffer\">VkBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGeometryTrianglesNV-commonparent",
|
|
"text": " Each of <code>indexData</code>, <code>transformData</code>, and <code>vertexData</code> that are valid handles of non-ignored parameters <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
]
|
|
},
|
|
"VkGeometryAABBNV": {
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)+(VK_NV_ray_tracing)": [
|
|
{
|
|
"vuid": "VUID-VkGeometryAABBNV-offset-02439",
|
|
"text": " <code>offset</code> <strong class=\"purple\">must</strong> be less than the size of <code>aabbData</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGeometryAABBNV-offset-02440",
|
|
"text": " <code>offset</code> <strong class=\"purple\">must</strong> be a multiple of <code>8</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGeometryAABBNV-stride-02441",
|
|
"text": " <code>stride</code> <strong class=\"purple\">must</strong> be a multiple of <code>8</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGeometryAABBNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_GEOMETRY_AABB_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGeometryAABBNV-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGeometryAABBNV-aabbData-parameter",
|
|
"text": " If <code>aabbData</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>aabbData</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBuffer\">VkBuffer</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"vkDestroyAccelerationStructureKHR": {
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)": [
|
|
{
|
|
"vuid": "VUID-vkDestroyAccelerationStructureKHR-accelerationStructure-02442",
|
|
"text": " All submitted commands that refer to <code>accelerationStructure</code> <strong class=\"purple\">must</strong> have completed execution"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyAccelerationStructureKHR-accelerationStructure-02443",
|
|
"text": " If <code>VkAllocationCallbacks</code> were provided when <code>accelerationStructure</code> was created, a compatible set of callbacks <strong class=\"purple\">must</strong> be provided here"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyAccelerationStructureKHR-accelerationStructure-02444",
|
|
"text": " If no <code>VkAllocationCallbacks</code> were provided when <code>accelerationStructure</code> was created, <code>pAllocator</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyAccelerationStructureKHR-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyAccelerationStructureKHR-accelerationStructure-parameter",
|
|
"text": " If <code>accelerationStructure</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>accelerationStructure</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkAccelerationStructureKHR\">VkAccelerationStructureKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyAccelerationStructureKHR-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyAccelerationStructureKHR-accelerationStructure-parent",
|
|
"text": " If <code>accelerationStructure</code> is a valid handle, it <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkDestroyAccelerationStructureNV": {
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)+(VK_NV_ray_tracing)": [
|
|
{
|
|
"vuid": "VUID-vkDestroyAccelerationStructureNV-accelerationStructure-03752",
|
|
"text": " All submitted commands that refer to <code>accelerationStructure</code> <strong class=\"purple\">must</strong> have completed execution"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyAccelerationStructureNV-accelerationStructure-03753",
|
|
"text": " If <code>VkAllocationCallbacks</code> were provided when <code>accelerationStructure</code> was created, a compatible set of callbacks <strong class=\"purple\">must</strong> be provided here"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyAccelerationStructureNV-accelerationStructure-03754",
|
|
"text": " If no <code>VkAllocationCallbacks</code> were provided when <code>accelerationStructure</code> was created, <code>pAllocator</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyAccelerationStructureNV-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyAccelerationStructureNV-accelerationStructure-parameter",
|
|
"text": " If <code>accelerationStructure</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>accelerationStructure</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkAccelerationStructureNV\">VkAccelerationStructureNV</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyAccelerationStructureNV-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyAccelerationStructureNV-accelerationStructure-parent",
|
|
"text": " If <code>accelerationStructure</code> is a valid handle, it <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetAccelerationStructureMemoryRequirementsNV": {
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)+(VK_NV_ray_tracing)": [
|
|
{
|
|
"vuid": "VUID-vkGetAccelerationStructureMemoryRequirementsNV-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetAccelerationStructureMemoryRequirementsNV-pInfo-parameter",
|
|
"text": " <code>pInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAccelerationStructureMemoryRequirementsInfoNV\">VkAccelerationStructureMemoryRequirementsInfoNV</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetAccelerationStructureMemoryRequirementsNV-pMemoryRequirements-parameter",
|
|
"text": " <code>pMemoryRequirements</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkMemoryRequirements2KHR\">VkMemoryRequirements2KHR</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkAccelerationStructureMemoryRequirementsInfoNV": {
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)+(VK_NV_ray_tracing)": [
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureMemoryRequirementsInfoNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_ACCELERATION_STRUCTURE_MEMORY_REQUIREMENTS_INFO_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureMemoryRequirementsInfoNV-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureMemoryRequirementsInfoNV-type-parameter",
|
|
"text": " <code>type</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkAccelerationStructureMemoryRequirementsTypeNV\">VkAccelerationStructureMemoryRequirementsTypeNV</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureMemoryRequirementsInfoNV-accelerationStructure-parameter",
|
|
"text": " <code>accelerationStructure</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkAccelerationStructureNV\">VkAccelerationStructureNV</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"vkBindAccelerationStructureMemoryNV": {
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)+(VK_NV_ray_tracing)": [
|
|
{
|
|
"vuid": "VUID-vkBindAccelerationStructureMemoryNV-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBindAccelerationStructureMemoryNV-pBindInfos-parameter",
|
|
"text": " <code>pBindInfos</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>bindInfoCount</code> valid <a href=\"#VkBindAccelerationStructureMemoryInfoNV\">VkBindAccelerationStructureMemoryInfoNV</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBindAccelerationStructureMemoryNV-bindInfoCount-arraylength",
|
|
"text": " <code>bindInfoCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkBindAccelerationStructureMemoryInfoNV": {
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)+(VK_NV_ray_tracing)": [
|
|
{
|
|
"vuid": "VUID-VkBindAccelerationStructureMemoryInfoNV-accelerationStructure-03620",
|
|
"text": " <code>accelerationStructure</code> <strong class=\"purple\">must</strong> not already be backed by a memory object"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindAccelerationStructureMemoryInfoNV-memoryOffset-03621",
|
|
"text": " <code>memoryOffset</code> <strong class=\"purple\">must</strong> be less than the size of <code>memory</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindAccelerationStructureMemoryInfoNV-memory-03622",
|
|
"text": " <code>memory</code> <strong class=\"purple\">must</strong> have been allocated using one of the memory types allowed in the <code>memoryTypeBits</code> member of the <a href=\"#VkMemoryRequirements\">VkMemoryRequirements</a> structure returned from a call to <a href=\"#vkGetAccelerationStructureMemoryRequirementsNV\">vkGetAccelerationStructureMemoryRequirementsNV</a> with <code>accelerationStructure</code> and <code>type</code> of <code>VK_ACCELERATION_STRUCTURE_MEMORY_REQUIREMENTS_TYPE_OBJECT_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindAccelerationStructureMemoryInfoNV-memoryOffset-03623",
|
|
"text": " <code>memoryOffset</code> <strong class=\"purple\">must</strong> be an integer multiple of the <code>alignment</code> member of the <a href=\"#VkMemoryRequirements\">VkMemoryRequirements</a> structure returned from a call to <a href=\"#vkGetAccelerationStructureMemoryRequirementsNV\">vkGetAccelerationStructureMemoryRequirementsNV</a> with <code>accelerationStructure</code> and <code>type</code> of <code>VK_ACCELERATION_STRUCTURE_MEMORY_REQUIREMENTS_TYPE_OBJECT_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindAccelerationStructureMemoryInfoNV-size-03624",
|
|
"text": " The <code>size</code> member of the <code>VkMemoryRequirements</code> structure returned from a call to <a href=\"#vkGetAccelerationStructureMemoryRequirementsNV\">vkGetAccelerationStructureMemoryRequirementsNV</a> with <code>accelerationStructure</code> and <code>type</code> of <code>VK_ACCELERATION_STRUCTURE_MEMORY_REQUIREMENTS_TYPE_OBJECT_NV</code> <strong class=\"purple\">must</strong> be less than or equal to the size of <code>memory</code> minus <code>memoryOffset</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindAccelerationStructureMemoryInfoNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_BIND_ACCELERATION_STRUCTURE_MEMORY_INFO_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindAccelerationStructureMemoryInfoNV-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindAccelerationStructureMemoryInfoNV-accelerationStructure-parameter",
|
|
"text": " <code>accelerationStructure</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkAccelerationStructureNV\">VkAccelerationStructureNV</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindAccelerationStructureMemoryInfoNV-memory-parameter",
|
|
"text": " <code>memory</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDeviceMemory\">VkDeviceMemory</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindAccelerationStructureMemoryInfoNV-pDeviceIndices-parameter",
|
|
"text": " If <code>deviceIndexCount</code> is not <code>0</code>, <code>pDeviceIndices</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>deviceIndexCount</code> <code>uint32_t</code> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindAccelerationStructureMemoryInfoNV-commonparent",
|
|
"text": " Both of <code>accelerationStructure</code>, and <code>memory</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetAccelerationStructureHandleNV": {
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)+(VK_NV_ray_tracing)": [
|
|
{
|
|
"vuid": "VUID-vkGetAccelerationStructureHandleNV-dataSize-02240",
|
|
"text": " <code>dataSize</code> <strong class=\"purple\">must</strong> be large enough to contain the result of the query, as described above"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetAccelerationStructureHandleNV-accelerationStructure-02787",
|
|
"text": " <code>accelerationStructure</code> <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object via <a href=\"#vkBindAccelerationStructureMemoryNV\">vkBindAccelerationStructureMemoryNV</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetAccelerationStructureHandleNV-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetAccelerationStructureHandleNV-accelerationStructure-parameter",
|
|
"text": " <code>accelerationStructure</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkAccelerationStructureNV\">VkAccelerationStructureNV</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetAccelerationStructureHandleNV-pData-parameter",
|
|
"text": " <code>pData</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>dataSize</code> bytes"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetAccelerationStructureHandleNV-dataSize-arraylength",
|
|
"text": " <code>dataSize</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetAccelerationStructureHandleNV-accelerationStructure-parent",
|
|
"text": " <code>accelerationStructure</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetAccelerationStructureDeviceAddressKHR": {
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)+(VK_KHR_acceleration_structure)": [
|
|
{
|
|
"vuid": "VUID-vkGetAccelerationStructureDeviceAddressKHR-device-03504",
|
|
"text": " If <code>device</code> was created with multiple physical devices, then the <a href=\"#features-bufferDeviceAddressMultiDevice\"><code>bufferDeviceAddressMultiDevice</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetAccelerationStructureDeviceAddressKHR-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetAccelerationStructureDeviceAddressKHR-pInfo-parameter",
|
|
"text": " <code>pInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAccelerationStructureDeviceAddressInfoKHR\">VkAccelerationStructureDeviceAddressInfoKHR</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkAccelerationStructureDeviceAddressInfoKHR": {
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)+(VK_KHR_acceleration_structure)": [
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureDeviceAddressInfoKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_ACCELERATION_STRUCTURE_DEVICE_ADDRESS_INFO_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureDeviceAddressInfoKHR-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureDeviceAddressInfoKHR-accelerationStructure-parameter",
|
|
"text": " <code>accelerationStructure</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkAccelerationStructureKHR\">VkAccelerationStructureKHR</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"vkGetBufferMemoryRequirements": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkGetBufferMemoryRequirements-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetBufferMemoryRequirements-buffer-parameter",
|
|
"text": " <code>buffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBuffer\">VkBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetBufferMemoryRequirements-pMemoryRequirements-parameter",
|
|
"text": " <code>pMemoryRequirements</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkMemoryRequirements\">VkMemoryRequirements</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetBufferMemoryRequirements-buffer-parent",
|
|
"text": " <code>buffer</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetImageMemoryRequirements": {
|
|
"(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-vkGetImageMemoryRequirements-image-01588",
|
|
"text": " <code>image</code> <strong class=\"purple\">must</strong> not have been created with the <code>VK_IMAGE_CREATE_DISJOINT_BIT</code> flag set"
|
|
}
|
|
],
|
|
"(VK_ANDROID_external_memory_android_hardware_buffer)": [
|
|
{
|
|
"vuid": "VUID-vkGetImageMemoryRequirements-image-04004",
|
|
"text": " If <code>image</code> was created with the <code>VK_EXTERNAL_MEMORY_HANDLE_TYPE_ANDROID_HARDWARE_BUFFER_BIT_ANDROID</code> external memory handle type, then <code>image</code> <strong class=\"purple\">must</strong> be bound to memory"
|
|
}
|
|
],
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkGetImageMemoryRequirements-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetImageMemoryRequirements-image-parameter",
|
|
"text": " <code>image</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImage\">VkImage</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetImageMemoryRequirements-pMemoryRequirements-parameter",
|
|
"text": " <code>pMemoryRequirements</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkMemoryRequirements\">VkMemoryRequirements</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetImageMemoryRequirements-image-parent",
|
|
"text": " <code>image</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetBufferMemoryRequirements2": {
|
|
"(VK_VERSION_1_1,VK_KHR_get_memory_requirements2)": [
|
|
{
|
|
"vuid": "VUID-vkGetBufferMemoryRequirements2-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetBufferMemoryRequirements2-pInfo-parameter",
|
|
"text": " <code>pInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkBufferMemoryRequirementsInfo2\">VkBufferMemoryRequirementsInfo2</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetBufferMemoryRequirements2-pMemoryRequirements-parameter",
|
|
"text": " <code>pMemoryRequirements</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkMemoryRequirements2\">VkMemoryRequirements2</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"vkGetDeviceBufferMemoryRequirements": {
|
|
"(VK_VERSION_1_1,VK_KHR_get_memory_requirements2)+(VK_VERSION_1_3,VK_KHR_maintenance4)": [
|
|
{
|
|
"vuid": "VUID-vkGetDeviceBufferMemoryRequirements-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDeviceBufferMemoryRequirements-pInfo-parameter",
|
|
"text": " <code>pInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkDeviceBufferMemoryRequirements\">VkDeviceBufferMemoryRequirements</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDeviceBufferMemoryRequirements-pMemoryRequirements-parameter",
|
|
"text": " <code>pMemoryRequirements</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkMemoryRequirements2\">VkMemoryRequirements2</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkBufferMemoryRequirementsInfo2": {
|
|
"(VK_VERSION_1_1,VK_KHR_get_memory_requirements2)": [
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryRequirementsInfo2-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_BUFFER_MEMORY_REQUIREMENTS_INFO_2</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryRequirementsInfo2-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferMemoryRequirementsInfo2-buffer-parameter",
|
|
"text": " <code>buffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBuffer\">VkBuffer</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkDeviceBufferMemoryRequirements": {
|
|
"(VK_VERSION_1_1,VK_KHR_get_memory_requirements2)+(VK_VERSION_1_3,VK_KHR_maintenance4)": [
|
|
{
|
|
"vuid": "VUID-VkDeviceBufferMemoryRequirements-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_DEVICE_BUFFER_MEMORY_REQUIREMENTS</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceBufferMemoryRequirements-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceBufferMemoryRequirements-pCreateInfo-parameter",
|
|
"text": " <code>pCreateInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkBufferCreateInfo\">VkBufferCreateInfo</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"vkGetImageMemoryRequirements2": {
|
|
"(VK_VERSION_1_1,VK_KHR_get_memory_requirements2)": [
|
|
{
|
|
"vuid": "VUID-vkGetImageMemoryRequirements2-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetImageMemoryRequirements2-pInfo-parameter",
|
|
"text": " <code>pInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkImageMemoryRequirementsInfo2\">VkImageMemoryRequirementsInfo2</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetImageMemoryRequirements2-pMemoryRequirements-parameter",
|
|
"text": " <code>pMemoryRequirements</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkMemoryRequirements2\">VkMemoryRequirements2</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"vkGetDeviceImageMemoryRequirements": {
|
|
"(VK_VERSION_1_1,VK_KHR_get_memory_requirements2)+(VK_VERSION_1_3,VK_KHR_maintenance4)": [
|
|
{
|
|
"vuid": "VUID-vkGetDeviceImageMemoryRequirements-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDeviceImageMemoryRequirements-pInfo-parameter",
|
|
"text": " <code>pInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkDeviceImageMemoryRequirements\">VkDeviceImageMemoryRequirements</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDeviceImageMemoryRequirements-pMemoryRequirements-parameter",
|
|
"text": " <code>pMemoryRequirements</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkMemoryRequirements2\">VkMemoryRequirements2</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkImageMemoryRequirementsInfo2": {
|
|
"(VK_VERSION_1_1,VK_KHR_get_memory_requirements2)+(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-VkImageMemoryRequirementsInfo2-image-01589",
|
|
"text": " If <code>image</code> was created with a <em>multi-planar</em> format and the <code>VK_IMAGE_CREATE_DISJOINT_BIT</code> flag, there <strong class=\"purple\">must</strong> be a <a href=\"#VkImagePlaneMemoryRequirementsInfo\">VkImagePlaneMemoryRequirementsInfo</a> included in the <code>pNext</code> chain of the <a href=\"#VkImageMemoryRequirementsInfo2\">VkImageMemoryRequirementsInfo2</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryRequirementsInfo2-image-01590",
|
|
"text": " If <code>image</code> was not created with the <code>VK_IMAGE_CREATE_DISJOINT_BIT</code> flag, there <strong class=\"purple\">must</strong> not be a <a href=\"#VkImagePlaneMemoryRequirementsInfo\">VkImagePlaneMemoryRequirementsInfo</a> included in the <code>pNext</code> chain of the <a href=\"#VkImageMemoryRequirementsInfo2\">VkImageMemoryRequirementsInfo2</a> structure"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_get_memory_requirements2)+(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)+(VK_EXT_image_drm_format_modifier)": [
|
|
{
|
|
"vuid": "VUID-VkImageMemoryRequirementsInfo2-image-02279",
|
|
"text": " If <code>image</code> was created with <code>VK_IMAGE_CREATE_DISJOINT_BIT</code> and with <code>VK_IMAGE_TILING_DRM_FORMAT_MODIFIER_EXT</code>, then there <strong class=\"purple\">must</strong> be a <a href=\"#VkImagePlaneMemoryRequirementsInfo\">VkImagePlaneMemoryRequirementsInfo</a> included in the <code>pNext</code> chain of the <a href=\"#VkImageMemoryRequirementsInfo2\">VkImageMemoryRequirementsInfo2</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryRequirementsInfo2-image-02280",
|
|
"text": " If <code>image</code> was created with a single-plane format and with any <code>tiling</code> other than <code>VK_IMAGE_TILING_DRM_FORMAT_MODIFIER_EXT</code>, then there <strong class=\"purple\">must</strong> not be a <a href=\"#VkImagePlaneMemoryRequirementsInfo\">VkImagePlaneMemoryRequirementsInfo</a> included in the <code>pNext</code> chain of the <a href=\"#VkImageMemoryRequirementsInfo2\">VkImageMemoryRequirementsInfo2</a> structure"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_get_memory_requirements2)+(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)+!(VK_EXT_image_drm_format_modifier)": [
|
|
{
|
|
"vuid": "VUID-VkImageMemoryRequirementsInfo2-image-01591",
|
|
"text": " If <code>image</code> was created with a single-plane format, there <strong class=\"purple\">must</strong> not be a <a href=\"#VkImagePlaneMemoryRequirementsInfo\">VkImagePlaneMemoryRequirementsInfo</a> included in the <code>pNext</code> chain of the <a href=\"#VkImageMemoryRequirementsInfo2\">VkImageMemoryRequirementsInfo2</a> structure"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_get_memory_requirements2)+(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)+(VK_ANDROID_external_memory_android_hardware_buffer)": [
|
|
{
|
|
"vuid": "VUID-VkImageMemoryRequirementsInfo2-image-01897",
|
|
"text": " If <code>image</code> was created with the <code>VK_EXTERNAL_MEMORY_HANDLE_TYPE_ANDROID_HARDWARE_BUFFER_BIT_ANDROID</code> external memory handle type, then <code>image</code> <strong class=\"purple\">must</strong> be bound to memory"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_get_memory_requirements2)": [
|
|
{
|
|
"vuid": "VUID-VkImageMemoryRequirementsInfo2-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_IMAGE_MEMORY_REQUIREMENTS_INFO_2</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryRequirementsInfo2-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkImagePlaneMemoryRequirementsInfo\">VkImagePlaneMemoryRequirementsInfo</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryRequirementsInfo2-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageMemoryRequirementsInfo2-image-parameter",
|
|
"text": " <code>image</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImage\">VkImage</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkDeviceImageMemoryRequirements": {
|
|
"(VK_VERSION_1_1,VK_KHR_get_memory_requirements2)+(VK_VERSION_1_3,VK_KHR_maintenance4)": [
|
|
{
|
|
"vuid": "VUID-VkDeviceImageMemoryRequirementsKHR-pCreateInfo-06416",
|
|
"text": " The <code>pCreateInfo</code>::<code>pNext</code> chain <strong class=\"purple\">must</strong> not contain a <a href=\"#VkImageSwapchainCreateInfoKHR\">VkImageSwapchainCreateInfoKHR</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceImageMemoryRequirementsKHR-pCreateInfo-06417",
|
|
"text": " If <code>pCreateInfo</code>::<code>format</code> specifies a <em>multi-planar</em> format and <code>pCreateInfo</code>::<code>flags</code> has <code>VK_IMAGE_CREATE_DISJOINT_BIT</code> set then <code>planeAspect</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_ASPECT_NONE_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceImageMemoryRequirementsKHR-pCreateInfo-06419",
|
|
"text": " If <code>pCreateInfo</code>::<code>flags</code> has <code>VK_IMAGE_CREATE_DISJOINT_BIT</code> set and if the <code>pCreateInfo</code>::<code>tiling</code> is <code>VK_IMAGE_TILING_LINEAR</code> or <code>VK_IMAGE_TILING_OPTIMAL</code>, then <code>planeAspect</code> <strong class=\"purple\">must</strong> be a single valid <em>format plane</em> for the image (that is, for a two-plane image <code>planeAspect</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_ASPECT_PLANE_0_BIT</code> or <code>VK_IMAGE_ASPECT_PLANE_1_BIT</code>, and for a three-plane image <code>planeAspect</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_ASPECT_PLANE_0_BIT</code>, <code>VK_IMAGE_ASPECT_PLANE_1_BIT</code> or <code>VK_IMAGE_ASPECT_PLANE_2_BIT</code>)"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceImageMemoryRequirements-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_DEVICE_IMAGE_MEMORY_REQUIREMENTS</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceImageMemoryRequirements-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceImageMemoryRequirements-pCreateInfo-parameter",
|
|
"text": " <code>pCreateInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceImageMemoryRequirements-planeAspect-parameter",
|
|
"text": " If <code>planeAspect</code> is not <code>0</code>, <code>planeAspect</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageAspectFlagBits\">VkImageAspectFlagBits</a> value"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_get_memory_requirements2)+(VK_VERSION_1_3,VK_KHR_maintenance4)+(VK_EXT_image_drm_format_modifier)": [
|
|
{
|
|
"vuid": "VUID-VkDeviceImageMemoryRequirements-pCreateInfo-06776",
|
|
"text": " The <code>pCreateInfo</code>::<code>pNext</code> chain <strong class=\"purple\">must</strong> not contain a <a href=\"#VkImageDrmFormatModifierExplicitCreateInfoEXT\">VkImageDrmFormatModifierExplicitCreateInfoEXT</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceImageMemoryRequirementsKHR-pCreateInfo-06420",
|
|
"text": " If <code>pCreateInfo</code>::<code>tiling</code> is <code>VK_IMAGE_TILING_DRM_FORMAT_MODIFIER_EXT</code>, then <code>planeAspect</code> <strong class=\"purple\">must</strong> be a single valid <em>memory plane</em> for the image (that is, <code>aspectMask</code> <strong class=\"purple\">must</strong> specify a plane index that is less than the <a href=\"#VkDrmFormatModifierPropertiesEXT\">VkDrmFormatModifierPropertiesEXT</a>::<code>drmFormatModifierPlaneCount</code> associated with the image’s <code>format</code> and <a href=\"#VkImageDrmFormatModifierPropertiesEXT\">VkImageDrmFormatModifierPropertiesEXT</a>::<code>drmFormatModifier</code>)"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_get_memory_requirements2)+(VK_VERSION_1_3,VK_KHR_maintenance4)+(VK_ANDROID_external_memory_android_hardware_buffer)+(VK_VERSION_1_3,VK_KHR_maintenance4)": [
|
|
{
|
|
"vuid": "VUID-VkDeviceImageMemoryRequirements-pNext-06996",
|
|
"text": " Applications also <strong class=\"purple\">must</strong> not call <a href=\"#vkGetDeviceImageMemoryRequirements\">vkGetDeviceImageMemoryRequirements</a> with a <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> whose <code>pNext</code> chain includes a <a href=\"#VkExternalFormatANDROID\">VkExternalFormatANDROID</a> structure with non-zero <code>externalFormat</code>."
|
|
}
|
|
]
|
|
},
|
|
"VkImagePlaneMemoryRequirementsInfo": {
|
|
"(VK_VERSION_1_1,VK_KHR_get_memory_requirements2)+(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-VkImagePlaneMemoryRequirementsInfo-planeAspect-02281",
|
|
"text": " If the image’s <code>tiling</code> is <code>VK_IMAGE_TILING_LINEAR</code> or <code>VK_IMAGE_TILING_OPTIMAL</code>, then <code>planeAspect</code> <strong class=\"purple\">must</strong> be a single valid <em>format plane</em> for the image (that is, for a two-plane image <code>planeAspect</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_ASPECT_PLANE_0_BIT</code> or <code>VK_IMAGE_ASPECT_PLANE_1_BIT</code>, and for a three-plane image <code>planeAspect</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_ASPECT_PLANE_0_BIT</code>, <code>VK_IMAGE_ASPECT_PLANE_1_BIT</code> or <code>VK_IMAGE_ASPECT_PLANE_2_BIT</code>)"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImagePlaneMemoryRequirementsInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_IMAGE_PLANE_MEMORY_REQUIREMENTS_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImagePlaneMemoryRequirementsInfo-planeAspect-parameter",
|
|
"text": " <code>planeAspect</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageAspectFlagBits\">VkImageAspectFlagBits</a> value"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_get_memory_requirements2)+(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)+(VK_EXT_image_drm_format_modifier)": [
|
|
{
|
|
"vuid": "VUID-VkImagePlaneMemoryRequirementsInfo-planeAspect-02282",
|
|
"text": " If the image’s <code>tiling</code> is <code>VK_IMAGE_TILING_DRM_FORMAT_MODIFIER_EXT</code>, then <code>planeAspect</code> <strong class=\"purple\">must</strong> be a single valid <em>memory plane</em> for the image (that is, <code>aspectMask</code> <strong class=\"purple\">must</strong> specify a plane index that is less than the <a href=\"#VkDrmFormatModifierPropertiesEXT\">VkDrmFormatModifierPropertiesEXT</a>::<code>drmFormatModifierPlaneCount</code> associated with the image’s <code>format</code> and <a href=\"#VkImageDrmFormatModifierPropertiesEXT\">VkImageDrmFormatModifierPropertiesEXT</a>::<code>drmFormatModifier</code>)"
|
|
}
|
|
]
|
|
},
|
|
"VkMemoryRequirements2": {
|
|
"(VK_VERSION_1_1,VK_KHR_get_memory_requirements2)": [
|
|
{
|
|
"vuid": "VUID-VkMemoryRequirements2-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_MEMORY_REQUIREMENTS_2</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryRequirements2-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkMemoryDedicatedRequirements\">VkMemoryDedicatedRequirements</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMemoryRequirements2-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
}
|
|
]
|
|
},
|
|
"VkMemoryDedicatedRequirements": {
|
|
"(VK_VERSION_1_1,VK_KHR_dedicated_allocation)": [
|
|
{
|
|
"vuid": "VUID-VkMemoryDedicatedRequirements-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_MEMORY_DEDICATED_REQUIREMENTS</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkBindBufferMemory": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkBindBufferMemory-buffer-01029",
|
|
"text": " <code>buffer</code> <strong class=\"purple\">must</strong> not already be backed by a memory object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBindBufferMemory-buffer-01030",
|
|
"text": " <code>buffer</code> <strong class=\"purple\">must</strong> not have been created with any sparse memory binding flags"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBindBufferMemory-memoryOffset-01031",
|
|
"text": " <code>memoryOffset</code> <strong class=\"purple\">must</strong> be less than the size of <code>memory</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBindBufferMemory-memory-01035",
|
|
"text": " <code>memory</code> <strong class=\"purple\">must</strong> have been allocated using one of the memory types allowed in the <code>memoryTypeBits</code> member of the <code>VkMemoryRequirements</code> structure returned from a call to <code>vkGetBufferMemoryRequirements</code> with <code>buffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBindBufferMemory-memoryOffset-01036",
|
|
"text": " <code>memoryOffset</code> <strong class=\"purple\">must</strong> be an integer multiple of the <code>alignment</code> member of the <code>VkMemoryRequirements</code> structure returned from a call to <code>vkGetBufferMemoryRequirements</code> with <code>buffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBindBufferMemory-size-01037",
|
|
"text": " The <code>size</code> member of the <code>VkMemoryRequirements</code> structure returned from a call to <code>vkGetBufferMemoryRequirements</code> with <code>buffer</code> <strong class=\"purple\">must</strong> be less than or equal to the size of <code>memory</code> minus <code>memoryOffset</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBindBufferMemory-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBindBufferMemory-buffer-parameter",
|
|
"text": " <code>buffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBuffer\">VkBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBindBufferMemory-memory-parameter",
|
|
"text": " <code>memory</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDeviceMemory\">VkDeviceMemory</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBindBufferMemory-buffer-parent",
|
|
"text": " <code>buffer</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBindBufferMemory-memory-parent",
|
|
"text": " <code>memory</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_dedicated_allocation)": [
|
|
{
|
|
"vuid": "VUID-vkBindBufferMemory-buffer-01444",
|
|
"text": " If <code>buffer</code> requires a dedicated allocation (as reported by <a href=\"#vkGetBufferMemoryRequirements2\">vkGetBufferMemoryRequirements2</a> in <a href=\"#VkMemoryDedicatedRequirements\">VkMemoryDedicatedRequirements</a>::<code>requiresDedicatedAllocation</code> for <code>buffer</code>), <code>memory</code> <strong class=\"purple\">must</strong> have been allocated with <a href=\"#VkMemoryDedicatedAllocateInfo\">VkMemoryDedicatedAllocateInfo</a>::<code>buffer</code> equal to <code>buffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBindBufferMemory-memory-01508",
|
|
"text": " If the <code>VkMemoryAllocateInfo</code> provided when <code>memory</code> was allocated included a <a href=\"#VkMemoryDedicatedAllocateInfo\">VkMemoryDedicatedAllocateInfo</a> structure in its <code>pNext</code> chain, and <a href=\"#VkMemoryDedicatedAllocateInfo\">VkMemoryDedicatedAllocateInfo</a>::<code>buffer</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, then <code>buffer</code> <strong class=\"purple\">must</strong> equal <a href=\"#VkMemoryDedicatedAllocateInfo\">VkMemoryDedicatedAllocateInfo</a>::<code>buffer</code>, and <code>memoryOffset</code> <strong class=\"purple\">must</strong> be zero"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-vkBindBufferMemory-None-01898",
|
|
"text": " If <code>buffer</code> was created with the <code>VK_BUFFER_CREATE_PROTECTED_BIT</code> bit set, the buffer <strong class=\"purple\">must</strong> be bound to a memory object allocated with a memory type that reports <code>VK_MEMORY_PROPERTY_PROTECTED_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBindBufferMemory-None-01899",
|
|
"text": " If <code>buffer</code> was created with the <code>VK_BUFFER_CREATE_PROTECTED_BIT</code> bit not set, the buffer <strong class=\"purple\">must</strong> not be bound to a memory object allocated with a memory type that reports <code>VK_MEMORY_PROPERTY_PROTECTED_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_NV_dedicated_allocation)": [
|
|
{
|
|
"vuid": "VUID-vkBindBufferMemory-buffer-01038",
|
|
"text": " If <code>buffer</code> was created with <a href=\"#VkDedicatedAllocationBufferCreateInfoNV\">VkDedicatedAllocationBufferCreateInfoNV</a>::<code>dedicatedAllocation</code> equal to <code>VK_TRUE</code>, <code>memory</code> <strong class=\"purple\">must</strong> have been allocated with <a href=\"#VkDedicatedAllocationMemoryAllocateInfoNV\">VkDedicatedAllocationMemoryAllocateInfoNV</a>::<code>buffer</code> equal to a buffer handle created with identical creation parameters to <code>buffer</code> and <code>memoryOffset</code> <strong class=\"purple\">must</strong> be zero"
|
|
}
|
|
],
|
|
"(VK_NV_dedicated_allocation)+!(VK_VERSION_1_1,VK_KHR_dedicated_allocation)": [
|
|
{
|
|
"vuid": "VUID-vkBindBufferMemory-buffer-01039",
|
|
"text": " If <code>buffer</code> was not created with <a href=\"#VkDedicatedAllocationBufferCreateInfoNV\">VkDedicatedAllocationBufferCreateInfoNV</a>::<code>dedicatedAllocation</code> equal to <code>VK_TRUE</code>, <code>memory</code> <strong class=\"purple\">must</strong> not have been allocated dedicated for a specific buffer or image"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_external_memory)": [
|
|
{
|
|
"vuid": "VUID-vkBindBufferMemory-memory-02726",
|
|
"text": " If the value of <a href=\"#VkExportMemoryAllocateInfo\">VkExportMemoryAllocateInfo</a>::<code>handleTypes</code> used to allocate <code>memory</code> is not <code>0</code>, it <strong class=\"purple\">must</strong> include at least one of the handles set in <a href=\"#VkExternalMemoryBufferCreateInfo\">VkExternalMemoryBufferCreateInfo</a>::<code>handleTypes</code> when <code>buffer</code> was created"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_external_memory)+!(VK_ANDROID_external_memory_android_hardware_buffer)": [
|
|
{
|
|
"vuid": "VUID-vkBindBufferMemory-memory-02727",
|
|
"text": " If <code>memory</code> was allocated by a memory import operation, the external handle type of the imported memory <strong class=\"purple\">must</strong> also have been set in <a href=\"#VkExternalMemoryBufferCreateInfo\">VkExternalMemoryBufferCreateInfo</a>::<code>handleTypes</code> when <code>buffer</code> was created"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_external_memory)+(VK_ANDROID_external_memory_android_hardware_buffer)": [
|
|
{
|
|
"vuid": "VUID-vkBindBufferMemory-memory-02985",
|
|
"text": " If <code>memory</code> was allocated by a memory import operation, that is not <a href=\"#VkImportAndroidHardwareBufferInfoANDROID\">VkImportAndroidHardwareBufferInfoANDROID</a> with a non-<code>NULL</code> <code>buffer</code> value, the external handle type of the imported memory <strong class=\"purple\">must</strong> also have been set in <a href=\"#VkExternalMemoryBufferCreateInfo\">VkExternalMemoryBufferCreateInfo</a>::<code>handleTypes</code> when <code>buffer</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBindBufferMemory-memory-02986",
|
|
"text": " If <code>memory</code> was allocated with the <a href=\"#VkImportAndroidHardwareBufferInfoANDROID\">VkImportAndroidHardwareBufferInfoANDROID</a> memory import operation with a non-<code>NULL</code> <code>buffer</code> value, <code>VK_EXTERNAL_MEMORY_HANDLE_TYPE_ANDROID_HARDWARE_BUFFER_BIT_ANDROID</code> <strong class=\"purple\">must</strong> also have been set in <a href=\"#VkExternalMemoryBufferCreateInfo\">VkExternalMemoryBufferCreateInfo</a>::<code>handleTypes</code> when <code>buffer</code> was created"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_buffer_device_address)": [
|
|
{
|
|
"vuid": "VUID-vkBindBufferMemory-bufferDeviceAddress-03339",
|
|
"text": " If the <a href=\"#VkPhysicalDeviceBufferDeviceAddressFeatures\">VkPhysicalDeviceBufferDeviceAddressFeatures</a>::<code>bufferDeviceAddress</code> feature is enabled and <code>buffer</code> was created with the <code>VK_BUFFER_USAGE_SHADER_DEVICE_ADDRESS_BIT</code> bit set, <code>memory</code> <strong class=\"purple\">must</strong> have been allocated with the <code>VK_MEMORY_ALLOCATE_DEVICE_ADDRESS_BIT</code> bit set"
|
|
}
|
|
],
|
|
"(VK_FUCHSIA_buffer_collection)": [
|
|
{
|
|
"vuid": "VUID-vkBindBufferMemory-buffer-06408",
|
|
"text": " If <code>buffer</code> was created with <a href=\"#VkBufferCollectionBufferCreateInfoFUCHSIA\">VkBufferCollectionBufferCreateInfoFUCHSIA</a> chained to <a href=\"#VkBufferCreateInfo\">VkBufferCreateInfo</a>::<code>pNext</code>, <code>memory</code> <strong class=\"purple\">must</strong> be allocated with a <a href=\"#VkImportMemoryBufferCollectionFUCHSIA\">VkImportMemoryBufferCollectionFUCHSIA</a> chained to <a href=\"#VkMemoryAllocateInfo\">VkMemoryAllocateInfo</a>::<code>pNext</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkBindBufferMemory2": {
|
|
"(VK_VERSION_1_1,VK_KHR_bind_memory2)": [
|
|
{
|
|
"vuid": "VUID-vkBindBufferMemory2-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBindBufferMemory2-pBindInfos-parameter",
|
|
"text": " <code>pBindInfos</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>bindInfoCount</code> valid <a href=\"#VkBindBufferMemoryInfo\">VkBindBufferMemoryInfo</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBindBufferMemory2-bindInfoCount-arraylength",
|
|
"text": " <code>bindInfoCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkBindBufferMemoryInfo": {
|
|
"(VK_VERSION_1_1,VK_KHR_bind_memory2)": [
|
|
{
|
|
"vuid": "VUID-VkBindBufferMemoryInfo-buffer-01029",
|
|
"text": " <code>buffer</code> <strong class=\"purple\">must</strong> not already be backed by a memory object"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindBufferMemoryInfo-buffer-01030",
|
|
"text": " <code>buffer</code> <strong class=\"purple\">must</strong> not have been created with any sparse memory binding flags"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindBufferMemoryInfo-memoryOffset-01031",
|
|
"text": " <code>memoryOffset</code> <strong class=\"purple\">must</strong> be less than the size of <code>memory</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindBufferMemoryInfo-memory-01035",
|
|
"text": " <code>memory</code> <strong class=\"purple\">must</strong> have been allocated using one of the memory types allowed in the <code>memoryTypeBits</code> member of the <code>VkMemoryRequirements</code> structure returned from a call to <code>vkGetBufferMemoryRequirements</code> with <code>buffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindBufferMemoryInfo-memoryOffset-01036",
|
|
"text": " <code>memoryOffset</code> <strong class=\"purple\">must</strong> be an integer multiple of the <code>alignment</code> member of the <code>VkMemoryRequirements</code> structure returned from a call to <code>vkGetBufferMemoryRequirements</code> with <code>buffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindBufferMemoryInfo-size-01037",
|
|
"text": " The <code>size</code> member of the <code>VkMemoryRequirements</code> structure returned from a call to <code>vkGetBufferMemoryRequirements</code> with <code>buffer</code> <strong class=\"purple\">must</strong> be less than or equal to the size of <code>memory</code> minus <code>memoryOffset</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindBufferMemoryInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_BIND_BUFFER_MEMORY_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindBufferMemoryInfo-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkBindBufferMemoryDeviceGroupInfo\">VkBindBufferMemoryDeviceGroupInfo</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindBufferMemoryInfo-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindBufferMemoryInfo-buffer-parameter",
|
|
"text": " <code>buffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBuffer\">VkBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindBufferMemoryInfo-memory-parameter",
|
|
"text": " <code>memory</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDeviceMemory\">VkDeviceMemory</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindBufferMemoryInfo-commonparent",
|
|
"text": " Both of <code>buffer</code>, and <code>memory</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_bind_memory2)+(VK_VERSION_1_1,VK_KHR_dedicated_allocation)": [
|
|
{
|
|
"vuid": "VUID-VkBindBufferMemoryInfo-buffer-01444",
|
|
"text": " If <code>buffer</code> requires a dedicated allocation (as reported by <a href=\"#vkGetBufferMemoryRequirements2\">vkGetBufferMemoryRequirements2</a> in <a href=\"#VkMemoryDedicatedRequirements\">VkMemoryDedicatedRequirements</a>::<code>requiresDedicatedAllocation</code> for <code>buffer</code>), <code>memory</code> <strong class=\"purple\">must</strong> have been allocated with <a href=\"#VkMemoryDedicatedAllocateInfo\">VkMemoryDedicatedAllocateInfo</a>::<code>buffer</code> equal to <code>buffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindBufferMemoryInfo-memory-01508",
|
|
"text": " If the <code>VkMemoryAllocateInfo</code> provided when <code>memory</code> was allocated included a <a href=\"#VkMemoryDedicatedAllocateInfo\">VkMemoryDedicatedAllocateInfo</a> structure in its <code>pNext</code> chain, and <a href=\"#VkMemoryDedicatedAllocateInfo\">VkMemoryDedicatedAllocateInfo</a>::<code>buffer</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, then <code>buffer</code> <strong class=\"purple\">must</strong> equal <a href=\"#VkMemoryDedicatedAllocateInfo\">VkMemoryDedicatedAllocateInfo</a>::<code>buffer</code>, and <code>memoryOffset</code> <strong class=\"purple\">must</strong> be zero"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_bind_memory2)+(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-VkBindBufferMemoryInfo-None-01898",
|
|
"text": " If <code>buffer</code> was created with the <code>VK_BUFFER_CREATE_PROTECTED_BIT</code> bit set, the buffer <strong class=\"purple\">must</strong> be bound to a memory object allocated with a memory type that reports <code>VK_MEMORY_PROPERTY_PROTECTED_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindBufferMemoryInfo-None-01899",
|
|
"text": " If <code>buffer</code> was created with the <code>VK_BUFFER_CREATE_PROTECTED_BIT</code> bit not set, the buffer <strong class=\"purple\">must</strong> not be bound to a memory object allocated with a memory type that reports <code>VK_MEMORY_PROPERTY_PROTECTED_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_bind_memory2)+(VK_NV_dedicated_allocation)": [
|
|
{
|
|
"vuid": "VUID-VkBindBufferMemoryInfo-buffer-01038",
|
|
"text": " If <code>buffer</code> was created with <a href=\"#VkDedicatedAllocationBufferCreateInfoNV\">VkDedicatedAllocationBufferCreateInfoNV</a>::<code>dedicatedAllocation</code> equal to <code>VK_TRUE</code>, <code>memory</code> <strong class=\"purple\">must</strong> have been allocated with <a href=\"#VkDedicatedAllocationMemoryAllocateInfoNV\">VkDedicatedAllocationMemoryAllocateInfoNV</a>::<code>buffer</code> equal to a buffer handle created with identical creation parameters to <code>buffer</code> and <code>memoryOffset</code> <strong class=\"purple\">must</strong> be zero"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_bind_memory2)+(VK_NV_dedicated_allocation)+!(VK_VERSION_1_1,VK_KHR_dedicated_allocation)": [
|
|
{
|
|
"vuid": "VUID-VkBindBufferMemoryInfo-buffer-01039",
|
|
"text": " If <code>buffer</code> was not created with <a href=\"#VkDedicatedAllocationBufferCreateInfoNV\">VkDedicatedAllocationBufferCreateInfoNV</a>::<code>dedicatedAllocation</code> equal to <code>VK_TRUE</code>, <code>memory</code> <strong class=\"purple\">must</strong> not have been allocated dedicated for a specific buffer or image"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_bind_memory2)+(VK_VERSION_1_1,VK_KHR_external_memory)": [
|
|
{
|
|
"vuid": "VUID-VkBindBufferMemoryInfo-memory-02726",
|
|
"text": " If the value of <a href=\"#VkExportMemoryAllocateInfo\">VkExportMemoryAllocateInfo</a>::<code>handleTypes</code> used to allocate <code>memory</code> is not <code>0</code>, it <strong class=\"purple\">must</strong> include at least one of the handles set in <a href=\"#VkExternalMemoryBufferCreateInfo\">VkExternalMemoryBufferCreateInfo</a>::<code>handleTypes</code> when <code>buffer</code> was created"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_bind_memory2)+(VK_VERSION_1_1,VK_KHR_external_memory)+!(VK_ANDROID_external_memory_android_hardware_buffer)": [
|
|
{
|
|
"vuid": "VUID-VkBindBufferMemoryInfo-memory-02727",
|
|
"text": " If <code>memory</code> was allocated by a memory import operation, the external handle type of the imported memory <strong class=\"purple\">must</strong> also have been set in <a href=\"#VkExternalMemoryBufferCreateInfo\">VkExternalMemoryBufferCreateInfo</a>::<code>handleTypes</code> when <code>buffer</code> was created"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_bind_memory2)+(VK_VERSION_1_1,VK_KHR_external_memory)+(VK_ANDROID_external_memory_android_hardware_buffer)": [
|
|
{
|
|
"vuid": "VUID-VkBindBufferMemoryInfo-memory-02985",
|
|
"text": " If <code>memory</code> was allocated by a memory import operation, that is not <a href=\"#VkImportAndroidHardwareBufferInfoANDROID\">VkImportAndroidHardwareBufferInfoANDROID</a> with a non-<code>NULL</code> <code>buffer</code> value, the external handle type of the imported memory <strong class=\"purple\">must</strong> also have been set in <a href=\"#VkExternalMemoryBufferCreateInfo\">VkExternalMemoryBufferCreateInfo</a>::<code>handleTypes</code> when <code>buffer</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindBufferMemoryInfo-memory-02986",
|
|
"text": " If <code>memory</code> was allocated with the <a href=\"#VkImportAndroidHardwareBufferInfoANDROID\">VkImportAndroidHardwareBufferInfoANDROID</a> memory import operation with a non-<code>NULL</code> <code>buffer</code> value, <code>VK_EXTERNAL_MEMORY_HANDLE_TYPE_ANDROID_HARDWARE_BUFFER_BIT_ANDROID</code> <strong class=\"purple\">must</strong> also have been set in <a href=\"#VkExternalMemoryBufferCreateInfo\">VkExternalMemoryBufferCreateInfo</a>::<code>handleTypes</code> when <code>buffer</code> was created"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_bind_memory2)+(VK_VERSION_1_2,VK_KHR_buffer_device_address)": [
|
|
{
|
|
"vuid": "VUID-VkBindBufferMemoryInfo-bufferDeviceAddress-03339",
|
|
"text": " If the <a href=\"#VkPhysicalDeviceBufferDeviceAddressFeatures\">VkPhysicalDeviceBufferDeviceAddressFeatures</a>::<code>bufferDeviceAddress</code> feature is enabled and <code>buffer</code> was created with the <code>VK_BUFFER_USAGE_SHADER_DEVICE_ADDRESS_BIT</code> bit set, <code>memory</code> <strong class=\"purple\">must</strong> have been allocated with the <code>VK_MEMORY_ALLOCATE_DEVICE_ADDRESS_BIT</code> bit set"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_bind_memory2)+(VK_FUCHSIA_buffer_collection)": [
|
|
{
|
|
"vuid": "VUID-VkBindBufferMemoryInfo-buffer-06408",
|
|
"text": " If <code>buffer</code> was created with <a href=\"#VkBufferCollectionBufferCreateInfoFUCHSIA\">VkBufferCollectionBufferCreateInfoFUCHSIA</a> chained to <a href=\"#VkBufferCreateInfo\">VkBufferCreateInfo</a>::<code>pNext</code>, <code>memory</code> <strong class=\"purple\">must</strong> be allocated with a <a href=\"#VkImportMemoryBufferCollectionFUCHSIA\">VkImportMemoryBufferCollectionFUCHSIA</a> chained to <a href=\"#VkMemoryAllocateInfo\">VkMemoryAllocateInfo</a>::<code>pNext</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_bind_memory2)+(VK_VERSION_1_1,VK_KHR_device_group)": [
|
|
{
|
|
"vuid": "VUID-VkBindBufferMemoryInfo-pNext-01605",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkBindBufferMemoryDeviceGroupInfo\">VkBindBufferMemoryDeviceGroupInfo</a> structure, all instances of <code>memory</code> specified by <a href=\"#VkBindBufferMemoryDeviceGroupInfo\">VkBindBufferMemoryDeviceGroupInfo</a>::<code>pDeviceIndices</code> <strong class=\"purple\">must</strong> have been allocated"
|
|
}
|
|
]
|
|
},
|
|
"VkBindBufferMemoryDeviceGroupInfo": {
|
|
"(VK_VERSION_1_1,VK_KHR_bind_memory2)+(VK_VERSION_1_1,VK_KHR_device_group)": [
|
|
{
|
|
"vuid": "VUID-VkBindBufferMemoryDeviceGroupInfo-deviceIndexCount-01606",
|
|
"text": " <code>deviceIndexCount</code> <strong class=\"purple\">must</strong> either be zero or equal to the number of physical devices in the logical device"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindBufferMemoryDeviceGroupInfo-pDeviceIndices-01607",
|
|
"text": " All elements of <code>pDeviceIndices</code> <strong class=\"purple\">must</strong> be valid device indices"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindBufferMemoryDeviceGroupInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_BIND_BUFFER_MEMORY_DEVICE_GROUP_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindBufferMemoryDeviceGroupInfo-pDeviceIndices-parameter",
|
|
"text": " If <code>deviceIndexCount</code> is not <code>0</code>, <code>pDeviceIndices</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>deviceIndexCount</code> <code>uint32_t</code> values"
|
|
}
|
|
]
|
|
},
|
|
"vkBindImageMemory": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkBindImageMemory-image-01044",
|
|
"text": " <code>image</code> <strong class=\"purple\">must</strong> not already be backed by a memory object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBindImageMemory-image-01045",
|
|
"text": " <code>image</code> <strong class=\"purple\">must</strong> not have been created with any sparse memory binding flags"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBindImageMemory-memoryOffset-01046",
|
|
"text": " <code>memoryOffset</code> <strong class=\"purple\">must</strong> be less than the size of <code>memory</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBindImageMemory-memory-01047",
|
|
"text": " <code>memory</code> <strong class=\"purple\">must</strong> have been allocated using one of the memory types allowed in the <code>memoryTypeBits</code> member of the <code>VkMemoryRequirements</code> structure returned from a call to <a href=\"#vkGetImageMemoryRequirements\">vkGetImageMemoryRequirements</a> with <code>image</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBindImageMemory-memoryOffset-01048",
|
|
"text": " <code>memoryOffset</code> <strong class=\"purple\">must</strong> be an integer multiple of the <code>alignment</code> member of the <code>VkMemoryRequirements</code> structure returned from a call to <a href=\"#vkGetImageMemoryRequirements\">vkGetImageMemoryRequirements</a> with <code>image</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBindImageMemory-size-01049",
|
|
"text": " The difference of the size of <code>memory</code> and <code>memoryOffset</code> <strong class=\"purple\">must</strong> be greater than or equal to the <code>size</code> member of the <a href=\"#VkMemoryRequirements\">VkMemoryRequirements</a> structure returned from a call to <a href=\"#vkGetImageMemoryRequirements\">vkGetImageMemoryRequirements</a> with the same <code>image</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBindImageMemory-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBindImageMemory-image-parameter",
|
|
"text": " <code>image</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImage\">VkImage</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBindImageMemory-memory-parameter",
|
|
"text": " <code>memory</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDeviceMemory\">VkDeviceMemory</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBindImageMemory-image-parent",
|
|
"text": " <code>image</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBindImageMemory-memory-parent",
|
|
"text": " <code>memory</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_dedicated_allocation)": [
|
|
{
|
|
"vuid": "VUID-vkBindImageMemory-image-01445",
|
|
"text": " If <code>image</code> requires a dedicated allocation (as reported by <a href=\"#vkGetImageMemoryRequirements2\">vkGetImageMemoryRequirements2</a> in <a href=\"#VkMemoryDedicatedRequirements\">VkMemoryDedicatedRequirements</a>::<code>requiresDedicatedAllocation</code> for <code>image</code>), <code>memory</code> <strong class=\"purple\">must</strong> have been created with <a href=\"#VkMemoryDedicatedAllocateInfo\">VkMemoryDedicatedAllocateInfo</a>::<code>image</code> equal to <code>image</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_dedicated_allocation)+!(VK_NV_dedicated_allocation_image_aliasing)": [
|
|
{
|
|
"vuid": "VUID-vkBindImageMemory-memory-01509",
|
|
"text": " If the <code>VkMemoryAllocateInfo</code> provided when <code>memory</code> was allocated included a <a href=\"#VkMemoryDedicatedAllocateInfo\">VkMemoryDedicatedAllocateInfo</a> structure in its <code>pNext</code> chain, and <a href=\"#VkMemoryDedicatedAllocateInfo\">VkMemoryDedicatedAllocateInfo</a>::<code>image</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, then <code>image</code> <strong class=\"purple\">must</strong> equal <a href=\"#VkMemoryDedicatedAllocateInfo\">VkMemoryDedicatedAllocateInfo</a>::<code>image</code> and <code>memoryOffset</code> <strong class=\"purple\">must</strong> be zero"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_dedicated_allocation)+(VK_NV_dedicated_allocation_image_aliasing)": [
|
|
{
|
|
"vuid": "VUID-vkBindImageMemory-memory-02628",
|
|
"text": " If the <a href=\"#features-dedicatedAllocationImageAliasing\"><code>dedicatedAllocationImageAliasing</code></a> feature is not enabled, and the <code>VkMemoryAllocateInfo</code> provided when <code>memory</code> was allocated included a <a href=\"#VkMemoryDedicatedAllocateInfo\">VkMemoryDedicatedAllocateInfo</a> structure in its <code>pNext</code> chain, and <a href=\"#VkMemoryDedicatedAllocateInfo\">VkMemoryDedicatedAllocateInfo</a>::<code>image</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, then <code>image</code> <strong class=\"purple\">must</strong> equal <a href=\"#VkMemoryDedicatedAllocateInfo\">VkMemoryDedicatedAllocateInfo</a>::<code>image</code> and <code>memoryOffset</code> <strong class=\"purple\">must</strong> be zero"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBindImageMemory-memory-02629",
|
|
"text": " If the <a href=\"#features-dedicatedAllocationImageAliasing\"><code>dedicatedAllocationImageAliasing</code></a> feature is enabled, and the <code>VkMemoryAllocateInfo</code> provided when <code>memory</code> was allocated included a <a href=\"#VkMemoryDedicatedAllocateInfo\">VkMemoryDedicatedAllocateInfo</a> structure in its <code>pNext</code> chain, and <a href=\"#VkMemoryDedicatedAllocateInfo\">VkMemoryDedicatedAllocateInfo</a>::<code>image</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, then <code>memoryOffset</code> <strong class=\"purple\">must</strong> be zero, and <code>image</code> <strong class=\"purple\">must</strong> be either equal to <a href=\"#VkMemoryDedicatedAllocateInfo\">VkMemoryDedicatedAllocateInfo</a>::<code>image</code> or an image that was created using the same parameters in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a>, with the exception that <code>extent</code> and <code>arrayLayers</code> <strong class=\"purple\">may</strong> differ subject to the following restrictions: every dimension in the <code>extent</code> parameter of the image being bound <strong class=\"purple\">must</strong> be equal to or smaller than the original image for which the allocation was created; and the <code>arrayLayers</code> parameter of the image being bound <strong class=\"purple\">must</strong> be equal to or smaller than the original image for which the allocation was created"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-vkBindImageMemory-None-01901",
|
|
"text": " If image was created with the <code>VK_IMAGE_CREATE_PROTECTED_BIT</code> bit set, the image <strong class=\"purple\">must</strong> be bound to a memory object allocated with a memory type that reports <code>VK_MEMORY_PROPERTY_PROTECTED_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBindImageMemory-None-01902",
|
|
"text": " If image was created with the <code>VK_IMAGE_CREATE_PROTECTED_BIT</code> bit not set, the image <strong class=\"purple\">must</strong> not be bound to a memory object created with a memory type that reports <code>VK_MEMORY_PROPERTY_PROTECTED_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_NV_dedicated_allocation)": [
|
|
{
|
|
"vuid": "VUID-vkBindImageMemory-image-01050",
|
|
"text": " If <code>image</code> was created with <a href=\"#VkDedicatedAllocationImageCreateInfoNV\">VkDedicatedAllocationImageCreateInfoNV</a>::<code>dedicatedAllocation</code> equal to <code>VK_TRUE</code>, <code>memory</code> <strong class=\"purple\">must</strong> have been created with <a href=\"#VkDedicatedAllocationMemoryAllocateInfoNV\">VkDedicatedAllocationMemoryAllocateInfoNV</a>::<code>image</code> equal to an image handle created with identical creation parameters to <code>image</code> and <code>memoryOffset</code> <strong class=\"purple\">must</strong> be zero"
|
|
}
|
|
],
|
|
"(VK_NV_dedicated_allocation)+!(VK_VERSION_1_1,VK_KHR_dedicated_allocation)": [
|
|
{
|
|
"vuid": "VUID-vkBindImageMemory-image-01051",
|
|
"text": " If <code>image</code> was not created with <a href=\"#VkDedicatedAllocationImageCreateInfoNV\">VkDedicatedAllocationImageCreateInfoNV</a>::<code>dedicatedAllocation</code> equal to <code>VK_TRUE</code>, <code>memory</code> <strong class=\"purple\">must</strong> not have been allocated dedicated for a specific buffer or image"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_external_memory)": [
|
|
{
|
|
"vuid": "VUID-vkBindImageMemory-memory-02728",
|
|
"text": " If the value of <a href=\"#VkExportMemoryAllocateInfo\">VkExportMemoryAllocateInfo</a>::<code>handleTypes</code> used to allocate <code>memory</code> is not <code>0</code>, it <strong class=\"purple\">must</strong> include at least one of the handles set in <a href=\"#VkExternalMemoryImageCreateInfo\">VkExternalMemoryImageCreateInfo</a>::<code>handleTypes</code> when <code>image</code> was created"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_external_memory)+!(VK_ANDROID_external_memory_android_hardware_buffer)": [
|
|
{
|
|
"vuid": "VUID-vkBindImageMemory-memory-02729",
|
|
"text": " If <code>memory</code> was created by a memory import operation, the external handle type of the imported memory <strong class=\"purple\">must</strong> also have been set in <a href=\"#VkExternalMemoryImageCreateInfo\">VkExternalMemoryImageCreateInfo</a>::<code>handleTypes</code> when <code>image</code> was created"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_external_memory)+(VK_ANDROID_external_memory_android_hardware_buffer)": [
|
|
{
|
|
"vuid": "VUID-vkBindImageMemory-memory-02989",
|
|
"text": " If <code>memory</code> was created by a memory import operation, that is not <a href=\"#VkImportAndroidHardwareBufferInfoANDROID\">VkImportAndroidHardwareBufferInfoANDROID</a> with a non-<code>NULL</code> <code>buffer</code> value, the external handle type of the imported memory <strong class=\"purple\">must</strong> also have been set in <a href=\"#VkExternalMemoryImageCreateInfo\">VkExternalMemoryImageCreateInfo</a>::<code>handleTypes</code> when <code>image</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBindImageMemory-memory-02990",
|
|
"text": " If <code>memory</code> was created with the <a href=\"#VkImportAndroidHardwareBufferInfoANDROID\">VkImportAndroidHardwareBufferInfoANDROID</a> memory import operation with a non-<code>NULL</code> <code>buffer</code> value, <code>VK_EXTERNAL_MEMORY_HANDLE_TYPE_ANDROID_HARDWARE_BUFFER_BIT_ANDROID</code> <strong class=\"purple\">must</strong> also have been set in <a href=\"#VkExternalMemoryImageCreateInfo\">VkExternalMemoryImageCreateInfo</a>::<code>handleTypes</code> when <code>image</code> was created"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-vkBindImageMemory-image-01608",
|
|
"text": " <code>image</code> <strong class=\"purple\">must</strong> not have been created with the <code>VK_IMAGE_CREATE_DISJOINT_BIT</code> set"
|
|
}
|
|
],
|
|
"(VK_FUCHSIA_buffer_collection)": [
|
|
{
|
|
"vuid": "VUID-vkBindImageMemory-image-06392",
|
|
"text": " If <code>image</code> was created with <a href=\"#VkBufferCollectionImageCreateInfoFUCHSIA\">VkBufferCollectionImageCreateInfoFUCHSIA</a> chained to <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a>::<code>pNext</code>, <code>memory</code> <strong class=\"purple\">must</strong> be allocated with a <a href=\"#VkImportMemoryBufferCollectionFUCHSIA\">VkImportMemoryBufferCollectionFUCHSIA</a> chained to <a href=\"#VkMemoryAllocateInfo\">VkMemoryAllocateInfo</a>::<code>pNext</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkBindImageMemory2": {
|
|
"(VK_VERSION_1_1,VK_KHR_bind_memory2)+(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-vkBindImageMemory2-pBindInfos-02858",
|
|
"text": " If any <a href=\"#VkBindImageMemoryInfo\">VkBindImageMemoryInfo</a>::<code>image</code> was created with <code>VK_IMAGE_CREATE_DISJOINT_BIT</code> then all planes of <a href=\"#VkBindImageMemoryInfo\">VkBindImageMemoryInfo</a>::<code>image</code> <strong class=\"purple\">must</strong> be bound individually in separate <code>pBindInfos</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBindImageMemory2-pBindInfos-04006",
|
|
"text": " <code>pBindInfos</code> <strong class=\"purple\">must</strong> not refer to the same image subresource more than once"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_bind_memory2)": [
|
|
{
|
|
"vuid": "VUID-vkBindImageMemory2-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBindImageMemory2-pBindInfos-parameter",
|
|
"text": " <code>pBindInfos</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>bindInfoCount</code> valid <a href=\"#VkBindImageMemoryInfo\">VkBindImageMemoryInfo</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBindImageMemory2-bindInfoCount-arraylength",
|
|
"text": " <code>bindInfoCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkBindImageMemoryInfo": {
|
|
"(VK_VERSION_1_1,VK_KHR_bind_memory2)": [
|
|
{
|
|
"vuid": "VUID-VkBindImageMemoryInfo-image-01044",
|
|
"text": " <code>image</code> <strong class=\"purple\">must</strong> not already be backed by a memory object"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindImageMemoryInfo-image-01045",
|
|
"text": " <code>image</code> <strong class=\"purple\">must</strong> not have been created with any sparse memory binding flags"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindImageMemoryInfo-memoryOffset-01046",
|
|
"text": " <code>memoryOffset</code> <strong class=\"purple\">must</strong> be less than the size of <code>memory</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindImageMemoryInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_BIND_IMAGE_MEMORY_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindImageMemoryInfo-pNext-pNext",
|
|
"text": " Each <code>pNext</code> member of any structure (including this one) in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be either <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkBindImageMemoryDeviceGroupInfo\">VkBindImageMemoryDeviceGroupInfo</a>, <a href=\"#VkBindImageMemorySwapchainInfoKHR\">VkBindImageMemorySwapchainInfoKHR</a>, or <a href=\"#VkBindImagePlaneMemoryInfo\">VkBindImagePlaneMemoryInfo</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindImageMemoryInfo-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindImageMemoryInfo-image-parameter",
|
|
"text": " <code>image</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImage\">VkImage</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindImageMemoryInfo-commonparent",
|
|
"text": " Both of <code>image</code>, and <code>memory</code> that are valid handles of non-ignored parameters <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_bind_memory2)+(VK_VERSION_1_1,VK_KHR_dedicated_allocation)": [
|
|
{
|
|
"vuid": "VUID-VkBindImageMemoryInfo-image-01445",
|
|
"text": " If <code>image</code> requires a dedicated allocation (as reported by <a href=\"#vkGetImageMemoryRequirements2\">vkGetImageMemoryRequirements2</a> in <a href=\"#VkMemoryDedicatedRequirements\">VkMemoryDedicatedRequirements</a>::<code>requiresDedicatedAllocation</code> for <code>image</code>), <code>memory</code> <strong class=\"purple\">must</strong> have been created with <a href=\"#VkMemoryDedicatedAllocateInfo\">VkMemoryDedicatedAllocateInfo</a>::<code>image</code> equal to <code>image</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_bind_memory2)+(VK_VERSION_1_1,VK_KHR_dedicated_allocation)+!(VK_NV_dedicated_allocation_image_aliasing)": [
|
|
{
|
|
"vuid": "VUID-VkBindImageMemoryInfo-memory-01509",
|
|
"text": " If the <code>VkMemoryAllocateInfo</code> provided when <code>memory</code> was allocated included a <a href=\"#VkMemoryDedicatedAllocateInfo\">VkMemoryDedicatedAllocateInfo</a> structure in its <code>pNext</code> chain, and <a href=\"#VkMemoryDedicatedAllocateInfo\">VkMemoryDedicatedAllocateInfo</a>::<code>image</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, then <code>image</code> <strong class=\"purple\">must</strong> equal <a href=\"#VkMemoryDedicatedAllocateInfo\">VkMemoryDedicatedAllocateInfo</a>::<code>image</code> and <code>memoryOffset</code> <strong class=\"purple\">must</strong> be zero"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_bind_memory2)+(VK_VERSION_1_1,VK_KHR_dedicated_allocation)+(VK_NV_dedicated_allocation_image_aliasing)": [
|
|
{
|
|
"vuid": "VUID-VkBindImageMemoryInfo-memory-02628",
|
|
"text": " If the <a href=\"#features-dedicatedAllocationImageAliasing\"><code>dedicatedAllocationImageAliasing</code></a> feature is not enabled, and the <code>VkMemoryAllocateInfo</code> provided when <code>memory</code> was allocated included a <a href=\"#VkMemoryDedicatedAllocateInfo\">VkMemoryDedicatedAllocateInfo</a> structure in its <code>pNext</code> chain, and <a href=\"#VkMemoryDedicatedAllocateInfo\">VkMemoryDedicatedAllocateInfo</a>::<code>image</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, then <code>image</code> <strong class=\"purple\">must</strong> equal <a href=\"#VkMemoryDedicatedAllocateInfo\">VkMemoryDedicatedAllocateInfo</a>::<code>image</code> and <code>memoryOffset</code> <strong class=\"purple\">must</strong> be zero"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindImageMemoryInfo-memory-02629",
|
|
"text": " If the <a href=\"#features-dedicatedAllocationImageAliasing\"><code>dedicatedAllocationImageAliasing</code></a> feature is enabled, and the <code>VkMemoryAllocateInfo</code> provided when <code>memory</code> was allocated included a <a href=\"#VkMemoryDedicatedAllocateInfo\">VkMemoryDedicatedAllocateInfo</a> structure in its <code>pNext</code> chain, and <a href=\"#VkMemoryDedicatedAllocateInfo\">VkMemoryDedicatedAllocateInfo</a>::<code>image</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, then <code>memoryOffset</code> <strong class=\"purple\">must</strong> be zero, and <code>image</code> <strong class=\"purple\">must</strong> be either equal to <a href=\"#VkMemoryDedicatedAllocateInfo\">VkMemoryDedicatedAllocateInfo</a>::<code>image</code> or an image that was created using the same parameters in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a>, with the exception that <code>extent</code> and <code>arrayLayers</code> <strong class=\"purple\">may</strong> differ subject to the following restrictions: every dimension in the <code>extent</code> parameter of the image being bound <strong class=\"purple\">must</strong> be equal to or smaller than the original image for which the allocation was created; and the <code>arrayLayers</code> parameter of the image being bound <strong class=\"purple\">must</strong> be equal to or smaller than the original image for which the allocation was created"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_bind_memory2)+(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-VkBindImageMemoryInfo-None-01901",
|
|
"text": " If image was created with the <code>VK_IMAGE_CREATE_PROTECTED_BIT</code> bit set, the image <strong class=\"purple\">must</strong> be bound to a memory object allocated with a memory type that reports <code>VK_MEMORY_PROPERTY_PROTECTED_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindImageMemoryInfo-None-01902",
|
|
"text": " If image was created with the <code>VK_IMAGE_CREATE_PROTECTED_BIT</code> bit not set, the image <strong class=\"purple\">must</strong> not be bound to a memory object created with a memory type that reports <code>VK_MEMORY_PROPERTY_PROTECTED_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_bind_memory2)+(VK_NV_dedicated_allocation)": [
|
|
{
|
|
"vuid": "VUID-VkBindImageMemoryInfo-image-01050",
|
|
"text": " If <code>image</code> was created with <a href=\"#VkDedicatedAllocationImageCreateInfoNV\">VkDedicatedAllocationImageCreateInfoNV</a>::<code>dedicatedAllocation</code> equal to <code>VK_TRUE</code>, <code>memory</code> <strong class=\"purple\">must</strong> have been created with <a href=\"#VkDedicatedAllocationMemoryAllocateInfoNV\">VkDedicatedAllocationMemoryAllocateInfoNV</a>::<code>image</code> equal to an image handle created with identical creation parameters to <code>image</code> and <code>memoryOffset</code> <strong class=\"purple\">must</strong> be zero"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_bind_memory2)+(VK_NV_dedicated_allocation)+!(VK_VERSION_1_1,VK_KHR_dedicated_allocation)": [
|
|
{
|
|
"vuid": "VUID-VkBindImageMemoryInfo-image-01051",
|
|
"text": " If <code>image</code> was not created with <a href=\"#VkDedicatedAllocationImageCreateInfoNV\">VkDedicatedAllocationImageCreateInfoNV</a>::<code>dedicatedAllocation</code> equal to <code>VK_TRUE</code>, <code>memory</code> <strong class=\"purple\">must</strong> not have been allocated dedicated for a specific buffer or image"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_bind_memory2)+(VK_VERSION_1_1,VK_KHR_external_memory)": [
|
|
{
|
|
"vuid": "VUID-VkBindImageMemoryInfo-memory-02728",
|
|
"text": " If the value of <a href=\"#VkExportMemoryAllocateInfo\">VkExportMemoryAllocateInfo</a>::<code>handleTypes</code> used to allocate <code>memory</code> is not <code>0</code>, it <strong class=\"purple\">must</strong> include at least one of the handles set in <a href=\"#VkExternalMemoryImageCreateInfo\">VkExternalMemoryImageCreateInfo</a>::<code>handleTypes</code> when <code>image</code> was created"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_bind_memory2)+(VK_VERSION_1_1,VK_KHR_external_memory)+!(VK_ANDROID_external_memory_android_hardware_buffer)": [
|
|
{
|
|
"vuid": "VUID-VkBindImageMemoryInfo-memory-02729",
|
|
"text": " If <code>memory</code> was created by a memory import operation, the external handle type of the imported memory <strong class=\"purple\">must</strong> also have been set in <a href=\"#VkExternalMemoryImageCreateInfo\">VkExternalMemoryImageCreateInfo</a>::<code>handleTypes</code> when <code>image</code> was created"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_bind_memory2)+(VK_VERSION_1_1,VK_KHR_external_memory)+(VK_ANDROID_external_memory_android_hardware_buffer)": [
|
|
{
|
|
"vuid": "VUID-VkBindImageMemoryInfo-memory-02989",
|
|
"text": " If <code>memory</code> was created by a memory import operation, that is not <a href=\"#VkImportAndroidHardwareBufferInfoANDROID\">VkImportAndroidHardwareBufferInfoANDROID</a> with a non-<code>NULL</code> <code>buffer</code> value, the external handle type of the imported memory <strong class=\"purple\">must</strong> also have been set in <a href=\"#VkExternalMemoryImageCreateInfo\">VkExternalMemoryImageCreateInfo</a>::<code>handleTypes</code> when <code>image</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindImageMemoryInfo-memory-02990",
|
|
"text": " If <code>memory</code> was created with the <a href=\"#VkImportAndroidHardwareBufferInfoANDROID\">VkImportAndroidHardwareBufferInfoANDROID</a> memory import operation with a non-<code>NULL</code> <code>buffer</code> value, <code>VK_EXTERNAL_MEMORY_HANDLE_TYPE_ANDROID_HARDWARE_BUFFER_BIT_ANDROID</code> <strong class=\"purple\">must</strong> also have been set in <a href=\"#VkExternalMemoryImageCreateInfo\">VkExternalMemoryImageCreateInfo</a>::<code>handleTypes</code> when <code>image</code> was created"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_bind_memory2)+!(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-VkBindImageMemoryInfo-memory-01612",
|
|
"text": " <code>memory</code> <strong class=\"purple\">must</strong> have been allocated using one of the memory types allowed in the <code>memoryTypeBits</code> member of the <a href=\"#VkMemoryRequirements\">VkMemoryRequirements</a> structure returned from a call to <a href=\"#vkGetImageMemoryRequirements\">vkGetImageMemoryRequirements</a> with <code>image</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindImageMemoryInfo-memoryOffset-01613",
|
|
"text": " <code>memoryOffset</code> <strong class=\"purple\">must</strong> be an integer multiple of the <code>alignment</code> member of the <a href=\"#VkMemoryRequirements\">VkMemoryRequirements</a> structure returned from a call to <a href=\"#vkGetImageMemoryRequirements\">vkGetImageMemoryRequirements</a> with <code>image</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindImageMemoryInfo-memory-01614",
|
|
"text": " The difference of the size of <code>memory</code> and <code>memoryOffset</code> <strong class=\"purple\">must</strong> be greater than or equal to the <code>size</code> member of the <a href=\"#VkMemoryRequirements\">VkMemoryRequirements</a> structure returned from a call to <a href=\"#vkGetImageMemoryRequirements\">vkGetImageMemoryRequirements</a> with the same <code>image</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_bind_memory2)+(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-VkBindImageMemoryInfo-pNext-01615",
|
|
"text": " If the <code>pNext</code> chain does not include a <a href=\"#VkBindImagePlaneMemoryInfo\">VkBindImagePlaneMemoryInfo</a> structure, <code>memory</code> <strong class=\"purple\">must</strong> have been allocated using one of the memory types allowed in the <code>memoryTypeBits</code> member of the <a href=\"#VkMemoryRequirements\">VkMemoryRequirements</a> structure returned from a call to <a href=\"#vkGetImageMemoryRequirements2\">vkGetImageMemoryRequirements2</a> with <code>image</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindImageMemoryInfo-pNext-01616",
|
|
"text": " If the <code>pNext</code> chain does not include a <a href=\"#VkBindImagePlaneMemoryInfo\">VkBindImagePlaneMemoryInfo</a> structure, <code>memoryOffset</code> <strong class=\"purple\">must</strong> be an integer multiple of the <code>alignment</code> member of the <a href=\"#VkMemoryRequirements\">VkMemoryRequirements</a> structure returned from a call to <a href=\"#vkGetImageMemoryRequirements2\">vkGetImageMemoryRequirements2</a> with <code>image</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindImageMemoryInfo-pNext-01617",
|
|
"text": " If the <code>pNext</code> chain does not include a <a href=\"#VkBindImagePlaneMemoryInfo\">VkBindImagePlaneMemoryInfo</a> structure, the difference of the size of <code>memory</code> and <code>memoryOffset</code> <strong class=\"purple\">must</strong> be greater than or equal to the <code>size</code> member of the <a href=\"#VkMemoryRequirements\">VkMemoryRequirements</a> structure returned from a call to <a href=\"#vkGetImageMemoryRequirements2\">vkGetImageMemoryRequirements2</a> with the same <code>image</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindImageMemoryInfo-pNext-01618",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkBindImagePlaneMemoryInfo\">VkBindImagePlaneMemoryInfo</a> structure, <code>image</code> <strong class=\"purple\">must</strong> have been created with the <code>VK_IMAGE_CREATE_DISJOINT_BIT</code> bit set"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindImageMemoryInfo-pNext-01619",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkBindImagePlaneMemoryInfo\">VkBindImagePlaneMemoryInfo</a> structure, <code>memory</code> <strong class=\"purple\">must</strong> have been allocated using one of the memory types allowed in the <code>memoryTypeBits</code> member of the <a href=\"#VkMemoryRequirements\">VkMemoryRequirements</a> structure returned from a call to <a href=\"#vkGetImageMemoryRequirements2\">vkGetImageMemoryRequirements2</a> with <code>image</code> and where <a href=\"#VkBindImagePlaneMemoryInfo\">VkBindImagePlaneMemoryInfo</a>::<code>planeAspect</code> corresponds to the <a href=\"#VkImagePlaneMemoryRequirementsInfo\">VkImagePlaneMemoryRequirementsInfo</a>::<code>planeAspect</code> in the <a href=\"#VkImageMemoryRequirementsInfo2\">VkImageMemoryRequirementsInfo2</a> structure’s <code>pNext</code> chain"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindImageMemoryInfo-pNext-01620",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkBindImagePlaneMemoryInfo\">VkBindImagePlaneMemoryInfo</a> structure, <code>memoryOffset</code> <strong class=\"purple\">must</strong> be an integer multiple of the <code>alignment</code> member of the <a href=\"#VkMemoryRequirements\">VkMemoryRequirements</a> structure returned from a call to <a href=\"#vkGetImageMemoryRequirements2\">vkGetImageMemoryRequirements2</a> with <code>image</code> and where <a href=\"#VkBindImagePlaneMemoryInfo\">VkBindImagePlaneMemoryInfo</a>::<code>planeAspect</code> corresponds to the <a href=\"#VkImagePlaneMemoryRequirementsInfo\">VkImagePlaneMemoryRequirementsInfo</a>::<code>planeAspect</code> in the <a href=\"#VkImageMemoryRequirementsInfo2\">VkImageMemoryRequirementsInfo2</a> structure’s <code>pNext</code> chain"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindImageMemoryInfo-pNext-01621",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkBindImagePlaneMemoryInfo\">VkBindImagePlaneMemoryInfo</a> structure, the difference of the size of <code>memory</code> and <code>memoryOffset</code> <strong class=\"purple\">must</strong> be greater than or equal to the <code>size</code> member of the <a href=\"#VkMemoryRequirements\">VkMemoryRequirements</a> structure returned from a call to <a href=\"#vkGetImageMemoryRequirements2\">vkGetImageMemoryRequirements2</a> with the same <code>image</code> and where <a href=\"#VkBindImagePlaneMemoryInfo\">VkBindImagePlaneMemoryInfo</a>::<code>planeAspect</code> corresponds to the <a href=\"#VkImagePlaneMemoryRequirementsInfo\">VkImagePlaneMemoryRequirementsInfo</a>::<code>planeAspect</code> in the <a href=\"#VkImageMemoryRequirementsInfo2\">VkImageMemoryRequirementsInfo2</a> structure’s <code>pNext</code> chain"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_bind_memory2)+!(VK_VERSION_1_1+VK_KHR_swapchain)+!(VK_KHR_device_group+VK_KHR_swapchain)": [
|
|
{
|
|
"vuid": "VUID-VkBindImageMemoryInfo-memory-01625",
|
|
"text": " <code>memory</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDeviceMemory\">VkDeviceMemory</a> handle"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_bind_memory2)+(VK_VERSION_1_1,VK_KHR_device_group)": [
|
|
{
|
|
"vuid": "VUID-VkBindImageMemoryInfo-pNext-01626",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkBindImageMemoryDeviceGroupInfo\">VkBindImageMemoryDeviceGroupInfo</a> structure, all instances of <code>memory</code> specified by <a href=\"#VkBindImageMemoryDeviceGroupInfo\">VkBindImageMemoryDeviceGroupInfo</a>::<code>pDeviceIndices</code> <strong class=\"purple\">must</strong> have been allocated"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindImageMemoryInfo-pNext-01627",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkBindImageMemoryDeviceGroupInfo\">VkBindImageMemoryDeviceGroupInfo</a> structure, and <a href=\"#VkBindImageMemoryDeviceGroupInfo\">VkBindImageMemoryDeviceGroupInfo</a>::<code>splitInstanceBindRegionCount</code> is not zero, then <code>image</code> <strong class=\"purple\">must</strong> have been created with the <code>VK_IMAGE_CREATE_SPLIT_INSTANCE_BIND_REGIONS_BIT</code> bit set"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindImageMemoryInfo-pNext-01628",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkBindImageMemoryDeviceGroupInfo\">VkBindImageMemoryDeviceGroupInfo</a> structure, all elements of <a href=\"#VkBindImageMemoryDeviceGroupInfo\">VkBindImageMemoryDeviceGroupInfo</a>::<code>pSplitInstanceBindRegions</code> <strong class=\"purple\">must</strong> be valid rectangles contained within the dimensions of <code>image</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindImageMemoryInfo-pNext-01629",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkBindImageMemoryDeviceGroupInfo\">VkBindImageMemoryDeviceGroupInfo</a> structure, the union of the areas of all elements of <a href=\"#VkBindImageMemoryDeviceGroupInfo\">VkBindImageMemoryDeviceGroupInfo</a>::<code>pSplitInstanceBindRegions</code> that correspond to the same instance of <code>image</code> <strong class=\"purple\">must</strong> cover the entire image"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_bind_memory2)+(VK_VERSION_1_1,VK_KHR_device_group)+(VK_KHR_swapchain)": [
|
|
{
|
|
"vuid": "VUID-VkBindImageMemoryInfo-image-01630",
|
|
"text": " If <code>image</code> was created with a valid swapchain handle in <a href=\"#VkImageSwapchainCreateInfoKHR\">VkImageSwapchainCreateInfoKHR</a>::<code>swapchain</code>, then the <code>pNext</code> chain <strong class=\"purple\">must</strong> include a <a href=\"#VkBindImageMemorySwapchainInfoKHR\">VkBindImageMemorySwapchainInfoKHR</a> structure containing the same swapchain handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindImageMemoryInfo-pNext-01631",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkBindImageMemorySwapchainInfoKHR\">VkBindImageMemorySwapchainInfoKHR</a> structure, <code>memory</code> <strong class=\"purple\">must</strong> be <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindImageMemoryInfo-pNext-01632",
|
|
"text": " If the <code>pNext</code> chain does not include a <a href=\"#VkBindImageMemorySwapchainInfoKHR\">VkBindImageMemorySwapchainInfoKHR</a> structure, <code>memory</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDeviceMemory\">VkDeviceMemory</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkBindImageMemoryDeviceGroupInfo": {
|
|
"(VK_VERSION_1_1,VK_KHR_bind_memory2)+(VK_VERSION_1_1,VK_KHR_device_group)": [
|
|
{
|
|
"vuid": "VUID-VkBindImageMemoryDeviceGroupInfo-deviceIndexCount-01633",
|
|
"text": " At least one of <code>deviceIndexCount</code> and <code>splitInstanceBindRegionCount</code> <strong class=\"purple\">must</strong> be zero"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindImageMemoryDeviceGroupInfo-deviceIndexCount-01634",
|
|
"text": " <code>deviceIndexCount</code> <strong class=\"purple\">must</strong> either be zero or equal to the number of physical devices in the logical device"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindImageMemoryDeviceGroupInfo-pDeviceIndices-01635",
|
|
"text": " All elements of <code>pDeviceIndices</code> <strong class=\"purple\">must</strong> be valid device indices"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindImageMemoryDeviceGroupInfo-splitInstanceBindRegionCount-01636",
|
|
"text": " <code>splitInstanceBindRegionCount</code> <strong class=\"purple\">must</strong> either be zero or equal to the number of physical devices in the logical device squared"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindImageMemoryDeviceGroupInfo-pSplitInstanceBindRegions-01637",
|
|
"text": " Elements of <code>pSplitInstanceBindRegions</code> that correspond to the same instance of an image <strong class=\"purple\">must</strong> not overlap"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindImageMemoryDeviceGroupInfo-offset-01638",
|
|
"text": " The <code>offset.x</code> member of any element of <code>pSplitInstanceBindRegions</code> <strong class=\"purple\">must</strong> be a multiple of the sparse image block width (<code>VkSparseImageFormatProperties</code>::<code>imageGranularity.width</code>) of all non-metadata aspects of the image"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindImageMemoryDeviceGroupInfo-offset-01639",
|
|
"text": " The <code>offset.y</code> member of any element of <code>pSplitInstanceBindRegions</code> <strong class=\"purple\">must</strong> be a multiple of the sparse image block height (<code>VkSparseImageFormatProperties</code>::<code>imageGranularity.height</code>) of all non-metadata aspects of the image"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindImageMemoryDeviceGroupInfo-extent-01640",
|
|
"text": " The <code>extent.width</code> member of any element of <code>pSplitInstanceBindRegions</code> <strong class=\"purple\">must</strong> either be a multiple of the sparse image block width of all non-metadata aspects of the image, or else <code>extent.width</code> + <code>offset.x</code> <strong class=\"purple\">must</strong> equal the width of the image subresource"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindImageMemoryDeviceGroupInfo-extent-01641",
|
|
"text": " The <code>extent.height</code> member of any element of <code>pSplitInstanceBindRegions</code> <strong class=\"purple\">must</strong> either be a multiple of the sparse image block height of all non-metadata aspects of the image, or else <code>extent.height</code> + <code>offset.y</code> <strong class=\"purple\">must</strong> equal the height of the image subresource"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindImageMemoryDeviceGroupInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_BIND_IMAGE_MEMORY_DEVICE_GROUP_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindImageMemoryDeviceGroupInfo-pDeviceIndices-parameter",
|
|
"text": " If <code>deviceIndexCount</code> is not <code>0</code>, <code>pDeviceIndices</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>deviceIndexCount</code> <code>uint32_t</code> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindImageMemoryDeviceGroupInfo-pSplitInstanceBindRegions-parameter",
|
|
"text": " If <code>splitInstanceBindRegionCount</code> is not <code>0</code>, <code>pSplitInstanceBindRegions</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>splitInstanceBindRegionCount</code> <a href=\"#VkRect2D\">VkRect2D</a> structures"
|
|
}
|
|
]
|
|
},
|
|
"VkBindImageMemorySwapchainInfoKHR": {
|
|
"(VK_VERSION_1_1,VK_KHR_bind_memory2)+(VK_VERSION_1_1,VK_KHR_device_group)+(VK_KHR_swapchain)": [
|
|
{
|
|
"vuid": "VUID-VkBindImageMemorySwapchainInfoKHR-imageIndex-01644",
|
|
"text": " <code>imageIndex</code> <strong class=\"purple\">must</strong> be less than the number of images in <code>swapchain</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindImageMemorySwapchainInfoKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_BIND_IMAGE_MEMORY_SWAPCHAIN_INFO_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindImageMemorySwapchainInfoKHR-swapchain-parameter",
|
|
"text": " <code>swapchain</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSwapchainKHR\">VkSwapchainKHR</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkBindImagePlaneMemoryInfo": {
|
|
"(VK_VERSION_1_1,VK_KHR_bind_memory2)+(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-VkBindImagePlaneMemoryInfo-planeAspect-02283",
|
|
"text": " If the image’s <code>tiling</code> is <code>VK_IMAGE_TILING_LINEAR</code> or <code>VK_IMAGE_TILING_OPTIMAL</code>, then <code>planeAspect</code> <strong class=\"purple\">must</strong> be a single valid <em>format plane</em> for the image (that is, for a two-plane image <code>planeAspect</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_ASPECT_PLANE_0_BIT</code> or <code>VK_IMAGE_ASPECT_PLANE_1_BIT</code>, and for a three-plane image <code>planeAspect</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_ASPECT_PLANE_0_BIT</code>, <code>VK_IMAGE_ASPECT_PLANE_1_BIT</code> or <code>VK_IMAGE_ASPECT_PLANE_2_BIT</code>)"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindImagePlaneMemoryInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_BIND_IMAGE_PLANE_MEMORY_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindImagePlaneMemoryInfo-planeAspect-parameter",
|
|
"text": " <code>planeAspect</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageAspectFlagBits\">VkImageAspectFlagBits</a> value"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_bind_memory2)+(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)+(VK_EXT_image_drm_format_modifier)": [
|
|
{
|
|
"vuid": "VUID-VkBindImagePlaneMemoryInfo-planeAspect-02284",
|
|
"text": " If the image’s <code>tiling</code> is <code>VK_IMAGE_TILING_DRM_FORMAT_MODIFIER_EXT</code>, then <code>planeAspect</code> <strong class=\"purple\">must</strong> be a single valid <em>memory plane</em> for the image (that is, <code>aspectMask</code> <strong class=\"purple\">must</strong> specify a plane index that is less than the <a href=\"#VkDrmFormatModifierPropertiesEXT\">VkDrmFormatModifierPropertiesEXT</a>::<code>drmFormatModifierPlaneCount</code> associated with the image’s <code>format</code> and <a href=\"#VkImageDrmFormatModifierPropertiesEXT\">VkImageDrmFormatModifierPropertiesEXT</a>::<code>drmFormatModifier</code>)"
|
|
}
|
|
]
|
|
},
|
|
"vkCreateBufferCollectionFUCHSIA": {
|
|
"(VK_FUCHSIA_buffer_collection)": [
|
|
{
|
|
"vuid": "VUID-vkCreateBufferCollectionFUCHSIA-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateBufferCollectionFUCHSIA-pCreateInfo-parameter",
|
|
"text": " <code>pCreateInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkBufferCollectionCreateInfoFUCHSIA\">VkBufferCollectionCreateInfoFUCHSIA</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateBufferCollectionFUCHSIA-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateBufferCollectionFUCHSIA-pCollection-parameter",
|
|
"text": " <code>pCollection</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkBufferCollectionFUCHSIA\">VkBufferCollectionFUCHSIA</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkBufferCollectionCreateInfoFUCHSIA": {
|
|
"(VK_FUCHSIA_buffer_collection)": [
|
|
{
|
|
"vuid": "VUID-VkBufferCollectionCreateInfoFUCHSIA-collectionToken-06393",
|
|
"text": " <code>collectionToken</code> <strong class=\"purple\">must</strong> be a valid <code>zx_handle_t</code> to a Zircon channel allocated from Sysmem (<code>fuchsia.sysmem.Allocator</code>/AllocateSharedCollection) with <code>ZX_DEFAULT_CHANNEL_RIGHTS</code> rights"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferCollectionCreateInfoFUCHSIA-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_BUFFER_COLLECTION_CREATE_INFO_FUCHSIA</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferCollectionCreateInfoFUCHSIA-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkSetBufferCollectionImageConstraintsFUCHSIA": {
|
|
"(VK_FUCHSIA_buffer_collection)": [
|
|
{
|
|
"vuid": "VUID-vkSetBufferCollectionImageConstraintsFUCHSIA-collection-06394",
|
|
"text": " <code>vkSetBufferCollectionImageConstraintsFUCHSIA</code> or <code>vkSetBufferCollectionBufferConstraintsFUCHSIA</code> <strong class=\"purple\">must</strong> not have already been called on <code>collection</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkSetBufferCollectionImageConstraintsFUCHSIA-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkSetBufferCollectionImageConstraintsFUCHSIA-collection-parameter",
|
|
"text": " <code>collection</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBufferCollectionFUCHSIA\">VkBufferCollectionFUCHSIA</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkSetBufferCollectionImageConstraintsFUCHSIA-pImageConstraintsInfo-parameter",
|
|
"text": " <code>pImageConstraintsInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkImageConstraintsInfoFUCHSIA\">VkImageConstraintsInfoFUCHSIA</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkSetBufferCollectionImageConstraintsFUCHSIA-collection-parent",
|
|
"text": " <code>collection</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkImageConstraintsInfoFUCHSIA": {
|
|
"(VK_FUCHSIA_buffer_collection)": [
|
|
{
|
|
"vuid": "VUID-VkImageConstraintsInfoFUCHSIA-pFormatConstraints-06395",
|
|
"text": " All elements of <code>pFormatConstraints</code> <strong class=\"purple\">must</strong> have at least one bit set in its <a href=\"#VkImageFormatConstraintsInfoFUCHSIA\">VkImageFormatConstraintsInfoFUCHSIA</a>::<code>requiredFormatFeatures</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageConstraintsInfoFUCHSIA-pFormatConstraints-06396",
|
|
"text": " If <code>pFormatConstraints</code>::<code>imageCreateInfo</code>::<code>usage</code> contains <code>VK_IMAGE_USAGE_SAMPLED_BIT</code>, then <code>pFormatConstraints</code>::<code>requiredFormatFeatures</code> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageConstraintsInfoFUCHSIA-pFormatConstraints-06397",
|
|
"text": " If <code>pFormatConstraints</code>::<code>imageCreateInfo</code>::<code>usage</code> contains <code>VK_IMAGE_USAGE_STORAGE_BIT</code>, then <code>pFormatConstraints</code>::<code>requiredFormatFeatures</code> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_STORAGE_IMAGE_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageConstraintsInfoFUCHSIA-pFormatConstraints-06398",
|
|
"text": " If <code>pFormatConstraints</code>::<code>imageCreateInfo</code>::<code>usage</code> contains <code>VK_IMAGE_USAGE_COLOR_ATTACHMENT_BIT</code>, then <code>pFormatConstraints</code>::<code>requiredFormatFeatures</code> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_COLOR_ATTACHMENT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageConstraintsInfoFUCHSIA-pFormatConstraints-06399",
|
|
"text": " If <code>pFormatConstraints</code>::<code>imageCreateInfo</code>::<code>usage</code> contains <code>VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT</code>, then <code>pFormatConstraints</code>::<code>requiredFormatFeatures</code> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_DEPTH_STENCIL_ATTACHMENT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageConstraintsInfoFUCHSIA-pFormatConstraints-06400",
|
|
"text": " If <code>pFormatConstraints</code>::<code>imageCreateInfo</code>::<code>usage</code> contains <code>VK_IMAGE_USAGE_INPUT_ATTACHMENT_BIT</code>, then <code>pFormatConstraints</code>::<code>requiredFormatFeatures</code> <strong class=\"purple\">must</strong> contain at least one of <code>VK_FORMAT_FEATURE_COLOR_ATTACHMENT_BIT</code> or <code>VK_FORMAT_FEATURE_DEPTH_STENCIL_ATTACHMENT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageConstraintsInfoFUCHSIA-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_IMAGE_CONSTRAINTS_INFO_FUCHSIA</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageConstraintsInfoFUCHSIA-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageConstraintsInfoFUCHSIA-pFormatConstraints-parameter",
|
|
"text": " <code>pFormatConstraints</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>formatConstraintsCount</code> valid <a href=\"#VkImageFormatConstraintsInfoFUCHSIA\">VkImageFormatConstraintsInfoFUCHSIA</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageConstraintsInfoFUCHSIA-bufferCollectionConstraints-parameter",
|
|
"text": " <code>bufferCollectionConstraints</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBufferCollectionConstraintsInfoFUCHSIA\">VkBufferCollectionConstraintsInfoFUCHSIA</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageConstraintsInfoFUCHSIA-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkImageConstraintsInfoFlagBitsFUCHSIA\">VkImageConstraintsInfoFlagBitsFUCHSIA</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageConstraintsInfoFUCHSIA-formatConstraintsCount-arraylength",
|
|
"text": " <code>formatConstraintsCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
],
|
|
"(VK_FUCHSIA_buffer_collection)+(VK_KHR_fragment_shading_rate)": [
|
|
{
|
|
"vuid": "VUID-VkImageConstraintsInfoFUCHSIA-attachmentFragmentShadingRate-06401",
|
|
"text": " If the <a href=\"#features-attachmentFragmentShadingRate\"><code>attachmentFragmentShadingRate</code></a> feature is enabled, and <code>pFormatConstraints</code>::<code>imageCreateInfo</code>::<code>usage</code> contains <code>VK_IMAGE_USAGE_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR</code>, then <code>pFormatConstraints</code>::<code>requiredFormatFeatures</code> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkImageFormatConstraintsInfoFUCHSIA": {
|
|
"(VK_FUCHSIA_buffer_collection)": [
|
|
{
|
|
"vuid": "VUID-VkImageFormatConstraintsInfoFUCHSIA-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_IMAGE_FORMAT_CONSTRAINTS_INFO_FUCHSIA</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageFormatConstraintsInfoFUCHSIA-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageFormatConstraintsInfoFUCHSIA-imageCreateInfo-parameter",
|
|
"text": " <code>imageCreateInfo</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageFormatConstraintsInfoFUCHSIA-requiredFormatFeatures-parameter",
|
|
"text": " <code>requiredFormatFeatures</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkFormatFeatureFlagBits\">VkFormatFeatureFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageFormatConstraintsInfoFUCHSIA-requiredFormatFeatures-requiredbitmask",
|
|
"text": " <code>requiredFormatFeatures</code> <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageFormatConstraintsInfoFUCHSIA-flags-zerobitmask",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageFormatConstraintsInfoFUCHSIA-pColorSpaces-parameter",
|
|
"text": " <code>pColorSpaces</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>colorSpaceCount</code> valid <a href=\"#VkSysmemColorSpaceFUCHSIA\">VkSysmemColorSpaceFUCHSIA</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageFormatConstraintsInfoFUCHSIA-colorSpaceCount-arraylength",
|
|
"text": " <code>colorSpaceCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkBufferCollectionConstraintsInfoFUCHSIA": {
|
|
"(VK_FUCHSIA_buffer_collection)": [
|
|
{
|
|
"vuid": "VUID-VkBufferCollectionConstraintsInfoFUCHSIA-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_BUFFER_COLLECTION_CONSTRAINTS_INFO_FUCHSIA</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferCollectionConstraintsInfoFUCHSIA-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkSysmemColorSpaceFUCHSIA": {
|
|
"(VK_FUCHSIA_buffer_collection)": [
|
|
{
|
|
"vuid": "VUID-VkSysmemColorSpaceFUCHSIA-colorSpace-06402",
|
|
"text": " <code>colorSpace</code> <strong class=\"purple\">must</strong> be a <code>ColorSpaceType</code> as defined in <code>fuchsia.sysmem/image_formats.fidl</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSysmemColorSpaceFUCHSIA-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_SYSMEM_COLOR_SPACE_FUCHSIA</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSysmemColorSpaceFUCHSIA-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkSetBufferCollectionBufferConstraintsFUCHSIA": {
|
|
"(VK_FUCHSIA_buffer_collection)": [
|
|
{
|
|
"vuid": "VUID-vkSetBufferCollectionBufferConstraintsFUCHSIA-collection-06403",
|
|
"text": " <code>vkSetBufferCollectionImageConstraintsFUCHSIA</code> or <code>vkSetBufferCollectionBufferConstraintsFUCHSIA</code> <strong class=\"purple\">must</strong> not have already been called on <code>collection</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkSetBufferCollectionBufferConstraintsFUCHSIA-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkSetBufferCollectionBufferConstraintsFUCHSIA-collection-parameter",
|
|
"text": " <code>collection</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBufferCollectionFUCHSIA\">VkBufferCollectionFUCHSIA</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkSetBufferCollectionBufferConstraintsFUCHSIA-pBufferConstraintsInfo-parameter",
|
|
"text": " <code>pBufferConstraintsInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkBufferConstraintsInfoFUCHSIA\">VkBufferConstraintsInfoFUCHSIA</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkSetBufferCollectionBufferConstraintsFUCHSIA-collection-parent",
|
|
"text": " <code>collection</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkBufferConstraintsInfoFUCHSIA": {
|
|
"(VK_FUCHSIA_buffer_collection)": [
|
|
{
|
|
"vuid": "VUID-VkBufferConstraintsInfoFUCHSIA-requiredFormatFeatures-06404",
|
|
"text": " The <code>requiredFormatFeatures</code> bitmask of <code>VkFormatFeatureFlagBits</code> <strong class=\"purple\">must</strong> be chosen from among the buffer compatible format features listed in <a href=\"#buffer-compatible-format-features\">buffer compatible format features</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferConstraintsInfoFUCHSIA-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_BUFFER_CONSTRAINTS_INFO_FUCHSIA</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferConstraintsInfoFUCHSIA-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferConstraintsInfoFUCHSIA-createInfo-parameter",
|
|
"text": " <code>createInfo</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBufferCreateInfo\">VkBufferCreateInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferConstraintsInfoFUCHSIA-requiredFormatFeatures-parameter",
|
|
"text": " <code>requiredFormatFeatures</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkFormatFeatureFlagBits\">VkFormatFeatureFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferConstraintsInfoFUCHSIA-bufferCollectionConstraints-parameter",
|
|
"text": " <code>bufferCollectionConstraints</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBufferCollectionConstraintsInfoFUCHSIA\">VkBufferCollectionConstraintsInfoFUCHSIA</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"vkGetBufferCollectionPropertiesFUCHSIA": {
|
|
"(VK_FUCHSIA_buffer_collection)": [
|
|
{
|
|
"vuid": "VUID-vkGetBufferCollectionPropertiesFUCHSIA-None-06405",
|
|
"text": " Prior to calling <a href=\"#vkGetBufferCollectionPropertiesFUCHSIA\">vkGetBufferCollectionPropertiesFUCHSIA</a>, the constraints on the buffer collection <strong class=\"purple\">must</strong> have been set by either <a href=\"#vkSetBufferCollectionImageConstraintsFUCHSIA\">vkSetBufferCollectionImageConstraintsFUCHSIA</a> or <a href=\"#vkSetBufferCollectionBufferConstraintsFUCHSIA\">vkSetBufferCollectionBufferConstraintsFUCHSIA</a>."
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetBufferCollectionPropertiesFUCHSIA-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetBufferCollectionPropertiesFUCHSIA-collection-parameter",
|
|
"text": " <code>collection</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBufferCollectionFUCHSIA\">VkBufferCollectionFUCHSIA</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetBufferCollectionPropertiesFUCHSIA-pProperties-parameter",
|
|
"text": " <code>pProperties</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkBufferCollectionPropertiesFUCHSIA\">VkBufferCollectionPropertiesFUCHSIA</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetBufferCollectionPropertiesFUCHSIA-collection-parent",
|
|
"text": " <code>collection</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkBufferCollectionPropertiesFUCHSIA": {
|
|
"(VK_FUCHSIA_buffer_collection)": [
|
|
{
|
|
"vuid": "VUID-VkBufferCollectionPropertiesFUCHSIA-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_BUFFER_COLLECTION_PROPERTIES_FUCHSIA</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferCollectionPropertiesFUCHSIA-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferCollectionPropertiesFUCHSIA-formatFeatures-parameter",
|
|
"text": " <code>formatFeatures</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkFormatFeatureFlagBits\">VkFormatFeatureFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferCollectionPropertiesFUCHSIA-formatFeatures-requiredbitmask",
|
|
"text": " <code>formatFeatures</code> <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferCollectionPropertiesFUCHSIA-sysmemColorSpaceIndex-parameter",
|
|
"text": " <code>sysmemColorSpaceIndex</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSysmemColorSpaceFUCHSIA\">VkSysmemColorSpaceFUCHSIA</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferCollectionPropertiesFUCHSIA-samplerYcbcrConversionComponents-parameter",
|
|
"text": " <code>samplerYcbcrConversionComponents</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkComponentMapping\">VkComponentMapping</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferCollectionPropertiesFUCHSIA-suggestedYcbcrModel-parameter",
|
|
"text": " <code>suggestedYcbcrModel</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSamplerYcbcrModelConversion\">VkSamplerYcbcrModelConversion</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferCollectionPropertiesFUCHSIA-suggestedYcbcrRange-parameter",
|
|
"text": " <code>suggestedYcbcrRange</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSamplerYcbcrRange\">VkSamplerYcbcrRange</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferCollectionPropertiesFUCHSIA-suggestedXChromaOffset-parameter",
|
|
"text": " <code>suggestedXChromaOffset</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkChromaLocation\">VkChromaLocation</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferCollectionPropertiesFUCHSIA-suggestedYChromaOffset-parameter",
|
|
"text": " <code>suggestedYChromaOffset</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkChromaLocation\">VkChromaLocation</a> value"
|
|
}
|
|
]
|
|
},
|
|
"VkImportMemoryBufferCollectionFUCHSIA": {
|
|
"(VK_FUCHSIA_buffer_collection)": [
|
|
{
|
|
"vuid": "VUID-VkImportMemoryBufferCollectionFUCHSIA-index-06406",
|
|
"text": " <code>index</code> <strong class=\"purple\">must</strong> be less than the value retrieved as <a href=\"#VkBufferCollectionPropertiesFUCHSIA\">VkBufferCollectionPropertiesFUCHSIA</a>:bufferCount"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportMemoryBufferCollectionFUCHSIA-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_IMPORT_MEMORY_BUFFER_COLLECTION_FUCHSIA</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImportMemoryBufferCollectionFUCHSIA-collection-parameter",
|
|
"text": " <code>collection</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBufferCollectionFUCHSIA\">VkBufferCollectionFUCHSIA</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"vkDestroyBufferCollectionFUCHSIA": {
|
|
"(VK_FUCHSIA_buffer_collection)": [
|
|
{
|
|
"vuid": "VUID-vkDestroyBufferCollectionFUCHSIA-collection-06407",
|
|
"text": " <a href=\"#VkImage\">VkImage</a> and <a href=\"#VkBuffer\">VkBuffer</a> objects that referenced <code>collection</code> upon creation by inclusion of a <a href=\"#VkBufferCollectionImageCreateInfoFUCHSIA\">VkBufferCollectionImageCreateInfoFUCHSIA</a> or <a href=\"#VkBufferCollectionBufferCreateInfoFUCHSIA\">VkBufferCollectionBufferCreateInfoFUCHSIA</a> chained to their <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> or <a href=\"#VkBufferCreateInfo\">VkBufferCreateInfo</a> structures respectively, <strong class=\"purple\">may</strong> outlive <code>collection</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyBufferCollectionFUCHSIA-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyBufferCollectionFUCHSIA-collection-parameter",
|
|
"text": " <code>collection</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBufferCollectionFUCHSIA\">VkBufferCollectionFUCHSIA</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyBufferCollectionFUCHSIA-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyBufferCollectionFUCHSIA-collection-parent",
|
|
"text": " <code>collection</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCreateSampler": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCreateSampler-maxSamplerAllocationCount-04110",
|
|
"text": " There <strong class=\"purple\">must</strong> be less than <a href=\"#VkPhysicalDeviceLimits\">VkPhysicalDeviceLimits</a>::<code>maxSamplerAllocationCount</code> <a href=\"#VkSampler\">VkSampler</a> objects currently created on the device"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateSampler-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateSampler-pCreateInfo-parameter",
|
|
"text": " <code>pCreateInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkSamplerCreateInfo\">VkSamplerCreateInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateSampler-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateSampler-pSampler-parameter",
|
|
"text": " <code>pSampler</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkSampler\">VkSampler</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkSamplerCreateInfo": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkSamplerCreateInfo-mipLodBias-01069",
|
|
"text": " The absolute value of <code>mipLodBias</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxSamplerLodBias</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerCreateInfo-maxLod-01973",
|
|
"text": " <code>maxLod</code> <strong class=\"purple\">must</strong> be greater than or equal to <code>minLod</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerCreateInfo-anisotropyEnable-01070",
|
|
"text": " If the <a href=\"#features-samplerAnisotropy\"><code>samplerAnisotropy</code></a> feature is not enabled, <code>anisotropyEnable</code> <strong class=\"purple\">must</strong> be <code>VK_FALSE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerCreateInfo-anisotropyEnable-01071",
|
|
"text": " If <code>anisotropyEnable</code> is <code>VK_TRUE</code>, <code>maxAnisotropy</code> <strong class=\"purple\">must</strong> be between <code>1.0</code> and <code>VkPhysicalDeviceLimits</code>::<code>maxSamplerAnisotropy</code>, inclusive"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerCreateInfo-unnormalizedCoordinates-01072",
|
|
"text": " If <code>unnormalizedCoordinates</code> is <code>VK_TRUE</code>, <code>minFilter</code> and <code>magFilter</code> <strong class=\"purple\">must</strong> be equal"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerCreateInfo-unnormalizedCoordinates-01073",
|
|
"text": " If <code>unnormalizedCoordinates</code> is <code>VK_TRUE</code>, <code>mipmapMode</code> <strong class=\"purple\">must</strong> be <code>VK_SAMPLER_MIPMAP_MODE_NEAREST</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerCreateInfo-unnormalizedCoordinates-01074",
|
|
"text": " If <code>unnormalizedCoordinates</code> is <code>VK_TRUE</code>, <code>minLod</code> and <code>maxLod</code> <strong class=\"purple\">must</strong> be zero"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerCreateInfo-unnormalizedCoordinates-01075",
|
|
"text": " If <code>unnormalizedCoordinates</code> is <code>VK_TRUE</code>, <code>addressModeU</code> and <code>addressModeV</code> <strong class=\"purple\">must</strong> each be either <code>VK_SAMPLER_ADDRESS_MODE_CLAMP_TO_EDGE</code> or <code>VK_SAMPLER_ADDRESS_MODE_CLAMP_TO_BORDER</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerCreateInfo-unnormalizedCoordinates-01076",
|
|
"text": " If <code>unnormalizedCoordinates</code> is <code>VK_TRUE</code>, <code>anisotropyEnable</code> <strong class=\"purple\">must</strong> be <code>VK_FALSE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerCreateInfo-unnormalizedCoordinates-01077",
|
|
"text": " If <code>unnormalizedCoordinates</code> is <code>VK_TRUE</code>, <code>compareEnable</code> <strong class=\"purple\">must</strong> be <code>VK_FALSE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerCreateInfo-addressModeU-01078",
|
|
"text": " If any of <code>addressModeU</code>, <code>addressModeV</code> or <code>addressModeW</code> are <code>VK_SAMPLER_ADDRESS_MODE_CLAMP_TO_BORDER</code>, <code>borderColor</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBorderColor\">VkBorderColor</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerCreateInfo-addressModeU-01079",
|
|
"text": " If <a href=\"#features-samplerMirrorClampToEdge\"><code>samplerMirrorClampToEdge</code></a> is not enabled, and if the <code><a href=\"#VK_KHR_sampler_mirror_clamp_to_edge\">VK_KHR_sampler_mirror_clamp_to_edge</a></code> extension is not enabled, <code>addressModeU</code>, <code>addressModeV</code> and <code>addressModeW</code> <strong class=\"purple\">must</strong> not be <code>VK_SAMPLER_ADDRESS_MODE_MIRROR_CLAMP_TO_EDGE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerCreateInfo-compareEnable-01080",
|
|
"text": " If <code>compareEnable</code> is <code>VK_TRUE</code>, <code>compareOp</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCompareOp\">VkCompareOp</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerCreateInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_SAMPLER_CREATE_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerCreateInfo-pNext-pNext",
|
|
"text": " Each <code>pNext</code> member of any structure (including this one) in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be either <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkSamplerBorderColorComponentMappingCreateInfoEXT\">VkSamplerBorderColorComponentMappingCreateInfoEXT</a>, <a href=\"#VkSamplerCustomBorderColorCreateInfoEXT\">VkSamplerCustomBorderColorCreateInfoEXT</a>, <a href=\"#VkSamplerReductionModeCreateInfo\">VkSamplerReductionModeCreateInfo</a>, or <a href=\"#VkSamplerYcbcrConversionInfo\">VkSamplerYcbcrConversionInfo</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerCreateInfo-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerCreateInfo-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkSamplerCreateFlagBits\">VkSamplerCreateFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerCreateInfo-magFilter-parameter",
|
|
"text": " <code>magFilter</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkFilter\">VkFilter</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerCreateInfo-minFilter-parameter",
|
|
"text": " <code>minFilter</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkFilter\">VkFilter</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerCreateInfo-mipmapMode-parameter",
|
|
"text": " <code>mipmapMode</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSamplerMipmapMode\">VkSamplerMipmapMode</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerCreateInfo-addressModeU-parameter",
|
|
"text": " <code>addressModeU</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSamplerAddressMode\">VkSamplerAddressMode</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerCreateInfo-addressModeV-parameter",
|
|
"text": " <code>addressModeV</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSamplerAddressMode\">VkSamplerAddressMode</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerCreateInfo-addressModeW-parameter",
|
|
"text": " <code>addressModeW</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSamplerAddressMode\">VkSamplerAddressMode</a> value"
|
|
}
|
|
],
|
|
"(VK_KHR_portability_subset)": [
|
|
{
|
|
"vuid": "VUID-VkSamplerCreateInfo-samplerMipLodBias-04467",
|
|
"text": " If the <code><a href=\"#VK_KHR_portability_subset\">VK_KHR_portability_subset</a></code> extension is enabled, and <a href=\"#VkPhysicalDevicePortabilitySubsetFeaturesKHR\">VkPhysicalDevicePortabilitySubsetFeaturesKHR</a>::<code>samplerMipLodBias</code> is <code>VK_FALSE</code>, <code>mipLodBias</code> <strong class=\"purple\">must</strong> be zero"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-VkSamplerCreateInfo-minFilter-01645",
|
|
"text": " If <a href=\"#samplers-YCbCr-conversion\">sampler {YCbCr} conversion</a> is enabled and the <a href=\"#potential-format-features\">potential format features</a> of the sampler {YCbCr} conversion do not support <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_YCBCR_CONVERSION_SEPARATE_RECONSTRUCTION_FILTER_BIT</code>, <code>minFilter</code> and <code>magFilter</code> <strong class=\"purple\">must</strong> be equal to the sampler {YCbCr} conversion’s <code>chromaFilter</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerCreateInfo-addressModeU-01646",
|
|
"text": " If <a href=\"#samplers-YCbCr-conversion\">sampler {YCbCr} conversion</a> is enabled, <code>addressModeU</code>, <code>addressModeV</code>, and <code>addressModeW</code> <strong class=\"purple\">must</strong> be <code>VK_SAMPLER_ADDRESS_MODE_CLAMP_TO_EDGE</code>, <code>anisotropyEnable</code> <strong class=\"purple\">must</strong> be <code>VK_FALSE</code>, and <code>unnormalizedCoordinates</code> <strong class=\"purple\">must</strong> be <code>VK_FALSE</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)+(VK_VERSION_1_2,VK_EXT_sampler_filter_minmax)": [
|
|
{
|
|
"vuid": "VUID-VkSamplerCreateInfo-None-01647",
|
|
"text": " if <a href=\"#samplers-YCbCr-conversion\">sampler {YCbCr} conversion</a> is enabled and the <code>pNext</code> chain includes a <a href=\"#VkSamplerReductionModeCreateInfo\">VkSamplerReductionModeCreateInfo</a> structure, then the sampler reduction mode <strong class=\"purple\">must</strong> be set to <code>VK_SAMPLER_REDUCTION_MODE_WEIGHTED_AVERAGE</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2)": [
|
|
{
|
|
"vuid": "VUID-VkSamplerCreateInfo-pNext-06726",
|
|
"text": " If <a href=\"#features-samplerFilterMinmax\"><code>samplerFilterMinmax</code></a> is not enabled and the <code>pNext</code> chain includes a <a href=\"#VkSamplerReductionModeCreateInfo\">VkSamplerReductionModeCreateInfo</a> structure, then the sampler reduction mode <strong class=\"purple\">must</strong> be set to <code>VK_SAMPLER_REDUCTION_MODE_WEIGHTED_AVERAGE</code>"
|
|
}
|
|
],
|
|
"(VK_IMG_filter_cubic,VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-VkSamplerCreateInfo-magFilter-01081",
|
|
"text": " If either <code>magFilter</code> or <code>minFilter</code> is <code>VK_FILTER_CUBIC_EXT</code>, <code>anisotropyEnable</code> <strong class=\"purple\">must</strong> be <code>VK_FALSE</code>"
|
|
}
|
|
],
|
|
"(VK_IMG_filter_cubic+VK_EXT_sampler_filter_minmax)+!(VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-VkSamplerCreateInfo-magFilter-01422",
|
|
"text": " If either <code>magFilter</code> or <code>minFilter</code> is <code>VK_FILTER_CUBIC_EXT</code>, the <code>reductionMode</code> member of <a href=\"#VkSamplerReductionModeCreateInfo\">VkSamplerReductionModeCreateInfo</a> <strong class=\"purple\">must</strong> be <code>VK_SAMPLER_REDUCTION_MODE_WEIGHTED_AVERAGE</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_EXT_sampler_filter_minmax)": [
|
|
{
|
|
"vuid": "VUID-VkSamplerCreateInfo-compareEnable-01423",
|
|
"text": " If <code>compareEnable</code> is <code>VK_TRUE</code>, the <code>reductionMode</code> member of <a href=\"#VkSamplerReductionModeCreateInfo\">VkSamplerReductionModeCreateInfo</a> <strong class=\"purple\">must</strong> be <code>VK_SAMPLER_REDUCTION_MODE_WEIGHTED_AVERAGE</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_fragment_density_map)": [
|
|
{
|
|
"vuid": "VUID-VkSamplerCreateInfo-flags-02574",
|
|
"text": " If <code>flags</code> includes <code>VK_SAMPLER_CREATE_SUBSAMPLED_BIT_EXT</code>, then <code>minFilter</code> and <code>magFilter</code> <strong class=\"purple\">must</strong> be equal"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerCreateInfo-flags-02575",
|
|
"text": " If <code>flags</code> includes <code>VK_SAMPLER_CREATE_SUBSAMPLED_BIT_EXT</code>, then <code>mipmapMode</code> <strong class=\"purple\">must</strong> be <code>VK_SAMPLER_MIPMAP_MODE_NEAREST</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerCreateInfo-flags-02576",
|
|
"text": " If <code>flags</code> includes <code>VK_SAMPLER_CREATE_SUBSAMPLED_BIT_EXT</code>, then <code>minLod</code> and <code>maxLod</code> <strong class=\"purple\">must</strong> be zero"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerCreateInfo-flags-02577",
|
|
"text": " If <code>flags</code> includes <code>VK_SAMPLER_CREATE_SUBSAMPLED_BIT_EXT</code>, then <code>addressModeU</code> and <code>addressModeV</code> <strong class=\"purple\">must</strong> each be either <code>VK_SAMPLER_ADDRESS_MODE_CLAMP_TO_EDGE</code> or <code>VK_SAMPLER_ADDRESS_MODE_CLAMP_TO_BORDER</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerCreateInfo-flags-02578",
|
|
"text": " If <code>flags</code> includes <code>VK_SAMPLER_CREATE_SUBSAMPLED_BIT_EXT</code>, then <code>anisotropyEnable</code> <strong class=\"purple\">must</strong> be <code>VK_FALSE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerCreateInfo-flags-02579",
|
|
"text": " If <code>flags</code> includes <code>VK_SAMPLER_CREATE_SUBSAMPLED_BIT_EXT</code>, then <code>compareEnable</code> <strong class=\"purple\">must</strong> be <code>VK_FALSE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerCreateInfo-flags-02580",
|
|
"text": " If <code>flags</code> includes <code>VK_SAMPLER_CREATE_SUBSAMPLED_BIT_EXT</code>, then <code>unnormalizedCoordinates</code> <strong class=\"purple\">must</strong> be <code>VK_FALSE</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_non_seamless_cube_map)": [
|
|
{
|
|
"vuid": "VUID-VkSamplerCreateInfo-nonSeamlessCubeMap-06788",
|
|
"text": " If the <a href=\"#features-nonSeamlessCubeMap\"><code>nonSeamlessCubeMap</code></a> feature is not enabled, <code>flags</code> <strong class=\"purple\">must</strong> not include <code>VK_SAMPLER_CREATE_NON_SEAMLESS_CUBE_MAP_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_custom_border_color)": [
|
|
{
|
|
"vuid": "VUID-VkSamplerCreateInfo-borderColor-04011",
|
|
"text": " If <code>borderColor</code> is one of <code>VK_BORDER_COLOR_FLOAT_CUSTOM_EXT</code> or <code>VK_BORDER_COLOR_INT_CUSTOM_EXT</code>, then a <a href=\"#VkSamplerCustomBorderColorCreateInfoEXT\">VkSamplerCustomBorderColorCreateInfoEXT</a> <strong class=\"purple\">must</strong> be included in the <code>pNext</code> chain"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerCreateInfo-customBorderColors-04085",
|
|
"text": " If the <a href=\"#features-customBorderColors\"><code>customBorderColors</code></a> feature is not enabled, <code>borderColor</code> <strong class=\"purple\">must</strong> not be <code>VK_BORDER_COLOR_FLOAT_CUSTOM_EXT</code> or <code>VK_BORDER_COLOR_INT_CUSTOM_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerCreateInfo-borderColor-04442",
|
|
"text": " If <code>borderColor</code> is one of <code>VK_BORDER_COLOR_FLOAT_CUSTOM_EXT</code> or <code>VK_BORDER_COLOR_INT_CUSTOM_EXT</code>, and <a href=\"#VkSamplerCustomBorderColorCreateInfoEXT\">VkSamplerCustomBorderColorCreateInfoEXT</a>::<code>format</code> is not <code>VK_FORMAT_UNDEFINED</code>, <a href=\"#VkSamplerCustomBorderColorCreateInfoEXT\">VkSamplerCustomBorderColorCreateInfoEXT</a>::<code>customBorderColor</code> <strong class=\"purple\">must</strong> be within the range of values representable in <code>format</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerCreateInfo-None-04012",
|
|
"text": " The maximum number of samplers with custom border colors which <strong class=\"purple\">can</strong> be simultaneously created on a device is implementation-dependent and specified by the <a href=\"#limits-maxCustomBorderColorSamplers\"><code>maxCustomBorderColorSamplers</code></a> member of the <a href=\"#VkPhysicalDeviceCustomBorderColorPropertiesEXT\">VkPhysicalDeviceCustomBorderColorPropertiesEXT</a> structure"
|
|
}
|
|
],
|
|
"(VK_QCOM_image_processing)": [
|
|
{
|
|
"vuid": "VUID-VkSamplerCreateInfo-flags-06964",
|
|
"text": " If <code>flags</code> includes <code>VK_SAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM</code>, then <code>minFilter</code> and <code>magFilter</code> <strong class=\"purple\">must</strong> be <code>VK_FILTER_NEAREST</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerCreateInfo-flags-06965",
|
|
"text": " If <code>flags</code> includes <code>VK_SAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM</code>, then <code>mipmapMode</code> <strong class=\"purple\">must</strong> be <code>VK_SAMPLER_MIPMAP_MODE_NEAREST</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerCreateInfo-flags-06966",
|
|
"text": " [If <code>flags</code> includes <code>VK_SAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM</code>, then <code>minLod</code> and <code>maxLod</code> <strong class=\"purple\">must</strong> be zero"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerCreateInfo-flags-06967",
|
|
"text": " If <code>flags</code> includes <code>VK_SAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM</code>, then <code>addressModeU</code> and <code>addressModeV</code> <strong class=\"purple\">must</strong> each be either <code>VK_SAMPLER_ADDRESS_MODE_CLAMP_TO_EDGE</code> or <code>VK_SAMPLER_ADDRESS_MODE_CLAMP_TO_BORDER</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerCreateInfo-flags-06968",
|
|
"text": " If <code>flags</code> includes <code>VK_SAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM</code>, and if <code>addressModeU</code> or <code>addressModeV</code> is <code>VK_SAMPLER_ADDRESS_MODE_CLAMP_TO_BORDER</code>, then <code>borderColor</code> <strong class=\"purple\">must</strong> be <code>VK_BORDER_COLOR_FLOAT_TRANSPARENT_BLACK</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerCreateInfo-flags-06969",
|
|
"text": " If <code>flags</code> includes <code>VK_SAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM</code>, then <code>anisotropyEnable</code> <strong class=\"purple\">must</strong> be <code>VK_FALSE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerCreateInfo-flags-06970",
|
|
"text": " If <code>flags</code> includes <code>VK_SAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM</code>, then <code>compareEnable</code> <strong class=\"purple\">must</strong> be <code>VK_FALSE</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkSamplerReductionModeCreateInfo": {
|
|
"(VK_VERSION_1_2,VK_EXT_sampler_filter_minmax)": [
|
|
{
|
|
"vuid": "VUID-VkSamplerReductionModeCreateInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_SAMPLER_REDUCTION_MODE_CREATE_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerReductionModeCreateInfo-reductionMode-parameter",
|
|
"text": " <code>reductionMode</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSamplerReductionMode\">VkSamplerReductionMode</a> value"
|
|
}
|
|
]
|
|
},
|
|
"vkDestroySampler": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkDestroySampler-sampler-01082",
|
|
"text": " All submitted commands that refer to <code>sampler</code> <strong class=\"purple\">must</strong> have completed execution"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroySampler-sampler-01083",
|
|
"text": " If <code>VkAllocationCallbacks</code> were provided when <code>sampler</code> was created, a compatible set of callbacks <strong class=\"purple\">must</strong> be provided here"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroySampler-sampler-01084",
|
|
"text": " If no <code>VkAllocationCallbacks</code> were provided when <code>sampler</code> was created, <code>pAllocator</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroySampler-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroySampler-sampler-parameter",
|
|
"text": " If <code>sampler</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>sampler</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSampler\">VkSampler</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroySampler-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroySampler-sampler-parent",
|
|
"text": " If <code>sampler</code> is a valid handle, it <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkSamplerYcbcrConversionInfo": {
|
|
"(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-VkSamplerYcbcrConversionInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_SAMPLER_YCBCR_CONVERSION_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerYcbcrConversionInfo-conversion-parameter",
|
|
"text": " <code>conversion</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSamplerYcbcrConversion\">VkSamplerYcbcrConversion</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"vkCreateSamplerYcbcrConversion": {
|
|
"(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-vkCreateSamplerYcbcrConversion-None-01648",
|
|
"text": " The <a href=\"#features-samplerYcbcrConversion\"><code>samplerYcbcrConversion</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateSamplerYcbcrConversion-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateSamplerYcbcrConversion-pCreateInfo-parameter",
|
|
"text": " <code>pCreateInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkSamplerYcbcrConversionCreateInfo\">VkSamplerYcbcrConversionCreateInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateSamplerYcbcrConversion-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateSamplerYcbcrConversion-pYcbcrConversion-parameter",
|
|
"text": " <code>pYcbcrConversion</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkSamplerYcbcrConversion\">VkSamplerYcbcrConversion</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkSamplerYcbcrConversionCreateInfo": {
|
|
"(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)+!(VK_ANDROID_external_memory_android_hardware_buffer)": [
|
|
{
|
|
"vuid": "VUID-VkSamplerYcbcrConversionCreateInfo-format-04060",
|
|
"text": " <code>format</code> <strong class=\"purple\">must</strong> represent unsigned normalized values (i.e. the format must be a <code>UNORM</code> format)"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)+(VK_ANDROID_external_memory_android_hardware_buffer)": [
|
|
{
|
|
"vuid": "VUID-VkSamplerYcbcrConversionCreateInfo-format-01904",
|
|
"text": " If an external format conversion is being created, <code>format</code> <strong class=\"purple\">must</strong> be <code>VK_FORMAT_UNDEFINED</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerYcbcrConversionCreateInfo-format-04061",
|
|
"text": " If an external format conversion is not being created, <code>format</code> <strong class=\"purple\">must</strong> represent unsigned normalized values (i.e. the format must be a <code>UNORM</code> format)"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-VkSamplerYcbcrConversionCreateInfo-format-01650",
|
|
"text": " The <a href=\"#potential-format-features\">potential format features</a> of the sampler {YCbCr} conversion <strong class=\"purple\">must</strong> support <code>VK_FORMAT_FEATURE_MIDPOINT_CHROMA_SAMPLES_BIT</code> or <code>VK_FORMAT_FEATURE_COSITED_CHROMA_SAMPLES_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerYcbcrConversionCreateInfo-xChromaOffset-01651",
|
|
"text": " If the <a href=\"#potential-format-features\">potential format features</a> of the sampler {YCbCr} conversion do not support <code>VK_FORMAT_FEATURE_COSITED_CHROMA_SAMPLES_BIT</code>, <code>xChromaOffset</code> and <code>yChromaOffset</code> <strong class=\"purple\">must</strong> not be <code>VK_CHROMA_LOCATION_COSITED_EVEN</code> if the corresponding components are <a href=\"#textures-chroma-reconstruction\">downsampled</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerYcbcrConversionCreateInfo-xChromaOffset-01652",
|
|
"text": " If the <a href=\"#potential-format-features\">potential format features</a> of the sampler {YCbCr} conversion do not support <code>VK_FORMAT_FEATURE_MIDPOINT_CHROMA_SAMPLES_BIT</code>, <code>xChromaOffset</code> and <code>yChromaOffset</code> <strong class=\"purple\">must</strong> not be <code>VK_CHROMA_LOCATION_MIDPOINT</code> if the corresponding components are <a href=\"#textures-chroma-reconstruction\">downsampled</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerYcbcrConversionCreateInfo-components-02581",
|
|
"text": " If the format has a <code>_422</code> or <code>_420</code> suffix, then <code>components.g</code> <strong class=\"purple\">must</strong> be the <a href=\"#resources-image-views-identity-mappings\">identity swizzle</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerYcbcrConversionCreateInfo-components-02582",
|
|
"text": " If the format has a <code>_422</code> or <code>_420</code> suffix, then <code>components.a</code> <strong class=\"purple\">must</strong> be the <a href=\"#resources-image-views-identity-mappings\">identity swizzle</a>, <code>VK_COMPONENT_SWIZZLE_ONE</code>, or <code>VK_COMPONENT_SWIZZLE_ZERO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerYcbcrConversionCreateInfo-components-02583",
|
|
"text": " If the format has a <code>_422</code> or <code>_420</code> suffix, then <code>components.r</code> <strong class=\"purple\">must</strong> be the <a href=\"#resources-image-views-identity-mappings\">identity swizzle</a> or <code>VK_COMPONENT_SWIZZLE_B</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerYcbcrConversionCreateInfo-components-02584",
|
|
"text": " If the format has a <code>_422</code> or <code>_420</code> suffix, then <code>components.b</code> <strong class=\"purple\">must</strong> be the <a href=\"#resources-image-views-identity-mappings\">identity swizzle</a> or <code>VK_COMPONENT_SWIZZLE_R</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerYcbcrConversionCreateInfo-components-02585",
|
|
"text": " If the format has a <code>_422</code> or <code>_420</code> suffix, and if either <code>components.r</code> or <code>components.b</code> is the <a href=\"#resources-image-views-identity-mappings\">identity swizzle</a>, both values <strong class=\"purple\">must</strong> be the identity swizzle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerYcbcrConversionCreateInfo-ycbcrModel-01655",
|
|
"text": " If <code>ycbcrModel</code> is not <code>VK_SAMPLER_YCBCR_MODEL_CONVERSION_RGB_IDENTITY</code>, then <code>components.r</code>, <code>components.g</code>, and <code>components.b</code> <strong class=\"purple\">must</strong> correspond to components of the <code>format</code>; that is, <code>components.r</code>, <code>components.g</code>, and <code>components.b</code> <strong class=\"purple\">must</strong> not be <code>VK_COMPONENT_SWIZZLE_ZERO</code> or <code>VK_COMPONENT_SWIZZLE_ONE</code>, and <strong class=\"purple\">must</strong> not correspond to a component containing zero or one as a consequence of <a href=\"#textures-conversion-to-rgba\">conversion to RGBA</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerYcbcrConversionCreateInfo-ycbcrRange-02748",
|
|
"text": " If <code>ycbcrRange</code> is <code>VK_SAMPLER_YCBCR_RANGE_ITU_NARROW</code> then the R, G and B components obtained by applying the <code>component</code> swizzle to <code>format</code> <strong class=\"purple\">must</strong> each have a bit-depth greater than or equal to 8"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerYcbcrConversionCreateInfo-forceExplicitReconstruction-01656",
|
|
"text": " If the <a href=\"#potential-format-features\">potential format features</a> of the sampler {YCbCr} conversion do not support <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_YCBCR_CONVERSION_CHROMA_RECONSTRUCTION_EXPLICIT_FORCEABLE_BIT</code> <code>forceExplicitReconstruction</code> <strong class=\"purple\">must</strong> be <code>VK_FALSE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerYcbcrConversionCreateInfo-chromaFilter-01657",
|
|
"text": " If the <a href=\"#potential-format-features\">potential format features</a> of the sampler {YCbCr} conversion do not support <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_YCBCR_CONVERSION_LINEAR_FILTER_BIT</code>, <code>chromaFilter</code> <strong class=\"purple\">must</strong> not be <code>VK_FILTER_LINEAR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerYcbcrConversionCreateInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_SAMPLER_YCBCR_CONVERSION_CREATE_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerYcbcrConversionCreateInfo-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkExternalFormatANDROID\">VkExternalFormatANDROID</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerYcbcrConversionCreateInfo-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerYcbcrConversionCreateInfo-format-parameter",
|
|
"text": " <code>format</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkFormat\">VkFormat</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerYcbcrConversionCreateInfo-ycbcrModel-parameter",
|
|
"text": " <code>ycbcrModel</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSamplerYcbcrModelConversion\">VkSamplerYcbcrModelConversion</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerYcbcrConversionCreateInfo-ycbcrRange-parameter",
|
|
"text": " <code>ycbcrRange</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSamplerYcbcrRange\">VkSamplerYcbcrRange</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerYcbcrConversionCreateInfo-components-parameter",
|
|
"text": " <code>components</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkComponentMapping\">VkComponentMapping</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerYcbcrConversionCreateInfo-xChromaOffset-parameter",
|
|
"text": " <code>xChromaOffset</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkChromaLocation\">VkChromaLocation</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerYcbcrConversionCreateInfo-yChromaOffset-parameter",
|
|
"text": " <code>yChromaOffset</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkChromaLocation\">VkChromaLocation</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerYcbcrConversionCreateInfo-chromaFilter-parameter",
|
|
"text": " <code>chromaFilter</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkFilter\">VkFilter</a> value"
|
|
}
|
|
]
|
|
},
|
|
"vkDestroySamplerYcbcrConversion": {
|
|
"(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-vkDestroySamplerYcbcrConversion-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroySamplerYcbcrConversion-ycbcrConversion-parameter",
|
|
"text": " If <code>ycbcrConversion</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>ycbcrConversion</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSamplerYcbcrConversion\">VkSamplerYcbcrConversion</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroySamplerYcbcrConversion-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroySamplerYcbcrConversion-ycbcrConversion-parent",
|
|
"text": " If <code>ycbcrConversion</code> is a valid handle, it <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkSamplerCustomBorderColorCreateInfoEXT": {
|
|
"(VK_EXT_custom_border_color)": [
|
|
{
|
|
"vuid": "VUID-VkSamplerCustomBorderColorCreateInfoEXT-format-04013",
|
|
"text": " If provided <code>format</code> is not <code>VK_FORMAT_UNDEFINED</code> then the <a href=\"#VkSamplerCreateInfo\">VkSamplerCreateInfo</a>::<code>borderColor</code> type <strong class=\"purple\">must</strong> match the sampled type of the provided <code>format</code>, as shown in the <em>SPIR-V Sampled Type</em> column of the <a href=\"#formats-numericformat\">Interpretation of Numeric Format</a> table"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerCustomBorderColorCreateInfoEXT-format-04014",
|
|
"text": " If the <a href=\"#features-customBorderColorWithoutFormat\"><code>customBorderColorWithoutFormat</code></a> feature is not enabled then <code>format</code> <strong class=\"purple\">must</strong> not be <code>VK_FORMAT_UNDEFINED</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerCustomBorderColorCreateInfoEXT-format-04015",
|
|
"text": " If the sampler is used to sample an image view of <code>VK_FORMAT_B4G4R4A4_UNORM_PACK16</code>, <code>VK_FORMAT_B5G6R5_UNORM_PACK16</code>, or <code>VK_FORMAT_B5G5R5A1_UNORM_PACK16</code> format then <code>format</code> <strong class=\"purple\">must</strong> not be <code>VK_FORMAT_UNDEFINED</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerCustomBorderColorCreateInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_SAMPLER_CUSTOM_BORDER_COLOR_CREATE_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerCustomBorderColorCreateInfoEXT-format-parameter",
|
|
"text": " <code>format</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkFormat\">VkFormat</a> value"
|
|
}
|
|
]
|
|
},
|
|
"VkSamplerBorderColorComponentMappingCreateInfoEXT": {
|
|
"(VK_EXT_border_color_swizzle)": [
|
|
{
|
|
"vuid": "VUID-VkSamplerBorderColorComponentMappingCreateInfoEXT-borderColorSwizzle-06437",
|
|
"text": " The <a href=\"#features-borderColorSwizzle\"><code>borderColorSwizzle</code></a> feature <strong class=\"purple\">must</strong> be enabled."
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerBorderColorComponentMappingCreateInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_SAMPLER_BORDER_COLOR_COMPONENT_MAPPING_CREATE_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSamplerBorderColorComponentMappingCreateInfoEXT-components-parameter",
|
|
"text": " <code>components</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkComponentMapping\">VkComponentMapping</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"vkCreateDescriptorSetLayout": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCreateDescriptorSetLayout-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateDescriptorSetLayout-pCreateInfo-parameter",
|
|
"text": " <code>pCreateInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkDescriptorSetLayoutCreateInfo\">VkDescriptorSetLayoutCreateInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateDescriptorSetLayout-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateDescriptorSetLayout-pSetLayout-parameter",
|
|
"text": " <code>pSetLayout</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkDescriptorSetLayout\">VkDescriptorSetLayout</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkDescriptorSetLayoutCreateInfo": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetLayoutCreateInfo-binding-00279",
|
|
"text": " The <a href=\"#VkDescriptorSetLayoutBinding\">VkDescriptorSetLayoutBinding</a>::<code>binding</code> members of the elements of the <code>pBindings</code> array <strong class=\"purple\">must</strong> each have different values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetLayoutCreateInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_DESCRIPTOR_SET_LAYOUT_CREATE_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetLayoutCreateInfo-pNext-pNext",
|
|
"text": " Each <code>pNext</code> member of any structure (including this one) in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be either <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkDescriptorSetLayoutBindingFlagsCreateInfo\">VkDescriptorSetLayoutBindingFlagsCreateInfo</a> or <a href=\"#VkMutableDescriptorTypeCreateInfoVALVE\">VkMutableDescriptorTypeCreateInfoVALVE</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetLayoutCreateInfo-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetLayoutCreateInfo-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkDescriptorSetLayoutCreateFlagBits\">VkDescriptorSetLayoutCreateFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetLayoutCreateInfo-pBindings-parameter",
|
|
"text": " If <code>bindingCount</code> is not <code>0</code>, <code>pBindings</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>bindingCount</code> valid <a href=\"#VkDescriptorSetLayoutBinding\">VkDescriptorSetLayoutBinding</a> structures"
|
|
}
|
|
],
|
|
"(VK_KHR_push_descriptor)": [
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetLayoutCreateInfo-flags-00280",
|
|
"text": " If <code>flags</code> contains <code>VK_DESCRIPTOR_SET_LAYOUT_CREATE_PUSH_DESCRIPTOR_BIT_KHR</code>, then all elements of <code>pBindings</code> <strong class=\"purple\">must</strong> not have a <code>descriptorType</code> of <code>VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER_DYNAMIC</code> or <code>VK_DESCRIPTOR_TYPE_STORAGE_BUFFER_DYNAMIC</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetLayoutCreateInfo-flags-00281",
|
|
"text": " If <code>flags</code> contains <code>VK_DESCRIPTOR_SET_LAYOUT_CREATE_PUSH_DESCRIPTOR_BIT_KHR</code>, then the total number of elements of all bindings <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#VkPhysicalDevicePushDescriptorPropertiesKHR\">VkPhysicalDevicePushDescriptorPropertiesKHR</a>::<code>maxPushDescriptors</code>"
|
|
}
|
|
],
|
|
"(VK_KHR_push_descriptor)+(VK_VERSION_1_3,VK_EXT_inline_uniform_block)": [
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetLayoutCreateInfo-flags-02208",
|
|
"text": " If <code>flags</code> contains <code>VK_DESCRIPTOR_SET_LAYOUT_CREATE_PUSH_DESCRIPTOR_BIT_KHR</code>, then all elements of <code>pBindings</code> <strong class=\"purple\">must</strong> not have a <code>descriptorType</code> of <code>VK_DESCRIPTOR_TYPE_INLINE_UNIFORM_BLOCK</code>"
|
|
}
|
|
],
|
|
"(VK_KHR_push_descriptor)+(VK_VALVE_mutable_descriptor_type)": [
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetLayoutCreateInfo-flags-04590",
|
|
"text": " If <code>flags</code> contains <code>VK_DESCRIPTOR_SET_LAYOUT_CREATE_PUSH_DESCRIPTOR_BIT_KHR</code>, <code>flags</code> <strong class=\"purple\">must</strong> not contain <code>VK_DESCRIPTOR_SET_LAYOUT_CREATE_HOST_ONLY_POOL_BIT_VALVE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetLayoutCreateInfo-flags-04591",
|
|
"text": " If <code>flags</code> contains <code>VK_DESCRIPTOR_SET_LAYOUT_CREATE_PUSH_DESCRIPTOR_BIT_KHR</code>, <code>pBindings</code> <strong class=\"purple\">must</strong> not have a <code>descriptorType</code> of <code>VK_DESCRIPTOR_TYPE_MUTABLE_VALVE</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_EXT_descriptor_indexing)": [
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetLayoutCreateInfo-flags-03000",
|
|
"text": " If any binding has the <code>VK_DESCRIPTOR_BINDING_UPDATE_AFTER_BIND_BIT</code> bit set, <code>flags</code> <strong class=\"purple\">must</strong> include <code>VK_DESCRIPTOR_SET_LAYOUT_CREATE_UPDATE_AFTER_BIND_POOL_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetLayoutCreateInfo-descriptorType-03001",
|
|
"text": " If any binding has the <code>VK_DESCRIPTOR_BINDING_UPDATE_AFTER_BIND_BIT</code> bit set, then all bindings <strong class=\"purple\">must</strong> not have <code>descriptorType</code> of <code>VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER_DYNAMIC</code> or <code>VK_DESCRIPTOR_TYPE_STORAGE_BUFFER_DYNAMIC</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_EXT_descriptor_indexing)+(VK_VALVE_mutable_descriptor_type)": [
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetLayoutCreateInfo-flags-04592",
|
|
"text": " If <code>flags</code> contains <code>VK_DESCRIPTOR_SET_LAYOUT_CREATE_UPDATE_AFTER_BIND_POOL_BIT</code>, <code>flags</code> <strong class=\"purple\">must</strong> not contain <code>VK_DESCRIPTOR_SET_LAYOUT_CREATE_HOST_ONLY_POOL_BIT_VALVE</code>"
|
|
}
|
|
],
|
|
"(VK_VALVE_mutable_descriptor_type)": [
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetLayoutCreateInfo-descriptorType-04593",
|
|
"text": " If any binding has a <code>descriptorType</code> of <code>VK_DESCRIPTOR_TYPE_MUTABLE_VALVE</code>, then a <a href=\"#VkMutableDescriptorTypeCreateInfoVALVE\">VkMutableDescriptorTypeCreateInfoVALVE</a> <strong class=\"purple\">must</strong> be present in the <code>pNext</code> chain"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetLayoutCreateInfo-descriptorType-04594",
|
|
"text": " If a binding has a <code>descriptorType</code> value of <code>VK_DESCRIPTOR_TYPE_MUTABLE_VALVE</code>, then <code>pImmutableSamplers</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetLayoutCreateInfo-mutableDescriptorType-04595",
|
|
"text": " If <a href=\"#VkPhysicalDeviceMutableDescriptorTypeFeaturesVALVE\">VkPhysicalDeviceMutableDescriptorTypeFeaturesVALVE</a>::<code>mutableDescriptorType</code> is not enabled, <code>pBindings</code> <strong class=\"purple\">must</strong> not contain a <code>descriptorType</code> of <code>VK_DESCRIPTOR_TYPE_MUTABLE_VALVE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetLayoutCreateInfo-flags-04596",
|
|
"text": " If <code>flags</code> contains <code>VK_DESCRIPTOR_SET_LAYOUT_CREATE_HOST_ONLY_POOL_BIT_VALVE</code>, <a href=\"#VkPhysicalDeviceMutableDescriptorTypeFeaturesVALVE\">VkPhysicalDeviceMutableDescriptorTypeFeaturesVALVE</a>::<code>mutableDescriptorType</code> <strong class=\"purple\">must</strong> be enabled"
|
|
}
|
|
]
|
|
},
|
|
"VkMutableDescriptorTypeCreateInfoVALVE": {
|
|
"(VK_VALVE_mutable_descriptor_type)": [
|
|
{
|
|
"vuid": "VUID-VkMutableDescriptorTypeCreateInfoVALVE-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_MUTABLE_DESCRIPTOR_TYPE_CREATE_INFO_VALVE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMutableDescriptorTypeCreateInfoVALVE-pMutableDescriptorTypeLists-parameter",
|
|
"text": " If <code>mutableDescriptorTypeListCount</code> is not <code>0</code>, <code>pMutableDescriptorTypeLists</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>mutableDescriptorTypeListCount</code> valid <a href=\"#VkMutableDescriptorTypeListVALVE\">VkMutableDescriptorTypeListVALVE</a> structures"
|
|
}
|
|
]
|
|
},
|
|
"VkMutableDescriptorTypeListVALVE": {
|
|
"(VK_VALVE_mutable_descriptor_type)": [
|
|
{
|
|
"vuid": "VUID-VkMutableDescriptorTypeListVALVE-descriptorTypeCount-04597",
|
|
"text": " <code>descriptorTypeCount</code> <strong class=\"purple\">must</strong> not be <code>0</code> if the corresponding binding is of <code>VK_DESCRIPTOR_TYPE_MUTABLE_VALVE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMutableDescriptorTypeListVALVE-pDescriptorTypes-04598",
|
|
"text": " <code>pDescriptorTypes</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>descriptorTypeCount</code> valid, unique <a href=\"#VkDescriptorType\">VkDescriptorType</a> values if the given binding is of <code>VK_DESCRIPTOR_TYPE_MUTABLE_VALVE</code> type"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMutableDescriptorTypeListVALVE-descriptorTypeCount-04599",
|
|
"text": " <code>descriptorTypeCount</code> <strong class=\"purple\">must</strong> be <code>0</code> if the corresponding binding is not of <code>VK_DESCRIPTOR_TYPE_MUTABLE_VALVE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMutableDescriptorTypeListVALVE-pDescriptorTypes-04600",
|
|
"text": " <code>pDescriptorTypes</code> <strong class=\"purple\">must</strong> not contain <code>VK_DESCRIPTOR_TYPE_MUTABLE_VALVE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMutableDescriptorTypeListVALVE-pDescriptorTypes-04601",
|
|
"text": " <code>pDescriptorTypes</code> <strong class=\"purple\">must</strong> not contain <code>VK_DESCRIPTOR_TYPE_STORAGE_BUFFER_DYNAMIC</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMutableDescriptorTypeListVALVE-pDescriptorTypes-04602",
|
|
"text": " <code>pDescriptorTypes</code> <strong class=\"purple\">must</strong> not contain <code>VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER_DYNAMIC</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMutableDescriptorTypeListVALVE-pDescriptorTypes-parameter",
|
|
"text": " If <code>descriptorTypeCount</code> is not <code>0</code>, <code>pDescriptorTypes</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>descriptorTypeCount</code> valid <a href=\"#VkDescriptorType\">VkDescriptorType</a> values"
|
|
}
|
|
],
|
|
"(VK_VALVE_mutable_descriptor_type)+(VK_VERSION_1_3,VK_EXT_inline_uniform_block)": [
|
|
{
|
|
"vuid": "VUID-VkMutableDescriptorTypeListVALVE-pDescriptorTypes-04603",
|
|
"text": " <code>pDescriptorTypes</code> <strong class=\"purple\">must</strong> not contain <code>VK_DESCRIPTOR_TYPE_INLINE_UNIFORM_BLOCK</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkDescriptorSetLayoutBinding": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetLayoutBinding-descriptorType-00282",
|
|
"text": " If <code>descriptorType</code> is <code>VK_DESCRIPTOR_TYPE_SAMPLER</code> or <code>VK_DESCRIPTOR_TYPE_COMBINED_IMAGE_SAMPLER</code>, and <code>descriptorCount</code> is not <code>0</code> and <code>pImmutableSamplers</code> is not <code>NULL</code>, <code>pImmutableSamplers</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>descriptorCount</code> valid <code>VkSampler</code> handles"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetLayoutBinding-descriptorCount-00283",
|
|
"text": " If <code>descriptorCount</code> is not <code>0</code>, <code>stageFlags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkShaderStageFlagBits\">VkShaderStageFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetLayoutBinding-descriptorType-01510",
|
|
"text": " If <code>descriptorType</code> is <code>VK_DESCRIPTOR_TYPE_INPUT_ATTACHMENT</code> and <code>descriptorCount</code> is not <code>0</code>, then <code>stageFlags</code> <strong class=\"purple\">must</strong> be <code>0</code> or <code>VK_SHADER_STAGE_FRAGMENT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetLayoutBinding-descriptorType-parameter",
|
|
"text": " <code>descriptorType</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDescriptorType\">VkDescriptorType</a> value"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_inline_uniform_block)": [
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetLayoutBinding-descriptorType-04604",
|
|
"text": " If the <a href=\"#features-inlineUniformBlock\"><code>inlineUniformBlock</code></a> feature is not enabled, <code>descriptorType</code> <strong class=\"purple\">must</strong> not be <code>VK_DESCRIPTOR_TYPE_INLINE_UNIFORM_BLOCK</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetLayoutBinding-descriptorType-02209",
|
|
"text": " If <code>descriptorType</code> is <code>VK_DESCRIPTOR_TYPE_INLINE_UNIFORM_BLOCK</code> then <code>descriptorCount</code> <strong class=\"purple\">must</strong> be a multiple of <code>4</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetLayoutBinding-descriptorType-02210",
|
|
"text": " If <code>descriptorType</code> is <code>VK_DESCRIPTOR_TYPE_INLINE_UNIFORM_BLOCK</code> then <code>descriptorCount</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceInlineUniformBlockProperties</code>::<code>maxInlineUniformBlockSize</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_custom_border_color)": [
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetLayoutBinding-pImmutableSamplers-04009",
|
|
"text": " The sampler objects indicated by <code>pImmutableSamplers</code> <strong class=\"purple\">must</strong> not have a <code>borderColor</code> with one of the values <code>VK_BORDER_COLOR_FLOAT_CUSTOM_EXT</code> or <code>VK_BORDER_COLOR_INT_CUSTOM_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_VALVE_mutable_descriptor_type)": [
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetLayoutBinding-descriptorType-04605",
|
|
"text": " If <code>descriptorType</code> is <code>VK_DESCRIPTOR_TYPE_MUTABLE_VALVE</code>, then <code>pImmutableSamplers</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkDescriptorSetLayoutBindingFlagsCreateInfo": {
|
|
"(VK_VERSION_1_2,VK_EXT_descriptor_indexing)": [
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetLayoutBindingFlagsCreateInfo-bindingCount-03002",
|
|
"text": " If <code>bindingCount</code> is not zero, <code>bindingCount</code> <strong class=\"purple\">must</strong> equal <a href=\"#VkDescriptorSetLayoutCreateInfo\">VkDescriptorSetLayoutCreateInfo</a>::<code>bindingCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetLayoutBindingFlagsCreateInfo-pBindingFlags-03004",
|
|
"text": " If an element of <code>pBindingFlags</code> includes <code>VK_DESCRIPTOR_BINDING_VARIABLE_DESCRIPTOR_COUNT_BIT</code>, then all other elements of <a href=\"#VkDescriptorSetLayoutCreateInfo\">VkDescriptorSetLayoutCreateInfo</a>::<code>pBindings</code> <strong class=\"purple\">must</strong> have a smaller value of <code>binding</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetLayoutBindingFlagsCreateInfo-descriptorBindingUniformBufferUpdateAfterBind-03005",
|
|
"text": " If <a href=\"#VkPhysicalDeviceDescriptorIndexingFeatures\">VkPhysicalDeviceDescriptorIndexingFeatures</a>::<code>descriptorBindingUniformBufferUpdateAfterBind</code> is not enabled, all bindings with descriptor type <code>VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER</code> <strong class=\"purple\">must</strong> not use <code>VK_DESCRIPTOR_BINDING_UPDATE_AFTER_BIND_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetLayoutBindingFlagsCreateInfo-descriptorBindingSampledImageUpdateAfterBind-03006",
|
|
"text": " If <a href=\"#VkPhysicalDeviceDescriptorIndexingFeatures\">VkPhysicalDeviceDescriptorIndexingFeatures</a>::<code>descriptorBindingSampledImageUpdateAfterBind</code> is not enabled, all bindings with descriptor type <code>VK_DESCRIPTOR_TYPE_SAMPLER</code>, <code>VK_DESCRIPTOR_TYPE_COMBINED_IMAGE_SAMPLER</code>, or <code>VK_DESCRIPTOR_TYPE_SAMPLED_IMAGE</code> <strong class=\"purple\">must</strong> not use <code>VK_DESCRIPTOR_BINDING_UPDATE_AFTER_BIND_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetLayoutBindingFlagsCreateInfo-descriptorBindingStorageImageUpdateAfterBind-03007",
|
|
"text": " If <a href=\"#VkPhysicalDeviceDescriptorIndexingFeatures\">VkPhysicalDeviceDescriptorIndexingFeatures</a>::<code>descriptorBindingStorageImageUpdateAfterBind</code> is not enabled, all bindings with descriptor type <code>VK_DESCRIPTOR_TYPE_STORAGE_IMAGE</code> <strong class=\"purple\">must</strong> not use <code>VK_DESCRIPTOR_BINDING_UPDATE_AFTER_BIND_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetLayoutBindingFlagsCreateInfo-descriptorBindingStorageBufferUpdateAfterBind-03008",
|
|
"text": " If <a href=\"#VkPhysicalDeviceDescriptorIndexingFeatures\">VkPhysicalDeviceDescriptorIndexingFeatures</a>::<code>descriptorBindingStorageBufferUpdateAfterBind</code> is not enabled, all bindings with descriptor type <code>VK_DESCRIPTOR_TYPE_STORAGE_BUFFER</code> <strong class=\"purple\">must</strong> not use <code>VK_DESCRIPTOR_BINDING_UPDATE_AFTER_BIND_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetLayoutBindingFlagsCreateInfo-descriptorBindingUniformTexelBufferUpdateAfterBind-03009",
|
|
"text": " If <a href=\"#VkPhysicalDeviceDescriptorIndexingFeatures\">VkPhysicalDeviceDescriptorIndexingFeatures</a>::<code>descriptorBindingUniformTexelBufferUpdateAfterBind</code> is not enabled, all bindings with descriptor type <code>VK_DESCRIPTOR_TYPE_UNIFORM_TEXEL_BUFFER</code> <strong class=\"purple\">must</strong> not use <code>VK_DESCRIPTOR_BINDING_UPDATE_AFTER_BIND_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetLayoutBindingFlagsCreateInfo-descriptorBindingStorageTexelBufferUpdateAfterBind-03010",
|
|
"text": " If <a href=\"#VkPhysicalDeviceDescriptorIndexingFeatures\">VkPhysicalDeviceDescriptorIndexingFeatures</a>::<code>descriptorBindingStorageTexelBufferUpdateAfterBind</code> is not enabled, all bindings with descriptor type <code>VK_DESCRIPTOR_TYPE_STORAGE_TEXEL_BUFFER</code> <strong class=\"purple\">must</strong> not use <code>VK_DESCRIPTOR_BINDING_UPDATE_AFTER_BIND_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetLayoutBindingFlagsCreateInfo-None-03011",
|
|
"text": " All bindings with descriptor type <code>VK_DESCRIPTOR_TYPE_INPUT_ATTACHMENT</code>, <code>VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER_DYNAMIC</code>, or <code>VK_DESCRIPTOR_TYPE_STORAGE_BUFFER_DYNAMIC</code> <strong class=\"purple\">must</strong> not use <code>VK_DESCRIPTOR_BINDING_UPDATE_AFTER_BIND_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetLayoutBindingFlagsCreateInfo-descriptorBindingUpdateUnusedWhilePending-03012",
|
|
"text": " If <a href=\"#VkPhysicalDeviceDescriptorIndexingFeatures\">VkPhysicalDeviceDescriptorIndexingFeatures</a>::<code>descriptorBindingUpdateUnusedWhilePending</code> is not enabled, all elements of <code>pBindingFlags</code> <strong class=\"purple\">must</strong> not include <code>VK_DESCRIPTOR_BINDING_UPDATE_UNUSED_WHILE_PENDING_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetLayoutBindingFlagsCreateInfo-descriptorBindingPartiallyBound-03013",
|
|
"text": " If <a href=\"#VkPhysicalDeviceDescriptorIndexingFeatures\">VkPhysicalDeviceDescriptorIndexingFeatures</a>::<code>descriptorBindingPartiallyBound</code> is not enabled, all elements of <code>pBindingFlags</code> <strong class=\"purple\">must</strong> not include <code>VK_DESCRIPTOR_BINDING_PARTIALLY_BOUND_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetLayoutBindingFlagsCreateInfo-descriptorBindingVariableDescriptorCount-03014",
|
|
"text": " If <a href=\"#VkPhysicalDeviceDescriptorIndexingFeatures\">VkPhysicalDeviceDescriptorIndexingFeatures</a>::<code>descriptorBindingVariableDescriptorCount</code> is not enabled, all elements of <code>pBindingFlags</code> <strong class=\"purple\">must</strong> not include <code>VK_DESCRIPTOR_BINDING_VARIABLE_DESCRIPTOR_COUNT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetLayoutBindingFlagsCreateInfo-pBindingFlags-03015",
|
|
"text": " If an element of <code>pBindingFlags</code> includes <code>VK_DESCRIPTOR_BINDING_VARIABLE_DESCRIPTOR_COUNT_BIT</code>, that element’s <code>descriptorType</code> <strong class=\"purple\">must</strong> not be <code>VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER_DYNAMIC</code> or <code>VK_DESCRIPTOR_TYPE_STORAGE_BUFFER_DYNAMIC</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetLayoutBindingFlagsCreateInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_DESCRIPTOR_SET_LAYOUT_BINDING_FLAGS_CREATE_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetLayoutBindingFlagsCreateInfo-pBindingFlags-parameter",
|
|
"text": " If <code>bindingCount</code> is not <code>0</code>, <code>pBindingFlags</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>bindingCount</code> valid combinations of <a href=\"#VkDescriptorBindingFlagBits\">VkDescriptorBindingFlagBits</a> values"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_EXT_descriptor_indexing)+(VK_KHR_push_descriptor)": [
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetLayoutBindingFlagsCreateInfo-flags-03003",
|
|
"text": " If <a href=\"#VkDescriptorSetLayoutCreateInfo\">VkDescriptorSetLayoutCreateInfo</a>::<code>flags</code> includes <code>VK_DESCRIPTOR_SET_LAYOUT_CREATE_PUSH_DESCRIPTOR_BIT_KHR</code>, then all elements of <code>pBindingFlags</code> <strong class=\"purple\">must</strong> not include <code>VK_DESCRIPTOR_BINDING_UPDATE_AFTER_BIND_BIT</code>, <code>VK_DESCRIPTOR_BINDING_UPDATE_UNUSED_WHILE_PENDING_BIT</code>, or <code>VK_DESCRIPTOR_BINDING_VARIABLE_DESCRIPTOR_COUNT_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_EXT_descriptor_indexing)+(VK_VERSION_1_3,VK_EXT_inline_uniform_block)": [
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetLayoutBindingFlagsCreateInfo-descriptorBindingInlineUniformBlockUpdateAfterBind-02211",
|
|
"text": " If <a href=\"#VkPhysicalDeviceInlineUniformBlockFeatures\">VkPhysicalDeviceInlineUniformBlockFeatures</a>::<code>descriptorBindingInlineUniformBlockUpdateAfterBind</code> is not enabled, all bindings with descriptor type <code>VK_DESCRIPTOR_TYPE_INLINE_UNIFORM_BLOCK</code> <strong class=\"purple\">must</strong> not use <code>VK_DESCRIPTOR_BINDING_UPDATE_AFTER_BIND_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_EXT_descriptor_indexing)+(VK_KHR_acceleration_structure)": [
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetLayoutBindingFlagsCreateInfo-descriptorBindingAccelerationStructureUpdateAfterBind-03570",
|
|
"text": " If <a href=\"#VkPhysicalDeviceAccelerationStructureFeaturesKHR\">VkPhysicalDeviceAccelerationStructureFeaturesKHR</a>::<code>descriptorBindingAccelerationStructureUpdateAfterBind</code> is not enabled, all bindings with descriptor type <code>VK_DESCRIPTOR_TYPE_ACCELERATION_STRUCTURE_KHR</code> or <code>VK_DESCRIPTOR_TYPE_ACCELERATION_STRUCTURE_NV</code> <strong class=\"purple\">must</strong> not use <code>VK_DESCRIPTOR_BINDING_UPDATE_AFTER_BIND_BIT</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetDescriptorSetLayoutSupport": {
|
|
"(VK_VERSION_1_1,VK_KHR_maintenance3)": [
|
|
{
|
|
"vuid": "VUID-vkGetDescriptorSetLayoutSupport-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDescriptorSetLayoutSupport-pCreateInfo-parameter",
|
|
"text": " <code>pCreateInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkDescriptorSetLayoutCreateInfo\">VkDescriptorSetLayoutCreateInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDescriptorSetLayoutSupport-pSupport-parameter",
|
|
"text": " <code>pSupport</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkDescriptorSetLayoutSupport\">VkDescriptorSetLayoutSupport</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkDescriptorSetLayoutSupport": {
|
|
"(VK_VERSION_1_1,VK_KHR_maintenance3)": [
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetLayoutSupport-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_DESCRIPTOR_SET_LAYOUT_SUPPORT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetLayoutSupport-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkDescriptorSetVariableDescriptorCountLayoutSupport\">VkDescriptorSetVariableDescriptorCountLayoutSupport</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetLayoutSupport-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
}
|
|
]
|
|
},
|
|
"VkDescriptorSetVariableDescriptorCountLayoutSupport": {
|
|
"(VK_VERSION_1_2,VK_EXT_descriptor_indexing)": [
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetVariableDescriptorCountLayoutSupport-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_DESCRIPTOR_SET_VARIABLE_DESCRIPTOR_COUNT_LAYOUT_SUPPORT</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkDestroyDescriptorSetLayout": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkDestroyDescriptorSetLayout-descriptorSetLayout-00284",
|
|
"text": " If <code>VkAllocationCallbacks</code> were provided when <code>descriptorSetLayout</code> was created, a compatible set of callbacks <strong class=\"purple\">must</strong> be provided here"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyDescriptorSetLayout-descriptorSetLayout-00285",
|
|
"text": " If no <code>VkAllocationCallbacks</code> were provided when <code>descriptorSetLayout</code> was created, <code>pAllocator</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyDescriptorSetLayout-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyDescriptorSetLayout-descriptorSetLayout-parameter",
|
|
"text": " If <code>descriptorSetLayout</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>descriptorSetLayout</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDescriptorSetLayout\">VkDescriptorSetLayout</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyDescriptorSetLayout-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyDescriptorSetLayout-descriptorSetLayout-parent",
|
|
"text": " If <code>descriptorSetLayout</code> is a valid handle, it <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCreatePipelineLayout": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCreatePipelineLayout-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreatePipelineLayout-pCreateInfo-parameter",
|
|
"text": " <code>pCreateInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkPipelineLayoutCreateInfo\">VkPipelineLayoutCreateInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreatePipelineLayout-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreatePipelineLayout-pPipelineLayout-parameter",
|
|
"text": " <code>pPipelineLayout</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkPipelineLayout\">VkPipelineLayout</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkPipelineLayoutCreateInfo": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-setLayoutCount-00286",
|
|
"text": " <code>setLayoutCount</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxBoundDescriptorSets</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-pPushConstantRanges-00292",
|
|
"text": " Any two elements of <code>pPushConstantRanges</code> <strong class=\"purple\">must</strong> not include the same stage in <code>stageFlags</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PIPELINE_LAYOUT_CREATE_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkPipelineLayoutCreateFlagBits\">VkPipelineLayoutCreateFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-pSetLayouts-parameter",
|
|
"text": " If <code>setLayoutCount</code> is not <code>0</code>, <code>pSetLayouts</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>setLayoutCount</code> valid or <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> <a href=\"#VkDescriptorSetLayout\">VkDescriptorSetLayout</a> handles"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-pPushConstantRanges-parameter",
|
|
"text": " If <code>pushConstantRangeCount</code> is not <code>0</code>, <code>pPushConstantRanges</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>pushConstantRangeCount</code> valid <a href=\"#VkPushConstantRange\">VkPushConstantRange</a> structures"
|
|
}
|
|
],
|
|
"!(VK_VERSION_1_2,VK_EXT_descriptor_indexing)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-pSetLayouts-00287",
|
|
"text": " The total number of descriptors of the type <code>VK_DESCRIPTOR_TYPE_SAMPLER</code> and <code>VK_DESCRIPTOR_TYPE_COMBINED_IMAGE_SAMPLER</code> accessible to any shader stage across all elements of <code>pSetLayouts</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxPerStageDescriptorSamplers</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-pSetLayouts-00288",
|
|
"text": " The total number of descriptors of the type <code>VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER</code> and <code>VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER_DYNAMIC</code> accessible to any shader stage across all elements of <code>pSetLayouts</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxPerStageDescriptorUniformBuffers</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-pSetLayouts-00289",
|
|
"text": " The total number of descriptors of the type <code>VK_DESCRIPTOR_TYPE_STORAGE_BUFFER</code> and <code>VK_DESCRIPTOR_TYPE_STORAGE_BUFFER_DYNAMIC</code> accessible to any shader stage across all elements of <code>pSetLayouts</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxPerStageDescriptorStorageBuffers</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-pSetLayouts-00291",
|
|
"text": " The total number of descriptors of the type <code>VK_DESCRIPTOR_TYPE_STORAGE_IMAGE</code>, and <code>VK_DESCRIPTOR_TYPE_STORAGE_TEXEL_BUFFER</code> accessible to any shader stage across all elements of <code>pSetLayouts</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxPerStageDescriptorStorageImages</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-pSetLayouts-01676",
|
|
"text": " The total number of descriptors of the type <code>VK_DESCRIPTOR_TYPE_INPUT_ATTACHMENT</code> accessible to any given shader stage across all elements of <code>pSetLayouts</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxPerStageDescriptorInputAttachments</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-pSetLayouts-01677",
|
|
"text": " The total number of descriptors of the type <code>VK_DESCRIPTOR_TYPE_SAMPLER</code> and <code>VK_DESCRIPTOR_TYPE_COMBINED_IMAGE_SAMPLER</code> accessible across all shader stages and across all elements of <code>pSetLayouts</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxDescriptorSetSamplers</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-pSetLayouts-01678",
|
|
"text": " The total number of descriptors of the type <code>VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER</code> accessible across all shader stages and across all elements of <code>pSetLayouts</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxDescriptorSetUniformBuffers</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-pSetLayouts-01679",
|
|
"text": " The total number of descriptors of the type <code>VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER_DYNAMIC</code> accessible across all shader stages and across all elements of <code>pSetLayouts</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxDescriptorSetUniformBuffersDynamic</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-pSetLayouts-01680",
|
|
"text": " The total number of descriptors of the type <code>VK_DESCRIPTOR_TYPE_STORAGE_BUFFER</code> accessible across all shader stages and across all elements of <code>pSetLayouts</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxDescriptorSetStorageBuffers</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-pSetLayouts-01681",
|
|
"text": " The total number of descriptors of the type <code>VK_DESCRIPTOR_TYPE_STORAGE_BUFFER_DYNAMIC</code> accessible across all shader stages and across all elements of <code>pSetLayouts</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxDescriptorSetStorageBuffersDynamic</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-pSetLayouts-01682",
|
|
"text": " The total number of descriptors of the type <code>VK_DESCRIPTOR_TYPE_COMBINED_IMAGE_SAMPLER</code>, <code>VK_DESCRIPTOR_TYPE_SAMPLED_IMAGE</code>, and <code>VK_DESCRIPTOR_TYPE_UNIFORM_TEXEL_BUFFER</code> accessible across all shader stages and across all elements of <code>pSetLayouts</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxDescriptorSetSampledImages</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-pSetLayouts-01683",
|
|
"text": " The total number of descriptors of the type <code>VK_DESCRIPTOR_TYPE_STORAGE_IMAGE</code>, and <code>VK_DESCRIPTOR_TYPE_STORAGE_TEXEL_BUFFER</code> accessible across all shader stages and across all elements of <code>pSetLayouts</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxDescriptorSetStorageImages</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-pSetLayouts-01684",
|
|
"text": " The total number of descriptors of the type <code>VK_DESCRIPTOR_TYPE_INPUT_ATTACHMENT</code> accessible across all shader stages and across all elements of <code>pSetLayouts</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxDescriptorSetInputAttachments</code>"
|
|
}
|
|
],
|
|
"!(VK_VERSION_1_2,VK_EXT_descriptor_indexing)+!(VK_QCOM_image_processing)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-pSetLayouts-00290",
|
|
"text": " The total number of descriptors of the type <code>VK_DESCRIPTOR_TYPE_COMBINED_IMAGE_SAMPLER</code>, <code>VK_DESCRIPTOR_TYPE_SAMPLED_IMAGE</code>, and <code>VK_DESCRIPTOR_TYPE_UNIFORM_TEXEL_BUFFER</code> accessible to any shader stage across all elements of <code>pSetLayouts</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxPerStageDescriptorSampledImages</code>"
|
|
}
|
|
],
|
|
"!(VK_VERSION_1_2,VK_EXT_descriptor_indexing)+(VK_QCOM_image_processing)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-pSetLayouts-06938",
|
|
"text": " The total number of descriptors of the type <code>VK_DESCRIPTOR_TYPE_COMBINED_IMAGE_SAMPLER</code>, <code>VK_DESCRIPTOR_TYPE_SAMPLED_IMAGE</code>, <code>VK_DESCRIPTOR_TYPE_UNIFORM_TEXEL_BUFFER</code>, <code>VK_DESCRIPTOR_TYPE_SAMPLE_WEIGHT_IMAGE_QCOM</code>, and <code>VK_DESCRIPTOR_TYPE_BLOCK_MATCH_IMAGE_QCOM</code>, accessible to any shader stage across all elements of <code>pSetLayouts</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxPerStageDescriptorSampledImages</code>"
|
|
}
|
|
],
|
|
"!(VK_VERSION_1_2,VK_EXT_descriptor_indexing)+(VK_VERSION_1_3,VK_EXT_inline_uniform_block)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-descriptorType-02212",
|
|
"text": " The total number of bindings with a <code>descriptorType</code> of <code>VK_DESCRIPTOR_TYPE_INLINE_UNIFORM_BLOCK</code> accessible to any given shader stage across all elements of <code>pSetLayouts</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceInlineUniformBlockProperties</code>::<code>maxPerStageDescriptorInlineUniformBlocks</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-descriptorType-02213",
|
|
"text": " The total number of bindings with a <code>descriptorType</code> of <code>VK_DESCRIPTOR_TYPE_INLINE_UNIFORM_BLOCK</code> accessible across all shader stages and across all elements of <code>pSetLayouts</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceInlineUniformBlockProperties</code>::<code>maxDescriptorSetInlineUniformBlocks</code>"
|
|
}
|
|
],
|
|
"!(VK_VERSION_1_2,VK_EXT_descriptor_indexing)+(VK_VERSION_1_3)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-descriptorType-06531",
|
|
"text": " The total number of descriptors with a <code>descriptorType</code> of <code>VK_DESCRIPTOR_TYPE_INLINE_UNIFORM_BLOCK</code> accessible across all shader stages and across all elements of <code>pSetLayouts</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceVulkan13Properties</code>::<code>maxInlineUniformTotalSize</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_EXT_descriptor_indexing)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-descriptorType-03016",
|
|
"text": " The total number of descriptors in descriptor set layouts created without the <code>VK_DESCRIPTOR_SET_LAYOUT_CREATE_UPDATE_AFTER_BIND_POOL_BIT</code> bit set with a <code>descriptorType</code> of <code>VK_DESCRIPTOR_TYPE_SAMPLER</code> and <code>VK_DESCRIPTOR_TYPE_COMBINED_IMAGE_SAMPLER</code> accessible to any given shader stage across all elements of <code>pSetLayouts</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxPerStageDescriptorSamplers</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-descriptorType-03017",
|
|
"text": " The total number of descriptors in descriptor set layouts created without the <code>VK_DESCRIPTOR_SET_LAYOUT_CREATE_UPDATE_AFTER_BIND_POOL_BIT</code> bit set with a <code>descriptorType</code> of <code>VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER</code> and <code>VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER_DYNAMIC</code> accessible to any given shader stage across all elements of <code>pSetLayouts</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxPerStageDescriptorUniformBuffers</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-descriptorType-03018",
|
|
"text": " The total number of descriptors in descriptor set layouts created without the <code>VK_DESCRIPTOR_SET_LAYOUT_CREATE_UPDATE_AFTER_BIND_POOL_BIT</code> bit set with a <code>descriptorType</code> of <code>VK_DESCRIPTOR_TYPE_STORAGE_BUFFER</code> and <code>VK_DESCRIPTOR_TYPE_STORAGE_BUFFER_DYNAMIC</code> accessible to any given shader stage across all elements of <code>pSetLayouts</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxPerStageDescriptorStorageBuffers</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-descriptorType-03020",
|
|
"text": " The total number of descriptors in descriptor set layouts created without the <code>VK_DESCRIPTOR_SET_LAYOUT_CREATE_UPDATE_AFTER_BIND_POOL_BIT</code> bit set with a <code>descriptorType</code> of <code>VK_DESCRIPTOR_TYPE_STORAGE_IMAGE</code>, and <code>VK_DESCRIPTOR_TYPE_STORAGE_TEXEL_BUFFER</code> accessible to any given shader stage across all elements of <code>pSetLayouts</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxPerStageDescriptorStorageImages</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-descriptorType-03021",
|
|
"text": " The total number of descriptors in descriptor set layouts created without the <code>VK_DESCRIPTOR_SET_LAYOUT_CREATE_UPDATE_AFTER_BIND_POOL_BIT</code> bit set with a <code>descriptorType</code> of <code>VK_DESCRIPTOR_TYPE_INPUT_ATTACHMENT</code> accessible to any given shader stage across all elements of <code>pSetLayouts</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxPerStageDescriptorInputAttachments</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-descriptorType-03022",
|
|
"text": " The total number of descriptors with a <code>descriptorType</code> of <code>VK_DESCRIPTOR_TYPE_SAMPLER</code> and <code>VK_DESCRIPTOR_TYPE_COMBINED_IMAGE_SAMPLER</code> accessible to any given shader stage across all elements of <code>pSetLayouts</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceDescriptorIndexingProperties</code>::<code>maxPerStageDescriptorUpdateAfterBindSamplers</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-descriptorType-03023",
|
|
"text": " The total number of descriptors with a <code>descriptorType</code> of <code>VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER</code> and <code>VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER_DYNAMIC</code> accessible to any given shader stage across all elements of <code>pSetLayouts</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceDescriptorIndexingProperties</code>::<code>maxPerStageDescriptorUpdateAfterBindUniformBuffers</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-descriptorType-03024",
|
|
"text": " The total number of descriptors with a <code>descriptorType</code> of <code>VK_DESCRIPTOR_TYPE_STORAGE_BUFFER</code> and <code>VK_DESCRIPTOR_TYPE_STORAGE_BUFFER_DYNAMIC</code> accessible to any given shader stage across all elements of <code>pSetLayouts</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceDescriptorIndexingProperties</code>::<code>maxPerStageDescriptorUpdateAfterBindStorageBuffers</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-descriptorType-03025",
|
|
"text": " The total number of descriptors with a <code>descriptorType</code> of <code>VK_DESCRIPTOR_TYPE_COMBINED_IMAGE_SAMPLER</code>, <code>VK_DESCRIPTOR_TYPE_SAMPLED_IMAGE</code>, and <code>VK_DESCRIPTOR_TYPE_UNIFORM_TEXEL_BUFFER</code> accessible to any given shader stage across all elements of <code>pSetLayouts</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceDescriptorIndexingProperties</code>::<code>maxPerStageDescriptorUpdateAfterBindSampledImages</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-descriptorType-03026",
|
|
"text": " The total number of descriptors with a <code>descriptorType</code> of <code>VK_DESCRIPTOR_TYPE_STORAGE_IMAGE</code>, and <code>VK_DESCRIPTOR_TYPE_STORAGE_TEXEL_BUFFER</code> accessible to any given shader stage across all elements of <code>pSetLayouts</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceDescriptorIndexingProperties</code>::<code>maxPerStageDescriptorUpdateAfterBindStorageImages</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-descriptorType-03027",
|
|
"text": " The total number of descriptors with a <code>descriptorType</code> of <code>VK_DESCRIPTOR_TYPE_INPUT_ATTACHMENT</code> accessible to any given shader stage across all elements of <code>pSetLayouts</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceDescriptorIndexingProperties</code>::<code>maxPerStageDescriptorUpdateAfterBindInputAttachments</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-descriptorType-03028",
|
|
"text": " The total number of descriptors in descriptor set layouts created without the <code>VK_DESCRIPTOR_SET_LAYOUT_CREATE_UPDATE_AFTER_BIND_POOL_BIT</code> bit set with a <code>descriptorType</code> of <code>VK_DESCRIPTOR_TYPE_SAMPLER</code> and <code>VK_DESCRIPTOR_TYPE_COMBINED_IMAGE_SAMPLER</code> accessible across all shader stages and across all elements of <code>pSetLayouts</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxDescriptorSetSamplers</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-descriptorType-03029",
|
|
"text": " The total number of descriptors in descriptor set layouts created without the <code>VK_DESCRIPTOR_SET_LAYOUT_CREATE_UPDATE_AFTER_BIND_POOL_BIT</code> bit set with a <code>descriptorType</code> of <code>VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER</code> accessible across all shader stages and across all elements of <code>pSetLayouts</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxDescriptorSetUniformBuffers</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-descriptorType-03030",
|
|
"text": " The total number of descriptors in descriptor set layouts created without the <code>VK_DESCRIPTOR_SET_LAYOUT_CREATE_UPDATE_AFTER_BIND_POOL_BIT</code> bit set with a <code>descriptorType</code> of <code>VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER_DYNAMIC</code> accessible across all shader stages and across all elements of <code>pSetLayouts</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxDescriptorSetUniformBuffersDynamic</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-descriptorType-03031",
|
|
"text": " The total number of descriptors in descriptor set layouts created without the <code>VK_DESCRIPTOR_SET_LAYOUT_CREATE_UPDATE_AFTER_BIND_POOL_BIT</code> bit set with a <code>descriptorType</code> of <code>VK_DESCRIPTOR_TYPE_STORAGE_BUFFER</code> accessible across all shader stages and across all elements of <code>pSetLayouts</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxDescriptorSetStorageBuffers</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-descriptorType-03032",
|
|
"text": " The total number of descriptors in descriptor set layouts created without the <code>VK_DESCRIPTOR_SET_LAYOUT_CREATE_UPDATE_AFTER_BIND_POOL_BIT</code> bit set with a <code>descriptorType</code> of <code>VK_DESCRIPTOR_TYPE_STORAGE_BUFFER_DYNAMIC</code> accessible across all shader stages and across all elements of <code>pSetLayouts</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxDescriptorSetStorageBuffersDynamic</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-descriptorType-03033",
|
|
"text": " The total number of descriptors in descriptor set layouts created without the <code>VK_DESCRIPTOR_SET_LAYOUT_CREATE_UPDATE_AFTER_BIND_POOL_BIT</code> bit set with a <code>descriptorType</code> of <code>VK_DESCRIPTOR_TYPE_COMBINED_IMAGE_SAMPLER</code>, <code>VK_DESCRIPTOR_TYPE_SAMPLED_IMAGE</code>, and <code>VK_DESCRIPTOR_TYPE_UNIFORM_TEXEL_BUFFER</code> accessible across all shader stages and across all elements of <code>pSetLayouts</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxDescriptorSetSampledImages</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-descriptorType-03034",
|
|
"text": " The total number of descriptors in descriptor set layouts created without the <code>VK_DESCRIPTOR_SET_LAYOUT_CREATE_UPDATE_AFTER_BIND_POOL_BIT</code> bit set with a <code>descriptorType</code> of <code>VK_DESCRIPTOR_TYPE_STORAGE_IMAGE</code>, and <code>VK_DESCRIPTOR_TYPE_STORAGE_TEXEL_BUFFER</code> accessible across all shader stages and across all elements of <code>pSetLayouts</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxDescriptorSetStorageImages</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-descriptorType-03035",
|
|
"text": " The total number of descriptors in descriptor set layouts created without the <code>VK_DESCRIPTOR_SET_LAYOUT_CREATE_UPDATE_AFTER_BIND_POOL_BIT</code> bit set with a <code>descriptorType</code> of <code>VK_DESCRIPTOR_TYPE_INPUT_ATTACHMENT</code> accessible across all shader stages and across all elements of <code>pSetLayouts</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxDescriptorSetInputAttachments</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-pSetLayouts-03036",
|
|
"text": " The total number of descriptors of the type <code>VK_DESCRIPTOR_TYPE_SAMPLER</code> and <code>VK_DESCRIPTOR_TYPE_COMBINED_IMAGE_SAMPLER</code> accessible across all shader stages and across all elements of <code>pSetLayouts</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceDescriptorIndexingProperties</code>::<code>maxDescriptorSetUpdateAfterBindSamplers</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-pSetLayouts-03037",
|
|
"text": " The total number of descriptors of the type <code>VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER</code> accessible across all shader stages and across all elements of <code>pSetLayouts</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceDescriptorIndexingProperties</code>::<code>maxDescriptorSetUpdateAfterBindUniformBuffers</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-pSetLayouts-03038",
|
|
"text": " The total number of descriptors of the type <code>VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER_DYNAMIC</code> accessible across all shader stages and across all elements of <code>pSetLayouts</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceDescriptorIndexingProperties</code>::<code>maxDescriptorSetUpdateAfterBindUniformBuffersDynamic</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-pSetLayouts-03039",
|
|
"text": " The total number of descriptors of the type <code>VK_DESCRIPTOR_TYPE_STORAGE_BUFFER</code> accessible across all shader stages and across all elements of <code>pSetLayouts</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceDescriptorIndexingProperties</code>::<code>maxDescriptorSetUpdateAfterBindStorageBuffers</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-pSetLayouts-03040",
|
|
"text": " The total number of descriptors of the type <code>VK_DESCRIPTOR_TYPE_STORAGE_BUFFER_DYNAMIC</code> accessible across all shader stages and across all elements of <code>pSetLayouts</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceDescriptorIndexingProperties</code>::<code>maxDescriptorSetUpdateAfterBindStorageBuffersDynamic</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-pSetLayouts-03041",
|
|
"text": " The total number of descriptors of the type <code>VK_DESCRIPTOR_TYPE_COMBINED_IMAGE_SAMPLER</code>, <code>VK_DESCRIPTOR_TYPE_SAMPLED_IMAGE</code>, and <code>VK_DESCRIPTOR_TYPE_UNIFORM_TEXEL_BUFFER</code> accessible across all shader stages and across all elements of <code>pSetLayouts</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceDescriptorIndexingProperties</code>::<code>maxDescriptorSetUpdateAfterBindSampledImages</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-pSetLayouts-03042",
|
|
"text": " The total number of descriptors of the type <code>VK_DESCRIPTOR_TYPE_STORAGE_IMAGE</code>, and <code>VK_DESCRIPTOR_TYPE_STORAGE_TEXEL_BUFFER</code> accessible across all shader stages and across all elements of <code>pSetLayouts</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceDescriptorIndexingProperties</code>::<code>maxDescriptorSetUpdateAfterBindStorageImages</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-pSetLayouts-03043",
|
|
"text": " The total number of descriptors of the type <code>VK_DESCRIPTOR_TYPE_INPUT_ATTACHMENT</code> accessible across all shader stages and across all elements of <code>pSetLayouts</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceDescriptorIndexingProperties</code>::<code>maxDescriptorSetUpdateAfterBindInputAttachments</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_EXT_descriptor_indexing)+!(VK_QCOM_image_processing)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-descriptorType-03019",
|
|
"text": " The total number of descriptors in descriptor set layouts created without the <code>VK_DESCRIPTOR_SET_LAYOUT_CREATE_UPDATE_AFTER_BIND_POOL_BIT</code> bit set with a <code>descriptorType</code> of <code>VK_DESCRIPTOR_TYPE_COMBINED_IMAGE_SAMPLER</code>, <code>VK_DESCRIPTOR_TYPE_SAMPLED_IMAGE</code>, and <code>VK_DESCRIPTOR_TYPE_UNIFORM_TEXEL_BUFFER</code> accessible to any given shader stage across all elements of <code>pSetLayouts</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxPerStageDescriptorSampledImages</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_EXT_descriptor_indexing)+(VK_QCOM_image_processing)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-descriptorType-06939",
|
|
"text": " The total number of descriptors in descriptor set layouts created without the <code>VK_DESCRIPTOR_SET_LAYOUT_CREATE_UPDATE_AFTER_BIND_POOL_BIT</code> bit set with a <code>descriptorType</code> of <code>VK_DESCRIPTOR_TYPE_COMBINED_IMAGE_SAMPLER</code>, <code>VK_DESCRIPTOR_TYPE_SAMPLED_IMAGE</code>, <code>VK_DESCRIPTOR_TYPE_UNIFORM_TEXEL_BUFFER</code>, <code>VK_DESCRIPTOR_TYPE_SAMPLE_WEIGHT_IMAGE_QCOM</code>, and <code>VK_DESCRIPTOR_TYPE_BLOCK_MATCH_IMAGE_QCOM</code> accessible to any given shader stage across all elements of <code>pSetLayouts</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxPerStageDescriptorSampledImages</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_EXT_descriptor_indexing)+(VK_VERSION_1_3,VK_EXT_inline_uniform_block)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-descriptorType-02214",
|
|
"text": " The total number of bindings in descriptor set layouts created without the <code>VK_DESCRIPTOR_SET_LAYOUT_CREATE_UPDATE_AFTER_BIND_POOL_BIT</code> bit set with a <code>descriptorType</code> of <code>VK_DESCRIPTOR_TYPE_INLINE_UNIFORM_BLOCK</code> accessible to any given shader stage across all elements of <code>pSetLayouts</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceInlineUniformBlockProperties</code>::<code>maxPerStageDescriptorInlineUniformBlocks</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-descriptorType-02215",
|
|
"text": " The total number of bindings with a <code>descriptorType</code> of <code>VK_DESCRIPTOR_TYPE_INLINE_UNIFORM_BLOCK</code> accessible to any given shader stage across all elements of <code>pSetLayouts</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceInlineUniformBlockProperties</code>::<code>maxPerStageDescriptorUpdateAfterBindInlineUniformBlocks</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-descriptorType-02216",
|
|
"text": " The total number of bindings in descriptor set layouts created without the <code>VK_DESCRIPTOR_SET_LAYOUT_CREATE_UPDATE_AFTER_BIND_POOL_BIT</code> bit set with a <code>descriptorType</code> of <code>VK_DESCRIPTOR_TYPE_INLINE_UNIFORM_BLOCK</code> accessible across all shader stages and across all elements of <code>pSetLayouts</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceInlineUniformBlockProperties</code>::<code>maxDescriptorSetInlineUniformBlocks</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-descriptorType-02217",
|
|
"text": " The total number of bindings with a <code>descriptorType</code> of <code>VK_DESCRIPTOR_TYPE_INLINE_UNIFORM_BLOCK</code> accessible across all shader stages and across all elements of <code>pSetLayouts</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceInlineUniformBlockProperties</code>::<code>maxDescriptorSetUpdateAfterBindInlineUniformBlocks</code>"
|
|
}
|
|
],
|
|
"(VK_KHR_push_descriptor)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-pSetLayouts-00293",
|
|
"text": " <code>pSetLayouts</code> <strong class=\"purple\">must</strong> not contain more than one descriptor set layout that was created with <code>VK_DESCRIPTOR_SET_LAYOUT_CREATE_PUSH_DESCRIPTOR_BIT_KHR</code> set"
|
|
}
|
|
],
|
|
"(VK_KHR_acceleration_structure)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-descriptorType-03571",
|
|
"text": " The total number of bindings in descriptor set layouts created without the <code>VK_DESCRIPTOR_SET_LAYOUT_CREATE_UPDATE_AFTER_BIND_POOL_BIT</code> bit set with a <code>descriptorType</code> of <code>VK_DESCRIPTOR_TYPE_ACCELERATION_STRUCTURE_KHR</code> accessible to any given shader stage across all elements of <code>pSetLayouts</code> <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#VkPhysicalDeviceAccelerationStructurePropertiesKHR\">VkPhysicalDeviceAccelerationStructurePropertiesKHR</a>::<code>maxPerStageDescriptorAccelerationStructures</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-descriptorType-03572",
|
|
"text": " The total number of bindings with a <code>descriptorType</code> of <code>VK_DESCRIPTOR_TYPE_ACCELERATION_STRUCTURE_KHR</code> accessible to any given shader stage across all elements of <code>pSetLayouts</code> <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#VkPhysicalDeviceAccelerationStructurePropertiesKHR\">VkPhysicalDeviceAccelerationStructurePropertiesKHR</a>::<code>maxPerStageDescriptorUpdateAfterBindAccelerationStructures</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-descriptorType-03573",
|
|
"text": " The total number of bindings in descriptor set layouts created without the <code>VK_DESCRIPTOR_SET_LAYOUT_CREATE_UPDATE_AFTER_BIND_POOL_BIT</code> bit set with a <code>descriptorType</code> of <code>VK_DESCRIPTOR_TYPE_ACCELERATION_STRUCTURE_KHR</code> accessible across all shader stages and across all elements of <code>pSetLayouts</code> <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#VkPhysicalDeviceAccelerationStructurePropertiesKHR\">VkPhysicalDeviceAccelerationStructurePropertiesKHR</a>::<code>maxDescriptorSetAccelerationStructures</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-descriptorType-03574",
|
|
"text": " The total number of bindings with a <code>descriptorType</code> of <code>VK_DESCRIPTOR_TYPE_ACCELERATION_STRUCTURE_KHR</code> accessible across all shader stages and across all elements of <code>pSetLayouts</code> <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#VkPhysicalDeviceAccelerationStructurePropertiesKHR\">VkPhysicalDeviceAccelerationStructurePropertiesKHR</a>::<code>maxDescriptorSetUpdateAfterBindAccelerationStructures</code>"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-descriptorType-02381",
|
|
"text": " The total number of bindings with a <code>descriptorType</code> of <code>VK_DESCRIPTOR_TYPE_ACCELERATION_STRUCTURE_NV</code> accessible across all shader stages and across all elements of <code>pSetLayouts</code> <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#VkPhysicalDeviceRayTracingPropertiesNV\">VkPhysicalDeviceRayTracingPropertiesNV</a>::<code>maxDescriptorSetAccelerationStructures</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_fragment_density_map2)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-pImmutableSamplers-03566",
|
|
"text": " The total number of <code>pImmutableSamplers</code> created with <code>flags</code> containing <code>VK_SAMPLER_CREATE_SUBSAMPLED_BIT_EXT</code> or <code>VK_SAMPLER_CREATE_SUBSAMPLED_COARSE_RECONSTRUCTION_BIT_EXT</code> across all shader stages and across all elements of <code>pSetLayouts</code> <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#limits-maxDescriptorSetSubsampledSamplers\"><code>VkPhysicalDeviceFragmentDensityMap2PropertiesEXT</code>::<code>maxDescriptorSetSubsampledSamplers</code></a>"
|
|
}
|
|
],
|
|
"(VK_VALVE_mutable_descriptor_type)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-pSetLayouts-04606",
|
|
"text": " Any element of <code>pSetLayouts</code> <strong class=\"purple\">must</strong> not have been created with the <code>VK_DESCRIPTOR_SET_LAYOUT_CREATE_HOST_ONLY_POOL_BIT_VALVE</code> bit set"
|
|
}
|
|
],
|
|
"!(VK_EXT_graphics_pipeline_library)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-pSetLayouts-06561",
|
|
"text": " Elements of <code>pSetLayouts</code> <strong class=\"purple\">must</strong> be valid <a href=\"#VkDescriptorSetLayout\">VkDescriptorSetLayout</a> objects"
|
|
}
|
|
],
|
|
"(VK_EXT_graphics_pipeline_library)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineLayoutCreateInfo-graphicsPipelineLibrary-06753",
|
|
"text": " If <a href=\"#features-graphicsPipelineLibrary\"><code>graphicsPipelineLibrary</code></a> is not enabled, elements of <code>pSetLayouts</code> <strong class=\"purple\">must</strong> be valid <a href=\"#VkDescriptorSetLayout\">VkDescriptorSetLayout</a> objects"
|
|
}
|
|
]
|
|
},
|
|
"VkPushConstantRange": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkPushConstantRange-offset-00294",
|
|
"text": " <code>offset</code> <strong class=\"purple\">must</strong> be less than <code>VkPhysicalDeviceLimits</code>::<code>maxPushConstantsSize</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPushConstantRange-offset-00295",
|
|
"text": " <code>offset</code> <strong class=\"purple\">must</strong> be a multiple of <code>4</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPushConstantRange-size-00296",
|
|
"text": " <code>size</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPushConstantRange-size-00297",
|
|
"text": " <code>size</code> <strong class=\"purple\">must</strong> be a multiple of <code>4</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPushConstantRange-size-00298",
|
|
"text": " <code>size</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxPushConstantsSize</code> minus <code>offset</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPushConstantRange-stageFlags-parameter",
|
|
"text": " <code>stageFlags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkShaderStageFlagBits\">VkShaderStageFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPushConstantRange-stageFlags-requiredbitmask",
|
|
"text": " <code>stageFlags</code> <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkDestroyPipelineLayout": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkDestroyPipelineLayout-pipelineLayout-00299",
|
|
"text": " If <code>VkAllocationCallbacks</code> were provided when <code>pipelineLayout</code> was created, a compatible set of callbacks <strong class=\"purple\">must</strong> be provided here"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyPipelineLayout-pipelineLayout-00300",
|
|
"text": " If no <code>VkAllocationCallbacks</code> were provided when <code>pipelineLayout</code> was created, <code>pAllocator</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyPipelineLayout-pipelineLayout-02004",
|
|
"text": " <code>pipelineLayout</code> <strong class=\"purple\">must</strong> not have been passed to any <code>vkCmd*</code> command for any command buffers that are still in the <a href=\"#commandbuffers-lifecycle\">recording state</a> when <code>vkDestroyPipelineLayout</code> is called"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyPipelineLayout-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyPipelineLayout-pipelineLayout-parameter",
|
|
"text": " If <code>pipelineLayout</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>pipelineLayout</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPipelineLayout\">VkPipelineLayout</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyPipelineLayout-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyPipelineLayout-pipelineLayout-parent",
|
|
"text": " If <code>pipelineLayout</code> is a valid handle, it <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCreateDescriptorPool": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCreateDescriptorPool-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateDescriptorPool-pCreateInfo-parameter",
|
|
"text": " <code>pCreateInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkDescriptorPoolCreateInfo\">VkDescriptorPoolCreateInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateDescriptorPool-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateDescriptorPool-pDescriptorPool-parameter",
|
|
"text": " <code>pDescriptorPool</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkDescriptorPool\">VkDescriptorPool</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkDescriptorPoolCreateInfo": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkDescriptorPoolCreateInfo-maxSets-00301",
|
|
"text": " <code>maxSets</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorPoolCreateInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_DESCRIPTOR_POOL_CREATE_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorPoolCreateInfo-pNext-pNext",
|
|
"text": " Each <code>pNext</code> member of any structure (including this one) in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be either <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkDescriptorPoolInlineUniformBlockCreateInfo\">VkDescriptorPoolInlineUniformBlockCreateInfo</a> or <a href=\"#VkMutableDescriptorTypeCreateInfoVALVE\">VkMutableDescriptorTypeCreateInfoVALVE</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorPoolCreateInfo-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorPoolCreateInfo-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkDescriptorPoolCreateFlagBits\">VkDescriptorPoolCreateFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorPoolCreateInfo-pPoolSizes-parameter",
|
|
"text": " If <code>poolSizeCount</code> is not <code>0</code>, <code>pPoolSizes</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>poolSizeCount</code> valid <a href=\"#VkDescriptorPoolSize\">VkDescriptorPoolSize</a> structures"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_EXT_descriptor_indexing)+(VK_VALVE_mutable_descriptor_type)": [
|
|
{
|
|
"vuid": "VUID-VkDescriptorPoolCreateInfo-flags-04607",
|
|
"text": " If <code>flags</code> has the <code>VK_DESCRIPTOR_POOL_CREATE_HOST_ONLY_BIT_VALVE</code> bit set, then the <code>VK_DESCRIPTOR_POOL_CREATE_UPDATE_AFTER_BIND_BIT</code> bit <strong class=\"purple\">must</strong> not be set"
|
|
}
|
|
],
|
|
"(VK_VALVE_mutable_descriptor_type)": [
|
|
{
|
|
"vuid": "VUID-VkDescriptorPoolCreateInfo-mutableDescriptorType-04608",
|
|
"text": " If <a href=\"#VkPhysicalDeviceMutableDescriptorTypeFeaturesVALVE\">VkPhysicalDeviceMutableDescriptorTypeFeaturesVALVE</a>::<code>mutableDescriptorType</code> is not enabled, <code>pPoolSizes</code> <strong class=\"purple\">must</strong> not contain a <code>descriptorType</code> of <code>VK_DESCRIPTOR_TYPE_MUTABLE_VALVE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorPoolCreateInfo-flags-04609",
|
|
"text": " If <code>flags</code> has the <code>VK_DESCRIPTOR_POOL_CREATE_HOST_ONLY_BIT_VALVE</code> bit set, <a href=\"#VkPhysicalDeviceMutableDescriptorTypeFeaturesVALVE\">VkPhysicalDeviceMutableDescriptorTypeFeaturesVALVE</a>::<code>mutableDescriptorType</code> <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorPoolCreateInfo-pPoolSizes-04787",
|
|
"text": " If <code>pPoolSizes</code> contains a <code>descriptorType</code> of <code>VK_DESCRIPTOR_TYPE_MUTABLE_VALVE</code>, any other <code>VK_DESCRIPTOR_TYPE_MUTABLE_VALVE</code> element in <code>pPoolSizes</code> <strong class=\"purple\">must</strong> not have sets of supported descriptor types which partially overlap"
|
|
}
|
|
]
|
|
},
|
|
"VkDescriptorPoolInlineUniformBlockCreateInfo": {
|
|
"(VK_VERSION_1_3,VK_EXT_inline_uniform_block)": [
|
|
{
|
|
"vuid": "VUID-VkDescriptorPoolInlineUniformBlockCreateInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_DESCRIPTOR_POOL_INLINE_UNIFORM_BLOCK_CREATE_INFO</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkDescriptorPoolSize": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkDescriptorPoolSize-descriptorCount-00302",
|
|
"text": " <code>descriptorCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorPoolSize-type-parameter",
|
|
"text": " <code>type</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDescriptorType\">VkDescriptorType</a> value"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_inline_uniform_block)": [
|
|
{
|
|
"vuid": "VUID-VkDescriptorPoolSize-type-02218",
|
|
"text": " If <code>type</code> is <code>VK_DESCRIPTOR_TYPE_INLINE_UNIFORM_BLOCK</code> then <code>descriptorCount</code> <strong class=\"purple\">must</strong> be a multiple of <code>4</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkDestroyDescriptorPool": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkDestroyDescriptorPool-descriptorPool-00303",
|
|
"text": " All submitted commands that refer to <code>descriptorPool</code> (via any allocated descriptor sets) <strong class=\"purple\">must</strong> have completed execution"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyDescriptorPool-descriptorPool-00304",
|
|
"text": " If <code>VkAllocationCallbacks</code> were provided when <code>descriptorPool</code> was created, a compatible set of callbacks <strong class=\"purple\">must</strong> be provided here"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyDescriptorPool-descriptorPool-00305",
|
|
"text": " If no <code>VkAllocationCallbacks</code> were provided when <code>descriptorPool</code> was created, <code>pAllocator</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyDescriptorPool-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyDescriptorPool-descriptorPool-parameter",
|
|
"text": " If <code>descriptorPool</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>descriptorPool</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDescriptorPool\">VkDescriptorPool</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyDescriptorPool-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyDescriptorPool-descriptorPool-parent",
|
|
"text": " If <code>descriptorPool</code> is a valid handle, it <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkAllocateDescriptorSets": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkAllocateDescriptorSets-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkAllocateDescriptorSets-pAllocateInfo-parameter",
|
|
"text": " <code>pAllocateInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkDescriptorSetAllocateInfo\">VkDescriptorSetAllocateInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkAllocateDescriptorSets-pDescriptorSets-parameter",
|
|
"text": " <code>pDescriptorSets</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>pAllocateInfo->descriptorSetCount</code> <a href=\"#VkDescriptorSet\">VkDescriptorSet</a> handles"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkAllocateDescriptorSets-pAllocateInfo::descriptorSetCount-arraylength",
|
|
"text": " <code>pAllocateInfo->descriptorSetCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkDescriptorSetAllocateInfo": {
|
|
"!(VK_VERSION_1_1,VK_KHR_maintenance1)": [
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetAllocateInfo-descriptorSetCount-00306",
|
|
"text": " <code>descriptorSetCount</code> <strong class=\"purple\">must</strong> not be greater than the number of sets that are currently available for allocation in <code>descriptorPool</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetAllocateInfo-descriptorPool-00307",
|
|
"text": " <code>descriptorPool</code> <strong class=\"purple\">must</strong> have enough free descriptor capacity remaining to allocate the descriptor sets of the specified layouts"
|
|
}
|
|
],
|
|
"(VK_KHR_push_descriptor)": [
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetAllocateInfo-pSetLayouts-00308",
|
|
"text": " Each element of <code>pSetLayouts</code> <strong class=\"purple\">must</strong> not have been created with <code>VK_DESCRIPTOR_SET_LAYOUT_CREATE_PUSH_DESCRIPTOR_BIT_KHR</code> set"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_EXT_descriptor_indexing)": [
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetAllocateInfo-pSetLayouts-03044",
|
|
"text": " If any element of <code>pSetLayouts</code> was created with the <code>VK_DESCRIPTOR_SET_LAYOUT_CREATE_UPDATE_AFTER_BIND_POOL_BIT</code> bit set, <code>descriptorPool</code> <strong class=\"purple\">must</strong> have been created with the <code>VK_DESCRIPTOR_POOL_CREATE_UPDATE_AFTER_BIND_BIT</code> flag set"
|
|
}
|
|
],
|
|
"(VK_VALVE_mutable_descriptor_type)": [
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetAllocateInfo-pSetLayouts-04610",
|
|
"text": " If any element of <code>pSetLayouts</code> was created with the <code>VK_DESCRIPTOR_SET_LAYOUT_CREATE_HOST_ONLY_POOL_BIT_VALVE</code> bit set, <code>descriptorPool</code> <strong class=\"purple\">must</strong> have been created with the <code>VK_DESCRIPTOR_POOL_CREATE_HOST_ONLY_BIT_VALVE</code> flag set"
|
|
}
|
|
],
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetAllocateInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_DESCRIPTOR_SET_ALLOCATE_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetAllocateInfo-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkDescriptorSetVariableDescriptorCountAllocateInfo\">VkDescriptorSetVariableDescriptorCountAllocateInfo</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetAllocateInfo-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetAllocateInfo-descriptorPool-parameter",
|
|
"text": " <code>descriptorPool</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDescriptorPool\">VkDescriptorPool</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetAllocateInfo-pSetLayouts-parameter",
|
|
"text": " <code>pSetLayouts</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>descriptorSetCount</code> valid <a href=\"#VkDescriptorSetLayout\">VkDescriptorSetLayout</a> handles"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetAllocateInfo-descriptorSetCount-arraylength",
|
|
"text": " <code>descriptorSetCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetAllocateInfo-commonparent",
|
|
"text": " Both of <code>descriptorPool</code>, and the elements of <code>pSetLayouts</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
]
|
|
},
|
|
"VkDescriptorSetVariableDescriptorCountAllocateInfo": {
|
|
"(VK_VERSION_1_2,VK_EXT_descriptor_indexing)": [
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetVariableDescriptorCountAllocateInfo-descriptorSetCount-03045",
|
|
"text": " If <code>descriptorSetCount</code> is not zero, <code>descriptorSetCount</code> <strong class=\"purple\">must</strong> equal <a href=\"#VkDescriptorSetAllocateInfo\">VkDescriptorSetAllocateInfo</a>::<code>descriptorSetCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetVariableDescriptorCountAllocateInfo-pSetLayouts-03046",
|
|
"text": " If <a href=\"#VkDescriptorSetAllocateInfo\">VkDescriptorSetAllocateInfo</a>::<code>pSetLayouts</code>[i] has a variable-sized descriptor binding, then <code>pDescriptorCounts</code>[i] <strong class=\"purple\">must</strong> be less than or equal to the descriptor count specified for that binding when the descriptor set layout was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetVariableDescriptorCountAllocateInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_DESCRIPTOR_SET_VARIABLE_DESCRIPTOR_COUNT_ALLOCATE_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetVariableDescriptorCountAllocateInfo-pDescriptorCounts-parameter",
|
|
"text": " If <code>descriptorSetCount</code> is not <code>0</code>, <code>pDescriptorCounts</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>descriptorSetCount</code> <code>uint32_t</code> values"
|
|
}
|
|
]
|
|
},
|
|
"vkFreeDescriptorSets": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkFreeDescriptorSets-pDescriptorSets-00309",
|
|
"text": " All submitted commands that refer to any element of <code>pDescriptorSets</code> <strong class=\"purple\">must</strong> have completed execution"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkFreeDescriptorSets-pDescriptorSets-00310",
|
|
"text": " <code>pDescriptorSets</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>descriptorSetCount</code> <code>VkDescriptorSet</code> handles, each element of which <strong class=\"purple\">must</strong> either be a valid handle or <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkFreeDescriptorSets-descriptorPool-00312",
|
|
"text": " <code>descriptorPool</code> <strong class=\"purple\">must</strong> have been created with the <code>VK_DESCRIPTOR_POOL_CREATE_FREE_DESCRIPTOR_SET_BIT</code> flag"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkFreeDescriptorSets-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkFreeDescriptorSets-descriptorPool-parameter",
|
|
"text": " <code>descriptorPool</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDescriptorPool\">VkDescriptorPool</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkFreeDescriptorSets-descriptorSetCount-arraylength",
|
|
"text": " <code>descriptorSetCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkFreeDescriptorSets-descriptorPool-parent",
|
|
"text": " <code>descriptorPool</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkFreeDescriptorSets-pDescriptorSets-parent",
|
|
"text": " Each element of <code>pDescriptorSets</code> that is a valid handle <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>descriptorPool</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkResetDescriptorPool": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkResetDescriptorPool-descriptorPool-00313",
|
|
"text": " All uses of <code>descriptorPool</code> (via any allocated descriptor sets) <strong class=\"purple\">must</strong> have completed execution"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkResetDescriptorPool-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkResetDescriptorPool-descriptorPool-parameter",
|
|
"text": " <code>descriptorPool</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDescriptorPool\">VkDescriptorPool</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkResetDescriptorPool-flags-zerobitmask",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkResetDescriptorPool-descriptorPool-parent",
|
|
"text": " <code>descriptorPool</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkUpdateDescriptorSets": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkUpdateDescriptorSets-pDescriptorWrites-06236",
|
|
"text": " For each element <span class=\"eq\">i</span> where <code>pDescriptorWrites</code>[i].<code>descriptorType</code> is <code>VK_DESCRIPTOR_TYPE_UNIFORM_TEXEL_BUFFER</code> or <code>VK_DESCRIPTOR_TYPE_STORAGE_TEXEL_BUFFER</code>, elements of the <code>pTexelBufferView</code> member of <code>pDescriptorWrites</code>[i] <strong class=\"purple\">must</strong> have been created on <code>device</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkUpdateDescriptorSets-pDescriptorWrites-06237",
|
|
"text": " For each element <span class=\"eq\">i</span> where <code>pDescriptorWrites</code>[i].<code>descriptorType</code> is <code>VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER</code>, <code>VK_DESCRIPTOR_TYPE_STORAGE_BUFFER</code>, <code>VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER_DYNAMIC</code>, or <code>VK_DESCRIPTOR_TYPE_STORAGE_BUFFER_DYNAMIC</code>, the <code>buffer</code> member of any element of the <code>pBufferInfo</code> member of <code>pDescriptorWrites</code>[i] <strong class=\"purple\">must</strong> have been created on <code>device</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkUpdateDescriptorSets-pDescriptorWrites-06238",
|
|
"text": " For each element <span class=\"eq\">i</span> where <code>pDescriptorWrites</code>[i].<code>descriptorType</code> is <code>VK_DESCRIPTOR_TYPE_SAMPLER</code> or <code>VK_DESCRIPTOR_TYPE_COMBINED_IMAGE_SAMPLER</code>, and <code>dstSet</code> was not allocated with a layout that included immutable samplers for <code>dstBinding</code> with <code>descriptorType</code>, the <code>sampler</code> member of any element of the <code>pImageInfo</code> member of <code>pDescriptorWrites</code>[i] <strong class=\"purple\">must</strong> have been created on <code>device</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkUpdateDescriptorSets-pDescriptorWrites-06239",
|
|
"text": " For each element <span class=\"eq\">i</span> where <code>pDescriptorWrites</code>[i].<code>descriptorType</code> is <code>VK_DESCRIPTOR_TYPE_SAMPLED_IMAGE</code>, <code>VK_DESCRIPTOR_TYPE_STORAGE_IMAGE</code>, <code>VK_DESCRIPTOR_TYPE_INPUT_ATTACHMENT</code>, or <code>VK_DESCRIPTOR_TYPE_COMBINED_IMAGE_SAMPLER</code> the <code>imageView</code> member of any element of <code>pDescriptorWrites</code>[i] <strong class=\"purple\">must</strong> have been created on <code>device</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkUpdateDescriptorSets-pDescriptorWrites-06493",
|
|
"text": " For each element <span class=\"eq\">i</span> where <code>pDescriptorWrites</code>[i].<code>descriptorType</code> is <code>VK_DESCRIPTOR_TYPE_SAMPLER</code>, <code>VK_DESCRIPTOR_TYPE_COMBINED_IMAGE_SAMPLER</code>, <code>VK_DESCRIPTOR_TYPE_SAMPLED_IMAGE</code>, <code>VK_DESCRIPTOR_TYPE_STORAGE_IMAGE</code>, or <code>VK_DESCRIPTOR_TYPE_INPUT_ATTACHMENT</code>, <code>pDescriptorWrites</code>[i].<code>pImageInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>pDescriptorWrites</code>[i].<code>descriptorCount</code> valid <code>VkDescriptorImageInfo</code> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkUpdateDescriptorSets-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkUpdateDescriptorSets-pDescriptorWrites-parameter",
|
|
"text": " If <code>descriptorWriteCount</code> is not <code>0</code>, <code>pDescriptorWrites</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>descriptorWriteCount</code> valid <a href=\"#VkWriteDescriptorSet\">VkWriteDescriptorSet</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkUpdateDescriptorSets-pDescriptorCopies-parameter",
|
|
"text": " If <code>descriptorCopyCount</code> is not <code>0</code>, <code>pDescriptorCopies</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>descriptorCopyCount</code> valid <a href=\"#VkCopyDescriptorSet\">VkCopyDescriptorSet</a> structures"
|
|
}
|
|
],
|
|
"(VK_KHR_acceleration_structure)": [
|
|
{
|
|
"vuid": "VUID-vkUpdateDescriptorSets-pDescriptorWrites-06240",
|
|
"text": " For each element <span class=\"eq\">i</span> where <code>pDescriptorWrites</code>[i].<code>descriptorType</code> is <code>VK_DESCRIPTOR_TYPE_ACCELERATION_STRUCTURE_KHR</code>, elements of the <code>pAccelerationStructures</code> member of a <a href=\"#VkWriteDescriptorSetAccelerationStructureKHR\">VkWriteDescriptorSetAccelerationStructureKHR</a> structure in the <code>pNext</code> chain of <code>pDescriptorWrites</code>[i] <strong class=\"purple\">must</strong> have been created on <code>device</code>"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing)": [
|
|
{
|
|
"vuid": "VUID-vkUpdateDescriptorSets-pDescriptorWrites-06241",
|
|
"text": " For each element <span class=\"eq\">i</span> where <code>pDescriptorWrites</code>[i].<code>descriptorType</code> is <code>VK_DESCRIPTOR_TYPE_ACCELERATION_STRUCTURE_NV</code>, elements of the <code>pAccelerationStructures</code> member of a <a href=\"#VkWriteDescriptorSetAccelerationStructureNV\">VkWriteDescriptorSetAccelerationStructureNV</a> structure in the <code>pNext</code> chain of <code>pDescriptorWrites</code>[i] <strong class=\"purple\">must</strong> have been created on <code>device</code>"
|
|
}
|
|
],
|
|
"(VK_QCOM_image_processing)": [
|
|
{
|
|
"vuid": "VUID-vkUpdateDescriptorSets-pDescriptorWrites-06940",
|
|
"text": " For each element <span class=\"eq\">i</span> where <code>pDescriptorWrites</code>[i].<code>descriptorType</code> is <code>VK_DESCRIPTOR_TYPE_SAMPLE_WEIGHT_IMAGE_QCOM</code> or <code>VK_DESCRIPTOR_TYPE_BLOCK_MATCH_IMAGE_QCOM</code>, the <code>imageView</code> member of any element of <code>pDescriptorWrites</code>[i] <strong class=\"purple\">must</strong> have been created on <code>device</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkUpdateDescriptorSets-pDescriptorWrites-06941",
|
|
"text": " For each element <span class=\"eq\">i</span> where <code>pDescriptorWrites</code>[i].<code>descriptorType</code> is <code>VK_DESCRIPTOR_TYPE_SAMPLE_WEIGHT_IMAGE_QCOM</code> or <code>VK_DESCRIPTOR_TYPE_BLOCK_MATCH_IMAGE_QCOM</code>, <code>pDescriptorWrites</code>[i].<code>pImageInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>pDescriptorWrites</code>[i].<code>descriptorCount</code> valid <code>VkDescriptorImageInfo</code> structures"
|
|
}
|
|
],
|
|
"!(VK_VERSION_1_2,VK_EXT_descriptor_indexing)": [
|
|
{
|
|
"vuid": "VUID-vkUpdateDescriptorSets-dstSet-00314",
|
|
"text": " The <code>dstSet</code> member of each element of <code>pDescriptorWrites</code> or <code>pDescriptorCopies</code> <strong class=\"purple\">must</strong> not be used by any command that was recorded to a command buffer which is in the <a href=\"#commandbuffers-lifecycle\">pending state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkUpdateDescriptorSets-pDescriptorWrites-06992",
|
|
"text": " Host access to <code>pDescriptorWrites</code>[i].<code>dstSet</code> and <code>pDescriptorCopies</code>[i].<code>dstSet</code> <strong class=\"purple\">must</strong> be <a href=\"#fundamentals-threadingbehavior\">externally synchronized</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_EXT_descriptor_indexing)": [
|
|
{
|
|
"vuid": "VUID-vkUpdateDescriptorSets-None-03047",
|
|
"text": " Descriptor bindings updated by this command which were created without the <code>VK_DESCRIPTOR_BINDING_UPDATE_AFTER_BIND_BIT</code> or <code>VK_DESCRIPTOR_BINDING_UPDATE_UNUSED_WHILE_PENDING_BIT</code> bits set <strong class=\"purple\">must</strong> not be used by any command that was recorded to a command buffer which is in the <a href=\"#commandbuffers-lifecycle\">pending state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkUpdateDescriptorSets-pDescriptorWrites-06993",
|
|
"text": " Host access to <code>pDescriptorWrites</code>[i].<code>dstSet</code> and <code>pDescriptorCopies</code>[i].<code>dstSet</code> <strong class=\"purple\">must</strong> be <a href=\"#fundamentals-threadingbehavior\">externally synchronized</a> unless explicitly denoted otherwise for specific flags"
|
|
}
|
|
]
|
|
},
|
|
"VkWriteDescriptorSet": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSet-dstBinding-00315",
|
|
"text": " <code>dstBinding</code> <strong class=\"purple\">must</strong> be less than or equal to the maximum value of <code>binding</code> of all <a href=\"#VkDescriptorSetLayoutBinding\">VkDescriptorSetLayoutBinding</a> structures specified when <code>dstSet</code>’s descriptor set layout was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSet-dstBinding-00316",
|
|
"text": " <code>dstBinding</code> <strong class=\"purple\">must</strong> be a binding with a non-zero <code>descriptorCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSet-descriptorCount-00317",
|
|
"text": " All consecutive bindings updated via a single <code>VkWriteDescriptorSet</code> structure, except those with a <code>descriptorCount</code> of zero, <strong class=\"purple\">must</strong> have identical <code>descriptorType</code> and <code>stageFlags</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSet-descriptorCount-00318",
|
|
"text": " All consecutive bindings updated via a single <code>VkWriteDescriptorSet</code> structure, except those with a <code>descriptorCount</code> of zero, <strong class=\"purple\">must</strong> all either use immutable samplers or <strong class=\"purple\">must</strong> all not use immutable samplers"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSet-descriptorType-00319",
|
|
"text": " <code>descriptorType</code> <strong class=\"purple\">must</strong> match the type of <code>dstBinding</code> within <code>dstSet</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSet-dstSet-00320",
|
|
"text": " <code>dstSet</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDescriptorSet\">VkDescriptorSet</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSet-dstArrayElement-00321",
|
|
"text": " The sum of <code>dstArrayElement</code> and <code>descriptorCount</code> <strong class=\"purple\">must</strong> be less than or equal to the number of array elements in the descriptor set binding specified by <code>dstBinding</code>, and all applicable consecutive bindings, as described by <a href=\"#descriptorsets-updates-consecutive\">consecutive binding updates</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSet-descriptorType-02994",
|
|
"text": " If <code>descriptorType</code> is <code>VK_DESCRIPTOR_TYPE_UNIFORM_TEXEL_BUFFER</code> or <code>VK_DESCRIPTOR_TYPE_STORAGE_TEXEL_BUFFER</code>, each element of <code>pTexelBufferView</code> <strong class=\"purple\">must</strong> be either a valid <code>VkBufferView</code> handle or <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSet-descriptorType-02995",
|
|
"text": " If <code>descriptorType</code> is <code>VK_DESCRIPTOR_TYPE_UNIFORM_TEXEL_BUFFER</code> or <code>VK_DESCRIPTOR_TYPE_STORAGE_TEXEL_BUFFER</code> and the <a href=\"#features-nullDescriptor\"><code>nullDescriptor</code></a> feature is not enabled, each element of <code>pTexelBufferView</code> <strong class=\"purple\">must</strong> not be <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSet-descriptorType-00324",
|
|
"text": " If <code>descriptorType</code> is <code>VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER</code>, <code>VK_DESCRIPTOR_TYPE_STORAGE_BUFFER</code>, <code>VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER_DYNAMIC</code>, or <code>VK_DESCRIPTOR_TYPE_STORAGE_BUFFER_DYNAMIC</code>, <code>pBufferInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>descriptorCount</code> valid <code>VkDescriptorBufferInfo</code> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSet-descriptorType-00325",
|
|
"text": " If <code>descriptorType</code> is <code>VK_DESCRIPTOR_TYPE_SAMPLER</code> or <code>VK_DESCRIPTOR_TYPE_COMBINED_IMAGE_SAMPLER</code>, and <code>dstSet</code> was not allocated with a layout that included immutable samplers for <code>dstBinding</code> with <code>descriptorType</code>, the <code>sampler</code> member of each element of <code>pImageInfo</code> <strong class=\"purple\">must</strong> be a valid <code>VkSampler</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSet-descriptorType-02996",
|
|
"text": " If <code>descriptorType</code> is <code>VK_DESCRIPTOR_TYPE_COMBINED_IMAGE_SAMPLER</code>, <code>VK_DESCRIPTOR_TYPE_SAMPLED_IMAGE</code>, <code>VK_DESCRIPTOR_TYPE_STORAGE_IMAGE</code>, or <code>VK_DESCRIPTOR_TYPE_INPUT_ATTACHMENT</code>, the <code>imageView</code> member of each element of <code>pImageInfo</code> <strong class=\"purple\">must</strong> be either a valid <code>VkImageView</code> handle or <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSet-descriptorType-02997",
|
|
"text": " If <code>descriptorType</code> is <code>VK_DESCRIPTOR_TYPE_COMBINED_IMAGE_SAMPLER</code>, <code>VK_DESCRIPTOR_TYPE_SAMPLED_IMAGE</code>, <code>VK_DESCRIPTOR_TYPE_STORAGE_IMAGE</code>, or <code>VK_DESCRIPTOR_TYPE_INPUT_ATTACHMENT</code> and the <a href=\"#features-nullDescriptor\"><code>nullDescriptor</code></a> feature is not enabled, the <code>imageView</code> member of each element of <code>pImageInfo</code> <strong class=\"purple\">must</strong> not be <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSet-descriptorType-00327",
|
|
"text": " If <code>descriptorType</code> is <code>VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER</code> or <code>VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER_DYNAMIC</code>, the <code>offset</code> member of each element of <code>pBufferInfo</code> <strong class=\"purple\">must</strong> be a multiple of <code>VkPhysicalDeviceLimits</code>::<code>minUniformBufferOffsetAlignment</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSet-descriptorType-00328",
|
|
"text": " If <code>descriptorType</code> is <code>VK_DESCRIPTOR_TYPE_STORAGE_BUFFER</code> or <code>VK_DESCRIPTOR_TYPE_STORAGE_BUFFER_DYNAMIC</code>, the <code>offset</code> member of each element of <code>pBufferInfo</code> <strong class=\"purple\">must</strong> be a multiple of <code>VkPhysicalDeviceLimits</code>::<code>minStorageBufferOffsetAlignment</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSet-descriptorType-00329",
|
|
"text": " If <code>descriptorType</code> is <code>VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER</code>, <code>VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER_DYNAMIC</code>, <code>VK_DESCRIPTOR_TYPE_STORAGE_BUFFER</code>, or <code>VK_DESCRIPTOR_TYPE_STORAGE_BUFFER_DYNAMIC</code>, and the <code>buffer</code> member of any element of <code>pBufferInfo</code> is the handle of a non-sparse buffer, then that buffer <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSet-descriptorType-00330",
|
|
"text": " If <code>descriptorType</code> is <code>VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER</code> or <code>VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER_DYNAMIC</code>, the <code>buffer</code> member of each element of <code>pBufferInfo</code> <strong class=\"purple\">must</strong> have been created with <code>VK_BUFFER_USAGE_UNIFORM_BUFFER_BIT</code> set"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSet-descriptorType-00331",
|
|
"text": " If <code>descriptorType</code> is <code>VK_DESCRIPTOR_TYPE_STORAGE_BUFFER</code> or <code>VK_DESCRIPTOR_TYPE_STORAGE_BUFFER_DYNAMIC</code>, the <code>buffer</code> member of each element of <code>pBufferInfo</code> <strong class=\"purple\">must</strong> have been created with <code>VK_BUFFER_USAGE_STORAGE_BUFFER_BIT</code> set"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSet-descriptorType-00332",
|
|
"text": " If <code>descriptorType</code> is <code>VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER</code> or <code>VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER_DYNAMIC</code>, the <code>range</code> member of each element of <code>pBufferInfo</code>, or the <a href=\"#buffer-info-effective-range\">effective range</a> if <code>range</code> is <code>VK_WHOLE_SIZE</code>, <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxUniformBufferRange</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSet-descriptorType-00333",
|
|
"text": " If <code>descriptorType</code> is <code>VK_DESCRIPTOR_TYPE_STORAGE_BUFFER</code> or <code>VK_DESCRIPTOR_TYPE_STORAGE_BUFFER_DYNAMIC</code>, the <code>range</code> member of each element of <code>pBufferInfo</code>, or the <a href=\"#buffer-info-effective-range\">effective range</a> if <code>range</code> is <code>VK_WHOLE_SIZE</code>, <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxStorageBufferRange</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSet-descriptorType-00334",
|
|
"text": " If <code>descriptorType</code> is <code>VK_DESCRIPTOR_TYPE_UNIFORM_TEXEL_BUFFER</code>, the <code>VkBuffer</code> that each element of <code>pTexelBufferView</code> was created from <strong class=\"purple\">must</strong> have been created with <code>VK_BUFFER_USAGE_UNIFORM_TEXEL_BUFFER_BIT</code> set"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSet-descriptorType-00335",
|
|
"text": " If <code>descriptorType</code> is <code>VK_DESCRIPTOR_TYPE_STORAGE_TEXEL_BUFFER</code>, the <code>VkBuffer</code> that each element of <code>pTexelBufferView</code> was created from <strong class=\"purple\">must</strong> have been created with <code>VK_BUFFER_USAGE_STORAGE_TEXEL_BUFFER_BIT</code> set"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSet-descriptorType-00336",
|
|
"text": " If <code>descriptorType</code> is <code>VK_DESCRIPTOR_TYPE_STORAGE_IMAGE</code> or <code>VK_DESCRIPTOR_TYPE_INPUT_ATTACHMENT</code>, the <code>imageView</code> member of each element of <code>pImageInfo</code> <strong class=\"purple\">must</strong> have been created with the identity swizzle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSet-descriptorType-00337",
|
|
"text": " If <code>descriptorType</code> is <code>VK_DESCRIPTOR_TYPE_SAMPLED_IMAGE</code> or <code>VK_DESCRIPTOR_TYPE_COMBINED_IMAGE_SAMPLER</code>, the <code>imageView</code> member of each element of <code>pImageInfo</code> <strong class=\"purple\">must</strong> have been created with <code>VK_IMAGE_USAGE_SAMPLED_BIT</code> set"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSet-descriptorType-04149",
|
|
"text": " If <code>descriptorType</code> is <code>VK_DESCRIPTOR_TYPE_SAMPLED_IMAGE</code> the <code>imageLayout</code> member of each element of <code>pImageInfo</code> <strong class=\"purple\">must</strong> be a member of the list given in <a href=\"#descriptorsets-sampledimage\">Sampled Image</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSet-descriptorType-04150",
|
|
"text": " If <code>descriptorType</code> is <code>VK_DESCRIPTOR_TYPE_COMBINED_IMAGE_SAMPLER</code> the <code>imageLayout</code> member of each element of <code>pImageInfo</code> <strong class=\"purple\">must</strong> be a member of the list given in <a href=\"#descriptorsets-combinedimagesampler\">Combined Image Sampler</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSet-descriptorType-04151",
|
|
"text": " If <code>descriptorType</code> is <code>VK_DESCRIPTOR_TYPE_INPUT_ATTACHMENT</code> the <code>imageLayout</code> member of each element of <code>pImageInfo</code> <strong class=\"purple\">must</strong> be a member of the list given in <a href=\"#descriptorsets-inputattachment\">Input Attachment</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSet-descriptorType-04152",
|
|
"text": " If <code>descriptorType</code> is <code>VK_DESCRIPTOR_TYPE_STORAGE_IMAGE</code> the <code>imageLayout</code> member of each element of <code>pImageInfo</code> <strong class=\"purple\">must</strong> be a member of the list given in <a href=\"#descriptorsets-storageimage\">Storage Image</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSet-descriptorType-00338",
|
|
"text": " If <code>descriptorType</code> is <code>VK_DESCRIPTOR_TYPE_INPUT_ATTACHMENT</code>, the <code>imageView</code> member of each element of <code>pImageInfo</code> <strong class=\"purple\">must</strong> have been created with <code>VK_IMAGE_USAGE_INPUT_ATTACHMENT_BIT</code> set"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSet-descriptorType-00339",
|
|
"text": " If <code>descriptorType</code> is <code>VK_DESCRIPTOR_TYPE_STORAGE_IMAGE</code>, the <code>imageView</code> member of each element of <code>pImageInfo</code> <strong class=\"purple\">must</strong> have been created with <code>VK_IMAGE_USAGE_STORAGE_BIT</code> set"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSet-descriptorType-02752",
|
|
"text": " If <code>descriptorType</code> is <code>VK_DESCRIPTOR_TYPE_SAMPLER</code>, then <code>dstSet</code> <strong class=\"purple\">must</strong> not have been allocated with a layout that included immutable samplers for <code>dstBinding</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSet-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_WRITE_DESCRIPTOR_SET</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSet-pNext-pNext",
|
|
"text": " Each <code>pNext</code> member of any structure (including this one) in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be either <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkWriteDescriptorSetAccelerationStructureKHR\">VkWriteDescriptorSetAccelerationStructureKHR</a>, <a href=\"#VkWriteDescriptorSetAccelerationStructureNV\">VkWriteDescriptorSetAccelerationStructureNV</a>, or <a href=\"#VkWriteDescriptorSetInlineUniformBlock\">VkWriteDescriptorSetInlineUniformBlock</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSet-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSet-descriptorType-parameter",
|
|
"text": " <code>descriptorType</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDescriptorType\">VkDescriptorType</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSet-descriptorCount-arraylength",
|
|
"text": " <code>descriptorCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSet-commonparent",
|
|
"text": " Both of <code>dstSet</code>, and the elements of <code>pTexelBufferView</code> that are valid handles of non-ignored parameters <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_inline_uniform_block)": [
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSet-descriptorType-02219",
|
|
"text": " If <code>descriptorType</code> is <code>VK_DESCRIPTOR_TYPE_INLINE_UNIFORM_BLOCK</code>, <code>dstArrayElement</code> <strong class=\"purple\">must</strong> be an integer multiple of <code>4</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSet-descriptorType-02220",
|
|
"text": " If <code>descriptorType</code> is <code>VK_DESCRIPTOR_TYPE_INLINE_UNIFORM_BLOCK</code>, <code>descriptorCount</code> <strong class=\"purple\">must</strong> be an integer multiple of <code>4</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSet-descriptorType-02221",
|
|
"text": " If <code>descriptorType</code> is <code>VK_DESCRIPTOR_TYPE_INLINE_UNIFORM_BLOCK</code>, the <code>pNext</code> chain <strong class=\"purple\">must</strong> include a <a href=\"#VkWriteDescriptorSetInlineUniformBlock\">VkWriteDescriptorSetInlineUniformBlock</a> structure whose <code>dataSize</code> member equals <code>descriptorCount</code>"
|
|
}
|
|
],
|
|
"(VK_KHR_acceleration_structure)": [
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSet-descriptorType-02382",
|
|
"text": " If <code>descriptorType</code> is <code>VK_DESCRIPTOR_TYPE_ACCELERATION_STRUCTURE_KHR</code>, the <code>pNext</code> chain <strong class=\"purple\">must</strong> include a <a href=\"#VkWriteDescriptorSetAccelerationStructureKHR\">VkWriteDescriptorSetAccelerationStructureKHR</a> structure whose <code>accelerationStructureCount</code> member equals <code>descriptorCount</code>"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing)": [
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSet-descriptorType-03817",
|
|
"text": " If <code>descriptorType</code> is <code>VK_DESCRIPTOR_TYPE_ACCELERATION_STRUCTURE_NV</code>, the <code>pNext</code> chain <strong class=\"purple\">must</strong> include a <a href=\"#VkWriteDescriptorSetAccelerationStructureNV\">VkWriteDescriptorSetAccelerationStructureNV</a> structure whose <code>accelerationStructureCount</code> member equals <code>descriptorCount</code>"
|
|
}
|
|
],
|
|
"(VK_VULKAN_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSet-descriptorType-01946",
|
|
"text": " If <code>descriptorType</code> is <code>VK_DESCRIPTOR_TYPE_SAMPLED_IMAGE</code>, then the <code>imageView</code> member of each <code>pImageInfo</code> element <strong class=\"purple\">must</strong> have been created without a <code>VkSamplerYcbcrConversionInfo</code> structure in its <code>pNext</code> chain"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSet-descriptorType-02738",
|
|
"text": " If <code>descriptorType</code> is <code>VK_DESCRIPTOR_TYPE_COMBINED_IMAGE_SAMPLER</code>, and if any element of <code>pImageInfo</code> has a <code>imageView</code> member that was created with a <code>VkSamplerYcbcrConversionInfo</code> structure in its <code>pNext</code> chain, then <code>dstSet</code> <strong class=\"purple\">must</strong> have been allocated with a layout that included immutable samplers for <code>dstBinding</code>, and the corresponding immutable sampler <strong class=\"purple\">must</strong> have been created with an <em>identically defined</em> <code>VkSamplerYcbcrConversionInfo</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSet-descriptorType-01948",
|
|
"text": " If <code>descriptorType</code> is <code>VK_DESCRIPTOR_TYPE_COMBINED_IMAGE_SAMPLER</code>, and <code>dstSet</code> was allocated with a layout that included immutable samplers for <code>dstBinding</code>, then the <code>imageView</code> member of each element of <code>pImageInfo</code> which corresponds to an immutable sampler that enables <a href=\"#samplers-YCbCr-conversion\">sampler {YCbCr} conversion</a> <strong class=\"purple\">must</strong> have been created with a <code>VkSamplerYcbcrConversionInfo</code> structure in its <code>pNext</code> chain with an <em>identically defined</em> <code>VkSamplerYcbcrConversionInfo</code> to the corresponding immutable sampler"
|
|
}
|
|
],
|
|
"(VK_EXT_image_2d_view_of_3d)": [
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSet-descriptorType-06710",
|
|
"text": " If <code>descriptorType</code> is <code>VK_DESCRIPTOR_TYPE_STORAGE_IMAGE</code>, <code>VK_DESCRIPTOR_TYPE_SAMPLED_IMAGE</code>, or <code>VK_DESCRIPTOR_TYPE_COMBINED_IMAGE_SAMPLER</code>, each <code>imageView</code> member of each element of <code>pImageInfo</code> that is a 2D image view created from a 3D image <strong class=\"purple\">must</strong> have been created from an image created with <code>VK_IMAGE_CREATE_2D_VIEW_COMPATIBLE_BIT_EXT</code> set"
|
|
}
|
|
],
|
|
"(VK_VALVE_mutable_descriptor_type)": [
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSet-dstSet-04611",
|
|
"text": " If the <code>VkDescriptorSetLayoutBinding</code> for <code>dstSet</code> at <code>dstBinding</code> is <code>VK_DESCRIPTOR_TYPE_MUTABLE_VALVE</code>, the new active descriptor type <code>descriptorType</code> <strong class=\"purple\">must</strong> exist in the corresponding <code>pMutableDescriptorTypeLists</code> list for <code>dstBinding</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_image_view_min_lod)": [
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSet-descriptorType-06450",
|
|
"text": " If <code>descriptorType</code> is <code>VK_DESCRIPTOR_TYPE_INPUT_ATTACHMENT</code>, the <code>imageView</code> member of each element of <code>pImageInfo</code> <strong class=\"purple\">must</strong> have either been created without a <a href=\"#VkImageViewMinLodCreateInfoEXT\">VkImageViewMinLodCreateInfoEXT</a> present in the <code>pNext</code> chain or with a <a href=\"#VkImageViewMinLodCreateInfoEXT\">VkImageViewMinLodCreateInfoEXT</a>::<code>minLod</code> of <code>0.0</code>"
|
|
}
|
|
],
|
|
"(VK_QCOM_image_processing)": [
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSet-descriptorType-06942",
|
|
"text": " If <code>descriptorType</code> is <code>VK_DESCRIPTOR_TYPE_SAMPLE_WEIGHT_IMAGE_QCOM</code>, the <code>imageView</code> member of each element of <code>pImageInfo</code> <strong class=\"purple\">must</strong> have been created with a view created with an <code>image</code> created with <code>VK_IMAGE_USAGE_SAMPLE_WEIGHT_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSet-descriptorType-06943",
|
|
"text": " If <code>descriptorType</code> is <code>VK_DESCRIPTOR_TYPE_BLOCK_MATCH_IMAGE_QCOM</code>, the <code>imageView</code> member of each element of <code>pImageInfo</code> <strong class=\"purple\">must</strong> have been created with a view created with an <code>image</code> created with <code>VK_IMAGE_USAGE_SAMPLE_BLOCK_MATCH_BIT_QCOM</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkDescriptorBufferInfo": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkDescriptorBufferInfo-offset-00340",
|
|
"text": " <code>offset</code> <strong class=\"purple\">must</strong> be less than the size of <code>buffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorBufferInfo-range-00341",
|
|
"text": " If <code>range</code> is not equal to <code>VK_WHOLE_SIZE</code>, <code>range</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorBufferInfo-range-00342",
|
|
"text": " If <code>range</code> is not equal to <code>VK_WHOLE_SIZE</code>, <code>range</code> <strong class=\"purple\">must</strong> be less than or equal to the size of <code>buffer</code> minus <code>offset</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorBufferInfo-buffer-02998",
|
|
"text": " If the <a href=\"#features-nullDescriptor\"><code>nullDescriptor</code></a> feature is not enabled, <code>buffer</code> <strong class=\"purple\">must</strong> not be <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorBufferInfo-buffer-parameter",
|
|
"text": " If <code>buffer</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>buffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBuffer\">VkBuffer</a> handle"
|
|
}
|
|
],
|
|
"(VK_EXT_robustness2)": [
|
|
{
|
|
"vuid": "VUID-VkDescriptorBufferInfo-buffer-02999",
|
|
"text": " If <code>buffer</code> is <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>offset</code> <strong class=\"purple\">must</strong> be zero and <code>range</code> <strong class=\"purple\">must</strong> be <code>VK_WHOLE_SIZE</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkDescriptorImageInfo": {
|
|
"(VK_VERSION_1_1,VK_KHR_maintenance1)+!(VK_EXT_image_2d_view_of_3d)": [
|
|
{
|
|
"vuid": "VUID-VkDescriptorImageInfo-imageView-06711",
|
|
"text": " <code>imageView</code> <strong class=\"purple\">must</strong> not be 2D image view created from a 3D image"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_maintenance1)": [
|
|
{
|
|
"vuid": "VUID-VkDescriptorImageInfo-imageView-06712",
|
|
"text": " <code>imageView</code> <strong class=\"purple\">must</strong> not be a 2D array image view created from a 3D image"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_maintenance1)+(VK_EXT_image_2d_view_of_3d)": [
|
|
{
|
|
"vuid": "VUID-VkDescriptorImageInfo-descriptorType-06713",
|
|
"text": " If the <a href=\"#features-image2DViewOf3D\"><code>image2DViewOf3D</code></a> feature is not enabled and <code>descriptorType</code> is <code>VK_DESCRIPTOR_TYPE_STORAGE_IMAGE</code> then <code>imageView</code> <strong class=\"purple\">must</strong> not be a 2D view created from a 3D image"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorImageInfo-descriptorType-06714",
|
|
"text": " If the <a href=\"#features-sampler2DViewOf3D\"><code>sampler2DViewOf3D</code></a> feature is not enabled and <code>descriptorType</code> is <code>VK_DESCRIPTOR_TYPE_SAMPLED_IMAGE</code> or <code>VK_DESCRIPTOR_TYPE_COMBINED_IMAGE_SAMPLER</code> then <code>imageView</code> <strong class=\"purple\">must</strong> not be a 2D view created from a 3D image"
|
|
}
|
|
],
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkDescriptorImageInfo-imageView-01976",
|
|
"text": " If <code>imageView</code> is created from a depth/stencil image, the <code>aspectMask</code> used to create the <code>imageView</code> <strong class=\"purple\">must</strong> include either <code>VK_IMAGE_ASPECT_DEPTH_BIT</code> or <code>VK_IMAGE_ASPECT_STENCIL_BIT</code> but not both"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorImageInfo-imageLayout-00344",
|
|
"text": " <code>imageLayout</code> <strong class=\"purple\">must</strong> match the actual <a href=\"#VkImageLayout\">VkImageLayout</a> of each subresource accessible from <code>imageView</code> at the time this descriptor is accessed as defined by the <a href=\"#resources-image-layouts-matching-rule\">image layout matching rules</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorImageInfo-commonparent",
|
|
"text": " Both of <code>imageView</code>, and <code>sampler</code> that are valid handles of non-ignored parameters <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-VkDescriptorImageInfo-sampler-01564",
|
|
"text": " If <code>sampler</code> is used and the <a href=\"#VkFormat\">VkFormat</a> of the image is a <a href=\"#formats-requiring-sampler-ycbcr-conversion\">multi-planar format</a>, the image <strong class=\"purple\">must</strong> have been created with <code>VK_IMAGE_CREATE_MUTABLE_FORMAT_BIT</code>, and the <code>aspectMask</code> of the <code>imageView</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_ASPECT_PLANE_0_BIT</code>, <code>VK_IMAGE_ASPECT_PLANE_1_BIT</code> or (for three-plane formats only) <code>VK_IMAGE_ASPECT_PLANE_2_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_KHR_portability_subset)": [
|
|
{
|
|
"vuid": "VUID-VkDescriptorImageInfo-mutableComparisonSamplers-04450",
|
|
"text": " If the <code><a href=\"#VK_KHR_portability_subset\">VK_KHR_portability_subset</a></code> extension is enabled, and <a href=\"#VkPhysicalDevicePortabilitySubsetFeaturesKHR\">VkPhysicalDevicePortabilitySubsetFeaturesKHR</a>::<code>mutableComparisonSamplers</code> is <code>VK_FALSE</code>, then <code>sampler</code> <strong class=\"purple\">must</strong> have been created with <a href=\"#VkSamplerCreateInfo\">VkSamplerCreateInfo</a>::<code>compareEnable</code> set to <code>VK_FALSE</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkWriteDescriptorSetInlineUniformBlock": {
|
|
"(VK_VERSION_1_3,VK_EXT_inline_uniform_block)": [
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSetInlineUniformBlock-dataSize-02222",
|
|
"text": " <code>dataSize</code> <strong class=\"purple\">must</strong> be an integer multiple of <code>4</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSetInlineUniformBlock-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_WRITE_DESCRIPTOR_SET_INLINE_UNIFORM_BLOCK</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSetInlineUniformBlock-pData-parameter",
|
|
"text": " <code>pData</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>dataSize</code> bytes"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSetInlineUniformBlock-dataSize-arraylength",
|
|
"text": " <code>dataSize</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkWriteDescriptorSetAccelerationStructureKHR": {
|
|
"(VK_KHR_acceleration_structure)": [
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSetAccelerationStructureKHR-accelerationStructureCount-02236",
|
|
"text": " <code>accelerationStructureCount</code> <strong class=\"purple\">must</strong> be equal to <code>descriptorCount</code> in the extended structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSetAccelerationStructureKHR-pAccelerationStructures-03579",
|
|
"text": " Each acceleration structure in <code>pAccelerationStructures</code> <strong class=\"purple\">must</strong> have been created with a <code>type</code> of <code>VK_ACCELERATION_STRUCTURE_TYPE_TOP_LEVEL_KHR</code> or <code>VK_ACCELERATION_STRUCTURE_TYPE_GENERIC_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSetAccelerationStructureKHR-pAccelerationStructures-03580",
|
|
"text": " If the <a href=\"#features-nullDescriptor\"><code>nullDescriptor</code></a> feature is not enabled, each element of <code>pAccelerationStructures</code> <strong class=\"purple\">must</strong> not be <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSetAccelerationStructureKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_WRITE_DESCRIPTOR_SET_ACCELERATION_STRUCTURE_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSetAccelerationStructureKHR-pAccelerationStructures-parameter",
|
|
"text": " <code>pAccelerationStructures</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>accelerationStructureCount</code> valid or <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> <a href=\"#VkAccelerationStructureKHR\">VkAccelerationStructureKHR</a> handles"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSetAccelerationStructureKHR-accelerationStructureCount-arraylength",
|
|
"text": " <code>accelerationStructureCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkWriteDescriptorSetAccelerationStructureNV": {
|
|
"(VK_NV_ray_tracing)": [
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSetAccelerationStructureNV-accelerationStructureCount-03747",
|
|
"text": " <code>accelerationStructureCount</code> <strong class=\"purple\">must</strong> be equal to <code>descriptorCount</code> in the extended structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSetAccelerationStructureNV-pAccelerationStructures-03748",
|
|
"text": " Each acceleration structure in <code>pAccelerationStructures</code> <strong class=\"purple\">must</strong> have been created with <code>VK_ACCELERATION_STRUCTURE_TYPE_TOP_LEVEL_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSetAccelerationStructureNV-pAccelerationStructures-03749",
|
|
"text": " If the <a href=\"#features-nullDescriptor\"><code>nullDescriptor</code></a> feature is not enabled, each member of <code>pAccelerationStructures</code> <strong class=\"purple\">must</strong> not be <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSetAccelerationStructureNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_WRITE_DESCRIPTOR_SET_ACCELERATION_STRUCTURE_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSetAccelerationStructureNV-pAccelerationStructures-parameter",
|
|
"text": " <code>pAccelerationStructures</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>accelerationStructureCount</code> valid or <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> <a href=\"#VkAccelerationStructureNV\">VkAccelerationStructureNV</a> handles"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWriteDescriptorSetAccelerationStructureNV-accelerationStructureCount-arraylength",
|
|
"text": " <code>accelerationStructureCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkCopyDescriptorSet": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkCopyDescriptorSet-srcBinding-00345",
|
|
"text": " <code>srcBinding</code> <strong class=\"purple\">must</strong> be a valid binding within <code>srcSet</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyDescriptorSet-srcArrayElement-00346",
|
|
"text": " The sum of <code>srcArrayElement</code> and <code>descriptorCount</code> <strong class=\"purple\">must</strong> be less than or equal to the number of array elements in the descriptor set binding specified by <code>srcBinding</code>, and all applicable consecutive bindings, as described by <a href=\"#descriptorsets-updates-consecutive\">consecutive binding updates</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyDescriptorSet-dstBinding-00347",
|
|
"text": " <code>dstBinding</code> <strong class=\"purple\">must</strong> be a valid binding within <code>dstSet</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyDescriptorSet-dstArrayElement-00348",
|
|
"text": " The sum of <code>dstArrayElement</code> and <code>descriptorCount</code> <strong class=\"purple\">must</strong> be less than or equal to the number of array elements in the descriptor set binding specified by <code>dstBinding</code>, and all applicable consecutive bindings, as described by <a href=\"#descriptorsets-updates-consecutive\">consecutive binding updates</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyDescriptorSet-dstBinding-02632",
|
|
"text": " The type of <code>dstBinding</code> within <code>dstSet</code> <strong class=\"purple\">must</strong> be equal to the type of <code>srcBinding</code> within <code>srcSet</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyDescriptorSet-srcSet-00349",
|
|
"text": " If <code>srcSet</code> is equal to <code>dstSet</code>, then the source and destination ranges of descriptors <strong class=\"purple\">must</strong> not overlap, where the ranges <strong class=\"purple\">may</strong> include array elements from consecutive bindings as described by <a href=\"#descriptorsets-updates-consecutive\">consecutive binding updates</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyDescriptorSet-dstBinding-02753",
|
|
"text": " If the descriptor type of the descriptor set binding specified by <code>dstBinding</code> is <code>VK_DESCRIPTOR_TYPE_SAMPLER</code>, then <code>dstSet</code> <strong class=\"purple\">must</strong> not have been allocated with a layout that included immutable samplers for <code>dstBinding</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyDescriptorSet-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_COPY_DESCRIPTOR_SET</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyDescriptorSet-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyDescriptorSet-srcSet-parameter",
|
|
"text": " <code>srcSet</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDescriptorSet\">VkDescriptorSet</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyDescriptorSet-dstSet-parameter",
|
|
"text": " <code>dstSet</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDescriptorSet\">VkDescriptorSet</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyDescriptorSet-commonparent",
|
|
"text": " Both of <code>dstSet</code>, and <code>srcSet</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_inline_uniform_block)": [
|
|
{
|
|
"vuid": "VUID-VkCopyDescriptorSet-srcBinding-02223",
|
|
"text": " If the descriptor type of the descriptor set binding specified by <code>srcBinding</code> is <code>VK_DESCRIPTOR_TYPE_INLINE_UNIFORM_BLOCK</code>, <code>srcArrayElement</code> <strong class=\"purple\">must</strong> be an integer multiple of <code>4</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyDescriptorSet-dstBinding-02224",
|
|
"text": " If the descriptor type of the descriptor set binding specified by <code>dstBinding</code> is <code>VK_DESCRIPTOR_TYPE_INLINE_UNIFORM_BLOCK</code>, <code>dstArrayElement</code> <strong class=\"purple\">must</strong> be an integer multiple of <code>4</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyDescriptorSet-srcBinding-02225",
|
|
"text": " If the descriptor type of the descriptor set binding specified by either <code>srcBinding</code> or <code>dstBinding</code> is <code>VK_DESCRIPTOR_TYPE_INLINE_UNIFORM_BLOCK</code>, <code>descriptorCount</code> <strong class=\"purple\">must</strong> be an integer multiple of <code>4</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_EXT_descriptor_indexing)": [
|
|
{
|
|
"vuid": "VUID-VkCopyDescriptorSet-srcSet-01918",
|
|
"text": " If <code>srcSet</code>’s layout was created with the <code>VK_DESCRIPTOR_SET_LAYOUT_CREATE_UPDATE_AFTER_BIND_POOL_BIT</code> flag set, then <code>dstSet</code>’s layout <strong class=\"purple\">must</strong> also have been created with the <code>VK_DESCRIPTOR_SET_LAYOUT_CREATE_UPDATE_AFTER_BIND_POOL_BIT</code> flag set"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyDescriptorSet-srcSet-01920",
|
|
"text": " If the descriptor pool from which <code>srcSet</code> was allocated was created with the <code>VK_DESCRIPTOR_POOL_CREATE_UPDATE_AFTER_BIND_BIT</code> flag set, then the descriptor pool from which <code>dstSet</code> was allocated <strong class=\"purple\">must</strong> also have been created with the <code>VK_DESCRIPTOR_POOL_CREATE_UPDATE_AFTER_BIND_BIT</code> flag set"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_EXT_descriptor_indexing)+(VK_VALVE_mutable_descriptor_type)": [
|
|
{
|
|
"vuid": "VUID-VkCopyDescriptorSet-srcSet-04885",
|
|
"text": " If <code>srcSet</code>’s layout was created with neither <code>VK_DESCRIPTOR_SET_LAYOUT_CREATE_UPDATE_AFTER_BIND_POOL_BIT</code> nor <code>VK_DESCRIPTOR_SET_LAYOUT_CREATE_HOST_ONLY_POOL_BIT_VALVE</code> flags set, then <code>dstSet</code>’s layout <strong class=\"purple\">must</strong> have been created without the <code>VK_DESCRIPTOR_SET_LAYOUT_CREATE_UPDATE_AFTER_BIND_POOL_BIT</code> flag set"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyDescriptorSet-srcSet-04887",
|
|
"text": " If the descriptor pool from which <code>srcSet</code> was allocated was created with neither <code>VK_DESCRIPTOR_POOL_CREATE_UPDATE_AFTER_BIND_BIT</code> nor <code>VK_DESCRIPTOR_POOL_CREATE_HOST_ONLY_BIT_VALVE</code> flags set, then the descriptor pool from which <code>dstSet</code> was allocated <strong class=\"purple\">must</strong> have been created without the <code>VK_DESCRIPTOR_POOL_CREATE_UPDATE_AFTER_BIND_BIT</code> flag set"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_EXT_descriptor_indexing)+!(VK_VALVE_mutable_descriptor_type)": [
|
|
{
|
|
"vuid": "VUID-VkCopyDescriptorSet-srcSet-04886",
|
|
"text": " If <code>srcSet</code>’s layout was created without the <code>VK_DESCRIPTOR_SET_LAYOUT_CREATE_UPDATE_AFTER_BIND_POOL_BIT</code> flag set, then <code>dstSet</code>’s layout <strong class=\"purple\">must</strong> also have been created without the <code>VK_DESCRIPTOR_SET_LAYOUT_CREATE_UPDATE_AFTER_BIND_POOL_BIT</code> flag set"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyDescriptorSet-srcSet-04888",
|
|
"text": " If the descriptor pool from which <code>srcSet</code> was allocated was created without the <code>VK_DESCRIPTOR_POOL_CREATE_UPDATE_AFTER_BIND_BIT</code> flag set, then the descriptor pool from which <code>dstSet</code> was allocated <strong class=\"purple\">must</strong> also have been created without the <code>VK_DESCRIPTOR_POOL_CREATE_UPDATE_AFTER_BIND_BIT</code> flag set"
|
|
}
|
|
],
|
|
"(VK_VALVE_mutable_descriptor_type)": [
|
|
{
|
|
"vuid": "VUID-VkCopyDescriptorSet-dstSet-04612",
|
|
"text": " If <code>VkDescriptorSetLayoutBinding</code> for <code>dstSet</code> at <code>dstBinding</code> is <code>VK_DESCRIPTOR_TYPE_MUTABLE_VALVE</code>, the new active descriptor type <strong class=\"purple\">must</strong> exist in the corresponding <code>pMutableDescriptorTypeLists</code> list for <code>dstBinding</code> if the new active descriptor type is not <code>VK_DESCRIPTOR_TYPE_MUTABLE_VALVE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyDescriptorSet-srcSet-04613",
|
|
"text": " If <code>VkDescriptorSetLayoutBinding</code> for <code>srcSet</code> at <code>srcBinding</code> is <code>VK_DESCRIPTOR_TYPE_MUTABLE_VALVE</code> and the <code>VkDescriptorSetLayoutBinding</code> for <code>dstSet</code> at <code>dstBinding</code> is not <code>VK_DESCRIPTOR_TYPE_MUTABLE_VALVE</code>, the active descriptor type for the source descriptor <strong class=\"purple\">must</strong> match the descriptor type of <code>dstBinding</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyDescriptorSet-dstSet-04614",
|
|
"text": " If <code>VkDescriptorSetLayoutBinding</code> for <code>dstSet</code> at <code>dstBinding</code> is <code>VK_DESCRIPTOR_TYPE_MUTABLE_VALVE</code>, and the new active descriptor type is <code>VK_DESCRIPTOR_TYPE_MUTABLE_VALVE</code>, the <code>pMutableDescriptorTypeLists</code> for <code>srcBinding</code> and <code>dstBinding</code> <strong class=\"purple\">must</strong> match exactly"
|
|
}
|
|
]
|
|
},
|
|
"vkCreateDescriptorUpdateTemplate": {
|
|
"(VK_VERSION_1_1,VK_KHR_descriptor_update_template)": [
|
|
{
|
|
"vuid": "VUID-vkCreateDescriptorUpdateTemplate-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateDescriptorUpdateTemplate-pCreateInfo-parameter",
|
|
"text": " <code>pCreateInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkDescriptorUpdateTemplateCreateInfo\">VkDescriptorUpdateTemplateCreateInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateDescriptorUpdateTemplate-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateDescriptorUpdateTemplate-pDescriptorUpdateTemplate-parameter",
|
|
"text": " <code>pDescriptorUpdateTemplate</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkDescriptorUpdateTemplate\">VkDescriptorUpdateTemplate</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkDescriptorUpdateTemplateCreateInfo": {
|
|
"(VK_VERSION_1_1,VK_KHR_descriptor_update_template)": [
|
|
{
|
|
"vuid": "VUID-VkDescriptorUpdateTemplateCreateInfo-templateType-00350",
|
|
"text": " If <code>templateType</code> is <code>VK_DESCRIPTOR_UPDATE_TEMPLATE_TYPE_DESCRIPTOR_SET</code>, <code>descriptorSetLayout</code> <strong class=\"purple\">must</strong> be a valid <code>VkDescriptorSetLayout</code> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorUpdateTemplateCreateInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_DESCRIPTOR_UPDATE_TEMPLATE_CREATE_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorUpdateTemplateCreateInfo-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorUpdateTemplateCreateInfo-flags-zerobitmask",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorUpdateTemplateCreateInfo-pDescriptorUpdateEntries-parameter",
|
|
"text": " <code>pDescriptorUpdateEntries</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>descriptorUpdateEntryCount</code> valid <a href=\"#VkDescriptorUpdateTemplateEntry\">VkDescriptorUpdateTemplateEntry</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorUpdateTemplateCreateInfo-templateType-parameter",
|
|
"text": " <code>templateType</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDescriptorUpdateTemplateType\">VkDescriptorUpdateTemplateType</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorUpdateTemplateCreateInfo-descriptorUpdateEntryCount-arraylength",
|
|
"text": " <code>descriptorUpdateEntryCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorUpdateTemplateCreateInfo-commonparent",
|
|
"text": " Both of <code>descriptorSetLayout</code>, and <code>pipelineLayout</code> that are valid handles of non-ignored parameters <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_descriptor_update_template)+(VK_KHR_push_descriptor)": [
|
|
{
|
|
"vuid": "VUID-VkDescriptorUpdateTemplateCreateInfo-templateType-00351",
|
|
"text": " If <code>templateType</code> is <code>VK_DESCRIPTOR_UPDATE_TEMPLATE_TYPE_PUSH_DESCRIPTORS_KHR</code>, <code>pipelineBindPoint</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPipelineBindPoint\">VkPipelineBindPoint</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorUpdateTemplateCreateInfo-templateType-00352",
|
|
"text": " If <code>templateType</code> is <code>VK_DESCRIPTOR_UPDATE_TEMPLATE_TYPE_PUSH_DESCRIPTORS_KHR</code>, <code>pipelineLayout</code> <strong class=\"purple\">must</strong> be a valid <code>VkPipelineLayout</code> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorUpdateTemplateCreateInfo-templateType-00353",
|
|
"text": " If <code>templateType</code> is <code>VK_DESCRIPTOR_UPDATE_TEMPLATE_TYPE_PUSH_DESCRIPTORS_KHR</code>, <code>set</code> <strong class=\"purple\">must</strong> be the unique set number in the pipeline layout that uses a descriptor set layout that was created with <code>VK_DESCRIPTOR_SET_LAYOUT_CREATE_PUSH_DESCRIPTOR_BIT_KHR</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_descriptor_update_template)+(VK_VALVE_mutable_descriptor_type)": [
|
|
{
|
|
"vuid": "VUID-VkDescriptorUpdateTemplateCreateInfo-templateType-04615",
|
|
"text": " If <code>templateType</code> is <code>VK_DESCRIPTOR_UPDATE_TEMPLATE_TYPE_DESCRIPTOR_SET</code>, <code>descriptorSetLayout</code> <strong class=\"purple\">must</strong> not contain a binding with type <code>VK_DESCRIPTOR_TYPE_MUTABLE_VALVE</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkDescriptorUpdateTemplateEntry": {
|
|
"(VK_VERSION_1_1,VK_KHR_descriptor_update_template)": [
|
|
{
|
|
"vuid": "VUID-VkDescriptorUpdateTemplateEntry-dstBinding-00354",
|
|
"text": " <code>dstBinding</code> <strong class=\"purple\">must</strong> be a valid binding in the descriptor set layout implicitly specified when using a descriptor update template to update descriptors"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorUpdateTemplateEntry-dstArrayElement-00355",
|
|
"text": " <code>dstArrayElement</code> and <code>descriptorCount</code> <strong class=\"purple\">must</strong> be less than or equal to the number of array elements in the descriptor set binding implicitly specified when using a descriptor update template to update descriptors, and all applicable consecutive bindings, as described by <a href=\"#descriptorsets-updates-consecutive\">consecutive binding updates</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorUpdateTemplateEntry-descriptorType-parameter",
|
|
"text": " <code>descriptorType</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDescriptorType\">VkDescriptorType</a> value"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_descriptor_update_template)+(VK_VERSION_1_3,VK_EXT_inline_uniform_block)": [
|
|
{
|
|
"vuid": "VUID-VkDescriptorUpdateTemplateEntry-descriptor-02226",
|
|
"text": " If <code>descriptor</code> type is <code>VK_DESCRIPTOR_TYPE_INLINE_UNIFORM_BLOCK</code>, <code>dstArrayElement</code> <strong class=\"purple\">must</strong> be an integer multiple of <code>4</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorUpdateTemplateEntry-descriptor-02227",
|
|
"text": " If <code>descriptor</code> type is <code>VK_DESCRIPTOR_TYPE_INLINE_UNIFORM_BLOCK</code>, <code>descriptorCount</code> <strong class=\"purple\">must</strong> be an integer multiple of <code>4</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkDestroyDescriptorUpdateTemplate": {
|
|
"(VK_VERSION_1_1,VK_KHR_descriptor_update_template)": [
|
|
{
|
|
"vuid": "VUID-vkDestroyDescriptorUpdateTemplate-descriptorSetLayout-00356",
|
|
"text": " If <code>VkAllocationCallbacks</code> were provided when <code>descriptorUpdateTemplate</code> was created, a compatible set of callbacks <strong class=\"purple\">must</strong> be provided here"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyDescriptorUpdateTemplate-descriptorSetLayout-00357",
|
|
"text": " If no <code>VkAllocationCallbacks</code> were provided when <code>descriptorUpdateTemplate</code> was created, <code>pAllocator</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyDescriptorUpdateTemplate-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyDescriptorUpdateTemplate-descriptorUpdateTemplate-parameter",
|
|
"text": " If <code>descriptorUpdateTemplate</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>descriptorUpdateTemplate</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDescriptorUpdateTemplate\">VkDescriptorUpdateTemplate</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyDescriptorUpdateTemplate-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyDescriptorUpdateTemplate-descriptorUpdateTemplate-parent",
|
|
"text": " If <code>descriptorUpdateTemplate</code> is a valid handle, it <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkUpdateDescriptorSetWithTemplate": {
|
|
"(VK_VERSION_1_1,VK_KHR_descriptor_update_template)": [
|
|
{
|
|
"vuid": "VUID-vkUpdateDescriptorSetWithTemplate-pData-01685",
|
|
"text": " <code>pData</code> <strong class=\"purple\">must</strong> be a valid pointer to a memory containing one or more valid instances of <a href=\"#VkDescriptorImageInfo\">VkDescriptorImageInfo</a>, <a href=\"#VkDescriptorBufferInfo\">VkDescriptorBufferInfo</a>, or <a href=\"#VkBufferView\">VkBufferView</a> in a layout defined by <code>descriptorUpdateTemplate</code> when it was created with <a href=\"#vkCreateDescriptorUpdateTemplate\">vkCreateDescriptorUpdateTemplate</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkUpdateDescriptorSetWithTemplate-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkUpdateDescriptorSetWithTemplate-descriptorSet-parameter",
|
|
"text": " <code>descriptorSet</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDescriptorSet\">VkDescriptorSet</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkUpdateDescriptorSetWithTemplate-descriptorUpdateTemplate-parameter",
|
|
"text": " <code>descriptorUpdateTemplate</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDescriptorUpdateTemplate\">VkDescriptorUpdateTemplate</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkUpdateDescriptorSetWithTemplate-descriptorUpdateTemplate-parent",
|
|
"text": " <code>descriptorUpdateTemplate</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_descriptor_update_template)+!(VK_VERSION_1_2,VK_EXT_descriptor_indexing)": [
|
|
{
|
|
"vuid": "VUID-vkUpdateDescriptorSetWithTemplate-descriptorSet-06994",
|
|
"text": " Host access to <code>descriptorSet</code> <strong class=\"purple\">must</strong> be <a href=\"#fundamentals-threadingbehavior\">externally synchronized</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_descriptor_update_template)+(VK_VERSION_1_2,VK_EXT_descriptor_indexing)": [
|
|
{
|
|
"vuid": "VUID-vkUpdateDescriptorSetWithTemplate-descriptorSet-06995",
|
|
"text": " Host access to <code>descriptorSet</code> <strong class=\"purple\">must</strong> be <a href=\"#fundamentals-threadingbehavior\">externally synchronized</a> unless explicitly denoted otherwise for specific flags"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdBindDescriptorSets": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCmdBindDescriptorSets-pDescriptorSets-00358",
|
|
"text": " Each element of <code>pDescriptorSets</code> <strong class=\"purple\">must</strong> have been allocated with a <code>VkDescriptorSetLayout</code> that matches (is the same as, or identically defined as) the <code>VkDescriptorSetLayout</code> at set <em>n</em> in <code>layout</code>, where <em>n</em> is the sum of <code>firstSet</code> and the index into <code>pDescriptorSets</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindDescriptorSets-dynamicOffsetCount-00359",
|
|
"text": " <code>dynamicOffsetCount</code> <strong class=\"purple\">must</strong> be equal to the total number of dynamic descriptors in <code>pDescriptorSets</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindDescriptorSets-firstSet-00360",
|
|
"text": " The sum of <code>firstSet</code> and <code>descriptorSetCount</code> <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#VkPipelineLayoutCreateInfo\">VkPipelineLayoutCreateInfo</a>::<code>setLayoutCount</code> provided when <code>layout</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindDescriptorSets-pipelineBindPoint-00361",
|
|
"text": " <code>pipelineBindPoint</code> <strong class=\"purple\">must</strong> be supported by the <code>commandBuffer</code>’s parent <code>VkCommandPool</code>’s queue family"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindDescriptorSets-pDynamicOffsets-01971",
|
|
"text": " Each element of <code>pDynamicOffsets</code> which corresponds to a descriptor binding with type <code>VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER_DYNAMIC</code> <strong class=\"purple\">must</strong> be a multiple of <code>VkPhysicalDeviceLimits</code>::<code>minUniformBufferOffsetAlignment</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindDescriptorSets-pDynamicOffsets-01972",
|
|
"text": " Each element of <code>pDynamicOffsets</code> which corresponds to a descriptor binding with type <code>VK_DESCRIPTOR_TYPE_STORAGE_BUFFER_DYNAMIC</code> <strong class=\"purple\">must</strong> be a multiple of <code>VkPhysicalDeviceLimits</code>::<code>minStorageBufferOffsetAlignment</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindDescriptorSets-pDescriptorSets-01979",
|
|
"text": " For each dynamic uniform or storage buffer binding in <code>pDescriptorSets</code>, the sum of the <a href=\"#dynamic-effective-offset\">effective offset</a> and the range of the binding <strong class=\"purple\">must</strong> be less than or equal to the size of the buffer"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindDescriptorSets-pDescriptorSets-06715",
|
|
"text": " For each dynamic uniform or storage buffer binding in <code>pDescriptorSets</code>, if the range was set with <code>VK_WHOLE_SIZE</code> then <code>pDynamicOffsets</code> which corresponds to the descriptor binding <strong class=\"purple\">must</strong> be 0"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindDescriptorSets-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindDescriptorSets-pipelineBindPoint-parameter",
|
|
"text": " <code>pipelineBindPoint</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPipelineBindPoint\">VkPipelineBindPoint</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindDescriptorSets-layout-parameter",
|
|
"text": " <code>layout</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPipelineLayout\">VkPipelineLayout</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindDescriptorSets-pDescriptorSets-parameter",
|
|
"text": " <code>pDescriptorSets</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>descriptorSetCount</code> valid or <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> <a href=\"#VkDescriptorSet\">VkDescriptorSet</a> handles"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindDescriptorSets-pDynamicOffsets-parameter",
|
|
"text": " If <code>dynamicOffsetCount</code> is not <code>0</code>, <code>pDynamicOffsets</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>dynamicOffsetCount</code> <code>uint32_t</code> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindDescriptorSets-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindDescriptorSets-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics, or compute operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindDescriptorSets-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindDescriptorSets-descriptorSetCount-arraylength",
|
|
"text": " <code>descriptorSetCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindDescriptorSets-commonparent",
|
|
"text": " Each of <code>commandBuffer</code>, <code>layout</code>, and the elements of <code>pDescriptorSets</code> that are valid handles of non-ignored parameters <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"(VK_VALVE_mutable_descriptor_type)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBindDescriptorSets-pDescriptorSets-04616",
|
|
"text": " Each element of <code>pDescriptorSets</code> <strong class=\"purple\">must</strong> not have been allocated from a <code>VkDescriptorPool</code> with the <code>VK_DESCRIPTOR_POOL_CREATE_HOST_ONLY_BIT_VALVE</code> flag set"
|
|
}
|
|
],
|
|
"!(VK_EXT_graphics_pipeline_library)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBindDescriptorSets-pDescriptorSets-06563",
|
|
"text": " Each element of <code>pDescriptorSets</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDescriptorSet\">VkDescriptorSet</a>"
|
|
}
|
|
],
|
|
"(VK_EXT_graphics_pipeline_library)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBindDescriptorSets-graphicsPipelineLibrary-06754",
|
|
"text": " If <a href=\"#features-graphicsPipelineLibrary\"><code>graphicsPipelineLibrary</code></a> is not enabled, each element of <code>pDescriptorSets</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDescriptorSet\">VkDescriptorSet</a>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdPushDescriptorSetKHR": {
|
|
"(VK_KHR_push_descriptor)": [
|
|
{
|
|
"vuid": "VUID-vkCmdPushDescriptorSetKHR-pipelineBindPoint-00363",
|
|
"text": " <code>pipelineBindPoint</code> <strong class=\"purple\">must</strong> be supported by the <code>commandBuffer</code>’s parent <code>VkCommandPool</code>’s queue family"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPushDescriptorSetKHR-set-00364",
|
|
"text": " <code>set</code> <strong class=\"purple\">must</strong> be less than <a href=\"#VkPipelineLayoutCreateInfo\">VkPipelineLayoutCreateInfo</a>::<code>setLayoutCount</code> provided when <code>layout</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPushDescriptorSetKHR-set-00365",
|
|
"text": " <code>set</code> <strong class=\"purple\">must</strong> be the unique set number in the pipeline layout that uses a descriptor set layout that was created with <code>VK_DESCRIPTOR_SET_LAYOUT_CREATE_PUSH_DESCRIPTOR_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPushDescriptorSetKHR-pDescriptorWrites-06494",
|
|
"text": " For each element <span class=\"eq\">i</span> where <code>pDescriptorWrites</code>[i].<code>descriptorType</code> is <code>VK_DESCRIPTOR_TYPE_SAMPLED_IMAGE</code>, <code>VK_DESCRIPTOR_TYPE_STORAGE_IMAGE</code>, or <code>VK_DESCRIPTOR_TYPE_INPUT_ATTACHMENT</code>, <code>pDescriptorWrites</code>[i].<code>pImageInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>pDescriptorWrites</code>[i].<code>descriptorCount</code> valid <code>VkDescriptorImageInfo</code> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPushDescriptorSetKHR-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPushDescriptorSetKHR-pipelineBindPoint-parameter",
|
|
"text": " <code>pipelineBindPoint</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPipelineBindPoint\">VkPipelineBindPoint</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPushDescriptorSetKHR-layout-parameter",
|
|
"text": " <code>layout</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPipelineLayout\">VkPipelineLayout</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPushDescriptorSetKHR-pDescriptorWrites-parameter",
|
|
"text": " <code>pDescriptorWrites</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>descriptorWriteCount</code> valid <a href=\"#VkWriteDescriptorSet\">VkWriteDescriptorSet</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPushDescriptorSetKHR-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPushDescriptorSetKHR-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics, or compute operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPushDescriptorSetKHR-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPushDescriptorSetKHR-descriptorWriteCount-arraylength",
|
|
"text": " <code>descriptorWriteCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPushDescriptorSetKHR-commonparent",
|
|
"text": " Both of <code>commandBuffer</code>, and <code>layout</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdPushDescriptorSetWithTemplateKHR": {
|
|
"(VK_KHR_push_descriptor)+(VK_VERSION_1_1,VK_KHR_descriptor_update_template)": [
|
|
{
|
|
"vuid": "VUID-vkCmdPushDescriptorSetWithTemplateKHR-commandBuffer-00366",
|
|
"text": " The <code>pipelineBindPoint</code> specified during the creation of the descriptor update template <strong class=\"purple\">must</strong> be supported by the <code>commandBuffer</code>’s parent <code>VkCommandPool</code>’s queue family"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPushDescriptorSetWithTemplateKHR-pData-01686",
|
|
"text": " <code>pData</code> <strong class=\"purple\">must</strong> be a valid pointer to a memory containing one or more valid instances of <a href=\"#VkDescriptorImageInfo\">VkDescriptorImageInfo</a>, <a href=\"#VkDescriptorBufferInfo\">VkDescriptorBufferInfo</a>, or <a href=\"#VkBufferView\">VkBufferView</a> in a layout defined by <code>descriptorUpdateTemplate</code> when it was created with <a href=\"#vkCreateDescriptorUpdateTemplate\">vkCreateDescriptorUpdateTemplate</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPushDescriptorSetWithTemplateKHR-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPushDescriptorSetWithTemplateKHR-descriptorUpdateTemplate-parameter",
|
|
"text": " <code>descriptorUpdateTemplate</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDescriptorUpdateTemplate\">VkDescriptorUpdateTemplate</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPushDescriptorSetWithTemplateKHR-layout-parameter",
|
|
"text": " <code>layout</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPipelineLayout\">VkPipelineLayout</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPushDescriptorSetWithTemplateKHR-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPushDescriptorSetWithTemplateKHR-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics, or compute operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPushDescriptorSetWithTemplateKHR-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPushDescriptorSetWithTemplateKHR-commonparent",
|
|
"text": " Each of <code>commandBuffer</code>, <code>descriptorUpdateTemplate</code>, and <code>layout</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdPushConstants": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCmdPushConstants-offset-01795",
|
|
"text": " For each byte in the range specified by <code>offset</code> and <code>size</code> and for each shader stage in <code>stageFlags</code>, there <strong class=\"purple\">must</strong> be a push constant range in <code>layout</code> that includes that byte and that stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPushConstants-offset-01796",
|
|
"text": " For each byte in the range specified by <code>offset</code> and <code>size</code> and for each push constant range that overlaps that byte, <code>stageFlags</code> <strong class=\"purple\">must</strong> include all stages in that push constant range’s <a href=\"#VkPushConstantRange\">VkPushConstantRange</a>::<code>stageFlags</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPushConstants-offset-00368",
|
|
"text": " <code>offset</code> <strong class=\"purple\">must</strong> be a multiple of <code>4</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPushConstants-size-00369",
|
|
"text": " <code>size</code> <strong class=\"purple\">must</strong> be a multiple of <code>4</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPushConstants-offset-00370",
|
|
"text": " <code>offset</code> <strong class=\"purple\">must</strong> be less than <code>VkPhysicalDeviceLimits</code>::<code>maxPushConstantsSize</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPushConstants-size-00371",
|
|
"text": " <code>size</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxPushConstantsSize</code> minus <code>offset</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPushConstants-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPushConstants-layout-parameter",
|
|
"text": " <code>layout</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPipelineLayout\">VkPipelineLayout</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPushConstants-stageFlags-parameter",
|
|
"text": " <code>stageFlags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkShaderStageFlagBits\">VkShaderStageFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPushConstants-stageFlags-requiredbitmask",
|
|
"text": " <code>stageFlags</code> <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPushConstants-pValues-parameter",
|
|
"text": " <code>pValues</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>size</code> bytes"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPushConstants-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPushConstants-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics, or compute operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPushConstants-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPushConstants-size-arraylength",
|
|
"text": " <code>size</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPushConstants-commonparent",
|
|
"text": " Both of <code>commandBuffer</code>, and <code>layout</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetBufferDeviceAddress": {
|
|
"(VK_VERSION_1_2,VK_EXT_buffer_device_address,VK_KHR_buffer_device_address)+(VK_EXT_buffer_device_address)": [
|
|
{
|
|
"vuid": "VUID-vkGetBufferDeviceAddress-bufferDeviceAddress-03324",
|
|
"text": " The <a href=\"#features-bufferDeviceAddress\"><code>bufferDeviceAddress</code></a> or <a href=\"#features-bufferDeviceAddressEXT\"><code>VkPhysicalDeviceBufferDeviceAddressFeaturesEXT</code>::<code>bufferDeviceAddress</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetBufferDeviceAddress-device-03325",
|
|
"text": " If <code>device</code> was created with multiple physical devices, then the <a href=\"#features-bufferDeviceAddressMultiDevice\"><code>bufferDeviceAddressMultiDevice</code></a> or <a href=\"#features-bufferDeviceAddressMultiDeviceEXT\"><code>VkPhysicalDeviceBufferDeviceAddressFeaturesEXT</code>::<code>bufferDeviceAddressMultiDevice</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_EXT_buffer_device_address,VK_KHR_buffer_device_address)+!(VK_EXT_buffer_device_address)": [
|
|
{
|
|
"vuid": "VUID-vkGetBufferDeviceAddress-None-06542",
|
|
"text": " The <a href=\"#features-bufferDeviceAddress\"><code>bufferDeviceAddress</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetBufferDeviceAddress-device-06543",
|
|
"text": " If <code>device</code> was created with multiple physical devices, then the <a href=\"#features-bufferDeviceAddressMultiDevice\"><code>bufferDeviceAddressMultiDevice</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_EXT_buffer_device_address,VK_KHR_buffer_device_address)": [
|
|
{
|
|
"vuid": "VUID-vkGetBufferDeviceAddress-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetBufferDeviceAddress-pInfo-parameter",
|
|
"text": " <code>pInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkBufferDeviceAddressInfo\">VkBufferDeviceAddressInfo</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkBufferDeviceAddressInfo": {
|
|
"(VK_VERSION_1_2,VK_EXT_buffer_device_address,VK_KHR_buffer_device_address)": [
|
|
{
|
|
"vuid": "VUID-VkBufferDeviceAddressInfo-buffer-02600",
|
|
"text": " If <code>buffer</code> is non-sparse and was not created with the <code>VK_BUFFER_CREATE_DEVICE_ADDRESS_CAPTURE_REPLAY_BIT</code> flag, then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferDeviceAddressInfo-buffer-02601",
|
|
"text": " <code>buffer</code> <strong class=\"purple\">must</strong> have been created with <code>VK_BUFFER_USAGE_SHADER_DEVICE_ADDRESS_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferDeviceAddressInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_BUFFER_DEVICE_ADDRESS_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferDeviceAddressInfo-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferDeviceAddressInfo-buffer-parameter",
|
|
"text": " <code>buffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBuffer\">VkBuffer</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"vkGetBufferOpaqueCaptureAddress": {
|
|
"(VK_VERSION_1_2,VK_KHR_buffer_device_address)": [
|
|
{
|
|
"vuid": "VUID-vkGetBufferOpaqueCaptureAddress-None-03326",
|
|
"text": " The <a href=\"#features-bufferDeviceAddress\"><code>bufferDeviceAddress</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetBufferOpaqueCaptureAddress-device-03327",
|
|
"text": " If <code>device</code> was created with multiple physical devices, then the <a href=\"#features-bufferDeviceAddressMultiDevice\"><code>bufferDeviceAddressMultiDevice</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetBufferOpaqueCaptureAddress-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetBufferOpaqueCaptureAddress-pInfo-parameter",
|
|
"text": " <code>pInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkBufferDeviceAddressInfo\">VkBufferDeviceAddressInfo</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"BaryCoordKHR": {
|
|
"(VK_NV_fragment_shader_barycentric,VK_KHR_fragment_shader_barycentric)": [
|
|
{
|
|
"vuid": "VUID-BaryCoordKHR-BaryCoordKHR-04154",
|
|
"text": " The <code>BaryCoordKHR</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>Fragment</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-BaryCoordKHR-BaryCoordKHR-04155",
|
|
"text": " The variable decorated with <code>BaryCoordKHR</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-BaryCoordKHR-BaryCoordKHR-04156",
|
|
"text": " The variable decorated with <code>BaryCoordKHR</code> <strong class=\"purple\">must</strong> be declared as a three-component vector of 32-bit floating-point values"
|
|
}
|
|
]
|
|
},
|
|
"BaryCoordNoPerspAMD": {
|
|
"(VK_AMD_shader_explicit_vertex_parameter)": [
|
|
{
|
|
"vuid": "VUID-BaryCoordNoPerspAMD-BaryCoordNoPerspAMD-04157",
|
|
"text": " The <code>BaryCoordNoPerspAMD</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>Fragment</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-BaryCoordNoPerspAMD-BaryCoordNoPerspAMD-04158",
|
|
"text": " The variable decorated with <code>BaryCoordNoPerspAMD</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-BaryCoordNoPerspAMD-BaryCoordNoPerspAMD-04159",
|
|
"text": " The variable decorated with <code>BaryCoordNoPerspAMD</code> <strong class=\"purple\">must</strong> be declared as a two-component vector of 32-bit floating-point values"
|
|
}
|
|
]
|
|
},
|
|
"BaryCoordNoPerspKHR": {
|
|
"(VK_NV_fragment_shader_barycentric,VK_KHR_fragment_shader_barycentric)": [
|
|
{
|
|
"vuid": "VUID-BaryCoordNoPerspKHR-BaryCoordNoPerspKHR-04160",
|
|
"text": " The <code>BaryCoordNoPerspKHR</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>Fragment</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-BaryCoordNoPerspKHR-BaryCoordNoPerspKHR-04161",
|
|
"text": " The variable decorated with <code>BaryCoordNoPerspKHR</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-BaryCoordNoPerspKHR-BaryCoordNoPerspKHR-04162",
|
|
"text": " The variable decorated with <code>BaryCoordNoPerspKHR</code> <strong class=\"purple\">must</strong> be declared as a three-component vector of 32-bit floating-point values"
|
|
}
|
|
]
|
|
},
|
|
"BaryCoordNoPerspCentroidAMD": {
|
|
"(VK_AMD_shader_explicit_vertex_parameter)": [
|
|
{
|
|
"vuid": "VUID-BaryCoordNoPerspCentroidAMD-BaryCoordNoPerspCentroidAMD-04163",
|
|
"text": " The <code>BaryCoordNoPerspCentroidAMD</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>Fragment</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-BaryCoordNoPerspCentroidAMD-BaryCoordNoPerspCentroidAMD-04164",
|
|
"text": " The variable decorated with <code>BaryCoordNoPerspCentroidAMD</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-BaryCoordNoPerspCentroidAMD-BaryCoordNoPerspCentroidAMD-04165",
|
|
"text": " The variable decorated with <code>BaryCoordNoPerspCentroidAMD</code> <strong class=\"purple\">must</strong> be declared as a three-component vector of 32-bit floating-point values"
|
|
}
|
|
]
|
|
},
|
|
"BaryCoordNoPerspSampleAMD": {
|
|
"(VK_AMD_shader_explicit_vertex_parameter)": [
|
|
{
|
|
"vuid": "VUID-BaryCoordNoPerspSampleAMD-BaryCoordNoPerspSampleAMD-04166",
|
|
"text": " The <code>BaryCoordNoPerspSampleAMD</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>Fragment</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-BaryCoordNoPerspSampleAMD-BaryCoordNoPerspSampleAMD-04167",
|
|
"text": " The variable decorated with <code>BaryCoordNoPerspSampleAMD</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-BaryCoordNoPerspSampleAMD-BaryCoordNoPerspSampleAMD-04168",
|
|
"text": " The variable decorated with <code>BaryCoordNoPerspSampleAMD</code> <strong class=\"purple\">must</strong> be declared as a two-component vector of 32-bit floating-point values"
|
|
}
|
|
]
|
|
},
|
|
"BaryCoordPullModelAMD": {
|
|
"(VK_AMD_shader_explicit_vertex_parameter)": [
|
|
{
|
|
"vuid": "VUID-BaryCoordPullModelAMD-BaryCoordPullModelAMD-04169",
|
|
"text": " The <code>BaryCoordPullModelAMD</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>Fragment</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-BaryCoordPullModelAMD-BaryCoordPullModelAMD-04170",
|
|
"text": " The variable decorated with <code>BaryCoordPullModelAMD</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-BaryCoordPullModelAMD-BaryCoordPullModelAMD-04171",
|
|
"text": " The variable decorated with <code>BaryCoordPullModelAMD</code> <strong class=\"purple\">must</strong> be declared as a three-component vector of 32-bit floating-point values"
|
|
}
|
|
]
|
|
},
|
|
"BaryCoordSmoothAMD": {
|
|
"(VK_AMD_shader_explicit_vertex_parameter)": [
|
|
{
|
|
"vuid": "VUID-BaryCoordSmoothAMD-BaryCoordSmoothAMD-04172",
|
|
"text": " The <code>BaryCoordSmoothAMD</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>Fragment</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-BaryCoordSmoothAMD-BaryCoordSmoothAMD-04173",
|
|
"text": " The variable decorated with <code>BaryCoordSmoothAMD</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-BaryCoordSmoothAMD-BaryCoordSmoothAMD-04174",
|
|
"text": " The variable decorated with <code>BaryCoordSmoothAMD</code> <strong class=\"purple\">must</strong> be declared as a two-component vector of 32-bit floating-point values"
|
|
}
|
|
]
|
|
},
|
|
"BaryCoordSmoothCentroidAMD": {
|
|
"(VK_AMD_shader_explicit_vertex_parameter)": [
|
|
{
|
|
"vuid": "VUID-BaryCoordSmoothCentroidAMD-BaryCoordSmoothCentroidAMD-04175",
|
|
"text": " The <code>BaryCoordSmoothCentroidAMD</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>Fragment</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-BaryCoordSmoothCentroidAMD-BaryCoordSmoothCentroidAMD-04176",
|
|
"text": " The variable decorated with <code>BaryCoordSmoothCentroidAMD</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-BaryCoordSmoothCentroidAMD-BaryCoordSmoothCentroidAMD-04177",
|
|
"text": " The variable decorated with <code>BaryCoordSmoothCentroidAMD</code> <strong class=\"purple\">must</strong> be declared as a two-component vector of 32-bit floating-point values"
|
|
}
|
|
]
|
|
},
|
|
"BaryCoordSmoothSampleAMD": {
|
|
"(VK_AMD_shader_explicit_vertex_parameter)": [
|
|
{
|
|
"vuid": "VUID-BaryCoordSmoothSampleAMD-BaryCoordSmoothSampleAMD-04178",
|
|
"text": " The <code>BaryCoordSmoothSampleAMD</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>Fragment</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-BaryCoordSmoothSampleAMD-BaryCoordSmoothSampleAMD-04179",
|
|
"text": " The variable decorated with <code>BaryCoordSmoothSampleAMD</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-BaryCoordSmoothSampleAMD-BaryCoordSmoothSampleAMD-04180",
|
|
"text": " The variable decorated with <code>BaryCoordSmoothSampleAMD</code> <strong class=\"purple\">must</strong> be declared as a two-component vector of 32-bit floating-point values"
|
|
}
|
|
]
|
|
},
|
|
"BaseInstance": {
|
|
"(VK_VERSION_1_1,VK_KHR_shader_draw_parameters)": [
|
|
{
|
|
"vuid": "VUID-BaseInstance-BaseInstance-04181",
|
|
"text": " The <code>BaseInstance</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>Vertex</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-BaseInstance-BaseInstance-04182",
|
|
"text": " The variable decorated with <code>BaseInstance</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-BaseInstance-BaseInstance-04183",
|
|
"text": " The variable decorated with <code>BaseInstance</code> <strong class=\"purple\">must</strong> be declared as a scalar 32-bit integer value"
|
|
}
|
|
]
|
|
},
|
|
"BaseVertex": {
|
|
"(VK_VERSION_1_1,VK_KHR_shader_draw_parameters)": [
|
|
{
|
|
"vuid": "VUID-BaseVertex-BaseVertex-04184",
|
|
"text": " The <code>BaseVertex</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>Vertex</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-BaseVertex-BaseVertex-04185",
|
|
"text": " The variable decorated with <code>BaseVertex</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-BaseVertex-BaseVertex-04186",
|
|
"text": " The variable decorated with <code>BaseVertex</code> <strong class=\"purple\">must</strong> be declared as a scalar 32-bit integer value"
|
|
}
|
|
]
|
|
},
|
|
"ClipDistance": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-ClipDistance-ClipDistance-04187",
|
|
"text": " The <code>ClipDistance</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>MeshNV</code>, <code>Vertex</code>, <code>Fragment</code>, <code>TessellationControl</code>, <code>TessellationEvaluation</code>, or <code>Geometry</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-ClipDistance-ClipDistance-04188",
|
|
"text": " The variable decorated with <code>ClipDistance</code> within the <code>MeshNV</code> or <code>Vertex</code> {ExecutionModel} <strong class=\"purple\">must</strong> be declared using the <code>Output</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-ClipDistance-ClipDistance-04189",
|
|
"text": " The variable decorated with <code>ClipDistance</code> within the <code>Fragment</code> {ExecutionModel} <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-ClipDistance-ClipDistance-04190",
|
|
"text": " The variable decorated with <code>ClipDistance</code> within the <code>TessellationControl</code>, <code>TessellationEvaluation</code>, or <code>Geometry</code> {ExecutionModel} <strong class=\"purple\">must</strong> not be declared in a {StorageClass} other than <code>Input</code> or <code>Output</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-ClipDistance-ClipDistance-04191",
|
|
"text": " The variable decorated with <code>ClipDistance</code> <strong class=\"purple\">must</strong> be declared as an array of 32-bit floating-point values"
|
|
}
|
|
]
|
|
},
|
|
"ClipDistancePerViewNV": {
|
|
"(VK_NV_mesh_shader)": [
|
|
{
|
|
"vuid": "VUID-ClipDistancePerViewNV-ClipDistancePerViewNV-04192",
|
|
"text": " The <code>ClipDistancePerViewNV</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>MeshNV</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-ClipDistancePerViewNV-ClipDistancePerViewNV-04193",
|
|
"text": " The variable decorated with <code>ClipDistancePerViewNV</code> <strong class=\"purple\">must</strong> be declared using the <code>Output</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-ClipDistancePerViewNV-ClipDistancePerViewNV-04194",
|
|
"text": " The variable decorated with <code>ClipDistancePerViewNV</code> <strong class=\"purple\">must</strong> also be decorated with the <code>PerViewNV</code> decoration"
|
|
},
|
|
{
|
|
"vuid": "VUID-ClipDistancePerViewNV-ClipDistancePerViewNV-04195",
|
|
"text": " The variable decorated with <code>ClipDistancePerViewNV</code> <strong class=\"purple\">must</strong> be declared as a two-dimensional array of 32-bit floating-point values"
|
|
}
|
|
]
|
|
},
|
|
"CullDistance": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-CullDistance-CullDistance-04196",
|
|
"text": " The <code>CullDistance</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>MeshNV</code>, <code>Vertex</code>, <code>Fragment</code>, <code>TessellationControl</code>, <code>TessellationEvaluation</code>, or <code>Geometry</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-CullDistance-CullDistance-04197",
|
|
"text": " The variable decorated with <code>CullDistance</code> within the <code>MeshNV</code> or <code>Vertex</code> {ExecutionModel} <strong class=\"purple\">must</strong> be declared using the <code>Output</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-CullDistance-CullDistance-04198",
|
|
"text": " The variable decorated with <code>CullDistance</code> within the <code>Fragment</code> {ExecutionModel} <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-CullDistance-CullDistance-04199",
|
|
"text": " The variable decorated with <code>CullDistance</code> within the <code>TessellationControl</code>, <code>TessellationEvaluation</code>, or <code>Geometry</code> {ExecutionModel} <strong class=\"purple\">must</strong> not be declared using a {StorageClass} other than <code>Input</code> or <code>Output</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-CullDistance-CullDistance-04200",
|
|
"text": " The variable decorated with <code>CullDistance</code> <strong class=\"purple\">must</strong> be declared as an array of 32-bit floating-point values"
|
|
}
|
|
]
|
|
},
|
|
"CullDistancePerViewNV": {
|
|
"(VK_NV_mesh_shader)": [
|
|
{
|
|
"vuid": "VUID-CullDistancePerViewNV-CullDistancePerViewNV-04201",
|
|
"text": " The <code>CullDistancePerViewNV</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>MeshNV</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-CullDistancePerViewNV-CullDistancePerViewNV-04202",
|
|
"text": " The variable decorated with <code>CullDistancePerViewNV</code> <strong class=\"purple\">must</strong> be declared using the <code>Output</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-CullDistancePerViewNV-CullDistancePerViewNV-04203",
|
|
"text": " The variable decorated with <code>CullDistancePerViewNV</code> <strong class=\"purple\">must</strong> also be decorated with the <code>PerViewNV</code> decoration"
|
|
},
|
|
{
|
|
"vuid": "VUID-CullDistancePerViewNV-CullDistancePerViewNV-04204",
|
|
"text": " The variable decorated with <code>CullDistancePerViewNV</code> <strong class=\"purple\">must</strong> be declared as a two-dimensional array of 32-bit floating-point values"
|
|
}
|
|
]
|
|
},
|
|
"CullMaskKHR": {
|
|
"(VK_KHR_ray_tracing_pipeline,VK_KHR_ray_tracing_maintenance1)": [
|
|
{
|
|
"vuid": "VUID-CullMaskKHR-CullMaskKHR-06735",
|
|
"text": " The <code>CullMaskKHR</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>IntersectionKHR</code>, <code>AnyHitKHR</code>, <code>ClosestHitKHR</code>, or <code>MissKHR</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-CullMaskKHR-CullMaskKHR-06736",
|
|
"text": " The variable decorated with <code>CullMaskKHR</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-CullMaskKHR-CullMaskKHR-06737",
|
|
"text": " The variable decorated with <code>CullMaskKHR</code> <strong class=\"purple\">must</strong> be declared as a scalar 32-bit integer value"
|
|
}
|
|
]
|
|
},
|
|
"CurrentRayTimeNV": {
|
|
"(VK_NV_ray_tracing_motion_blur)": [
|
|
{
|
|
"vuid": "VUID-CurrentRayTimeNV-CurrentRayTimeNV-04942",
|
|
"text": " The <code>CurrentRayTimeNV</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>IntersectionKHR</code>, <code>AnyHitKHR</code>, <code>ClosestHitKHR</code>, or <code>MissKHR</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-CurrentRayTimeNV-CurrentRayTimeNV-04943",
|
|
"text": " The variable decorated with <code>CurrentRayTimeNV</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-CurrentRayTimeNV-CurrentRayTimeNV-04944",
|
|
"text": " The variable decorated with <code>CurrentRayTimeNV</code> <strong class=\"purple\">must</strong> be declared as a scalar 32-bit floating-point value"
|
|
}
|
|
]
|
|
},
|
|
"DeviceIndex": {
|
|
"(VK_VERSION_1_1,VK_KHR_device_group)": [
|
|
{
|
|
"vuid": "VUID-DeviceIndex-DeviceIndex-04205",
|
|
"text": " The variable decorated with <code>DeviceIndex</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-DeviceIndex-DeviceIndex-04206",
|
|
"text": " The variable decorated with <code>DeviceIndex</code> <strong class=\"purple\">must</strong> be declared as a scalar 32-bit integer value"
|
|
}
|
|
]
|
|
},
|
|
"DrawIndex": {
|
|
"(VK_VERSION_1_1,VK_KHR_shader_draw_parameters)": [
|
|
{
|
|
"vuid": "VUID-DrawIndex-DrawIndex-04207",
|
|
"text": " The <code>DrawIndex</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>Vertex</code>, <code>MeshNV</code>, or <code>TaskNV</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-DrawIndex-DrawIndex-04208",
|
|
"text": " The variable decorated with <code>DrawIndex</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-DrawIndex-DrawIndex-04209",
|
|
"text": " The variable decorated with <code>DrawIndex</code> <strong class=\"purple\">must</strong> be declared as a scalar 32-bit integer value"
|
|
}
|
|
]
|
|
},
|
|
"FragCoord": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-FragCoord-FragCoord-04210",
|
|
"text": " The <code>FragCoord</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>Fragment</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-FragCoord-FragCoord-04211",
|
|
"text": " The variable decorated with <code>FragCoord</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-FragCoord-FragCoord-04212",
|
|
"text": " The variable decorated with <code>FragCoord</code> <strong class=\"purple\">must</strong> be declared as a four-component vector of 32-bit floating-point values"
|
|
}
|
|
]
|
|
},
|
|
"FragDepth": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-FragDepth-FragDepth-04213",
|
|
"text": " The <code>FragDepth</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>Fragment</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-FragDepth-FragDepth-04214",
|
|
"text": " The variable decorated with <code>FragDepth</code> <strong class=\"purple\">must</strong> be declared using the <code>Output</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-FragDepth-FragDepth-04215",
|
|
"text": " The variable decorated with <code>FragDepth</code> <strong class=\"purple\">must</strong> be declared as a scalar 32-bit floating-point value"
|
|
},
|
|
{
|
|
"vuid": "VUID-FragDepth-FragDepth-04216",
|
|
"text": " If the shader dynamically writes to the variable decorated with <code>FragDepth</code>, the <code>DepthReplacing</code> {ExecutionMode} <strong class=\"purple\">must</strong> be declared"
|
|
}
|
|
]
|
|
},
|
|
"FragInvocationCountEXT": {
|
|
"(VK_EXT_fragment_density_map)": [
|
|
{
|
|
"vuid": "VUID-FragInvocationCountEXT-FragInvocationCountEXT-04217",
|
|
"text": " The <code>FragInvocationCountEXT</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>Fragment</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-FragInvocationCountEXT-FragInvocationCountEXT-04218",
|
|
"text": " The variable decorated with <code>FragInvocationCountEXT</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-FragInvocationCountEXT-FragInvocationCountEXT-04219",
|
|
"text": " The variable decorated with <code>FragInvocationCountEXT</code> <strong class=\"purple\">must</strong> be declared as a scalar 32-bit integer value"
|
|
}
|
|
]
|
|
},
|
|
"FragSizeEXT": {
|
|
"(VK_EXT_fragment_density_map)": [
|
|
{
|
|
"vuid": "VUID-FragSizeEXT-FragSizeEXT-04220",
|
|
"text": " The <code>FragSizeEXT</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>Fragment</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-FragSizeEXT-FragSizeEXT-04221",
|
|
"text": " The variable decorated with <code>FragSizeEXT</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-FragSizeEXT-FragSizeEXT-04222",
|
|
"text": " The variable decorated with <code>FragSizeEXT</code> <strong class=\"purple\">must</strong> be declared as a two-component vector of 32-bit integer values"
|
|
}
|
|
]
|
|
},
|
|
"FragStencilRefEXT": {
|
|
"(VK_EXT_shader_stencil_export)": [
|
|
{
|
|
"vuid": "VUID-FragStencilRefEXT-FragStencilRefEXT-04223",
|
|
"text": " The <code>FragStencilRefEXT</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>Fragment</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-FragStencilRefEXT-FragStencilRefEXT-04224",
|
|
"text": " The variable decorated with <code>FragStencilRefEXT</code> <strong class=\"purple\">must</strong> be declared using the <code>Output</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-FragStencilRefEXT-FragStencilRefEXT-04225",
|
|
"text": " The variable decorated with <code>FragStencilRefEXT</code> <strong class=\"purple\">must</strong> be declared as a scalar integer value"
|
|
}
|
|
]
|
|
},
|
|
"FragmentSizeNV": {
|
|
"(VK_NV_shading_rate_image)": [
|
|
{
|
|
"vuid": "VUID-FragmentSizeNV-FragmentSizeNV-04226",
|
|
"text": " The <code>FragmentSizeNV</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>Fragment</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-FragmentSizeNV-FragmentSizeNV-04227",
|
|
"text": " The variable decorated with <code>FragmentSizeNV</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-FragmentSizeNV-FragmentSizeNV-04228",
|
|
"text": " The variable decorated with <code>FragmentSizeNV</code> <strong class=\"purple\">must</strong> be declared as a two-component vector of 32-bit integer values"
|
|
}
|
|
]
|
|
},
|
|
"FrontFacing": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-FrontFacing-FrontFacing-04229",
|
|
"text": " The <code>FrontFacing</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>Fragment</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-FrontFacing-FrontFacing-04230",
|
|
"text": " The variable decorated with <code>FrontFacing</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-FrontFacing-FrontFacing-04231",
|
|
"text": " The variable decorated with <code>FrontFacing</code> <strong class=\"purple\">must</strong> be declared as a boolean value"
|
|
}
|
|
]
|
|
},
|
|
"FullyCoveredEXT": {
|
|
"(VK_EXT_conservative_rasterization)": [
|
|
{
|
|
"vuid": "VUID-FullyCoveredEXT-FullyCoveredEXT-04232",
|
|
"text": " The <code>FullyCoveredEXT</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>Fragment</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-FullyCoveredEXT-FullyCoveredEXT-04233",
|
|
"text": " The variable decorated with <code>FullyCoveredEXT</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-FullyCoveredEXT-FullyCoveredEXT-04234",
|
|
"text": " The variable decorated with <code>FullyCoveredEXT</code> <strong class=\"purple\">must</strong> be declared as a boolean value"
|
|
}
|
|
],
|
|
"(VK_EXT_conservative_rasterization)+(VK_EXT_post_depth_coverage)": [
|
|
{
|
|
"vuid": "VUID-FullyCoveredEXT-conservativeRasterizationPostDepthCoverage-04235",
|
|
"text": " If <code>VkPhysicalDeviceConservativeRasterizationPropertiesEXT</code>::<code>conservativeRasterizationPostDepthCoverage</code> is not supported the <code>PostDepthCoverage</code> {ExecutionMode} <strong class=\"purple\">must</strong> not be declared, when a variable with the <code>FullyCoveredEXT</code> decoration is declared"
|
|
}
|
|
]
|
|
},
|
|
"GlobalInvocationId": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-GlobalInvocationId-GlobalInvocationId-04236",
|
|
"text": " The <code>GlobalInvocationId</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>GLCompute</code>, <code>MeshNV</code>, or <code>TaskNV</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-GlobalInvocationId-GlobalInvocationId-04237",
|
|
"text": " The variable decorated with <code>GlobalInvocationId</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-GlobalInvocationId-GlobalInvocationId-04238",
|
|
"text": " The variable decorated with <code>GlobalInvocationId</code> <strong class=\"purple\">must</strong> be declared as a three-component vector of 32-bit integer values"
|
|
}
|
|
]
|
|
},
|
|
"HelperInvocation": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-HelperInvocation-HelperInvocation-04239",
|
|
"text": " The <code>HelperInvocation</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>Fragment</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-HelperInvocation-HelperInvocation-04240",
|
|
"text": " The variable decorated with <code>HelperInvocation</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-HelperInvocation-HelperInvocation-04241",
|
|
"text": " The variable decorated with <code>HelperInvocation</code> <strong class=\"purple\">must</strong> be declared as a boolean value"
|
|
}
|
|
]
|
|
},
|
|
"HitKindKHR": {
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)": [
|
|
{
|
|
"vuid": "VUID-HitKindKHR-HitKindKHR-04242",
|
|
"text": " The <code>HitKindKHR</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>AnyHitKHR</code> or <code>ClosestHitKHR</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-HitKindKHR-HitKindKHR-04243",
|
|
"text": " The variable decorated with <code>HitKindKHR</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-HitKindKHR-HitKindKHR-04244",
|
|
"text": " The variable decorated with <code>HitKindKHR</code> <strong class=\"purple\">must</strong> be declared as a scalar 32-bit integer value"
|
|
}
|
|
]
|
|
},
|
|
"HitTNV": {
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_NV_ray_tracing)": [
|
|
{
|
|
"vuid": "VUID-HitTNV-HitTNV-04245",
|
|
"text": " The <code>HitTNV</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>AnyHitNV</code> or <code>ClosestHitNV</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-HitTNV-HitTNV-04246",
|
|
"text": " The variable decorated with <code>HitTNV</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-HitTNV-HitTNV-04247",
|
|
"text": " The variable decorated with <code>HitTNV</code> <strong class=\"purple\">must</strong> be declared as a scalar 32-bit floating-point value"
|
|
}
|
|
]
|
|
},
|
|
"IncomingRayFlagsKHR": {
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)": [
|
|
{
|
|
"vuid": "VUID-IncomingRayFlagsKHR-IncomingRayFlagsKHR-04248",
|
|
"text": " The <code>IncomingRayFlagsKHR</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>IntersectionKHR</code>, <code>AnyHitKHR</code>, <code>ClosestHitKHR</code>, or <code>MissKHR</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-IncomingRayFlagsKHR-IncomingRayFlagsKHR-04249",
|
|
"text": " The variable decorated with <code>IncomingRayFlagsKHR</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-IncomingRayFlagsKHR-IncomingRayFlagsKHR-04250",
|
|
"text": " The variable decorated with <code>IncomingRayFlagsKHR</code> <strong class=\"purple\">must</strong> be declared as a scalar 32-bit integer value"
|
|
}
|
|
]
|
|
},
|
|
"InstanceCustomIndexKHR": {
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)": [
|
|
{
|
|
"vuid": "VUID-InstanceCustomIndexKHR-InstanceCustomIndexKHR-04251",
|
|
"text": " The <code>InstanceCustomIndexKHR</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>IntersectionKHR</code>, <code>AnyHitKHR</code>, or <code>ClosestHitKHR</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-InstanceCustomIndexKHR-InstanceCustomIndexKHR-04252",
|
|
"text": " The variable decorated with <code>InstanceCustomIndexKHR</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-InstanceCustomIndexKHR-InstanceCustomIndexKHR-04253",
|
|
"text": " The variable decorated with <code>InstanceCustomIndexKHR</code> <strong class=\"purple\">must</strong> be declared as a scalar 32-bit integer value"
|
|
}
|
|
]
|
|
},
|
|
"InstanceId": {
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)": [
|
|
{
|
|
"vuid": "VUID-InstanceId-InstanceId-04254",
|
|
"text": " The <code>InstanceId</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>IntersectionKHR</code>, <code>AnyHitKHR</code>, or <code>ClosestHitKHR</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-InstanceId-InstanceId-04255",
|
|
"text": " The variable decorated with <code>InstanceId</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-InstanceId-InstanceId-04256",
|
|
"text": " The variable decorated with <code>InstanceId</code> <strong class=\"purple\">must</strong> be declared as a scalar 32-bit integer value"
|
|
}
|
|
]
|
|
},
|
|
"InvocationId": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-InvocationId-InvocationId-04257",
|
|
"text": " The <code>InvocationId</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>TessellationControl</code> or <code>Geometry</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-InvocationId-InvocationId-04258",
|
|
"text": " The variable decorated with <code>InvocationId</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-InvocationId-InvocationId-04259",
|
|
"text": " The variable decorated with <code>InvocationId</code> <strong class=\"purple\">must</strong> be declared as a scalar 32-bit integer value"
|
|
}
|
|
]
|
|
},
|
|
"InvocationsPerPixelNV": {
|
|
"(VK_NV_shading_rate_image)": [
|
|
{
|
|
"vuid": "VUID-InvocationsPerPixelNV-InvocationsPerPixelNV-04260",
|
|
"text": " The <code>InvocationsPerPixelNV</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>Fragment</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-InvocationsPerPixelNV-InvocationsPerPixelNV-04261",
|
|
"text": " The variable decorated with <code>InvocationsPerPixelNV</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-InvocationsPerPixelNV-InvocationsPerPixelNV-04262",
|
|
"text": " The variable decorated with <code>InvocationsPerPixelNV</code> <strong class=\"purple\">must</strong> be declared as a scalar 32-bit integer value"
|
|
}
|
|
]
|
|
},
|
|
"InstanceIndex": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-InstanceIndex-InstanceIndex-04263",
|
|
"text": " The <code>InstanceIndex</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>Vertex</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-InstanceIndex-InstanceIndex-04264",
|
|
"text": " The variable decorated with <code>InstanceIndex</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-InstanceIndex-InstanceIndex-04265",
|
|
"text": " The variable decorated with <code>InstanceIndex</code> <strong class=\"purple\">must</strong> be declared as a scalar 32-bit integer value"
|
|
}
|
|
]
|
|
},
|
|
"LaunchIdKHR": {
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)": [
|
|
{
|
|
"vuid": "VUID-LaunchIdKHR-LaunchIdKHR-04266",
|
|
"text": " The <code>LaunchIdKHR</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>RayGenerationKHR</code>, <code>IntersectionKHR</code>, <code>AnyHitKHR</code>, <code>ClosestHitKHR</code>, <code>MissKHR</code>, or <code>CallableKHR</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-LaunchIdKHR-LaunchIdKHR-04267",
|
|
"text": " The variable decorated with <code>LaunchIdKHR</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-LaunchIdKHR-LaunchIdKHR-04268",
|
|
"text": " The variable decorated with <code>LaunchIdKHR</code> <strong class=\"purple\">must</strong> be declared as a three-component vector of 32-bit integer values"
|
|
}
|
|
]
|
|
},
|
|
"LaunchSizeKHR": {
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)": [
|
|
{
|
|
"vuid": "VUID-LaunchSizeKHR-LaunchSizeKHR-04269",
|
|
"text": " The <code>LaunchSizeKHR</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>RayGenerationKHR</code>, <code>IntersectionKHR</code>, <code>AnyHitKHR</code>, <code>ClosestHitKHR</code>, <code>MissKHR</code>, or <code>CallableKHR</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-LaunchSizeKHR-LaunchSizeKHR-04270",
|
|
"text": " The variable decorated with <code>LaunchSizeKHR</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-LaunchSizeKHR-LaunchSizeKHR-04271",
|
|
"text": " The variable decorated with <code>LaunchSizeKHR</code> <strong class=\"purple\">must</strong> be declared as a three-component vector of 32-bit integer values"
|
|
}
|
|
]
|
|
},
|
|
"Layer": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-Layer-Layer-04272",
|
|
"text": " The <code>Layer</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>MeshNV</code>, <code>Vertex</code>, <code>TessellationEvaluation</code>, <code>Geometry</code>, or <code>Fragment</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-Layer-Layer-04274",
|
|
"text": " The variable decorated with <code>Layer</code> within the <code>MeshNV</code>, <code>Vertex</code>, <code>TessellationEvaluation</code>, or <code>Geometry</code> {ExecutionModel} <strong class=\"purple\">must</strong> be declared using the <code>Output</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-Layer-Layer-04275",
|
|
"text": " The variable decorated with <code>Layer</code> within the <code>Fragment</code> {ExecutionModel} <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-Layer-Layer-04276",
|
|
"text": " The variable decorated with <code>Layer</code> <strong class=\"purple\">must</strong> be declared as a scalar 32-bit integer value"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2)": [
|
|
{
|
|
"vuid": "VUID-Layer-Layer-04273",
|
|
"text": " If the <a href=\"#features-shaderOutputLayer\"><code>shaderOutputLayer</code></a> feature is not enabled then the <code>Layer</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>Geometry</code> or <code>Fragment</code> {ExecutionModel}"
|
|
}
|
|
]
|
|
},
|
|
"LayerPerViewNV": {
|
|
"(VK_NV_mesh_shader)": [
|
|
{
|
|
"vuid": "VUID-LayerPerViewNV-LayerPerViewNV-04277",
|
|
"text": " The <code>LayerPerViewNV</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>MeshNV</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-LayerPerViewNV-LayerPerViewNV-04278",
|
|
"text": " The variable decorated with <code>LayerPerViewNV</code> <strong class=\"purple\">must</strong> be declared using the <code>Output</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-LayerPerViewNV-LayerPerViewNV-04279",
|
|
"text": " The variable decorated with <code>LayerPerViewNV</code> <strong class=\"purple\">must</strong> also be decorated with the <code>PerViewNV</code> decoration"
|
|
},
|
|
{
|
|
"vuid": "VUID-LayerPerViewNV-LayerPerViewNV-04280",
|
|
"text": " The variable decorated with <code>LayerPerViewNV</code> <strong class=\"purple\">must</strong> be declared as an array of scalar 32-bit integer values"
|
|
}
|
|
]
|
|
},
|
|
"LocalInvocationId": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-LocalInvocationId-LocalInvocationId-04281",
|
|
"text": " The <code>LocalInvocationId</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>GLCompute</code>, <code>MeshNV</code>, or <code>TaskNV</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-LocalInvocationId-LocalInvocationId-04282",
|
|
"text": " The variable decorated with <code>LocalInvocationId</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-LocalInvocationId-LocalInvocationId-04283",
|
|
"text": " The variable decorated with <code>LocalInvocationId</code> <strong class=\"purple\">must</strong> be declared as a three-component vector of 32-bit integer values"
|
|
}
|
|
]
|
|
},
|
|
"LocalInvocationIndex": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-LocalInvocationIndex-LocalInvocationIndex-04284",
|
|
"text": " The <code>LocalInvocationIndex</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>GLCompute</code>, <code>MeshNV</code>, or <code>TaskNV</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-LocalInvocationIndex-LocalInvocationIndex-04285",
|
|
"text": " The variable decorated with <code>LocalInvocationIndex</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-LocalInvocationIndex-LocalInvocationIndex-04286",
|
|
"text": " The variable decorated with <code>LocalInvocationIndex</code> <strong class=\"purple\">must</strong> be declared as a scalar 32-bit integer value"
|
|
}
|
|
]
|
|
},
|
|
"MeshViewCountNV": {
|
|
"(VK_NV_mesh_shader)": [
|
|
{
|
|
"vuid": "VUID-MeshViewCountNV-MeshViewCountNV-04287",
|
|
"text": " The <code>MeshViewCountNV</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>MeshNV</code> or <code>TaskNV</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-MeshViewCountNV-MeshViewCountNV-04288",
|
|
"text": " The variable decorated with <code>MeshViewCountNV</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-MeshViewCountNV-MeshViewCountNV-04289",
|
|
"text": " The variable decorated with <code>MeshViewCountNV</code> <strong class=\"purple\">must</strong> be declared as a scalar 32-bit integer value"
|
|
}
|
|
]
|
|
},
|
|
"MeshViewIndicesNV": {
|
|
"(VK_NV_mesh_shader)": [
|
|
{
|
|
"vuid": "VUID-MeshViewIndicesNV-MeshViewIndicesNV-04290",
|
|
"text": " The <code>MeshViewIndicesNV</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>MeshNV</code> or <code>TaskNV</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-MeshViewIndicesNV-MeshViewIndicesNV-04291",
|
|
"text": " The variable decorated with <code>MeshViewIndicesNV</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-MeshViewIndicesNV-MeshViewIndicesNV-04292",
|
|
"text": " The variable decorated with <code>MeshViewIndicesNV</code> <strong class=\"purple\">must</strong> be declared as an array of scalar 32-bit integer values"
|
|
}
|
|
]
|
|
},
|
|
"NumSubgroups": {
|
|
"(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-NumSubgroups-NumSubgroups-04293",
|
|
"text": " The <code>NumSubgroups</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>GLCompute</code>, <code>MeshNV</code>, or <code>TaskNV</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-NumSubgroups-NumSubgroups-04294",
|
|
"text": " The variable decorated with <code>NumSubgroups</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-NumSubgroups-NumSubgroups-04295",
|
|
"text": " The variable decorated with <code>NumSubgroups</code> <strong class=\"purple\">must</strong> be declared as a scalar 32-bit integer value"
|
|
}
|
|
]
|
|
},
|
|
"NumWorkgroups": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-NumWorkgroups-NumWorkgroups-04296",
|
|
"text": " The <code>NumWorkgroups</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>GLCompute</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-NumWorkgroups-NumWorkgroups-04297",
|
|
"text": " The variable decorated with <code>NumWorkgroups</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-NumWorkgroups-NumWorkgroups-04298",
|
|
"text": " The variable decorated with <code>NumWorkgroups</code> <strong class=\"purple\">must</strong> be declared as a three-component vector of 32-bit integer values"
|
|
}
|
|
]
|
|
},
|
|
"ObjectRayDirectionKHR": {
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)": [
|
|
{
|
|
"vuid": "VUID-ObjectRayDirectionKHR-ObjectRayDirectionKHR-04299",
|
|
"text": " The <code>ObjectRayDirectionKHR</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>IntersectionKHR</code>, <code>AnyHitKHR</code>, or <code>ClosestHitKHR</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-ObjectRayDirectionKHR-ObjectRayDirectionKHR-04300",
|
|
"text": " The variable decorated with <code>ObjectRayDirectionKHR</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-ObjectRayDirectionKHR-ObjectRayDirectionKHR-04301",
|
|
"text": " The variable decorated with <code>ObjectRayDirectionKHR</code> <strong class=\"purple\">must</strong> be declared as a three-component vector of 32-bit floating-point values"
|
|
}
|
|
]
|
|
},
|
|
"ObjectRayOriginKHR": {
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)": [
|
|
{
|
|
"vuid": "VUID-ObjectRayOriginKHR-ObjectRayOriginKHR-04302",
|
|
"text": " The <code>ObjectRayOriginKHR</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>IntersectionKHR</code>, <code>AnyHitKHR</code>, or <code>ClosestHitKHR</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-ObjectRayOriginKHR-ObjectRayOriginKHR-04303",
|
|
"text": " The variable decorated with <code>ObjectRayOriginKHR</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-ObjectRayOriginKHR-ObjectRayOriginKHR-04304",
|
|
"text": " The variable decorated with <code>ObjectRayOriginKHR</code> <strong class=\"purple\">must</strong> be declared as a three-component vector of 32-bit floating-point values"
|
|
}
|
|
]
|
|
},
|
|
"ObjectToWorldKHR": {
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)": [
|
|
{
|
|
"vuid": "VUID-ObjectToWorldKHR-ObjectToWorldKHR-04305",
|
|
"text": " The <code>ObjectToWorldKHR</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>IntersectionKHR</code>, <code>AnyHitKHR</code>, or <code>ClosestHitKHR</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-ObjectToWorldKHR-ObjectToWorldKHR-04306",
|
|
"text": " The variable decorated with <code>ObjectToWorldKHR</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-ObjectToWorldKHR-ObjectToWorldKHR-04307",
|
|
"text": " The variable decorated with <code>ObjectToWorldKHR</code> <strong class=\"purple\">must</strong> be declared as a matrix with four columns of three-component vectors of 32-bit floating-point values"
|
|
}
|
|
]
|
|
},
|
|
"PatchVertices": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-PatchVertices-PatchVertices-04308",
|
|
"text": " The <code>PatchVertices</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>TessellationControl</code> or <code>TessellationEvaluation</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-PatchVertices-PatchVertices-04309",
|
|
"text": " The variable decorated with <code>PatchVertices</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-PatchVertices-PatchVertices-04310",
|
|
"text": " The variable decorated with <code>PatchVertices</code> <strong class=\"purple\">must</strong> be declared as a scalar 32-bit integer value"
|
|
}
|
|
]
|
|
},
|
|
"PointCoord": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-PointCoord-PointCoord-04311",
|
|
"text": " The <code>PointCoord</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>Fragment</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-PointCoord-PointCoord-04312",
|
|
"text": " The variable decorated with <code>PointCoord</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-PointCoord-PointCoord-04313",
|
|
"text": " The variable decorated with <code>PointCoord</code> <strong class=\"purple\">must</strong> be declared as a two-component vector of 32-bit floating-point values"
|
|
}
|
|
]
|
|
},
|
|
"PointSize": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-PointSize-PointSize-04314",
|
|
"text": " The <code>PointSize</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>MeshNV</code>, <code>Vertex</code>, <code>TessellationControl</code>, <code>TessellationEvaluation</code>, or <code>Geometry</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-PointSize-PointSize-04315",
|
|
"text": " The variable decorated with <code>PointSize</code> within the <code>MeshNV</code> or <code>Vertex</code> {ExecutionModel} <strong class=\"purple\">must</strong> be declared using the <code>Output</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-PointSize-PointSize-04316",
|
|
"text": " The variable decorated with <code>PointSize</code> within the <code>TessellationControl</code>, <code>TessellationEvaluation</code>, or <code>Geometry</code> {ExecutionModel} <strong class=\"purple\">must</strong> not be declared using a {StorageClass} other than <code>Input</code> or <code>Output</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-PointSize-PointSize-04317",
|
|
"text": " The variable decorated with <code>PointSize</code> <strong class=\"purple\">must</strong> be declared as a scalar 32-bit floating-point value"
|
|
}
|
|
]
|
|
},
|
|
"Position": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-Position-Position-04318",
|
|
"text": " The <code>Position</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>MeshNV</code>, <code>Vertex</code>, <code>TessellationControl</code>, <code>TessellationEvaluation</code>, or <code>Geometry</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-Position-Position-04319",
|
|
"text": " The variable decorated with <code>Position</code> within <code>MeshNV</code> or <code>Vertex</code> {ExecutionModel} <strong class=\"purple\">must</strong> be declared using the <code>Output</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-Position-Position-04320",
|
|
"text": " The variable decorated with <code>Position</code> within <code>TessellationControl</code>, <code>TessellationEvaluation</code>, or <code>Geometry</code> {ExecutionModel} <strong class=\"purple\">must</strong> not be declared using a {StorageClass} other than <code>Input</code> or <code>Output</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-Position-Position-04321",
|
|
"text": " The variable decorated with <code>Position</code> <strong class=\"purple\">must</strong> be declared as a four-component vector of 32-bit floating-point values"
|
|
}
|
|
]
|
|
},
|
|
"PositionPerViewNV": {
|
|
"(VK_NVX_multiview_per_view_attributes)": [
|
|
{
|
|
"vuid": "VUID-PositionPerViewNV-PositionPerViewNV-04322",
|
|
"text": " The <code>PositionPerViewNV</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>MeshNV</code>, <code>Vertex</code>, <code>TessellationControl</code>, <code>TessellationEvaluation</code>, or <code>Geometry</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-PositionPerViewNV-PositionPerViewNV-04323",
|
|
"text": " The variable decorated with <code>PositionPerViewNV</code> within the <code>Vertex</code>, or <code>MeshNV</code> {ExecutionModel} <strong class=\"purple\">must</strong> be declared using the <code>Output</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-PositionPerViewNV-PositionPerViewNV-04324",
|
|
"text": " The variable decorated with <code>PositionPerViewNV</code> within the <code>TessellationControl</code>, <code>TessellationEvaluation</code>, or <code>Geometry</code> {ExecutionModel} <strong class=\"purple\">must</strong> not be declared using a {StorageClass} other than <code>Input</code> or <code>Output</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-PositionPerViewNV-PositionPerViewNV-04325",
|
|
"text": " The variable decorated with <code>PositionPerViewNV</code> <strong class=\"purple\">must</strong> be declared as an array of four-component vector of 32-bit floating-point values with at least as many elements as the maximum view in the subpass’s view mask plus one"
|
|
},
|
|
{
|
|
"vuid": "VUID-PositionPerViewNV-PositionPerViewNV-04326",
|
|
"text": " The array variable decorated with <code>PositionPerViewNV</code> <strong class=\"purple\">must</strong> only be indexed by a constant or specialization constant"
|
|
}
|
|
]
|
|
},
|
|
"PrimitiveCountNV": {
|
|
"(VK_NV_mesh_shader)": [
|
|
{
|
|
"vuid": "VUID-PrimitiveCountNV-PrimitiveCountNV-04327",
|
|
"text": " The <code>PrimitiveCountNV</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>MeshNV</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-PrimitiveCountNV-PrimitiveCountNV-04328",
|
|
"text": " The variable decorated with <code>PrimitiveCountNV</code> <strong class=\"purple\">must</strong> be declared using the <code>Output</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-PrimitiveCountNV-PrimitiveCountNV-04329",
|
|
"text": " The variable decorated with <code>PrimitiveCountNV</code> <strong class=\"purple\">must</strong> be declared as a scalar 32-bit integer value"
|
|
}
|
|
]
|
|
},
|
|
"PrimitiveId": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-PrimitiveId-PrimitiveId-04330",
|
|
"text": " The <code>PrimitiveId</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>MeshNV</code>, <code>IntersectionKHR</code>, <code>AnyHitKHR</code>, <code>ClosestHitKHR</code>, <code>TessellationControl</code>, <code>TessellationEvaluation</code>, <code>Geometry</code>, or <code>Fragment</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-PrimitiveId-Fragment-04331",
|
|
"text": " If pipeline contains both the <code>Fragment</code> and <code>Geometry</code> {ExecutionModel} and a variable decorated with <code>PrimitiveId</code> is read from <code>Fragment</code> shader, then the <code>Geometry</code> shader <strong class=\"purple\">must</strong> write to the output variables decorated with <code>PrimitiveId</code> in all execution paths"
|
|
},
|
|
{
|
|
"vuid": "VUID-PrimitiveId-Fragment-04332",
|
|
"text": " If pipeline contains both the <code>Fragment</code> and <code>MeshNV</code> {ExecutionModel} and a variable decorated with <code>PrimitiveId</code> is read from <code>Fragment</code> shader, then the <code>MeshNV</code> shader <strong class=\"purple\">must</strong> write to the output variables decorated with <code>PrimitiveId</code> in all execution paths"
|
|
},
|
|
{
|
|
"vuid": "VUID-PrimitiveId-Fragment-04333",
|
|
"text": " If <code>Fragment</code> {ExecutionModel} contains a variable decorated with <code>PrimitiveId</code>, then either the <code>MeshShadingNV</code>, <code>Geometry</code> or <code>Tessellation</code> capability <strong class=\"purple\">must</strong> also be declared"
|
|
},
|
|
{
|
|
"vuid": "VUID-PrimitiveId-PrimitiveId-04334",
|
|
"text": " The variable decorated with <code>PrimitiveId</code> within the <code>TessellationControl</code>, <code>TessellationEvaluation</code>, <code>Fragment</code>, <code>IntersectionKHR</code>, <code>AnyHitKHR</code>, or <code>ClosestHitKHR</code> {ExecutionModel} <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-PrimitiveId-PrimitiveId-04335",
|
|
"text": " The variable decorated with <code>PrimitiveId</code> within the <code>Geometry</code> {ExecutionModel} <strong class=\"purple\">must</strong> be declared using the <code>Input</code> or <code>Output</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-PrimitiveId-PrimitiveId-04336",
|
|
"text": " The variable decorated with <code>PrimitiveId</code> within the <code>MeshNV</code> {ExecutionModel} <strong class=\"purple\">must</strong> be declared using the <code>Output</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-PrimitiveId-PrimitiveId-04337",
|
|
"text": " The variable decorated with <code>PrimitiveId</code> <strong class=\"purple\">must</strong> be declared as a scalar 32-bit integer value"
|
|
}
|
|
]
|
|
},
|
|
"PrimitiveIndicesNV": {
|
|
"(VK_NV_mesh_shader)": [
|
|
{
|
|
"vuid": "VUID-PrimitiveIndicesNV-PrimitiveIndicesNV-04338",
|
|
"text": " The <code>PrimitiveIndicesNV</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>MeshNV</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-PrimitiveIndicesNV-PrimitiveIndicesNV-04339",
|
|
"text": " The variable decorated with <code>PrimitiveIndicesNV</code> <strong class=\"purple\">must</strong> be declared using the <code>Output</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-PrimitiveIndicesNV-PrimitiveIndicesNV-04340",
|
|
"text": " The variable decorated with <code>PrimitiveIndicesNV</code> <strong class=\"purple\">must</strong> be declared as an array of scalar 32-bit integer values"
|
|
},
|
|
{
|
|
"vuid": "VUID-PrimitiveIndicesNV-PrimitiveIndicesNV-04341",
|
|
"text": " All index values of the array decorated with <code>PrimitiveIndicesNV</code> <strong class=\"purple\">must</strong> be in the range <span class=\"eq\">[0, N-1]</span>, where <span class=\"eq\">N</span> is the value specified by the <code>OutputVertices</code> {ExecutionMode}"
|
|
},
|
|
{
|
|
"vuid": "VUID-PrimitiveIndicesNV-OutputPoints-04342",
|
|
"text": " If the {ExecutionMode} is <code>OutputPoints</code>, then the array decorated with <code>PrimitiveIndicesNV</code> must be the size of the value specified by <code>OutputPrimitivesNV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-PrimitiveIndicesNV-OutputLinesNV-04343",
|
|
"text": " If the {ExecutionMode} is <code>OutputLinesNV</code>, then the array decorated with <code>PrimitiveIndicesNV</code> must be the size of two times the value specified by <code>OutputPrimitivesNV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-PrimitiveIndicesNV-OutputTrianglesNV-04344",
|
|
"text": " If the {ExecutionMode} is <code>OutputTrianglesNV</code>, then the array decorated with <code>PrimitiveIndicesNV</code> must be the size of three times the value specified by <code>OutputPrimitivesNV</code>"
|
|
}
|
|
]
|
|
},
|
|
"PrimitiveShadingRateKHR": {
|
|
"(VK_KHR_fragment_shading_rate)": [
|
|
{
|
|
"vuid": "VUID-PrimitiveShadingRateKHR-PrimitiveShadingRateKHR-04484",
|
|
"text": " The <code>PrimitiveShadingRateKHR</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>MeshNV</code>, <code>Vertex</code>, or <code>Geometry</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-PrimitiveShadingRateKHR-PrimitiveShadingRateKHR-04485",
|
|
"text": " The variable decorated with <code>PrimitiveShadingRateKHR</code> <strong class=\"purple\">must</strong> be declared using the <code>Output</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-PrimitiveShadingRateKHR-PrimitiveShadingRateKHR-04486",
|
|
"text": " The variable decorated with <code>PrimitiveShadingRateKHR</code> <strong class=\"purple\">must</strong> be declared as a scalar 32-bit integer value"
|
|
},
|
|
{
|
|
"vuid": "VUID-PrimitiveShadingRateKHR-PrimitiveShadingRateKHR-04487",
|
|
"text": " The value written to <code>PrimitiveShadingRateKHR</code> <strong class=\"purple\">must</strong> include no more than one of <code>Vertical2Pixels</code> and <code>Vertical4Pixels</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-PrimitiveShadingRateKHR-PrimitiveShadingRateKHR-04488",
|
|
"text": " The value written to <code>PrimitiveShadingRateKHR</code> <strong class=\"purple\">must</strong> include no more than one of <code>Horizontal2Pixels</code> and <code>Horizontal4Pixels</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-PrimitiveShadingRateKHR-PrimitiveShadingRateKHR-04489",
|
|
"text": " The value written to <code>PrimitiveShadingRateKHR</code> <strong class=\"purple\">must</strong> not have any bits set other than those defined by <strong>Fragment Shading Rate Flags</strong> enumerants in the SPIR-V specification"
|
|
}
|
|
]
|
|
},
|
|
"RayGeometryIndexKHR": {
|
|
"(VK_KHR_ray_tracing_pipeline)": [
|
|
{
|
|
"vuid": "VUID-RayGeometryIndexKHR-RayGeometryIndexKHR-04345",
|
|
"text": " The <code>RayGeometryIndexKHR</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>IntersectionKHR</code>, <code>AnyHitKHR</code>, or <code>ClosestHitKHR</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-RayGeometryIndexKHR-RayGeometryIndexKHR-04346",
|
|
"text": " The variable decorated with <code>RayGeometryIndexKHR</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-RayGeometryIndexKHR-RayGeometryIndexKHR-04347",
|
|
"text": " The variable decorated with <code>RayGeometryIndexKHR</code> <strong class=\"purple\">must</strong> be declared as a scalar 32-bit integer value"
|
|
}
|
|
]
|
|
},
|
|
"RayTmaxKHR": {
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)": [
|
|
{
|
|
"vuid": "VUID-RayTmaxKHR-RayTmaxKHR-04348",
|
|
"text": " The <code>RayTmaxKHR</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>IntersectionKHR</code>, <code>AnyHitKHR</code>, <code>ClosestHitKHR</code>, or <code>MissKHR</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-RayTmaxKHR-RayTmaxKHR-04349",
|
|
"text": " The variable decorated with <code>RayTmaxKHR</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-RayTmaxKHR-RayTmaxKHR-04350",
|
|
"text": " The variable decorated with <code>RayTmaxKHR</code> <strong class=\"purple\">must</strong> be declared as a scalar 32-bit floating-point value"
|
|
}
|
|
]
|
|
},
|
|
"RayTminKHR": {
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)": [
|
|
{
|
|
"vuid": "VUID-RayTminKHR-RayTminKHR-04351",
|
|
"text": " The <code>RayTminKHR</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>IntersectionKHR</code>, <code>AnyHitKHR</code>, <code>ClosestHitKHR</code>, or <code>MissKHR</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-RayTminKHR-RayTminKHR-04352",
|
|
"text": " The variable decorated with <code>RayTminKHR</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-RayTminKHR-RayTminKHR-04353",
|
|
"text": " The variable decorated with <code>RayTminKHR</code> <strong class=\"purple\">must</strong> be declared as a scalar 32-bit floating-point value"
|
|
}
|
|
]
|
|
},
|
|
"SampleId": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-SampleId-SampleId-04354",
|
|
"text": " The <code>SampleId</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>Fragment</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-SampleId-SampleId-04355",
|
|
"text": " The variable decorated with <code>SampleId</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-SampleId-SampleId-04356",
|
|
"text": " The variable decorated with <code>SampleId</code> <strong class=\"purple\">must</strong> be declared as a scalar 32-bit integer value"
|
|
}
|
|
]
|
|
},
|
|
"SampleMask": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-SampleMask-SampleMask-04357",
|
|
"text": " The <code>SampleMask</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>Fragment</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-SampleMask-SampleMask-04358",
|
|
"text": " The variable decorated with <code>SampleMask</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> or <code>Output</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-SampleMask-SampleMask-04359",
|
|
"text": " The variable decorated with <code>SampleMask</code> <strong class=\"purple\">must</strong> be declared as an array of 32-bit integer values"
|
|
}
|
|
]
|
|
},
|
|
"SamplePosition": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-SamplePosition-SamplePosition-04360",
|
|
"text": " The <code>SamplePosition</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>Fragment</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-SamplePosition-SamplePosition-04361",
|
|
"text": " The variable decorated with <code>SamplePosition</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-SamplePosition-SamplePosition-04362",
|
|
"text": " The variable decorated with <code>SamplePosition</code> <strong class=\"purple\">must</strong> be declared as a two-component vector of 32-bit floating-point values"
|
|
}
|
|
]
|
|
},
|
|
"ShadingRateKHR": {
|
|
"(VK_KHR_fragment_shading_rate)": [
|
|
{
|
|
"vuid": "VUID-ShadingRateKHR-ShadingRateKHR-04490",
|
|
"text": " The <code>ShadingRateKHR</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>Fragment</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-ShadingRateKHR-ShadingRateKHR-04491",
|
|
"text": " The variable decorated with <code>ShadingRateKHR</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-ShadingRateKHR-ShadingRateKHR-04492",
|
|
"text": " The variable decorated with <code>ShadingRateKHR</code> <strong class=\"purple\">must</strong> be declared as a scalar 32-bit integer value"
|
|
}
|
|
]
|
|
},
|
|
"SMCountNV": {
|
|
"(VK_NV_shader_sm_builtins)": [
|
|
{
|
|
"vuid": "VUID-SMCountNV-SMCountNV-04363",
|
|
"text": " The variable decorated with <code>SMCountNV</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-SMCountNV-SMCountNV-04364",
|
|
"text": " The variable decorated with <code>SMCountNV</code> <strong class=\"purple\">must</strong> be declared as a scalar 32-bit integer value"
|
|
}
|
|
]
|
|
},
|
|
"SMIDNV": {
|
|
"(VK_NV_shader_sm_builtins)": [
|
|
{
|
|
"vuid": "VUID-SMIDNV-SMIDNV-04365",
|
|
"text": " The variable decorated with <code>SMIDNV</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-SMIDNV-SMIDNV-04366",
|
|
"text": " The variable decorated with <code>SMIDNV</code> <strong class=\"purple\">must</strong> be declared as a scalar 32-bit integer value"
|
|
}
|
|
]
|
|
},
|
|
"SubgroupId": {
|
|
"(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-SubgroupId-SubgroupId-04367",
|
|
"text": " The <code>SubgroupId</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>GLCompute</code>, <code>MeshNV</code>, or <code>TaskNV</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-SubgroupId-SubgroupId-04368",
|
|
"text": " The variable decorated with <code>SubgroupId</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-SubgroupId-SubgroupId-04369",
|
|
"text": " The variable decorated with <code>SubgroupId</code> <strong class=\"purple\">must</strong> be declared as a scalar 32-bit integer value"
|
|
}
|
|
]
|
|
},
|
|
"SubgroupEqMask": {
|
|
"(VK_VERSION_1_1,VK_EXT_shader_subgroup_ballot)": [
|
|
{
|
|
"vuid": "VUID-SubgroupEqMask-SubgroupEqMask-04370",
|
|
"text": " The variable decorated with <code>SubgroupEqMask</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-SubgroupEqMask-SubgroupEqMask-04371",
|
|
"text": " The variable decorated with <code>SubgroupEqMask</code> <strong class=\"purple\">must</strong> be declared as a four-component vector of 32-bit integer values"
|
|
}
|
|
]
|
|
},
|
|
"SubgroupGeMask": {
|
|
"(VK_VERSION_1_1,VK_EXT_shader_subgroup_ballot)": [
|
|
{
|
|
"vuid": "VUID-SubgroupGeMask-SubgroupGeMask-04372",
|
|
"text": " The variable decorated with <code>SubgroupGeMask</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-SubgroupGeMask-SubgroupGeMask-04373",
|
|
"text": " The variable decorated with <code>SubgroupGeMask</code> <strong class=\"purple\">must</strong> be declared as a four-component vector of 32-bit integer values"
|
|
}
|
|
]
|
|
},
|
|
"SubgroupGtMask": {
|
|
"(VK_VERSION_1_1,VK_EXT_shader_subgroup_ballot)": [
|
|
{
|
|
"vuid": "VUID-SubgroupGtMask-SubgroupGtMask-04374",
|
|
"text": " The variable decorated with <code>SubgroupGtMask</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-SubgroupGtMask-SubgroupGtMask-04375",
|
|
"text": " The variable decorated with <code>SubgroupGtMask</code> <strong class=\"purple\">must</strong> be declared as a four-component vector of 32-bit integer values"
|
|
}
|
|
]
|
|
},
|
|
"SubgroupLeMask": {
|
|
"(VK_VERSION_1_1,VK_EXT_shader_subgroup_ballot)": [
|
|
{
|
|
"vuid": "VUID-SubgroupLeMask-SubgroupLeMask-04376",
|
|
"text": " The variable decorated with <code>SubgroupLeMask</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-SubgroupLeMask-SubgroupLeMask-04377",
|
|
"text": " The variable decorated with <code>SubgroupLeMask</code> <strong class=\"purple\">must</strong> be declared as a four-component vector of 32-bit integer values"
|
|
}
|
|
]
|
|
},
|
|
"SubgroupLtMask": {
|
|
"(VK_VERSION_1_1,VK_EXT_shader_subgroup_ballot)": [
|
|
{
|
|
"vuid": "VUID-SubgroupLtMask-SubgroupLtMask-04378",
|
|
"text": " The variable decorated with <code>SubgroupLtMask</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-SubgroupLtMask-SubgroupLtMask-04379",
|
|
"text": " The variable decorated with <code>SubgroupLtMask</code> <strong class=\"purple\">must</strong> be declared as a four-component vector of 32-bit integer values"
|
|
}
|
|
]
|
|
},
|
|
"SubgroupLocalInvocationId": {
|
|
"(VK_VERSION_1_1,VK_EXT_shader_subgroup_ballot)": [
|
|
{
|
|
"vuid": "VUID-SubgroupLocalInvocationId-SubgroupLocalInvocationId-04380",
|
|
"text": " The variable decorated with <code>SubgroupLocalInvocationId</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-SubgroupLocalInvocationId-SubgroupLocalInvocationId-04381",
|
|
"text": " The variable decorated with <code>SubgroupLocalInvocationId</code> <strong class=\"purple\">must</strong> be declared as a scalar 32-bit integer value"
|
|
}
|
|
]
|
|
},
|
|
"SubgroupSize": {
|
|
"(VK_VERSION_1_1,VK_EXT_shader_subgroup_ballot)": [
|
|
{
|
|
"vuid": "VUID-SubgroupSize-SubgroupSize-04382",
|
|
"text": " The variable decorated with <code>SubgroupSize</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-SubgroupSize-SubgroupSize-04383",
|
|
"text": " The variable decorated with <code>SubgroupSize</code> <strong class=\"purple\">must</strong> be declared as a scalar 32-bit integer value"
|
|
}
|
|
]
|
|
},
|
|
"TaskCountNV": {
|
|
"(VK_NV_mesh_shader)": [
|
|
{
|
|
"vuid": "VUID-TaskCountNV-TaskCountNV-04384",
|
|
"text": " The <code>TaskCountNV</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>TaskNV</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-TaskCountNV-TaskCountNV-04385",
|
|
"text": " The variable decorated with <code>TaskCountNV</code> <strong class=\"purple\">must</strong> be declared using the <code>Output</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-TaskCountNV-TaskCountNV-04386",
|
|
"text": " The variable decorated with <code>TaskCountNV</code> <strong class=\"purple\">must</strong> be declared as a scalar 32-bit integer value"
|
|
}
|
|
]
|
|
},
|
|
"TessCoord": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-TessCoord-TessCoord-04387",
|
|
"text": " The <code>TessCoord</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>TessellationEvaluation</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-TessCoord-TessCoord-04388",
|
|
"text": " The variable decorated with <code>TessCoord</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-TessCoord-TessCoord-04389",
|
|
"text": " The variable decorated with <code>TessCoord</code> <strong class=\"purple\">must</strong> be declared as a three-component vector of 32-bit floating-point values"
|
|
}
|
|
]
|
|
},
|
|
"TessLevelOuter": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-TessLevelOuter-TessLevelOuter-04390",
|
|
"text": " The <code>TessLevelOuter</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>TessellationControl</code> or <code>TessellationEvaluation</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-TessLevelOuter-TessLevelOuter-04391",
|
|
"text": " The variable decorated with <code>TessLevelOuter</code> within the <code>TessellationControl</code> {ExecutionModel} <strong class=\"purple\">must</strong> be declared using the <code>Output</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-TessLevelOuter-TessLevelOuter-04392",
|
|
"text": " The variable decorated with <code>TessLevelOuter</code> within the <code>TessellationEvaluation</code> {ExecutionModel} <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-TessLevelOuter-TessLevelOuter-04393",
|
|
"text": " The variable decorated with <code>TessLevelOuter</code> <strong class=\"purple\">must</strong> be declared as an array of size four, containing 32-bit floating-point values"
|
|
}
|
|
]
|
|
},
|
|
"TessLevelInner": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-TessLevelInner-TessLevelInner-04394",
|
|
"text": " The <code>TessLevelInner</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>TessellationControl</code> or <code>TessellationEvaluation</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-TessLevelInner-TessLevelInner-04395",
|
|
"text": " The variable decorated with <code>TessLevelInner</code> within the <code>TessellationControl</code> {ExecutionModel} <strong class=\"purple\">must</strong> be declared using the <code>Output</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-TessLevelInner-TessLevelInner-04396",
|
|
"text": " The variable decorated with <code>TessLevelInner</code> within the <code>TessellationEvaluation</code> {ExecutionModel} <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-TessLevelInner-TessLevelInner-04397",
|
|
"text": " The variable decorated with <code>TessLevelInner</code> <strong class=\"purple\">must</strong> be declared as an array of size two, containing 32-bit floating-point values"
|
|
}
|
|
]
|
|
},
|
|
"VertexIndex": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VertexIndex-VertexIndex-04398",
|
|
"text": " The <code>VertexIndex</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>Vertex</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-VertexIndex-VertexIndex-04399",
|
|
"text": " The variable decorated with <code>VertexIndex</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-VertexIndex-VertexIndex-04400",
|
|
"text": " The variable decorated with <code>VertexIndex</code> <strong class=\"purple\">must</strong> be declared as a scalar 32-bit integer value"
|
|
}
|
|
]
|
|
},
|
|
"ViewIndex": {
|
|
"(VK_VERSION_1_1,VK_KHR_multiview)": [
|
|
{
|
|
"vuid": "VUID-ViewIndex-ViewIndex-04401",
|
|
"text": " The <code>ViewIndex</code> decoration <strong class=\"purple\">must</strong> not be used within the <code>GLCompute</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-ViewIndex-ViewIndex-04402",
|
|
"text": " The variable decorated with <code>ViewIndex</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-ViewIndex-ViewIndex-04403",
|
|
"text": " The variable decorated with <code>ViewIndex</code> <strong class=\"purple\">must</strong> be declared as a scalar 32-bit integer value"
|
|
}
|
|
]
|
|
},
|
|
"ViewportIndex": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-ViewportIndex-ViewportIndex-04404",
|
|
"text": " The <code>ViewportIndex</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>MeshNV</code>, <code>Vertex</code>, <code>TessellationEvaluation</code>, <code>Geometry</code>, or <code>Fragment</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-ViewportIndex-ViewportIndex-04406",
|
|
"text": " The variable decorated with <code>ViewportIndex</code> within the <code>MeshNV</code>, <code>Vertex</code>, <code>TessellationEvaluation</code>, or <code>Geometry</code> {ExecutionModel} <strong class=\"purple\">must</strong> be declared using the <code>Output</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-ViewportIndex-ViewportIndex-04407",
|
|
"text": " The variable decorated with <code>ViewportIndex</code> within the <code>Fragment</code> {ExecutionModel} <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-ViewportIndex-ViewportIndex-04408",
|
|
"text": " The variable decorated with <code>ViewportIndex</code> <strong class=\"purple\">must</strong> be declared as a scalar 32-bit integer value"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2)": [
|
|
{
|
|
"vuid": "VUID-ViewportIndex-ViewportIndex-04405",
|
|
"text": " If the <a href=\"#features-shaderOutputViewportIndex\"><code>shaderOutputViewportIndex</code></a> feature is not enabled then the <code>ViewportIndex</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>Geometry</code> or <code>Fragment</code> {ExecutionModel}"
|
|
}
|
|
]
|
|
},
|
|
"ViewportMaskNV": {
|
|
"(VK_NV_viewport_array2)": [
|
|
{
|
|
"vuid": "VUID-ViewportMaskNV-ViewportMaskNV-04409",
|
|
"text": " The <code>ViewportMaskNV</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>Vertex</code>, <code>MeshNV</code>, <code>TessellationEvaluation</code>, or <code>Geometry</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-ViewportMaskNV-ViewportMaskNV-04410",
|
|
"text": " The variable decorated with <code>ViewportMaskNV</code> <strong class=\"purple\">must</strong> be declared using the <code>Output</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-ViewportMaskNV-ViewportMaskNV-04411",
|
|
"text": " The variable decorated with <code>ViewportMaskNV</code> <strong class=\"purple\">must</strong> be declared as an array of 32-bit integer values"
|
|
}
|
|
]
|
|
},
|
|
"ViewportMaskPerViewNV": {
|
|
"(VK_NVX_multiview_per_view_attributes+VK_NV_viewport_array2)": [
|
|
{
|
|
"vuid": "VUID-ViewportMaskPerViewNV-ViewportMaskPerViewNV-04412",
|
|
"text": " The <code>ViewportMaskPerViewNV</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>Vertex</code>, <code>MeshNV</code>, <code>TessellationControl</code>, <code>TessellationEvaluation</code>, or <code>Geometry</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-ViewportMaskPerViewNV-ViewportMaskPerViewNV-04413",
|
|
"text": " The variable decorated with <code>ViewportMaskPerViewNV</code> <strong class=\"purple\">must</strong> be declared using the <code>Output</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-ViewportMaskPerViewNV-ViewportMaskPerViewNV-04414",
|
|
"text": " The variable decorated with <code>ViewportMaskPerViewNV</code> <strong class=\"purple\">must</strong> be declared as an array of 32-bit integer values"
|
|
},
|
|
{
|
|
"vuid": "VUID-ViewportMaskPerViewNV-ViewportMaskPerViewNV-04415",
|
|
"text": " The array decorated with <code>ViewportMaskPerViewNV</code> <strong class=\"purple\">must</strong> be a size less than or equal to 32"
|
|
},
|
|
{
|
|
"vuid": "VUID-ViewportMaskPerViewNV-ViewportMaskPerViewNV-04416",
|
|
"text": " The array decorated with <code>ViewportMaskPerViewNV</code> <strong class=\"purple\">must</strong> be a size greater than the maximum view in the subpass’s view mask"
|
|
},
|
|
{
|
|
"vuid": "VUID-ViewportMaskPerViewNV-ViewportMaskPerViewNV-04417",
|
|
"text": " The array variable decorated with <code>ViewportMaskPerViewNV</code> <strong class=\"purple\">must</strong> only be indexed by a constant or specialization constant"
|
|
}
|
|
]
|
|
},
|
|
"WarpsPerSMNV": {
|
|
"(VK_NV_shader_sm_builtins)": [
|
|
{
|
|
"vuid": "VUID-WarpsPerSMNV-WarpsPerSMNV-04418",
|
|
"text": " The variable decorated with <code>WarpsPerSMNV</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-WarpsPerSMNV-WarpsPerSMNV-04419",
|
|
"text": " The variable decorated with <code>WarpsPerSMNV</code> <strong class=\"purple\">must</strong> be declared as a scalar 32-bit integer value"
|
|
}
|
|
]
|
|
},
|
|
"WarpIDNV": {
|
|
"(VK_NV_shader_sm_builtins)": [
|
|
{
|
|
"vuid": "VUID-WarpIDNV-WarpIDNV-04420",
|
|
"text": " The variable decorated with <code>WarpIDNV</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-WarpIDNV-WarpIDNV-04421",
|
|
"text": " The variable decorated with <code>WarpIDNV</code> <strong class=\"purple\">must</strong> be declared as a scalar 32-bit integer value"
|
|
}
|
|
]
|
|
},
|
|
"WorkgroupId": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-WorkgroupId-WorkgroupId-04422",
|
|
"text": " The <code>WorkgroupId</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>GLCompute</code>, <code>MeshNV</code>, or <code>TaskNV</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-WorkgroupId-WorkgroupId-04423",
|
|
"text": " The variable decorated with <code>WorkgroupId</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-WorkgroupId-WorkgroupId-04424",
|
|
"text": " The variable decorated with <code>WorkgroupId</code> <strong class=\"purple\">must</strong> be declared as a three-component vector of 32-bit integer values"
|
|
}
|
|
]
|
|
},
|
|
"WorkgroupSize": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-WorkgroupSize-WorkgroupSize-04425",
|
|
"text": " The <code>WorkgroupSize</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>GLCompute</code>, <code>MeshNV</code>, or <code>TaskNV</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-WorkgroupSize-WorkgroupSize-04426",
|
|
"text": " The variable decorated with <code>WorkgroupSize</code> <strong class=\"purple\">must</strong> be a specialization constant or a constant"
|
|
},
|
|
{
|
|
"vuid": "VUID-WorkgroupSize-WorkgroupSize-04427",
|
|
"text": " The variable decorated with <code>WorkgroupSize</code> <strong class=\"purple\">must</strong> be declared as a three-component vector of 32-bit integer values"
|
|
}
|
|
]
|
|
},
|
|
"WorldRayDirectionKHR": {
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)": [
|
|
{
|
|
"vuid": "VUID-WorldRayDirectionKHR-WorldRayDirectionKHR-04428",
|
|
"text": " The <code>WorldRayDirectionKHR</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>IntersectionKHR</code>, <code>AnyHitKHR</code>, <code>ClosestHitKHR</code>, or <code>MissKHR</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-WorldRayDirectionKHR-WorldRayDirectionKHR-04429",
|
|
"text": " The variable decorated with <code>WorldRayDirectionKHR</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-WorldRayDirectionKHR-WorldRayDirectionKHR-04430",
|
|
"text": " The variable decorated with <code>WorldRayDirectionKHR</code> <strong class=\"purple\">must</strong> be declared as a three-component vector of 32-bit floating-point values"
|
|
}
|
|
]
|
|
},
|
|
"WorldRayOriginKHR": {
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)": [
|
|
{
|
|
"vuid": "VUID-WorldRayOriginKHR-WorldRayOriginKHR-04431",
|
|
"text": " The <code>WorldRayOriginKHR</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>IntersectionKHR</code>, <code>AnyHitKHR</code>, <code>ClosestHitKHR</code>, or <code>MissKHR</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-WorldRayOriginKHR-WorldRayOriginKHR-04432",
|
|
"text": " The variable decorated with <code>WorldRayOriginKHR</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-WorldRayOriginKHR-WorldRayOriginKHR-04433",
|
|
"text": " The variable decorated with <code>WorldRayOriginKHR</code> <strong class=\"purple\">must</strong> be declared as a three-component vector of 32-bit floating-point values"
|
|
}
|
|
]
|
|
},
|
|
"WorldToObjectKHR": {
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)": [
|
|
{
|
|
"vuid": "VUID-WorldToObjectKHR-WorldToObjectKHR-04434",
|
|
"text": " The <code>WorldToObjectKHR</code> decoration <strong class=\"purple\">must</strong> be used only within the <code>IntersectionKHR</code>, <code>AnyHitKHR</code>, or <code>ClosestHitKHR</code> {ExecutionModel}"
|
|
},
|
|
{
|
|
"vuid": "VUID-WorldToObjectKHR-WorldToObjectKHR-04435",
|
|
"text": " The variable decorated with <code>WorldToObjectKHR</code> <strong class=\"purple\">must</strong> be declared using the <code>Input</code> {StorageClass}"
|
|
},
|
|
{
|
|
"vuid": "VUID-WorldToObjectKHR-WorldToObjectKHR-04436",
|
|
"text": " The variable decorated with <code>WorldToObjectKHR</code> <strong class=\"purple\">must</strong> be declared as a matrix with four columns of three-component vectors of 32-bit floating-point values"
|
|
}
|
|
]
|
|
},
|
|
"vkCreateQueryPool": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCreateQueryPool-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateQueryPool-pCreateInfo-parameter",
|
|
"text": " <code>pCreateInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkQueryPoolCreateInfo\">VkQueryPoolCreateInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateQueryPool-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateQueryPool-pQueryPool-parameter",
|
|
"text": " <code>pQueryPool</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkQueryPool\">VkQueryPool</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkQueryPoolCreateInfo": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkQueryPoolCreateInfo-queryType-00791",
|
|
"text": " If the <a href=\"#features-pipelineStatisticsQuery\"><code>pipelineStatisticsQuery</code></a> feature is not enabled, <code>queryType</code> <strong class=\"purple\">must</strong> not be <code>VK_QUERY_TYPE_PIPELINE_STATISTICS</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkQueryPoolCreateInfo-queryType-00792",
|
|
"text": " If <code>queryType</code> is <code>VK_QUERY_TYPE_PIPELINE_STATISTICS</code>, <code>pipelineStatistics</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkQueryPipelineStatisticFlagBits\">VkQueryPipelineStatisticFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkQueryPoolCreateInfo-queryCount-02763",
|
|
"text": " <code>queryCount</code> <strong class=\"purple\">must</strong> be greater than 0"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkQueryPoolCreateInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_QUERY_POOL_CREATE_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkQueryPoolCreateInfo-pNext-pNext",
|
|
"text": " Each <code>pNext</code> member of any structure (including this one) in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be either <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkQueryPoolPerformanceCreateInfoKHR\">VkQueryPoolPerformanceCreateInfoKHR</a>, <a href=\"#VkQueryPoolPerformanceQueryCreateInfoINTEL\">VkQueryPoolPerformanceQueryCreateInfoINTEL</a>, <a href=\"#VkVideoDecodeH264ProfileEXT\">VkVideoDecodeH264ProfileEXT</a>, <a href=\"#VkVideoDecodeH265ProfileEXT\">VkVideoDecodeH265ProfileEXT</a>, <a href=\"#VkVideoEncodeH264ProfileEXT\">VkVideoEncodeH264ProfileEXT</a>, <a href=\"#VkVideoEncodeH265ProfileEXT\">VkVideoEncodeH265ProfileEXT</a>, or <a href=\"#VkVideoProfileKHR\">VkVideoProfileKHR</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkQueryPoolCreateInfo-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkQueryPoolCreateInfo-flags-zerobitmask",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkQueryPoolCreateInfo-queryType-parameter",
|
|
"text": " <code>queryType</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkQueryType\">VkQueryType</a> value"
|
|
}
|
|
],
|
|
"(VK_KHR_performance_query)": [
|
|
{
|
|
"vuid": "VUID-VkQueryPoolCreateInfo-queryType-03222",
|
|
"text": " If <code>queryType</code> is <code>VK_QUERY_TYPE_PERFORMANCE_QUERY_KHR</code>, the <code>pNext</code> chain <strong class=\"purple\">must</strong> include a <a href=\"#VkQueryPoolPerformanceCreateInfoKHR\">VkQueryPoolPerformanceCreateInfoKHR</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkQueryPoolPerformanceCreateInfoKHR": {
|
|
"(VK_KHR_performance_query)": [
|
|
{
|
|
"vuid": "VUID-VkQueryPoolPerformanceCreateInfoKHR-queueFamilyIndex-03236",
|
|
"text": " <code>queueFamilyIndex</code> <strong class=\"purple\">must</strong> be a valid queue family index of the device"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkQueryPoolPerformanceCreateInfoKHR-performanceCounterQueryPools-03237",
|
|
"text": " The <a href=\"#features-performanceCounterQueryPools\"><code>performanceCounterQueryPools</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkQueryPoolPerformanceCreateInfoKHR-pCounterIndices-03321",
|
|
"text": " Each element of <code>pCounterIndices</code> <strong class=\"purple\">must</strong> be in the range of counters reported by <code>vkEnumeratePhysicalDeviceQueueFamilyPerformanceQueryCountersKHR</code> for the queue family specified in <code>queueFamilyIndex</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkQueryPoolPerformanceCreateInfoKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_QUERY_POOL_PERFORMANCE_CREATE_INFO_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkQueryPoolPerformanceCreateInfoKHR-pCounterIndices-parameter",
|
|
"text": " <code>pCounterIndices</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>counterIndexCount</code> <code>uint32_t</code> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkQueryPoolPerformanceCreateInfoKHR-counterIndexCount-arraylength",
|
|
"text": " <code>counterIndexCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetPhysicalDeviceQueueFamilyPerformanceQueryPassesKHR": {
|
|
"(VK_KHR_performance_query)": [
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceQueueFamilyPerformanceQueryPassesKHR-physicalDevice-parameter",
|
|
"text": " <code>physicalDevice</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceQueueFamilyPerformanceQueryPassesKHR-pPerformanceQueryCreateInfo-parameter",
|
|
"text": " <code>pPerformanceQueryCreateInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkQueryPoolPerformanceCreateInfoKHR\">VkQueryPoolPerformanceCreateInfoKHR</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceQueueFamilyPerformanceQueryPassesKHR-pNumPasses-parameter",
|
|
"text": " <code>pNumPasses</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>uint32_t</code> value"
|
|
}
|
|
]
|
|
},
|
|
"vkDestroyQueryPool": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkDestroyQueryPool-queryPool-00793",
|
|
"text": " All submitted commands that refer to <code>queryPool</code> <strong class=\"purple\">must</strong> have completed execution"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyQueryPool-queryPool-00794",
|
|
"text": " If <code>VkAllocationCallbacks</code> were provided when <code>queryPool</code> was created, a compatible set of callbacks <strong class=\"purple\">must</strong> be provided here"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyQueryPool-queryPool-00795",
|
|
"text": " If no <code>VkAllocationCallbacks</code> were provided when <code>queryPool</code> was created, <code>pAllocator</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyQueryPool-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyQueryPool-queryPool-parameter",
|
|
"text": " If <code>queryPool</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>queryPool</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkQueryPool\">VkQueryPool</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyQueryPool-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyQueryPool-queryPool-parent",
|
|
"text": " If <code>queryPool</code> is a valid handle, it <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdResetQueryPool": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCmdResetQueryPool-firstQuery-00796",
|
|
"text": " <code>firstQuery</code> <strong class=\"purple\">must</strong> be less than the number of queries in <code>queryPool</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResetQueryPool-firstQuery-00797",
|
|
"text": " The sum of <code>firstQuery</code> and <code>queryCount</code> <strong class=\"purple\">must</strong> be less than or equal to the number of queries in <code>queryPool</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResetQueryPool-None-02841",
|
|
"text": " All queries used by the command <strong class=\"purple\">must</strong> not be active"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResetQueryPool-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResetQueryPool-queryPool-parameter",
|
|
"text": " <code>queryPool</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkQueryPool\">VkQueryPool</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResetQueryPool-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResetQueryPool-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics, compute, decode, or encode operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResetQueryPool-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResetQueryPool-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResetQueryPool-commonparent",
|
|
"text": " Both of <code>commandBuffer</code>, and <code>queryPool</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"(VK_KHR_performance_query)": [
|
|
{
|
|
"vuid": "VUID-vkCmdResetQueryPool-firstQuery-02862",
|
|
"text": " If <code>queryPool</code> was created with <code>VK_QUERY_TYPE_PERFORMANCE_QUERY_KHR</code>, this command <strong class=\"purple\">must</strong> not be recorded in a command buffer that, either directly or through secondary command buffers, also contains begin commands for a query from the set of queries <span class=\"eq\">[<code>firstQuery</code>, <code>firstQuery</code> + <code>queryCount</code> - 1]</span>"
|
|
}
|
|
]
|
|
},
|
|
"vkResetQueryPool": {
|
|
"(VK_VERSION_1_2,VK_EXT_host_query_reset)": [
|
|
{
|
|
"vuid": "VUID-vkResetQueryPool-None-02665",
|
|
"text": " The <a href=\"#features-hostQueryReset\"><code>hostQueryReset</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkResetQueryPool-firstQuery-02666",
|
|
"text": " <code>firstQuery</code> <strong class=\"purple\">must</strong> be less than the number of queries in <code>queryPool</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkResetQueryPool-firstQuery-02667",
|
|
"text": " The sum of <code>firstQuery</code> and <code>queryCount</code> <strong class=\"purple\">must</strong> be less than or equal to the number of queries in <code>queryPool</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkResetQueryPool-firstQuery-02741",
|
|
"text": " Submitted commands that refer to the range specified by <code>firstQuery</code> and <code>queryCount</code> in <code>queryPool</code> <strong class=\"purple\">must</strong> have completed execution"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkResetQueryPool-firstQuery-02742",
|
|
"text": " The range of queries specified by <code>firstQuery</code> and <code>queryCount</code> in <code>queryPool</code> <strong class=\"purple\">must</strong> not be in use by calls to <a href=\"#vkGetQueryPoolResults\">vkGetQueryPoolResults</a> or <code>vkResetQueryPool</code> in other threads"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkResetQueryPool-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkResetQueryPool-queryPool-parameter",
|
|
"text": " <code>queryPool</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkQueryPool\">VkQueryPool</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkResetQueryPool-queryPool-parent",
|
|
"text": " <code>queryPool</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdBeginQuery": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCmdBeginQuery-None-00807",
|
|
"text": " All queries used by the command <strong class=\"purple\">must</strong> be unavailable"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginQuery-queryType-02804",
|
|
"text": " The <code>queryType</code> used to create <code>queryPool</code> <strong class=\"purple\">must</strong> not be <code>VK_QUERY_TYPE_TIMESTAMP</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginQuery-queryType-00800",
|
|
"text": " If the <a href=\"#features-occlusionQueryPrecise\"><code>occlusionQueryPrecise</code></a> feature is not enabled, or the <code>queryType</code> used to create <code>queryPool</code> was not <code>VK_QUERY_TYPE_OCCLUSION</code>, <code>flags</code> <strong class=\"purple\">must</strong> not contain <code>VK_QUERY_CONTROL_PRECISE_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginQuery-query-00802",
|
|
"text": " <code>query</code> <strong class=\"purple\">must</strong> be less than the number of queries in <code>queryPool</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginQuery-queryType-00803",
|
|
"text": " If the <code>queryType</code> used to create <code>queryPool</code> was <code>VK_QUERY_TYPE_OCCLUSION</code>, the <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginQuery-queryType-00804",
|
|
"text": " If the <code>queryType</code> used to create <code>queryPool</code> was <code>VK_QUERY_TYPE_PIPELINE_STATISTICS</code> and any of the <code>pipelineStatistics</code> indicate graphics operations, the <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginQuery-queryType-00805",
|
|
"text": " If the <code>queryType</code> used to create <code>queryPool</code> was <code>VK_QUERY_TYPE_PIPELINE_STATISTICS</code> and any of the <code>pipelineStatistics</code> indicate compute operations, the <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support compute operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginQuery-queryPool-01922",
|
|
"text": " <code>queryPool</code> <strong class=\"purple\">must</strong> have been created with a <code>queryType</code> that differs from that of any queries that are <a href=\"#queries-operation-active\">active</a> within <code>commandBuffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginQuery-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginQuery-queryPool-parameter",
|
|
"text": " <code>queryPool</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkQueryPool\">VkQueryPool</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginQuery-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkQueryControlFlagBits\">VkQueryControlFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginQuery-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginQuery-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics, compute, decode, or encode operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginQuery-commonparent",
|
|
"text": " Both of <code>commandBuffer</code>, and <code>queryPool</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"(VK_KHR_acceleration_structure)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBeginQuery-queryType-04728",
|
|
"text": " The <code>queryType</code> used to create <code>queryPool</code> <strong class=\"purple\">must</strong> not be <code>VK_QUERY_TYPE_ACCELERATION_STRUCTURE_COMPACTED_SIZE_KHR</code> or <code>VK_QUERY_TYPE_ACCELERATION_STRUCTURE_SERIALIZATION_SIZE_KHR</code>"
|
|
}
|
|
],
|
|
"(VK_KHR_ray_tracing_maintenance1)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBeginQuery-queryType-06741",
|
|
"text": " The <code>queryType</code> used to create <code>queryPool</code> <strong class=\"purple\">must</strong> not be <code>VK_QUERY_TYPE_ACCELERATION_STRUCTURE_SIZE_KHR</code> or <code>VK_QUERY_TYPE_ACCELERATION_STRUCTURE_SERIALIZATION_BOTTOM_LEVEL_POINTERS_KHR</code>"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBeginQuery-queryType-04729",
|
|
"text": " The <code>queryType</code> used to create <code>queryPool</code> <strong class=\"purple\">must</strong> not be <code>VK_QUERY_TYPE_ACCELERATION_STRUCTURE_COMPACTED_SIZE_NV</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBeginQuery-commandBuffer-01885",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> not be a protected command buffer"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_multiview)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBeginQuery-query-00808",
|
|
"text": " If called within a render pass instance, the sum of <code>query</code> and the number of bits set in the current subpass’s view mask <strong class=\"purple\">must</strong> be less than or equal to the number of queries in <code>queryPool</code>"
|
|
}
|
|
],
|
|
"(VK_KHR_video_encode_queue)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBeginQuery-queryType-04862",
|
|
"text": " If the <code>queryType</code> used to create <code>queryPool</code> was <code>VK_QUERY_TYPE_VIDEO_ENCODE_BITSTREAM_BUFFER_RANGE_KHR</code> the <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support <a href=\"#video-encode-operations\">video encode operations</a>"
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBeginQuery-queryType-02327",
|
|
"text": " If the <code>queryType</code> used to create <code>queryPool</code> was <code>VK_QUERY_TYPE_TRANSFORM_FEEDBACK_STREAM_EXT</code> the <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginQuery-queryType-02328",
|
|
"text": " If the <code>queryType</code> used to create <code>queryPool</code> was <code>VK_QUERY_TYPE_TRANSFORM_FEEDBACK_STREAM_EXT</code> then <code>VkPhysicalDeviceTransformFeedbackPropertiesEXT</code>::<code>transformFeedbackQueries</code> <strong class=\"purple\">must</strong> be supported"
|
|
}
|
|
],
|
|
"(VK_EXT_primitives_generated_query)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBeginQuery-queryType-06687",
|
|
"text": " If the <code>queryType</code> used to create <code>queryPool</code> was <code>VK_QUERY_TYPE_PRIMITIVES_GENERATED_EXT</code> the <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginQuery-queryType-06688",
|
|
"text": " If the <code>queryType</code> used to create <code>queryPool</code> was <code>VK_QUERY_TYPE_PRIMITIVES_GENERATED_EXT</code> then <a href=\"#features-primitivesGeneratedQuery\"><code>primitivesGeneratedQuery</code></a> <strong class=\"purple\">must</strong> be enabled"
|
|
}
|
|
],
|
|
"(VK_KHR_performance_query)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBeginQuery-queryPool-03223",
|
|
"text": " If <code>queryPool</code> was created with a <code>queryType</code> of <code>VK_QUERY_TYPE_PERFORMANCE_QUERY_KHR</code>, the <a href=\"#profiling-lock\">profiling lock</a> <strong class=\"purple\">must</strong> have been held before <a href=\"#vkBeginCommandBuffer\">vkBeginCommandBuffer</a> was called on <code>commandBuffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginQuery-queryPool-03224",
|
|
"text": " If <code>queryPool</code> was created with a <code>queryType</code> of <code>VK_QUERY_TYPE_PERFORMANCE_QUERY_KHR</code> and one of the counters used to create <code>queryPool</code> was <code>VK_PERFORMANCE_COUNTER_SCOPE_COMMAND_BUFFER_KHR</code>, the query begin <strong class=\"purple\">must</strong> be the first recorded command in <code>commandBuffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginQuery-queryPool-03225",
|
|
"text": " If <code>queryPool</code> was created with a <code>queryType</code> of <code>VK_QUERY_TYPE_PERFORMANCE_QUERY_KHR</code> and one of the counters used to create <code>queryPool</code> was <code>VK_PERFORMANCE_COUNTER_SCOPE_RENDER_PASS_KHR</code>, the begin command <strong class=\"purple\">must</strong> not be recorded within a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginQuery-queryPool-03226",
|
|
"text": " If <code>queryPool</code> was created with a <code>queryType</code> of <code>VK_QUERY_TYPE_PERFORMANCE_QUERY_KHR</code> and another query pool with a <code>queryType</code> <code>VK_QUERY_TYPE_PERFORMANCE_QUERY_KHR</code> has been used within <code>commandBuffer</code>, its parent primary command buffer or secondary command buffer recorded within the same parent primary command buffer as <code>commandBuffer</code>, the <a href=\"#features-performanceCounterMultipleQueryPools\"><code>performanceCounterMultipleQueryPools</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginQuery-None-02863",
|
|
"text": " If <code>queryPool</code> was created with a <code>queryType</code> of <code>VK_QUERY_TYPE_PERFORMANCE_QUERY_KHR</code>, this command <strong class=\"purple\">must</strong> not be recorded in a command buffer that, either directly or through secondary command buffers, also contains a <code>vkCmdResetQueryPool</code> command affecting the same query"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdBeginQueryIndexedEXT": {
|
|
"(VK_EXT_transform_feedback)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBeginQueryIndexedEXT-None-00807",
|
|
"text": " All queries used by the command <strong class=\"purple\">must</strong> be unavailable"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginQueryIndexedEXT-queryType-02804",
|
|
"text": " The <code>queryType</code> used to create <code>queryPool</code> <strong class=\"purple\">must</strong> not be <code>VK_QUERY_TYPE_TIMESTAMP</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginQueryIndexedEXT-queryType-00800",
|
|
"text": " If the <a href=\"#features-occlusionQueryPrecise\"><code>occlusionQueryPrecise</code></a> feature is not enabled, or the <code>queryType</code> used to create <code>queryPool</code> was not <code>VK_QUERY_TYPE_OCCLUSION</code>, <code>flags</code> <strong class=\"purple\">must</strong> not contain <code>VK_QUERY_CONTROL_PRECISE_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginQueryIndexedEXT-query-00802",
|
|
"text": " <code>query</code> <strong class=\"purple\">must</strong> be less than the number of queries in <code>queryPool</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginQueryIndexedEXT-queryType-00803",
|
|
"text": " If the <code>queryType</code> used to create <code>queryPool</code> was <code>VK_QUERY_TYPE_OCCLUSION</code>, the <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginQueryIndexedEXT-queryType-00804",
|
|
"text": " If the <code>queryType</code> used to create <code>queryPool</code> was <code>VK_QUERY_TYPE_PIPELINE_STATISTICS</code> and any of the <code>pipelineStatistics</code> indicate graphics operations, the <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginQueryIndexedEXT-queryType-00805",
|
|
"text": " If the <code>queryType</code> used to create <code>queryPool</code> was <code>VK_QUERY_TYPE_PIPELINE_STATISTICS</code> and any of the <code>pipelineStatistics</code> indicate compute operations, the <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support compute operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginQueryIndexedEXT-queryPool-04753",
|
|
"text": " If the <code>queryPool</code> was created with the same <code>queryType</code> as that of another <a href=\"#queries-operation-active\">active</a> query within <code>commandBuffer</code>, then <code>index</code> <strong class=\"purple\">must</strong> not match the index used for the active query"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginQueryIndexedEXT-queryType-02338",
|
|
"text": " If the <code>queryType</code> used to create <code>queryPool</code> was <code>VK_QUERY_TYPE_TRANSFORM_FEEDBACK_STREAM_EXT</code> the <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginQueryIndexedEXT-queryType-02339",
|
|
"text": " If the <code>queryType</code> used to create <code>queryPool</code> was <code>VK_QUERY_TYPE_TRANSFORM_FEEDBACK_STREAM_EXT</code> the <code>index</code> parameter <strong class=\"purple\">must</strong> be less than <code>VkPhysicalDeviceTransformFeedbackPropertiesEXT</code>::<code>maxTransformFeedbackStreams</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginQueryIndexedEXT-queryType-02341",
|
|
"text": " If the <code>queryType</code> used to create <code>queryPool</code> was <code>VK_QUERY_TYPE_TRANSFORM_FEEDBACK_STREAM_EXT</code> then <code>VkPhysicalDeviceTransformFeedbackPropertiesEXT</code>::<code>transformFeedbackQueries</code> <strong class=\"purple\">must</strong> be supported"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginQueryIndexedEXT-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginQueryIndexedEXT-queryPool-parameter",
|
|
"text": " <code>queryPool</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkQueryPool\">VkQueryPool</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginQueryIndexedEXT-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkQueryControlFlagBits\">VkQueryControlFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginQueryIndexedEXT-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginQueryIndexedEXT-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics, or compute operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginQueryIndexedEXT-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginQueryIndexedEXT-commonparent",
|
|
"text": " Both of <code>commandBuffer</code>, and <code>queryPool</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)+(VK_KHR_acceleration_structure)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBeginQueryIndexedEXT-queryType-04728",
|
|
"text": " The <code>queryType</code> used to create <code>queryPool</code> <strong class=\"purple\">must</strong> not be <code>VK_QUERY_TYPE_ACCELERATION_STRUCTURE_COMPACTED_SIZE_KHR</code> or <code>VK_QUERY_TYPE_ACCELERATION_STRUCTURE_SERIALIZATION_SIZE_KHR</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)+(VK_KHR_ray_tracing_maintenance1)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBeginQueryIndexedEXT-queryType-06741",
|
|
"text": " The <code>queryType</code> used to create <code>queryPool</code> <strong class=\"purple\">must</strong> not be <code>VK_QUERY_TYPE_ACCELERATION_STRUCTURE_SIZE_KHR</code> or <code>VK_QUERY_TYPE_ACCELERATION_STRUCTURE_SERIALIZATION_BOTTOM_LEVEL_POINTERS_KHR</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)+(VK_NV_ray_tracing)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBeginQueryIndexedEXT-queryType-04729",
|
|
"text": " The <code>queryType</code> used to create <code>queryPool</code> <strong class=\"purple\">must</strong> not be <code>VK_QUERY_TYPE_ACCELERATION_STRUCTURE_COMPACTED_SIZE_NV</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)+(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBeginQueryIndexedEXT-commandBuffer-01885",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> not be a protected command buffer"
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)+(VK_VERSION_1_1,VK_KHR_multiview)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBeginQueryIndexedEXT-query-00808",
|
|
"text": " If called within a render pass instance, the sum of <code>query</code> and the number of bits set in the current subpass’s view mask <strong class=\"purple\">must</strong> be less than or equal to the number of queries in <code>queryPool</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)+(VK_KHR_video_encode_queue)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBeginQueryIndexedEXT-queryType-04862",
|
|
"text": " If the <code>queryType</code> used to create <code>queryPool</code> was <code>VK_QUERY_TYPE_VIDEO_ENCODE_BITSTREAM_BUFFER_RANGE_KHR</code> the <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support <a href=\"#video-encode-operations\">video encode operations</a>"
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)+!(VK_EXT_primitives_generated_query)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBeginQueryIndexedEXT-queryType-02340",
|
|
"text": " If the <code>queryType</code> used to create <code>queryPool</code> was not <code>VK_QUERY_TYPE_TRANSFORM_FEEDBACK_STREAM_EXT</code> the <code>index</code> <strong class=\"purple\">must</strong> be zero"
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)+(VK_EXT_primitives_generated_query)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBeginQueryIndexedEXT-queryType-06689",
|
|
"text": " If the <code>queryType</code> used to create <code>queryPool</code> was <code>VK_QUERY_TYPE_PRIMITIVES_GENERATED_EXT</code> the <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginQueryIndexedEXT-queryType-06690",
|
|
"text": " If the <code>queryType</code> used to create <code>queryPool</code> was <code>VK_QUERY_TYPE_PRIMITIVES_GENERATED_EXT</code> the <code>index</code> parameter <strong class=\"purple\">must</strong> be less than <code>VkPhysicalDeviceTransformFeedbackPropertiesEXT</code>::<code>maxTransformFeedbackStreams</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginQueryIndexedEXT-queryType-06691",
|
|
"text": " If the <code>queryType</code> used to create <code>queryPool</code> was <code>VK_QUERY_TYPE_PRIMITIVES_GENERATED_EXT</code> and the <a href=\"#features-primitivesGeneratedQueryWithNonZeroStreams\"><code>primitivesGeneratedQueryWithNonZeroStreams</code></a> feature is not enabled, the <code>index</code> parameter <strong class=\"purple\">must</strong> be zero."
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginQueryIndexedEXT-queryType-06692",
|
|
"text": " If the <code>queryType</code> used to create <code>queryPool</code> was not <code>VK_QUERY_TYPE_TRANSFORM_FEEDBACK_STREAM_EXT</code> and not <code>VK_QUERY_TYPE_PRIMITIVES_GENERATED_EXT</code>, the <code>index</code> <strong class=\"purple\">must</strong> be zero"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginQueryIndexedEXT-queryType-06693",
|
|
"text": " If the <code>queryType</code> used to create <code>queryPool</code> was <code>VK_QUERY_TYPE_PRIMITIVES_GENERATED_EXT</code> then <a href=\"#features-primitivesGeneratedQuery\"><code>primitivesGeneratedQuery</code></a> <strong class=\"purple\">must</strong> be enabled"
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)+(VK_KHR_performance_query)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBeginQueryIndexedEXT-queryPool-03223",
|
|
"text": " If <code>queryPool</code> was created with a <code>queryType</code> of <code>VK_QUERY_TYPE_PERFORMANCE_QUERY_KHR</code>, the <a href=\"#profiling-lock\">profiling lock</a> <strong class=\"purple\">must</strong> have been held before <a href=\"#vkBeginCommandBuffer\">vkBeginCommandBuffer</a> was called on <code>commandBuffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginQueryIndexedEXT-queryPool-03224",
|
|
"text": " If <code>queryPool</code> was created with a <code>queryType</code> of <code>VK_QUERY_TYPE_PERFORMANCE_QUERY_KHR</code> and one of the counters used to create <code>queryPool</code> was <code>VK_PERFORMANCE_COUNTER_SCOPE_COMMAND_BUFFER_KHR</code>, the query begin <strong class=\"purple\">must</strong> be the first recorded command in <code>commandBuffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginQueryIndexedEXT-queryPool-03225",
|
|
"text": " If <code>queryPool</code> was created with a <code>queryType</code> of <code>VK_QUERY_TYPE_PERFORMANCE_QUERY_KHR</code> and one of the counters used to create <code>queryPool</code> was <code>VK_PERFORMANCE_COUNTER_SCOPE_RENDER_PASS_KHR</code>, the begin command <strong class=\"purple\">must</strong> not be recorded within a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginQueryIndexedEXT-queryPool-03226",
|
|
"text": " If <code>queryPool</code> was created with a <code>queryType</code> of <code>VK_QUERY_TYPE_PERFORMANCE_QUERY_KHR</code> and another query pool with a <code>queryType</code> <code>VK_QUERY_TYPE_PERFORMANCE_QUERY_KHR</code> has been used within <code>commandBuffer</code>, its parent primary command buffer or secondary command buffer recorded within the same parent primary command buffer as <code>commandBuffer</code>, the <a href=\"#features-performanceCounterMultipleQueryPools\"><code>performanceCounterMultipleQueryPools</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginQueryIndexedEXT-None-02863",
|
|
"text": " If <code>queryPool</code> was created with a <code>queryType</code> of <code>VK_QUERY_TYPE_PERFORMANCE_QUERY_KHR</code>, this command <strong class=\"purple\">must</strong> not be recorded in a command buffer that, either directly or through secondary command buffers, also contains a <code>vkCmdResetQueryPool</code> command affecting the same query"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdEndQuery": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCmdEndQuery-None-01923",
|
|
"text": " All queries used by the command <strong class=\"purple\">must</strong> be <a href=\"#queries-operation-active\">active</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndQuery-query-00810",
|
|
"text": " <code>query</code> <strong class=\"purple\">must</strong> be less than the number of queries in <code>queryPool</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndQuery-None-07007",
|
|
"text": " If called within a subpass of a render pass instance, the corresponding <code>vkCmdBeginQuery</code>* command <strong class=\"purple\">must</strong> have been called previously within the same subpass"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndQuery-None-07008",
|
|
"text": " If called outside of a render pass instance, the corresponding <code>vkCmdBeginQuery</code>* command <strong class=\"purple\">must</strong> have been called outside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndQuery-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndQuery-queryPool-parameter",
|
|
"text": " <code>queryPool</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkQueryPool\">VkQueryPool</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndQuery-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndQuery-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics, compute, decode, or encode operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndQuery-commonparent",
|
|
"text": " Both of <code>commandBuffer</code>, and <code>queryPool</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-vkCmdEndQuery-commandBuffer-01886",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> not be a protected command buffer"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_multiview)": [
|
|
{
|
|
"vuid": "VUID-vkCmdEndQuery-query-00812",
|
|
"text": " If <code>vkCmdEndQuery</code> is called within a render pass instance, the sum of <code>query</code> and the number of bits set in the current subpass’s view mask <strong class=\"purple\">must</strong> be less than or equal to the number of queries in <code>queryPool</code>"
|
|
}
|
|
],
|
|
"(VK_KHR_performance_query)": [
|
|
{
|
|
"vuid": "VUID-vkCmdEndQuery-queryPool-03227",
|
|
"text": " If <code>queryPool</code> was created with a <code>queryType</code> of <code>VK_QUERY_TYPE_PERFORMANCE_QUERY_KHR</code> and one or more of the counters used to create <code>queryPool</code> was <code>VK_PERFORMANCE_COUNTER_SCOPE_COMMAND_BUFFER_KHR</code>, the <a href=\"#vkCmdEndQuery\">vkCmdEndQuery</a> <strong class=\"purple\">must</strong> be the last recorded command in <code>commandBuffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndQuery-queryPool-03228",
|
|
"text": " If <code>queryPool</code> was created with a <code>queryType</code> of <code>VK_QUERY_TYPE_PERFORMANCE_QUERY_KHR</code> and one or more of the counters used to create <code>queryPool</code> was <code>VK_PERFORMANCE_COUNTER_SCOPE_RENDER_PASS_KHR</code>, the <a href=\"#vkCmdEndQuery\">vkCmdEndQuery</a> <strong class=\"purple\">must</strong> not be recorded within a render pass instance"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdEndQueryIndexedEXT": {
|
|
"(VK_EXT_transform_feedback)": [
|
|
{
|
|
"vuid": "VUID-vkCmdEndQueryIndexedEXT-None-02342",
|
|
"text": " All queries used by the command <strong class=\"purple\">must</strong> be <a href=\"#queries-operation-active\">active</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndQueryIndexedEXT-query-02343",
|
|
"text": " <code>query</code> <strong class=\"purple\">must</strong> be less than the number of queries in <code>queryPool</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndQueryIndexedEXT-None-07007",
|
|
"text": " If called within a subpass of a render pass instance, the corresponding <code>vkCmdBeginQuery</code>* command <strong class=\"purple\">must</strong> have been called previously within the same subpass"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndQueryIndexedEXT-None-07008",
|
|
"text": " If called outside of a render pass instance, the corresponding <code>vkCmdBeginQuery</code>* command <strong class=\"purple\">must</strong> have been called outside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndQueryIndexedEXT-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndQueryIndexedEXT-queryPool-parameter",
|
|
"text": " <code>queryPool</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkQueryPool\">VkQueryPool</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndQueryIndexedEXT-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndQueryIndexedEXT-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics, or compute operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndQueryIndexedEXT-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndQueryIndexedEXT-commonparent",
|
|
"text": " Both of <code>commandBuffer</code>, and <code>queryPool</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)+(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-vkCmdEndQueryIndexedEXT-commandBuffer-02344",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> not be a protected command buffer"
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)+(VK_VERSION_1_1,VK_KHR_multiview)": [
|
|
{
|
|
"vuid": "VUID-vkCmdEndQueryIndexedEXT-query-02345",
|
|
"text": " If <code>vkCmdEndQueryIndexedEXT</code> is called within a render pass instance, the sum of <code>query</code> and the number of bits set in the current subpass’s view mask <strong class=\"purple\">must</strong> be less than or equal to the number of queries in <code>queryPool</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)+!(VK_EXT_primitives_generated_query)": [
|
|
{
|
|
"vuid": "VUID-vkCmdEndQueryIndexedEXT-queryType-02346",
|
|
"text": " If the <code>queryType</code> used to create <code>queryPool</code> was <code>VK_QUERY_TYPE_TRANSFORM_FEEDBACK_STREAM_EXT</code> the <code>index</code> parameter <strong class=\"purple\">must</strong> be less than <code>VkPhysicalDeviceTransformFeedbackPropertiesEXT</code>::<code>maxTransformFeedbackStreams</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndQueryIndexedEXT-queryType-02347",
|
|
"text": " If the <code>queryType</code> used to create <code>queryPool</code> was not <code>VK_QUERY_TYPE_TRANSFORM_FEEDBACK_STREAM_EXT</code> the <code>index</code> <strong class=\"purple\">must</strong> be zero"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndQueryIndexedEXT-queryType-02723",
|
|
"text": " If the <code>queryType</code> used to create <code>queryPool</code> was <code>VK_QUERY_TYPE_TRANSFORM_FEEDBACK_STREAM_EXT</code> <code>index</code> <strong class=\"purple\">must</strong> equal the <code>index</code> used to begin the query"
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)+(VK_EXT_primitives_generated_query)": [
|
|
{
|
|
"vuid": "VUID-vkCmdEndQueryIndexedEXT-queryType-06694",
|
|
"text": " If the <code>queryType</code> used to create <code>queryPool</code> was <code>VK_QUERY_TYPE_TRANSFORM_FEEDBACK_STREAM_EXT</code> or <code>VK_QUERY_TYPE_PRIMITIVES_GENERATED_EXT</code>, the <code>index</code> parameter <strong class=\"purple\">must</strong> be less than <code>VkPhysicalDeviceTransformFeedbackPropertiesEXT</code>::<code>maxTransformFeedbackStreams</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndQueryIndexedEXT-queryType-06695",
|
|
"text": " If the <code>queryType</code> used to create <code>queryPool</code> was not <code>VK_QUERY_TYPE_TRANSFORM_FEEDBACK_STREAM_EXT</code> and not <code>VK_QUERY_TYPE_PRIMITIVES_GENERATED_EXT</code>, the <code>index</code> <strong class=\"purple\">must</strong> be zero"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndQueryIndexedEXT-queryType-06696",
|
|
"text": " If the <code>queryType</code> used to create <code>queryPool</code> was <code>VK_QUERY_TYPE_TRANSFORM_FEEDBACK_STREAM_EXT</code> or <code>VK_QUERY_TYPE_PRIMITIVES_GENERATED_EXT</code>, <code>index</code> <strong class=\"purple\">must</strong> equal the <code>index</code> used to begin the query"
|
|
}
|
|
]
|
|
},
|
|
"vkGetQueryPoolResults": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkGetQueryPoolResults-firstQuery-00813",
|
|
"text": " <code>firstQuery</code> <strong class=\"purple\">must</strong> be less than the number of queries in <code>queryPool</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetQueryPoolResults-flags-00815",
|
|
"text": " If <code>VK_QUERY_RESULT_64_BIT</code> is set in <code>flags</code> then <code>pData</code> and <code>stride</code> <strong class=\"purple\">must</strong> be multiples of <code>8</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetQueryPoolResults-firstQuery-00816",
|
|
"text": " The sum of <code>firstQuery</code> and <code>queryCount</code> <strong class=\"purple\">must</strong> be less than or equal to the number of queries in <code>queryPool</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetQueryPoolResults-dataSize-00817",
|
|
"text": " <code>dataSize</code> <strong class=\"purple\">must</strong> be large enough to contain the result of each query, as described <a href=\"#queries-operation-memorylayout\">here</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetQueryPoolResults-queryType-00818",
|
|
"text": " If the <code>queryType</code> used to create <code>queryPool</code> was <code>VK_QUERY_TYPE_TIMESTAMP</code>, <code>flags</code> <strong class=\"purple\">must</strong> not contain <code>VK_QUERY_RESULT_PARTIAL_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetQueryPoolResults-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetQueryPoolResults-queryPool-parameter",
|
|
"text": " <code>queryPool</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkQueryPool\">VkQueryPool</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetQueryPoolResults-pData-parameter",
|
|
"text": " <code>pData</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>dataSize</code> bytes"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetQueryPoolResults-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkQueryResultFlagBits\">VkQueryResultFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetQueryPoolResults-dataSize-arraylength",
|
|
"text": " <code>dataSize</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetQueryPoolResults-queryPool-parent",
|
|
"text": " <code>queryPool</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
],
|
|
"!(VK_KHR_performance_query)": [
|
|
{
|
|
"vuid": "VUID-vkGetQueryPoolResults-flags-02827",
|
|
"text": " If <code>VK_QUERY_RESULT_64_BIT</code> is not set in <code>flags</code>, then <code>pData</code> and <code>stride</code> <strong class=\"purple\">must</strong> be multiples of <code>4</code>"
|
|
}
|
|
],
|
|
"(VK_KHR_performance_query)": [
|
|
{
|
|
"vuid": "VUID-vkGetQueryPoolResults-flags-02828",
|
|
"text": " If <code>VK_QUERY_RESULT_64_BIT</code> is not set in <code>flags</code> and the <code>queryType</code> used to create <code>queryPool</code> was not <code>VK_QUERY_TYPE_PERFORMANCE_QUERY_KHR</code>, then <code>pData</code> and <code>stride</code> <strong class=\"purple\">must</strong> be multiples of <code>4</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetQueryPoolResults-queryType-03229",
|
|
"text": " If the <code>queryType</code> used to create <code>queryPool</code> was <code>VK_QUERY_TYPE_PERFORMANCE_QUERY_KHR</code>, then <code>pData</code> and <code>stride</code> <strong class=\"purple\">must</strong> be multiples of the size of <a href=\"#VkPerformanceCounterResultKHR\">VkPerformanceCounterResultKHR</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetQueryPoolResults-queryType-04519",
|
|
"text": " If the <code>queryType</code> used to create <code>queryPool</code> was <code>VK_QUERY_TYPE_PERFORMANCE_QUERY_KHR</code>, then <code>stride</code> <strong class=\"purple\">must</strong> be large enough to contain <code>VkQueryPoolPerformanceCreateInfoKHR</code>::<code>counterIndexCount</code> used to create <code>queryPool</code> times the size of <a href=\"#VkPerformanceCounterResultKHR\">VkPerformanceCounterResultKHR</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetQueryPoolResults-queryType-03230",
|
|
"text": " If the <code>queryType</code> used to create <code>queryPool</code> was <code>VK_QUERY_TYPE_PERFORMANCE_QUERY_KHR</code>, <code>flags</code> <strong class=\"purple\">must</strong> not contain <code>VK_QUERY_RESULT_WITH_AVAILABILITY_BIT</code>, <code>VK_QUERY_RESULT_PARTIAL_BIT</code> or <code>VK_QUERY_RESULT_64_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetQueryPoolResults-queryType-03231",
|
|
"text": " If the <code>queryType</code> used to create <code>queryPool</code> was <code>VK_QUERY_TYPE_PERFORMANCE_QUERY_KHR</code>, the <code>queryPool</code> <strong class=\"purple\">must</strong> have been recorded once for each pass as retrieved via a call to <a href=\"#vkGetPhysicalDeviceQueueFamilyPerformanceQueryPassesKHR\">vkGetPhysicalDeviceQueueFamilyPerformanceQueryPassesKHR</a>"
|
|
}
|
|
],
|
|
"(VK_KHR_video_queue)": [
|
|
{
|
|
"vuid": "VUID-vkGetQueryPoolResults-queryType-04810",
|
|
"text": " If the <code>queryType</code> used to create <code>queryPool</code> was <code>VK_QUERY_TYPE_RESULT_STATUS_ONLY_KHR</code>, <code>flags</code> <strong class=\"purple\">must</strong> include <code>VK_QUERY_RESULT_WITH_STATUS_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetQueryPoolResults-flags-04811",
|
|
"text": " If <code>flags</code> includes <code>VK_QUERY_RESULT_WITH_STATUS_BIT_KHR</code>, it <strong class=\"purple\">must</strong> not include <code>VK_QUERY_RESULT_WITH_AVAILABILITY_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetQueryPoolResults-queryType-06900",
|
|
"text": " If the <code>queryType</code> used to create <code>queryPool</code> was <code>VK_QUERY_TYPE_PERFORMANCE_QUERY_KHR</code>, <code>flags</code> <strong class=\"purple\">must</strong> not contain <code>VK_QUERY_RESULT_WITH_STATUS_BIT_KHR</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdCopyQueryPoolResults": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCmdCopyQueryPoolResults-dstOffset-00819",
|
|
"text": " <code>dstOffset</code> <strong class=\"purple\">must</strong> be less than the size of <code>dstBuffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyQueryPoolResults-firstQuery-00820",
|
|
"text": " <code>firstQuery</code> <strong class=\"purple\">must</strong> be less than the number of queries in <code>queryPool</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyQueryPoolResults-firstQuery-00821",
|
|
"text": " The sum of <code>firstQuery</code> and <code>queryCount</code> <strong class=\"purple\">must</strong> be less than or equal to the number of queries in <code>queryPool</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyQueryPoolResults-flags-00822",
|
|
"text": " If <code>VK_QUERY_RESULT_64_BIT</code> is not set in <code>flags</code> then <code>dstOffset</code> and <code>stride</code> <strong class=\"purple\">must</strong> be multiples of <code>4</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyQueryPoolResults-flags-00823",
|
|
"text": " If <code>VK_QUERY_RESULT_64_BIT</code> is set in <code>flags</code> then <code>dstOffset</code> and <code>stride</code> <strong class=\"purple\">must</strong> be multiples of <code>8</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyQueryPoolResults-dstBuffer-00824",
|
|
"text": " <code>dstBuffer</code> <strong class=\"purple\">must</strong> have enough storage, from <code>dstOffset</code>, to contain the result of each query, as described <a href=\"#queries-operation-memorylayout\">here</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyQueryPoolResults-dstBuffer-00825",
|
|
"text": " <code>dstBuffer</code> <strong class=\"purple\">must</strong> have been created with <code>VK_BUFFER_USAGE_TRANSFER_DST_BIT</code> usage flag"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyQueryPoolResults-dstBuffer-00826",
|
|
"text": " If <code>dstBuffer</code> is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyQueryPoolResults-queryType-00827",
|
|
"text": " If the <code>queryType</code> used to create <code>queryPool</code> was <code>VK_QUERY_TYPE_TIMESTAMP</code>, <code>flags</code> <strong class=\"purple\">must</strong> not contain <code>VK_QUERY_RESULT_PARTIAL_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyQueryPoolResults-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyQueryPoolResults-queryPool-parameter",
|
|
"text": " <code>queryPool</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkQueryPool\">VkQueryPool</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyQueryPoolResults-dstBuffer-parameter",
|
|
"text": " <code>dstBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBuffer\">VkBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyQueryPoolResults-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkQueryResultFlagBits\">VkQueryResultFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyQueryPoolResults-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyQueryPoolResults-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics, or compute operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyQueryPoolResults-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyQueryPoolResults-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyQueryPoolResults-commonparent",
|
|
"text": " Each of <code>commandBuffer</code>, <code>dstBuffer</code>, and <code>queryPool</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"(VK_KHR_performance_query)": [
|
|
{
|
|
"vuid": "VUID-vkCmdCopyQueryPoolResults-queryType-03232",
|
|
"text": " If the <code>queryType</code> used to create <code>queryPool</code> was <code>VK_QUERY_TYPE_PERFORMANCE_QUERY_KHR</code>, <a href=\"#VkPhysicalDevicePerformanceQueryPropertiesKHR\">VkPhysicalDevicePerformanceQueryPropertiesKHR</a>::<code>allowCommandBufferQueryCopies</code> <strong class=\"purple\">must</strong> be <code>VK_TRUE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyQueryPoolResults-queryType-03233",
|
|
"text": " If the <code>queryType</code> used to create <code>queryPool</code> was <code>VK_QUERY_TYPE_PERFORMANCE_QUERY_KHR</code>, <code>flags</code> <strong class=\"purple\">must</strong> not contain <code>VK_QUERY_RESULT_WITH_AVAILABILITY_BIT</code>, <code>VK_QUERY_RESULT_PARTIAL_BIT</code> or <code>VK_QUERY_RESULT_64_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyQueryPoolResults-queryType-03234",
|
|
"text": " If the <code>queryType</code> used to create <code>queryPool</code> was <code>VK_QUERY_TYPE_PERFORMANCE_QUERY_KHR</code>, the <code>queryPool</code> <strong class=\"purple\">must</strong> have been submitted once for each pass as retrieved via a call to <a href=\"#vkGetPhysicalDeviceQueueFamilyPerformanceQueryPassesKHR\">vkGetPhysicalDeviceQueueFamilyPerformanceQueryPassesKHR</a>"
|
|
}
|
|
],
|
|
"(VK_INTEL_performance_query)": [
|
|
{
|
|
"vuid": "VUID-vkCmdCopyQueryPoolResults-queryType-02734",
|
|
"text": " <a href=\"#vkCmdCopyQueryPoolResults\">vkCmdCopyQueryPoolResults</a> <strong class=\"purple\">must</strong> not be called if the <code>queryType</code> used to create <code>queryPool</code> was <code>VK_QUERY_TYPE_PERFORMANCE_QUERY_INTEL</code>"
|
|
}
|
|
],
|
|
"(VK_KHR_video_queue)": [
|
|
{
|
|
"vuid": "VUID-vkCmdCopyQueryPoolResults-queryType-06901",
|
|
"text": " If the <code>queryType</code> used to create <code>queryPool</code> was <code>VK_QUERY_TYPE_RESULT_STATUS_ONLY_KHR</code>, <code>flags</code> <strong class=\"purple\">must</strong> include <code>VK_QUERY_RESULT_WITH_STATUS_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyQueryPoolResults-flags-06902",
|
|
"text": " If <code>flags</code> includes <code>VK_QUERY_RESULT_WITH_STATUS_BIT_KHR</code>, it <strong class=\"purple\">must</strong> not include <code>VK_QUERY_RESULT_WITH_AVAILABILITY_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyQueryPoolResults-queryType-06903",
|
|
"text": " If the <code>queryType</code> used to create <code>queryPool</code> was <code>VK_QUERY_TYPE_PERFORMANCE_QUERY_KHR</code>, <code>flags</code> <strong class=\"purple\">must</strong> not contain <code>VK_QUERY_RESULT_WITH_STATUS_BIT_KHR</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdWriteTimestamp2": {
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdWriteTimestamp2-stage-03929",
|
|
"text": " If the <a href=\"#features-geometryShader\"><code>geometryShader</code></a> feature is not enabled, pname:stage <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_GEOMETRY_SHADER_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteTimestamp2-stage-03930",
|
|
"text": " If the <a href=\"#features-tessellationShader\"><code>tessellationShader</code></a> feature is not enabled, pname:stage <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_TESSELLATION_CONTROL_SHADER_BIT</code> or <code>VK_PIPELINE_STAGE_2_TESSELLATION_EVALUATION_SHADER_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteTimestamp2-synchronization2-03858",
|
|
"text": " The <a href=\"#features-synchronization2\"><code>synchronization2</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteTimestamp2-stage-03859",
|
|
"text": " <code>stage</code> <strong class=\"purple\">must</strong> only include a single pipeline stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteTimestamp2-stage-03860",
|
|
"text": " <code>stage</code> <strong class=\"purple\">must</strong> only include stages valid for the queue family that was used to create the command pool that <code>commandBuffer</code> was allocated from"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteTimestamp2-queryPool-03861",
|
|
"text": " <code>queryPool</code> <strong class=\"purple\">must</strong> have been created with a <code>queryType</code> of <code>VK_QUERY_TYPE_TIMESTAMP</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteTimestamp2-queryPool-03862",
|
|
"text": " The query identified by <code>queryPool</code> and <code>query</code> <strong class=\"purple\">must</strong> be <em>unavailable</em>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteTimestamp2-timestampValidBits-03863",
|
|
"text": " The command pool’s queue family <strong class=\"purple\">must</strong> support a non-zero <code>timestampValidBits</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteTimestamp2-query-04903",
|
|
"text": " <code>query</code> <strong class=\"purple\">must</strong> be less than the number of queries in <code>queryPool</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteTimestamp2-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteTimestamp2-stage-parameter",
|
|
"text": " <code>stage</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkPipelineStageFlagBits2\">VkPipelineStageFlagBits2</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteTimestamp2-queryPool-parameter",
|
|
"text": " <code>queryPool</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkQueryPool\">VkQueryPool</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteTimestamp2-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteTimestamp2-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support transfer, graphics, compute, decode, or encode operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteTimestamp2-commonparent",
|
|
"text": " Both of <code>commandBuffer</code>, and <code>queryPool</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_EXT_conditional_rendering)": [
|
|
{
|
|
"vuid": "VUID-vkCmdWriteTimestamp2-stage-03931",
|
|
"text": " If the <a href=\"#features-conditionalRendering\"><code>conditionalRendering</code></a> feature is not enabled, pname:stage <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_CONDITIONAL_RENDERING_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_EXT_fragment_density_map)": [
|
|
{
|
|
"vuid": "VUID-vkCmdWriteTimestamp2-stage-03932",
|
|
"text": " If the <a href=\"#features-fragmentDensityMap\"><code>fragmentDensityMap</code></a> feature is not enabled, pname:stage <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_FRAGMENT_DENSITY_PROCESS_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_EXT_transform_feedback)": [
|
|
{
|
|
"vuid": "VUID-vkCmdWriteTimestamp2-stage-03933",
|
|
"text": " If the <a href=\"#features-transformFeedback\"><code>transformFeedback</code></a> feature is not enabled, pname:stage <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_TRANSFORM_FEEDBACK_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_NV_mesh_shader)": [
|
|
{
|
|
"vuid": "VUID-vkCmdWriteTimestamp2-stage-03934",
|
|
"text": " If the <a href=\"#features-meshShader\"><code>meshShader</code></a> feature is not enabled, pname:stage <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_MESH_SHADER_BIT_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteTimestamp2-stage-03935",
|
|
"text": " If the <a href=\"#features-taskShader\"><code>taskShader</code></a> feature is not enabled, pname:stage <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_TASK_SHADER_BIT_NV</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_NV_shading_rate_image)": [
|
|
{
|
|
"vuid": "VUID-vkCmdWriteTimestamp2-stage-04956",
|
|
"text": " If the <a href=\"#features-shadingRateImage\"><code>shadingRateImage</code></a> feature is not enabled, pname:stage <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_SHADING_RATE_IMAGE_BIT_NV</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_HUAWEI_subpass_shading)": [
|
|
{
|
|
"vuid": "VUID-vkCmdWriteTimestamp2-stage-04957",
|
|
"text": " If the <a href=\"#features-subpassShading\"><code>subpassShading</code></a> feature is not enabled, pname:stage <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_SUBPASS_SHADING_BIT_HUAWEI</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_HUAWEI_invocation_mask)": [
|
|
{
|
|
"vuid": "VUID-vkCmdWriteTimestamp2-stage-04995",
|
|
"text": " If the <a href=\"#features-invocationMask\"><code>invocationMask</code></a> feature is not enabled, pname:stage <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_INVOCATION_MASK_BIT_HUAWEI</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_VERSION_1_1,VK_KHR_multiview)": [
|
|
{
|
|
"vuid": "VUID-vkCmdWriteTimestamp2-None-03864",
|
|
"text": " All queries used by the command <strong class=\"purple\">must</strong> be unavailable"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteTimestamp2-query-03865",
|
|
"text": " If <code>vkCmdWriteTimestamp2</code> is called within a render pass instance, the sum of <code>query</code> and the number of bits set in the current subpass’s view mask <strong class=\"purple\">must</strong> be less than or equal to the number of queries in <code>queryPool</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdWriteTimestamp": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCmdWriteTimestamp-pipelineStage-04074",
|
|
"text": " <code>pipelineStage</code> <strong class=\"purple\">must</strong> be a <a href=\"#synchronization-pipeline-stages-supported\">valid stage</a> for the queue family that was used to create the command pool that <code>commandBuffer</code> was allocated from"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteTimestamp-pipelineStage-04075",
|
|
"text": " If the <a href=\"#features-geometryShader\"><code>geometryShader</code></a> feature is not enabled, <code>pipelineStage</code> <strong class=\"purple\">must</strong> not be <code>VK_PIPELINE_STAGE_GEOMETRY_SHADER_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteTimestamp-pipelineStage-04076",
|
|
"text": " If the <a href=\"#features-tessellationShader\"><code>tessellationShader</code></a> feature is not enabled, <code>pipelineStage</code> <strong class=\"purple\">must</strong> not be <code>VK_PIPELINE_STAGE_TESSELLATION_CONTROL_SHADER_BIT</code> or <code>VK_PIPELINE_STAGE_TESSELLATION_EVALUATION_SHADER_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteTimestamp-queryPool-01416",
|
|
"text": " <code>queryPool</code> <strong class=\"purple\">must</strong> have been created with a <code>queryType</code> of <code>VK_QUERY_TYPE_TIMESTAMP</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteTimestamp-queryPool-00828",
|
|
"text": " The query identified by <code>queryPool</code> and <code>query</code> <strong class=\"purple\">must</strong> be <em>unavailable</em>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteTimestamp-timestampValidBits-00829",
|
|
"text": " The command pool’s queue family <strong class=\"purple\">must</strong> support a non-zero <code>timestampValidBits</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteTimestamp-query-04904",
|
|
"text": " <code>query</code> <strong class=\"purple\">must</strong> be less than the number of queries in <code>queryPool</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteTimestamp-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteTimestamp-pipelineStage-parameter",
|
|
"text": " <code>pipelineStage</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPipelineStageFlagBits\">VkPipelineStageFlagBits</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteTimestamp-queryPool-parameter",
|
|
"text": " <code>queryPool</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkQueryPool\">VkQueryPool</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteTimestamp-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteTimestamp-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support transfer, graphics, compute, decode, or encode operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteTimestamp-commonparent",
|
|
"text": " Both of <code>commandBuffer</code>, and <code>queryPool</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"(VK_EXT_conditional_rendering)": [
|
|
{
|
|
"vuid": "VUID-vkCmdWriteTimestamp-pipelineStage-04077",
|
|
"text": " If the <a href=\"#features-conditionalRendering\"><code>conditionalRendering</code></a> feature is not enabled, <code>pipelineStage</code> <strong class=\"purple\">must</strong> not be <code>VK_PIPELINE_STAGE_CONDITIONAL_RENDERING_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_fragment_density_map)": [
|
|
{
|
|
"vuid": "VUID-vkCmdWriteTimestamp-pipelineStage-04078",
|
|
"text": " If the <a href=\"#features-fragmentDensityMap\"><code>fragmentDensityMap</code></a> feature is not enabled, <code>pipelineStage</code> <strong class=\"purple\">must</strong> not be <code>VK_PIPELINE_STAGE_FRAGMENT_DENSITY_PROCESS_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)": [
|
|
{
|
|
"vuid": "VUID-vkCmdWriteTimestamp-pipelineStage-04079",
|
|
"text": " If the <a href=\"#features-transformFeedback\"><code>transformFeedback</code></a> feature is not enabled, <code>pipelineStage</code> <strong class=\"purple\">must</strong> not be <code>VK_PIPELINE_STAGE_TRANSFORM_FEEDBACK_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)": [
|
|
{
|
|
"vuid": "VUID-vkCmdWriteTimestamp-pipelineStage-04080",
|
|
"text": " If the <a href=\"#features-meshShader\"><code>meshShader</code></a> feature is not enabled, <code>pipelineStage</code> <strong class=\"purple\">must</strong> not be <code>VK_PIPELINE_STAGE_MESH_SHADER_BIT_NV</code> or <code>VK_PIPELINE_STAGE_TASK_SHADER_BIT_NV</code>"
|
|
}
|
|
],
|
|
"(VK_NV_shading_rate_image)": [
|
|
{
|
|
"vuid": "VUID-vkCmdWriteTimestamp-pipelineStage-04081",
|
|
"text": " If the <a href=\"#features-shadingRateImage\"><code>shadingRateImage</code></a> feature is not enabled, <code>pipelineStage</code> <strong class=\"purple\">must</strong> not be <code>VK_PIPELINE_STAGE_SHADING_RATE_IMAGE_BIT_NV</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdWriteTimestamp-synchronization2-06489",
|
|
"text": " If the <a href=\"#features-synchronization2\"><code>synchronization2</code></a> feature is not enabled, <code>pipelineStage</code> <strong class=\"purple\">must</strong> not be <code>VK_PIPELINE_STAGE_NONE</code>"
|
|
}
|
|
],
|
|
"!(VK_VERSION_1_3,VK_KHR_synchronization2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdWriteTimestamp-pipelineStage-06490",
|
|
"text": " <code>pipelineStage</code> <strong class=\"purple\">must</strong> not be <code>VK_PIPELINE_STAGE_NONE</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_multiview)": [
|
|
{
|
|
"vuid": "VUID-vkCmdWriteTimestamp-None-00830",
|
|
"text": " All queries used by the command <strong class=\"purple\">must</strong> be unavailable"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteTimestamp-query-00831",
|
|
"text": " If <code>vkCmdWriteTimestamp</code> is called within a render pass instance, the sum of <code>query</code> and the number of bits set in the current subpass’s view mask <strong class=\"purple\">must</strong> be less than or equal to the number of queries in <code>queryPool</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkAcquireProfilingLockKHR": {
|
|
"(VK_KHR_performance_query)": [
|
|
{
|
|
"vuid": "VUID-vkAcquireProfilingLockKHR-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkAcquireProfilingLockKHR-pInfo-parameter",
|
|
"text": " <code>pInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAcquireProfilingLockInfoKHR\">VkAcquireProfilingLockInfoKHR</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkAcquireProfilingLockInfoKHR": {
|
|
"(VK_KHR_performance_query)": [
|
|
{
|
|
"vuid": "VUID-VkAcquireProfilingLockInfoKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_ACQUIRE_PROFILING_LOCK_INFO_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAcquireProfilingLockInfoKHR-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAcquireProfilingLockInfoKHR-flags-zerobitmask",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkReleaseProfilingLockKHR": {
|
|
"(VK_KHR_performance_query)": [
|
|
{
|
|
"vuid": "VUID-vkReleaseProfilingLockKHR-device-03235",
|
|
"text": " The profiling lock of <code>device</code> <strong class=\"purple\">must</strong> have been held via a previous successful call to <a href=\"#vkAcquireProfilingLockKHR\">vkAcquireProfilingLockKHR</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkReleaseProfilingLockKHR-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"vkInitializePerformanceApiINTEL": {
|
|
"(VK_INTEL_performance_query)+(VK_INTEL_performance_query)": [
|
|
{
|
|
"vuid": "VUID-vkInitializePerformanceApiINTEL-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkInitializePerformanceApiINTEL-pInitializeInfo-parameter",
|
|
"text": " <code>pInitializeInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkInitializePerformanceApiInfoINTEL\">VkInitializePerformanceApiInfoINTEL</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkInitializePerformanceApiInfoINTEL": {
|
|
"(VK_INTEL_performance_query)+(VK_INTEL_performance_query)": [
|
|
{
|
|
"vuid": "VUID-VkInitializePerformanceApiInfoINTEL-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_INITIALIZE_PERFORMANCE_API_INFO_INTEL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkInitializePerformanceApiInfoINTEL-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkUninitializePerformanceApiINTEL": {
|
|
"(VK_INTEL_performance_query)+(VK_INTEL_performance_query)": [
|
|
{
|
|
"vuid": "VUID-vkUninitializePerformanceApiINTEL-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"vkGetPerformanceParameterINTEL": {
|
|
"(VK_INTEL_performance_query)+(VK_INTEL_performance_query)": [
|
|
{
|
|
"vuid": "VUID-vkGetPerformanceParameterINTEL-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPerformanceParameterINTEL-parameter-parameter",
|
|
"text": " <code>parameter</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPerformanceParameterTypeINTEL\">VkPerformanceParameterTypeINTEL</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPerformanceParameterINTEL-pValue-parameter",
|
|
"text": " <code>pValue</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkPerformanceValueINTEL\">VkPerformanceValueINTEL</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkPerformanceValueINTEL": {
|
|
"(VK_INTEL_performance_query)+(VK_INTEL_performance_query)": [
|
|
{
|
|
"vuid": "VUID-VkPerformanceValueINTEL-type-parameter",
|
|
"text": " <code>type</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPerformanceValueTypeINTEL\">VkPerformanceValueTypeINTEL</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPerformanceValueINTEL-valueString-parameter",
|
|
"text": " If <code>type</code> is <code>VK_PERFORMANCE_VALUE_TYPE_STRING_INTEL</code>, the <code>valueString</code> member of <code>data</code> <strong class=\"purple\">must</strong> be a null-terminated UTF-8 string"
|
|
}
|
|
]
|
|
},
|
|
"VkQueryPoolPerformanceQueryCreateInfoINTEL": {
|
|
"(VK_INTEL_performance_query)+(VK_INTEL_performance_query)": [
|
|
{
|
|
"vuid": "VUID-VkQueryPoolPerformanceQueryCreateInfoINTEL-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_QUERY_POOL_PERFORMANCE_QUERY_CREATE_INFO_INTEL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkQueryPoolPerformanceQueryCreateInfoINTEL-performanceCountersSampling-parameter",
|
|
"text": " <code>performanceCountersSampling</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkQueryPoolSamplingModeINTEL\">VkQueryPoolSamplingModeINTEL</a> value"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdSetPerformanceMarkerINTEL": {
|
|
"(VK_INTEL_performance_query)+(VK_INTEL_performance_query)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetPerformanceMarkerINTEL-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetPerformanceMarkerINTEL-pMarkerInfo-parameter",
|
|
"text": " <code>pMarkerInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkPerformanceMarkerInfoINTEL\">VkPerformanceMarkerInfoINTEL</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetPerformanceMarkerINTEL-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetPerformanceMarkerINTEL-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics, compute, or transfer operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetPerformanceMarkerINTEL-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
]
|
|
},
|
|
"VkPerformanceMarkerInfoINTEL": {
|
|
"(VK_INTEL_performance_query)+(VK_INTEL_performance_query)": [
|
|
{
|
|
"vuid": "VUID-VkPerformanceMarkerInfoINTEL-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PERFORMANCE_MARKER_INFO_INTEL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPerformanceMarkerInfoINTEL-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdSetPerformanceStreamMarkerINTEL": {
|
|
"(VK_INTEL_performance_query)+(VK_INTEL_performance_query)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetPerformanceStreamMarkerINTEL-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetPerformanceStreamMarkerINTEL-pMarkerInfo-parameter",
|
|
"text": " <code>pMarkerInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkPerformanceStreamMarkerInfoINTEL\">VkPerformanceStreamMarkerInfoINTEL</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetPerformanceStreamMarkerINTEL-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetPerformanceStreamMarkerINTEL-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics, compute, or transfer operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetPerformanceStreamMarkerINTEL-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
]
|
|
},
|
|
"VkPerformanceStreamMarkerInfoINTEL": {
|
|
"(VK_INTEL_performance_query)+(VK_INTEL_performance_query)": [
|
|
{
|
|
"vuid": "VUID-VkPerformanceStreamMarkerInfoINTEL-marker-02735",
|
|
"text": " The value written by the application into <code>marker</code> <strong class=\"purple\">must</strong> only used the valid bits as reported by <a href=\"#vkGetPerformanceParameterINTEL\">vkGetPerformanceParameterINTEL</a> with the <code>VK_PERFORMANCE_PARAMETER_TYPE_STREAM_MARKER_VALID_BITS_INTEL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPerformanceStreamMarkerInfoINTEL-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PERFORMANCE_STREAM_MARKER_INFO_INTEL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPerformanceStreamMarkerInfoINTEL-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdSetPerformanceOverrideINTEL": {
|
|
"(VK_INTEL_performance_query)+(VK_INTEL_performance_query)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetPerformanceOverrideINTEL-pOverrideInfo-02736",
|
|
"text": " <code>pOverrideInfo</code> <strong class=\"purple\">must</strong> not be used with a <a href=\"#VkPerformanceOverrideTypeINTEL\">VkPerformanceOverrideTypeINTEL</a> that is not reported available by <code>vkGetPerformanceParameterINTEL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetPerformanceOverrideINTEL-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetPerformanceOverrideINTEL-pOverrideInfo-parameter",
|
|
"text": " <code>pOverrideInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkPerformanceOverrideInfoINTEL\">VkPerformanceOverrideInfoINTEL</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetPerformanceOverrideINTEL-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetPerformanceOverrideINTEL-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics, compute, or transfer operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetPerformanceOverrideINTEL-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
]
|
|
},
|
|
"VkPerformanceOverrideInfoINTEL": {
|
|
"(VK_INTEL_performance_query)+(VK_INTEL_performance_query)": [
|
|
{
|
|
"vuid": "VUID-VkPerformanceOverrideInfoINTEL-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PERFORMANCE_OVERRIDE_INFO_INTEL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPerformanceOverrideInfoINTEL-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPerformanceOverrideInfoINTEL-type-parameter",
|
|
"text": " <code>type</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPerformanceOverrideTypeINTEL\">VkPerformanceOverrideTypeINTEL</a> value"
|
|
}
|
|
]
|
|
},
|
|
"vkAcquirePerformanceConfigurationINTEL": {
|
|
"(VK_INTEL_performance_query)+(VK_INTEL_performance_query)": [
|
|
{
|
|
"vuid": "VUID-vkAcquirePerformanceConfigurationINTEL-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkAcquirePerformanceConfigurationINTEL-pAcquireInfo-parameter",
|
|
"text": " <code>pAcquireInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkPerformanceConfigurationAcquireInfoINTEL\">VkPerformanceConfigurationAcquireInfoINTEL</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkAcquirePerformanceConfigurationINTEL-pConfiguration-parameter",
|
|
"text": " <code>pConfiguration</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkPerformanceConfigurationINTEL\">VkPerformanceConfigurationINTEL</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkPerformanceConfigurationAcquireInfoINTEL": {
|
|
"(VK_INTEL_performance_query)+(VK_INTEL_performance_query)": [
|
|
{
|
|
"vuid": "VUID-VkPerformanceConfigurationAcquireInfoINTEL-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PERFORMANCE_CONFIGURATION_ACQUIRE_INFO_INTEL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPerformanceConfigurationAcquireInfoINTEL-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPerformanceConfigurationAcquireInfoINTEL-type-parameter",
|
|
"text": " <code>type</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPerformanceConfigurationTypeINTEL\">VkPerformanceConfigurationTypeINTEL</a> value"
|
|
}
|
|
]
|
|
},
|
|
"vkQueueSetPerformanceConfigurationINTEL": {
|
|
"(VK_INTEL_performance_query)+(VK_INTEL_performance_query)": [
|
|
{
|
|
"vuid": "VUID-vkQueueSetPerformanceConfigurationINTEL-queue-parameter",
|
|
"text": " <code>queue</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkQueue\">VkQueue</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkQueueSetPerformanceConfigurationINTEL-configuration-parameter",
|
|
"text": " <code>configuration</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPerformanceConfigurationINTEL\">VkPerformanceConfigurationINTEL</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkQueueSetPerformanceConfigurationINTEL-commonparent",
|
|
"text": " Both of <code>configuration</code>, and <code>queue</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
]
|
|
},
|
|
"vkReleasePerformanceConfigurationINTEL": {
|
|
"(VK_INTEL_performance_query)+(VK_INTEL_performance_query)": [
|
|
{
|
|
"vuid": "VUID-vkReleasePerformanceConfigurationINTEL-configuration-02737",
|
|
"text": " <code>configuration</code> <strong class=\"purple\">must</strong> not be released before all command buffers submitted while the configuration was set are in <a href=\"#commandbuffers-lifecycle\">pending state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkReleasePerformanceConfigurationINTEL-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkReleasePerformanceConfigurationINTEL-configuration-parameter",
|
|
"text": " If <code>configuration</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>configuration</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPerformanceConfigurationINTEL\">VkPerformanceConfigurationINTEL</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkReleasePerformanceConfigurationINTEL-configuration-parent",
|
|
"text": " If <code>configuration</code> is a valid handle, it <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkQueueFamilyQueryResultStatusProperties2KHR": {
|
|
"(VK_KHR_video_queue)": [
|
|
{
|
|
"vuid": "VUID-VkQueueFamilyQueryResultStatusProperties2KHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_QUEUE_FAMILY_QUERY_RESULT_STATUS_PROPERTIES_2_KHR</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdClearColorImage": {
|
|
"(VK_VERSION_1_1,VK_KHR_maintenance1)": [
|
|
{
|
|
"vuid": "VUID-vkCmdClearColorImage-image-01993",
|
|
"text": " The <a href=\"#resources-image-format-features\">format features</a> of <code>image</code> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_TRANSFER_DST_BIT</code>"
|
|
}
|
|
],
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCmdClearColorImage-image-00002",
|
|
"text": " <code>image</code> <strong class=\"purple\">must</strong> have been created with <code>VK_IMAGE_USAGE_TRANSFER_DST_BIT</code> usage flag"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdClearColorImage-image-00003",
|
|
"text": " If <code>image</code> is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdClearColorImage-imageLayout-00004",
|
|
"text": " <code>imageLayout</code> <strong class=\"purple\">must</strong> specify the layout of the image subresource ranges of <code>image</code> specified in <code>pRanges</code> at the time this command is executed on a <code>VkDevice</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdClearColorImage-aspectMask-02498",
|
|
"text": " The <a href=\"#VkImageSubresourceRange\">VkImageSubresourceRange</a>::<code>aspectMask</code> members of the elements of the <code>pRanges</code> array <strong class=\"purple\">must</strong> each only include <code>VK_IMAGE_ASPECT_COLOR_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdClearColorImage-baseMipLevel-01470",
|
|
"text": " The <a href=\"#VkImageSubresourceRange\">VkImageSubresourceRange</a>::<code>baseMipLevel</code> members of the elements of the <code>pRanges</code> array <strong class=\"purple\">must</strong> each be less than the <code>mipLevels</code> specified in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> when <code>image</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdClearColorImage-pRanges-01692",
|
|
"text": " For each <a href=\"#VkImageSubresourceRange\">VkImageSubresourceRange</a> element of <code>pRanges</code>, if the <code>levelCount</code> member is not <code>VK_REMAINING_MIP_LEVELS</code>, then <span class=\"eq\"><code>baseMipLevel</code> + <code>levelCount</code></span> <strong class=\"purple\">must</strong> be less than the <code>mipLevels</code> specified in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> when <code>image</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdClearColorImage-baseArrayLayer-01472",
|
|
"text": " The <a href=\"#VkImageSubresourceRange\">VkImageSubresourceRange</a>::<code>baseArrayLayer</code> members of the elements of the <code>pRanges</code> array <strong class=\"purple\">must</strong> each be less than the <code>arrayLayers</code> specified in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> when <code>image</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdClearColorImage-pRanges-01693",
|
|
"text": " For each <a href=\"#VkImageSubresourceRange\">VkImageSubresourceRange</a> element of <code>pRanges</code>, if the <code>layerCount</code> member is not <code>VK_REMAINING_ARRAY_LAYERS</code>, then <span class=\"eq\"><code>baseArrayLayer</code> + <code>layerCount</code></span> <strong class=\"purple\">must</strong> be less than the <code>arrayLayers</code> specified in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> when <code>image</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdClearColorImage-image-00007",
|
|
"text": " <code>image</code> <strong class=\"purple\">must</strong> not have a compressed or depth/stencil format"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdClearColorImage-pColor-04961",
|
|
"text": " <code>pColor</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkClearColorValue\">VkClearColorValue</a> union"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdClearColorImage-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdClearColorImage-image-parameter",
|
|
"text": " <code>image</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImage\">VkImage</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdClearColorImage-imageLayout-parameter",
|
|
"text": " <code>imageLayout</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageLayout\">VkImageLayout</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdClearColorImage-pRanges-parameter",
|
|
"text": " <code>pRanges</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>rangeCount</code> valid <a href=\"#VkImageSubresourceRange\">VkImageSubresourceRange</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdClearColorImage-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdClearColorImage-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics, or compute operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdClearColorImage-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdClearColorImage-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdClearColorImage-rangeCount-arraylength",
|
|
"text": " <code>rangeCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdClearColorImage-commonparent",
|
|
"text": " Both of <code>commandBuffer</code>, and <code>image</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-vkCmdClearColorImage-image-01545",
|
|
"text": " <code>image</code> <strong class=\"purple\">must</strong> not use any of the <a href=\"#formats-requiring-sampler-ycbcr-conversion\">formats that require a sampler {YCbCr} conversion</a>"
|
|
}
|
|
],
|
|
"!(VK_KHR_shared_presentable_image)": [
|
|
{
|
|
"vuid": "VUID-vkCmdClearColorImage-imageLayout-00005",
|
|
"text": " <code>imageLayout</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_LAYOUT_TRANSFER_DST_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_GENERAL</code>"
|
|
}
|
|
],
|
|
"(VK_KHR_shared_presentable_image)": [
|
|
{
|
|
"vuid": "VUID-vkCmdClearColorImage-imageLayout-01394",
|
|
"text": " <code>imageLayout</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_LAYOUT_TRANSFER_DST_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_GENERAL</code>, or <code>VK_IMAGE_LAYOUT_SHARED_PRESENT_KHR</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-vkCmdClearColorImage-commandBuffer-01805",
|
|
"text": " If <code>commandBuffer</code> is an unprotected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, <code>image</code> <strong class=\"purple\">must</strong> not be a protected image"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdClearColorImage-commandBuffer-01806",
|
|
"text": " If <code>commandBuffer</code> is a protected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, <strong class=\"purple\">must</strong> not be an unprotected image"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdClearDepthStencilImage": {
|
|
"(VK_VERSION_1_1,VK_KHR_maintenance1)": [
|
|
{
|
|
"vuid": "VUID-vkCmdClearDepthStencilImage-image-01994",
|
|
"text": " The <a href=\"#resources-image-format-features\">format features</a> of <code>image</code> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_TRANSFER_DST_BIT</code>"
|
|
}
|
|
],
|
|
"!(VK_VERSION_1_2,VK_EXT_separate_stencil_usage)": [
|
|
{
|
|
"vuid": "VUID-vkCmdClearDepthStencilImage-image-00009",
|
|
"text": " <code>image</code> <strong class=\"purple\">must</strong> have been created with <code>VK_IMAGE_USAGE_TRANSFER_DST_BIT</code> usage flag"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_EXT_separate_stencil_usage)": [
|
|
{
|
|
"vuid": "VUID-vkCmdClearDepthStencilImage-pRanges-02658",
|
|
"text": " If the <code>aspect</code> member of any element of <code>pRanges</code> includes <code>VK_IMAGE_ASPECT_STENCIL_BIT</code>, and <code>image</code> was created with <a href=\"#VkImageStencilUsageCreateInfo\">separate stencil usage</a>, <code>VK_IMAGE_USAGE_TRANSFER_DST_BIT</code> <strong class=\"purple\">must</strong> have been included in the <a href=\"#VkImageStencilUsageCreateInfo\">VkImageStencilUsageCreateInfo</a>::<code>stencilUsage</code> used to create <code>image</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdClearDepthStencilImage-pRanges-02659",
|
|
"text": " If the <code>aspect</code> member of any element of <code>pRanges</code> includes <code>VK_IMAGE_ASPECT_STENCIL_BIT</code>, and <code>image</code> was not created with <a href=\"#VkImageStencilUsageCreateInfo\">separate stencil usage</a>, <code>VK_IMAGE_USAGE_TRANSFER_DST_BIT</code> <strong class=\"purple\">must</strong> have been included in the <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a>::<code>usage</code> used to create <code>image</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdClearDepthStencilImage-pRanges-02660",
|
|
"text": " If the <code>aspect</code> member of any element of <code>pRanges</code> includes <code>VK_IMAGE_ASPECT_DEPTH_BIT</code>, <code>VK_IMAGE_USAGE_TRANSFER_DST_BIT</code> <strong class=\"purple\">must</strong> have been included in the <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a>::<code>usage</code> used to create <code>image</code>"
|
|
}
|
|
],
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCmdClearDepthStencilImage-image-00010",
|
|
"text": " If <code>image</code> is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdClearDepthStencilImage-imageLayout-00011",
|
|
"text": " <code>imageLayout</code> <strong class=\"purple\">must</strong> specify the layout of the image subresource ranges of <code>image</code> specified in <code>pRanges</code> at the time this command is executed on a <code>VkDevice</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdClearDepthStencilImage-imageLayout-00012",
|
|
"text": " <code>imageLayout</code> <strong class=\"purple\">must</strong> be either of <code>VK_IMAGE_LAYOUT_TRANSFER_DST_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_GENERAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdClearDepthStencilImage-aspectMask-02824",
|
|
"text": " The <a href=\"#VkImageSubresourceRange\">VkImageSubresourceRange</a>::<code>aspectMask</code> member of each element of the <code>pRanges</code> array <strong class=\"purple\">must</strong> not include bits other than <code>VK_IMAGE_ASPECT_DEPTH_BIT</code> or <code>VK_IMAGE_ASPECT_STENCIL_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdClearDepthStencilImage-image-02825",
|
|
"text": " If the <code>image</code>’s format does not have a stencil component, then the <a href=\"#VkImageSubresourceRange\">VkImageSubresourceRange</a>::<code>aspectMask</code> member of each element of the <code>pRanges</code> array <strong class=\"purple\">must</strong> not include the <code>VK_IMAGE_ASPECT_STENCIL_BIT</code> bit"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdClearDepthStencilImage-image-02826",
|
|
"text": " If the <code>image</code>’s format does not have a depth component, then the <a href=\"#VkImageSubresourceRange\">VkImageSubresourceRange</a>::<code>aspectMask</code> member of each element of the <code>pRanges</code> array <strong class=\"purple\">must</strong> not include the <code>VK_IMAGE_ASPECT_DEPTH_BIT</code> bit"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdClearDepthStencilImage-baseMipLevel-01474",
|
|
"text": " The <a href=\"#VkImageSubresourceRange\">VkImageSubresourceRange</a>::<code>baseMipLevel</code> members of the elements of the <code>pRanges</code> array <strong class=\"purple\">must</strong> each be less than the <code>mipLevels</code> specified in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> when <code>image</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdClearDepthStencilImage-pRanges-01694",
|
|
"text": " For each <a href=\"#VkImageSubresourceRange\">VkImageSubresourceRange</a> element of <code>pRanges</code>, if the <code>levelCount</code> member is not <code>VK_REMAINING_MIP_LEVELS</code>, then <span class=\"eq\"><code>baseMipLevel</code> + <code>levelCount</code></span> <strong class=\"purple\">must</strong> be less than the <code>mipLevels</code> specified in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> when <code>image</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdClearDepthStencilImage-baseArrayLayer-01476",
|
|
"text": " The <a href=\"#VkImageSubresourceRange\">VkImageSubresourceRange</a>::<code>baseArrayLayer</code> members of the elements of the <code>pRanges</code> array <strong class=\"purple\">must</strong> each be less than the <code>arrayLayers</code> specified in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> when <code>image</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdClearDepthStencilImage-pRanges-01695",
|
|
"text": " For each <a href=\"#VkImageSubresourceRange\">VkImageSubresourceRange</a> element of <code>pRanges</code>, if the <code>layerCount</code> member is not <code>VK_REMAINING_ARRAY_LAYERS</code>, then <span class=\"eq\"><code>baseArrayLayer</code> + <code>layerCount</code></span> <strong class=\"purple\">must</strong> be less than the <code>arrayLayers</code> specified in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> when <code>image</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdClearDepthStencilImage-image-00014",
|
|
"text": " <code>image</code> <strong class=\"purple\">must</strong> have a depth/stencil format"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdClearDepthStencilImage-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdClearDepthStencilImage-image-parameter",
|
|
"text": " <code>image</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImage\">VkImage</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdClearDepthStencilImage-imageLayout-parameter",
|
|
"text": " <code>imageLayout</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageLayout\">VkImageLayout</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdClearDepthStencilImage-pDepthStencil-parameter",
|
|
"text": " <code>pDepthStencil</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkClearDepthStencilValue\">VkClearDepthStencilValue</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdClearDepthStencilImage-pRanges-parameter",
|
|
"text": " <code>pRanges</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>rangeCount</code> valid <a href=\"#VkImageSubresourceRange\">VkImageSubresourceRange</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdClearDepthStencilImage-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdClearDepthStencilImage-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdClearDepthStencilImage-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdClearDepthStencilImage-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdClearDepthStencilImage-rangeCount-arraylength",
|
|
"text": " <code>rangeCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdClearDepthStencilImage-commonparent",
|
|
"text": " Both of <code>commandBuffer</code>, and <code>image</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-vkCmdClearDepthStencilImage-commandBuffer-01807",
|
|
"text": " If <code>commandBuffer</code> is an unprotected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, <code>image</code> <strong class=\"purple\">must</strong> not be a protected image"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdClearDepthStencilImage-commandBuffer-01808",
|
|
"text": " If <code>commandBuffer</code> is a protected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, <code>image</code> <strong class=\"purple\">must</strong> not be an unprotected image"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdClearAttachments": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCmdClearAttachments-aspectMask-02501",
|
|
"text": " If the <code>aspectMask</code> member of any element of <code>pAttachments</code> contains <code>VK_IMAGE_ASPECT_COLOR_BIT</code>, then the <code>colorAttachment</code> member of that element <strong class=\"purple\">must</strong> either refer to a color attachment which is <code>VK_ATTACHMENT_UNUSED</code>, or <strong class=\"purple\">must</strong> be a valid color attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdClearAttachments-aspectMask-02502",
|
|
"text": " If the <code>aspectMask</code> member of any element of <code>pAttachments</code> contains <code>VK_IMAGE_ASPECT_DEPTH_BIT</code>, then the current subpass' depth/stencil attachment <strong class=\"purple\">must</strong> either be <code>VK_ATTACHMENT_UNUSED</code>, or <strong class=\"purple\">must</strong> have a depth component"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdClearAttachments-aspectMask-02503",
|
|
"text": " If the <code>aspectMask</code> member of any element of <code>pAttachments</code> contains <code>VK_IMAGE_ASPECT_STENCIL_BIT</code>, then the current subpass' depth/stencil attachment <strong class=\"purple\">must</strong> either be <code>VK_ATTACHMENT_UNUSED</code>, or <strong class=\"purple\">must</strong> have a stencil component"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdClearAttachments-rect-02682",
|
|
"text": " The <code>rect</code> member of each element of <code>pRects</code> <strong class=\"purple\">must</strong> have an <code>extent.width</code> greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdClearAttachments-rect-02683",
|
|
"text": " The <code>rect</code> member of each element of <code>pRects</code> <strong class=\"purple\">must</strong> have an <code>extent.height</code> greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdClearAttachments-pRects-00016",
|
|
"text": " The rectangular region specified by each element of <code>pRects</code> <strong class=\"purple\">must</strong> be contained within the render area of the current render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdClearAttachments-pRects-06937",
|
|
"text": " The layers specified by each element of <code>pRects</code> <strong class=\"purple\">must</strong> be contained within every attachment that <code>pAttachments</code> refers to, i.e. for each element of <code>pRects</code>, <a href=\"#VkClearRect\">VkClearRect</a>::<code>baseArrayLayer</code><br> <a href=\"#VkClearRect\">VkClearRect</a>::<code>layerCount</code> <strong class=\"purple\">must</strong> be less than or equal to the number of layers rendered to in the current render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdClearAttachments-layerCount-01934",
|
|
"text": " The <code>layerCount</code> member of each element of <code>pRects</code> <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdClearAttachments-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdClearAttachments-pAttachments-parameter",
|
|
"text": " <code>pAttachments</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>attachmentCount</code> valid <a href=\"#VkClearAttachment\">VkClearAttachment</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdClearAttachments-pRects-parameter",
|
|
"text": " <code>pRects</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>rectCount</code> <a href=\"#VkClearRect\">VkClearRect</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdClearAttachments-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdClearAttachments-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdClearAttachments-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called inside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdClearAttachments-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdClearAttachments-attachmentCount-arraylength",
|
|
"text": " <code>attachmentCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdClearAttachments-rectCount-arraylength",
|
|
"text": " <code>rectCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-vkCmdClearAttachments-commandBuffer-02504",
|
|
"text": " If <code>commandBuffer</code> is an unprotected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, each attachment to be cleared <strong class=\"purple\">must</strong> not be a protected image"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdClearAttachments-commandBuffer-02505",
|
|
"text": " If <code>commandBuffer</code> is a protected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, each attachment to be cleared <strong class=\"purple\">must</strong> not be an unprotected image"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_multiview)": [
|
|
{
|
|
"vuid": "VUID-vkCmdClearAttachments-baseArrayLayer-00018",
|
|
"text": " If the render pass instance this is recorded in uses multiview, then <code>baseArrayLayer</code> <strong class=\"purple\">must</strong> be zero and <code>layerCount</code> <strong class=\"purple\">must</strong> be one"
|
|
}
|
|
]
|
|
},
|
|
"VkClearAttachment": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkClearAttachment-aspectMask-00019",
|
|
"text": " If <code>aspectMask</code> includes <code>VK_IMAGE_ASPECT_COLOR_BIT</code>, it <strong class=\"purple\">must</strong> not include <code>VK_IMAGE_ASPECT_DEPTH_BIT</code> or <code>VK_IMAGE_ASPECT_STENCIL_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkClearAttachment-aspectMask-00020",
|
|
"text": " <code>aspectMask</code> <strong class=\"purple\">must</strong> not include <code>VK_IMAGE_ASPECT_METADATA_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkClearAttachment-clearValue-00021",
|
|
"text": " <code>clearValue</code> <strong class=\"purple\">must</strong> be a valid <code>VkClearValue</code> union"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkClearAttachment-aspectMask-parameter",
|
|
"text": " <code>aspectMask</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkImageAspectFlagBits\">VkImageAspectFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkClearAttachment-aspectMask-requiredbitmask",
|
|
"text": " <code>aspectMask</code> <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_image_drm_format_modifier)": [
|
|
{
|
|
"vuid": "VUID-VkClearAttachment-aspectMask-02246",
|
|
"text": " <code>aspectMask</code> <strong class=\"purple\">must</strong> not include <code>VK_IMAGE_ASPECT_MEMORY_PLANE<em>{ibit}</em>BIT_EXT</code> for any index <em>i</em>"
|
|
}
|
|
]
|
|
},
|
|
"VkClearDepthStencilValue": {
|
|
"(VK_EXT_depth_range_unrestricted)": [
|
|
{
|
|
"vuid": "VUID-VkClearDepthStencilValue-depth-00022",
|
|
"text": " Unless the <code><a href=\"#VK_EXT_depth_range_unrestricted\">VK_EXT_depth_range_unrestricted</a></code> extension is enabled <code>depth</code> <strong class=\"purple\">must</strong> be between <code>0.0</code> and <code>1.0</code>, inclusive"
|
|
}
|
|
],
|
|
"!(VK_EXT_depth_range_unrestricted)": [
|
|
{
|
|
"vuid": "VUID-VkClearDepthStencilValue-depth-02506",
|
|
"text": " <code>depth</code> <strong class=\"purple\">must</strong> be between <code>0.0</code> and <code>1.0</code>, inclusive"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdFillBuffer": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCmdFillBuffer-dstOffset-00024",
|
|
"text": " <code>dstOffset</code> <strong class=\"purple\">must</strong> be less than the size of <code>dstBuffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdFillBuffer-dstOffset-00025",
|
|
"text": " <code>dstOffset</code> <strong class=\"purple\">must</strong> be a multiple of <code>4</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdFillBuffer-size-00026",
|
|
"text": " If <code>size</code> is not equal to <code>VK_WHOLE_SIZE</code>, <code>size</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdFillBuffer-size-00027",
|
|
"text": " If <code>size</code> is not equal to <code>VK_WHOLE_SIZE</code>, <code>size</code> <strong class=\"purple\">must</strong> be less than or equal to the size of <code>dstBuffer</code> minus <code>dstOffset</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdFillBuffer-size-00028",
|
|
"text": " If <code>size</code> is not equal to <code>VK_WHOLE_SIZE</code>, <code>size</code> <strong class=\"purple\">must</strong> be a multiple of <code>4</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdFillBuffer-dstBuffer-00029",
|
|
"text": " <code>dstBuffer</code> <strong class=\"purple\">must</strong> have been created with <code>VK_BUFFER_USAGE_TRANSFER_DST_BIT</code> usage flag"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdFillBuffer-dstBuffer-00031",
|
|
"text": " If <code>dstBuffer</code> is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdFillBuffer-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdFillBuffer-dstBuffer-parameter",
|
|
"text": " <code>dstBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBuffer\">VkBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdFillBuffer-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdFillBuffer-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support transfer, graphics or compute operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdFillBuffer-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdFillBuffer-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdFillBuffer-commonparent",
|
|
"text": " Both of <code>commandBuffer</code>, and <code>dstBuffer</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"!(VK_VERSION_1_1,VK_KHR_maintenance1)": [
|
|
{
|
|
"vuid": "VUID-vkCmdFillBuffer-commandBuffer-00030",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics or compute operations"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-vkCmdFillBuffer-commandBuffer-01811",
|
|
"text": " If <code>commandBuffer</code> is an unprotected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, <code>dstBuffer</code> <strong class=\"purple\">must</strong> not be a protected buffer"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdFillBuffer-commandBuffer-01812",
|
|
"text": " If <code>commandBuffer</code> is a protected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, <code>dstBuffer</code> <strong class=\"purple\">must</strong> not be an unprotected buffer"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdUpdateBuffer": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCmdUpdateBuffer-dstOffset-00032",
|
|
"text": " <code>dstOffset</code> <strong class=\"purple\">must</strong> be less than the size of <code>dstBuffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdUpdateBuffer-dataSize-00033",
|
|
"text": " <code>dataSize</code> <strong class=\"purple\">must</strong> be less than or equal to the size of <code>dstBuffer</code> minus <code>dstOffset</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdUpdateBuffer-dstBuffer-00034",
|
|
"text": " <code>dstBuffer</code> <strong class=\"purple\">must</strong> have been created with <code>VK_BUFFER_USAGE_TRANSFER_DST_BIT</code> usage flag"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdUpdateBuffer-dstBuffer-00035",
|
|
"text": " If <code>dstBuffer</code> is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdUpdateBuffer-dstOffset-00036",
|
|
"text": " <code>dstOffset</code> <strong class=\"purple\">must</strong> be a multiple of <code>4</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdUpdateBuffer-dataSize-00037",
|
|
"text": " <code>dataSize</code> <strong class=\"purple\">must</strong> be less than or equal to <code>65536</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdUpdateBuffer-dataSize-00038",
|
|
"text": " <code>dataSize</code> <strong class=\"purple\">must</strong> be a multiple of <code>4</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdUpdateBuffer-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdUpdateBuffer-dstBuffer-parameter",
|
|
"text": " <code>dstBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBuffer\">VkBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdUpdateBuffer-pData-parameter",
|
|
"text": " <code>pData</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>dataSize</code> bytes"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdUpdateBuffer-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdUpdateBuffer-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support transfer, graphics, or compute operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdUpdateBuffer-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdUpdateBuffer-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdUpdateBuffer-dataSize-arraylength",
|
|
"text": " <code>dataSize</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdUpdateBuffer-commonparent",
|
|
"text": " Both of <code>commandBuffer</code>, and <code>dstBuffer</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-vkCmdUpdateBuffer-commandBuffer-01813",
|
|
"text": " If <code>commandBuffer</code> is an unprotected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, <code>dstBuffer</code> <strong class=\"purple\">must</strong> not be a protected buffer"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdUpdateBuffer-commandBuffer-01814",
|
|
"text": " If <code>commandBuffer</code> is a protected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, <code>dstBuffer</code> <strong class=\"purple\">must</strong> not be an unprotected buffer"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdCopyBuffer": {
|
|
"(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBuffer-commandBuffer-01822",
|
|
"text": " If <code>commandBuffer</code> is an unprotected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, <code>srcBuffer</code> <strong class=\"purple\">must</strong> not be a protected buffer"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBuffer-commandBuffer-01823",
|
|
"text": " If <code>commandBuffer</code> is an unprotected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, <code>dstBuffer</code> <strong class=\"purple\">must</strong> not be a protected buffer"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBuffer-commandBuffer-01824",
|
|
"text": " If <code>commandBuffer</code> is a protected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, <code>dstBuffer</code> <strong class=\"purple\">must</strong> not be an unprotected buffer"
|
|
}
|
|
],
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBuffer-srcOffset-00113",
|
|
"text": " The <code>srcOffset</code> member of each element of <code>pRegions</code> <strong class=\"purple\">must</strong> be less than the size of <code>srcBuffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBuffer-dstOffset-00114",
|
|
"text": " The <code>dstOffset</code> member of each element of <code>pRegions</code> <strong class=\"purple\">must</strong> be less than the size of <code>dstBuffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBuffer-size-00115",
|
|
"text": " The <code>size</code> member of each element of <code>pRegions</code> <strong class=\"purple\">must</strong> be less than or equal to the size of <code>srcBuffer</code> minus <code>srcOffset</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBuffer-size-00116",
|
|
"text": " The <code>size</code> member of each element of <code>pRegions</code> <strong class=\"purple\">must</strong> be less than or equal to the size of <code>dstBuffer</code> minus <code>dstOffset</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBuffer-pRegions-00117",
|
|
"text": " The union of the source regions, and the union of the destination regions, specified by the elements of <code>pRegions</code>, <strong class=\"purple\">must</strong> not overlap in memory"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBuffer-srcBuffer-00118",
|
|
"text": " <code>srcBuffer</code> <strong class=\"purple\">must</strong> have been created with <code>VK_BUFFER_USAGE_TRANSFER_SRC_BIT</code> usage flag"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBuffer-srcBuffer-00119",
|
|
"text": " If <code>srcBuffer</code> is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBuffer-dstBuffer-00120",
|
|
"text": " <code>dstBuffer</code> <strong class=\"purple\">must</strong> have been created with <code>VK_BUFFER_USAGE_TRANSFER_DST_BIT</code> usage flag"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBuffer-dstBuffer-00121",
|
|
"text": " If <code>dstBuffer</code> is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBuffer-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBuffer-srcBuffer-parameter",
|
|
"text": " <code>srcBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBuffer\">VkBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBuffer-dstBuffer-parameter",
|
|
"text": " <code>dstBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBuffer\">VkBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBuffer-pRegions-parameter",
|
|
"text": " <code>pRegions</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>regionCount</code> valid <a href=\"#VkBufferCopy\">VkBufferCopy</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBuffer-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBuffer-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support transfer, graphics, or compute operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBuffer-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBuffer-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBuffer-regionCount-arraylength",
|
|
"text": " <code>regionCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBuffer-commonparent",
|
|
"text": " Each of <code>commandBuffer</code>, <code>dstBuffer</code>, and <code>srcBuffer</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
]
|
|
},
|
|
"VkBufferCopy": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkBufferCopy-size-01988",
|
|
"text": " The <code>size</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdCopyBuffer2": {
|
|
"(VK_VERSION_1_3,VK_KHR_copy_commands2)+(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBuffer2-commandBuffer-01822",
|
|
"text": " If <code>commandBuffer</code> is an unprotected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, <code>srcBuffer</code> <strong class=\"purple\">must</strong> not be a protected buffer"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBuffer2-commandBuffer-01823",
|
|
"text": " If <code>commandBuffer</code> is an unprotected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, <code>dstBuffer</code> <strong class=\"purple\">must</strong> not be a protected buffer"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBuffer2-commandBuffer-01824",
|
|
"text": " If <code>commandBuffer</code> is a protected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, <code>dstBuffer</code> <strong class=\"purple\">must</strong> not be an unprotected buffer"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_copy_commands2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBuffer2-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBuffer2-pCopyBufferInfo-parameter",
|
|
"text": " <code>pCopyBufferInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkCopyBufferInfo2\">VkCopyBufferInfo2</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBuffer2-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBuffer2-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support transfer, graphics, or compute operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBuffer2-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBuffer2-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
]
|
|
},
|
|
"VkCopyBufferInfo2": {
|
|
"(VK_VERSION_1_3,VK_KHR_copy_commands2)": [
|
|
{
|
|
"vuid": "VUID-VkCopyBufferInfo2-srcOffset-00113",
|
|
"text": " The <code>srcOffset</code> member of each element of <code>pRegions</code> <strong class=\"purple\">must</strong> be less than the size of <code>srcBuffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyBufferInfo2-dstOffset-00114",
|
|
"text": " The <code>dstOffset</code> member of each element of <code>pRegions</code> <strong class=\"purple\">must</strong> be less than the size of <code>dstBuffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyBufferInfo2-size-00115",
|
|
"text": " The <code>size</code> member of each element of <code>pRegions</code> <strong class=\"purple\">must</strong> be less than or equal to the size of <code>srcBuffer</code> minus <code>srcOffset</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyBufferInfo2-size-00116",
|
|
"text": " The <code>size</code> member of each element of <code>pRegions</code> <strong class=\"purple\">must</strong> be less than or equal to the size of <code>dstBuffer</code> minus <code>dstOffset</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyBufferInfo2-pRegions-00117",
|
|
"text": " The union of the source regions, and the union of the destination regions, specified by the elements of <code>pRegions</code>, <strong class=\"purple\">must</strong> not overlap in memory"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyBufferInfo2-srcBuffer-00118",
|
|
"text": " <code>srcBuffer</code> <strong class=\"purple\">must</strong> have been created with <code>VK_BUFFER_USAGE_TRANSFER_SRC_BIT</code> usage flag"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyBufferInfo2-srcBuffer-00119",
|
|
"text": " If <code>srcBuffer</code> is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyBufferInfo2-dstBuffer-00120",
|
|
"text": " <code>dstBuffer</code> <strong class=\"purple\">must</strong> have been created with <code>VK_BUFFER_USAGE_TRANSFER_DST_BIT</code> usage flag"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyBufferInfo2-dstBuffer-00121",
|
|
"text": " If <code>dstBuffer</code> is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyBufferInfo2-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_COPY_BUFFER_INFO_2</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyBufferInfo2-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyBufferInfo2-srcBuffer-parameter",
|
|
"text": " <code>srcBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBuffer\">VkBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyBufferInfo2-dstBuffer-parameter",
|
|
"text": " <code>dstBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBuffer\">VkBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyBufferInfo2-pRegions-parameter",
|
|
"text": " <code>pRegions</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>regionCount</code> valid <a href=\"#VkBufferCopy2\">VkBufferCopy2</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyBufferInfo2-regionCount-arraylength",
|
|
"text": " <code>regionCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyBufferInfo2-commonparent",
|
|
"text": " Both of <code>dstBuffer</code>, and <code>srcBuffer</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
]
|
|
},
|
|
"VkBufferCopy2": {
|
|
"(VK_VERSION_1_3,VK_KHR_copy_commands2)": [
|
|
{
|
|
"vuid": "VUID-VkBufferCopy2-size-01988",
|
|
"text": " The <code>size</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferCopy2-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_BUFFER_COPY_2</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferCopy2-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdCopyImage": {
|
|
"(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-commandBuffer-01825",
|
|
"text": " If <code>commandBuffer</code> is an unprotected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, <code>srcImage</code> <strong class=\"purple\">must</strong> not be a protected image"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-commandBuffer-01826",
|
|
"text": " If <code>commandBuffer</code> is an unprotected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, <code>dstImage</code> <strong class=\"purple\">must</strong> not be a protected image"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-commandBuffer-01827",
|
|
"text": " If <code>commandBuffer</code> is a protected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, <code>dstImage</code> <strong class=\"purple\">must</strong> not be an unprotected image"
|
|
}
|
|
],
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-pRegions-00124",
|
|
"text": " The union of all source regions, and the union of all destination regions, specified by the elements of <code>pRegions</code>, <strong class=\"purple\">must</strong> not overlap in memory"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-srcImageLayout-00128",
|
|
"text": " <code>srcImageLayout</code> <strong class=\"purple\">must</strong> specify the layout of the image subresources of <code>srcImage</code> specified in <code>pRegions</code> at the time this command is executed on a <code>VkDevice</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-dstImageLayout-00133",
|
|
"text": " <code>dstImageLayout</code> <strong class=\"purple\">must</strong> specify the layout of the image subresources of <code>dstImage</code> specified in <code>pRegions</code> at the time this command is executed on a <code>VkDevice</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-srcImage-00136",
|
|
"text": " The sample count of <code>srcImage</code> and <code>dstImage</code> <strong class=\"purple\">must</strong> match"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-srcSubresource-01696",
|
|
"text": " The <code>srcSubresource.mipLevel</code> member of each element of <code>pRegions</code> <strong class=\"purple\">must</strong> be less than the <code>mipLevels</code> specified in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> when <code>srcImage</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-dstSubresource-01697",
|
|
"text": " The <code>dstSubresource.mipLevel</code> member of each element of <code>pRegions</code> <strong class=\"purple\">must</strong> be less than the <code>mipLevels</code> specified in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> when <code>dstImage</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-srcSubresource-01698",
|
|
"text": " The <span class=\"eq\"><code>srcSubresource.baseArrayLayer</code> + <code>srcSubresource.layerCount</code></span> of each element of <code>pRegions</code> <strong class=\"purple\">must</strong> be less than or equal to the <code>arrayLayers</code> specified in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> when <code>srcImage</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-dstSubresource-01699",
|
|
"text": " The <span class=\"eq\"><code>dstSubresource.baseArrayLayer</code> + <code>dstSubresource.layerCount</code></span> of each element of <code>pRegions</code> <strong class=\"purple\">must</strong> be less than or equal to the <code>arrayLayers</code> specified in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> when <code>dstImage</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-srcOffset-01783",
|
|
"text": " The <code>srcOffset</code> and <code>extent</code> members of each element of <code>pRegions</code> <strong class=\"purple\">must</strong> respect the image transfer granularity requirements of <code>commandBuffer</code>’s command pool’s queue family, as described in <a href=\"#VkQueueFamilyProperties\">VkQueueFamilyProperties</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-dstOffset-01784",
|
|
"text": " The <code>dstOffset</code> and <code>extent</code> members of each element of <code>pRegions</code> <strong class=\"purple\">must</strong> respect the image transfer granularity requirements of <code>commandBuffer</code>’s command pool’s queue family, as described in <a href=\"#VkQueueFamilyProperties\">VkQueueFamilyProperties</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-aspectMask-00142",
|
|
"text": " For each element of <code>pRegions</code>, <code>srcSubresource.aspectMask</code> <strong class=\"purple\">must</strong> specify aspects present in <code>srcImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-aspectMask-00143",
|
|
"text": " For each element of <code>pRegions</code>, <code>dstSubresource.aspectMask</code> <strong class=\"purple\">must</strong> specify aspects present in <code>dstImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-srcOffset-00144",
|
|
"text": " For each element of <code>pRegions</code>, <code>srcOffset.x</code> and <span class=\"eq\">(<code>extent.width</code> + <code>srcOffset.x</code>)</span> <strong class=\"purple\">must</strong> both be greater than or equal to <code>0</code> and less than or equal to the width of the specified <code>srcSubresource</code> of <code>srcImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-srcOffset-00145",
|
|
"text": " For each element of <code>pRegions</code>, <code>srcOffset.y</code> and <span class=\"eq\">(<code>extent.height</code> + <code>srcOffset.y</code>)</span> <strong class=\"purple\">must</strong> both be greater than or equal to <code>0</code> and less than or equal to the height of the specified <code>srcSubresource</code> of <code>srcImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-srcImage-00146",
|
|
"text": " If <code>srcImage</code> is of type <code>VK_IMAGE_TYPE_1D</code>, then for each element of <code>pRegions</code>, <code>srcOffset.y</code> <strong class=\"purple\">must</strong> be <code>0</code> and <code>extent.height</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-srcOffset-00147",
|
|
"text": " If <code>srcImage</code> is of type <code>VK_IMAGE_TYPE_3D</code>, then for each element of <code>pRegions</code>, <code>srcOffset.z</code> and <span class=\"eq\">(<code>extent.depth</code> + <code>srcOffset.z</code>)</span> <strong class=\"purple\">must</strong> both be greater than or equal to <code>0</code> and less than or equal to the depth of the specified <code>srcSubresource</code> of <code>srcImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-srcImage-01785",
|
|
"text": " If <code>srcImage</code> is of type <code>VK_IMAGE_TYPE_1D</code>, then for each element of <code>pRegions</code>, <code>srcOffset.z</code> <strong class=\"purple\">must</strong> be <code>0</code> and <code>extent.depth</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-dstImage-01786",
|
|
"text": " If <code>dstImage</code> is of type <code>VK_IMAGE_TYPE_1D</code>, then for each element of <code>pRegions</code>, <code>dstOffset.z</code> <strong class=\"purple\">must</strong> be <code>0</code> and <code>extent.depth</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-srcImage-01787",
|
|
"text": " If <code>srcImage</code> is of type <code>VK_IMAGE_TYPE_2D</code>, then for each element of <code>pRegions</code>, <code>srcOffset.z</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-dstImage-01788",
|
|
"text": " If <code>dstImage</code> is of type <code>VK_IMAGE_TYPE_2D</code>, then for each element of <code>pRegions</code>, <code>dstOffset.z</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-dstOffset-00150",
|
|
"text": " For each element of <code>pRegions</code>, <code>dstOffset.x</code> and <span class=\"eq\">(<code>extent.width</code> + <code>dstOffset.x</code>)</span> <strong class=\"purple\">must</strong> both be greater than or equal to <code>0</code> and less than or equal to the width of the specified <code>dstSubresource</code> of <code>dstImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-dstOffset-00151",
|
|
"text": " For each element of <code>pRegions</code>, <code>dstOffset.y</code> and <span class=\"eq\">(<code>extent.height</code> + <code>dstOffset.y</code>)</span> <strong class=\"purple\">must</strong> both be greater than or equal to <code>0</code> and less than or equal to the height of the specified <code>dstSubresource</code> of <code>dstImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-dstImage-00152",
|
|
"text": " If <code>dstImage</code> is of type <code>VK_IMAGE_TYPE_1D</code>, then for each element of <code>pRegions</code>, <code>dstOffset.y</code> <strong class=\"purple\">must</strong> be <code>0</code> and <code>extent.height</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-dstOffset-00153",
|
|
"text": " If <code>dstImage</code> is of type <code>VK_IMAGE_TYPE_3D</code>, then for each element of <code>pRegions</code>, <code>dstOffset.z</code> and <span class=\"eq\">(<code>extent.depth</code> + <code>dstOffset.z</code>)</span> <strong class=\"purple\">must</strong> both be greater than or equal to <code>0</code> and less than or equal to the depth of the specified <code>dstSubresource</code> of <code>dstImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-srcImage-01727",
|
|
"text": " If <code>srcImage</code> is a <a href=\"#blocked-image\">blocked image</a>, then for each element of <code>pRegions</code>, all members of <code>srcOffset</code> <strong class=\"purple\">must</strong> be a multiple of the corresponding dimensions of the compressed texel block"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-srcImage-01728",
|
|
"text": " If <code>srcImage</code> is a <a href=\"#blocked-image\">blocked image</a>, then for each element of <code>pRegions</code>, <code>extent.width</code> <strong class=\"purple\">must</strong> be a multiple of the compressed texel block width or <span class=\"eq\">(<code>extent.width</code> + <code>srcOffset.x</code>)</span> <strong class=\"purple\">must</strong> equal the width of the specified <code>srcSubresource</code> of <code>srcImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-srcImage-01729",
|
|
"text": " If <code>srcImage</code> is a <a href=\"#blocked-image\">blocked image</a>, then for each element of <code>pRegions</code>, <code>extent.height</code> <strong class=\"purple\">must</strong> be a multiple of the compressed texel block height or <span class=\"eq\">(<code>extent.height</code> + <code>srcOffset.y</code>)</span> <strong class=\"purple\">must</strong> equal the height of the specified <code>srcSubresource</code> of <code>srcImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-srcImage-01730",
|
|
"text": " If <code>srcImage</code> is a <a href=\"#blocked-image\">blocked image</a>, then for each element of <code>pRegions</code>, <code>extent.depth</code> <strong class=\"purple\">must</strong> be a multiple of the compressed texel block depth or <span class=\"eq\">(<code>extent.depth</code> + <code>srcOffset.z</code>)</span> <strong class=\"purple\">must</strong> equal the depth of the specified <code>srcSubresource</code> of <code>srcImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-dstImage-01731",
|
|
"text": " If <code>dstImage</code> is a <a href=\"#blocked-image\">blocked image</a>, then for each element of <code>pRegions</code>, all members of <code>dstOffset</code> <strong class=\"purple\">must</strong> be a multiple of the corresponding dimensions of the compressed texel block"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-dstImage-01732",
|
|
"text": " If <code>dstImage</code> is a <a href=\"#blocked-image\">blocked image</a>, then for each element of <code>pRegions</code>, <code>extent.width</code> <strong class=\"purple\">must</strong> be a multiple of the compressed texel block width or <span class=\"eq\">(<code>extent.width</code> + <code>dstOffset.x</code>)</span> <strong class=\"purple\">must</strong> equal the width of the specified <code>dstSubresource</code> of <code>dstImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-dstImage-01733",
|
|
"text": " If <code>dstImage</code> is a <a href=\"#blocked-image\">blocked image</a>, then for each element of <code>pRegions</code>, <code>extent.height</code> <strong class=\"purple\">must</strong> be a multiple of the compressed texel block height or <span class=\"eq\">(<code>extent.height</code> + <code>dstOffset.y</code>)</span> <strong class=\"purple\">must</strong> equal the height of the specified <code>dstSubresource</code> of <code>dstImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-dstImage-01734",
|
|
"text": " If <code>dstImage</code> is a <a href=\"#blocked-image\">blocked image</a>, then for each element of <code>pRegions</code>, <code>extent.depth</code> <strong class=\"purple\">must</strong> be a multiple of the compressed texel block depth or <span class=\"eq\">(<code>extent.depth</code> + <code>dstOffset.z</code>)</span> <strong class=\"purple\">must</strong> equal the depth of the specified <code>dstSubresource</code> of <code>dstImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-srcImage-parameter",
|
|
"text": " <code>srcImage</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImage\">VkImage</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-srcImageLayout-parameter",
|
|
"text": " <code>srcImageLayout</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageLayout\">VkImageLayout</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-dstImage-parameter",
|
|
"text": " <code>dstImage</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImage\">VkImage</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-dstImageLayout-parameter",
|
|
"text": " <code>dstImageLayout</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageLayout\">VkImageLayout</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-pRegions-parameter",
|
|
"text": " <code>pRegions</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>regionCount</code> valid <a href=\"#VkImageCopy\">VkImageCopy</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support transfer, graphics, or compute operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-regionCount-arraylength",
|
|
"text": " <code>regionCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-commonparent",
|
|
"text": " Each of <code>commandBuffer</code>, <code>dstImage</code>, and <code>srcImage</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_maintenance1)": [
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-srcImage-01995",
|
|
"text": " The <a href=\"#resources-image-format-features\">format features</a> of <code>srcImage</code> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_TRANSFER_SRC_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-dstImage-01996",
|
|
"text": " The <a href=\"#resources-image-format-features\">format features</a> of <code>dstImage</code> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_TRANSFER_DST_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-srcImage-04443",
|
|
"text": " If <code>srcImage</code> is of type <code>VK_IMAGE_TYPE_3D</code>, then for each element of <code>pRegions</code>, <code>srcSubresource.baseArrayLayer</code> <strong class=\"purple\">must</strong> be <code>0</code> and <code>srcSubresource.layerCount</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-dstImage-04444",
|
|
"text": " If <code>dstImage</code> is of type <code>VK_IMAGE_TYPE_3D</code>, then for each element of <code>pRegions</code>, <code>dstSubresource.baseArrayLayer</code> <strong class=\"purple\">must</strong> be <code>0</code> and <code>dstSubresource.layerCount</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-srcImage-01790",
|
|
"text": " If <code>srcImage</code> and <code>dstImage</code> are both of type <code>VK_IMAGE_TYPE_2D</code>, then for each element of <code>pRegions</code>, <code>extent.depth</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-srcImage-01791",
|
|
"text": " If <code>srcImage</code> is of type <code>VK_IMAGE_TYPE_2D</code>, and <code>dstImage</code> is of type <code>VK_IMAGE_TYPE_3D</code>, then for each element of <code>pRegions</code>, <code>extent.depth</code> <strong class=\"purple\">must</strong> equal <code>srcSubresource.layerCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-dstImage-01792",
|
|
"text": " If <code>dstImage</code> is of type <code>VK_IMAGE_TYPE_2D</code>, and <code>srcImage</code> is of type <code>VK_IMAGE_TYPE_3D</code>, then for each element of <code>pRegions</code>, <code>extent.depth</code> <strong class=\"purple\">must</strong> equal <code>dstSubresource.layerCount</code>"
|
|
}
|
|
],
|
|
"!(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-srcImage-00127",
|
|
"text": " If <code>srcImage</code> is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-dstImage-00132",
|
|
"text": " If <code>dstImage</code> is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-srcImage-00135",
|
|
"text": " The <a href=\"#VkFormat\">VkFormat</a> of each of <code>srcImage</code> and <code>dstImage</code> <strong class=\"purple\">must</strong> be compatible, as defined <a href=\"#copies-images-format-compatibility\">above</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-srcImage-01546",
|
|
"text": " If <code>srcImage</code> is non-sparse then the image or <em>disjoint</em> plane to be copied <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-dstImage-01547",
|
|
"text": " If <code>dstImage</code> is non-sparse then the image or <em>disjoint</em> plane that is the destination of the copy <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-srcImage-01548",
|
|
"text": " If the <a href=\"#VkFormat\">VkFormat</a> of each of <code>srcImage</code> and <code>dstImage</code> is not a <a href=\"#formats-requiring-sampler-ycbcr-conversion\"><em>multi-planar format</em></a>, the <a href=\"#VkFormat\">VkFormat</a> of each of <code>srcImage</code> and <code>dstImage</code> <strong class=\"purple\">must</strong> be compatible, as defined <a href=\"#copies-images-format-compatibility\">above</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-None-01549",
|
|
"text": " In a copy to or from a plane of a <a href=\"#formats-requiring-sampler-ycbcr-conversion\">multi-planar image</a>, the <a href=\"#VkFormat\">VkFormat</a> of the image and plane <strong class=\"purple\">must</strong> be compatible according to <a href=\"#formats-compatible-planes\">the description of compatible planes</a> for the plane being copied"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-srcImage-01551",
|
|
"text": " If neither <code>srcImage</code> nor <code>dstImage</code> has a <a href=\"#formats-requiring-sampler-ycbcr-conversion\">multi-planar image format</a> then for each element of <code>pRegions</code>, <code>srcSubresource.aspectMask</code> and <code>dstSubresource.aspectMask</code> <strong class=\"purple\">must</strong> match"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-srcImage-01552",
|
|
"text": " If <code>srcImage</code> has a <a href=\"#VkFormat\">VkFormat</a> with <a href=\"#formats-requiring-sampler-ycbcr-conversion\">two planes</a> then for each element of <code>pRegions</code>, <code>srcSubresource.aspectMask</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_ASPECT_PLANE_0_BIT</code> or <code>VK_IMAGE_ASPECT_PLANE_1_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-srcImage-01553",
|
|
"text": " If <code>srcImage</code> has a <a href=\"#VkFormat\">VkFormat</a> with <a href=\"#formats-requiring-sampler-ycbcr-conversion\">three planes</a> then for each element of <code>pRegions</code>, <code>srcSubresource.aspectMask</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_ASPECT_PLANE_0_BIT</code>, <code>VK_IMAGE_ASPECT_PLANE_1_BIT</code>, or <code>VK_IMAGE_ASPECT_PLANE_2_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-dstImage-01554",
|
|
"text": " If <code>dstImage</code> has a <a href=\"#VkFormat\">VkFormat</a> with <a href=\"#formats-requiring-sampler-ycbcr-conversion\">two planes</a> then for each element of <code>pRegions</code>, <code>dstSubresource.aspectMask</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_ASPECT_PLANE_0_BIT</code> or <code>VK_IMAGE_ASPECT_PLANE_1_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-dstImage-01555",
|
|
"text": " If <code>dstImage</code> has a <a href=\"#VkFormat\">VkFormat</a> with <a href=\"#formats-requiring-sampler-ycbcr-conversion\">three planes</a> then for each element of <code>pRegions</code>, <code>dstSubresource.aspectMask</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_ASPECT_PLANE_0_BIT</code>, <code>VK_IMAGE_ASPECT_PLANE_1_BIT</code>, or <code>VK_IMAGE_ASPECT_PLANE_2_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-srcImage-01556",
|
|
"text": " If <code>srcImage</code> has a <a href=\"#formats-requiring-sampler-ycbcr-conversion\">multi-planar image format</a> and the <code>dstImage</code> does not have a multi-planar image format, then for each element of <code>pRegions</code>, <code>dstSubresource.aspectMask</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_ASPECT_COLOR_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-dstImage-01557",
|
|
"text": " If <code>dstImage</code> has a <a href=\"#formats-requiring-sampler-ycbcr-conversion\">multi-planar image format</a> and the <code>srcImage</code> does not have a multi-planar image format, then for each element of <code>pRegions</code>, <code>srcSubresource.aspectMask</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_ASPECT_COLOR_BIT</code>"
|
|
}
|
|
],
|
|
"!(VK_KHR_shared_presentable_image)": [
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-srcImageLayout-00129",
|
|
"text": " <code>srcImageLayout</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_LAYOUT_TRANSFER_SRC_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_GENERAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-dstImageLayout-00134",
|
|
"text": " <code>dstImageLayout</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_LAYOUT_TRANSFER_DST_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_GENERAL</code>"
|
|
}
|
|
],
|
|
"(VK_KHR_shared_presentable_image)": [
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-srcImageLayout-01917",
|
|
"text": " <code>srcImageLayout</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_LAYOUT_TRANSFER_SRC_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_GENERAL</code>, or <code>VK_IMAGE_LAYOUT_SHARED_PRESENT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-dstImageLayout-01395",
|
|
"text": " <code>dstImageLayout</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_LAYOUT_TRANSFER_DST_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_GENERAL</code>, or <code>VK_IMAGE_LAYOUT_SHARED_PRESENT_KHR</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_fragment_density_map)": [
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-dstImage-02542",
|
|
"text": " <code>dstImage</code> and <code>srcImage</code> <strong class=\"purple\">must</strong> not have been created with <code>flags</code> containing <code>VK_IMAGE_CREATE_SUBSAMPLED_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"!(VK_VERSION_1_1,VK_KHR_maintenance1)": [
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-srcImage-00139",
|
|
"text": " If either <code>srcImage</code> or <code>dstImage</code> is of type <code>VK_IMAGE_TYPE_3D</code>, then for each element of <code>pRegions</code>, <code>srcSubresource.baseArrayLayer</code> and <code>dstSubresource.baseArrayLayer</code> <strong class=\"purple\">must</strong> each be <code>0</code>, and <code>srcSubresource.layerCount</code> and <code>dstSubresource.layerCount</code> <strong class=\"purple\">must</strong> each be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-srcImage-01789",
|
|
"text": " If <code>srcImage</code> or <code>dstImage</code> is of type <code>VK_IMAGE_TYPE_2D</code>, then for each element of <code>pRegions</code>, <code>extent.depth</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
}
|
|
],
|
|
"!(VK_VERSION_1_2,VK_EXT_separate_stencil_usage)": [
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-srcImage-00126",
|
|
"text": " <code>srcImage</code> <strong class=\"purple\">must</strong> have been created with <code>VK_IMAGE_USAGE_TRANSFER_SRC_BIT</code> usage flag"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-dstImage-00131",
|
|
"text": " <code>dstImage</code> <strong class=\"purple\">must</strong> have been created with <code>VK_IMAGE_USAGE_TRANSFER_DST_BIT</code> usage flag"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_EXT_separate_stencil_usage)": [
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-aspect-06662",
|
|
"text": " If the <code>aspect</code> member of any element of <code>pRegions</code> includes any flag other than <code>VK_IMAGE_ASPECT_STENCIL_BIT</code> or <code>srcImage</code> was not created with <a href=\"#VkImageStencilUsageCreateInfo\">separate stencil usage</a>, <code>VK_IMAGE_USAGE_TRANSFER_SRC_BIT</code> <strong class=\"purple\">must</strong> have been included in the <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a>::<code>usage</code> used to create <code>srcImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-aspect-06663",
|
|
"text": " If the <code>aspect</code> member of any element of <code>pRegions</code> includes any flag other than <code>VK_IMAGE_ASPECT_STENCIL_BIT</code> or <code>dstImage</code> was not created with <a href=\"#VkImageStencilUsageCreateInfo\">separate stencil usage</a>, <code>VK_IMAGE_USAGE_TRANSFER_DST_BIT</code> <strong class=\"purple\">must</strong> have been included in the <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a>::<code>usage</code> used to create <code>dstImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-aspect-06664",
|
|
"text": " If the <code>aspect</code> member of any element of <code>pRegions</code> includes <code>VK_IMAGE_ASPECT_STENCIL_BIT</code>, and <code>srcImage</code> was created with <a href=\"#VkImageStencilUsageCreateInfo\">separate stencil usage</a>, <code>VK_IMAGE_USAGE_TRANSFER_SRC_BIT</code> <strong class=\"purple\">must</strong> have been included in the <a href=\"#VkImageStencilUsageCreateInfo\">VkImageStencilUsageCreateInfo</a>::<code>stencilUsage</code> used to create <code>srcImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage-aspect-06665",
|
|
"text": " If the <code>aspect</code> member of any element of <code>pRegions</code> includes <code>VK_IMAGE_ASPECT_STENCIL_BIT</code>, and <code>dstImage</code> was created with <a href=\"#VkImageStencilUsageCreateInfo\">separate stencil usage</a>, <code>VK_IMAGE_USAGE_TRANSFER_DST_BIT</code> <strong class=\"purple\">must</strong> have been included in the <a href=\"#VkImageStencilUsageCreateInfo\">VkImageStencilUsageCreateInfo</a>::<code>stencilUsage</code> used to create <code>dstImage</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkImageCopy": {
|
|
"!(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-VkImageCopy-aspectMask-00137",
|
|
"text": " The <code>aspectMask</code> member of <code>srcSubresource</code> and <code>dstSubresource</code> <strong class=\"purple\">must</strong> match"
|
|
}
|
|
],
|
|
"!(VK_VERSION_1_1,VK_KHR_maintenance1)": [
|
|
{
|
|
"vuid": "VUID-VkImageCopy-layerCount-00138",
|
|
"text": " The <code>layerCount</code> member of <code>srcSubresource</code> and <code>dstSubresource</code> <strong class=\"purple\">must</strong> match"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_maintenance1)": [
|
|
{
|
|
"vuid": "VUID-VkImageCopy-extent-00140",
|
|
"text": " The number of slices of the <code>extent</code> (for 3D) or layers of the <code>srcSubresource</code> (for non-3D) <strong class=\"purple\">must</strong> match the number of slices of the <code>extent</code> (for 3D) or layers of the <code>dstSubresource</code> (for non-3D)"
|
|
}
|
|
],
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkImageCopy-extent-06668",
|
|
"text": " <code>extent.width</code> <strong class=\"purple\">must</strong> not be 0"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCopy-extent-06669",
|
|
"text": " <code>extent.height</code> <strong class=\"purple\">must</strong> not be 0"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCopy-extent-06670",
|
|
"text": " <code>extent.depth</code> <strong class=\"purple\">must</strong> not be 0"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCopy-srcSubresource-parameter",
|
|
"text": " <code>srcSubresource</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageSubresourceLayers\">VkImageSubresourceLayers</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCopy-dstSubresource-parameter",
|
|
"text": " <code>dstSubresource</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageSubresourceLayers\">VkImageSubresourceLayers</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkImageSubresourceLayers": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkImageSubresourceLayers-aspectMask-00167",
|
|
"text": " If <code>aspectMask</code> contains <code>VK_IMAGE_ASPECT_COLOR_BIT</code>, it <strong class=\"purple\">must</strong> not contain either of <code>VK_IMAGE_ASPECT_DEPTH_BIT</code> or <code>VK_IMAGE_ASPECT_STENCIL_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageSubresourceLayers-aspectMask-00168",
|
|
"text": " <code>aspectMask</code> <strong class=\"purple\">must</strong> not contain <code>VK_IMAGE_ASPECT_METADATA_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageSubresourceLayers-layerCount-01700",
|
|
"text": " <code>layerCount</code> <strong class=\"purple\">must</strong> be greater than 0"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageSubresourceLayers-aspectMask-parameter",
|
|
"text": " <code>aspectMask</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkImageAspectFlagBits\">VkImageAspectFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageSubresourceLayers-aspectMask-requiredbitmask",
|
|
"text": " <code>aspectMask</code> <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_image_drm_format_modifier)": [
|
|
{
|
|
"vuid": "VUID-VkImageSubresourceLayers-aspectMask-02247",
|
|
"text": " <code>aspectMask</code> <strong class=\"purple\">must</strong> not include <code>VK_IMAGE_ASPECT_MEMORY_PLANE<em>{ibit}</em>BIT_EXT</code> for any index <em>i</em>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdCopyImage2": {
|
|
"(VK_VERSION_1_3,VK_KHR_copy_commands2)+(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage2-commandBuffer-01825",
|
|
"text": " If <code>commandBuffer</code> is an unprotected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, <code>srcImage</code> <strong class=\"purple\">must</strong> not be a protected image"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage2-commandBuffer-01826",
|
|
"text": " If <code>commandBuffer</code> is an unprotected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, <code>dstImage</code> <strong class=\"purple\">must</strong> not be a protected image"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage2-commandBuffer-01827",
|
|
"text": " If <code>commandBuffer</code> is a protected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, <code>dstImage</code> <strong class=\"purple\">must</strong> not be an unprotected image"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_copy_commands2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage2-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage2-pCopyImageInfo-parameter",
|
|
"text": " <code>pCopyImageInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkCopyImageInfo2\">VkCopyImageInfo2</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage2-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage2-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support transfer, graphics, or compute operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage2-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImage2-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
]
|
|
},
|
|
"VkCopyImageInfo2": {
|
|
"(VK_VERSION_1_3,VK_KHR_copy_commands2)": [
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-pRegions-00124",
|
|
"text": " The union of all source regions, and the union of all destination regions, specified by the elements of <code>pRegions</code>, <strong class=\"purple\">must</strong> not overlap in memory"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-srcImageLayout-00128",
|
|
"text": " <code>srcImageLayout</code> <strong class=\"purple\">must</strong> specify the layout of the image subresources of <code>srcImage</code> specified in <code>pRegions</code> at the time this command is executed on a <code>VkDevice</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-dstImageLayout-00133",
|
|
"text": " <code>dstImageLayout</code> <strong class=\"purple\">must</strong> specify the layout of the image subresources of <code>dstImage</code> specified in <code>pRegions</code> at the time this command is executed on a <code>VkDevice</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-srcImage-00136",
|
|
"text": " The sample count of <code>srcImage</code> and <code>dstImage</code> <strong class=\"purple\">must</strong> match"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-srcSubresource-01696",
|
|
"text": " The <code>srcSubresource.mipLevel</code> member of each element of <code>pRegions</code> <strong class=\"purple\">must</strong> be less than the <code>mipLevels</code> specified in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> when <code>srcImage</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-dstSubresource-01697",
|
|
"text": " The <code>dstSubresource.mipLevel</code> member of each element of <code>pRegions</code> <strong class=\"purple\">must</strong> be less than the <code>mipLevels</code> specified in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> when <code>dstImage</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-srcSubresource-01698",
|
|
"text": " The <span class=\"eq\"><code>srcSubresource.baseArrayLayer</code> + <code>srcSubresource.layerCount</code></span> of each element of <code>pRegions</code> <strong class=\"purple\">must</strong> be less than or equal to the <code>arrayLayers</code> specified in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> when <code>srcImage</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-dstSubresource-01699",
|
|
"text": " The <span class=\"eq\"><code>dstSubresource.baseArrayLayer</code> + <code>dstSubresource.layerCount</code></span> of each element of <code>pRegions</code> <strong class=\"purple\">must</strong> be less than or equal to the <code>arrayLayers</code> specified in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> when <code>dstImage</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-srcOffset-01783",
|
|
"text": " The <code>srcOffset</code> and <code>extent</code> members of each element of <code>pRegions</code> <strong class=\"purple\">must</strong> respect the image transfer granularity requirements of <code>commandBuffer</code>’s command pool’s queue family, as described in <a href=\"#VkQueueFamilyProperties\">VkQueueFamilyProperties</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-dstOffset-01784",
|
|
"text": " The <code>dstOffset</code> and <code>extent</code> members of each element of <code>pRegions</code> <strong class=\"purple\">must</strong> respect the image transfer granularity requirements of <code>commandBuffer</code>’s command pool’s queue family, as described in <a href=\"#VkQueueFamilyProperties\">VkQueueFamilyProperties</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-aspectMask-00142",
|
|
"text": " For each element of <code>pRegions</code>, <code>srcSubresource.aspectMask</code> <strong class=\"purple\">must</strong> specify aspects present in <code>srcImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-aspectMask-00143",
|
|
"text": " For each element of <code>pRegions</code>, <code>dstSubresource.aspectMask</code> <strong class=\"purple\">must</strong> specify aspects present in <code>dstImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-srcOffset-00144",
|
|
"text": " For each element of <code>pRegions</code>, <code>srcOffset.x</code> and <span class=\"eq\">(<code>extent.width</code> + <code>srcOffset.x</code>)</span> <strong class=\"purple\">must</strong> both be greater than or equal to <code>0</code> and less than or equal to the width of the specified <code>srcSubresource</code> of <code>srcImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-srcOffset-00145",
|
|
"text": " For each element of <code>pRegions</code>, <code>srcOffset.y</code> and <span class=\"eq\">(<code>extent.height</code> + <code>srcOffset.y</code>)</span> <strong class=\"purple\">must</strong> both be greater than or equal to <code>0</code> and less than or equal to the height of the specified <code>srcSubresource</code> of <code>srcImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-srcImage-00146",
|
|
"text": " If <code>srcImage</code> is of type <code>VK_IMAGE_TYPE_1D</code>, then for each element of <code>pRegions</code>, <code>srcOffset.y</code> <strong class=\"purple\">must</strong> be <code>0</code> and <code>extent.height</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-srcOffset-00147",
|
|
"text": " If <code>srcImage</code> is of type <code>VK_IMAGE_TYPE_3D</code>, then for each element of <code>pRegions</code>, <code>srcOffset.z</code> and <span class=\"eq\">(<code>extent.depth</code> + <code>srcOffset.z</code>)</span> <strong class=\"purple\">must</strong> both be greater than or equal to <code>0</code> and less than or equal to the depth of the specified <code>srcSubresource</code> of <code>srcImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-srcImage-01785",
|
|
"text": " If <code>srcImage</code> is of type <code>VK_IMAGE_TYPE_1D</code>, then for each element of <code>pRegions</code>, <code>srcOffset.z</code> <strong class=\"purple\">must</strong> be <code>0</code> and <code>extent.depth</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-dstImage-01786",
|
|
"text": " If <code>dstImage</code> is of type <code>VK_IMAGE_TYPE_1D</code>, then for each element of <code>pRegions</code>, <code>dstOffset.z</code> <strong class=\"purple\">must</strong> be <code>0</code> and <code>extent.depth</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-srcImage-01787",
|
|
"text": " If <code>srcImage</code> is of type <code>VK_IMAGE_TYPE_2D</code>, then for each element of <code>pRegions</code>, <code>srcOffset.z</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-dstImage-01788",
|
|
"text": " If <code>dstImage</code> is of type <code>VK_IMAGE_TYPE_2D</code>, then for each element of <code>pRegions</code>, <code>dstOffset.z</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-dstOffset-00150",
|
|
"text": " For each element of <code>pRegions</code>, <code>dstOffset.x</code> and <span class=\"eq\">(<code>extent.width</code> + <code>dstOffset.x</code>)</span> <strong class=\"purple\">must</strong> both be greater than or equal to <code>0</code> and less than or equal to the width of the specified <code>dstSubresource</code> of <code>dstImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-dstOffset-00151",
|
|
"text": " For each element of <code>pRegions</code>, <code>dstOffset.y</code> and <span class=\"eq\">(<code>extent.height</code> + <code>dstOffset.y</code>)</span> <strong class=\"purple\">must</strong> both be greater than or equal to <code>0</code> and less than or equal to the height of the specified <code>dstSubresource</code> of <code>dstImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-dstImage-00152",
|
|
"text": " If <code>dstImage</code> is of type <code>VK_IMAGE_TYPE_1D</code>, then for each element of <code>pRegions</code>, <code>dstOffset.y</code> <strong class=\"purple\">must</strong> be <code>0</code> and <code>extent.height</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-dstOffset-00153",
|
|
"text": " If <code>dstImage</code> is of type <code>VK_IMAGE_TYPE_3D</code>, then for each element of <code>pRegions</code>, <code>dstOffset.z</code> and <span class=\"eq\">(<code>extent.depth</code> + <code>dstOffset.z</code>)</span> <strong class=\"purple\">must</strong> both be greater than or equal to <code>0</code> and less than or equal to the depth of the specified <code>dstSubresource</code> of <code>dstImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-srcImage-01727",
|
|
"text": " If <code>srcImage</code> is a <a href=\"#blocked-image\">blocked image</a>, then for each element of <code>pRegions</code>, all members of <code>srcOffset</code> <strong class=\"purple\">must</strong> be a multiple of the corresponding dimensions of the compressed texel block"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-srcImage-01728",
|
|
"text": " If <code>srcImage</code> is a <a href=\"#blocked-image\">blocked image</a>, then for each element of <code>pRegions</code>, <code>extent.width</code> <strong class=\"purple\">must</strong> be a multiple of the compressed texel block width or <span class=\"eq\">(<code>extent.width</code> + <code>srcOffset.x</code>)</span> <strong class=\"purple\">must</strong> equal the width of the specified <code>srcSubresource</code> of <code>srcImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-srcImage-01729",
|
|
"text": " If <code>srcImage</code> is a <a href=\"#blocked-image\">blocked image</a>, then for each element of <code>pRegions</code>, <code>extent.height</code> <strong class=\"purple\">must</strong> be a multiple of the compressed texel block height or <span class=\"eq\">(<code>extent.height</code> + <code>srcOffset.y</code>)</span> <strong class=\"purple\">must</strong> equal the height of the specified <code>srcSubresource</code> of <code>srcImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-srcImage-01730",
|
|
"text": " If <code>srcImage</code> is a <a href=\"#blocked-image\">blocked image</a>, then for each element of <code>pRegions</code>, <code>extent.depth</code> <strong class=\"purple\">must</strong> be a multiple of the compressed texel block depth or <span class=\"eq\">(<code>extent.depth</code> + <code>srcOffset.z</code>)</span> <strong class=\"purple\">must</strong> equal the depth of the specified <code>srcSubresource</code> of <code>srcImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-dstImage-01731",
|
|
"text": " If <code>dstImage</code> is a <a href=\"#blocked-image\">blocked image</a>, then for each element of <code>pRegions</code>, all members of <code>dstOffset</code> <strong class=\"purple\">must</strong> be a multiple of the corresponding dimensions of the compressed texel block"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-dstImage-01732",
|
|
"text": " If <code>dstImage</code> is a <a href=\"#blocked-image\">blocked image</a>, then for each element of <code>pRegions</code>, <code>extent.width</code> <strong class=\"purple\">must</strong> be a multiple of the compressed texel block width or <span class=\"eq\">(<code>extent.width</code> + <code>dstOffset.x</code>)</span> <strong class=\"purple\">must</strong> equal the width of the specified <code>dstSubresource</code> of <code>dstImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-dstImage-01733",
|
|
"text": " If <code>dstImage</code> is a <a href=\"#blocked-image\">blocked image</a>, then for each element of <code>pRegions</code>, <code>extent.height</code> <strong class=\"purple\">must</strong> be a multiple of the compressed texel block height or <span class=\"eq\">(<code>extent.height</code> + <code>dstOffset.y</code>)</span> <strong class=\"purple\">must</strong> equal the height of the specified <code>dstSubresource</code> of <code>dstImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-dstImage-01734",
|
|
"text": " If <code>dstImage</code> is a <a href=\"#blocked-image\">blocked image</a>, then for each element of <code>pRegions</code>, <code>extent.depth</code> <strong class=\"purple\">must</strong> be a multiple of the compressed texel block depth or <span class=\"eq\">(<code>extent.depth</code> + <code>dstOffset.z</code>)</span> <strong class=\"purple\">must</strong> equal the depth of the specified <code>dstSubresource</code> of <code>dstImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_COPY_IMAGE_INFO_2</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-srcImage-parameter",
|
|
"text": " <code>srcImage</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImage\">VkImage</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-srcImageLayout-parameter",
|
|
"text": " <code>srcImageLayout</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageLayout\">VkImageLayout</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-dstImage-parameter",
|
|
"text": " <code>dstImage</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImage\">VkImage</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-dstImageLayout-parameter",
|
|
"text": " <code>dstImageLayout</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageLayout\">VkImageLayout</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-pRegions-parameter",
|
|
"text": " <code>pRegions</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>regionCount</code> valid <a href=\"#VkImageCopy2\">VkImageCopy2</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-regionCount-arraylength",
|
|
"text": " <code>regionCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-commonparent",
|
|
"text": " Both of <code>dstImage</code>, and <code>srcImage</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_copy_commands2)+(VK_VERSION_1_1,VK_KHR_maintenance1)": [
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-srcImage-01995",
|
|
"text": " The <a href=\"#resources-image-format-features\">format features</a> of <code>srcImage</code> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_TRANSFER_SRC_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-dstImage-01996",
|
|
"text": " The <a href=\"#resources-image-format-features\">format features</a> of <code>dstImage</code> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_TRANSFER_DST_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-srcImage-04443",
|
|
"text": " If <code>srcImage</code> is of type <code>VK_IMAGE_TYPE_3D</code>, then for each element of <code>pRegions</code>, <code>srcSubresource.baseArrayLayer</code> <strong class=\"purple\">must</strong> be <code>0</code> and <code>srcSubresource.layerCount</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-dstImage-04444",
|
|
"text": " If <code>dstImage</code> is of type <code>VK_IMAGE_TYPE_3D</code>, then for each element of <code>pRegions</code>, <code>dstSubresource.baseArrayLayer</code> <strong class=\"purple\">must</strong> be <code>0</code> and <code>dstSubresource.layerCount</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-srcImage-01790",
|
|
"text": " If <code>srcImage</code> and <code>dstImage</code> are both of type <code>VK_IMAGE_TYPE_2D</code>, then for each element of <code>pRegions</code>, <code>extent.depth</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-srcImage-01791",
|
|
"text": " If <code>srcImage</code> is of type <code>VK_IMAGE_TYPE_2D</code>, and <code>dstImage</code> is of type <code>VK_IMAGE_TYPE_3D</code>, then for each element of <code>pRegions</code>, <code>extent.depth</code> <strong class=\"purple\">must</strong> equal <code>srcSubresource.layerCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-dstImage-01792",
|
|
"text": " If <code>dstImage</code> is of type <code>VK_IMAGE_TYPE_2D</code>, and <code>srcImage</code> is of type <code>VK_IMAGE_TYPE_3D</code>, then for each element of <code>pRegions</code>, <code>extent.depth</code> <strong class=\"purple\">must</strong> equal <code>dstSubresource.layerCount</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_copy_commands2)+!(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-srcImage-00127",
|
|
"text": " If <code>srcImage</code> is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-dstImage-00132",
|
|
"text": " If <code>dstImage</code> is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-srcImage-00135",
|
|
"text": " The <a href=\"#VkFormat\">VkFormat</a> of each of <code>srcImage</code> and <code>dstImage</code> <strong class=\"purple\">must</strong> be compatible, as defined <a href=\"#copies-images-format-compatibility\">above</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_copy_commands2)+(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-srcImage-01546",
|
|
"text": " If <code>srcImage</code> is non-sparse then the image or <em>disjoint</em> plane to be copied <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-dstImage-01547",
|
|
"text": " If <code>dstImage</code> is non-sparse then the image or <em>disjoint</em> plane that is the destination of the copy <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-srcImage-01548",
|
|
"text": " If the <a href=\"#VkFormat\">VkFormat</a> of each of <code>srcImage</code> and <code>dstImage</code> is not a <a href=\"#formats-requiring-sampler-ycbcr-conversion\"><em>multi-planar format</em></a>, the <a href=\"#VkFormat\">VkFormat</a> of each of <code>srcImage</code> and <code>dstImage</code> <strong class=\"purple\">must</strong> be compatible, as defined <a href=\"#copies-images-format-compatibility\">above</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-None-01549",
|
|
"text": " In a copy to or from a plane of a <a href=\"#formats-requiring-sampler-ycbcr-conversion\">multi-planar image</a>, the <a href=\"#VkFormat\">VkFormat</a> of the image and plane <strong class=\"purple\">must</strong> be compatible according to <a href=\"#formats-compatible-planes\">the description of compatible planes</a> for the plane being copied"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-srcImage-01551",
|
|
"text": " If neither <code>srcImage</code> nor <code>dstImage</code> has a <a href=\"#formats-requiring-sampler-ycbcr-conversion\">multi-planar image format</a> then for each element of <code>pRegions</code>, <code>srcSubresource.aspectMask</code> and <code>dstSubresource.aspectMask</code> <strong class=\"purple\">must</strong> match"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-srcImage-01552",
|
|
"text": " If <code>srcImage</code> has a <a href=\"#VkFormat\">VkFormat</a> with <a href=\"#formats-requiring-sampler-ycbcr-conversion\">two planes</a> then for each element of <code>pRegions</code>, <code>srcSubresource.aspectMask</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_ASPECT_PLANE_0_BIT</code> or <code>VK_IMAGE_ASPECT_PLANE_1_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-srcImage-01553",
|
|
"text": " If <code>srcImage</code> has a <a href=\"#VkFormat\">VkFormat</a> with <a href=\"#formats-requiring-sampler-ycbcr-conversion\">three planes</a> then for each element of <code>pRegions</code>, <code>srcSubresource.aspectMask</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_ASPECT_PLANE_0_BIT</code>, <code>VK_IMAGE_ASPECT_PLANE_1_BIT</code>, or <code>VK_IMAGE_ASPECT_PLANE_2_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-dstImage-01554",
|
|
"text": " If <code>dstImage</code> has a <a href=\"#VkFormat\">VkFormat</a> with <a href=\"#formats-requiring-sampler-ycbcr-conversion\">two planes</a> then for each element of <code>pRegions</code>, <code>dstSubresource.aspectMask</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_ASPECT_PLANE_0_BIT</code> or <code>VK_IMAGE_ASPECT_PLANE_1_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-dstImage-01555",
|
|
"text": " If <code>dstImage</code> has a <a href=\"#VkFormat\">VkFormat</a> with <a href=\"#formats-requiring-sampler-ycbcr-conversion\">three planes</a> then for each element of <code>pRegions</code>, <code>dstSubresource.aspectMask</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_ASPECT_PLANE_0_BIT</code>, <code>VK_IMAGE_ASPECT_PLANE_1_BIT</code>, or <code>VK_IMAGE_ASPECT_PLANE_2_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-srcImage-01556",
|
|
"text": " If <code>srcImage</code> has a <a href=\"#formats-requiring-sampler-ycbcr-conversion\">multi-planar image format</a> and the <code>dstImage</code> does not have a multi-planar image format, then for each element of <code>pRegions</code>, <code>dstSubresource.aspectMask</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_ASPECT_COLOR_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-dstImage-01557",
|
|
"text": " If <code>dstImage</code> has a <a href=\"#formats-requiring-sampler-ycbcr-conversion\">multi-planar image format</a> and the <code>srcImage</code> does not have a multi-planar image format, then for each element of <code>pRegions</code>, <code>srcSubresource.aspectMask</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_ASPECT_COLOR_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_copy_commands2)+!(VK_KHR_shared_presentable_image)": [
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-srcImageLayout-00129",
|
|
"text": " <code>srcImageLayout</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_LAYOUT_TRANSFER_SRC_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_GENERAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-dstImageLayout-00134",
|
|
"text": " <code>dstImageLayout</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_LAYOUT_TRANSFER_DST_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_GENERAL</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_copy_commands2)+(VK_KHR_shared_presentable_image)": [
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-srcImageLayout-01917",
|
|
"text": " <code>srcImageLayout</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_LAYOUT_TRANSFER_SRC_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_GENERAL</code>, or <code>VK_IMAGE_LAYOUT_SHARED_PRESENT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-dstImageLayout-01395",
|
|
"text": " <code>dstImageLayout</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_LAYOUT_TRANSFER_DST_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_GENERAL</code>, or <code>VK_IMAGE_LAYOUT_SHARED_PRESENT_KHR</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_copy_commands2)+(VK_EXT_fragment_density_map)": [
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-dstImage-02542",
|
|
"text": " <code>dstImage</code> and <code>srcImage</code> <strong class=\"purple\">must</strong> not have been created with <code>flags</code> containing <code>VK_IMAGE_CREATE_SUBSAMPLED_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_copy_commands2)+!(VK_VERSION_1_1,VK_KHR_maintenance1)": [
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-srcImage-00139",
|
|
"text": " If either <code>srcImage</code> or <code>dstImage</code> is of type <code>VK_IMAGE_TYPE_3D</code>, then for each element of <code>pRegions</code>, <code>srcSubresource.baseArrayLayer</code> and <code>dstSubresource.baseArrayLayer</code> <strong class=\"purple\">must</strong> each be <code>0</code>, and <code>srcSubresource.layerCount</code> and <code>dstSubresource.layerCount</code> <strong class=\"purple\">must</strong> each be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-srcImage-01789",
|
|
"text": " If <code>srcImage</code> or <code>dstImage</code> is of type <code>VK_IMAGE_TYPE_2D</code>, then for each element of <code>pRegions</code>, <code>extent.depth</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_copy_commands2)+!(VK_VERSION_1_2,VK_EXT_separate_stencil_usage)": [
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-srcImage-00126",
|
|
"text": " <code>srcImage</code> <strong class=\"purple\">must</strong> have been created with <code>VK_IMAGE_USAGE_TRANSFER_SRC_BIT</code> usage flag"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-dstImage-00131",
|
|
"text": " <code>dstImage</code> <strong class=\"purple\">must</strong> have been created with <code>VK_IMAGE_USAGE_TRANSFER_DST_BIT</code> usage flag"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_copy_commands2)+(VK_VERSION_1_2,VK_EXT_separate_stencil_usage)": [
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-aspect-06662",
|
|
"text": " If the <code>aspect</code> member of any element of <code>pRegions</code> includes any flag other than <code>VK_IMAGE_ASPECT_STENCIL_BIT</code> or <code>srcImage</code> was not created with <a href=\"#VkImageStencilUsageCreateInfo\">separate stencil usage</a>, <code>VK_IMAGE_USAGE_TRANSFER_SRC_BIT</code> <strong class=\"purple\">must</strong> have been included in the <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a>::<code>usage</code> used to create <code>srcImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-aspect-06663",
|
|
"text": " If the <code>aspect</code> member of any element of <code>pRegions</code> includes any flag other than <code>VK_IMAGE_ASPECT_STENCIL_BIT</code> or <code>dstImage</code> was not created with <a href=\"#VkImageStencilUsageCreateInfo\">separate stencil usage</a>, <code>VK_IMAGE_USAGE_TRANSFER_DST_BIT</code> <strong class=\"purple\">must</strong> have been included in the <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a>::<code>usage</code> used to create <code>dstImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-aspect-06664",
|
|
"text": " If the <code>aspect</code> member of any element of <code>pRegions</code> includes <code>VK_IMAGE_ASPECT_STENCIL_BIT</code>, and <code>srcImage</code> was created with <a href=\"#VkImageStencilUsageCreateInfo\">separate stencil usage</a>, <code>VK_IMAGE_USAGE_TRANSFER_SRC_BIT</code> <strong class=\"purple\">must</strong> have been included in the <a href=\"#VkImageStencilUsageCreateInfo\">VkImageStencilUsageCreateInfo</a>::<code>stencilUsage</code> used to create <code>srcImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageInfo2-aspect-06665",
|
|
"text": " If the <code>aspect</code> member of any element of <code>pRegions</code> includes <code>VK_IMAGE_ASPECT_STENCIL_BIT</code>, and <code>dstImage</code> was created with <a href=\"#VkImageStencilUsageCreateInfo\">separate stencil usage</a>, <code>VK_IMAGE_USAGE_TRANSFER_DST_BIT</code> <strong class=\"purple\">must</strong> have been included in the <a href=\"#VkImageStencilUsageCreateInfo\">VkImageStencilUsageCreateInfo</a>::<code>stencilUsage</code> used to create <code>dstImage</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkImageCopy2": {
|
|
"(VK_VERSION_1_3,VK_KHR_copy_commands2)+!(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-VkImageCopy2-aspectMask-00137",
|
|
"text": " The <code>aspectMask</code> member of <code>srcSubresource</code> and <code>dstSubresource</code> <strong class=\"purple\">must</strong> match"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_copy_commands2)+!(VK_VERSION_1_1,VK_KHR_maintenance1)": [
|
|
{
|
|
"vuid": "VUID-VkImageCopy2-layerCount-00138",
|
|
"text": " The <code>layerCount</code> member of <code>srcSubresource</code> and <code>dstSubresource</code> <strong class=\"purple\">must</strong> match"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_copy_commands2)+(VK_VERSION_1_1,VK_KHR_maintenance1)": [
|
|
{
|
|
"vuid": "VUID-VkImageCopy2-extent-00140",
|
|
"text": " The number of slices of the <code>extent</code> (for 3D) or layers of the <code>srcSubresource</code> (for non-3D) <strong class=\"purple\">must</strong> match the number of slices of the <code>extent</code> (for 3D) or layers of the <code>dstSubresource</code> (for non-3D)"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_copy_commands2)": [
|
|
{
|
|
"vuid": "VUID-VkImageCopy2-extent-06668",
|
|
"text": " <code>extent.width</code> <strong class=\"purple\">must</strong> not be 0"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCopy2-extent-06669",
|
|
"text": " <code>extent.height</code> <strong class=\"purple\">must</strong> not be 0"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCopy2-extent-06670",
|
|
"text": " <code>extent.depth</code> <strong class=\"purple\">must</strong> not be 0"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCopy2-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_IMAGE_COPY_2</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCopy2-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCopy2-srcSubresource-parameter",
|
|
"text": " <code>srcSubresource</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageSubresourceLayers\">VkImageSubresourceLayers</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageCopy2-dstSubresource-parameter",
|
|
"text": " <code>dstSubresource</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageSubresourceLayers\">VkImageSubresourceLayers</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdCopyBufferToImage": {
|
|
"(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBufferToImage-commandBuffer-01828",
|
|
"text": " If <code>commandBuffer</code> is an unprotected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, <code>srcBuffer</code> <strong class=\"purple\">must</strong> not be a protected buffer"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBufferToImage-commandBuffer-01829",
|
|
"text": " If <code>commandBuffer</code> is an unprotected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, <code>dstImage</code> <strong class=\"purple\">must</strong> not be a protected image"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBufferToImage-commandBuffer-01830",
|
|
"text": " If <code>commandBuffer</code> is a protected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, <code>dstImage</code> <strong class=\"purple\">must</strong> not be an unprotected image"
|
|
}
|
|
],
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBufferToImage-pRegions-06217",
|
|
"text": " The image region specified by each element of <code>pRegions</code> <strong class=\"purple\">must</strong> be contained within the specified <code>imageSubresource</code> of <code>dstImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBufferToImage-pRegions-00171",
|
|
"text": " <code>srcBuffer</code> <strong class=\"purple\">must</strong> be large enough to contain all buffer locations that are accessed according to <a href=\"#copies-buffers-images-addressing\">Buffer and Image Addressing</a>, for each element of <code>pRegions</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBufferToImage-pRegions-00173",
|
|
"text": " The union of all source regions, and the union of all destination regions, specified by the elements of <code>pRegions</code>, <strong class=\"purple\">must</strong> not overlap in memory"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBufferToImage-srcBuffer-00174",
|
|
"text": " <code>srcBuffer</code> <strong class=\"purple\">must</strong> have been created with <code>VK_BUFFER_USAGE_TRANSFER_SRC_BIT</code> usage flag"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBufferToImage-srcBuffer-00176",
|
|
"text": " If <code>srcBuffer</code> is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBufferToImage-dstImage-00177",
|
|
"text": " <code>dstImage</code> <strong class=\"purple\">must</strong> have been created with <code>VK_IMAGE_USAGE_TRANSFER_DST_BIT</code> usage flag"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBufferToImage-dstImage-00178",
|
|
"text": " If <code>dstImage</code> is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBufferToImage-dstImage-00179",
|
|
"text": " <code>dstImage</code> <strong class=\"purple\">must</strong> have a sample count equal to <code>VK_SAMPLE_COUNT_1_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBufferToImage-dstImageLayout-00180",
|
|
"text": " <code>dstImageLayout</code> <strong class=\"purple\">must</strong> specify the layout of the image subresources of <code>dstImage</code> specified in <code>pRegions</code> at the time this command is executed on a <code>VkDevice</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBufferToImage-imageSubresource-01701",
|
|
"text": " The <code>imageSubresource.mipLevel</code> member of each element of <code>pRegions</code> <strong class=\"purple\">must</strong> be less than the <code>mipLevels</code> specified in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> when <code>dstImage</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBufferToImage-imageSubresource-01702",
|
|
"text": " The <span class=\"eq\"><code>imageSubresource.baseArrayLayer</code> + <code>imageSubresource.layerCount</code></span> of each element of <code>pRegions</code> <strong class=\"purple\">must</strong> be less than or equal to the <code>arrayLayers</code> specified in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> when <code>dstImage</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBufferToImage-imageOffset-01793",
|
|
"text": " The <code>imageOffset</code> and <code>imageExtent</code> members of each element of <code>pRegions</code> <strong class=\"purple\">must</strong> respect the image transfer granularity requirements of <code>commandBuffer</code>’s command pool’s queue family, as described in <a href=\"#VkQueueFamilyProperties\">VkQueueFamilyProperties</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBufferToImage-commandBuffer-04477",
|
|
"text": " If the queue family used to create the <a href=\"#VkCommandPool\">VkCommandPool</a> which <code>commandBuffer</code> was allocated from does not support <code>VK_QUEUE_GRAPHICS_BIT</code>, for each element of <code>pRegions</code>, the <code>aspectMask</code> member of <code>imageSubresource</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_ASPECT_DEPTH_BIT</code> or <code>VK_IMAGE_ASPECT_STENCIL_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBufferToImage-pRegions-06218",
|
|
"text": " For each element of <code>pRegions</code>, <code>imageOffset.x</code> and <span class=\"eq\">(<code>imageExtent.width</code> + <code>imageOffset.x</code>)</span> <strong class=\"purple\">must</strong> both be greater than or equal to <code>0</code> and less than or equal to the width of the specified <code>imageSubresource</code> of <code>dstImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBufferToImage-pRegions-06219",
|
|
"text": " For each element of <code>pRegions</code>, <code>imageOffset.y</code> and <span class=\"eq\">(<code>imageExtent.height</code> + <code>imageOffset.y</code>)</span> <strong class=\"purple\">must</strong> both be greater than or equal to <code>0</code> and less than or equal to the height of the specified <code>imageSubresource</code> of <code>dstImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBufferToImage-srcImage-00199",
|
|
"text": " If pname:dstImage is of type <code>VK_IMAGE_TYPE_1D</code>, then for each element of <code>pRegions</code>, <code>imageOffset.y</code> <strong class=\"purple\">must</strong> be <code>0</code> and <code>imageExtent.height</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBufferToImage-imageOffset-00200",
|
|
"text": " For each element of <code>pRegions</code>, <code>imageOffset.z</code> and <span class=\"eq\">(<code>imageExtent.depth</code> + <code>imageOffset.z</code>)</span> <strong class=\"purple\">must</strong> both be greater than or equal to <code>0</code> and less than or equal to the depth of the specified <code>imageSubresource</code> of pname:dstImage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBufferToImage-srcImage-00201",
|
|
"text": " If pname:dstImage is of type <code>VK_IMAGE_TYPE_1D</code> or <code>VK_IMAGE_TYPE_2D</code>, then for each element of <code>pRegions</code>, <code>imageOffset.z</code> <strong class=\"purple\">must</strong> be <code>0</code> and <code>imageExtent.depth</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBufferToImage-bufferRowLength-00203",
|
|
"text": " If pname:dstImage is a <a href=\"#blocked-image\">blocked image</a>, for each element of <code>pRegions</code>, <code>bufferRowLength</code> <strong class=\"purple\">must</strong> be a multiple of the compressed texel block width"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBufferToImage-bufferImageHeight-00204",
|
|
"text": " If pname:dstImage is a <a href=\"#blocked-image\">blocked image</a>, for each element of <code>pRegions</code>, <code>bufferImageHeight</code> <strong class=\"purple\">must</strong> be a multiple of the compressed texel block height"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBufferToImage-imageOffset-00205",
|
|
"text": " If pname:dstImage is a <a href=\"#blocked-image\">blocked image</a>, for each element of <code>pRegions</code>, all members of <code>imageOffset</code> <strong class=\"purple\">must</strong> be a multiple of the corresponding dimensions of the compressed texel block"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBufferToImage-bufferOffset-00206",
|
|
"text": " If pname:dstImage is a <a href=\"#blocked-image\">blocked image</a>, for each element of <code>pRegions</code>, <code>bufferOffset</code> <strong class=\"purple\">must</strong> be a multiple of the compressed texel block size in bytes"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBufferToImage-imageExtent-00207",
|
|
"text": " If pname:dstImage is a <a href=\"#blocked-image\">blocked image</a>, for each element of <code>pRegions</code>, <code>imageExtent.width</code> <strong class=\"purple\">must</strong> be a multiple of the compressed texel block width or <span class=\"eq\">(<code>imageExtent.width</code> + <code>imageOffset.x</code>)</span> <strong class=\"purple\">must</strong> equal the width of the specified <code>imageSubresource</code> of pname:dstImage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBufferToImage-imageExtent-00208",
|
|
"text": " If pname:dstImage is a <a href=\"#blocked-image\">blocked image</a>, for each element of <code>pRegions</code>, <code>imageExtent.height</code> <strong class=\"purple\">must</strong> be a multiple of the compressed texel block height or <span class=\"eq\">(<code>imageExtent.height</code> + <code>imageOffset.y</code>)</span> <strong class=\"purple\">must</strong> equal the height of the specified <code>imageSubresource</code> of pname:dstImage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBufferToImage-imageExtent-00209",
|
|
"text": " If pname:dstImage is a <a href=\"#blocked-image\">blocked image</a>, for each element of <code>pRegions</code>, <code>imageExtent.depth</code> <strong class=\"purple\">must</strong> be a multiple of the compressed texel block depth or <span class=\"eq\">(<code>imageExtent.depth</code> + <code>imageOffset.z</code>)</span> <strong class=\"purple\">must</strong> equal the depth of the specified <code>imageSubresource</code> of pname:dstImage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBufferToImage-aspectMask-00211",
|
|
"text": " For each element of <code>pRegions</code>, <code>imageSubresource.aspectMask</code> <strong class=\"purple\">must</strong> specify aspects present in pname:dstImage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBufferToImage-baseArrayLayer-00213",
|
|
"text": " If pname:dstImage is of type <code>VK_IMAGE_TYPE_3D</code>, for each element of <code>pRegions</code>, <code>imageSubresource.baseArrayLayer</code> <strong class=\"purple\">must</strong> be <code>0</code> and <code>imageSubresource.layerCount</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBufferToImage-pRegions-04725",
|
|
"text": " If pname:dstImage is not a <a href=\"#blocked-image\">blocked image</a>, for each element of <code>pRegions</code>, <code>bufferRowLength</code> multiplied by the texel block size of pname:dstImage <strong class=\"purple\">must</strong> be less than or equal to <span class=\"eq\">2<sup>31</sup>-1</span>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBufferToImage-pRegions-04726",
|
|
"text": " If pname:dstImage is a <a href=\"#blocked-image\">blocked image</a>, for each element of <code>pRegions</code>, <code>bufferRowLength</code> divided by the compressed texel block width and then multiplied by the texel block size of pname:dstImage <strong class=\"purple\">must</strong> be less than or equal to <span class=\"eq\">2<sup>31</sup>-1</span>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBufferToImage-commandBuffer-04052",
|
|
"text": " If the queue family used to create the <a href=\"#VkCommandPool\">VkCommandPool</a> which <code>commandBuffer</code> was allocated from does not support <code>VK_QUEUE_GRAPHICS_BIT</code> or <code>VK_QUEUE_COMPUTE_BIT</code>, the <code>bufferOffset</code> member of any element of <code>pRegions</code> <strong class=\"purple\">must</strong> be a multiple of <code>4</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBufferToImage-srcImage-04053",
|
|
"text": " If pname:dstImage has a depth/stencil format, the <code>bufferOffset</code> member of any element of <code>pRegions</code> <strong class=\"purple\">must</strong> be a multiple of <code>4</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBufferToImage-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBufferToImage-srcBuffer-parameter",
|
|
"text": " <code>srcBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBuffer\">VkBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBufferToImage-dstImage-parameter",
|
|
"text": " <code>dstImage</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImage\">VkImage</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBufferToImage-dstImageLayout-parameter",
|
|
"text": " <code>dstImageLayout</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageLayout\">VkImageLayout</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBufferToImage-pRegions-parameter",
|
|
"text": " <code>pRegions</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>regionCount</code> valid <a href=\"#VkBufferImageCopy\">VkBufferImageCopy</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBufferToImage-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBufferToImage-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support transfer, graphics, or compute operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBufferToImage-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBufferToImage-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBufferToImage-regionCount-arraylength",
|
|
"text": " <code>regionCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBufferToImage-commonparent",
|
|
"text": " Each of <code>commandBuffer</code>, <code>dstImage</code>, and <code>srcBuffer</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_maintenance1)": [
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBufferToImage-dstImage-01997",
|
|
"text": " The <a href=\"#resources-image-format-features\">format features</a> of <code>dstImage</code> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_TRANSFER_DST_BIT</code>"
|
|
}
|
|
],
|
|
"!(VK_KHR_shared_presentable_image)": [
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBufferToImage-dstImageLayout-00181",
|
|
"text": " <code>dstImageLayout</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_LAYOUT_TRANSFER_DST_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_GENERAL</code>"
|
|
}
|
|
],
|
|
"(VK_KHR_shared_presentable_image)": [
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBufferToImage-dstImageLayout-01396",
|
|
"text": " <code>dstImageLayout</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_LAYOUT_TRANSFER_DST_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_GENERAL</code>, or <code>VK_IMAGE_LAYOUT_SHARED_PRESENT_KHR</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_fragment_density_map)": [
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBufferToImage-dstImage-02543",
|
|
"text": " <code>dstImage</code> <strong class=\"purple\">must</strong> not have been created with <code>flags</code> containing <code>VK_IMAGE_CREATE_SUBSAMPLED_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"!(VK_EXT_depth_range_unrestricted)": [
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBufferToImage-None-00214",
|
|
"text": " For each element of <code>pRegions</code> whose <code>imageSubresource</code> contains a depth aspect, the data in <code>srcBuffer</code> <strong class=\"purple\">must</strong> be in the range <span class=\"eq\">[0,1]</span>"
|
|
}
|
|
],
|
|
"!(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBufferToImage-bufferOffset-00193",
|
|
"text": " If pname:dstImage does not have a depth/stencil format, then for each element of <code>pRegions</code>, <code>bufferOffset</code> <strong class=\"purple\">must</strong> be a multiple of the format’s texel block size"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBufferToImage-bufferOffset-01558",
|
|
"text": " If pname:dstImage does not have either a depth/stencil or a <a href=\"#formats-requiring-sampler-ycbcr-conversion\">multi-planar format</a>, then for each element of <code>pRegions</code>, <code>bufferOffset</code> <strong class=\"purple\">must</strong> be a multiple of the format’s texel block size"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBufferToImage-bufferOffset-01559",
|
|
"text": " If pname:dstImage has a <a href=\"#formats-requiring-sampler-ycbcr-conversion\">multi-planar format</a>, then for each element of <code>pRegions</code>, <code>bufferOffset</code> <strong class=\"purple\">must</strong> be a multiple of the element size of the compatible format for the format and the <code>aspectMask</code> of the <code>imageSubresource</code> as defined in <a href=\"#formats-compatible-planes\">Compatible formats of planes of multi-planar formats</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBufferToImage-aspectMask-01560",
|
|
"text": " If pname:dstImage has a <a href=\"#formats-requiring-sampler-ycbcr-conversion\">multi-planar format</a>, then for each element of <code>pRegions</code>, <code>imageSubresource.aspectMask</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_ASPECT_PLANE_0_BIT</code>, <code>VK_IMAGE_ASPECT_PLANE_1_BIT</code>, or <code>VK_IMAGE_ASPECT_PLANE_2_BIT</code> (with <code>VK_IMAGE_ASPECT_PLANE_2_BIT</code> valid only for image formats with three planes)"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdCopyImageToBuffer": {
|
|
"(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImageToBuffer-commandBuffer-01831",
|
|
"text": " If <code>commandBuffer</code> is an unprotected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, <code>srcImage</code> <strong class=\"purple\">must</strong> not be a protected image"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImageToBuffer-commandBuffer-01832",
|
|
"text": " If <code>commandBuffer</code> is an unprotected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, <code>dstBuffer</code> <strong class=\"purple\">must</strong> not be a protected buffer"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImageToBuffer-commandBuffer-01833",
|
|
"text": " If <code>commandBuffer</code> is a protected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, <code>dstBuffer</code> <strong class=\"purple\">must</strong> not be an unprotected buffer"
|
|
}
|
|
],
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImageToBuffer-pRegions-06220",
|
|
"text": " The image region specified by each element of <code>pRegions</code> <strong class=\"purple\">must</strong> be contained within the specified <code>imageSubresource</code> of <code>srcImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImageToBuffer-pRegions-00183",
|
|
"text": " <code>dstBuffer</code> <strong class=\"purple\">must</strong> be large enough to contain all buffer locations that are accessed according to <a href=\"#copies-buffers-images-addressing\">Buffer and Image Addressing</a>, for each element of <code>pRegions</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImageToBuffer-pRegions-00184",
|
|
"text": " The union of all source regions, and the union of all destination regions, specified by the elements of <code>pRegions</code>, <strong class=\"purple\">must</strong> not overlap in memory"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImageToBuffer-srcImage-00186",
|
|
"text": " <code>srcImage</code> <strong class=\"purple\">must</strong> have been created with <code>VK_IMAGE_USAGE_TRANSFER_SRC_BIT</code> usage flag"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImageToBuffer-srcImage-00187",
|
|
"text": " If <code>srcImage</code> is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImageToBuffer-dstBuffer-00191",
|
|
"text": " <code>dstBuffer</code> <strong class=\"purple\">must</strong> have been created with <code>VK_BUFFER_USAGE_TRANSFER_DST_BIT</code> usage flag"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImageToBuffer-dstBuffer-00192",
|
|
"text": " If <code>dstBuffer</code> is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImageToBuffer-srcImage-00188",
|
|
"text": " <code>srcImage</code> <strong class=\"purple\">must</strong> have a sample count equal to <code>VK_SAMPLE_COUNT_1_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImageToBuffer-srcImageLayout-00189",
|
|
"text": " <code>srcImageLayout</code> <strong class=\"purple\">must</strong> specify the layout of the image subresources of <code>srcImage</code> specified in <code>pRegions</code> at the time this command is executed on a <code>VkDevice</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImageToBuffer-imageSubresource-01703",
|
|
"text": " The <code>imageSubresource.mipLevel</code> member of each element of <code>pRegions</code> <strong class=\"purple\">must</strong> be less than the <code>mipLevels</code> specified in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> when <code>srcImage</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImageToBuffer-imageSubresource-01704",
|
|
"text": " The <span class=\"eq\"><code>imageSubresource.baseArrayLayer</code> + <code>imageSubresource.layerCount</code></span> of each element of <code>pRegions</code> <strong class=\"purple\">must</strong> be less than or equal to the <code>arrayLayers</code> specified in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> when <code>srcImage</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImageToBuffer-imageOffset-01794",
|
|
"text": " The <code>imageOffset</code> and <code>imageExtent</code> members of each element of <code>pRegions</code> <strong class=\"purple\">must</strong> respect the image transfer granularity requirements of <code>commandBuffer</code>’s command pool’s queue family, as described in <a href=\"#VkQueueFamilyProperties\">VkQueueFamilyProperties</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImageToBuffer-pRegions-06221",
|
|
"text": " For each element of <code>pRegions</code>, <code>imageOffset.x</code> and <span class=\"eq\">(<code>imageExtent.width</code> + <code>imageOffset.x</code>)</span> <strong class=\"purple\">must</strong> both be greater than or equal to <code>0</code> and less than or equal to the width of the specified <code>imageSubresource</code> of <code>srcImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImageToBuffer-pRegions-06222",
|
|
"text": " For each element of <code>pRegions</code>, <code>imageOffset.y</code> and <span class=\"eq\">(imageExtent.height + <code>imageOffset.y</code>)</span> <strong class=\"purple\">must</strong> both be greater than or equal to <code>0</code> and less than or equal to the height of the specified <code>imageSubresource</code> of <code>srcImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImageToBuffer-srcImage-00199",
|
|
"text": " If pname:srcImage is of type <code>VK_IMAGE_TYPE_1D</code>, then for each element of <code>pRegions</code>, <code>imageOffset.y</code> <strong class=\"purple\">must</strong> be <code>0</code> and <code>imageExtent.height</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImageToBuffer-imageOffset-00200",
|
|
"text": " For each element of <code>pRegions</code>, <code>imageOffset.z</code> and <span class=\"eq\">(<code>imageExtent.depth</code> + <code>imageOffset.z</code>)</span> <strong class=\"purple\">must</strong> both be greater than or equal to <code>0</code> and less than or equal to the depth of the specified <code>imageSubresource</code> of pname:srcImage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImageToBuffer-srcImage-00201",
|
|
"text": " If pname:srcImage is of type <code>VK_IMAGE_TYPE_1D</code> or <code>VK_IMAGE_TYPE_2D</code>, then for each element of <code>pRegions</code>, <code>imageOffset.z</code> <strong class=\"purple\">must</strong> be <code>0</code> and <code>imageExtent.depth</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImageToBuffer-bufferRowLength-00203",
|
|
"text": " If pname:srcImage is a <a href=\"#blocked-image\">blocked image</a>, for each element of <code>pRegions</code>, <code>bufferRowLength</code> <strong class=\"purple\">must</strong> be a multiple of the compressed texel block width"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImageToBuffer-bufferImageHeight-00204",
|
|
"text": " If pname:srcImage is a <a href=\"#blocked-image\">blocked image</a>, for each element of <code>pRegions</code>, <code>bufferImageHeight</code> <strong class=\"purple\">must</strong> be a multiple of the compressed texel block height"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImageToBuffer-imageOffset-00205",
|
|
"text": " If pname:srcImage is a <a href=\"#blocked-image\">blocked image</a>, for each element of <code>pRegions</code>, all members of <code>imageOffset</code> <strong class=\"purple\">must</strong> be a multiple of the corresponding dimensions of the compressed texel block"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImageToBuffer-bufferOffset-00206",
|
|
"text": " If pname:srcImage is a <a href=\"#blocked-image\">blocked image</a>, for each element of <code>pRegions</code>, <code>bufferOffset</code> <strong class=\"purple\">must</strong> be a multiple of the compressed texel block size in bytes"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImageToBuffer-imageExtent-00207",
|
|
"text": " If pname:srcImage is a <a href=\"#blocked-image\">blocked image</a>, for each element of <code>pRegions</code>, <code>imageExtent.width</code> <strong class=\"purple\">must</strong> be a multiple of the compressed texel block width or <span class=\"eq\">(<code>imageExtent.width</code> + <code>imageOffset.x</code>)</span> <strong class=\"purple\">must</strong> equal the width of the specified <code>imageSubresource</code> of pname:srcImage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImageToBuffer-imageExtent-00208",
|
|
"text": " If pname:srcImage is a <a href=\"#blocked-image\">blocked image</a>, for each element of <code>pRegions</code>, <code>imageExtent.height</code> <strong class=\"purple\">must</strong> be a multiple of the compressed texel block height or <span class=\"eq\">(<code>imageExtent.height</code> + <code>imageOffset.y</code>)</span> <strong class=\"purple\">must</strong> equal the height of the specified <code>imageSubresource</code> of pname:srcImage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImageToBuffer-imageExtent-00209",
|
|
"text": " If pname:srcImage is a <a href=\"#blocked-image\">blocked image</a>, for each element of <code>pRegions</code>, <code>imageExtent.depth</code> <strong class=\"purple\">must</strong> be a multiple of the compressed texel block depth or <span class=\"eq\">(<code>imageExtent.depth</code> + <code>imageOffset.z</code>)</span> <strong class=\"purple\">must</strong> equal the depth of the specified <code>imageSubresource</code> of pname:srcImage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImageToBuffer-aspectMask-00211",
|
|
"text": " For each element of <code>pRegions</code>, <code>imageSubresource.aspectMask</code> <strong class=\"purple\">must</strong> specify aspects present in pname:srcImage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImageToBuffer-baseArrayLayer-00213",
|
|
"text": " If pname:srcImage is of type <code>VK_IMAGE_TYPE_3D</code>, for each element of <code>pRegions</code>, <code>imageSubresource.baseArrayLayer</code> <strong class=\"purple\">must</strong> be <code>0</code> and <code>imageSubresource.layerCount</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImageToBuffer-pRegions-04725",
|
|
"text": " If pname:srcImage is not a <a href=\"#blocked-image\">blocked image</a>, for each element of <code>pRegions</code>, <code>bufferRowLength</code> multiplied by the texel block size of pname:srcImage <strong class=\"purple\">must</strong> be less than or equal to <span class=\"eq\">2<sup>31</sup>-1</span>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImageToBuffer-pRegions-04726",
|
|
"text": " If pname:srcImage is a <a href=\"#blocked-image\">blocked image</a>, for each element of <code>pRegions</code>, <code>bufferRowLength</code> divided by the compressed texel block width and then multiplied by the texel block size of pname:srcImage <strong class=\"purple\">must</strong> be less than or equal to <span class=\"eq\">2<sup>31</sup>-1</span>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImageToBuffer-commandBuffer-04052",
|
|
"text": " If the queue family used to create the <a href=\"#VkCommandPool\">VkCommandPool</a> which <code>commandBuffer</code> was allocated from does not support <code>VK_QUEUE_GRAPHICS_BIT</code> or <code>VK_QUEUE_COMPUTE_BIT</code>, the <code>bufferOffset</code> member of any element of <code>pRegions</code> <strong class=\"purple\">must</strong> be a multiple of <code>4</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImageToBuffer-srcImage-04053",
|
|
"text": " If pname:srcImage has a depth/stencil format, the <code>bufferOffset</code> member of any element of <code>pRegions</code> <strong class=\"purple\">must</strong> be a multiple of <code>4</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImageToBuffer-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImageToBuffer-srcImage-parameter",
|
|
"text": " <code>srcImage</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImage\">VkImage</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImageToBuffer-srcImageLayout-parameter",
|
|
"text": " <code>srcImageLayout</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageLayout\">VkImageLayout</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImageToBuffer-dstBuffer-parameter",
|
|
"text": " <code>dstBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBuffer\">VkBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImageToBuffer-pRegions-parameter",
|
|
"text": " <code>pRegions</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>regionCount</code> valid <a href=\"#VkBufferImageCopy\">VkBufferImageCopy</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImageToBuffer-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImageToBuffer-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support transfer, graphics, or compute operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImageToBuffer-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImageToBuffer-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImageToBuffer-regionCount-arraylength",
|
|
"text": " <code>regionCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImageToBuffer-commonparent",
|
|
"text": " Each of <code>commandBuffer</code>, <code>dstBuffer</code>, and <code>srcImage</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_maintenance1)": [
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImageToBuffer-srcImage-01998",
|
|
"text": " The <a href=\"#resources-image-format-features\">format features</a> of <code>srcImage</code> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_TRANSFER_SRC_BIT</code>"
|
|
}
|
|
],
|
|
"!(VK_KHR_shared_presentable_image)": [
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImageToBuffer-srcImageLayout-00190",
|
|
"text": " <code>srcImageLayout</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_LAYOUT_TRANSFER_SRC_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_GENERAL</code>"
|
|
}
|
|
],
|
|
"(VK_KHR_shared_presentable_image)": [
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImageToBuffer-srcImageLayout-01397",
|
|
"text": " <code>srcImageLayout</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_LAYOUT_TRANSFER_SRC_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_GENERAL</code>, or <code>VK_IMAGE_LAYOUT_SHARED_PRESENT_KHR</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_fragment_density_map)": [
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImageToBuffer-srcImage-02544",
|
|
"text": " <code>srcImage</code> <strong class=\"purple\">must</strong> not have been created with <code>flags</code> containing <code>VK_IMAGE_CREATE_SUBSAMPLED_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"!(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImageToBuffer-bufferOffset-00193",
|
|
"text": " If pname:srcImage does not have a depth/stencil format, then for each element of <code>pRegions</code>, <code>bufferOffset</code> <strong class=\"purple\">must</strong> be a multiple of the format’s texel block size"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImageToBuffer-bufferOffset-01558",
|
|
"text": " If pname:srcImage does not have either a depth/stencil or a <a href=\"#formats-requiring-sampler-ycbcr-conversion\">multi-planar format</a>, then for each element of <code>pRegions</code>, <code>bufferOffset</code> <strong class=\"purple\">must</strong> be a multiple of the format’s texel block size"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImageToBuffer-bufferOffset-01559",
|
|
"text": " If pname:srcImage has a <a href=\"#formats-requiring-sampler-ycbcr-conversion\">multi-planar format</a>, then for each element of <code>pRegions</code>, <code>bufferOffset</code> <strong class=\"purple\">must</strong> be a multiple of the element size of the compatible format for the format and the <code>aspectMask</code> of the <code>imageSubresource</code> as defined in <a href=\"#formats-compatible-planes\">Compatible formats of planes of multi-planar formats</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImageToBuffer-aspectMask-01560",
|
|
"text": " If pname:srcImage has a <a href=\"#formats-requiring-sampler-ycbcr-conversion\">multi-planar format</a>, then for each element of <code>pRegions</code>, <code>imageSubresource.aspectMask</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_ASPECT_PLANE_0_BIT</code>, <code>VK_IMAGE_ASPECT_PLANE_1_BIT</code>, or <code>VK_IMAGE_ASPECT_PLANE_2_BIT</code> (with <code>VK_IMAGE_ASPECT_PLANE_2_BIT</code> valid only for image formats with three planes)"
|
|
}
|
|
]
|
|
},
|
|
"VkBufferImageCopy": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkBufferImageCopy-bufferRowLength-00195",
|
|
"text": " <code>bufferRowLength</code> <strong class=\"purple\">must</strong> be <code>0</code>, or greater than or equal to the <code>width</code> member of <code>imageExtent</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferImageCopy-bufferImageHeight-00196",
|
|
"text": " <code>bufferImageHeight</code> <strong class=\"purple\">must</strong> be <code>0</code>, or greater than or equal to the <code>height</code> member of <code>imageExtent</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferImageCopy-aspectMask-00212",
|
|
"text": " The <code>aspectMask</code> member of <code>imageSubresource</code> <strong class=\"purple\">must</strong> only have a single bit set"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferImageCopy-imageExtent-06659",
|
|
"text": " <code>imageExtent.width</code> <strong class=\"purple\">must</strong> not be 0"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferImageCopy-imageExtent-06660",
|
|
"text": " <code>imageExtent.height</code> <strong class=\"purple\">must</strong> not be 0"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferImageCopy-imageExtent-06661",
|
|
"text": " <code>imageExtent.depth</code> <strong class=\"purple\">must</strong> not be 0"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferImageCopy-imageSubresource-parameter",
|
|
"text": " <code>imageSubresource</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageSubresourceLayers\">VkImageSubresourceLayers</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdCopyBufferToImage2": {
|
|
"(VK_VERSION_1_3,VK_KHR_copy_commands2)+(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBufferToImage2-commandBuffer-01828",
|
|
"text": " If <code>commandBuffer</code> is an unprotected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, <code>srcBuffer</code> <strong class=\"purple\">must</strong> not be a protected buffer"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBufferToImage2-commandBuffer-01829",
|
|
"text": " If <code>commandBuffer</code> is an unprotected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, <code>dstImage</code> <strong class=\"purple\">must</strong> not be a protected image"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBufferToImage2-commandBuffer-01830",
|
|
"text": " If <code>commandBuffer</code> is a protected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, <code>dstImage</code> <strong class=\"purple\">must</strong> not be an unprotected image"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_copy_commands2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBufferToImage2-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBufferToImage2-pCopyBufferToImageInfo-parameter",
|
|
"text": " <code>pCopyBufferToImageInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkCopyBufferToImageInfo2\">VkCopyBufferToImageInfo2</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBufferToImage2-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBufferToImage2-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support transfer, graphics, or compute operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBufferToImage2-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyBufferToImage2-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
]
|
|
},
|
|
"VkCopyBufferToImageInfo2": {
|
|
"(VK_VERSION_1_3,VK_KHR_copy_commands2)+!(VK_QCOM_rotated_copy_commands)": [
|
|
{
|
|
"vuid": "VUID-VkCopyBufferToImageInfo2-pRegions-00172",
|
|
"text": " The image region specified by each element of <code>pRegions</code> <strong class=\"purple\">must</strong> be contained within the specified <code>imageSubresource</code> of <code>dstImage</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_copy_commands2)+(VK_QCOM_rotated_copy_commands)": [
|
|
{
|
|
"vuid": "VUID-VkCopyBufferToImageInfo2-pRegions-04565",
|
|
"text": " If the image region specified by each element of <code>pRegions</code> does not contain <a href=\"#VkCopyCommandTransformInfoQCOM\">VkCopyCommandTransformInfoQCOM</a> in its <code>pNext</code> chain, it <strong class=\"purple\">must</strong> be a region that is contained within the specified <code>imageSubresource</code> of <code>dstImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyBufferToImageInfo2KHR-pRegions-04554",
|
|
"text": " If the image region specified by each element of <code>pRegions</code> contains <a href=\"#VkCopyCommandTransformInfoQCOM\">VkCopyCommandTransformInfoQCOM</a> in its <code>pNext</code> chain, the rotated destination region as described in <a href=\"#copies-buffers-images-rotation-addressing\">Buffer and Image Addressing with Rotation</a> <strong class=\"purple\">must</strong> be contained within <code>dstImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyBufferToImageInfo2KHR-pRegions-04555",
|
|
"text": " If any element of <code>pRegions</code> contains <a href=\"#VkCopyCommandTransformInfoQCOM\">VkCopyCommandTransformInfoQCOM</a> in its <code>pNext</code> chain, then <code>dstImage</code> <strong class=\"purple\">must</strong> not be a <a href=\"#blocked-image\">blocked image</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyBufferToImageInfo2KHR-pRegions-06203",
|
|
"text": " If any element of <code>pRegions</code> contains <a href=\"#VkCopyCommandTransformInfoQCOM\">VkCopyCommandTransformInfoQCOM</a> in its <code>pNext</code> chain, then <code>dstImage</code> <strong class=\"purple\">must</strong> be of type <code>VK_IMAGE_TYPE_2D</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyBufferToImageInfo2KHR-pRegions-06204",
|
|
"text": " If any element of <code>pRegions</code> contains <a href=\"#VkCopyCommandTransformInfoQCOM\">VkCopyCommandTransformInfoQCOM</a> in its <code>pNext</code> chain, then <code>dstImage</code> <strong class=\"purple\">must</strong> not have a <a href=\"#formats-requiring-sampler-ycbcr-conversion\">multi-planar format</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_copy_commands2)": [
|
|
{
|
|
"vuid": "VUID-VkCopyBufferToImageInfo2-pRegions-00171",
|
|
"text": " <code>srcBuffer</code> <strong class=\"purple\">must</strong> be large enough to contain all buffer locations that are accessed according to <a href=\"#copies-buffers-images-addressing\">Buffer and Image Addressing</a>, for each element of <code>pRegions</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyBufferToImageInfo2-pRegions-00173",
|
|
"text": " The union of all source regions, and the union of all destination regions, specified by the elements of <code>pRegions</code>, <strong class=\"purple\">must</strong> not overlap in memory"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyBufferToImageInfo2-srcBuffer-00174",
|
|
"text": " <code>srcBuffer</code> <strong class=\"purple\">must</strong> have been created with <code>VK_BUFFER_USAGE_TRANSFER_SRC_BIT</code> usage flag"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyBufferToImageInfo2-srcBuffer-00176",
|
|
"text": " If <code>srcBuffer</code> is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyBufferToImageInfo2-dstImage-00177",
|
|
"text": " <code>dstImage</code> <strong class=\"purple\">must</strong> have been created with <code>VK_IMAGE_USAGE_TRANSFER_DST_BIT</code> usage flag"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyBufferToImageInfo2-dstImage-00178",
|
|
"text": " If <code>dstImage</code> is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyBufferToImageInfo2-dstImage-00179",
|
|
"text": " <code>dstImage</code> <strong class=\"purple\">must</strong> have a sample count equal to <code>VK_SAMPLE_COUNT_1_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyBufferToImageInfo2-dstImageLayout-00180",
|
|
"text": " <code>dstImageLayout</code> <strong class=\"purple\">must</strong> specify the layout of the image subresources of <code>dstImage</code> specified in <code>pRegions</code> at the time this command is executed on a <code>VkDevice</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyBufferToImageInfo2-imageSubresource-01701",
|
|
"text": " The <code>imageSubresource.mipLevel</code> member of each element of <code>pRegions</code> <strong class=\"purple\">must</strong> be less than the <code>mipLevels</code> specified in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> when <code>dstImage</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyBufferToImageInfo2-imageSubresource-01702",
|
|
"text": " The <span class=\"eq\"><code>imageSubresource.baseArrayLayer</code> + <code>imageSubresource.layerCount</code></span> of each element of <code>pRegions</code> <strong class=\"purple\">must</strong> be less than or equal to the <code>arrayLayers</code> specified in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> when <code>dstImage</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyBufferToImageInfo2-imageOffset-01793",
|
|
"text": " The <code>imageOffset</code> and <code>imageExtent</code> members of each element of <code>pRegions</code> <strong class=\"purple\">must</strong> respect the image transfer granularity requirements of <code>commandBuffer</code>’s command pool’s queue family, as described in <a href=\"#VkQueueFamilyProperties\">VkQueueFamilyProperties</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyBufferToImageInfo2-commandBuffer-04477",
|
|
"text": " If the queue family used to create the <a href=\"#VkCommandPool\">VkCommandPool</a> which <code>commandBuffer</code> was allocated from does not support <code>VK_QUEUE_GRAPHICS_BIT</code>, for each element of <code>pRegions</code>, the <code>aspectMask</code> member of <code>imageSubresource</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_ASPECT_DEPTH_BIT</code> or <code>VK_IMAGE_ASPECT_STENCIL_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyBufferToImageInfo2-pRegions-06223",
|
|
"text": " For each element of <code>pRegions</code> not containing <code>VkCopyCommandTransformInfoQCOM</code> in its <code>pNext</code> chain, <code>imageOffset.x</code> and <span class=\"eq\">(<code>imageExtent.width</code> + <code>imageOffset.x</code>)</span> <strong class=\"purple\">must</strong> both be greater than or equal to <code>0</code> and less than or equal to the width of the specified <code>imageSubresource</code> of <code>dstImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyBufferToImageInfo2-pRegions-06224",
|
|
"text": " For each element of <code>pRegions</code> not containing <code>VkCopyCommandTransformInfoQCOM</code> in its <code>pNext</code> chain, <code>imageOffset.y</code> and <span class=\"eq\">(<code>imageExtent.height</code> + <code>imageOffset.y</code>)</span> <strong class=\"purple\">must</strong> both be greater than or equal to <code>0</code> and less than or equal to the height of the specified <code>imageSubresource</code> of <code>dstImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyBufferToImageInfo2-srcImage-00199",
|
|
"text": " If pname:dstImage is of type <code>VK_IMAGE_TYPE_1D</code>, then for each element of <code>pRegions</code>, <code>imageOffset.y</code> <strong class=\"purple\">must</strong> be <code>0</code> and <code>imageExtent.height</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyBufferToImageInfo2-imageOffset-00200",
|
|
"text": " For each element of <code>pRegions</code>, <code>imageOffset.z</code> and <span class=\"eq\">(<code>imageExtent.depth</code> + <code>imageOffset.z</code>)</span> <strong class=\"purple\">must</strong> both be greater than or equal to <code>0</code> and less than or equal to the depth of the specified <code>imageSubresource</code> of pname:dstImage"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyBufferToImageInfo2-srcImage-00201",
|
|
"text": " If pname:dstImage is of type <code>VK_IMAGE_TYPE_1D</code> or <code>VK_IMAGE_TYPE_2D</code>, then for each element of <code>pRegions</code>, <code>imageOffset.z</code> <strong class=\"purple\">must</strong> be <code>0</code> and <code>imageExtent.depth</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyBufferToImageInfo2-bufferRowLength-00203",
|
|
"text": " If pname:dstImage is a <a href=\"#blocked-image\">blocked image</a>, for each element of <code>pRegions</code>, <code>bufferRowLength</code> <strong class=\"purple\">must</strong> be a multiple of the compressed texel block width"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyBufferToImageInfo2-bufferImageHeight-00204",
|
|
"text": " If pname:dstImage is a <a href=\"#blocked-image\">blocked image</a>, for each element of <code>pRegions</code>, <code>bufferImageHeight</code> <strong class=\"purple\">must</strong> be a multiple of the compressed texel block height"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyBufferToImageInfo2-imageOffset-00205",
|
|
"text": " If pname:dstImage is a <a href=\"#blocked-image\">blocked image</a>, for each element of <code>pRegions</code>, all members of <code>imageOffset</code> <strong class=\"purple\">must</strong> be a multiple of the corresponding dimensions of the compressed texel block"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyBufferToImageInfo2-bufferOffset-00206",
|
|
"text": " If pname:dstImage is a <a href=\"#blocked-image\">blocked image</a>, for each element of <code>pRegions</code>, <code>bufferOffset</code> <strong class=\"purple\">must</strong> be a multiple of the compressed texel block size in bytes"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyBufferToImageInfo2-imageExtent-00207",
|
|
"text": " If pname:dstImage is a <a href=\"#blocked-image\">blocked image</a>, for each element of <code>pRegions</code>, <code>imageExtent.width</code> <strong class=\"purple\">must</strong> be a multiple of the compressed texel block width or <span class=\"eq\">(<code>imageExtent.width</code> + <code>imageOffset.x</code>)</span> <strong class=\"purple\">must</strong> equal the width of the specified <code>imageSubresource</code> of pname:dstImage"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyBufferToImageInfo2-imageExtent-00208",
|
|
"text": " If pname:dstImage is a <a href=\"#blocked-image\">blocked image</a>, for each element of <code>pRegions</code>, <code>imageExtent.height</code> <strong class=\"purple\">must</strong> be a multiple of the compressed texel block height or <span class=\"eq\">(<code>imageExtent.height</code> + <code>imageOffset.y</code>)</span> <strong class=\"purple\">must</strong> equal the height of the specified <code>imageSubresource</code> of pname:dstImage"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyBufferToImageInfo2-imageExtent-00209",
|
|
"text": " If pname:dstImage is a <a href=\"#blocked-image\">blocked image</a>, for each element of <code>pRegions</code>, <code>imageExtent.depth</code> <strong class=\"purple\">must</strong> be a multiple of the compressed texel block depth or <span class=\"eq\">(<code>imageExtent.depth</code> + <code>imageOffset.z</code>)</span> <strong class=\"purple\">must</strong> equal the depth of the specified <code>imageSubresource</code> of pname:dstImage"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyBufferToImageInfo2-aspectMask-00211",
|
|
"text": " For each element of <code>pRegions</code>, <code>imageSubresource.aspectMask</code> <strong class=\"purple\">must</strong> specify aspects present in pname:dstImage"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyBufferToImageInfo2-baseArrayLayer-00213",
|
|
"text": " If pname:dstImage is of type <code>VK_IMAGE_TYPE_3D</code>, for each element of <code>pRegions</code>, <code>imageSubresource.baseArrayLayer</code> <strong class=\"purple\">must</strong> be <code>0</code> and <code>imageSubresource.layerCount</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyBufferToImageInfo2-pRegions-04725",
|
|
"text": " If pname:dstImage is not a <a href=\"#blocked-image\">blocked image</a>, for each element of <code>pRegions</code>, <code>bufferRowLength</code> multiplied by the texel block size of pname:dstImage <strong class=\"purple\">must</strong> be less than or equal to <span class=\"eq\">2<sup>31</sup>-1</span>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyBufferToImageInfo2-pRegions-04726",
|
|
"text": " If pname:dstImage is a <a href=\"#blocked-image\">blocked image</a>, for each element of <code>pRegions</code>, <code>bufferRowLength</code> divided by the compressed texel block width and then multiplied by the texel block size of pname:dstImage <strong class=\"purple\">must</strong> be less than or equal to <span class=\"eq\">2<sup>31</sup>-1</span>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyBufferToImageInfo2-commandBuffer-04052",
|
|
"text": " If the queue family used to create the <a href=\"#VkCommandPool\">VkCommandPool</a> which <code>commandBuffer</code> was allocated from does not support <code>VK_QUEUE_GRAPHICS_BIT</code> or <code>VK_QUEUE_COMPUTE_BIT</code>, the <code>bufferOffset</code> member of any element of <code>pRegions</code> <strong class=\"purple\">must</strong> be a multiple of <code>4</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyBufferToImageInfo2-srcImage-04053",
|
|
"text": " If pname:dstImage has a depth/stencil format, the <code>bufferOffset</code> member of any element of <code>pRegions</code> <strong class=\"purple\">must</strong> be a multiple of <code>4</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyBufferToImageInfo2-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_COPY_BUFFER_TO_IMAGE_INFO_2</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyBufferToImageInfo2-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyBufferToImageInfo2-srcBuffer-parameter",
|
|
"text": " <code>srcBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBuffer\">VkBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyBufferToImageInfo2-dstImage-parameter",
|
|
"text": " <code>dstImage</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImage\">VkImage</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyBufferToImageInfo2-dstImageLayout-parameter",
|
|
"text": " <code>dstImageLayout</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageLayout\">VkImageLayout</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyBufferToImageInfo2-pRegions-parameter",
|
|
"text": " <code>pRegions</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>regionCount</code> valid <a href=\"#VkBufferImageCopy2\">VkBufferImageCopy2</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyBufferToImageInfo2-regionCount-arraylength",
|
|
"text": " <code>regionCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyBufferToImageInfo2-commonparent",
|
|
"text": " Both of <code>dstImage</code>, and <code>srcBuffer</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_copy_commands2)+(VK_VERSION_1_1,VK_KHR_maintenance1)": [
|
|
{
|
|
"vuid": "VUID-VkCopyBufferToImageInfo2-dstImage-01997",
|
|
"text": " The <a href=\"#resources-image-format-features\">format features</a> of <code>dstImage</code> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_TRANSFER_DST_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_copy_commands2)+!(VK_KHR_shared_presentable_image)": [
|
|
{
|
|
"vuid": "VUID-VkCopyBufferToImageInfo2-dstImageLayout-00181",
|
|
"text": " <code>dstImageLayout</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_LAYOUT_TRANSFER_DST_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_GENERAL</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_copy_commands2)+(VK_KHR_shared_presentable_image)": [
|
|
{
|
|
"vuid": "VUID-VkCopyBufferToImageInfo2-dstImageLayout-01396",
|
|
"text": " <code>dstImageLayout</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_LAYOUT_TRANSFER_DST_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_GENERAL</code>, or <code>VK_IMAGE_LAYOUT_SHARED_PRESENT_KHR</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_copy_commands2)+(VK_EXT_fragment_density_map)": [
|
|
{
|
|
"vuid": "VUID-VkCopyBufferToImageInfo2-dstImage-02543",
|
|
"text": " <code>dstImage</code> <strong class=\"purple\">must</strong> not have been created with <code>flags</code> containing <code>VK_IMAGE_CREATE_SUBSAMPLED_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_copy_commands2)+!(VK_EXT_depth_range_unrestricted)": [
|
|
{
|
|
"vuid": "VUID-VkCopyBufferToImageInfo2-None-00214",
|
|
"text": " For each element of <code>pRegions</code> whose <code>imageSubresource</code> contains a depth aspect, the data in <code>srcBuffer</code> <strong class=\"purple\">must</strong> be in the range <span class=\"eq\">[0,1]</span>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_copy_commands2)+!(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-VkCopyBufferToImageInfo2-bufferOffset-00193",
|
|
"text": " If pname:dstImage does not have a depth/stencil format, then for each element of <code>pRegions</code>, <code>bufferOffset</code> <strong class=\"purple\">must</strong> be a multiple of the format’s texel block size"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_copy_commands2)+(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-VkCopyBufferToImageInfo2-bufferOffset-01558",
|
|
"text": " If pname:dstImage does not have either a depth/stencil or a <a href=\"#formats-requiring-sampler-ycbcr-conversion\">multi-planar format</a>, then for each element of <code>pRegions</code>, <code>bufferOffset</code> <strong class=\"purple\">must</strong> be a multiple of the format’s texel block size"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyBufferToImageInfo2-bufferOffset-01559",
|
|
"text": " If pname:dstImage has a <a href=\"#formats-requiring-sampler-ycbcr-conversion\">multi-planar format</a>, then for each element of <code>pRegions</code>, <code>bufferOffset</code> <strong class=\"purple\">must</strong> be a multiple of the element size of the compatible format for the format and the <code>aspectMask</code> of the <code>imageSubresource</code> as defined in <a href=\"#formats-compatible-planes\">Compatible formats of planes of multi-planar formats</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyBufferToImageInfo2-aspectMask-01560",
|
|
"text": " If pname:dstImage has a <a href=\"#formats-requiring-sampler-ycbcr-conversion\">multi-planar format</a>, then for each element of <code>pRegions</code>, <code>imageSubresource.aspectMask</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_ASPECT_PLANE_0_BIT</code>, <code>VK_IMAGE_ASPECT_PLANE_1_BIT</code>, or <code>VK_IMAGE_ASPECT_PLANE_2_BIT</code> (with <code>VK_IMAGE_ASPECT_PLANE_2_BIT</code> valid only for image formats with three planes)"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdCopyImageToBuffer2": {
|
|
"(VK_VERSION_1_3,VK_KHR_copy_commands2)+(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImageToBuffer2-commandBuffer-01831",
|
|
"text": " If <code>commandBuffer</code> is an unprotected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, <code>srcImage</code> <strong class=\"purple\">must</strong> not be a protected image"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImageToBuffer2-commandBuffer-01832",
|
|
"text": " If <code>commandBuffer</code> is an unprotected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, <code>dstBuffer</code> <strong class=\"purple\">must</strong> not be a protected buffer"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImageToBuffer2-commandBuffer-01833",
|
|
"text": " If <code>commandBuffer</code> is a protected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, <code>dstBuffer</code> <strong class=\"purple\">must</strong> not be an unprotected buffer"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_copy_commands2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImageToBuffer2-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImageToBuffer2-pCopyImageToBufferInfo-parameter",
|
|
"text": " <code>pCopyImageToBufferInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkCopyImageToBufferInfo2\">VkCopyImageToBufferInfo2</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImageToBuffer2-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImageToBuffer2-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support transfer, graphics, or compute operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImageToBuffer2-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyImageToBuffer2-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
]
|
|
},
|
|
"VkCopyImageToBufferInfo2": {
|
|
"(VK_VERSION_1_3,VK_KHR_copy_commands2)+!(VK_QCOM_rotated_copy_commands)": [
|
|
{
|
|
"vuid": "VUID-VkCopyImageToBufferInfo2-pRegions-00182",
|
|
"text": " The image region specified by each element of <code>pRegions</code> <strong class=\"purple\">must</strong> be contained within the specified <code>imageSubresource</code> of <code>srcImage</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_copy_commands2)+(VK_QCOM_rotated_copy_commands)": [
|
|
{
|
|
"vuid": "VUID-VkCopyImageToBufferInfo2-pRegions-04566",
|
|
"text": " If the image region specified by each element of <code>pRegions</code> does not contain <a href=\"#VkCopyCommandTransformInfoQCOM\">VkCopyCommandTransformInfoQCOM</a> in its <code>pNext</code> chain, it <strong class=\"purple\">must</strong> be contained within the specified <code>imageSubresource</code> of <code>srcImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageToBufferInfo2KHR-pRegions-04557",
|
|
"text": " If the image region specified by each element of <code>pRegions</code> contains <a href=\"#VkCopyCommandTransformInfoQCOM\">VkCopyCommandTransformInfoQCOM</a> in its <code>pNext</code> chain, the rotated source region as described in <a href=\"#copies-buffers-images-rotation-addressing\">Buffer and Image Addressing with Rotation</a> <strong class=\"purple\">must</strong> be contained within <code>srcImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageToBufferInfo2KHR-pRegions-04558",
|
|
"text": " If any element of <code>pRegions</code> contains <a href=\"#VkCopyCommandTransformInfoQCOM\">VkCopyCommandTransformInfoQCOM</a> in its <code>pNext</code> chain, then <code>srcImage</code> <strong class=\"purple\">must</strong> not be a <a href=\"#blocked-image\">blocked image</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageToBufferInfo2KHR-pRegions-06205",
|
|
"text": " If any element of <code>pRegions</code> contains <a href=\"#VkCopyCommandTransformInfoQCOM\">VkCopyCommandTransformInfoQCOM</a> in its <code>pNext</code> chain, then <code>srcImage</code> <strong class=\"purple\">must</strong> be of type <code>VK_IMAGE_TYPE_2D</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageToBufferInfo2KHR-pRegions-06206",
|
|
"text": " If any element of <code>pRegions</code> contains <a href=\"#VkCopyCommandTransformInfoQCOM\">VkCopyCommandTransformInfoQCOM</a> in its <code>pNext</code> chain, then <code>srcImage</code> <strong class=\"purple\">must</strong> not have a <a href=\"#formats-requiring-sampler-ycbcr-conversion\">multi-planar format</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_copy_commands2)": [
|
|
{
|
|
"vuid": "VUID-VkCopyImageToBufferInfo2-pRegions-00183",
|
|
"text": " <code>dstBuffer</code> <strong class=\"purple\">must</strong> be large enough to contain all buffer locations that are accessed according to <a href=\"#copies-buffers-images-addressing\">Buffer and Image Addressing</a>, for each element of <code>pRegions</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageToBufferInfo2-pRegions-00184",
|
|
"text": " The union of all source regions, and the union of all destination regions, specified by the elements of <code>pRegions</code>, <strong class=\"purple\">must</strong> not overlap in memory"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageToBufferInfo2-srcImage-00186",
|
|
"text": " <code>srcImage</code> <strong class=\"purple\">must</strong> have been created with <code>VK_IMAGE_USAGE_TRANSFER_SRC_BIT</code> usage flag"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageToBufferInfo2-srcImage-00187",
|
|
"text": " If <code>srcImage</code> is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageToBufferInfo2-dstBuffer-00191",
|
|
"text": " <code>dstBuffer</code> <strong class=\"purple\">must</strong> have been created with <code>VK_BUFFER_USAGE_TRANSFER_DST_BIT</code> usage flag"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageToBufferInfo2-dstBuffer-00192",
|
|
"text": " If <code>dstBuffer</code> is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageToBufferInfo2-srcImage-00188",
|
|
"text": " <code>srcImage</code> <strong class=\"purple\">must</strong> have a sample count equal to <code>VK_SAMPLE_COUNT_1_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageToBufferInfo2-srcImageLayout-00189",
|
|
"text": " <code>srcImageLayout</code> <strong class=\"purple\">must</strong> specify the layout of the image subresources of <code>srcImage</code> specified in <code>pRegions</code> at the time this command is executed on a <code>VkDevice</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageToBufferInfo2-imageSubresource-01703",
|
|
"text": " The <code>imageSubresource.mipLevel</code> member of each element of <code>pRegions</code> <strong class=\"purple\">must</strong> be less than the <code>mipLevels</code> specified in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> when <code>srcImage</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageToBufferInfo2-imageSubresource-01704",
|
|
"text": " The <span class=\"eq\"><code>imageSubresource.baseArrayLayer</code> + <code>imageSubresource.layerCount</code></span> of each element of <code>pRegions</code> <strong class=\"purple\">must</strong> be less than or equal to the <code>arrayLayers</code> specified in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> when <code>srcImage</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageToBufferInfo2-imageOffset-01794",
|
|
"text": " The <code>imageOffset</code> and <code>imageExtent</code> members of each element of <code>pRegions</code> <strong class=\"purple\">must</strong> respect the image transfer granularity requirements of <code>commandBuffer</code>’s command pool’s queue family, as described in <a href=\"#VkQueueFamilyProperties\">VkQueueFamilyProperties</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageToBufferInfo2-imageOffset-00197",
|
|
"text": " For each element of <code>pRegions</code> not containing <code>VkCopyCommandTransformInfoQCOM</code> in its <code>pNext</code> chain, <code>imageOffset.x</code> and <span class=\"eq\">(<code>imageExtent.width</code> + <code>imageOffset.x</code>)</span> <strong class=\"purple\">must</strong> both be greater than or equal to <code>0</code> and less than or equal to the width of the specified <code>imageSubresource</code> of <code>srcImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageToBufferInfo2-imageOffset-00198",
|
|
"text": " For each element of <code>pRegions</code> not containing <code>VkCopyCommandTransformInfoQCOM</code> in its <code>pNext</code> chain, <code>imageOffset.y</code> and <span class=\"eq\">(<code>imageExtent.height</code> + <code>imageOffset.y</code>)</span> <strong class=\"purple\">must</strong> both be greater than or equal to <code>0</code> and less than or equal to the height of the specified <code>imageSubresource</code> of <code>srcImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageToBufferInfo2-srcImage-00199",
|
|
"text": " If pname:srcImage is of type <code>VK_IMAGE_TYPE_1D</code>, then for each element of <code>pRegions</code>, <code>imageOffset.y</code> <strong class=\"purple\">must</strong> be <code>0</code> and <code>imageExtent.height</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageToBufferInfo2-imageOffset-00200",
|
|
"text": " For each element of <code>pRegions</code>, <code>imageOffset.z</code> and <span class=\"eq\">(<code>imageExtent.depth</code> + <code>imageOffset.z</code>)</span> <strong class=\"purple\">must</strong> both be greater than or equal to <code>0</code> and less than or equal to the depth of the specified <code>imageSubresource</code> of pname:srcImage"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageToBufferInfo2-srcImage-00201",
|
|
"text": " If pname:srcImage is of type <code>VK_IMAGE_TYPE_1D</code> or <code>VK_IMAGE_TYPE_2D</code>, then for each element of <code>pRegions</code>, <code>imageOffset.z</code> <strong class=\"purple\">must</strong> be <code>0</code> and <code>imageExtent.depth</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageToBufferInfo2-bufferRowLength-00203",
|
|
"text": " If pname:srcImage is a <a href=\"#blocked-image\">blocked image</a>, for each element of <code>pRegions</code>, <code>bufferRowLength</code> <strong class=\"purple\">must</strong> be a multiple of the compressed texel block width"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageToBufferInfo2-bufferImageHeight-00204",
|
|
"text": " If pname:srcImage is a <a href=\"#blocked-image\">blocked image</a>, for each element of <code>pRegions</code>, <code>bufferImageHeight</code> <strong class=\"purple\">must</strong> be a multiple of the compressed texel block height"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageToBufferInfo2-imageOffset-00205",
|
|
"text": " If pname:srcImage is a <a href=\"#blocked-image\">blocked image</a>, for each element of <code>pRegions</code>, all members of <code>imageOffset</code> <strong class=\"purple\">must</strong> be a multiple of the corresponding dimensions of the compressed texel block"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageToBufferInfo2-bufferOffset-00206",
|
|
"text": " If pname:srcImage is a <a href=\"#blocked-image\">blocked image</a>, for each element of <code>pRegions</code>, <code>bufferOffset</code> <strong class=\"purple\">must</strong> be a multiple of the compressed texel block size in bytes"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageToBufferInfo2-imageExtent-00207",
|
|
"text": " If pname:srcImage is a <a href=\"#blocked-image\">blocked image</a>, for each element of <code>pRegions</code>, <code>imageExtent.width</code> <strong class=\"purple\">must</strong> be a multiple of the compressed texel block width or <span class=\"eq\">(<code>imageExtent.width</code> + <code>imageOffset.x</code>)</span> <strong class=\"purple\">must</strong> equal the width of the specified <code>imageSubresource</code> of pname:srcImage"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageToBufferInfo2-imageExtent-00208",
|
|
"text": " If pname:srcImage is a <a href=\"#blocked-image\">blocked image</a>, for each element of <code>pRegions</code>, <code>imageExtent.height</code> <strong class=\"purple\">must</strong> be a multiple of the compressed texel block height or <span class=\"eq\">(<code>imageExtent.height</code> + <code>imageOffset.y</code>)</span> <strong class=\"purple\">must</strong> equal the height of the specified <code>imageSubresource</code> of pname:srcImage"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageToBufferInfo2-imageExtent-00209",
|
|
"text": " If pname:srcImage is a <a href=\"#blocked-image\">blocked image</a>, for each element of <code>pRegions</code>, <code>imageExtent.depth</code> <strong class=\"purple\">must</strong> be a multiple of the compressed texel block depth or <span class=\"eq\">(<code>imageExtent.depth</code> + <code>imageOffset.z</code>)</span> <strong class=\"purple\">must</strong> equal the depth of the specified <code>imageSubresource</code> of pname:srcImage"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageToBufferInfo2-aspectMask-00211",
|
|
"text": " For each element of <code>pRegions</code>, <code>imageSubresource.aspectMask</code> <strong class=\"purple\">must</strong> specify aspects present in pname:srcImage"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageToBufferInfo2-baseArrayLayer-00213",
|
|
"text": " If pname:srcImage is of type <code>VK_IMAGE_TYPE_3D</code>, for each element of <code>pRegions</code>, <code>imageSubresource.baseArrayLayer</code> <strong class=\"purple\">must</strong> be <code>0</code> and <code>imageSubresource.layerCount</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageToBufferInfo2-pRegions-04725",
|
|
"text": " If pname:srcImage is not a <a href=\"#blocked-image\">blocked image</a>, for each element of <code>pRegions</code>, <code>bufferRowLength</code> multiplied by the texel block size of pname:srcImage <strong class=\"purple\">must</strong> be less than or equal to <span class=\"eq\">2<sup>31</sup>-1</span>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageToBufferInfo2-pRegions-04726",
|
|
"text": " If pname:srcImage is a <a href=\"#blocked-image\">blocked image</a>, for each element of <code>pRegions</code>, <code>bufferRowLength</code> divided by the compressed texel block width and then multiplied by the texel block size of pname:srcImage <strong class=\"purple\">must</strong> be less than or equal to <span class=\"eq\">2<sup>31</sup>-1</span>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageToBufferInfo2-commandBuffer-04052",
|
|
"text": " If the queue family used to create the <a href=\"#VkCommandPool\">VkCommandPool</a> which <code>commandBuffer</code> was allocated from does not support <code>VK_QUEUE_GRAPHICS_BIT</code> or <code>VK_QUEUE_COMPUTE_BIT</code>, the <code>bufferOffset</code> member of any element of <code>pRegions</code> <strong class=\"purple\">must</strong> be a multiple of <code>4</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageToBufferInfo2-srcImage-04053",
|
|
"text": " If pname:srcImage has a depth/stencil format, the <code>bufferOffset</code> member of any element of <code>pRegions</code> <strong class=\"purple\">must</strong> be a multiple of <code>4</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageToBufferInfo2-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_COPY_IMAGE_TO_BUFFER_INFO_2</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageToBufferInfo2-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageToBufferInfo2-srcImage-parameter",
|
|
"text": " <code>srcImage</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImage\">VkImage</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageToBufferInfo2-srcImageLayout-parameter",
|
|
"text": " <code>srcImageLayout</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageLayout\">VkImageLayout</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageToBufferInfo2-dstBuffer-parameter",
|
|
"text": " <code>dstBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBuffer\">VkBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageToBufferInfo2-pRegions-parameter",
|
|
"text": " <code>pRegions</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>regionCount</code> valid <a href=\"#VkBufferImageCopy2\">VkBufferImageCopy2</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageToBufferInfo2-regionCount-arraylength",
|
|
"text": " <code>regionCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageToBufferInfo2-commonparent",
|
|
"text": " Both of <code>dstBuffer</code>, and <code>srcImage</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_copy_commands2)+(VK_VERSION_1_1,VK_KHR_maintenance1)": [
|
|
{
|
|
"vuid": "VUID-VkCopyImageToBufferInfo2-srcImage-01998",
|
|
"text": " The <a href=\"#resources-image-format-features\">format features</a> of <code>srcImage</code> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_TRANSFER_SRC_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_copy_commands2)+!(VK_KHR_shared_presentable_image)": [
|
|
{
|
|
"vuid": "VUID-VkCopyImageToBufferInfo2-srcImageLayout-00190",
|
|
"text": " <code>srcImageLayout</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_LAYOUT_TRANSFER_SRC_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_GENERAL</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_copy_commands2)+(VK_KHR_shared_presentable_image)": [
|
|
{
|
|
"vuid": "VUID-VkCopyImageToBufferInfo2-srcImageLayout-01397",
|
|
"text": " <code>srcImageLayout</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_LAYOUT_TRANSFER_SRC_OPTIMAL</code>, <code>VK_IMAGE_LAYOUT_GENERAL</code>, or <code>VK_IMAGE_LAYOUT_SHARED_PRESENT_KHR</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_copy_commands2)+(VK_EXT_fragment_density_map)": [
|
|
{
|
|
"vuid": "VUID-VkCopyImageToBufferInfo2-srcImage-02544",
|
|
"text": " <code>srcImage</code> <strong class=\"purple\">must</strong> not have been created with <code>flags</code> containing <code>VK_IMAGE_CREATE_SUBSAMPLED_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_copy_commands2)+!(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-VkCopyImageToBufferInfo2-bufferOffset-00193",
|
|
"text": " If pname:srcImage does not have a depth/stencil format, then for each element of <code>pRegions</code>, <code>bufferOffset</code> <strong class=\"purple\">must</strong> be a multiple of the format’s texel block size"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_copy_commands2)+(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-VkCopyImageToBufferInfo2-bufferOffset-01558",
|
|
"text": " If pname:srcImage does not have either a depth/stencil or a <a href=\"#formats-requiring-sampler-ycbcr-conversion\">multi-planar format</a>, then for each element of <code>pRegions</code>, <code>bufferOffset</code> <strong class=\"purple\">must</strong> be a multiple of the format’s texel block size"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageToBufferInfo2-bufferOffset-01559",
|
|
"text": " If pname:srcImage has a <a href=\"#formats-requiring-sampler-ycbcr-conversion\">multi-planar format</a>, then for each element of <code>pRegions</code>, <code>bufferOffset</code> <strong class=\"purple\">must</strong> be a multiple of the element size of the compatible format for the format and the <code>aspectMask</code> of the <code>imageSubresource</code> as defined in <a href=\"#formats-compatible-planes\">Compatible formats of planes of multi-planar formats</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyImageToBufferInfo2-aspectMask-01560",
|
|
"text": " If pname:srcImage has a <a href=\"#formats-requiring-sampler-ycbcr-conversion\">multi-planar format</a>, then for each element of <code>pRegions</code>, <code>imageSubresource.aspectMask</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_ASPECT_PLANE_0_BIT</code>, <code>VK_IMAGE_ASPECT_PLANE_1_BIT</code>, or <code>VK_IMAGE_ASPECT_PLANE_2_BIT</code> (with <code>VK_IMAGE_ASPECT_PLANE_2_BIT</code> valid only for image formats with three planes)"
|
|
}
|
|
]
|
|
},
|
|
"VkBufferImageCopy2": {
|
|
"(VK_VERSION_1_3,VK_KHR_copy_commands2)": [
|
|
{
|
|
"vuid": "VUID-VkBufferImageCopy2-bufferRowLength-00195",
|
|
"text": " <code>bufferRowLength</code> <strong class=\"purple\">must</strong> be <code>0</code>, or greater than or equal to the <code>width</code> member of <code>imageExtent</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferImageCopy2-bufferImageHeight-00196",
|
|
"text": " <code>bufferImageHeight</code> <strong class=\"purple\">must</strong> be <code>0</code>, or greater than or equal to the <code>height</code> member of <code>imageExtent</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferImageCopy2-aspectMask-00212",
|
|
"text": " The <code>aspectMask</code> member of <code>imageSubresource</code> <strong class=\"purple\">must</strong> only have a single bit set"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferImageCopy2-imageExtent-06659",
|
|
"text": " <code>imageExtent.width</code> <strong class=\"purple\">must</strong> not be 0"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferImageCopy2-imageExtent-06660",
|
|
"text": " <code>imageExtent.height</code> <strong class=\"purple\">must</strong> not be 0"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferImageCopy2-imageExtent-06661",
|
|
"text": " <code>imageExtent.depth</code> <strong class=\"purple\">must</strong> not be 0"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferImageCopy2-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_BUFFER_IMAGE_COPY_2</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferImageCopy2-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkCopyCommandTransformInfoQCOM\">VkCopyCommandTransformInfoQCOM</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferImageCopy2-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBufferImageCopy2-imageSubresource-parameter",
|
|
"text": " <code>imageSubresource</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageSubresourceLayers\">VkImageSubresourceLayers</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkCopyCommandTransformInfoQCOM": {
|
|
"(VK_QCOM_rotated_copy_commands)": [
|
|
{
|
|
"vuid": "VUID-VkCopyCommandTransformInfoQCOM-transform-04560",
|
|
"text": " <code>transform</code> <strong class=\"purple\">must</strong> be <code>VK_SURFACE_TRANSFORM_IDENTITY_BIT_KHR</code>, <code>VK_SURFACE_TRANSFORM_ROTATE_90_BIT_KHR</code>, <code>VK_SURFACE_TRANSFORM_ROTATE_180_BIT_KHR</code>, or <code>VK_SURFACE_TRANSFORM_ROTATE_270_BIT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyCommandTransformInfoQCOM-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_COPY_COMMAND_TRANSFORM_INFO_QCOM</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdBlitImage": {
|
|
"(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage-commandBuffer-01834",
|
|
"text": " If <code>commandBuffer</code> is an unprotected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, <code>srcImage</code> <strong class=\"purple\">must</strong> not be a protected image"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage-commandBuffer-01835",
|
|
"text": " If <code>commandBuffer</code> is an unprotected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, <code>dstImage</code> <strong class=\"purple\">must</strong> not be a protected image"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage-commandBuffer-01836",
|
|
"text": " If <code>commandBuffer</code> is a protected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, <code>dstImage</code> <strong class=\"purple\">must</strong> not be an unprotected image"
|
|
}
|
|
],
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage-pRegions-00215",
|
|
"text": " The source region specified by each element of <code>pRegions</code> <strong class=\"purple\">must</strong> be a region that is contained within <code>srcImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage-pRegions-00216",
|
|
"text": " The destination region specified by each element of <code>pRegions</code> <strong class=\"purple\">must</strong> be a region that is contained within <code>dstImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage-pRegions-00217",
|
|
"text": " The union of all destination regions, specified by the elements of <code>pRegions</code>, <strong class=\"purple\">must</strong> not overlap in memory with any texel that <strong class=\"purple\">may</strong> be sampled during the blit operation"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage-srcImage-01999",
|
|
"text": " The <a href=\"#resources-image-format-features\">format features</a> of <code>srcImage</code> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_BLIT_SRC_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage-srcImage-00219",
|
|
"text": " <code>srcImage</code> <strong class=\"purple\">must</strong> have been created with <code>VK_IMAGE_USAGE_TRANSFER_SRC_BIT</code> usage flag"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage-srcImage-00220",
|
|
"text": " If <code>srcImage</code> is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage-srcImageLayout-00221",
|
|
"text": " <code>srcImageLayout</code> <strong class=\"purple\">must</strong> specify the layout of the image subresources of <code>srcImage</code> specified in <code>pRegions</code> at the time this command is executed on a <code>VkDevice</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage-dstImage-02000",
|
|
"text": " The <a href=\"#resources-image-format-features\">format features</a> of <code>dstImage</code> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_BLIT_DST_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage-dstImage-00224",
|
|
"text": " <code>dstImage</code> <strong class=\"purple\">must</strong> have been created with <code>VK_IMAGE_USAGE_TRANSFER_DST_BIT</code> usage flag"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage-dstImage-00225",
|
|
"text": " If <code>dstImage</code> is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage-dstImageLayout-00226",
|
|
"text": " <code>dstImageLayout</code> <strong class=\"purple\">must</strong> specify the layout of the image subresources of <code>dstImage</code> specified in <code>pRegions</code> at the time this command is executed on a <code>VkDevice</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage-srcImage-00229",
|
|
"text": " If either of <code>srcImage</code> or <code>dstImage</code> was created with a signed integer <a href=\"#VkFormat\">VkFormat</a>, the other <strong class=\"purple\">must</strong> also have been created with a signed integer <a href=\"#VkFormat\">VkFormat</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage-srcImage-00230",
|
|
"text": " If either of <code>srcImage</code> or <code>dstImage</code> was created with an unsigned integer <a href=\"#VkFormat\">VkFormat</a>, the other <strong class=\"purple\">must</strong> also have been created with an unsigned integer <a href=\"#VkFormat\">VkFormat</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage-srcImage-00231",
|
|
"text": " If either of <code>srcImage</code> or <code>dstImage</code> was created with a depth/stencil format, the other <strong class=\"purple\">must</strong> have exactly the same format"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage-srcImage-00232",
|
|
"text": " If <code>srcImage</code> was created with a depth/stencil format, <code>filter</code> <strong class=\"purple\">must</strong> be <code>VK_FILTER_NEAREST</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage-srcImage-00233",
|
|
"text": " <code>srcImage</code> <strong class=\"purple\">must</strong> have been created with a <code>samples</code> value of <code>VK_SAMPLE_COUNT_1_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage-dstImage-00234",
|
|
"text": " <code>dstImage</code> <strong class=\"purple\">must</strong> have been created with a <code>samples</code> value of <code>VK_SAMPLE_COUNT_1_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage-filter-02001",
|
|
"text": " If <code>filter</code> is <code>VK_FILTER_LINEAR</code>, then the <a href=\"#resources-image-format-features\">format features</a> of <code>srcImage</code> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage-srcSubresource-01705",
|
|
"text": " The <code>srcSubresource.mipLevel</code> member of each element of <code>pRegions</code> <strong class=\"purple\">must</strong> be less than the <code>mipLevels</code> specified in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> when <code>srcImage</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage-dstSubresource-01706",
|
|
"text": " The <code>dstSubresource.mipLevel</code> member of each element of <code>pRegions</code> <strong class=\"purple\">must</strong> be less than the <code>mipLevels</code> specified in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> when <code>dstImage</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage-srcSubresource-01707",
|
|
"text": " The <span class=\"eq\"><code>srcSubresource.baseArrayLayer</code> + <code>srcSubresource.layerCount</code></span> of each element of <code>pRegions</code> <strong class=\"purple\">must</strong> be less than or equal to the <code>arrayLayers</code> specified in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> when <code>srcImage</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage-dstSubresource-01708",
|
|
"text": " The <span class=\"eq\"><code>dstSubresource.baseArrayLayer</code> + <code>dstSubresource.layerCount</code></span> of each element of <code>pRegions</code> <strong class=\"purple\">must</strong> be less than or equal to the <code>arrayLayers</code> specified in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> when <code>dstImage</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage-srcImage-00240",
|
|
"text": " If either <code>srcImage</code> or <code>dstImage</code> is of type <code>VK_IMAGE_TYPE_3D</code>, then for each element of <code>pRegions</code>, <code>srcSubresource.baseArrayLayer</code> and <code>dstSubresource.baseArrayLayer</code> <strong class=\"purple\">must</strong> each be <code>0</code>, and <code>srcSubresource.layerCount</code> and <code>dstSubresource.layerCount</code> <strong class=\"purple\">must</strong> each be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage-aspectMask-00241",
|
|
"text": " For each element of <code>pRegions</code>, <code>srcSubresource.aspectMask</code> <strong class=\"purple\">must</strong> specify aspects present in <code>srcImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage-aspectMask-00242",
|
|
"text": " For each element of <code>pRegions</code>, <code>dstSubresource.aspectMask</code> <strong class=\"purple\">must</strong> specify aspects present in <code>dstImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage-srcOffset-00243",
|
|
"text": " For each element of <code>pRegions</code>, <code>srcOffsets</code>[0].x and <code>srcOffsets</code>[1].x <strong class=\"purple\">must</strong> both be greater than or equal to <code>0</code> and less than or equal to the width of the specified <code>srcSubresource</code> of <code>srcImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage-srcOffset-00244",
|
|
"text": " For each element of <code>pRegions</code>, <code>srcOffsets</code>[0].y and <code>srcOffsets</code>[1].y <strong class=\"purple\">must</strong> both be greater than or equal to <code>0</code> and less than or equal to the height of the specified <code>srcSubresource</code> of <code>srcImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage-srcImage-00245",
|
|
"text": " If <code>srcImage</code> is of type <code>VK_IMAGE_TYPE_1D</code>, then for each element of <code>pRegions</code>, <code>srcOffsets</code>[0].y <strong class=\"purple\">must</strong> be <code>0</code> and <code>srcOffsets</code>[1].y <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage-srcOffset-00246",
|
|
"text": " For each element of <code>pRegions</code>, <code>srcOffsets</code>[0].z and <code>srcOffsets</code>[1].z <strong class=\"purple\">must</strong> both be greater than or equal to <code>0</code> and less than or equal to the depth of the specified <code>srcSubresource</code> of <code>srcImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage-srcImage-00247",
|
|
"text": " If <code>srcImage</code> is of type <code>VK_IMAGE_TYPE_1D</code> or <code>VK_IMAGE_TYPE_2D</code>, then for each element of <code>pRegions</code>, <code>srcOffsets</code>[0].z <strong class=\"purple\">must</strong> be <code>0</code> and <code>srcOffsets</code>[1].z <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage-dstOffset-00248",
|
|
"text": " For each element of <code>pRegions</code>, <code>dstOffsets</code>[0].x and <code>dstOffsets</code>[1].x <strong class=\"purple\">must</strong> both be greater than or equal to <code>0</code> and less than or equal to the width of the specified <code>dstSubresource</code> of <code>dstImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage-dstOffset-00249",
|
|
"text": " For each element of <code>pRegions</code>, <code>dstOffsets</code>[0].y and <code>dstOffsets</code>[1].y <strong class=\"purple\">must</strong> both be greater than or equal to <code>0</code> and less than or equal to the height of the specified <code>dstSubresource</code> of <code>dstImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage-dstImage-00250",
|
|
"text": " If <code>dstImage</code> is of type <code>VK_IMAGE_TYPE_1D</code>, then for each element of <code>pRegions</code>, <code>dstOffsets</code>[0].y <strong class=\"purple\">must</strong> be <code>0</code> and <code>dstOffsets</code>[1].y <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage-dstOffset-00251",
|
|
"text": " For each element of <code>pRegions</code>, <code>dstOffsets</code>[0].z and <code>dstOffsets</code>[1].z <strong class=\"purple\">must</strong> both be greater than or equal to <code>0</code> and less than or equal to the depth of the specified <code>dstSubresource</code> of <code>dstImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage-dstImage-00252",
|
|
"text": " If <code>dstImage</code> is of type <code>VK_IMAGE_TYPE_1D</code> or <code>VK_IMAGE_TYPE_2D</code>, then for each element of <code>pRegions</code>, <code>dstOffsets</code>[0].z <strong class=\"purple\">must</strong> be <code>0</code> and <code>dstOffsets</code>[1].z <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage-srcImage-parameter",
|
|
"text": " <code>srcImage</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImage\">VkImage</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage-srcImageLayout-parameter",
|
|
"text": " <code>srcImageLayout</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageLayout\">VkImageLayout</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage-dstImage-parameter",
|
|
"text": " <code>dstImage</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImage\">VkImage</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage-dstImageLayout-parameter",
|
|
"text": " <code>dstImageLayout</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageLayout\">VkImageLayout</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage-pRegions-parameter",
|
|
"text": " <code>pRegions</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>regionCount</code> valid <a href=\"#VkImageBlit\">VkImageBlit</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage-filter-parameter",
|
|
"text": " <code>filter</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkFilter\">VkFilter</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage-regionCount-arraylength",
|
|
"text": " <code>regionCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage-commonparent",
|
|
"text": " Each of <code>commandBuffer</code>, <code>dstImage</code>, and <code>srcImage</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage-srcImage-06421",
|
|
"text": " <code>srcImage</code> <strong class=\"purple\">must</strong> not use a <a href=\"#formats-requiring-sampler-ycbcr-conversion\">format that requires a sampler {YCbCr} conversion</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage-dstImage-06422",
|
|
"text": " <code>dstImage</code> <strong class=\"purple\">must</strong> not use a <a href=\"#formats-requiring-sampler-ycbcr-conversion\">format that requires a sampler {YCbCr} conversion</a>"
|
|
}
|
|
],
|
|
"!(VK_KHR_shared_presentable_image)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage-srcImageLayout-00222",
|
|
"text": " <code>srcImageLayout</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_LAYOUT_TRANSFER_SRC_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_GENERAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage-dstImageLayout-00227",
|
|
"text": " <code>dstImageLayout</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_LAYOUT_TRANSFER_DST_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_GENERAL</code>"
|
|
}
|
|
],
|
|
"(VK_KHR_shared_presentable_image)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage-srcImageLayout-01398",
|
|
"text": " <code>srcImageLayout</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_LAYOUT_SHARED_PRESENT_KHR</code>, <code>VK_IMAGE_LAYOUT_TRANSFER_SRC_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_GENERAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage-dstImageLayout-01399",
|
|
"text": " <code>dstImageLayout</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_LAYOUT_SHARED_PRESENT_KHR</code>, <code>VK_IMAGE_LAYOUT_TRANSFER_DST_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_GENERAL</code>"
|
|
}
|
|
],
|
|
"(VK_IMG_filter_cubic,VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage-filter-02002",
|
|
"text": " If <code>filter</code> is <code>VK_FILTER_CUBIC_EXT</code>, then the <a href=\"#resources-image-format-features\">format features</a> of <code>srcImage</code> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_CUBIC_BIT_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage-filter-00237",
|
|
"text": " If <code>filter</code> is <code>VK_FILTER_CUBIC_EXT</code>, <code>srcImage</code> <strong class=\"purple\">must</strong> be of type <code>VK_IMAGE_TYPE_2D</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_fragment_density_map)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage-dstImage-02545",
|
|
"text": " <code>dstImage</code> and <code>srcImage</code> <strong class=\"purple\">must</strong> not have been created with <code>flags</code> containing <code>VK_IMAGE_CREATE_SUBSAMPLED_BIT_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkImageBlit": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkImageBlit-aspectMask-00238",
|
|
"text": " The <code>aspectMask</code> member of <code>srcSubresource</code> and <code>dstSubresource</code> <strong class=\"purple\">must</strong> match"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageBlit-layerCount-00239",
|
|
"text": " The <code>layerCount</code> member of <code>srcSubresource</code> and <code>dstSubresource</code> <strong class=\"purple\">must</strong> match"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageBlit-srcSubresource-parameter",
|
|
"text": " <code>srcSubresource</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageSubresourceLayers\">VkImageSubresourceLayers</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageBlit-dstSubresource-parameter",
|
|
"text": " <code>dstSubresource</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageSubresourceLayers\">VkImageSubresourceLayers</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdBlitImage2": {
|
|
"(VK_VERSION_1_3,VK_KHR_copy_commands2)+(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage2-commandBuffer-01834",
|
|
"text": " If <code>commandBuffer</code> is an unprotected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, <code>srcImage</code> <strong class=\"purple\">must</strong> not be a protected image"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage2-commandBuffer-01835",
|
|
"text": " If <code>commandBuffer</code> is an unprotected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, <code>dstImage</code> <strong class=\"purple\">must</strong> not be a protected image"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage2-commandBuffer-01836",
|
|
"text": " If <code>commandBuffer</code> is a protected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, <code>dstImage</code> <strong class=\"purple\">must</strong> not be an unprotected image"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_copy_commands2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage2-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage2-pBlitImageInfo-parameter",
|
|
"text": " <code>pBlitImageInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkBlitImageInfo2\">VkBlitImageInfo2</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage2-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage2-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage2-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBlitImage2-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
]
|
|
},
|
|
"VkBlitImageInfo2": {
|
|
"(VK_VERSION_1_3,VK_KHR_copy_commands2)": [
|
|
{
|
|
"vuid": "VUID-VkBlitImageInfo2-pRegions-00215",
|
|
"text": " The source region specified by each element of <code>pRegions</code> <strong class=\"purple\">must</strong> be a region that is contained within <code>srcImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBlitImageInfo2-pRegions-00216",
|
|
"text": " The destination region specified by each element of <code>pRegions</code> <strong class=\"purple\">must</strong> be a region that is contained within <code>dstImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBlitImageInfo2-pRegions-00217",
|
|
"text": " The union of all destination regions, specified by the elements of <code>pRegions</code>, <strong class=\"purple\">must</strong> not overlap in memory with any texel that <strong class=\"purple\">may</strong> be sampled during the blit operation"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBlitImageInfo2-srcImage-01999",
|
|
"text": " The <a href=\"#resources-image-format-features\">format features</a> of <code>srcImage</code> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_BLIT_SRC_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBlitImageInfo2-srcImage-00219",
|
|
"text": " <code>srcImage</code> <strong class=\"purple\">must</strong> have been created with <code>VK_IMAGE_USAGE_TRANSFER_SRC_BIT</code> usage flag"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBlitImageInfo2-srcImage-00220",
|
|
"text": " If <code>srcImage</code> is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBlitImageInfo2-srcImageLayout-00221",
|
|
"text": " <code>srcImageLayout</code> <strong class=\"purple\">must</strong> specify the layout of the image subresources of <code>srcImage</code> specified in <code>pRegions</code> at the time this command is executed on a <code>VkDevice</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBlitImageInfo2-dstImage-02000",
|
|
"text": " The <a href=\"#resources-image-format-features\">format features</a> of <code>dstImage</code> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_BLIT_DST_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBlitImageInfo2-dstImage-00224",
|
|
"text": " <code>dstImage</code> <strong class=\"purple\">must</strong> have been created with <code>VK_IMAGE_USAGE_TRANSFER_DST_BIT</code> usage flag"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBlitImageInfo2-dstImage-00225",
|
|
"text": " If <code>dstImage</code> is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBlitImageInfo2-dstImageLayout-00226",
|
|
"text": " <code>dstImageLayout</code> <strong class=\"purple\">must</strong> specify the layout of the image subresources of <code>dstImage</code> specified in <code>pRegions</code> at the time this command is executed on a <code>VkDevice</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBlitImageInfo2-srcImage-00229",
|
|
"text": " If either of <code>srcImage</code> or <code>dstImage</code> was created with a signed integer <a href=\"#VkFormat\">VkFormat</a>, the other <strong class=\"purple\">must</strong> also have been created with a signed integer <a href=\"#VkFormat\">VkFormat</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBlitImageInfo2-srcImage-00230",
|
|
"text": " If either of <code>srcImage</code> or <code>dstImage</code> was created with an unsigned integer <a href=\"#VkFormat\">VkFormat</a>, the other <strong class=\"purple\">must</strong> also have been created with an unsigned integer <a href=\"#VkFormat\">VkFormat</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBlitImageInfo2-srcImage-00231",
|
|
"text": " If either of <code>srcImage</code> or <code>dstImage</code> was created with a depth/stencil format, the other <strong class=\"purple\">must</strong> have exactly the same format"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBlitImageInfo2-srcImage-00232",
|
|
"text": " If <code>srcImage</code> was created with a depth/stencil format, <code>filter</code> <strong class=\"purple\">must</strong> be <code>VK_FILTER_NEAREST</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBlitImageInfo2-srcImage-00233",
|
|
"text": " <code>srcImage</code> <strong class=\"purple\">must</strong> have been created with a <code>samples</code> value of <code>VK_SAMPLE_COUNT_1_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBlitImageInfo2-dstImage-00234",
|
|
"text": " <code>dstImage</code> <strong class=\"purple\">must</strong> have been created with a <code>samples</code> value of <code>VK_SAMPLE_COUNT_1_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBlitImageInfo2-filter-02001",
|
|
"text": " If <code>filter</code> is <code>VK_FILTER_LINEAR</code>, then the <a href=\"#resources-image-format-features\">format features</a> of <code>srcImage</code> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBlitImageInfo2-srcSubresource-01705",
|
|
"text": " The <code>srcSubresource.mipLevel</code> member of each element of <code>pRegions</code> <strong class=\"purple\">must</strong> be less than the <code>mipLevels</code> specified in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> when <code>srcImage</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBlitImageInfo2-dstSubresource-01706",
|
|
"text": " The <code>dstSubresource.mipLevel</code> member of each element of <code>pRegions</code> <strong class=\"purple\">must</strong> be less than the <code>mipLevels</code> specified in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> when <code>dstImage</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBlitImageInfo2-srcSubresource-01707",
|
|
"text": " The <span class=\"eq\"><code>srcSubresource.baseArrayLayer</code> + <code>srcSubresource.layerCount</code></span> of each element of <code>pRegions</code> <strong class=\"purple\">must</strong> be less than or equal to the <code>arrayLayers</code> specified in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> when <code>srcImage</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBlitImageInfo2-dstSubresource-01708",
|
|
"text": " The <span class=\"eq\"><code>dstSubresource.baseArrayLayer</code> + <code>dstSubresource.layerCount</code></span> of each element of <code>pRegions</code> <strong class=\"purple\">must</strong> be less than or equal to the <code>arrayLayers</code> specified in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> when <code>dstImage</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBlitImageInfo2-srcImage-00240",
|
|
"text": " If either <code>srcImage</code> or <code>dstImage</code> is of type <code>VK_IMAGE_TYPE_3D</code>, then for each element of <code>pRegions</code>, <code>srcSubresource.baseArrayLayer</code> and <code>dstSubresource.baseArrayLayer</code> <strong class=\"purple\">must</strong> each be <code>0</code>, and <code>srcSubresource.layerCount</code> and <code>dstSubresource.layerCount</code> <strong class=\"purple\">must</strong> each be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBlitImageInfo2-aspectMask-00241",
|
|
"text": " For each element of <code>pRegions</code>, <code>srcSubresource.aspectMask</code> <strong class=\"purple\">must</strong> specify aspects present in <code>srcImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBlitImageInfo2-aspectMask-00242",
|
|
"text": " For each element of <code>pRegions</code>, <code>dstSubresource.aspectMask</code> <strong class=\"purple\">must</strong> specify aspects present in <code>dstImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBlitImageInfo2-srcOffset-00243",
|
|
"text": " For each element of <code>pRegions</code>, <code>srcOffsets</code>[0].x and <code>srcOffsets</code>[1].x <strong class=\"purple\">must</strong> both be greater than or equal to <code>0</code> and less than or equal to the width of the specified <code>srcSubresource</code> of <code>srcImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBlitImageInfo2-srcOffset-00244",
|
|
"text": " For each element of <code>pRegions</code>, <code>srcOffsets</code>[0].y and <code>srcOffsets</code>[1].y <strong class=\"purple\">must</strong> both be greater than or equal to <code>0</code> and less than or equal to the height of the specified <code>srcSubresource</code> of <code>srcImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBlitImageInfo2-srcImage-00245",
|
|
"text": " If <code>srcImage</code> is of type <code>VK_IMAGE_TYPE_1D</code>, then for each element of <code>pRegions</code>, <code>srcOffsets</code>[0].y <strong class=\"purple\">must</strong> be <code>0</code> and <code>srcOffsets</code>[1].y <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBlitImageInfo2-srcOffset-00246",
|
|
"text": " For each element of <code>pRegions</code>, <code>srcOffsets</code>[0].z and <code>srcOffsets</code>[1].z <strong class=\"purple\">must</strong> both be greater than or equal to <code>0</code> and less than or equal to the depth of the specified <code>srcSubresource</code> of <code>srcImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBlitImageInfo2-srcImage-00247",
|
|
"text": " If <code>srcImage</code> is of type <code>VK_IMAGE_TYPE_1D</code> or <code>VK_IMAGE_TYPE_2D</code>, then for each element of <code>pRegions</code>, <code>srcOffsets</code>[0].z <strong class=\"purple\">must</strong> be <code>0</code> and <code>srcOffsets</code>[1].z <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBlitImageInfo2-dstOffset-00248",
|
|
"text": " For each element of <code>pRegions</code>, <code>dstOffsets</code>[0].x and <code>dstOffsets</code>[1].x <strong class=\"purple\">must</strong> both be greater than or equal to <code>0</code> and less than or equal to the width of the specified <code>dstSubresource</code> of <code>dstImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBlitImageInfo2-dstOffset-00249",
|
|
"text": " For each element of <code>pRegions</code>, <code>dstOffsets</code>[0].y and <code>dstOffsets</code>[1].y <strong class=\"purple\">must</strong> both be greater than or equal to <code>0</code> and less than or equal to the height of the specified <code>dstSubresource</code> of <code>dstImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBlitImageInfo2-dstImage-00250",
|
|
"text": " If <code>dstImage</code> is of type <code>VK_IMAGE_TYPE_1D</code>, then for each element of <code>pRegions</code>, <code>dstOffsets</code>[0].y <strong class=\"purple\">must</strong> be <code>0</code> and <code>dstOffsets</code>[1].y <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBlitImageInfo2-dstOffset-00251",
|
|
"text": " For each element of <code>pRegions</code>, <code>dstOffsets</code>[0].z and <code>dstOffsets</code>[1].z <strong class=\"purple\">must</strong> both be greater than or equal to <code>0</code> and less than or equal to the depth of the specified <code>dstSubresource</code> of <code>dstImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBlitImageInfo2-dstImage-00252",
|
|
"text": " If <code>dstImage</code> is of type <code>VK_IMAGE_TYPE_1D</code> or <code>VK_IMAGE_TYPE_2D</code>, then for each element of <code>pRegions</code>, <code>dstOffsets</code>[0].z <strong class=\"purple\">must</strong> be <code>0</code> and <code>dstOffsets</code>[1].z <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBlitImageInfo2-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_BLIT_IMAGE_INFO_2</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBlitImageInfo2-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBlitImageInfo2-srcImage-parameter",
|
|
"text": " <code>srcImage</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImage\">VkImage</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBlitImageInfo2-srcImageLayout-parameter",
|
|
"text": " <code>srcImageLayout</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageLayout\">VkImageLayout</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBlitImageInfo2-dstImage-parameter",
|
|
"text": " <code>dstImage</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImage\">VkImage</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBlitImageInfo2-dstImageLayout-parameter",
|
|
"text": " <code>dstImageLayout</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageLayout\">VkImageLayout</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBlitImageInfo2-pRegions-parameter",
|
|
"text": " <code>pRegions</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>regionCount</code> valid <a href=\"#VkImageBlit2\">VkImageBlit2</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBlitImageInfo2-filter-parameter",
|
|
"text": " <code>filter</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkFilter\">VkFilter</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBlitImageInfo2-regionCount-arraylength",
|
|
"text": " <code>regionCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBlitImageInfo2-commonparent",
|
|
"text": " Both of <code>dstImage</code>, and <code>srcImage</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_copy_commands2)+(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-VkBlitImageInfo2-srcImage-06421",
|
|
"text": " <code>srcImage</code> <strong class=\"purple\">must</strong> not use a <a href=\"#formats-requiring-sampler-ycbcr-conversion\">format that requires a sampler {YCbCr} conversion</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBlitImageInfo2-dstImage-06422",
|
|
"text": " <code>dstImage</code> <strong class=\"purple\">must</strong> not use a <a href=\"#formats-requiring-sampler-ycbcr-conversion\">format that requires a sampler {YCbCr} conversion</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_copy_commands2)+!(VK_KHR_shared_presentable_image)": [
|
|
{
|
|
"vuid": "VUID-VkBlitImageInfo2-srcImageLayout-00222",
|
|
"text": " <code>srcImageLayout</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_LAYOUT_TRANSFER_SRC_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_GENERAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBlitImageInfo2-dstImageLayout-00227",
|
|
"text": " <code>dstImageLayout</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_LAYOUT_TRANSFER_DST_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_GENERAL</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_copy_commands2)+(VK_KHR_shared_presentable_image)": [
|
|
{
|
|
"vuid": "VUID-VkBlitImageInfo2-srcImageLayout-01398",
|
|
"text": " <code>srcImageLayout</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_LAYOUT_SHARED_PRESENT_KHR</code>, <code>VK_IMAGE_LAYOUT_TRANSFER_SRC_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_GENERAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBlitImageInfo2-dstImageLayout-01399",
|
|
"text": " <code>dstImageLayout</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_LAYOUT_SHARED_PRESENT_KHR</code>, <code>VK_IMAGE_LAYOUT_TRANSFER_DST_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_GENERAL</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_copy_commands2)+(VK_IMG_filter_cubic,VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-VkBlitImageInfo2-filter-02002",
|
|
"text": " If <code>filter</code> is <code>VK_FILTER_CUBIC_EXT</code>, then the <a href=\"#resources-image-format-features\">format features</a> of <code>srcImage</code> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_CUBIC_BIT_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBlitImageInfo2-filter-00237",
|
|
"text": " If <code>filter</code> is <code>VK_FILTER_CUBIC_EXT</code>, <code>srcImage</code> <strong class=\"purple\">must</strong> be of type <code>VK_IMAGE_TYPE_2D</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_copy_commands2)+(VK_EXT_fragment_density_map)": [
|
|
{
|
|
"vuid": "VUID-VkBlitImageInfo2-dstImage-02545",
|
|
"text": " <code>dstImage</code> and <code>srcImage</code> <strong class=\"purple\">must</strong> not have been created with <code>flags</code> containing <code>VK_IMAGE_CREATE_SUBSAMPLED_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_copy_commands2)+(VK_QCOM_rotated_copy_commands)": [
|
|
{
|
|
"vuid": "VUID-VkBlitImageInfo2-pRegions-04561",
|
|
"text": " If any element of <code>pRegions</code> contains <a href=\"#VkCopyCommandTransformInfoQCOM\">VkCopyCommandTransformInfoQCOM</a> in its <code>pNext</code> chain, then <code>srcImage</code> and <code>dstImage</code> <strong class=\"purple\">must</strong> not be block-compressed images"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBlitImageInfo2KHR-pRegions-06207",
|
|
"text": " If any element of <code>pRegions</code> contains <a href=\"#VkCopyCommandTransformInfoQCOM\">VkCopyCommandTransformInfoQCOM</a> in its <code>pNext</code> chain, then <code>srcImage</code> <strong class=\"purple\">must</strong> be of type <code>VK_IMAGE_TYPE_2D</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBlitImageInfo2KHR-pRegions-06208",
|
|
"text": " If any element of <code>pRegions</code> contains <a href=\"#VkCopyCommandTransformInfoQCOM\">VkCopyCommandTransformInfoQCOM</a> in its <code>pNext</code> chain, then <code>srcImage</code> <strong class=\"purple\">must</strong> not have a <a href=\"#formats-requiring-sampler-ycbcr-conversion\">multi-planar format</a>"
|
|
}
|
|
]
|
|
},
|
|
"VkImageBlit2": {
|
|
"(VK_VERSION_1_3,VK_KHR_copy_commands2)": [
|
|
{
|
|
"vuid": "VUID-VkImageBlit2-aspectMask-00238",
|
|
"text": " The <code>aspectMask</code> member of <code>srcSubresource</code> and <code>dstSubresource</code> <strong class=\"purple\">must</strong> match"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageBlit2-layerCount-00239",
|
|
"text": " The <code>layerCount</code> member of <code>srcSubresource</code> and <code>dstSubresource</code> <strong class=\"purple\">must</strong> match"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageBlit2-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_IMAGE_BLIT_2</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageBlit2-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkCopyCommandTransformInfoQCOM\">VkCopyCommandTransformInfoQCOM</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageBlit2-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageBlit2-srcSubresource-parameter",
|
|
"text": " <code>srcSubresource</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageSubresourceLayers\">VkImageSubresourceLayers</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageBlit2-dstSubresource-parameter",
|
|
"text": " <code>dstSubresource</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageSubresourceLayers\">VkImageSubresourceLayers</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdResolveImage": {
|
|
"(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-vkCmdResolveImage-commandBuffer-01837",
|
|
"text": " If <code>commandBuffer</code> is an unprotected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, <code>srcImage</code> <strong class=\"purple\">must</strong> not be a protected image"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResolveImage-commandBuffer-01838",
|
|
"text": " If <code>commandBuffer</code> is an unprotected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, <code>dstImage</code> <strong class=\"purple\">must</strong> not be a protected image"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResolveImage-commandBuffer-01839",
|
|
"text": " If <code>commandBuffer</code> is a protected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, <code>dstImage</code> <strong class=\"purple\">must</strong> not be an unprotected image"
|
|
}
|
|
],
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCmdResolveImage-pRegions-00255",
|
|
"text": " The union of all source regions, and the union of all destination regions, specified by the elements of <code>pRegions</code>, <strong class=\"purple\">must</strong> not overlap in memory"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResolveImage-srcImage-00256",
|
|
"text": " If <code>srcImage</code> is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResolveImage-srcImage-00257",
|
|
"text": " <code>srcImage</code> <strong class=\"purple\">must</strong> have a sample count equal to any valid sample count value other than <code>VK_SAMPLE_COUNT_1_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResolveImage-dstImage-00258",
|
|
"text": " If <code>dstImage</code> is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResolveImage-dstImage-00259",
|
|
"text": " <code>dstImage</code> <strong class=\"purple\">must</strong> have a sample count equal to <code>VK_SAMPLE_COUNT_1_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResolveImage-srcImageLayout-00260",
|
|
"text": " <code>srcImageLayout</code> <strong class=\"purple\">must</strong> specify the layout of the image subresources of <code>srcImage</code> specified in <code>pRegions</code> at the time this command is executed on a <code>VkDevice</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResolveImage-dstImageLayout-00262",
|
|
"text": " <code>dstImageLayout</code> <strong class=\"purple\">must</strong> specify the layout of the image subresources of <code>dstImage</code> specified in <code>pRegions</code> at the time this command is executed on a <code>VkDevice</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResolveImage-dstImage-02003",
|
|
"text": " The <a href=\"#resources-image-format-features\">format features</a> of <code>dstImage</code> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_COLOR_ATTACHMENT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResolveImage-srcImage-01386",
|
|
"text": " <code>srcImage</code> and <code>dstImage</code> <strong class=\"purple\">must</strong> have been created with the same image format"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResolveImage-srcSubresource-01709",
|
|
"text": " The <code>srcSubresource.mipLevel</code> member of each element of <code>pRegions</code> <strong class=\"purple\">must</strong> be less than the <code>mipLevels</code> specified in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> when <code>srcImage</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResolveImage-dstSubresource-01710",
|
|
"text": " The <code>dstSubresource.mipLevel</code> member of each element of <code>pRegions</code> <strong class=\"purple\">must</strong> be less than the <code>mipLevels</code> specified in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> when <code>dstImage</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResolveImage-srcSubresource-01711",
|
|
"text": " The <span class=\"eq\"><code>srcSubresource.baseArrayLayer</code> + <code>srcSubresource.layerCount</code></span> of each element of <code>pRegions</code> <strong class=\"purple\">must</strong> be less than or equal to the <code>arrayLayers</code> specified in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> when <code>srcImage</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResolveImage-dstSubresource-01712",
|
|
"text": " The <span class=\"eq\"><code>dstSubresource.baseArrayLayer</code> + <code>dstSubresource.layerCount</code></span> of each element of <code>pRegions</code> <strong class=\"purple\">must</strong> be less than or equal to the <code>arrayLayers</code> specified in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> when <code>dstImage</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResolveImage-srcImage-04446",
|
|
"text": " If either <code>srcImage</code> or <code>dstImage</code> are of type <code>VK_IMAGE_TYPE_3D</code>, then for each element of <code>pRegions</code>, <code>srcSubresource.baseArrayLayer</code> <strong class=\"purple\">must</strong> be <code>0</code> and <code>srcSubresource.layerCount</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResolveImage-srcImage-04447",
|
|
"text": " If either <code>srcImage</code> or <code>dstImage</code> are of type <code>VK_IMAGE_TYPE_3D</code>, then for each element of <code>pRegions</code>, <code>dstSubresource.baseArrayLayer</code> <strong class=\"purple\">must</strong> be <code>0</code> and <code>dstSubresource.layerCount</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResolveImage-srcOffset-00269",
|
|
"text": " For each element of <code>pRegions</code>, <code>srcOffset.x</code> and <span class=\"eq\">(<code>extent.width</code> + <code>srcOffset.x</code>)</span> <strong class=\"purple\">must</strong> both be greater than or equal to <code>0</code> and less than or equal to the width of the specified <code>srcSubresource</code> of <code>srcImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResolveImage-srcOffset-00270",
|
|
"text": " For each element of <code>pRegions</code>, <code>srcOffset.y</code> and <span class=\"eq\">(<code>extent.height</code> + <code>srcOffset.y</code>)</span> <strong class=\"purple\">must</strong> both be greater than or equal to <code>0</code> and less than or equal to the height of the specified <code>srcSubresource</code> of <code>srcImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResolveImage-srcImage-00271",
|
|
"text": " If <code>srcImage</code> is of type <code>VK_IMAGE_TYPE_1D</code>, then for each element of <code>pRegions</code>, <code>srcOffset.y</code> <strong class=\"purple\">must</strong> be <code>0</code> and <code>extent.height</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResolveImage-srcOffset-00272",
|
|
"text": " For each element of <code>pRegions</code>, <code>srcOffset.z</code> and <span class=\"eq\">(<code>extent.depth</code> + <code>srcOffset.z</code>)</span> <strong class=\"purple\">must</strong> both be greater than or equal to <code>0</code> and less than or equal to the depth of the specified <code>srcSubresource</code> of <code>srcImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResolveImage-srcImage-00273",
|
|
"text": " If <code>srcImage</code> is of type <code>VK_IMAGE_TYPE_1D</code> or <code>VK_IMAGE_TYPE_2D</code>, then for each element of <code>pRegions</code>, <code>srcOffset.z</code> <strong class=\"purple\">must</strong> be <code>0</code> and <code>extent.depth</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResolveImage-dstOffset-00274",
|
|
"text": " For each element of <code>pRegions</code>, <code>dstOffset.x</code> and <span class=\"eq\">(<code>extent.width</code> + <code>dstOffset.x</code>)</span> <strong class=\"purple\">must</strong> both be greater than or equal to <code>0</code> and less than or equal to the width of the specified <code>dstSubresource</code> of <code>dstImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResolveImage-dstOffset-00275",
|
|
"text": " For each element of <code>pRegions</code>, <code>dstOffset.y</code> and <span class=\"eq\">(<code>extent.height</code> + <code>dstOffset.y</code>)</span> <strong class=\"purple\">must</strong> both be greater than or equal to <code>0</code> and less than or equal to the height of the specified <code>dstSubresource</code> of <code>dstImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResolveImage-dstImage-00276",
|
|
"text": " If <code>dstImage</code> is of type <code>VK_IMAGE_TYPE_1D</code>, then for each element of <code>pRegions</code>, <code>dstOffset.y</code> <strong class=\"purple\">must</strong> be <code>0</code> and <code>extent.height</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResolveImage-dstOffset-00277",
|
|
"text": " For each element of <code>pRegions</code>, <code>dstOffset.z</code> and <span class=\"eq\">(<code>extent.depth</code> + <code>dstOffset.z</code>)</span> <strong class=\"purple\">must</strong> both be greater than or equal to <code>0</code> and less than or equal to the depth of the specified <code>dstSubresource</code> of <code>dstImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResolveImage-dstImage-00278",
|
|
"text": " If <code>dstImage</code> is of type <code>VK_IMAGE_TYPE_1D</code> or <code>VK_IMAGE_TYPE_2D</code>, then for each element of <code>pRegions</code>, <code>dstOffset.z</code> <strong class=\"purple\">must</strong> be <code>0</code> and <code>extent.depth</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResolveImage-srcImage-06762",
|
|
"text": " <code>srcImage</code> <strong class=\"purple\">must</strong> have been created with <code>VK_IMAGE_USAGE_TRANSFER_SRC_BIT</code> usage flag"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResolveImage-dstImage-06764",
|
|
"text": " <code>dstImage</code> <strong class=\"purple\">must</strong> have been created with <code>VK_IMAGE_USAGE_TRANSFER_DST_BIT</code> usage flag"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResolveImage-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResolveImage-srcImage-parameter",
|
|
"text": " <code>srcImage</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImage\">VkImage</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResolveImage-srcImageLayout-parameter",
|
|
"text": " <code>srcImageLayout</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageLayout\">VkImageLayout</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResolveImage-dstImage-parameter",
|
|
"text": " <code>dstImage</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImage\">VkImage</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResolveImage-dstImageLayout-parameter",
|
|
"text": " <code>dstImageLayout</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageLayout\">VkImageLayout</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResolveImage-pRegions-parameter",
|
|
"text": " <code>pRegions</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>regionCount</code> valid <a href=\"#VkImageResolve\">VkImageResolve</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResolveImage-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResolveImage-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResolveImage-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResolveImage-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResolveImage-regionCount-arraylength",
|
|
"text": " <code>regionCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResolveImage-commonparent",
|
|
"text": " Each of <code>commandBuffer</code>, <code>dstImage</code>, and <code>srcImage</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"!(VK_KHR_shared_presentable_image)": [
|
|
{
|
|
"vuid": "VUID-vkCmdResolveImage-srcImageLayout-00261",
|
|
"text": " <code>srcImageLayout</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_LAYOUT_TRANSFER_SRC_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_GENERAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResolveImage-dstImageLayout-00263",
|
|
"text": " <code>dstImageLayout</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_LAYOUT_TRANSFER_DST_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_GENERAL</code>"
|
|
}
|
|
],
|
|
"(VK_KHR_shared_presentable_image)": [
|
|
{
|
|
"vuid": "VUID-vkCmdResolveImage-srcImageLayout-01400",
|
|
"text": " <code>srcImageLayout</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_LAYOUT_SHARED_PRESENT_KHR</code>, <code>VK_IMAGE_LAYOUT_TRANSFER_SRC_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_GENERAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResolveImage-dstImageLayout-01401",
|
|
"text": " <code>dstImageLayout</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_LAYOUT_SHARED_PRESENT_KHR</code>, <code>VK_IMAGE_LAYOUT_TRANSFER_DST_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_GENERAL</code>"
|
|
}
|
|
],
|
|
"(VK_NV_linear_color_attachment)": [
|
|
{
|
|
"vuid": "VUID-vkCmdResolveImage-linearColorAttachment-06519",
|
|
"text": " If the <a href=\"#features-linearColorAttachment\"><code>linearColorAttachment</code></a> feature is enabled and the image is created with <code>VK_IMAGE_TILING_LINEAR</code>, the <a href=\"#resources-image-format-features\">format features</a> of <code>dstImage</code> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_LINEAR_COLOR_ATTACHMENT_BIT_NV</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_fragment_density_map)": [
|
|
{
|
|
"vuid": "VUID-vkCmdResolveImage-dstImage-02546",
|
|
"text": " <code>dstImage</code> and <code>srcImage</code> <strong class=\"purple\">must</strong> not have been created with <code>flags</code> containing <code>VK_IMAGE_CREATE_SUBSAMPLED_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_maintenance1)": [
|
|
{
|
|
"vuid": "VUID-vkCmdResolveImage-srcImage-06763",
|
|
"text": " The <a href=\"#resources-image-format-features\">format features</a> of <code>srcImage</code> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_TRANSFER_SRC_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResolveImage-dstImage-06765",
|
|
"text": " The <a href=\"#resources-image-format-features\">format features</a> of <code>dstImage</code> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_TRANSFER_DST_BIT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkImageResolve": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkImageResolve-aspectMask-00266",
|
|
"text": " The <code>aspectMask</code> member of <code>srcSubresource</code> and <code>dstSubresource</code> <strong class=\"purple\">must</strong> only contain <code>VK_IMAGE_ASPECT_COLOR_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageResolve-layerCount-00267",
|
|
"text": " The <code>layerCount</code> member of <code>srcSubresource</code> and <code>dstSubresource</code> <strong class=\"purple\">must</strong> match"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageResolve-srcSubresource-parameter",
|
|
"text": " <code>srcSubresource</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageSubresourceLayers\">VkImageSubresourceLayers</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageResolve-dstSubresource-parameter",
|
|
"text": " <code>dstSubresource</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageSubresourceLayers\">VkImageSubresourceLayers</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdResolveImage2": {
|
|
"(VK_VERSION_1_3,VK_KHR_copy_commands2)+(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-vkCmdResolveImage2-commandBuffer-01837",
|
|
"text": " If <code>commandBuffer</code> is an unprotected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, <code>srcImage</code> <strong class=\"purple\">must</strong> not be a protected image"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResolveImage2-commandBuffer-01838",
|
|
"text": " If <code>commandBuffer</code> is an unprotected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, <code>dstImage</code> <strong class=\"purple\">must</strong> not be a protected image"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResolveImage2-commandBuffer-01839",
|
|
"text": " If <code>commandBuffer</code> is a protected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, <code>dstImage</code> <strong class=\"purple\">must</strong> not be an unprotected image"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_copy_commands2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdResolveImage2-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResolveImage2-pResolveImageInfo-parameter",
|
|
"text": " <code>pResolveImageInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkResolveImageInfo2\">VkResolveImageInfo2</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResolveImage2-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResolveImage2-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResolveImage2-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdResolveImage2-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
]
|
|
},
|
|
"VkResolveImageInfo2": {
|
|
"(VK_VERSION_1_3,VK_KHR_copy_commands2)": [
|
|
{
|
|
"vuid": "VUID-VkResolveImageInfo2-pRegions-00255",
|
|
"text": " The union of all source regions, and the union of all destination regions, specified by the elements of <code>pRegions</code>, <strong class=\"purple\">must</strong> not overlap in memory"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkResolveImageInfo2-srcImage-00256",
|
|
"text": " If <code>srcImage</code> is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkResolveImageInfo2-srcImage-00257",
|
|
"text": " <code>srcImage</code> <strong class=\"purple\">must</strong> have a sample count equal to any valid sample count value other than <code>VK_SAMPLE_COUNT_1_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkResolveImageInfo2-dstImage-00258",
|
|
"text": " If <code>dstImage</code> is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkResolveImageInfo2-dstImage-00259",
|
|
"text": " <code>dstImage</code> <strong class=\"purple\">must</strong> have a sample count equal to <code>VK_SAMPLE_COUNT_1_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkResolveImageInfo2-srcImageLayout-00260",
|
|
"text": " <code>srcImageLayout</code> <strong class=\"purple\">must</strong> specify the layout of the image subresources of <code>srcImage</code> specified in <code>pRegions</code> at the time this command is executed on a <code>VkDevice</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkResolveImageInfo2-dstImageLayout-00262",
|
|
"text": " <code>dstImageLayout</code> <strong class=\"purple\">must</strong> specify the layout of the image subresources of <code>dstImage</code> specified in <code>pRegions</code> at the time this command is executed on a <code>VkDevice</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkResolveImageInfo2-dstImage-02003",
|
|
"text": " The <a href=\"#resources-image-format-features\">format features</a> of <code>dstImage</code> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_COLOR_ATTACHMENT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkResolveImageInfo2-srcImage-01386",
|
|
"text": " <code>srcImage</code> and <code>dstImage</code> <strong class=\"purple\">must</strong> have been created with the same image format"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkResolveImageInfo2-srcSubresource-01709",
|
|
"text": " The <code>srcSubresource.mipLevel</code> member of each element of <code>pRegions</code> <strong class=\"purple\">must</strong> be less than the <code>mipLevels</code> specified in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> when <code>srcImage</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkResolveImageInfo2-dstSubresource-01710",
|
|
"text": " The <code>dstSubresource.mipLevel</code> member of each element of <code>pRegions</code> <strong class=\"purple\">must</strong> be less than the <code>mipLevels</code> specified in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> when <code>dstImage</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkResolveImageInfo2-srcSubresource-01711",
|
|
"text": " The <span class=\"eq\"><code>srcSubresource.baseArrayLayer</code> + <code>srcSubresource.layerCount</code></span> of each element of <code>pRegions</code> <strong class=\"purple\">must</strong> be less than or equal to the <code>arrayLayers</code> specified in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> when <code>srcImage</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkResolveImageInfo2-dstSubresource-01712",
|
|
"text": " The <span class=\"eq\"><code>dstSubresource.baseArrayLayer</code> + <code>dstSubresource.layerCount</code></span> of each element of <code>pRegions</code> <strong class=\"purple\">must</strong> be less than or equal to the <code>arrayLayers</code> specified in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> when <code>dstImage</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkResolveImageInfo2-srcImage-04446",
|
|
"text": " If either <code>srcImage</code> or <code>dstImage</code> are of type <code>VK_IMAGE_TYPE_3D</code>, then for each element of <code>pRegions</code>, <code>srcSubresource.baseArrayLayer</code> <strong class=\"purple\">must</strong> be <code>0</code> and <code>srcSubresource.layerCount</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkResolveImageInfo2-srcImage-04447",
|
|
"text": " If either <code>srcImage</code> or <code>dstImage</code> are of type <code>VK_IMAGE_TYPE_3D</code>, then for each element of <code>pRegions</code>, <code>dstSubresource.baseArrayLayer</code> <strong class=\"purple\">must</strong> be <code>0</code> and <code>dstSubresource.layerCount</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkResolveImageInfo2-srcOffset-00269",
|
|
"text": " For each element of <code>pRegions</code>, <code>srcOffset.x</code> and <span class=\"eq\">(<code>extent.width</code> + <code>srcOffset.x</code>)</span> <strong class=\"purple\">must</strong> both be greater than or equal to <code>0</code> and less than or equal to the width of the specified <code>srcSubresource</code> of <code>srcImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkResolveImageInfo2-srcOffset-00270",
|
|
"text": " For each element of <code>pRegions</code>, <code>srcOffset.y</code> and <span class=\"eq\">(<code>extent.height</code> + <code>srcOffset.y</code>)</span> <strong class=\"purple\">must</strong> both be greater than or equal to <code>0</code> and less than or equal to the height of the specified <code>srcSubresource</code> of <code>srcImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkResolveImageInfo2-srcImage-00271",
|
|
"text": " If <code>srcImage</code> is of type <code>VK_IMAGE_TYPE_1D</code>, then for each element of <code>pRegions</code>, <code>srcOffset.y</code> <strong class=\"purple\">must</strong> be <code>0</code> and <code>extent.height</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkResolveImageInfo2-srcOffset-00272",
|
|
"text": " For each element of <code>pRegions</code>, <code>srcOffset.z</code> and <span class=\"eq\">(<code>extent.depth</code> + <code>srcOffset.z</code>)</span> <strong class=\"purple\">must</strong> both be greater than or equal to <code>0</code> and less than or equal to the depth of the specified <code>srcSubresource</code> of <code>srcImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkResolveImageInfo2-srcImage-00273",
|
|
"text": " If <code>srcImage</code> is of type <code>VK_IMAGE_TYPE_1D</code> or <code>VK_IMAGE_TYPE_2D</code>, then for each element of <code>pRegions</code>, <code>srcOffset.z</code> <strong class=\"purple\">must</strong> be <code>0</code> and <code>extent.depth</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkResolveImageInfo2-dstOffset-00274",
|
|
"text": " For each element of <code>pRegions</code>, <code>dstOffset.x</code> and <span class=\"eq\">(<code>extent.width</code> + <code>dstOffset.x</code>)</span> <strong class=\"purple\">must</strong> both be greater than or equal to <code>0</code> and less than or equal to the width of the specified <code>dstSubresource</code> of <code>dstImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkResolveImageInfo2-dstOffset-00275",
|
|
"text": " For each element of <code>pRegions</code>, <code>dstOffset.y</code> and <span class=\"eq\">(<code>extent.height</code> + <code>dstOffset.y</code>)</span> <strong class=\"purple\">must</strong> both be greater than or equal to <code>0</code> and less than or equal to the height of the specified <code>dstSubresource</code> of <code>dstImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkResolveImageInfo2-dstImage-00276",
|
|
"text": " If <code>dstImage</code> is of type <code>VK_IMAGE_TYPE_1D</code>, then for each element of <code>pRegions</code>, <code>dstOffset.y</code> <strong class=\"purple\">must</strong> be <code>0</code> and <code>extent.height</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkResolveImageInfo2-dstOffset-00277",
|
|
"text": " For each element of <code>pRegions</code>, <code>dstOffset.z</code> and <span class=\"eq\">(<code>extent.depth</code> + <code>dstOffset.z</code>)</span> <strong class=\"purple\">must</strong> both be greater than or equal to <code>0</code> and less than or equal to the depth of the specified <code>dstSubresource</code> of <code>dstImage</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkResolveImageInfo2-dstImage-00278",
|
|
"text": " If <code>dstImage</code> is of type <code>VK_IMAGE_TYPE_1D</code> or <code>VK_IMAGE_TYPE_2D</code>, then for each element of <code>pRegions</code>, <code>dstOffset.z</code> <strong class=\"purple\">must</strong> be <code>0</code> and <code>extent.depth</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkResolveImageInfo2-srcImage-06762",
|
|
"text": " <code>srcImage</code> <strong class=\"purple\">must</strong> have been created with <code>VK_IMAGE_USAGE_TRANSFER_SRC_BIT</code> usage flag"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkResolveImageInfo2-dstImage-06764",
|
|
"text": " <code>dstImage</code> <strong class=\"purple\">must</strong> have been created with <code>VK_IMAGE_USAGE_TRANSFER_DST_BIT</code> usage flag"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkResolveImageInfo2-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_RESOLVE_IMAGE_INFO_2</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkResolveImageInfo2-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkResolveImageInfo2-srcImage-parameter",
|
|
"text": " <code>srcImage</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImage\">VkImage</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkResolveImageInfo2-srcImageLayout-parameter",
|
|
"text": " <code>srcImageLayout</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageLayout\">VkImageLayout</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkResolveImageInfo2-dstImage-parameter",
|
|
"text": " <code>dstImage</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImage\">VkImage</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkResolveImageInfo2-dstImageLayout-parameter",
|
|
"text": " <code>dstImageLayout</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageLayout\">VkImageLayout</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkResolveImageInfo2-pRegions-parameter",
|
|
"text": " <code>pRegions</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>regionCount</code> valid <a href=\"#VkImageResolve2\">VkImageResolve2</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkResolveImageInfo2-regionCount-arraylength",
|
|
"text": " <code>regionCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkResolveImageInfo2-commonparent",
|
|
"text": " Both of <code>dstImage</code>, and <code>srcImage</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_copy_commands2)+!(VK_KHR_shared_presentable_image)": [
|
|
{
|
|
"vuid": "VUID-VkResolveImageInfo2-srcImageLayout-00261",
|
|
"text": " <code>srcImageLayout</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_LAYOUT_TRANSFER_SRC_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_GENERAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkResolveImageInfo2-dstImageLayout-00263",
|
|
"text": " <code>dstImageLayout</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_LAYOUT_TRANSFER_DST_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_GENERAL</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_copy_commands2)+(VK_KHR_shared_presentable_image)": [
|
|
{
|
|
"vuid": "VUID-VkResolveImageInfo2-srcImageLayout-01400",
|
|
"text": " <code>srcImageLayout</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_LAYOUT_SHARED_PRESENT_KHR</code>, <code>VK_IMAGE_LAYOUT_TRANSFER_SRC_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_GENERAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkResolveImageInfo2-dstImageLayout-01401",
|
|
"text": " <code>dstImageLayout</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_LAYOUT_SHARED_PRESENT_KHR</code>, <code>VK_IMAGE_LAYOUT_TRANSFER_DST_OPTIMAL</code> or <code>VK_IMAGE_LAYOUT_GENERAL</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_copy_commands2)+(VK_NV_linear_color_attachment)": [
|
|
{
|
|
"vuid": "VUID-VkResolveImageInfo2-linearColorAttachment-06519",
|
|
"text": " If the <a href=\"#features-linearColorAttachment\"><code>linearColorAttachment</code></a> feature is enabled and the image is created with <code>VK_IMAGE_TILING_LINEAR</code>, the <a href=\"#resources-image-format-features\">format features</a> of <code>dstImage</code> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_LINEAR_COLOR_ATTACHMENT_BIT_NV</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_copy_commands2)+(VK_EXT_fragment_density_map)": [
|
|
{
|
|
"vuid": "VUID-VkResolveImageInfo2-dstImage-02546",
|
|
"text": " <code>dstImage</code> and <code>srcImage</code> <strong class=\"purple\">must</strong> not have been created with <code>flags</code> containing <code>VK_IMAGE_CREATE_SUBSAMPLED_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_copy_commands2)+(VK_VERSION_1_1,VK_KHR_maintenance1)": [
|
|
{
|
|
"vuid": "VUID-VkResolveImageInfo2-srcImage-06763",
|
|
"text": " The <a href=\"#resources-image-format-features\">format features</a> of <code>srcImage</code> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_TRANSFER_SRC_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkResolveImageInfo2-dstImage-06765",
|
|
"text": " The <a href=\"#resources-image-format-features\">format features</a> of <code>dstImage</code> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_TRANSFER_DST_BIT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkImageResolve2": {
|
|
"(VK_VERSION_1_3,VK_KHR_copy_commands2)": [
|
|
{
|
|
"vuid": "VUID-VkImageResolve2-aspectMask-00266",
|
|
"text": " The <code>aspectMask</code> member of <code>srcSubresource</code> and <code>dstSubresource</code> <strong class=\"purple\">must</strong> only contain <code>VK_IMAGE_ASPECT_COLOR_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageResolve2-layerCount-00267",
|
|
"text": " The <code>layerCount</code> member of <code>srcSubresource</code> and <code>dstSubresource</code> <strong class=\"purple\">must</strong> match"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageResolve2-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_IMAGE_RESOLVE_2</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageResolve2-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageResolve2-srcSubresource-parameter",
|
|
"text": " <code>srcSubresource</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageSubresourceLayers\">VkImageSubresourceLayers</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageResolve2-dstSubresource-parameter",
|
|
"text": " <code>dstSubresource</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageSubresourceLayers\">VkImageSubresourceLayers</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdWriteBufferMarker2AMD": {
|
|
"(VK_AMD_buffer_marker)+(VK_VERSION_1_3,VK_KHR_synchronization2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdWriteBufferMarker2AMD-stage-03929",
|
|
"text": " If the <a href=\"#features-geometryShader\"><code>geometryShader</code></a> feature is not enabled, pname:stage <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_GEOMETRY_SHADER_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteBufferMarker2AMD-stage-03930",
|
|
"text": " If the <a href=\"#features-tessellationShader\"><code>tessellationShader</code></a> feature is not enabled, pname:stage <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_TESSELLATION_CONTROL_SHADER_BIT</code> or <code>VK_PIPELINE_STAGE_2_TESSELLATION_EVALUATION_SHADER_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteBufferMarker2AMD-synchronization2-03893",
|
|
"text": " The <a href=\"#features-synchronization2\"><code>synchronization2</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteBufferMarker2AMD-stage-03894",
|
|
"text": " <code>stage</code> <strong class=\"purple\">must</strong> include only a single pipeline stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteBufferMarker2AMD-stage-03895",
|
|
"text": " <code>stage</code> <strong class=\"purple\">must</strong> include only stages that are valid for the queue family that was used to create the command pool that <code>commandBuffer</code> was allocated from"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteBufferMarker2AMD-dstOffset-03896",
|
|
"text": " <code>dstOffset</code> <strong class=\"purple\">must</strong> be less than or equal to the size of <code>dstBuffer</code> minus <code>4</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteBufferMarker2AMD-dstBuffer-03897",
|
|
"text": " <code>dstBuffer</code> <strong class=\"purple\">must</strong> have been created with the <code>VK_BUFFER_USAGE_TRANSFER_DST_BIT</code> usage flag"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteBufferMarker2AMD-dstBuffer-03898",
|
|
"text": " If <code>dstBuffer</code> is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteBufferMarker2AMD-dstOffset-03899",
|
|
"text": " <code>dstOffset</code> <strong class=\"purple\">must</strong> be a multiple of <code>4</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteBufferMarker2AMD-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteBufferMarker2AMD-stage-parameter",
|
|
"text": " <code>stage</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkPipelineStageFlagBits2\">VkPipelineStageFlagBits2</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteBufferMarker2AMD-dstBuffer-parameter",
|
|
"text": " <code>dstBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBuffer\">VkBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteBufferMarker2AMD-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteBufferMarker2AMD-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support transfer, graphics, or compute operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteBufferMarker2AMD-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteBufferMarker2AMD-commonparent",
|
|
"text": " Both of <code>commandBuffer</code>, and <code>dstBuffer</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"(VK_AMD_buffer_marker)+(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_EXT_conditional_rendering)": [
|
|
{
|
|
"vuid": "VUID-vkCmdWriteBufferMarker2AMD-stage-03931",
|
|
"text": " If the <a href=\"#features-conditionalRendering\"><code>conditionalRendering</code></a> feature is not enabled, pname:stage <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_CONDITIONAL_RENDERING_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_AMD_buffer_marker)+(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_EXT_fragment_density_map)": [
|
|
{
|
|
"vuid": "VUID-vkCmdWriteBufferMarker2AMD-stage-03932",
|
|
"text": " If the <a href=\"#features-fragmentDensityMap\"><code>fragmentDensityMap</code></a> feature is not enabled, pname:stage <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_FRAGMENT_DENSITY_PROCESS_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_AMD_buffer_marker)+(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_EXT_transform_feedback)": [
|
|
{
|
|
"vuid": "VUID-vkCmdWriteBufferMarker2AMD-stage-03933",
|
|
"text": " If the <a href=\"#features-transformFeedback\"><code>transformFeedback</code></a> feature is not enabled, pname:stage <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_TRANSFORM_FEEDBACK_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_AMD_buffer_marker)+(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_NV_mesh_shader)": [
|
|
{
|
|
"vuid": "VUID-vkCmdWriteBufferMarker2AMD-stage-03934",
|
|
"text": " If the <a href=\"#features-meshShader\"><code>meshShader</code></a> feature is not enabled, pname:stage <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_MESH_SHADER_BIT_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteBufferMarker2AMD-stage-03935",
|
|
"text": " If the <a href=\"#features-taskShader\"><code>taskShader</code></a> feature is not enabled, pname:stage <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_TASK_SHADER_BIT_NV</code>"
|
|
}
|
|
],
|
|
"(VK_AMD_buffer_marker)+(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_NV_shading_rate_image)": [
|
|
{
|
|
"vuid": "VUID-vkCmdWriteBufferMarker2AMD-stage-04956",
|
|
"text": " If the <a href=\"#features-shadingRateImage\"><code>shadingRateImage</code></a> feature is not enabled, pname:stage <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_SHADING_RATE_IMAGE_BIT_NV</code>"
|
|
}
|
|
],
|
|
"(VK_AMD_buffer_marker)+(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_HUAWEI_subpass_shading)": [
|
|
{
|
|
"vuid": "VUID-vkCmdWriteBufferMarker2AMD-stage-04957",
|
|
"text": " If the <a href=\"#features-subpassShading\"><code>subpassShading</code></a> feature is not enabled, pname:stage <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_SUBPASS_SHADING_BIT_HUAWEI</code>"
|
|
}
|
|
],
|
|
"(VK_AMD_buffer_marker)+(VK_VERSION_1_3,VK_KHR_synchronization2)+(VK_HUAWEI_invocation_mask)": [
|
|
{
|
|
"vuid": "VUID-vkCmdWriteBufferMarker2AMD-stage-04995",
|
|
"text": " If the <a href=\"#features-invocationMask\"><code>invocationMask</code></a> feature is not enabled, pname:stage <strong class=\"purple\">must</strong> not contain <code>VK_PIPELINE_STAGE_2_INVOCATION_MASK_BIT_HUAWEI</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdWriteBufferMarkerAMD": {
|
|
"(VK_AMD_buffer_marker)": [
|
|
{
|
|
"vuid": "VUID-vkCmdWriteBufferMarkerAMD-pipelineStage-04074",
|
|
"text": " <code>pipelineStage</code> <strong class=\"purple\">must</strong> be a <a href=\"#synchronization-pipeline-stages-supported\">valid stage</a> for the queue family that was used to create the command pool that <code>commandBuffer</code> was allocated from"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteBufferMarkerAMD-pipelineStage-04075",
|
|
"text": " If the <a href=\"#features-geometryShader\"><code>geometryShader</code></a> feature is not enabled, <code>pipelineStage</code> <strong class=\"purple\">must</strong> not be <code>VK_PIPELINE_STAGE_GEOMETRY_SHADER_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteBufferMarkerAMD-pipelineStage-04076",
|
|
"text": " If the <a href=\"#features-tessellationShader\"><code>tessellationShader</code></a> feature is not enabled, <code>pipelineStage</code> <strong class=\"purple\">must</strong> not be <code>VK_PIPELINE_STAGE_TESSELLATION_CONTROL_SHADER_BIT</code> or <code>VK_PIPELINE_STAGE_TESSELLATION_EVALUATION_SHADER_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteBufferMarkerAMD-dstOffset-01798",
|
|
"text": " <code>dstOffset</code> <strong class=\"purple\">must</strong> be less than or equal to the size of <code>dstBuffer</code> minus <code>4</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteBufferMarkerAMD-dstBuffer-01799",
|
|
"text": " <code>dstBuffer</code> <strong class=\"purple\">must</strong> have been created with <code>VK_BUFFER_USAGE_TRANSFER_DST_BIT</code> usage flag"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteBufferMarkerAMD-dstBuffer-01800",
|
|
"text": " If <code>dstBuffer</code> is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteBufferMarkerAMD-dstOffset-01801",
|
|
"text": " <code>dstOffset</code> <strong class=\"purple\">must</strong> be a multiple of <code>4</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteBufferMarkerAMD-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteBufferMarkerAMD-pipelineStage-parameter",
|
|
"text": " If <code>pipelineStage</code> is not <code>0</code>, <code>pipelineStage</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPipelineStageFlagBits\">VkPipelineStageFlagBits</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteBufferMarkerAMD-dstBuffer-parameter",
|
|
"text": " <code>dstBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBuffer\">VkBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteBufferMarkerAMD-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteBufferMarkerAMD-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support transfer, graphics, or compute operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteBufferMarkerAMD-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteBufferMarkerAMD-commonparent",
|
|
"text": " Both of <code>commandBuffer</code>, and <code>dstBuffer</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"(VK_AMD_buffer_marker)+(VK_EXT_conditional_rendering)": [
|
|
{
|
|
"vuid": "VUID-vkCmdWriteBufferMarkerAMD-pipelineStage-04077",
|
|
"text": " If the <a href=\"#features-conditionalRendering\"><code>conditionalRendering</code></a> feature is not enabled, <code>pipelineStage</code> <strong class=\"purple\">must</strong> not be <code>VK_PIPELINE_STAGE_CONDITIONAL_RENDERING_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_AMD_buffer_marker)+(VK_EXT_fragment_density_map)": [
|
|
{
|
|
"vuid": "VUID-vkCmdWriteBufferMarkerAMD-pipelineStage-04078",
|
|
"text": " If the <a href=\"#features-fragmentDensityMap\"><code>fragmentDensityMap</code></a> feature is not enabled, <code>pipelineStage</code> <strong class=\"purple\">must</strong> not be <code>VK_PIPELINE_STAGE_FRAGMENT_DENSITY_PROCESS_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_AMD_buffer_marker)+(VK_EXT_transform_feedback)": [
|
|
{
|
|
"vuid": "VUID-vkCmdWriteBufferMarkerAMD-pipelineStage-04079",
|
|
"text": " If the <a href=\"#features-transformFeedback\"><code>transformFeedback</code></a> feature is not enabled, <code>pipelineStage</code> <strong class=\"purple\">must</strong> not be <code>VK_PIPELINE_STAGE_TRANSFORM_FEEDBACK_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_AMD_buffer_marker)+(VK_NV_mesh_shader)": [
|
|
{
|
|
"vuid": "VUID-vkCmdWriteBufferMarkerAMD-pipelineStage-04080",
|
|
"text": " If the <a href=\"#features-meshShader\"><code>meshShader</code></a> feature is not enabled, <code>pipelineStage</code> <strong class=\"purple\">must</strong> not be <code>VK_PIPELINE_STAGE_MESH_SHADER_BIT_NV</code> or <code>VK_PIPELINE_STAGE_TASK_SHADER_BIT_NV</code>"
|
|
}
|
|
],
|
|
"(VK_AMD_buffer_marker)+(VK_NV_shading_rate_image)": [
|
|
{
|
|
"vuid": "VUID-vkCmdWriteBufferMarkerAMD-pipelineStage-04081",
|
|
"text": " If the <a href=\"#features-shadingRateImage\"><code>shadingRateImage</code></a> feature is not enabled, <code>pipelineStage</code> <strong class=\"purple\">must</strong> not be <code>VK_PIPELINE_STAGE_SHADING_RATE_IMAGE_BIT_NV</code>"
|
|
}
|
|
],
|
|
"(VK_AMD_buffer_marker)+(VK_VERSION_1_3,VK_KHR_synchronization2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdWriteBufferMarkerAMD-synchronization2-06489",
|
|
"text": " If the <a href=\"#features-synchronization2\"><code>synchronization2</code></a> feature is not enabled, <code>pipelineStage</code> <strong class=\"purple\">must</strong> not be <code>VK_PIPELINE_STAGE_NONE</code>"
|
|
}
|
|
],
|
|
"(VK_AMD_buffer_marker)+!(VK_VERSION_1_3,VK_KHR_synchronization2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdWriteBufferMarkerAMD-pipelineStage-06490",
|
|
"text": " <code>pipelineStage</code> <strong class=\"purple\">must</strong> not be <code>VK_PIPELINE_STAGE_NONE</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPipelineInputAssemblyStateCreateInfo": {
|
|
"!(VK_EXT_primitive_topology_list_restart)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineInputAssemblyStateCreateInfo-topology-00428",
|
|
"text": " If <code>topology</code> is <code>VK_PRIMITIVE_TOPOLOGY_POINT_LIST</code>, <code>VK_PRIMITIVE_TOPOLOGY_LINE_LIST</code>, <code>VK_PRIMITIVE_TOPOLOGY_TRIANGLE_LIST</code>, <code>VK_PRIMITIVE_TOPOLOGY_LINE_LIST_WITH_ADJACENCY</code>, <code>VK_PRIMITIVE_TOPOLOGY_TRIANGLE_LIST_WITH_ADJACENCY</code> or <code>VK_PRIMITIVE_TOPOLOGY_PATCH_LIST</code>, <code>primitiveRestartEnable</code> <strong class=\"purple\">must</strong> be <code>VK_FALSE</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_primitive_topology_list_restart)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineInputAssemblyStateCreateInfo-topology-06252",
|
|
"text": " If <code>topology</code> is <code>VK_PRIMITIVE_TOPOLOGY_POINT_LIST</code>, <code>VK_PRIMITIVE_TOPOLOGY_LINE_LIST</code>, <code>VK_PRIMITIVE_TOPOLOGY_TRIANGLE_LIST</code>, <code>VK_PRIMITIVE_TOPOLOGY_LINE_LIST_WITH_ADJACENCY</code> or <code>VK_PRIMITIVE_TOPOLOGY_TRIANGLE_LIST_WITH_ADJACENCY</code>, and <code>primitiveRestartEnable</code> is <code>VK_TRUE</code>, the <a href=\"#features-primitiveTopologyListRestart\"><code>primitiveTopologyListRestart</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineInputAssemblyStateCreateInfo-topology-06253",
|
|
"text": " If <code>topology</code> is <code>VK_PRIMITIVE_TOPOLOGY_PATCH_LIST</code>, and <code>primitiveRestartEnable</code> is <code>VK_TRUE</code>, the <a href=\"#features-primitiveTopologyPatchListRestart\"><code>primitiveTopologyPatchListRestart</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
}
|
|
],
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkPipelineInputAssemblyStateCreateInfo-topology-00429",
|
|
"text": " If the <a href=\"#features-geometryShader\"><code>geometryShader</code></a> feature is not enabled, <code>topology</code> <strong class=\"purple\">must</strong> not be any of <code>VK_PRIMITIVE_TOPOLOGY_LINE_LIST_WITH_ADJACENCY</code>, <code>VK_PRIMITIVE_TOPOLOGY_LINE_STRIP_WITH_ADJACENCY</code>, <code>VK_PRIMITIVE_TOPOLOGY_TRIANGLE_LIST_WITH_ADJACENCY</code> or <code>VK_PRIMITIVE_TOPOLOGY_TRIANGLE_STRIP_WITH_ADJACENCY</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineInputAssemblyStateCreateInfo-topology-00430",
|
|
"text": " If the <a href=\"#features-tessellationShader\"><code>tessellationShader</code></a> feature is not enabled, <code>topology</code> <strong class=\"purple\">must</strong> not be <code>VK_PRIMITIVE_TOPOLOGY_PATCH_LIST</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineInputAssemblyStateCreateInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PIPELINE_INPUT_ASSEMBLY_STATE_CREATE_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineInputAssemblyStateCreateInfo-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineInputAssemblyStateCreateInfo-flags-zerobitmask",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineInputAssemblyStateCreateInfo-topology-parameter",
|
|
"text": " <code>topology</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPrimitiveTopology\">VkPrimitiveTopology</a> value"
|
|
}
|
|
],
|
|
"(VK_KHR_portability_subset)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineInputAssemblyStateCreateInfo-triangleFans-04452",
|
|
"text": " If the <code><a href=\"#VK_KHR_portability_subset\">VK_KHR_portability_subset</a></code> extension is enabled, and <a href=\"#VkPhysicalDevicePortabilitySubsetFeaturesKHR\">VkPhysicalDevicePortabilitySubsetFeaturesKHR</a>::<code>triangleFans</code> is <code>VK_FALSE</code>, <code>topology</code> <strong class=\"purple\">must</strong> not be <code>VK_PRIMITIVE_TOPOLOGY_TRIANGLE_FAN</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdSetPrimitiveRestartEnable": {
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state2)+!(VK_VERSION_1_3)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetPrimitiveRestartEnable-None-04866",
|
|
"text": " The <a href=\"#features-extendedDynamicState2\"><code>extendedDynamicState2</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetPrimitiveRestartEnable-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetPrimitiveRestartEnable-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetPrimitiveRestartEnable-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetPrimitiveRestartEnable-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdSetPrimitiveTopology": {
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+!(VK_VERSION_1_3)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetPrimitiveTopology-None-03347",
|
|
"text": " The <a href=\"#features-extendedDynamicState\"><code>extendedDynamicState</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetPrimitiveTopology-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetPrimitiveTopology-primitiveTopology-parameter",
|
|
"text": " <code>primitiveTopology</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPrimitiveTopology\">VkPrimitiveTopology</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetPrimitiveTopology-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetPrimitiveTopology-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetPrimitiveTopology-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdBindIndexBuffer": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCmdBindIndexBuffer-offset-00431",
|
|
"text": " <code>offset</code> <strong class=\"purple\">must</strong> be less than the size of <code>buffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindIndexBuffer-offset-00432",
|
|
"text": " The sum of <code>offset</code> and the address of the range of <code>VkDeviceMemory</code> object that is backing <code>buffer</code>, <strong class=\"purple\">must</strong> be a multiple of the type indicated by <code>indexType</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindIndexBuffer-buffer-00433",
|
|
"text": " <code>buffer</code> <strong class=\"purple\">must</strong> have been created with the <code>VK_BUFFER_USAGE_INDEX_BUFFER_BIT</code> flag"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindIndexBuffer-buffer-00434",
|
|
"text": " If <code>buffer</code> is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindIndexBuffer-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindIndexBuffer-buffer-parameter",
|
|
"text": " <code>buffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBuffer\">VkBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindIndexBuffer-indexType-parameter",
|
|
"text": " <code>indexType</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkIndexType\">VkIndexType</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindIndexBuffer-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindIndexBuffer-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindIndexBuffer-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindIndexBuffer-commonparent",
|
|
"text": " Both of <code>buffer</code>, and <code>commandBuffer</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBindIndexBuffer-indexType-02507",
|
|
"text": " <code>indexType</code> <strong class=\"purple\">must</strong> not be <code>VK_INDEX_TYPE_NONE_KHR</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_index_type_uint8)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBindIndexBuffer-indexType-02765",
|
|
"text": " If <code>indexType</code> is <code>VK_INDEX_TYPE_UINT8_EXT</code>, the <a href=\"#features-indexTypeUint8\"><code>indexTypeUint8</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdDraw": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-magFilter-04553",
|
|
"text": " If a <a href=\"#VkSampler\">VkSampler</a> created with <code>magFilter</code> or <code>minFilter</code> equal to <code>VK_FILTER_LINEAR</code> and <code>compareEnable</code> equal to <code>VK_FALSE</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-mipmapMode-04770",
|
|
"text": " If a <a href=\"#VkSampler\">VkSampler</a> created with <code>mipmapMode</code> equal to <code>VK_SAMPLER_MIPMAP_MODE_LINEAR</code> and <code>compareEnable</code> equal to <code>VK_FALSE</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-None-02691",
|
|
"text": " If a <code>VkImageView</code> is accessed using atomic operations as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_STORAGE_IMAGE_ATOMIC_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-None-02697",
|
|
"text": " For each set <em>n</em> that is statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command, a descriptor set <strong class=\"purple\">must</strong> have been bound to <em>n</em> at the same pipeline bind point, with a <code>VkPipelineLayout</code> that is compatible for set <em>n</em>, with the <code>VkPipelineLayout</code> used to create the current <code>VkPipeline</code>, as described in <a href=\"#descriptorsets-compatibility\">Pipeline Layout Compatibility</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-None-02699",
|
|
"text": " Descriptors in each bound descriptor set, specified via <code>vkCmdBindDescriptorSets</code>, <strong class=\"purple\">must</strong> be valid if they are statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-None-02700",
|
|
"text": " A valid pipeline <strong class=\"purple\">must</strong> be bound to the pipeline bind point used by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-commandBuffer-02701",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command requires any dynamic state, that state <strong class=\"purple\">must</strong> have been set or inherited (if the <code><a href=\"#VK_NV_inherited_viewport_scissor\">VK_NV_inherited_viewport_scissor</a></code> extension is enabled) for <code>commandBuffer</code>, and done so after any previously bound pipeline with the corresponding state not specified as dynamic"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-None-02859",
|
|
"text": " There <strong class=\"purple\">must</strong> not have been any calls to dynamic state setting commands for any state not specified as dynamic in the <code>VkPipeline</code> object bound to the pipeline bind point used by this command, since that pipeline was bound"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-None-02702",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> object that uses unnormalized coordinates, that sampler <strong class=\"purple\">must</strong> not be used to sample from any <code>VkImage</code> with a <code>VkImageView</code> of the type <code>VK_IMAGE_VIEW_TYPE_3D</code>, <code>VK_IMAGE_VIEW_TYPE_CUBE</code>, <code>VK_IMAGE_VIEW_TYPE_1D_ARRAY</code>, <code>VK_IMAGE_VIEW_TYPE_2D_ARRAY</code> or <code>VK_IMAGE_VIEW_TYPE_CUBE_ARRAY</code>, in any shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-None-02703",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> object that uses unnormalized coordinates, that sampler <strong class=\"purple\">must</strong> not be used with any of the SPIR-V <code>OpImageSample*</code> or <code>OpImageSparseSample*</code> instructions with <code>ImplicitLod</code>, <code>Dref</code> or <code>Proj</code> in their name, in any shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-None-02704",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> object that uses unnormalized coordinates, that sampler <strong class=\"purple\">must</strong> not be used with any of the SPIR-V <code>OpImageSample*</code> or <code>OpImageSparseSample*</code> instructions that includes a LOD bias or any offset values, in any shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-None-04115",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> is accessed using <code>OpImageWrite</code> as a result of this command, then the <code>Type</code> of the <code>Texel</code> operand of that instruction <strong class=\"purple\">must</strong> have at least as many components as the image view’s format"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-OpImageWrite-04469",
|
|
"text": " If a <a href=\"#VkBufferView\">VkBufferView</a> is accessed using <code>OpImageWrite</code> as a result of this command, then the <code>Type</code> of the <code>Texel</code> operand of that instruction <strong class=\"purple\">must</strong> have at least as many components as the buffer view’s format"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-renderPass-02684",
|
|
"text": " The current render pass <strong class=\"purple\">must</strong> be <a href=\"#renderpass-compatibility\">compatible</a> with the <code>renderPass</code> member of the <code>VkGraphicsPipelineCreateInfo</code> structure specified when creating the <code>VkPipeline</code> bound to <code>VK_PIPELINE_BIND_POINT_GRAPHICS</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-subpass-02685",
|
|
"text": " The subpass index of the current render pass <strong class=\"purple\">must</strong> be equal to the <code>subpass</code> member of the <code>VkGraphicsPipelineCreateInfo</code> structure specified when creating the <code>VkPipeline</code> bound to <code>VK_PIPELINE_BIND_POINT_GRAPHICS</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-None-02686",
|
|
"text": " Every input attachment used by the current subpass <strong class=\"purple\">must</strong> be bound to the pipeline via a descriptor set"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-None-06537",
|
|
"text": " Memory backing image subresources used as attachments in the current render pass <strong class=\"purple\">must</strong> not be written in any way other than as an attachment by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-None-06538",
|
|
"text": " If any recorded command in the current subpass will write to an image subresource as an attachment, this command <strong class=\"purple\">must</strong> not read from the memory backing that image subresource in any other way than as an attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-None-06539",
|
|
"text": " If any recorded command in the current subpass will read from an image subresource used as an attachment in any way other than as an attachment, this command <strong class=\"purple\">must</strong> not write to that image subresource as an attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-None-06886",
|
|
"text": " If the current render pass instance uses a depth/stencil attachment with a read-only layout for the depth aspect, <a href=\"#fragops-depth-write\">depth writes</a> <strong class=\"purple\">must</strong> be disabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-None-06887",
|
|
"text": " If the current render pass instance uses a depth/stencil attachment with a read-only layout for the stencil aspect and stencil test is enabled, <a href=\"#fragops-stencil\">all stencil ops</a> <strong class=\"purple\">must</strong> be <code>VK_STENCIL_OP_KEEP</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-blendEnable-04727",
|
|
"text": " If rasterization is not disabled in the bound graphics pipeline, then for each color attachment in the subpass, if the corresponding image view’s <a href=\"#resources-image-view-format-features\">format features</a> do not contain <code>VK_FORMAT_FEATURE_COLOR_ATTACHMENT_BLEND_BIT</code>, then the <code>blendEnable</code> member of the corresponding element of the <code>pAttachments</code> member of <code>pColorBlendState</code> <strong class=\"purple\">must</strong> be <code>VK_FALSE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-rasterizationSamples-04740",
|
|
"text": " If rasterization is not disabled in the bound graphics pipeline, and neither the <code><a href=\"#VK_AMD_mixed_attachment_samples\">VK_AMD_mixed_attachment_samples</a></code> nor the <code><a href=\"#VK_NV_framebuffer_mixed_samples\">VK_NV_framebuffer_mixed_samples</a></code> extensions are enabled, then <a href=\"#VkPipelineMultisampleStateCreateInfo\">VkPipelineMultisampleStateCreateInfo</a>::<code>rasterizationSamples</code> <strong class=\"purple\">must</strong> be the same as the current subpass color and/or depth/stencil attachments"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-None-04007",
|
|
"text": " All vertex input bindings accessed via vertex input variables declared in the vertex shader entry point’s interface <strong class=\"purple\">must</strong> have either valid or <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> buffers bound"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-None-04008",
|
|
"text": " If the <a href=\"#features-nullDescriptor\"><code>nullDescriptor</code></a> feature is not enabled, all vertex input bindings accessed via vertex input variables declared in the vertex shader entry point’s interface <strong class=\"purple\">must</strong> not be <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-None-02721",
|
|
"text": " For a given vertex buffer binding, any attribute data fetched <strong class=\"purple\">must</strong> be entirely contained within the corresponding vertex buffer binding, as described in <a href=\"#fxvertex-input\">Vertex Input Description</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called inside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
],
|
|
"!(VK_VERSION_1_3,VK_KHR_format_feature_flags2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-aspectMask-06478",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> is sampled with <a href=\"#textures-depth-compare-operation\">depth comparison</a>, the image view <strong class=\"purple\">must</strong> have been created with an <code>aspectMask</code> that contains <code>VK_IMAGE_ASPECT_DEPTH_BIT</code>."
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_format_feature_flags2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-None-06479",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> is sampled with <a href=\"#textures-depth-compare-operation\">depth comparison</a>, the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_SAMPLED_IMAGE_DEPTH_COMPARISON_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-OpTypeImage-06423",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> or <a href=\"#VkBufferView\">VkBufferView</a> being written as a storage image or storage texel buffer where the image format field of the <code>OpTypeImage</code> is <code>Unknown</code> then the view’s format feature <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_STORAGE_WRITE_WITHOUT_FORMAT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-OpTypeImage-06424",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> or <a href=\"#VkBufferView\">VkBufferView</a> being read as a storage image or storage texel buffer where the image format field of the <code>OpTypeImage</code> is <code>Unknown</code> then the view’s format feature <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_STORAGE_READ_WITHOUT_FORMAT_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_IMG_filter_cubic,VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-None-02692",
|
|
"text": " If a <code>VkImageView</code> is sampled with <code>VK_FILTER_CUBIC_EXT</code> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_CUBIC_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_IMG_filter_cubic,VK_EXT_filter_cubic)+!(VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-None-02693",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> being sampled with <code>VK_FILTER_CUBIC_EXT</code> as a result of this command <strong class=\"purple\">must</strong> not have a <a href=\"#VkImageViewType\">VkImageViewType</a> of <code>VK_IMAGE_VIEW_TYPE_3D</code>, <code>VK_IMAGE_VIEW_TYPE_CUBE</code>, or <code>VK_IMAGE_VIEW_TYPE_CUBE_ARRAY</code>"
|
|
}
|
|
],
|
|
"(VK_IMG_filter_cubic,VK_EXT_filter_cubic)+(VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-filterCubic-02694",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> being sampled with <code>VK_FILTER_CUBIC_EXT</code> as a result of this command <strong class=\"purple\">must</strong> have a <a href=\"#VkImageViewType\">VkImageViewType</a> and format that supports cubic filtering, as specified by <code>VkFilterCubicImageViewImageFormatPropertiesEXT</code>::<code>filterCubic</code> returned by <code>vkGetPhysicalDeviceImageFormatProperties2</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-filterCubicMinmax-02695",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> being sampled with <code>VK_FILTER_CUBIC_EXT</code> with a reduction mode of either <code>VK_SAMPLER_REDUCTION_MODE_MIN</code> or <code>VK_SAMPLER_REDUCTION_MODE_MAX</code> as a result of this command <strong class=\"purple\">must</strong> have a <a href=\"#VkImageViewType\">VkImageViewType</a> and format that supports cubic filtering together with minmax filtering, as specified by <code>VkFilterCubicImageViewImageFormatPropertiesEXT</code>::<code>filterCubicMinmax</code> returned by <code>vkGetPhysicalDeviceImageFormatProperties2</code>"
|
|
}
|
|
],
|
|
"(VK_NV_corner_sampled_image)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-flags-02696",
|
|
"text": " Any <a href=\"#VkImage\">VkImage</a> created with a <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a>::<code>flags</code> containing <code>VK_IMAGE_CREATE_CORNER_SAMPLED_BIT_NV</code> sampled as a result of this command <strong class=\"purple\">must</strong> only be sampled using a <a href=\"#VkSamplerAddressMode\">VkSamplerAddressMode</a> of <code>VK_SAMPLER_ADDRESS_MODE_CLAMP_TO_EDGE</code>"
|
|
}
|
|
],
|
|
"!(VK_VERSION_1_3,VK_KHR_maintenance4)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-None-02698",
|
|
"text": " For each push constant that is statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command, a push constant value <strong class=\"purple\">must</strong> have been set for the same pipeline bind point, with a <code>VkPipelineLayout</code> that is compatible for push constants, with the <code>VkPipelineLayout</code> used to create the current <code>VkPipeline</code>, as described in <a href=\"#descriptorsets-compatibility\">Pipeline Layout Compatibility</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_maintenance4)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-maintenance4-06425",
|
|
"text": " If the <a href=\"#features-maintenance4\"><code>maintenance4</code></a> feature is not enabled, then for each push constant that is statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command, a push constant value <strong class=\"purple\">must</strong> have been set for the same pipeline bind point, with a <code>VkPipelineLayout</code> that is compatible for push constants, with the <code>VkPipelineLayout</code> used to create the current <code>VkPipeline</code>, as described in <a href=\"#descriptorsets-compatibility\">Pipeline Layout Compatibility</a>"
|
|
}
|
|
],
|
|
"!(VK_EXT_pipeline_robustness)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-None-02705",
|
|
"text": " If the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, and if the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a uniform buffer, it <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-None-02706",
|
|
"text": " If the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, and if the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a storage buffer, it <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
}
|
|
],
|
|
"(VK_EXT_pipeline_robustness)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-uniformBuffers-06935",
|
|
"text": " If any stage of the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a uniform buffer, and that stage was created without enabling either <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_EXT</code> or <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXT</code> for <code>uniformBuffers</code>, and the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, that stage <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-storageBuffers-06936",
|
|
"text": " If any stage of the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a storage buffer, and that stage was created without enabling either <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_EXT</code> or <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXT</code> for <code>storageBuffers</code>, and the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, that stage <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-commandBuffer-02707",
|
|
"text": " If <code>commandBuffer</code> is an unprotected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, any resource accessed by the <a href=\"#VkPipeline\">VkPipeline</a> object bound to the pipeline bind point used by this command <strong class=\"purple\">must</strong> not be a protected resource"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-commandBuffer-02712",
|
|
"text": " If <code>commandBuffer</code> is a protected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, any resource written to by the <code>VkPipeline</code> object bound to the pipeline bind point used by this command <strong class=\"purple\">must</strong> not be an unprotected resource"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-commandBuffer-02713",
|
|
"text": " If <code>commandBuffer</code> is a protected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, pipeline stages other than the framebuffer-space and compute stages in the <code>VkPipeline</code> object bound to the pipeline bind point used by this command <strong class=\"purple\">must</strong> not write to any resource"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-commandBuffer-04617",
|
|
"text": " If any of the shader stages of the <code>VkPipeline</code> bound to the pipeline bind point used by this command uses the <a href=\"#spirvenv-capabilities-table-RayQueryKHR\"><code>RayQueryKHR</code></a> capability, then <code>commandBuffer</code> <strong class=\"purple\">must</strong> not be a protected command buffer"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-None-06550",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> or <code>VkImageView</code> object that enables <a href=\"#samplers-YCbCr-conversion\">sampler {YCbCr} conversion</a>, that object <strong class=\"purple\">must</strong> only be used with <code>OpImageSample*</code> or <code>OpImageSparseSample*</code> instructions"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-ConstOffset-06551",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> or <code>VkImageView</code> object that enables <a href=\"#samplers-YCbCr-conversion\">sampler {YCbCr} conversion</a>, that object <strong class=\"purple\">must</strong> not use the <code>ConstOffset</code> and <code>Offset</code> operands"
|
|
}
|
|
],
|
|
"(VK_EXT_shader_image_atomic_int64)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-SampledType-04470",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a 64-bit component width is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 64"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-SampledType-04471",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a component width less than 64-bit is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 32"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-SampledType-04472",
|
|
"text": " If a <a href=\"#VkBufferView\">VkBufferView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a 64-bit component width is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 64"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-SampledType-04473",
|
|
"text": " If a <a href=\"#VkBufferView\">VkBufferView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a component width less than 64-bit is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 32"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-sparseImageInt64Atomics-04474",
|
|
"text": " If the <a href=\"#features-sparseImageInt64Atomics\"><code>sparseImageInt64Atomics</code></a> feature is not enabled, <a href=\"#VkImage\">VkImage</a> objects created with the <code>VK_IMAGE_CREATE_SPARSE_RESIDENCY_BIT</code> flag <strong class=\"purple\">must</strong> not be accessed by atomic instructions through an <code>OpTypeImage</code> with a <code>SampledType</code> with a <code>Width</code> of 64 by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-sparseImageInt64Atomics-04475",
|
|
"text": " If the <a href=\"#features-sparseImageInt64Atomics\"><code>sparseImageInt64Atomics</code></a> feature is not enabled, <a href=\"#VkBuffer\">VkBuffer</a> objects created with the <code>VK_BUFFER_CREATE_SPARSE_RESIDENCY_BIT</code> flag <strong class=\"purple\">must</strong> not be accessed by atomic instructions through an <code>OpTypeImage</code> with a <code>SampledType</code> with a <code>Width</code> of 64 by this command"
|
|
}
|
|
],
|
|
"(VK_QCOM_image_processing)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-OpImageWeightedSampleQCOM-06971",
|
|
"text": " If <code>OpImageWeightedSampleQCOM</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_WEIGHT_SAMPLED_IMAGE_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-OpImageWeightedSampleQCOM-06972",
|
|
"text": " If <code>OpImageWeightedSampleQCOM</code> uses a <a href=\"#VkImageView\">VkImageView</a> as a sample weight image as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_WEIGHT_IMAGE_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-OpImageBoxFilterQCOM-06973",
|
|
"text": " If <code>OpImageBoxFilterQCOM</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_BOX_FILTER_SAMPLED_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-OpImageBlockMatchSSDQCOM-06974",
|
|
"text": " If <code>OpImageBlockMatchSSDQCOM</code> is used to read from an <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-OpImageBlockMatchSADQCOM-06975",
|
|
"text": " If <code>OpImageBlockMatchSADQCOM</code> is used to read from an <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-OpImageBlockMatchSADQCOM-06976",
|
|
"text": " If <code>OpImageBlockMatchSADQCOM</code> or OpImageBlockMatchSSDQCOM is used to read from a reference image as result of this command, then the specified reference coordinates <strong class=\"purple\">must</strong> not fail <a href=\"#textures-integer-coordinate-validation\">integer texel coordinate validation</a>."
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-OpImageWeightedSampleQCOM-06977",
|
|
"text": " If <code>OpImageWeightedSampleQCOM</code>, <code>OpImageBoxFilterQCOM</code>, <code>OpImageBlockMatchSSDQCOM</code>, or <code>OpImageBlockMatchSADQCOM</code> uses a <a href=\"#VkSampler\">VkSampler</a> as a result of this command, then the sampler <strong class=\"purple\">must</strong> have been created with <code>VK_SAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-OpImageWeightedSampleQCOM-06978",
|
|
"text": " If any command other than <code>OpImageWeightedSampleQCOM</code>, <code>OpImageBoxFilterQCOM</code>, <code>OpImageBlockMatchSSDQCOM</code>, or <code>OpImageBlockMatchSADQCOM</code> uses a <a href=\"#VkSampler\">VkSampler</a> as a result of this command, then the sampler <strong class=\"purple\">must</strong> not have been created with <code>VK_SAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM</code>."
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_multiview)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-maxMultiviewInstanceIndex-02688",
|
|
"text": " If the draw is recorded in a render pass instance with multiview enabled, the maximum instance index <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#VkPhysicalDeviceMultiviewProperties\">VkPhysicalDeviceMultiviewProperties</a>::<code>maxMultiviewInstanceIndex</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_sample_locations)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-sampleLocationsEnable-02689",
|
|
"text": " If the bound graphics pipeline was created with <a href=\"#VkPipelineSampleLocationsStateCreateInfoEXT\">VkPipelineSampleLocationsStateCreateInfoEXT</a>::<code>sampleLocationsEnable</code> set to <code>VK_TRUE</code> and the current subpass has a depth/stencil attachment, then that attachment <strong class=\"purple\">must</strong> have been created with the <code>VK_IMAGE_CREATE_SAMPLE_LOCATIONS_COMPATIBLE_DEPTH_BIT_EXT</code> bit set"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-None-06666",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_SAMPLE_LOCATIONS_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetSampleLocationsEXT\">vkCmdSetSampleLocationsEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-viewportCount-03417",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, but not the <code>VK_DYNAMIC_STATE_SCISSOR_WITH_COUNT</code> dynamic state enabled, then <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>viewportCount</code> parameter of <code>vkCmdSetViewportWithCount</code> <strong class=\"purple\">must</strong> match the <code>VkPipelineViewportStateCreateInfo</code>::<code>scissorCount</code> of the pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-scissorCount-03418",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_SCISSOR_WITH_COUNT</code> dynamic state enabled, but not the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, then <a href=\"#vkCmdSetScissorWithCount\">vkCmdSetScissorWithCount</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>scissorCount</code> parameter of <code>vkCmdSetScissorWithCount</code> <strong class=\"purple\">must</strong> match the <code>VkPipelineViewportStateCreateInfo</code>::<code>viewportCount</code> of the pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-viewportCount-03419",
|
|
"text": " If the bound graphics pipeline state was created with both the <code>VK_DYNAMIC_STATE_SCISSOR_WITH_COUNT</code> and <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic states enabled then both <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a> and <a href=\"#vkCmdSetScissorWithCount\">vkCmdSetScissorWithCount</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>viewportCount</code> parameter of <code>vkCmdSetViewportWithCount</code> <strong class=\"purple\">must</strong> match the <code>scissorCount</code> parameter of <code>vkCmdSetScissorWithCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-primitiveTopology-03420",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_PRIMITIVE_TOPOLOGY_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetPrimitiveTopologyEXT\">vkCmdSetPrimitiveTopologyEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>primitiveTopology</code> parameter of <code>vkCmdSetPrimitiveTopologyEXT</code> <strong class=\"purple\">must</strong> be of the same <a href=\"#drawing-primitive-topology-class\">topology class</a> as the pipeline <a href=\"#VkPipelineInputAssemblyStateCreateInfo\">VkPipelineInputAssemblyStateCreateInfo</a>::<code>topology</code> state"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_NV_clip_space_w_scaling)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-viewportCount-04137",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, but not the <code>VK_DYNAMIC_STATE_VIEWPORT_W_SCALING_NV</code> dynamic state enabled, then the bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <a href=\"#VkPipelineViewportWScalingStateCreateInfoNV\">VkPipelineViewportWScalingStateCreateInfoNV</a>::<code>viewportCount</code> greater or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-viewportCount-04138",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> and <code>VK_DYNAMIC_STATE_VIEWPORT_W_SCALING_NV</code> dynamic states enabled then the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWScalingNV\">vkCmdSetViewportWScalingNV</a> <strong class=\"purple\">must</strong> be greater than or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_NV_shading_rate_image)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-viewportCount-04139",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, but not the <code>VK_DYNAMIC_STATE_VIEWPORT_SHADING_RATE_PALETTE_NV</code> dynamic state enabled, then the bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <a href=\"#VkPipelineViewportShadingRateImageStateCreateInfoNV\">VkPipelineViewportShadingRateImageStateCreateInfoNV</a>::<code>viewportCount</code> greater or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-viewportCount-04140",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> and <code>VK_DYNAMIC_STATE_VIEWPORT_SHADING_RATE_PALETTE_NV</code> dynamic states enabled then the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportShadingRatePaletteNV\">vkCmdSetViewportShadingRatePaletteNV</a> <strong class=\"purple\">must</strong> be greater than or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_NV_viewport_swizzle)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-VkPipelineVieportCreateInfo-04141",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled and a <a href=\"#VkPipelineViewportSwizzleStateCreateInfoNV\">VkPipelineViewportSwizzleStateCreateInfoNV</a> structure chained from <code>VkPipelineVieportCreateInfo</code>, then the bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <a href=\"#VkPipelineViewportSwizzleStateCreateInfoNV\">VkPipelineViewportSwizzleStateCreateInfoNV</a>::<code>viewportCount</code> greater or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_NV_scissor_exclusive)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-VkPipelineVieportCreateInfo-04142",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled and a <a href=\"#VkPipelineViewportExclusiveScissorStateCreateInfoNV\">VkPipelineViewportExclusiveScissorStateCreateInfoNV</a> structure chained from <code>VkPipelineVieportCreateInfo</code>, then the bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <a href=\"#VkPipelineViewportExclusiveScissorStateCreateInfoNV\">VkPipelineViewportExclusiveScissorStateCreateInfoNV</a>::<code>exclusiveScissorCount</code> greater or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-None-04876",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_RASTERIZER_DISCARD_ENABLE</code> dynamic state enabled then <a href=\"#vkCmdSetRasterizerDiscardEnable\">vkCmdSetRasterizerDiscardEnable</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-None-04877",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_DEPTH_BIAS_ENABLE</code> dynamic state enabled then <a href=\"#vkCmdSetDepthBiasEnable\">vkCmdSetDepthBiasEnable</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-logicOp-04878",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_LOGIC_OP_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetLogicOpEXT\">vkCmdSetLogicOpEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command and the <code>logicOp</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkLogicOp\">VkLogicOp</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-None-04875",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_PATCH_CONTROL_POINTS_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetPatchControlPointsEXT\">vkCmdSetPatchControlPointsEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-None-04879",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_PRIMITIVE_RESTART_ENABLE_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetPrimitiveRestartEnableEXT\">vkCmdSetPrimitiveRestartEnableEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command"
|
|
}
|
|
],
|
|
"(VK_KHR_fragment_shading_rate)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-primitiveFragmentShadingRateWithMultipleViewports-04552",
|
|
"text": " If the <a href=\"#limits-primitiveFragmentShadingRateWithMultipleViewports\"><code>primitiveFragmentShadingRateWithMultipleViewports</code></a> limit is not supported, the bound graphics pipeline was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, and any of the shader stages of the bound graphics pipeline write to the <code>PrimitiveShadingRateKHR</code> built-in, then <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>viewportCount</code> parameter of <code>vkCmdSetViewportWithCount</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-imageView-06172",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pDepthAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pDepthAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the depth attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-imageView-06173",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pStencilAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pStencilAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the stencil attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-viewMask-06178",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound graphics pipeline <strong class=\"purple\">must</strong> have been created with a <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>viewMask</code> equal to <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>viewMask</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-colorAttachmentCount-06179",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound graphics pipeline <strong class=\"purple\">must</strong> have been created with a <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>colorAttachmentCount</code> equal to <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>colorAttachmentCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-colorAttachmentCount-06180",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>colorAttachmentCount</code> greater than <code>0</code>, then each element of the <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pColorAttachments</code> array with a <code>imageView</code> not equal to <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> <strong class=\"purple\">must</strong> have been created with a <a href=\"#VkFormat\">VkFormat</a> equal to the corresponding element of <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>pColorAttachmentFormats</code> used to create the currently bound graphics pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-pDepthAttachment-06181",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>depthAttachmentFormat</code> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the <a href=\"#VkFormat\">VkFormat</a> used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-pStencilAttachment-06182",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>stencilAttachmentFormat</code> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the <a href=\"#VkFormat\">VkFormat</a> used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_VERSION_1_1,VK_KHR_maintenance2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-imageView-06174",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pDepthAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pDepthAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_STENCIL_ATTACHMENT_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the depth attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-imageView-06175",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pStencilAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pStencilAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_STENCIL_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the stencil attachment"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_VERSION_1_2,VK_KHR_separate_depth_stencil_layouts)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-imageView-06176",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pDepthAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pDepthAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the depth attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-imageView-06177",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pStencilAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pStencilAttachment</code> is <code>VK_IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the stencil attachment"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_EXT_color_write_enable)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-attachmentCount-06667",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_COLOR_WRITE_ENABLE_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetColorWriteEnableEXT\">vkCmdSetColorWriteEnableEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>attachmentCount</code> parameter of <code>vkCmdSetColorWriteEnableEXT</code> <strong class=\"purple\">must</strong> be greater than or equal to the <code>VkPipelineColorBlendStateCreateInfo</code>::<code>attachmentCount</code> of the currently bound graphics pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-attachmentCount-06815",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_COLOR_WRITE_ENABLE_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetColorWriteEnableEXT\">vkCmdSetColorWriteEnableEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>attachmentCount</code> parameter of <code>vkCmdSetColorWriteEnableEXT</code> <strong class=\"purple\">must</strong> be less than or equal to the <code>maxColorAttachments</code> member of <code>VkPhysicalDeviceLimits</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_KHR_fragment_shading_rate)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-imageView-06183",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingFragmentShadingRateAttachmentInfoKHR\">VkRenderingFragmentShadingRateAttachmentInfoKHR</a>::<code>imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the currently bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <code>VK_PIPELINE_CREATE_RENDERING_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_EXT_fragment_density_map)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-imageView-06184",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingFragmentDensityMapAttachmentInfoEXT\">VkRenderingFragmentDensityMapAttachmentInfoEXT</a>::<code>imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the currently bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <code>VK_PIPELINE_CREATE_RENDERING_FRAGMENT_DENSITY_MAP_ATTACHMENT_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_AMD_mixed_attachment_samples,VK_NV_framebuffer_mixed_samples)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-colorAttachmentCount-06185",
|
|
"text": " If the currently bound pipeline was created with a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> with a <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>colorAttachmentCount</code> parameter greater than <code>0</code>, then each element of the <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pColorAttachments</code> array with a <code>imageView</code> not equal to <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> <strong class=\"purple\">must</strong> have been created with a sample count equal to the corresponding element of the <code>pColorAttachmentSamples</code> member of <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> used to create the currently bound graphics pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-pDepthAttachment-06186",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline was created with a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of the <code>depthStencilAttachmentSamples</code> member of <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the sample count used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-pStencilAttachment-06187",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline was created with a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of the <code>depthStencilAttachmentSamples</code> member of <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the sample count used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-colorAttachmentCount-06188",
|
|
"text": " If the currently bound pipeline was created without a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> with a <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>colorAttachmentCount</code> parameter greater than <code>0</code>, then each element of the <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pColorAttachments</code> array with a <code>imageView</code> not equal to <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> <strong class=\"purple\">must</strong> have been created with a sample count equal to the value of <a href=\"#VkPipelineMultisampleStateCreateInfo\">VkPipelineMultisampleStateCreateInfo</a>::<code>rasterizationSamples</code> used to create the currently bound graphics pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-pDepthAttachment-06189",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline was created without a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of <a href=\"#VkPipelineMultisampleStateCreateInfo\">VkPipelineMultisampleStateCreateInfo</a>::<code>rasterizationSamples</code> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the sample count used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-pStencilAttachment-06190",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline was created without a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of <a href=\"#VkPipelineMultisampleStateCreateInfo\">VkPipelineMultisampleStateCreateInfo</a>::<code>rasterizationSamples</code> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the sample count used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-renderPass-06198",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline <strong class=\"purple\">must</strong> have been created with a <a href=\"#VkGraphicsPipelineCreateInfo\">VkGraphicsPipelineCreateInfo</a>::<code>renderPass</code> equal to <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
}
|
|
],
|
|
"(VK_EXT_primitives_generated_query)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-primitivesGeneratedQueryWithRasterizerDiscard-06708",
|
|
"text": " If the <a href=\"#features-primitivesGeneratedQueryWithRasterizerDiscard\"><code>primitivesGeneratedQueryWithRasterizerDiscard</code></a> feature is not enabled and the <code>VK_QUERY_TYPE_PRIMITIVES_GENERATED_EXT</code> query is active, <a href=\"#primsrast-discard\">rasterization discard</a> <strong class=\"purple\">must</strong> not be enabled."
|
|
}
|
|
],
|
|
"(VK_EXT_primitives_generated_query)+(VK_EXT_transform_feedback)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-primitivesGeneratedQueryWithNonZeroStreams-06709",
|
|
"text": " If the <a href=\"#features-primitivesGeneratedQueryWithNonZeroStreams\"><code>primitivesGeneratedQueryWithNonZeroStreams</code></a> feature is not enabled and the <code>VK_QUERY_TYPE_PRIMITIVES_GENERATED_EXT</code> query is active, the bound graphics pipeline <strong class=\"purple\">must</strong> not have been created with a non-zero value in <code>VkPipelineRasterizationStateStreamCreateInfoEXT</code>::<code>rasterizationStream</code>."
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_EXT_vertex_input_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-None-04912",
|
|
"text": " If the bound graphics pipeline was created with both the <code>VK_DYNAMIC_STATE_VERTEX_INPUT_EXT</code> and <code>VK_DYNAMIC_STATE_VERTEX_INPUT_BINDING_STRIDE_EXT</code> dynamic states enabled, then <a href=\"#vkCmdSetVertexInputEXT\">vkCmdSetVertexInputEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this draw command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-pStrides-04913",
|
|
"text": " If the bound graphics pipeline was created with the <code>VK_DYNAMIC_STATE_VERTEX_INPUT_BINDING_STRIDE_EXT</code> dynamic state enabled, but not the <code>VK_DYNAMIC_STATE_VERTEX_INPUT_EXT</code> dynamic state enabled, then <a href=\"#vkCmdBindVertexBuffers2EXT\">vkCmdBindVertexBuffers2EXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this draw command, and the <code>pStrides</code> parameter of <a href=\"#vkCmdBindVertexBuffers2EXT\">vkCmdBindVertexBuffers2EXT</a> <strong class=\"purple\">must</strong> not be <code>NULL</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+!(VK_EXT_vertex_input_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-pStrides-04884",
|
|
"text": " If the bound graphics pipeline was created with the <code>VK_DYNAMIC_STATE_VERTEX_INPUT_BINDING_STRIDE_EXT</code> dynamic state enabled, then <a href=\"#vkCmdBindVertexBuffers2EXT\">vkCmdBindVertexBuffers2EXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>pStrides</code> parameter of <a href=\"#vkCmdBindVertexBuffers2EXT\">vkCmdBindVertexBuffers2EXT</a> <strong class=\"purple\">must</strong> not be <code>NULL</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_vertex_input_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-None-04914",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VERTEX_INPUT_EXT</code> dynamic state enabled, then <a href=\"#vkCmdSetVertexInputEXT\">vkCmdSetVertexInputEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this draw command"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDraw-stage-06481",
|
|
"text": " The bound graphics pipeline <strong class=\"purple\">must</strong> not have been created with the <a href=\"#VkPipelineShaderStageCreateInfo\">VkPipelineShaderStageCreateInfo</a>::<code>stage</code> member of an element of <a href=\"#VkGraphicsPipelineCreateInfo\">VkGraphicsPipelineCreateInfo</a>::<code>pStages</code> set to <code>VK_SHADER_STAGE_TASK_BIT_NV</code> or <code>VK_SHADER_STAGE_MESH_BIT_NV</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdDrawIndexed": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-magFilter-04553",
|
|
"text": " If a <a href=\"#VkSampler\">VkSampler</a> created with <code>magFilter</code> or <code>minFilter</code> equal to <code>VK_FILTER_LINEAR</code> and <code>compareEnable</code> equal to <code>VK_FALSE</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-mipmapMode-04770",
|
|
"text": " If a <a href=\"#VkSampler\">VkSampler</a> created with <code>mipmapMode</code> equal to <code>VK_SAMPLER_MIPMAP_MODE_LINEAR</code> and <code>compareEnable</code> equal to <code>VK_FALSE</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-None-02691",
|
|
"text": " If a <code>VkImageView</code> is accessed using atomic operations as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_STORAGE_IMAGE_ATOMIC_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-None-02697",
|
|
"text": " For each set <em>n</em> that is statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command, a descriptor set <strong class=\"purple\">must</strong> have been bound to <em>n</em> at the same pipeline bind point, with a <code>VkPipelineLayout</code> that is compatible for set <em>n</em>, with the <code>VkPipelineLayout</code> used to create the current <code>VkPipeline</code>, as described in <a href=\"#descriptorsets-compatibility\">Pipeline Layout Compatibility</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-None-02699",
|
|
"text": " Descriptors in each bound descriptor set, specified via <code>vkCmdBindDescriptorSets</code>, <strong class=\"purple\">must</strong> be valid if they are statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-None-02700",
|
|
"text": " A valid pipeline <strong class=\"purple\">must</strong> be bound to the pipeline bind point used by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-commandBuffer-02701",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command requires any dynamic state, that state <strong class=\"purple\">must</strong> have been set or inherited (if the <code><a href=\"#VK_NV_inherited_viewport_scissor\">VK_NV_inherited_viewport_scissor</a></code> extension is enabled) for <code>commandBuffer</code>, and done so after any previously bound pipeline with the corresponding state not specified as dynamic"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-None-02859",
|
|
"text": " There <strong class=\"purple\">must</strong> not have been any calls to dynamic state setting commands for any state not specified as dynamic in the <code>VkPipeline</code> object bound to the pipeline bind point used by this command, since that pipeline was bound"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-None-02702",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> object that uses unnormalized coordinates, that sampler <strong class=\"purple\">must</strong> not be used to sample from any <code>VkImage</code> with a <code>VkImageView</code> of the type <code>VK_IMAGE_VIEW_TYPE_3D</code>, <code>VK_IMAGE_VIEW_TYPE_CUBE</code>, <code>VK_IMAGE_VIEW_TYPE_1D_ARRAY</code>, <code>VK_IMAGE_VIEW_TYPE_2D_ARRAY</code> or <code>VK_IMAGE_VIEW_TYPE_CUBE_ARRAY</code>, in any shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-None-02703",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> object that uses unnormalized coordinates, that sampler <strong class=\"purple\">must</strong> not be used with any of the SPIR-V <code>OpImageSample*</code> or <code>OpImageSparseSample*</code> instructions with <code>ImplicitLod</code>, <code>Dref</code> or <code>Proj</code> in their name, in any shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-None-02704",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> object that uses unnormalized coordinates, that sampler <strong class=\"purple\">must</strong> not be used with any of the SPIR-V <code>OpImageSample*</code> or <code>OpImageSparseSample*</code> instructions that includes a LOD bias or any offset values, in any shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-None-04115",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> is accessed using <code>OpImageWrite</code> as a result of this command, then the <code>Type</code> of the <code>Texel</code> operand of that instruction <strong class=\"purple\">must</strong> have at least as many components as the image view’s format"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-OpImageWrite-04469",
|
|
"text": " If a <a href=\"#VkBufferView\">VkBufferView</a> is accessed using <code>OpImageWrite</code> as a result of this command, then the <code>Type</code> of the <code>Texel</code> operand of that instruction <strong class=\"purple\">must</strong> have at least as many components as the buffer view’s format"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-renderPass-02684",
|
|
"text": " The current render pass <strong class=\"purple\">must</strong> be <a href=\"#renderpass-compatibility\">compatible</a> with the <code>renderPass</code> member of the <code>VkGraphicsPipelineCreateInfo</code> structure specified when creating the <code>VkPipeline</code> bound to <code>VK_PIPELINE_BIND_POINT_GRAPHICS</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-subpass-02685",
|
|
"text": " The subpass index of the current render pass <strong class=\"purple\">must</strong> be equal to the <code>subpass</code> member of the <code>VkGraphicsPipelineCreateInfo</code> structure specified when creating the <code>VkPipeline</code> bound to <code>VK_PIPELINE_BIND_POINT_GRAPHICS</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-None-02686",
|
|
"text": " Every input attachment used by the current subpass <strong class=\"purple\">must</strong> be bound to the pipeline via a descriptor set"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-None-06537",
|
|
"text": " Memory backing image subresources used as attachments in the current render pass <strong class=\"purple\">must</strong> not be written in any way other than as an attachment by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-None-06538",
|
|
"text": " If any recorded command in the current subpass will write to an image subresource as an attachment, this command <strong class=\"purple\">must</strong> not read from the memory backing that image subresource in any other way than as an attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-None-06539",
|
|
"text": " If any recorded command in the current subpass will read from an image subresource used as an attachment in any way other than as an attachment, this command <strong class=\"purple\">must</strong> not write to that image subresource as an attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-None-06886",
|
|
"text": " If the current render pass instance uses a depth/stencil attachment with a read-only layout for the depth aspect, <a href=\"#fragops-depth-write\">depth writes</a> <strong class=\"purple\">must</strong> be disabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-None-06887",
|
|
"text": " If the current render pass instance uses a depth/stencil attachment with a read-only layout for the stencil aspect and stencil test is enabled, <a href=\"#fragops-stencil\">all stencil ops</a> <strong class=\"purple\">must</strong> be <code>VK_STENCIL_OP_KEEP</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-blendEnable-04727",
|
|
"text": " If rasterization is not disabled in the bound graphics pipeline, then for each color attachment in the subpass, if the corresponding image view’s <a href=\"#resources-image-view-format-features\">format features</a> do not contain <code>VK_FORMAT_FEATURE_COLOR_ATTACHMENT_BLEND_BIT</code>, then the <code>blendEnable</code> member of the corresponding element of the <code>pAttachments</code> member of <code>pColorBlendState</code> <strong class=\"purple\">must</strong> be <code>VK_FALSE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-rasterizationSamples-04740",
|
|
"text": " If rasterization is not disabled in the bound graphics pipeline, and neither the <code><a href=\"#VK_AMD_mixed_attachment_samples\">VK_AMD_mixed_attachment_samples</a></code> nor the <code><a href=\"#VK_NV_framebuffer_mixed_samples\">VK_NV_framebuffer_mixed_samples</a></code> extensions are enabled, then <a href=\"#VkPipelineMultisampleStateCreateInfo\">VkPipelineMultisampleStateCreateInfo</a>::<code>rasterizationSamples</code> <strong class=\"purple\">must</strong> be the same as the current subpass color and/or depth/stencil attachments"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-None-04007",
|
|
"text": " All vertex input bindings accessed via vertex input variables declared in the vertex shader entry point’s interface <strong class=\"purple\">must</strong> have either valid or <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> buffers bound"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-None-04008",
|
|
"text": " If the <a href=\"#features-nullDescriptor\"><code>nullDescriptor</code></a> feature is not enabled, all vertex input bindings accessed via vertex input variables declared in the vertex shader entry point’s interface <strong class=\"purple\">must</strong> not be <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-None-02721",
|
|
"text": " For a given vertex buffer binding, any attribute data fetched <strong class=\"purple\">must</strong> be entirely contained within the corresponding vertex buffer binding, as described in <a href=\"#fxvertex-input\">Vertex Input Description</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-firstIndex-04932",
|
|
"text": " <span class=\"eq\">(<code>indexSize</code> {times} (<code>firstIndex</code> + <code>indexCount</code>) + <code>offset</code>)</span> <strong class=\"purple\">must</strong> be less than or equal to the size of the bound index buffer, with <code>indexSize</code> being based on the type specified by <code>indexType</code>, where the index buffer, <code>indexType</code>, and <code>offset</code> are specified via <code>vkCmdBindIndexBuffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called inside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
],
|
|
"!(VK_VERSION_1_3,VK_KHR_format_feature_flags2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-aspectMask-06478",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> is sampled with <a href=\"#textures-depth-compare-operation\">depth comparison</a>, the image view <strong class=\"purple\">must</strong> have been created with an <code>aspectMask</code> that contains <code>VK_IMAGE_ASPECT_DEPTH_BIT</code>."
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_format_feature_flags2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-None-06479",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> is sampled with <a href=\"#textures-depth-compare-operation\">depth comparison</a>, the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_SAMPLED_IMAGE_DEPTH_COMPARISON_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-OpTypeImage-06423",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> or <a href=\"#VkBufferView\">VkBufferView</a> being written as a storage image or storage texel buffer where the image format field of the <code>OpTypeImage</code> is <code>Unknown</code> then the view’s format feature <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_STORAGE_WRITE_WITHOUT_FORMAT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-OpTypeImage-06424",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> or <a href=\"#VkBufferView\">VkBufferView</a> being read as a storage image or storage texel buffer where the image format field of the <code>OpTypeImage</code> is <code>Unknown</code> then the view’s format feature <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_STORAGE_READ_WITHOUT_FORMAT_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_IMG_filter_cubic,VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-None-02692",
|
|
"text": " If a <code>VkImageView</code> is sampled with <code>VK_FILTER_CUBIC_EXT</code> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_CUBIC_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_IMG_filter_cubic,VK_EXT_filter_cubic)+!(VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-None-02693",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> being sampled with <code>VK_FILTER_CUBIC_EXT</code> as a result of this command <strong class=\"purple\">must</strong> not have a <a href=\"#VkImageViewType\">VkImageViewType</a> of <code>VK_IMAGE_VIEW_TYPE_3D</code>, <code>VK_IMAGE_VIEW_TYPE_CUBE</code>, or <code>VK_IMAGE_VIEW_TYPE_CUBE_ARRAY</code>"
|
|
}
|
|
],
|
|
"(VK_IMG_filter_cubic,VK_EXT_filter_cubic)+(VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-filterCubic-02694",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> being sampled with <code>VK_FILTER_CUBIC_EXT</code> as a result of this command <strong class=\"purple\">must</strong> have a <a href=\"#VkImageViewType\">VkImageViewType</a> and format that supports cubic filtering, as specified by <code>VkFilterCubicImageViewImageFormatPropertiesEXT</code>::<code>filterCubic</code> returned by <code>vkGetPhysicalDeviceImageFormatProperties2</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-filterCubicMinmax-02695",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> being sampled with <code>VK_FILTER_CUBIC_EXT</code> with a reduction mode of either <code>VK_SAMPLER_REDUCTION_MODE_MIN</code> or <code>VK_SAMPLER_REDUCTION_MODE_MAX</code> as a result of this command <strong class=\"purple\">must</strong> have a <a href=\"#VkImageViewType\">VkImageViewType</a> and format that supports cubic filtering together with minmax filtering, as specified by <code>VkFilterCubicImageViewImageFormatPropertiesEXT</code>::<code>filterCubicMinmax</code> returned by <code>vkGetPhysicalDeviceImageFormatProperties2</code>"
|
|
}
|
|
],
|
|
"(VK_NV_corner_sampled_image)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-flags-02696",
|
|
"text": " Any <a href=\"#VkImage\">VkImage</a> created with a <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a>::<code>flags</code> containing <code>VK_IMAGE_CREATE_CORNER_SAMPLED_BIT_NV</code> sampled as a result of this command <strong class=\"purple\">must</strong> only be sampled using a <a href=\"#VkSamplerAddressMode\">VkSamplerAddressMode</a> of <code>VK_SAMPLER_ADDRESS_MODE_CLAMP_TO_EDGE</code>"
|
|
}
|
|
],
|
|
"!(VK_VERSION_1_3,VK_KHR_maintenance4)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-None-02698",
|
|
"text": " For each push constant that is statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command, a push constant value <strong class=\"purple\">must</strong> have been set for the same pipeline bind point, with a <code>VkPipelineLayout</code> that is compatible for push constants, with the <code>VkPipelineLayout</code> used to create the current <code>VkPipeline</code>, as described in <a href=\"#descriptorsets-compatibility\">Pipeline Layout Compatibility</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_maintenance4)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-maintenance4-06425",
|
|
"text": " If the <a href=\"#features-maintenance4\"><code>maintenance4</code></a> feature is not enabled, then for each push constant that is statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command, a push constant value <strong class=\"purple\">must</strong> have been set for the same pipeline bind point, with a <code>VkPipelineLayout</code> that is compatible for push constants, with the <code>VkPipelineLayout</code> used to create the current <code>VkPipeline</code>, as described in <a href=\"#descriptorsets-compatibility\">Pipeline Layout Compatibility</a>"
|
|
}
|
|
],
|
|
"!(VK_EXT_pipeline_robustness)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-None-02705",
|
|
"text": " If the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, and if the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a uniform buffer, it <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-None-02706",
|
|
"text": " If the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, and if the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a storage buffer, it <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
}
|
|
],
|
|
"(VK_EXT_pipeline_robustness)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-uniformBuffers-06935",
|
|
"text": " If any stage of the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a uniform buffer, and that stage was created without enabling either <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_EXT</code> or <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXT</code> for <code>uniformBuffers</code>, and the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, that stage <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-storageBuffers-06936",
|
|
"text": " If any stage of the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a storage buffer, and that stage was created without enabling either <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_EXT</code> or <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXT</code> for <code>storageBuffers</code>, and the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, that stage <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-commandBuffer-02707",
|
|
"text": " If <code>commandBuffer</code> is an unprotected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, any resource accessed by the <a href=\"#VkPipeline\">VkPipeline</a> object bound to the pipeline bind point used by this command <strong class=\"purple\">must</strong> not be a protected resource"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-commandBuffer-02712",
|
|
"text": " If <code>commandBuffer</code> is a protected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, any resource written to by the <code>VkPipeline</code> object bound to the pipeline bind point used by this command <strong class=\"purple\">must</strong> not be an unprotected resource"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-commandBuffer-02713",
|
|
"text": " If <code>commandBuffer</code> is a protected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, pipeline stages other than the framebuffer-space and compute stages in the <code>VkPipeline</code> object bound to the pipeline bind point used by this command <strong class=\"purple\">must</strong> not write to any resource"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-commandBuffer-04617",
|
|
"text": " If any of the shader stages of the <code>VkPipeline</code> bound to the pipeline bind point used by this command uses the <a href=\"#spirvenv-capabilities-table-RayQueryKHR\"><code>RayQueryKHR</code></a> capability, then <code>commandBuffer</code> <strong class=\"purple\">must</strong> not be a protected command buffer"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-None-06550",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> or <code>VkImageView</code> object that enables <a href=\"#samplers-YCbCr-conversion\">sampler {YCbCr} conversion</a>, that object <strong class=\"purple\">must</strong> only be used with <code>OpImageSample*</code> or <code>OpImageSparseSample*</code> instructions"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-ConstOffset-06551",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> or <code>VkImageView</code> object that enables <a href=\"#samplers-YCbCr-conversion\">sampler {YCbCr} conversion</a>, that object <strong class=\"purple\">must</strong> not use the <code>ConstOffset</code> and <code>Offset</code> operands"
|
|
}
|
|
],
|
|
"(VK_EXT_shader_image_atomic_int64)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-SampledType-04470",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a 64-bit component width is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 64"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-SampledType-04471",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a component width less than 64-bit is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 32"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-SampledType-04472",
|
|
"text": " If a <a href=\"#VkBufferView\">VkBufferView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a 64-bit component width is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 64"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-SampledType-04473",
|
|
"text": " If a <a href=\"#VkBufferView\">VkBufferView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a component width less than 64-bit is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 32"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-sparseImageInt64Atomics-04474",
|
|
"text": " If the <a href=\"#features-sparseImageInt64Atomics\"><code>sparseImageInt64Atomics</code></a> feature is not enabled, <a href=\"#VkImage\">VkImage</a> objects created with the <code>VK_IMAGE_CREATE_SPARSE_RESIDENCY_BIT</code> flag <strong class=\"purple\">must</strong> not be accessed by atomic instructions through an <code>OpTypeImage</code> with a <code>SampledType</code> with a <code>Width</code> of 64 by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-sparseImageInt64Atomics-04475",
|
|
"text": " If the <a href=\"#features-sparseImageInt64Atomics\"><code>sparseImageInt64Atomics</code></a> feature is not enabled, <a href=\"#VkBuffer\">VkBuffer</a> objects created with the <code>VK_BUFFER_CREATE_SPARSE_RESIDENCY_BIT</code> flag <strong class=\"purple\">must</strong> not be accessed by atomic instructions through an <code>OpTypeImage</code> with a <code>SampledType</code> with a <code>Width</code> of 64 by this command"
|
|
}
|
|
],
|
|
"(VK_QCOM_image_processing)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-OpImageWeightedSampleQCOM-06971",
|
|
"text": " If <code>OpImageWeightedSampleQCOM</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_WEIGHT_SAMPLED_IMAGE_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-OpImageWeightedSampleQCOM-06972",
|
|
"text": " If <code>OpImageWeightedSampleQCOM</code> uses a <a href=\"#VkImageView\">VkImageView</a> as a sample weight image as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_WEIGHT_IMAGE_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-OpImageBoxFilterQCOM-06973",
|
|
"text": " If <code>OpImageBoxFilterQCOM</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_BOX_FILTER_SAMPLED_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-OpImageBlockMatchSSDQCOM-06974",
|
|
"text": " If <code>OpImageBlockMatchSSDQCOM</code> is used to read from an <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-OpImageBlockMatchSADQCOM-06975",
|
|
"text": " If <code>OpImageBlockMatchSADQCOM</code> is used to read from an <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-OpImageBlockMatchSADQCOM-06976",
|
|
"text": " If <code>OpImageBlockMatchSADQCOM</code> or OpImageBlockMatchSSDQCOM is used to read from a reference image as result of this command, then the specified reference coordinates <strong class=\"purple\">must</strong> not fail <a href=\"#textures-integer-coordinate-validation\">integer texel coordinate validation</a>."
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-OpImageWeightedSampleQCOM-06977",
|
|
"text": " If <code>OpImageWeightedSampleQCOM</code>, <code>OpImageBoxFilterQCOM</code>, <code>OpImageBlockMatchSSDQCOM</code>, or <code>OpImageBlockMatchSADQCOM</code> uses a <a href=\"#VkSampler\">VkSampler</a> as a result of this command, then the sampler <strong class=\"purple\">must</strong> have been created with <code>VK_SAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-OpImageWeightedSampleQCOM-06978",
|
|
"text": " If any command other than <code>OpImageWeightedSampleQCOM</code>, <code>OpImageBoxFilterQCOM</code>, <code>OpImageBlockMatchSSDQCOM</code>, or <code>OpImageBlockMatchSADQCOM</code> uses a <a href=\"#VkSampler\">VkSampler</a> as a result of this command, then the sampler <strong class=\"purple\">must</strong> not have been created with <code>VK_SAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM</code>."
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_multiview)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-maxMultiviewInstanceIndex-02688",
|
|
"text": " If the draw is recorded in a render pass instance with multiview enabled, the maximum instance index <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#VkPhysicalDeviceMultiviewProperties\">VkPhysicalDeviceMultiviewProperties</a>::<code>maxMultiviewInstanceIndex</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_sample_locations)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-sampleLocationsEnable-02689",
|
|
"text": " If the bound graphics pipeline was created with <a href=\"#VkPipelineSampleLocationsStateCreateInfoEXT\">VkPipelineSampleLocationsStateCreateInfoEXT</a>::<code>sampleLocationsEnable</code> set to <code>VK_TRUE</code> and the current subpass has a depth/stencil attachment, then that attachment <strong class=\"purple\">must</strong> have been created with the <code>VK_IMAGE_CREATE_SAMPLE_LOCATIONS_COMPATIBLE_DEPTH_BIT_EXT</code> bit set"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-None-06666",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_SAMPLE_LOCATIONS_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetSampleLocationsEXT\">vkCmdSetSampleLocationsEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-viewportCount-03417",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, but not the <code>VK_DYNAMIC_STATE_SCISSOR_WITH_COUNT</code> dynamic state enabled, then <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>viewportCount</code> parameter of <code>vkCmdSetViewportWithCount</code> <strong class=\"purple\">must</strong> match the <code>VkPipelineViewportStateCreateInfo</code>::<code>scissorCount</code> of the pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-scissorCount-03418",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_SCISSOR_WITH_COUNT</code> dynamic state enabled, but not the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, then <a href=\"#vkCmdSetScissorWithCount\">vkCmdSetScissorWithCount</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>scissorCount</code> parameter of <code>vkCmdSetScissorWithCount</code> <strong class=\"purple\">must</strong> match the <code>VkPipelineViewportStateCreateInfo</code>::<code>viewportCount</code> of the pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-viewportCount-03419",
|
|
"text": " If the bound graphics pipeline state was created with both the <code>VK_DYNAMIC_STATE_SCISSOR_WITH_COUNT</code> and <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic states enabled then both <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a> and <a href=\"#vkCmdSetScissorWithCount\">vkCmdSetScissorWithCount</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>viewportCount</code> parameter of <code>vkCmdSetViewportWithCount</code> <strong class=\"purple\">must</strong> match the <code>scissorCount</code> parameter of <code>vkCmdSetScissorWithCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-primitiveTopology-03420",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_PRIMITIVE_TOPOLOGY_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetPrimitiveTopologyEXT\">vkCmdSetPrimitiveTopologyEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>primitiveTopology</code> parameter of <code>vkCmdSetPrimitiveTopologyEXT</code> <strong class=\"purple\">must</strong> be of the same <a href=\"#drawing-primitive-topology-class\">topology class</a> as the pipeline <a href=\"#VkPipelineInputAssemblyStateCreateInfo\">VkPipelineInputAssemblyStateCreateInfo</a>::<code>topology</code> state"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_NV_clip_space_w_scaling)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-viewportCount-04137",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, but not the <code>VK_DYNAMIC_STATE_VIEWPORT_W_SCALING_NV</code> dynamic state enabled, then the bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <a href=\"#VkPipelineViewportWScalingStateCreateInfoNV\">VkPipelineViewportWScalingStateCreateInfoNV</a>::<code>viewportCount</code> greater or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-viewportCount-04138",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> and <code>VK_DYNAMIC_STATE_VIEWPORT_W_SCALING_NV</code> dynamic states enabled then the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWScalingNV\">vkCmdSetViewportWScalingNV</a> <strong class=\"purple\">must</strong> be greater than or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_NV_shading_rate_image)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-viewportCount-04139",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, but not the <code>VK_DYNAMIC_STATE_VIEWPORT_SHADING_RATE_PALETTE_NV</code> dynamic state enabled, then the bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <a href=\"#VkPipelineViewportShadingRateImageStateCreateInfoNV\">VkPipelineViewportShadingRateImageStateCreateInfoNV</a>::<code>viewportCount</code> greater or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-viewportCount-04140",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> and <code>VK_DYNAMIC_STATE_VIEWPORT_SHADING_RATE_PALETTE_NV</code> dynamic states enabled then the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportShadingRatePaletteNV\">vkCmdSetViewportShadingRatePaletteNV</a> <strong class=\"purple\">must</strong> be greater than or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_NV_viewport_swizzle)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-VkPipelineVieportCreateInfo-04141",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled and a <a href=\"#VkPipelineViewportSwizzleStateCreateInfoNV\">VkPipelineViewportSwizzleStateCreateInfoNV</a> structure chained from <code>VkPipelineVieportCreateInfo</code>, then the bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <a href=\"#VkPipelineViewportSwizzleStateCreateInfoNV\">VkPipelineViewportSwizzleStateCreateInfoNV</a>::<code>viewportCount</code> greater or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_NV_scissor_exclusive)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-VkPipelineVieportCreateInfo-04142",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled and a <a href=\"#VkPipelineViewportExclusiveScissorStateCreateInfoNV\">VkPipelineViewportExclusiveScissorStateCreateInfoNV</a> structure chained from <code>VkPipelineVieportCreateInfo</code>, then the bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <a href=\"#VkPipelineViewportExclusiveScissorStateCreateInfoNV\">VkPipelineViewportExclusiveScissorStateCreateInfoNV</a>::<code>exclusiveScissorCount</code> greater or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-None-04876",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_RASTERIZER_DISCARD_ENABLE</code> dynamic state enabled then <a href=\"#vkCmdSetRasterizerDiscardEnable\">vkCmdSetRasterizerDiscardEnable</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-None-04877",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_DEPTH_BIAS_ENABLE</code> dynamic state enabled then <a href=\"#vkCmdSetDepthBiasEnable\">vkCmdSetDepthBiasEnable</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-logicOp-04878",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_LOGIC_OP_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetLogicOpEXT\">vkCmdSetLogicOpEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command and the <code>logicOp</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkLogicOp\">VkLogicOp</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-None-04875",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_PATCH_CONTROL_POINTS_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetPatchControlPointsEXT\">vkCmdSetPatchControlPointsEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-None-04879",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_PRIMITIVE_RESTART_ENABLE_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetPrimitiveRestartEnableEXT\">vkCmdSetPrimitiveRestartEnableEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command"
|
|
}
|
|
],
|
|
"(VK_KHR_fragment_shading_rate)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-primitiveFragmentShadingRateWithMultipleViewports-04552",
|
|
"text": " If the <a href=\"#limits-primitiveFragmentShadingRateWithMultipleViewports\"><code>primitiveFragmentShadingRateWithMultipleViewports</code></a> limit is not supported, the bound graphics pipeline was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, and any of the shader stages of the bound graphics pipeline write to the <code>PrimitiveShadingRateKHR</code> built-in, then <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>viewportCount</code> parameter of <code>vkCmdSetViewportWithCount</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-imageView-06172",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pDepthAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pDepthAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the depth attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-imageView-06173",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pStencilAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pStencilAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the stencil attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-viewMask-06178",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound graphics pipeline <strong class=\"purple\">must</strong> have been created with a <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>viewMask</code> equal to <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>viewMask</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-colorAttachmentCount-06179",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound graphics pipeline <strong class=\"purple\">must</strong> have been created with a <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>colorAttachmentCount</code> equal to <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>colorAttachmentCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-colorAttachmentCount-06180",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>colorAttachmentCount</code> greater than <code>0</code>, then each element of the <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pColorAttachments</code> array with a <code>imageView</code> not equal to <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> <strong class=\"purple\">must</strong> have been created with a <a href=\"#VkFormat\">VkFormat</a> equal to the corresponding element of <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>pColorAttachmentFormats</code> used to create the currently bound graphics pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-pDepthAttachment-06181",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>depthAttachmentFormat</code> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the <a href=\"#VkFormat\">VkFormat</a> used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-pStencilAttachment-06182",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>stencilAttachmentFormat</code> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the <a href=\"#VkFormat\">VkFormat</a> used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_VERSION_1_1,VK_KHR_maintenance2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-imageView-06174",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pDepthAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pDepthAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_STENCIL_ATTACHMENT_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the depth attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-imageView-06175",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pStencilAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pStencilAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_STENCIL_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the stencil attachment"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_VERSION_1_2,VK_KHR_separate_depth_stencil_layouts)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-imageView-06176",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pDepthAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pDepthAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the depth attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-imageView-06177",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pStencilAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pStencilAttachment</code> is <code>VK_IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the stencil attachment"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_EXT_color_write_enable)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-attachmentCount-06667",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_COLOR_WRITE_ENABLE_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetColorWriteEnableEXT\">vkCmdSetColorWriteEnableEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>attachmentCount</code> parameter of <code>vkCmdSetColorWriteEnableEXT</code> <strong class=\"purple\">must</strong> be greater than or equal to the <code>VkPipelineColorBlendStateCreateInfo</code>::<code>attachmentCount</code> of the currently bound graphics pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-attachmentCount-06815",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_COLOR_WRITE_ENABLE_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetColorWriteEnableEXT\">vkCmdSetColorWriteEnableEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>attachmentCount</code> parameter of <code>vkCmdSetColorWriteEnableEXT</code> <strong class=\"purple\">must</strong> be less than or equal to the <code>maxColorAttachments</code> member of <code>VkPhysicalDeviceLimits</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_KHR_fragment_shading_rate)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-imageView-06183",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingFragmentShadingRateAttachmentInfoKHR\">VkRenderingFragmentShadingRateAttachmentInfoKHR</a>::<code>imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the currently bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <code>VK_PIPELINE_CREATE_RENDERING_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_EXT_fragment_density_map)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-imageView-06184",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingFragmentDensityMapAttachmentInfoEXT\">VkRenderingFragmentDensityMapAttachmentInfoEXT</a>::<code>imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the currently bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <code>VK_PIPELINE_CREATE_RENDERING_FRAGMENT_DENSITY_MAP_ATTACHMENT_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_AMD_mixed_attachment_samples,VK_NV_framebuffer_mixed_samples)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-colorAttachmentCount-06185",
|
|
"text": " If the currently bound pipeline was created with a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> with a <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>colorAttachmentCount</code> parameter greater than <code>0</code>, then each element of the <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pColorAttachments</code> array with a <code>imageView</code> not equal to <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> <strong class=\"purple\">must</strong> have been created with a sample count equal to the corresponding element of the <code>pColorAttachmentSamples</code> member of <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> used to create the currently bound graphics pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-pDepthAttachment-06186",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline was created with a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of the <code>depthStencilAttachmentSamples</code> member of <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the sample count used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-pStencilAttachment-06187",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline was created with a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of the <code>depthStencilAttachmentSamples</code> member of <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the sample count used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-colorAttachmentCount-06188",
|
|
"text": " If the currently bound pipeline was created without a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> with a <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>colorAttachmentCount</code> parameter greater than <code>0</code>, then each element of the <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pColorAttachments</code> array with a <code>imageView</code> not equal to <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> <strong class=\"purple\">must</strong> have been created with a sample count equal to the value of <a href=\"#VkPipelineMultisampleStateCreateInfo\">VkPipelineMultisampleStateCreateInfo</a>::<code>rasterizationSamples</code> used to create the currently bound graphics pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-pDepthAttachment-06189",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline was created without a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of <a href=\"#VkPipelineMultisampleStateCreateInfo\">VkPipelineMultisampleStateCreateInfo</a>::<code>rasterizationSamples</code> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the sample count used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-pStencilAttachment-06190",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline was created without a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of <a href=\"#VkPipelineMultisampleStateCreateInfo\">VkPipelineMultisampleStateCreateInfo</a>::<code>rasterizationSamples</code> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the sample count used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-renderPass-06198",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline <strong class=\"purple\">must</strong> have been created with a <a href=\"#VkGraphicsPipelineCreateInfo\">VkGraphicsPipelineCreateInfo</a>::<code>renderPass</code> equal to <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
}
|
|
],
|
|
"(VK_EXT_primitives_generated_query)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-primitivesGeneratedQueryWithRasterizerDiscard-06708",
|
|
"text": " If the <a href=\"#features-primitivesGeneratedQueryWithRasterizerDiscard\"><code>primitivesGeneratedQueryWithRasterizerDiscard</code></a> feature is not enabled and the <code>VK_QUERY_TYPE_PRIMITIVES_GENERATED_EXT</code> query is active, <a href=\"#primsrast-discard\">rasterization discard</a> <strong class=\"purple\">must</strong> not be enabled."
|
|
}
|
|
],
|
|
"(VK_EXT_primitives_generated_query)+(VK_EXT_transform_feedback)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-primitivesGeneratedQueryWithNonZeroStreams-06709",
|
|
"text": " If the <a href=\"#features-primitivesGeneratedQueryWithNonZeroStreams\"><code>primitivesGeneratedQueryWithNonZeroStreams</code></a> feature is not enabled and the <code>VK_QUERY_TYPE_PRIMITIVES_GENERATED_EXT</code> query is active, the bound graphics pipeline <strong class=\"purple\">must</strong> not have been created with a non-zero value in <code>VkPipelineRasterizationStateStreamCreateInfoEXT</code>::<code>rasterizationStream</code>."
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_EXT_vertex_input_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-None-04912",
|
|
"text": " If the bound graphics pipeline was created with both the <code>VK_DYNAMIC_STATE_VERTEX_INPUT_EXT</code> and <code>VK_DYNAMIC_STATE_VERTEX_INPUT_BINDING_STRIDE_EXT</code> dynamic states enabled, then <a href=\"#vkCmdSetVertexInputEXT\">vkCmdSetVertexInputEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this draw command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-pStrides-04913",
|
|
"text": " If the bound graphics pipeline was created with the <code>VK_DYNAMIC_STATE_VERTEX_INPUT_BINDING_STRIDE_EXT</code> dynamic state enabled, but not the <code>VK_DYNAMIC_STATE_VERTEX_INPUT_EXT</code> dynamic state enabled, then <a href=\"#vkCmdBindVertexBuffers2EXT\">vkCmdBindVertexBuffers2EXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this draw command, and the <code>pStrides</code> parameter of <a href=\"#vkCmdBindVertexBuffers2EXT\">vkCmdBindVertexBuffers2EXT</a> <strong class=\"purple\">must</strong> not be <code>NULL</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+!(VK_EXT_vertex_input_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-pStrides-04884",
|
|
"text": " If the bound graphics pipeline was created with the <code>VK_DYNAMIC_STATE_VERTEX_INPUT_BINDING_STRIDE_EXT</code> dynamic state enabled, then <a href=\"#vkCmdBindVertexBuffers2EXT\">vkCmdBindVertexBuffers2EXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>pStrides</code> parameter of <a href=\"#vkCmdBindVertexBuffers2EXT\">vkCmdBindVertexBuffers2EXT</a> <strong class=\"purple\">must</strong> not be <code>NULL</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_vertex_input_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-None-04914",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VERTEX_INPUT_EXT</code> dynamic state enabled, then <a href=\"#vkCmdSetVertexInputEXT\">vkCmdSetVertexInputEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this draw command"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexed-stage-06481",
|
|
"text": " The bound graphics pipeline <strong class=\"purple\">must</strong> not have been created with the <a href=\"#VkPipelineShaderStageCreateInfo\">VkPipelineShaderStageCreateInfo</a>::<code>stage</code> member of an element of <a href=\"#VkGraphicsPipelineCreateInfo\">VkGraphicsPipelineCreateInfo</a>::<code>pStages</code> set to <code>VK_SHADER_STAGE_TASK_BIT_NV</code> or <code>VK_SHADER_STAGE_MESH_BIT_NV</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdDrawMultiEXT": {
|
|
"(VK_EXT_multi_draw)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-magFilter-04553",
|
|
"text": " If a <a href=\"#VkSampler\">VkSampler</a> created with <code>magFilter</code> or <code>minFilter</code> equal to <code>VK_FILTER_LINEAR</code> and <code>compareEnable</code> equal to <code>VK_FALSE</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-mipmapMode-04770",
|
|
"text": " If a <a href=\"#VkSampler\">VkSampler</a> created with <code>mipmapMode</code> equal to <code>VK_SAMPLER_MIPMAP_MODE_LINEAR</code> and <code>compareEnable</code> equal to <code>VK_FALSE</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-None-02691",
|
|
"text": " If a <code>VkImageView</code> is accessed using atomic operations as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_STORAGE_IMAGE_ATOMIC_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-None-02697",
|
|
"text": " For each set <em>n</em> that is statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command, a descriptor set <strong class=\"purple\">must</strong> have been bound to <em>n</em> at the same pipeline bind point, with a <code>VkPipelineLayout</code> that is compatible for set <em>n</em>, with the <code>VkPipelineLayout</code> used to create the current <code>VkPipeline</code>, as described in <a href=\"#descriptorsets-compatibility\">Pipeline Layout Compatibility</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-None-02699",
|
|
"text": " Descriptors in each bound descriptor set, specified via <code>vkCmdBindDescriptorSets</code>, <strong class=\"purple\">must</strong> be valid if they are statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-None-02700",
|
|
"text": " A valid pipeline <strong class=\"purple\">must</strong> be bound to the pipeline bind point used by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-commandBuffer-02701",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command requires any dynamic state, that state <strong class=\"purple\">must</strong> have been set or inherited (if the <code><a href=\"#VK_NV_inherited_viewport_scissor\">VK_NV_inherited_viewport_scissor</a></code> extension is enabled) for <code>commandBuffer</code>, and done so after any previously bound pipeline with the corresponding state not specified as dynamic"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-None-02859",
|
|
"text": " There <strong class=\"purple\">must</strong> not have been any calls to dynamic state setting commands for any state not specified as dynamic in the <code>VkPipeline</code> object bound to the pipeline bind point used by this command, since that pipeline was bound"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-None-02702",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> object that uses unnormalized coordinates, that sampler <strong class=\"purple\">must</strong> not be used to sample from any <code>VkImage</code> with a <code>VkImageView</code> of the type <code>VK_IMAGE_VIEW_TYPE_3D</code>, <code>VK_IMAGE_VIEW_TYPE_CUBE</code>, <code>VK_IMAGE_VIEW_TYPE_1D_ARRAY</code>, <code>VK_IMAGE_VIEW_TYPE_2D_ARRAY</code> or <code>VK_IMAGE_VIEW_TYPE_CUBE_ARRAY</code>, in any shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-None-02703",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> object that uses unnormalized coordinates, that sampler <strong class=\"purple\">must</strong> not be used with any of the SPIR-V <code>OpImageSample*</code> or <code>OpImageSparseSample*</code> instructions with <code>ImplicitLod</code>, <code>Dref</code> or <code>Proj</code> in their name, in any shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-None-02704",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> object that uses unnormalized coordinates, that sampler <strong class=\"purple\">must</strong> not be used with any of the SPIR-V <code>OpImageSample*</code> or <code>OpImageSparseSample*</code> instructions that includes a LOD bias or any offset values, in any shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-None-04115",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> is accessed using <code>OpImageWrite</code> as a result of this command, then the <code>Type</code> of the <code>Texel</code> operand of that instruction <strong class=\"purple\">must</strong> have at least as many components as the image view’s format"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-OpImageWrite-04469",
|
|
"text": " If a <a href=\"#VkBufferView\">VkBufferView</a> is accessed using <code>OpImageWrite</code> as a result of this command, then the <code>Type</code> of the <code>Texel</code> operand of that instruction <strong class=\"purple\">must</strong> have at least as many components as the buffer view’s format"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-renderPass-02684",
|
|
"text": " The current render pass <strong class=\"purple\">must</strong> be <a href=\"#renderpass-compatibility\">compatible</a> with the <code>renderPass</code> member of the <code>VkGraphicsPipelineCreateInfo</code> structure specified when creating the <code>VkPipeline</code> bound to <code>VK_PIPELINE_BIND_POINT_GRAPHICS</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-subpass-02685",
|
|
"text": " The subpass index of the current render pass <strong class=\"purple\">must</strong> be equal to the <code>subpass</code> member of the <code>VkGraphicsPipelineCreateInfo</code> structure specified when creating the <code>VkPipeline</code> bound to <code>VK_PIPELINE_BIND_POINT_GRAPHICS</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-None-02686",
|
|
"text": " Every input attachment used by the current subpass <strong class=\"purple\">must</strong> be bound to the pipeline via a descriptor set"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-None-06537",
|
|
"text": " Memory backing image subresources used as attachments in the current render pass <strong class=\"purple\">must</strong> not be written in any way other than as an attachment by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-None-06538",
|
|
"text": " If any recorded command in the current subpass will write to an image subresource as an attachment, this command <strong class=\"purple\">must</strong> not read from the memory backing that image subresource in any other way than as an attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-None-06539",
|
|
"text": " If any recorded command in the current subpass will read from an image subresource used as an attachment in any way other than as an attachment, this command <strong class=\"purple\">must</strong> not write to that image subresource as an attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-None-06886",
|
|
"text": " If the current render pass instance uses a depth/stencil attachment with a read-only layout for the depth aspect, <a href=\"#fragops-depth-write\">depth writes</a> <strong class=\"purple\">must</strong> be disabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-None-06887",
|
|
"text": " If the current render pass instance uses a depth/stencil attachment with a read-only layout for the stencil aspect and stencil test is enabled, <a href=\"#fragops-stencil\">all stencil ops</a> <strong class=\"purple\">must</strong> be <code>VK_STENCIL_OP_KEEP</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-blendEnable-04727",
|
|
"text": " If rasterization is not disabled in the bound graphics pipeline, then for each color attachment in the subpass, if the corresponding image view’s <a href=\"#resources-image-view-format-features\">format features</a> do not contain <code>VK_FORMAT_FEATURE_COLOR_ATTACHMENT_BLEND_BIT</code>, then the <code>blendEnable</code> member of the corresponding element of the <code>pAttachments</code> member of <code>pColorBlendState</code> <strong class=\"purple\">must</strong> be <code>VK_FALSE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-rasterizationSamples-04740",
|
|
"text": " If rasterization is not disabled in the bound graphics pipeline, and neither the <code><a href=\"#VK_AMD_mixed_attachment_samples\">VK_AMD_mixed_attachment_samples</a></code> nor the <code><a href=\"#VK_NV_framebuffer_mixed_samples\">VK_NV_framebuffer_mixed_samples</a></code> extensions are enabled, then <a href=\"#VkPipelineMultisampleStateCreateInfo\">VkPipelineMultisampleStateCreateInfo</a>::<code>rasterizationSamples</code> <strong class=\"purple\">must</strong> be the same as the current subpass color and/or depth/stencil attachments"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-None-04007",
|
|
"text": " All vertex input bindings accessed via vertex input variables declared in the vertex shader entry point’s interface <strong class=\"purple\">must</strong> have either valid or <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> buffers bound"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-None-04008",
|
|
"text": " If the <a href=\"#features-nullDescriptor\"><code>nullDescriptor</code></a> feature is not enabled, all vertex input bindings accessed via vertex input variables declared in the vertex shader entry point’s interface <strong class=\"purple\">must</strong> not be <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-None-02721",
|
|
"text": " For a given vertex buffer binding, any attribute data fetched <strong class=\"purple\">must</strong> be entirely contained within the corresponding vertex buffer binding, as described in <a href=\"#fxvertex-input\">Vertex Input Description</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-None-04933",
|
|
"text": " The <a href=\"#features-multiDraw\"><code>multiDraw</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-drawCount-04934",
|
|
"text": " <code>drawCount</code> <strong class=\"purple\">must</strong> be less than <code>VkPhysicalDeviceMultiDrawPropertiesEXT</code>::<code>maxMultiDrawCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-drawCount-04935",
|
|
"text": " If <code>drawCount</code> is greater than zero, <code>pVertexInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to memory containing one or more valid instances of <a href=\"#VkMultiDrawInfoEXT\">VkMultiDrawInfoEXT</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-stride-04936",
|
|
"text": " <code>stride</code> must be a multiple of 4"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called inside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+!(VK_VERSION_1_3,VK_KHR_format_feature_flags2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-aspectMask-06478",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> is sampled with <a href=\"#textures-depth-compare-operation\">depth comparison</a>, the image view <strong class=\"purple\">must</strong> have been created with an <code>aspectMask</code> that contains <code>VK_IMAGE_ASPECT_DEPTH_BIT</code>."
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_VERSION_1_3,VK_KHR_format_feature_flags2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-None-06479",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> is sampled with <a href=\"#textures-depth-compare-operation\">depth comparison</a>, the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_SAMPLED_IMAGE_DEPTH_COMPARISON_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-OpTypeImage-06423",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> or <a href=\"#VkBufferView\">VkBufferView</a> being written as a storage image or storage texel buffer where the image format field of the <code>OpTypeImage</code> is <code>Unknown</code> then the view’s format feature <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_STORAGE_WRITE_WITHOUT_FORMAT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-OpTypeImage-06424",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> or <a href=\"#VkBufferView\">VkBufferView</a> being read as a storage image or storage texel buffer where the image format field of the <code>OpTypeImage</code> is <code>Unknown</code> then the view’s format feature <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_STORAGE_READ_WITHOUT_FORMAT_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_IMG_filter_cubic,VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-None-02692",
|
|
"text": " If a <code>VkImageView</code> is sampled with <code>VK_FILTER_CUBIC_EXT</code> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_CUBIC_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_IMG_filter_cubic,VK_EXT_filter_cubic)+!(VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-None-02693",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> being sampled with <code>VK_FILTER_CUBIC_EXT</code> as a result of this command <strong class=\"purple\">must</strong> not have a <a href=\"#VkImageViewType\">VkImageViewType</a> of <code>VK_IMAGE_VIEW_TYPE_3D</code>, <code>VK_IMAGE_VIEW_TYPE_CUBE</code>, or <code>VK_IMAGE_VIEW_TYPE_CUBE_ARRAY</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_IMG_filter_cubic,VK_EXT_filter_cubic)+(VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-filterCubic-02694",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> being sampled with <code>VK_FILTER_CUBIC_EXT</code> as a result of this command <strong class=\"purple\">must</strong> have a <a href=\"#VkImageViewType\">VkImageViewType</a> and format that supports cubic filtering, as specified by <code>VkFilterCubicImageViewImageFormatPropertiesEXT</code>::<code>filterCubic</code> returned by <code>vkGetPhysicalDeviceImageFormatProperties2</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-filterCubicMinmax-02695",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> being sampled with <code>VK_FILTER_CUBIC_EXT</code> with a reduction mode of either <code>VK_SAMPLER_REDUCTION_MODE_MIN</code> or <code>VK_SAMPLER_REDUCTION_MODE_MAX</code> as a result of this command <strong class=\"purple\">must</strong> have a <a href=\"#VkImageViewType\">VkImageViewType</a> and format that supports cubic filtering together with minmax filtering, as specified by <code>VkFilterCubicImageViewImageFormatPropertiesEXT</code>::<code>filterCubicMinmax</code> returned by <code>vkGetPhysicalDeviceImageFormatProperties2</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_NV_corner_sampled_image)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-flags-02696",
|
|
"text": " Any <a href=\"#VkImage\">VkImage</a> created with a <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a>::<code>flags</code> containing <code>VK_IMAGE_CREATE_CORNER_SAMPLED_BIT_NV</code> sampled as a result of this command <strong class=\"purple\">must</strong> only be sampled using a <a href=\"#VkSamplerAddressMode\">VkSamplerAddressMode</a> of <code>VK_SAMPLER_ADDRESS_MODE_CLAMP_TO_EDGE</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+!(VK_VERSION_1_3,VK_KHR_maintenance4)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-None-02698",
|
|
"text": " For each push constant that is statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command, a push constant value <strong class=\"purple\">must</strong> have been set for the same pipeline bind point, with a <code>VkPipelineLayout</code> that is compatible for push constants, with the <code>VkPipelineLayout</code> used to create the current <code>VkPipeline</code>, as described in <a href=\"#descriptorsets-compatibility\">Pipeline Layout Compatibility</a>"
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_VERSION_1_3,VK_KHR_maintenance4)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-maintenance4-06425",
|
|
"text": " If the <a href=\"#features-maintenance4\"><code>maintenance4</code></a> feature is not enabled, then for each push constant that is statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command, a push constant value <strong class=\"purple\">must</strong> have been set for the same pipeline bind point, with a <code>VkPipelineLayout</code> that is compatible for push constants, with the <code>VkPipelineLayout</code> used to create the current <code>VkPipeline</code>, as described in <a href=\"#descriptorsets-compatibility\">Pipeline Layout Compatibility</a>"
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+!(VK_EXT_pipeline_robustness)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-None-02705",
|
|
"text": " If the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, and if the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a uniform buffer, it <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-None-02706",
|
|
"text": " If the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, and if the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a storage buffer, it <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_EXT_pipeline_robustness)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-uniformBuffers-06935",
|
|
"text": " If any stage of the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a uniform buffer, and that stage was created without enabling either <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_EXT</code> or <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXT</code> for <code>uniformBuffers</code>, and the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, that stage <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-storageBuffers-06936",
|
|
"text": " If any stage of the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a storage buffer, and that stage was created without enabling either <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_EXT</code> or <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXT</code> for <code>storageBuffers</code>, and the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, that stage <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-commandBuffer-02707",
|
|
"text": " If <code>commandBuffer</code> is an unprotected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, any resource accessed by the <a href=\"#VkPipeline\">VkPipeline</a> object bound to the pipeline bind point used by this command <strong class=\"purple\">must</strong> not be a protected resource"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-commandBuffer-02712",
|
|
"text": " If <code>commandBuffer</code> is a protected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, any resource written to by the <code>VkPipeline</code> object bound to the pipeline bind point used by this command <strong class=\"purple\">must</strong> not be an unprotected resource"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-commandBuffer-02713",
|
|
"text": " If <code>commandBuffer</code> is a protected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, pipeline stages other than the framebuffer-space and compute stages in the <code>VkPipeline</code> object bound to the pipeline bind point used by this command <strong class=\"purple\">must</strong> not write to any resource"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-commandBuffer-04617",
|
|
"text": " If any of the shader stages of the <code>VkPipeline</code> bound to the pipeline bind point used by this command uses the <a href=\"#spirvenv-capabilities-table-RayQueryKHR\"><code>RayQueryKHR</code></a> capability, then <code>commandBuffer</code> <strong class=\"purple\">must</strong> not be a protected command buffer"
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-None-06550",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> or <code>VkImageView</code> object that enables <a href=\"#samplers-YCbCr-conversion\">sampler {YCbCr} conversion</a>, that object <strong class=\"purple\">must</strong> only be used with <code>OpImageSample*</code> or <code>OpImageSparseSample*</code> instructions"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-ConstOffset-06551",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> or <code>VkImageView</code> object that enables <a href=\"#samplers-YCbCr-conversion\">sampler {YCbCr} conversion</a>, that object <strong class=\"purple\">must</strong> not use the <code>ConstOffset</code> and <code>Offset</code> operands"
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_EXT_shader_image_atomic_int64)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-SampledType-04470",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a 64-bit component width is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 64"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-SampledType-04471",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a component width less than 64-bit is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 32"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-SampledType-04472",
|
|
"text": " If a <a href=\"#VkBufferView\">VkBufferView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a 64-bit component width is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 64"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-SampledType-04473",
|
|
"text": " If a <a href=\"#VkBufferView\">VkBufferView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a component width less than 64-bit is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 32"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-sparseImageInt64Atomics-04474",
|
|
"text": " If the <a href=\"#features-sparseImageInt64Atomics\"><code>sparseImageInt64Atomics</code></a> feature is not enabled, <a href=\"#VkImage\">VkImage</a> objects created with the <code>VK_IMAGE_CREATE_SPARSE_RESIDENCY_BIT</code> flag <strong class=\"purple\">must</strong> not be accessed by atomic instructions through an <code>OpTypeImage</code> with a <code>SampledType</code> with a <code>Width</code> of 64 by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-sparseImageInt64Atomics-04475",
|
|
"text": " If the <a href=\"#features-sparseImageInt64Atomics\"><code>sparseImageInt64Atomics</code></a> feature is not enabled, <a href=\"#VkBuffer\">VkBuffer</a> objects created with the <code>VK_BUFFER_CREATE_SPARSE_RESIDENCY_BIT</code> flag <strong class=\"purple\">must</strong> not be accessed by atomic instructions through an <code>OpTypeImage</code> with a <code>SampledType</code> with a <code>Width</code> of 64 by this command"
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_QCOM_image_processing)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-OpImageWeightedSampleQCOM-06971",
|
|
"text": " If <code>OpImageWeightedSampleQCOM</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_WEIGHT_SAMPLED_IMAGE_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-OpImageWeightedSampleQCOM-06972",
|
|
"text": " If <code>OpImageWeightedSampleQCOM</code> uses a <a href=\"#VkImageView\">VkImageView</a> as a sample weight image as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_WEIGHT_IMAGE_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-OpImageBoxFilterQCOM-06973",
|
|
"text": " If <code>OpImageBoxFilterQCOM</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_BOX_FILTER_SAMPLED_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-OpImageBlockMatchSSDQCOM-06974",
|
|
"text": " If <code>OpImageBlockMatchSSDQCOM</code> is used to read from an <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-OpImageBlockMatchSADQCOM-06975",
|
|
"text": " If <code>OpImageBlockMatchSADQCOM</code> is used to read from an <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-OpImageBlockMatchSADQCOM-06976",
|
|
"text": " If <code>OpImageBlockMatchSADQCOM</code> or OpImageBlockMatchSSDQCOM is used to read from a reference image as result of this command, then the specified reference coordinates <strong class=\"purple\">must</strong> not fail <a href=\"#textures-integer-coordinate-validation\">integer texel coordinate validation</a>."
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-OpImageWeightedSampleQCOM-06977",
|
|
"text": " If <code>OpImageWeightedSampleQCOM</code>, <code>OpImageBoxFilterQCOM</code>, <code>OpImageBlockMatchSSDQCOM</code>, or <code>OpImageBlockMatchSADQCOM</code> uses a <a href=\"#VkSampler\">VkSampler</a> as a result of this command, then the sampler <strong class=\"purple\">must</strong> have been created with <code>VK_SAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-OpImageWeightedSampleQCOM-06978",
|
|
"text": " If any command other than <code>OpImageWeightedSampleQCOM</code>, <code>OpImageBoxFilterQCOM</code>, <code>OpImageBlockMatchSSDQCOM</code>, or <code>OpImageBlockMatchSADQCOM</code> uses a <a href=\"#VkSampler\">VkSampler</a> as a result of this command, then the sampler <strong class=\"purple\">must</strong> not have been created with <code>VK_SAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM</code>."
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_VERSION_1_1,VK_KHR_multiview)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-maxMultiviewInstanceIndex-02688",
|
|
"text": " If the draw is recorded in a render pass instance with multiview enabled, the maximum instance index <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#VkPhysicalDeviceMultiviewProperties\">VkPhysicalDeviceMultiviewProperties</a>::<code>maxMultiviewInstanceIndex</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_EXT_sample_locations)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-sampleLocationsEnable-02689",
|
|
"text": " If the bound graphics pipeline was created with <a href=\"#VkPipelineSampleLocationsStateCreateInfoEXT\">VkPipelineSampleLocationsStateCreateInfoEXT</a>::<code>sampleLocationsEnable</code> set to <code>VK_TRUE</code> and the current subpass has a depth/stencil attachment, then that attachment <strong class=\"purple\">must</strong> have been created with the <code>VK_IMAGE_CREATE_SAMPLE_LOCATIONS_COMPATIBLE_DEPTH_BIT_EXT</code> bit set"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-None-06666",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_SAMPLE_LOCATIONS_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetSampleLocationsEXT\">vkCmdSetSampleLocationsEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command"
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-viewportCount-03417",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, but not the <code>VK_DYNAMIC_STATE_SCISSOR_WITH_COUNT</code> dynamic state enabled, then <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>viewportCount</code> parameter of <code>vkCmdSetViewportWithCount</code> <strong class=\"purple\">must</strong> match the <code>VkPipelineViewportStateCreateInfo</code>::<code>scissorCount</code> of the pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-scissorCount-03418",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_SCISSOR_WITH_COUNT</code> dynamic state enabled, but not the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, then <a href=\"#vkCmdSetScissorWithCount\">vkCmdSetScissorWithCount</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>scissorCount</code> parameter of <code>vkCmdSetScissorWithCount</code> <strong class=\"purple\">must</strong> match the <code>VkPipelineViewportStateCreateInfo</code>::<code>viewportCount</code> of the pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-viewportCount-03419",
|
|
"text": " If the bound graphics pipeline state was created with both the <code>VK_DYNAMIC_STATE_SCISSOR_WITH_COUNT</code> and <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic states enabled then both <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a> and <a href=\"#vkCmdSetScissorWithCount\">vkCmdSetScissorWithCount</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>viewportCount</code> parameter of <code>vkCmdSetViewportWithCount</code> <strong class=\"purple\">must</strong> match the <code>scissorCount</code> parameter of <code>vkCmdSetScissorWithCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-primitiveTopology-03420",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_PRIMITIVE_TOPOLOGY_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetPrimitiveTopologyEXT\">vkCmdSetPrimitiveTopologyEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>primitiveTopology</code> parameter of <code>vkCmdSetPrimitiveTopologyEXT</code> <strong class=\"purple\">must</strong> be of the same <a href=\"#drawing-primitive-topology-class\">topology class</a> as the pipeline <a href=\"#VkPipelineInputAssemblyStateCreateInfo\">VkPipelineInputAssemblyStateCreateInfo</a>::<code>topology</code> state"
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_NV_clip_space_w_scaling)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-viewportCount-04137",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, but not the <code>VK_DYNAMIC_STATE_VIEWPORT_W_SCALING_NV</code> dynamic state enabled, then the bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <a href=\"#VkPipelineViewportWScalingStateCreateInfoNV\">VkPipelineViewportWScalingStateCreateInfoNV</a>::<code>viewportCount</code> greater or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-viewportCount-04138",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> and <code>VK_DYNAMIC_STATE_VIEWPORT_W_SCALING_NV</code> dynamic states enabled then the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWScalingNV\">vkCmdSetViewportWScalingNV</a> <strong class=\"purple\">must</strong> be greater than or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_NV_shading_rate_image)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-viewportCount-04139",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, but not the <code>VK_DYNAMIC_STATE_VIEWPORT_SHADING_RATE_PALETTE_NV</code> dynamic state enabled, then the bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <a href=\"#VkPipelineViewportShadingRateImageStateCreateInfoNV\">VkPipelineViewportShadingRateImageStateCreateInfoNV</a>::<code>viewportCount</code> greater or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-viewportCount-04140",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> and <code>VK_DYNAMIC_STATE_VIEWPORT_SHADING_RATE_PALETTE_NV</code> dynamic states enabled then the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportShadingRatePaletteNV\">vkCmdSetViewportShadingRatePaletteNV</a> <strong class=\"purple\">must</strong> be greater than or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_NV_viewport_swizzle)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-VkPipelineVieportCreateInfo-04141",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled and a <a href=\"#VkPipelineViewportSwizzleStateCreateInfoNV\">VkPipelineViewportSwizzleStateCreateInfoNV</a> structure chained from <code>VkPipelineVieportCreateInfo</code>, then the bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <a href=\"#VkPipelineViewportSwizzleStateCreateInfoNV\">VkPipelineViewportSwizzleStateCreateInfoNV</a>::<code>viewportCount</code> greater or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_NV_scissor_exclusive)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-VkPipelineVieportCreateInfo-04142",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled and a <a href=\"#VkPipelineViewportExclusiveScissorStateCreateInfoNV\">VkPipelineViewportExclusiveScissorStateCreateInfoNV</a> structure chained from <code>VkPipelineVieportCreateInfo</code>, then the bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <a href=\"#VkPipelineViewportExclusiveScissorStateCreateInfoNV\">VkPipelineViewportExclusiveScissorStateCreateInfoNV</a>::<code>exclusiveScissorCount</code> greater or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-None-04876",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_RASTERIZER_DISCARD_ENABLE</code> dynamic state enabled then <a href=\"#vkCmdSetRasterizerDiscardEnable\">vkCmdSetRasterizerDiscardEnable</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-None-04877",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_DEPTH_BIAS_ENABLE</code> dynamic state enabled then <a href=\"#vkCmdSetDepthBiasEnable\">vkCmdSetDepthBiasEnable</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-logicOp-04878",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_LOGIC_OP_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetLogicOpEXT\">vkCmdSetLogicOpEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command and the <code>logicOp</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkLogicOp\">VkLogicOp</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-None-04875",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_PATCH_CONTROL_POINTS_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetPatchControlPointsEXT\">vkCmdSetPatchControlPointsEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-None-04879",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_PRIMITIVE_RESTART_ENABLE_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetPrimitiveRestartEnableEXT\">vkCmdSetPrimitiveRestartEnableEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command"
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_KHR_fragment_shading_rate)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-primitiveFragmentShadingRateWithMultipleViewports-04552",
|
|
"text": " If the <a href=\"#limits-primitiveFragmentShadingRateWithMultipleViewports\"><code>primitiveFragmentShadingRateWithMultipleViewports</code></a> limit is not supported, the bound graphics pipeline was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, and any of the shader stages of the bound graphics pipeline write to the <code>PrimitiveShadingRateKHR</code> built-in, then <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>viewportCount</code> parameter of <code>vkCmdSetViewportWithCount</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-imageView-06172",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pDepthAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pDepthAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the depth attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-imageView-06173",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pStencilAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pStencilAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the stencil attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-viewMask-06178",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound graphics pipeline <strong class=\"purple\">must</strong> have been created with a <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>viewMask</code> equal to <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>viewMask</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-colorAttachmentCount-06179",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound graphics pipeline <strong class=\"purple\">must</strong> have been created with a <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>colorAttachmentCount</code> equal to <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>colorAttachmentCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-colorAttachmentCount-06180",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>colorAttachmentCount</code> greater than <code>0</code>, then each element of the <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pColorAttachments</code> array with a <code>imageView</code> not equal to <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> <strong class=\"purple\">must</strong> have been created with a <a href=\"#VkFormat\">VkFormat</a> equal to the corresponding element of <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>pColorAttachmentFormats</code> used to create the currently bound graphics pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-pDepthAttachment-06181",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>depthAttachmentFormat</code> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the <a href=\"#VkFormat\">VkFormat</a> used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-pStencilAttachment-06182",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>stencilAttachmentFormat</code> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the <a href=\"#VkFormat\">VkFormat</a> used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_VERSION_1_1,VK_KHR_maintenance2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-imageView-06174",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pDepthAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pDepthAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_STENCIL_ATTACHMENT_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the depth attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-imageView-06175",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pStencilAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pStencilAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_STENCIL_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the stencil attachment"
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_VERSION_1_2,VK_KHR_separate_depth_stencil_layouts)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-imageView-06176",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pDepthAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pDepthAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the depth attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-imageView-06177",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pStencilAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pStencilAttachment</code> is <code>VK_IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the stencil attachment"
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_EXT_color_write_enable)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-attachmentCount-06667",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_COLOR_WRITE_ENABLE_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetColorWriteEnableEXT\">vkCmdSetColorWriteEnableEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>attachmentCount</code> parameter of <code>vkCmdSetColorWriteEnableEXT</code> <strong class=\"purple\">must</strong> be greater than or equal to the <code>VkPipelineColorBlendStateCreateInfo</code>::<code>attachmentCount</code> of the currently bound graphics pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-attachmentCount-06815",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_COLOR_WRITE_ENABLE_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetColorWriteEnableEXT\">vkCmdSetColorWriteEnableEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>attachmentCount</code> parameter of <code>vkCmdSetColorWriteEnableEXT</code> <strong class=\"purple\">must</strong> be less than or equal to the <code>maxColorAttachments</code> member of <code>VkPhysicalDeviceLimits</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_KHR_fragment_shading_rate)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-imageView-06183",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingFragmentShadingRateAttachmentInfoKHR\">VkRenderingFragmentShadingRateAttachmentInfoKHR</a>::<code>imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the currently bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <code>VK_PIPELINE_CREATE_RENDERING_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_EXT_fragment_density_map)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-imageView-06184",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingFragmentDensityMapAttachmentInfoEXT\">VkRenderingFragmentDensityMapAttachmentInfoEXT</a>::<code>imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the currently bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <code>VK_PIPELINE_CREATE_RENDERING_FRAGMENT_DENSITY_MAP_ATTACHMENT_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_AMD_mixed_attachment_samples,VK_NV_framebuffer_mixed_samples)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-colorAttachmentCount-06185",
|
|
"text": " If the currently bound pipeline was created with a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> with a <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>colorAttachmentCount</code> parameter greater than <code>0</code>, then each element of the <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pColorAttachments</code> array with a <code>imageView</code> not equal to <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> <strong class=\"purple\">must</strong> have been created with a sample count equal to the corresponding element of the <code>pColorAttachmentSamples</code> member of <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> used to create the currently bound graphics pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-pDepthAttachment-06186",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline was created with a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of the <code>depthStencilAttachmentSamples</code> member of <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the sample count used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-pStencilAttachment-06187",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline was created with a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of the <code>depthStencilAttachmentSamples</code> member of <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the sample count used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-colorAttachmentCount-06188",
|
|
"text": " If the currently bound pipeline was created without a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> with a <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>colorAttachmentCount</code> parameter greater than <code>0</code>, then each element of the <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pColorAttachments</code> array with a <code>imageView</code> not equal to <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> <strong class=\"purple\">must</strong> have been created with a sample count equal to the value of <a href=\"#VkPipelineMultisampleStateCreateInfo\">VkPipelineMultisampleStateCreateInfo</a>::<code>rasterizationSamples</code> used to create the currently bound graphics pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-pDepthAttachment-06189",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline was created without a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of <a href=\"#VkPipelineMultisampleStateCreateInfo\">VkPipelineMultisampleStateCreateInfo</a>::<code>rasterizationSamples</code> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the sample count used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-pStencilAttachment-06190",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline was created without a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of <a href=\"#VkPipelineMultisampleStateCreateInfo\">VkPipelineMultisampleStateCreateInfo</a>::<code>rasterizationSamples</code> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the sample count used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-renderPass-06198",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline <strong class=\"purple\">must</strong> have been created with a <a href=\"#VkGraphicsPipelineCreateInfo\">VkGraphicsPipelineCreateInfo</a>::<code>renderPass</code> equal to <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_EXT_primitives_generated_query)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-primitivesGeneratedQueryWithRasterizerDiscard-06708",
|
|
"text": " If the <a href=\"#features-primitivesGeneratedQueryWithRasterizerDiscard\"><code>primitivesGeneratedQueryWithRasterizerDiscard</code></a> feature is not enabled and the <code>VK_QUERY_TYPE_PRIMITIVES_GENERATED_EXT</code> query is active, <a href=\"#primsrast-discard\">rasterization discard</a> <strong class=\"purple\">must</strong> not be enabled."
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_EXT_primitives_generated_query)+(VK_EXT_transform_feedback)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-primitivesGeneratedQueryWithNonZeroStreams-06709",
|
|
"text": " If the <a href=\"#features-primitivesGeneratedQueryWithNonZeroStreams\"><code>primitivesGeneratedQueryWithNonZeroStreams</code></a> feature is not enabled and the <code>VK_QUERY_TYPE_PRIMITIVES_GENERATED_EXT</code> query is active, the bound graphics pipeline <strong class=\"purple\">must</strong> not have been created with a non-zero value in <code>VkPipelineRasterizationStateStreamCreateInfoEXT</code>::<code>rasterizationStream</code>."
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_EXT_vertex_input_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-None-04912",
|
|
"text": " If the bound graphics pipeline was created with both the <code>VK_DYNAMIC_STATE_VERTEX_INPUT_EXT</code> and <code>VK_DYNAMIC_STATE_VERTEX_INPUT_BINDING_STRIDE_EXT</code> dynamic states enabled, then <a href=\"#vkCmdSetVertexInputEXT\">vkCmdSetVertexInputEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this draw command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-pStrides-04913",
|
|
"text": " If the bound graphics pipeline was created with the <code>VK_DYNAMIC_STATE_VERTEX_INPUT_BINDING_STRIDE_EXT</code> dynamic state enabled, but not the <code>VK_DYNAMIC_STATE_VERTEX_INPUT_EXT</code> dynamic state enabled, then <a href=\"#vkCmdBindVertexBuffers2EXT\">vkCmdBindVertexBuffers2EXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this draw command, and the <code>pStrides</code> parameter of <a href=\"#vkCmdBindVertexBuffers2EXT\">vkCmdBindVertexBuffers2EXT</a> <strong class=\"purple\">must</strong> not be <code>NULL</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+!(VK_EXT_vertex_input_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-pStrides-04884",
|
|
"text": " If the bound graphics pipeline was created with the <code>VK_DYNAMIC_STATE_VERTEX_INPUT_BINDING_STRIDE_EXT</code> dynamic state enabled, then <a href=\"#vkCmdBindVertexBuffers2EXT\">vkCmdBindVertexBuffers2EXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>pStrides</code> parameter of <a href=\"#vkCmdBindVertexBuffers2EXT\">vkCmdBindVertexBuffers2EXT</a> <strong class=\"purple\">must</strong> not be <code>NULL</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_EXT_vertex_input_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-None-04914",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VERTEX_INPUT_EXT</code> dynamic state enabled, then <a href=\"#vkCmdSetVertexInputEXT\">vkCmdSetVertexInputEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this draw command"
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_NV_mesh_shader)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiEXT-stage-06481",
|
|
"text": " The bound graphics pipeline <strong class=\"purple\">must</strong> not have been created with the <a href=\"#VkPipelineShaderStageCreateInfo\">VkPipelineShaderStageCreateInfo</a>::<code>stage</code> member of an element of <a href=\"#VkGraphicsPipelineCreateInfo\">VkGraphicsPipelineCreateInfo</a>::<code>pStages</code> set to <code>VK_SHADER_STAGE_TASK_BIT_NV</code> or <code>VK_SHADER_STAGE_MESH_BIT_NV</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdDrawMultiIndexedEXT": {
|
|
"(VK_EXT_multi_draw)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-magFilter-04553",
|
|
"text": " If a <a href=\"#VkSampler\">VkSampler</a> created with <code>magFilter</code> or <code>minFilter</code> equal to <code>VK_FILTER_LINEAR</code> and <code>compareEnable</code> equal to <code>VK_FALSE</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-mipmapMode-04770",
|
|
"text": " If a <a href=\"#VkSampler\">VkSampler</a> created with <code>mipmapMode</code> equal to <code>VK_SAMPLER_MIPMAP_MODE_LINEAR</code> and <code>compareEnable</code> equal to <code>VK_FALSE</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-None-02691",
|
|
"text": " If a <code>VkImageView</code> is accessed using atomic operations as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_STORAGE_IMAGE_ATOMIC_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-None-02697",
|
|
"text": " For each set <em>n</em> that is statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command, a descriptor set <strong class=\"purple\">must</strong> have been bound to <em>n</em> at the same pipeline bind point, with a <code>VkPipelineLayout</code> that is compatible for set <em>n</em>, with the <code>VkPipelineLayout</code> used to create the current <code>VkPipeline</code>, as described in <a href=\"#descriptorsets-compatibility\">Pipeline Layout Compatibility</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-None-02699",
|
|
"text": " Descriptors in each bound descriptor set, specified via <code>vkCmdBindDescriptorSets</code>, <strong class=\"purple\">must</strong> be valid if they are statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-None-02700",
|
|
"text": " A valid pipeline <strong class=\"purple\">must</strong> be bound to the pipeline bind point used by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-commandBuffer-02701",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command requires any dynamic state, that state <strong class=\"purple\">must</strong> have been set or inherited (if the <code><a href=\"#VK_NV_inherited_viewport_scissor\">VK_NV_inherited_viewport_scissor</a></code> extension is enabled) for <code>commandBuffer</code>, and done so after any previously bound pipeline with the corresponding state not specified as dynamic"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-None-02859",
|
|
"text": " There <strong class=\"purple\">must</strong> not have been any calls to dynamic state setting commands for any state not specified as dynamic in the <code>VkPipeline</code> object bound to the pipeline bind point used by this command, since that pipeline was bound"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-None-02702",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> object that uses unnormalized coordinates, that sampler <strong class=\"purple\">must</strong> not be used to sample from any <code>VkImage</code> with a <code>VkImageView</code> of the type <code>VK_IMAGE_VIEW_TYPE_3D</code>, <code>VK_IMAGE_VIEW_TYPE_CUBE</code>, <code>VK_IMAGE_VIEW_TYPE_1D_ARRAY</code>, <code>VK_IMAGE_VIEW_TYPE_2D_ARRAY</code> or <code>VK_IMAGE_VIEW_TYPE_CUBE_ARRAY</code>, in any shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-None-02703",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> object that uses unnormalized coordinates, that sampler <strong class=\"purple\">must</strong> not be used with any of the SPIR-V <code>OpImageSample*</code> or <code>OpImageSparseSample*</code> instructions with <code>ImplicitLod</code>, <code>Dref</code> or <code>Proj</code> in their name, in any shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-None-02704",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> object that uses unnormalized coordinates, that sampler <strong class=\"purple\">must</strong> not be used with any of the SPIR-V <code>OpImageSample*</code> or <code>OpImageSparseSample*</code> instructions that includes a LOD bias or any offset values, in any shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-None-04115",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> is accessed using <code>OpImageWrite</code> as a result of this command, then the <code>Type</code> of the <code>Texel</code> operand of that instruction <strong class=\"purple\">must</strong> have at least as many components as the image view’s format"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-OpImageWrite-04469",
|
|
"text": " If a <a href=\"#VkBufferView\">VkBufferView</a> is accessed using <code>OpImageWrite</code> as a result of this command, then the <code>Type</code> of the <code>Texel</code> operand of that instruction <strong class=\"purple\">must</strong> have at least as many components as the buffer view’s format"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-renderPass-02684",
|
|
"text": " The current render pass <strong class=\"purple\">must</strong> be <a href=\"#renderpass-compatibility\">compatible</a> with the <code>renderPass</code> member of the <code>VkGraphicsPipelineCreateInfo</code> structure specified when creating the <code>VkPipeline</code> bound to <code>VK_PIPELINE_BIND_POINT_GRAPHICS</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-subpass-02685",
|
|
"text": " The subpass index of the current render pass <strong class=\"purple\">must</strong> be equal to the <code>subpass</code> member of the <code>VkGraphicsPipelineCreateInfo</code> structure specified when creating the <code>VkPipeline</code> bound to <code>VK_PIPELINE_BIND_POINT_GRAPHICS</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-None-02686",
|
|
"text": " Every input attachment used by the current subpass <strong class=\"purple\">must</strong> be bound to the pipeline via a descriptor set"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-None-06537",
|
|
"text": " Memory backing image subresources used as attachments in the current render pass <strong class=\"purple\">must</strong> not be written in any way other than as an attachment by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-None-06538",
|
|
"text": " If any recorded command in the current subpass will write to an image subresource as an attachment, this command <strong class=\"purple\">must</strong> not read from the memory backing that image subresource in any other way than as an attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-None-06539",
|
|
"text": " If any recorded command in the current subpass will read from an image subresource used as an attachment in any way other than as an attachment, this command <strong class=\"purple\">must</strong> not write to that image subresource as an attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-None-06886",
|
|
"text": " If the current render pass instance uses a depth/stencil attachment with a read-only layout for the depth aspect, <a href=\"#fragops-depth-write\">depth writes</a> <strong class=\"purple\">must</strong> be disabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-None-06887",
|
|
"text": " If the current render pass instance uses a depth/stencil attachment with a read-only layout for the stencil aspect and stencil test is enabled, <a href=\"#fragops-stencil\">all stencil ops</a> <strong class=\"purple\">must</strong> be <code>VK_STENCIL_OP_KEEP</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-blendEnable-04727",
|
|
"text": " If rasterization is not disabled in the bound graphics pipeline, then for each color attachment in the subpass, if the corresponding image view’s <a href=\"#resources-image-view-format-features\">format features</a> do not contain <code>VK_FORMAT_FEATURE_COLOR_ATTACHMENT_BLEND_BIT</code>, then the <code>blendEnable</code> member of the corresponding element of the <code>pAttachments</code> member of <code>pColorBlendState</code> <strong class=\"purple\">must</strong> be <code>VK_FALSE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-rasterizationSamples-04740",
|
|
"text": " If rasterization is not disabled in the bound graphics pipeline, and neither the <code><a href=\"#VK_AMD_mixed_attachment_samples\">VK_AMD_mixed_attachment_samples</a></code> nor the <code><a href=\"#VK_NV_framebuffer_mixed_samples\">VK_NV_framebuffer_mixed_samples</a></code> extensions are enabled, then <a href=\"#VkPipelineMultisampleStateCreateInfo\">VkPipelineMultisampleStateCreateInfo</a>::<code>rasterizationSamples</code> <strong class=\"purple\">must</strong> be the same as the current subpass color and/or depth/stencil attachments"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-None-04007",
|
|
"text": " All vertex input bindings accessed via vertex input variables declared in the vertex shader entry point’s interface <strong class=\"purple\">must</strong> have either valid or <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> buffers bound"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-None-04008",
|
|
"text": " If the <a href=\"#features-nullDescriptor\"><code>nullDescriptor</code></a> feature is not enabled, all vertex input bindings accessed via vertex input variables declared in the vertex shader entry point’s interface <strong class=\"purple\">must</strong> not be <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-None-02721",
|
|
"text": " For a given vertex buffer binding, any attribute data fetched <strong class=\"purple\">must</strong> be entirely contained within the corresponding vertex buffer binding, as described in <a href=\"#fxvertex-input\">Vertex Input Description</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-None-04937",
|
|
"text": " The <a href=\"#features-multiDraw\"><code>multiDraw</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-firstIndex-04938",
|
|
"text": " <span class=\"eq\">(<code>indexSize</code> {times} (<code>firstIndex</code> + <code>indexCount</code>) + <code>offset</code>)</span> <strong class=\"purple\">must</strong> be less than or equal to the size of the bound index buffer, with <code>indexSize</code> being based on the type specified by <code>indexType</code>, where the index buffer, <code>indexType</code>, and <code>offset</code> are specified via <code>vkCmdBindIndexBuffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-drawCount-04939",
|
|
"text": " <code>drawCount</code> <strong class=\"purple\">must</strong> be less than <code>VkPhysicalDeviceMultiDrawPropertiesEXT</code>::<code>maxMultiDrawCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-drawCount-04940",
|
|
"text": " If <code>drawCount</code> is greater than zero, <code>pIndexInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to memory containing one or more valid instances of <a href=\"#VkMultiDrawIndexedInfoEXT\">VkMultiDrawIndexedInfoEXT</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-stride-04941",
|
|
"text": " <code>stride</code> must be a multiple of 4"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-pVertexOffset-parameter",
|
|
"text": " If <code>pVertexOffset</code> is not <code>NULL</code>, <code>pVertexOffset</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <code>int32_t</code> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called inside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+!(VK_VERSION_1_3,VK_KHR_format_feature_flags2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-aspectMask-06478",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> is sampled with <a href=\"#textures-depth-compare-operation\">depth comparison</a>, the image view <strong class=\"purple\">must</strong> have been created with an <code>aspectMask</code> that contains <code>VK_IMAGE_ASPECT_DEPTH_BIT</code>."
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_VERSION_1_3,VK_KHR_format_feature_flags2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-None-06479",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> is sampled with <a href=\"#textures-depth-compare-operation\">depth comparison</a>, the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_SAMPLED_IMAGE_DEPTH_COMPARISON_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-OpTypeImage-06423",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> or <a href=\"#VkBufferView\">VkBufferView</a> being written as a storage image or storage texel buffer where the image format field of the <code>OpTypeImage</code> is <code>Unknown</code> then the view’s format feature <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_STORAGE_WRITE_WITHOUT_FORMAT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-OpTypeImage-06424",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> or <a href=\"#VkBufferView\">VkBufferView</a> being read as a storage image or storage texel buffer where the image format field of the <code>OpTypeImage</code> is <code>Unknown</code> then the view’s format feature <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_STORAGE_READ_WITHOUT_FORMAT_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_IMG_filter_cubic,VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-None-02692",
|
|
"text": " If a <code>VkImageView</code> is sampled with <code>VK_FILTER_CUBIC_EXT</code> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_CUBIC_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_IMG_filter_cubic,VK_EXT_filter_cubic)+!(VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-None-02693",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> being sampled with <code>VK_FILTER_CUBIC_EXT</code> as a result of this command <strong class=\"purple\">must</strong> not have a <a href=\"#VkImageViewType\">VkImageViewType</a> of <code>VK_IMAGE_VIEW_TYPE_3D</code>, <code>VK_IMAGE_VIEW_TYPE_CUBE</code>, or <code>VK_IMAGE_VIEW_TYPE_CUBE_ARRAY</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_IMG_filter_cubic,VK_EXT_filter_cubic)+(VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-filterCubic-02694",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> being sampled with <code>VK_FILTER_CUBIC_EXT</code> as a result of this command <strong class=\"purple\">must</strong> have a <a href=\"#VkImageViewType\">VkImageViewType</a> and format that supports cubic filtering, as specified by <code>VkFilterCubicImageViewImageFormatPropertiesEXT</code>::<code>filterCubic</code> returned by <code>vkGetPhysicalDeviceImageFormatProperties2</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-filterCubicMinmax-02695",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> being sampled with <code>VK_FILTER_CUBIC_EXT</code> with a reduction mode of either <code>VK_SAMPLER_REDUCTION_MODE_MIN</code> or <code>VK_SAMPLER_REDUCTION_MODE_MAX</code> as a result of this command <strong class=\"purple\">must</strong> have a <a href=\"#VkImageViewType\">VkImageViewType</a> and format that supports cubic filtering together with minmax filtering, as specified by <code>VkFilterCubicImageViewImageFormatPropertiesEXT</code>::<code>filterCubicMinmax</code> returned by <code>vkGetPhysicalDeviceImageFormatProperties2</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_NV_corner_sampled_image)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-flags-02696",
|
|
"text": " Any <a href=\"#VkImage\">VkImage</a> created with a <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a>::<code>flags</code> containing <code>VK_IMAGE_CREATE_CORNER_SAMPLED_BIT_NV</code> sampled as a result of this command <strong class=\"purple\">must</strong> only be sampled using a <a href=\"#VkSamplerAddressMode\">VkSamplerAddressMode</a> of <code>VK_SAMPLER_ADDRESS_MODE_CLAMP_TO_EDGE</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+!(VK_VERSION_1_3,VK_KHR_maintenance4)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-None-02698",
|
|
"text": " For each push constant that is statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command, a push constant value <strong class=\"purple\">must</strong> have been set for the same pipeline bind point, with a <code>VkPipelineLayout</code> that is compatible for push constants, with the <code>VkPipelineLayout</code> used to create the current <code>VkPipeline</code>, as described in <a href=\"#descriptorsets-compatibility\">Pipeline Layout Compatibility</a>"
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_VERSION_1_3,VK_KHR_maintenance4)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-maintenance4-06425",
|
|
"text": " If the <a href=\"#features-maintenance4\"><code>maintenance4</code></a> feature is not enabled, then for each push constant that is statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command, a push constant value <strong class=\"purple\">must</strong> have been set for the same pipeline bind point, with a <code>VkPipelineLayout</code> that is compatible for push constants, with the <code>VkPipelineLayout</code> used to create the current <code>VkPipeline</code>, as described in <a href=\"#descriptorsets-compatibility\">Pipeline Layout Compatibility</a>"
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+!(VK_EXT_pipeline_robustness)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-None-02705",
|
|
"text": " If the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, and if the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a uniform buffer, it <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-None-02706",
|
|
"text": " If the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, and if the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a storage buffer, it <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_EXT_pipeline_robustness)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-uniformBuffers-06935",
|
|
"text": " If any stage of the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a uniform buffer, and that stage was created without enabling either <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_EXT</code> or <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXT</code> for <code>uniformBuffers</code>, and the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, that stage <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-storageBuffers-06936",
|
|
"text": " If any stage of the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a storage buffer, and that stage was created without enabling either <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_EXT</code> or <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXT</code> for <code>storageBuffers</code>, and the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, that stage <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-commandBuffer-02707",
|
|
"text": " If <code>commandBuffer</code> is an unprotected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, any resource accessed by the <a href=\"#VkPipeline\">VkPipeline</a> object bound to the pipeline bind point used by this command <strong class=\"purple\">must</strong> not be a protected resource"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-commandBuffer-02712",
|
|
"text": " If <code>commandBuffer</code> is a protected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, any resource written to by the <code>VkPipeline</code> object bound to the pipeline bind point used by this command <strong class=\"purple\">must</strong> not be an unprotected resource"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-commandBuffer-02713",
|
|
"text": " If <code>commandBuffer</code> is a protected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, pipeline stages other than the framebuffer-space and compute stages in the <code>VkPipeline</code> object bound to the pipeline bind point used by this command <strong class=\"purple\">must</strong> not write to any resource"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-commandBuffer-04617",
|
|
"text": " If any of the shader stages of the <code>VkPipeline</code> bound to the pipeline bind point used by this command uses the <a href=\"#spirvenv-capabilities-table-RayQueryKHR\"><code>RayQueryKHR</code></a> capability, then <code>commandBuffer</code> <strong class=\"purple\">must</strong> not be a protected command buffer"
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-None-06550",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> or <code>VkImageView</code> object that enables <a href=\"#samplers-YCbCr-conversion\">sampler {YCbCr} conversion</a>, that object <strong class=\"purple\">must</strong> only be used with <code>OpImageSample*</code> or <code>OpImageSparseSample*</code> instructions"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-ConstOffset-06551",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> or <code>VkImageView</code> object that enables <a href=\"#samplers-YCbCr-conversion\">sampler {YCbCr} conversion</a>, that object <strong class=\"purple\">must</strong> not use the <code>ConstOffset</code> and <code>Offset</code> operands"
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_EXT_shader_image_atomic_int64)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-SampledType-04470",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a 64-bit component width is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 64"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-SampledType-04471",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a component width less than 64-bit is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 32"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-SampledType-04472",
|
|
"text": " If a <a href=\"#VkBufferView\">VkBufferView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a 64-bit component width is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 64"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-SampledType-04473",
|
|
"text": " If a <a href=\"#VkBufferView\">VkBufferView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a component width less than 64-bit is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 32"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-sparseImageInt64Atomics-04474",
|
|
"text": " If the <a href=\"#features-sparseImageInt64Atomics\"><code>sparseImageInt64Atomics</code></a> feature is not enabled, <a href=\"#VkImage\">VkImage</a> objects created with the <code>VK_IMAGE_CREATE_SPARSE_RESIDENCY_BIT</code> flag <strong class=\"purple\">must</strong> not be accessed by atomic instructions through an <code>OpTypeImage</code> with a <code>SampledType</code> with a <code>Width</code> of 64 by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-sparseImageInt64Atomics-04475",
|
|
"text": " If the <a href=\"#features-sparseImageInt64Atomics\"><code>sparseImageInt64Atomics</code></a> feature is not enabled, <a href=\"#VkBuffer\">VkBuffer</a> objects created with the <code>VK_BUFFER_CREATE_SPARSE_RESIDENCY_BIT</code> flag <strong class=\"purple\">must</strong> not be accessed by atomic instructions through an <code>OpTypeImage</code> with a <code>SampledType</code> with a <code>Width</code> of 64 by this command"
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_QCOM_image_processing)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-OpImageWeightedSampleQCOM-06971",
|
|
"text": " If <code>OpImageWeightedSampleQCOM</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_WEIGHT_SAMPLED_IMAGE_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-OpImageWeightedSampleQCOM-06972",
|
|
"text": " If <code>OpImageWeightedSampleQCOM</code> uses a <a href=\"#VkImageView\">VkImageView</a> as a sample weight image as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_WEIGHT_IMAGE_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-OpImageBoxFilterQCOM-06973",
|
|
"text": " If <code>OpImageBoxFilterQCOM</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_BOX_FILTER_SAMPLED_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-OpImageBlockMatchSSDQCOM-06974",
|
|
"text": " If <code>OpImageBlockMatchSSDQCOM</code> is used to read from an <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-OpImageBlockMatchSADQCOM-06975",
|
|
"text": " If <code>OpImageBlockMatchSADQCOM</code> is used to read from an <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-OpImageBlockMatchSADQCOM-06976",
|
|
"text": " If <code>OpImageBlockMatchSADQCOM</code> or OpImageBlockMatchSSDQCOM is used to read from a reference image as result of this command, then the specified reference coordinates <strong class=\"purple\">must</strong> not fail <a href=\"#textures-integer-coordinate-validation\">integer texel coordinate validation</a>."
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-OpImageWeightedSampleQCOM-06977",
|
|
"text": " If <code>OpImageWeightedSampleQCOM</code>, <code>OpImageBoxFilterQCOM</code>, <code>OpImageBlockMatchSSDQCOM</code>, or <code>OpImageBlockMatchSADQCOM</code> uses a <a href=\"#VkSampler\">VkSampler</a> as a result of this command, then the sampler <strong class=\"purple\">must</strong> have been created with <code>VK_SAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-OpImageWeightedSampleQCOM-06978",
|
|
"text": " If any command other than <code>OpImageWeightedSampleQCOM</code>, <code>OpImageBoxFilterQCOM</code>, <code>OpImageBlockMatchSSDQCOM</code>, or <code>OpImageBlockMatchSADQCOM</code> uses a <a href=\"#VkSampler\">VkSampler</a> as a result of this command, then the sampler <strong class=\"purple\">must</strong> not have been created with <code>VK_SAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM</code>."
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_VERSION_1_1,VK_KHR_multiview)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-maxMultiviewInstanceIndex-02688",
|
|
"text": " If the draw is recorded in a render pass instance with multiview enabled, the maximum instance index <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#VkPhysicalDeviceMultiviewProperties\">VkPhysicalDeviceMultiviewProperties</a>::<code>maxMultiviewInstanceIndex</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_EXT_sample_locations)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-sampleLocationsEnable-02689",
|
|
"text": " If the bound graphics pipeline was created with <a href=\"#VkPipelineSampleLocationsStateCreateInfoEXT\">VkPipelineSampleLocationsStateCreateInfoEXT</a>::<code>sampleLocationsEnable</code> set to <code>VK_TRUE</code> and the current subpass has a depth/stencil attachment, then that attachment <strong class=\"purple\">must</strong> have been created with the <code>VK_IMAGE_CREATE_SAMPLE_LOCATIONS_COMPATIBLE_DEPTH_BIT_EXT</code> bit set"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-None-06666",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_SAMPLE_LOCATIONS_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetSampleLocationsEXT\">vkCmdSetSampleLocationsEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command"
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-viewportCount-03417",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, but not the <code>VK_DYNAMIC_STATE_SCISSOR_WITH_COUNT</code> dynamic state enabled, then <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>viewportCount</code> parameter of <code>vkCmdSetViewportWithCount</code> <strong class=\"purple\">must</strong> match the <code>VkPipelineViewportStateCreateInfo</code>::<code>scissorCount</code> of the pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-scissorCount-03418",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_SCISSOR_WITH_COUNT</code> dynamic state enabled, but not the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, then <a href=\"#vkCmdSetScissorWithCount\">vkCmdSetScissorWithCount</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>scissorCount</code> parameter of <code>vkCmdSetScissorWithCount</code> <strong class=\"purple\">must</strong> match the <code>VkPipelineViewportStateCreateInfo</code>::<code>viewportCount</code> of the pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-viewportCount-03419",
|
|
"text": " If the bound graphics pipeline state was created with both the <code>VK_DYNAMIC_STATE_SCISSOR_WITH_COUNT</code> and <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic states enabled then both <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a> and <a href=\"#vkCmdSetScissorWithCount\">vkCmdSetScissorWithCount</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>viewportCount</code> parameter of <code>vkCmdSetViewportWithCount</code> <strong class=\"purple\">must</strong> match the <code>scissorCount</code> parameter of <code>vkCmdSetScissorWithCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-primitiveTopology-03420",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_PRIMITIVE_TOPOLOGY_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetPrimitiveTopologyEXT\">vkCmdSetPrimitiveTopologyEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>primitiveTopology</code> parameter of <code>vkCmdSetPrimitiveTopologyEXT</code> <strong class=\"purple\">must</strong> be of the same <a href=\"#drawing-primitive-topology-class\">topology class</a> as the pipeline <a href=\"#VkPipelineInputAssemblyStateCreateInfo\">VkPipelineInputAssemblyStateCreateInfo</a>::<code>topology</code> state"
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_NV_clip_space_w_scaling)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-viewportCount-04137",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, but not the <code>VK_DYNAMIC_STATE_VIEWPORT_W_SCALING_NV</code> dynamic state enabled, then the bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <a href=\"#VkPipelineViewportWScalingStateCreateInfoNV\">VkPipelineViewportWScalingStateCreateInfoNV</a>::<code>viewportCount</code> greater or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-viewportCount-04138",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> and <code>VK_DYNAMIC_STATE_VIEWPORT_W_SCALING_NV</code> dynamic states enabled then the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWScalingNV\">vkCmdSetViewportWScalingNV</a> <strong class=\"purple\">must</strong> be greater than or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_NV_shading_rate_image)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-viewportCount-04139",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, but not the <code>VK_DYNAMIC_STATE_VIEWPORT_SHADING_RATE_PALETTE_NV</code> dynamic state enabled, then the bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <a href=\"#VkPipelineViewportShadingRateImageStateCreateInfoNV\">VkPipelineViewportShadingRateImageStateCreateInfoNV</a>::<code>viewportCount</code> greater or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-viewportCount-04140",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> and <code>VK_DYNAMIC_STATE_VIEWPORT_SHADING_RATE_PALETTE_NV</code> dynamic states enabled then the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportShadingRatePaletteNV\">vkCmdSetViewportShadingRatePaletteNV</a> <strong class=\"purple\">must</strong> be greater than or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_NV_viewport_swizzle)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-VkPipelineVieportCreateInfo-04141",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled and a <a href=\"#VkPipelineViewportSwizzleStateCreateInfoNV\">VkPipelineViewportSwizzleStateCreateInfoNV</a> structure chained from <code>VkPipelineVieportCreateInfo</code>, then the bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <a href=\"#VkPipelineViewportSwizzleStateCreateInfoNV\">VkPipelineViewportSwizzleStateCreateInfoNV</a>::<code>viewportCount</code> greater or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_NV_scissor_exclusive)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-VkPipelineVieportCreateInfo-04142",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled and a <a href=\"#VkPipelineViewportExclusiveScissorStateCreateInfoNV\">VkPipelineViewportExclusiveScissorStateCreateInfoNV</a> structure chained from <code>VkPipelineVieportCreateInfo</code>, then the bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <a href=\"#VkPipelineViewportExclusiveScissorStateCreateInfoNV\">VkPipelineViewportExclusiveScissorStateCreateInfoNV</a>::<code>exclusiveScissorCount</code> greater or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-None-04876",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_RASTERIZER_DISCARD_ENABLE</code> dynamic state enabled then <a href=\"#vkCmdSetRasterizerDiscardEnable\">vkCmdSetRasterizerDiscardEnable</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-None-04877",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_DEPTH_BIAS_ENABLE</code> dynamic state enabled then <a href=\"#vkCmdSetDepthBiasEnable\">vkCmdSetDepthBiasEnable</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-logicOp-04878",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_LOGIC_OP_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetLogicOpEXT\">vkCmdSetLogicOpEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command and the <code>logicOp</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkLogicOp\">VkLogicOp</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-None-04875",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_PATCH_CONTROL_POINTS_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetPatchControlPointsEXT\">vkCmdSetPatchControlPointsEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-None-04879",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_PRIMITIVE_RESTART_ENABLE_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetPrimitiveRestartEnableEXT\">vkCmdSetPrimitiveRestartEnableEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command"
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_KHR_fragment_shading_rate)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-primitiveFragmentShadingRateWithMultipleViewports-04552",
|
|
"text": " If the <a href=\"#limits-primitiveFragmentShadingRateWithMultipleViewports\"><code>primitiveFragmentShadingRateWithMultipleViewports</code></a> limit is not supported, the bound graphics pipeline was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, and any of the shader stages of the bound graphics pipeline write to the <code>PrimitiveShadingRateKHR</code> built-in, then <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>viewportCount</code> parameter of <code>vkCmdSetViewportWithCount</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-imageView-06172",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pDepthAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pDepthAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the depth attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-imageView-06173",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pStencilAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pStencilAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the stencil attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-viewMask-06178",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound graphics pipeline <strong class=\"purple\">must</strong> have been created with a <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>viewMask</code> equal to <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>viewMask</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-colorAttachmentCount-06179",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound graphics pipeline <strong class=\"purple\">must</strong> have been created with a <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>colorAttachmentCount</code> equal to <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>colorAttachmentCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-colorAttachmentCount-06180",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>colorAttachmentCount</code> greater than <code>0</code>, then each element of the <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pColorAttachments</code> array with a <code>imageView</code> not equal to <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> <strong class=\"purple\">must</strong> have been created with a <a href=\"#VkFormat\">VkFormat</a> equal to the corresponding element of <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>pColorAttachmentFormats</code> used to create the currently bound graphics pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-pDepthAttachment-06181",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>depthAttachmentFormat</code> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the <a href=\"#VkFormat\">VkFormat</a> used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-pStencilAttachment-06182",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>stencilAttachmentFormat</code> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the <a href=\"#VkFormat\">VkFormat</a> used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_VERSION_1_1,VK_KHR_maintenance2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-imageView-06174",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pDepthAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pDepthAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_STENCIL_ATTACHMENT_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the depth attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-imageView-06175",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pStencilAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pStencilAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_STENCIL_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the stencil attachment"
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_VERSION_1_2,VK_KHR_separate_depth_stencil_layouts)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-imageView-06176",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pDepthAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pDepthAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the depth attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-imageView-06177",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pStencilAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pStencilAttachment</code> is <code>VK_IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the stencil attachment"
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_EXT_color_write_enable)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-attachmentCount-06667",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_COLOR_WRITE_ENABLE_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetColorWriteEnableEXT\">vkCmdSetColorWriteEnableEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>attachmentCount</code> parameter of <code>vkCmdSetColorWriteEnableEXT</code> <strong class=\"purple\">must</strong> be greater than or equal to the <code>VkPipelineColorBlendStateCreateInfo</code>::<code>attachmentCount</code> of the currently bound graphics pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-attachmentCount-06815",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_COLOR_WRITE_ENABLE_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetColorWriteEnableEXT\">vkCmdSetColorWriteEnableEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>attachmentCount</code> parameter of <code>vkCmdSetColorWriteEnableEXT</code> <strong class=\"purple\">must</strong> be less than or equal to the <code>maxColorAttachments</code> member of <code>VkPhysicalDeviceLimits</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_KHR_fragment_shading_rate)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-imageView-06183",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingFragmentShadingRateAttachmentInfoKHR\">VkRenderingFragmentShadingRateAttachmentInfoKHR</a>::<code>imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the currently bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <code>VK_PIPELINE_CREATE_RENDERING_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_EXT_fragment_density_map)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-imageView-06184",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingFragmentDensityMapAttachmentInfoEXT\">VkRenderingFragmentDensityMapAttachmentInfoEXT</a>::<code>imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the currently bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <code>VK_PIPELINE_CREATE_RENDERING_FRAGMENT_DENSITY_MAP_ATTACHMENT_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_AMD_mixed_attachment_samples,VK_NV_framebuffer_mixed_samples)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-colorAttachmentCount-06185",
|
|
"text": " If the currently bound pipeline was created with a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> with a <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>colorAttachmentCount</code> parameter greater than <code>0</code>, then each element of the <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pColorAttachments</code> array with a <code>imageView</code> not equal to <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> <strong class=\"purple\">must</strong> have been created with a sample count equal to the corresponding element of the <code>pColorAttachmentSamples</code> member of <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> used to create the currently bound graphics pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-pDepthAttachment-06186",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline was created with a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of the <code>depthStencilAttachmentSamples</code> member of <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the sample count used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-pStencilAttachment-06187",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline was created with a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of the <code>depthStencilAttachmentSamples</code> member of <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the sample count used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-colorAttachmentCount-06188",
|
|
"text": " If the currently bound pipeline was created without a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> with a <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>colorAttachmentCount</code> parameter greater than <code>0</code>, then each element of the <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pColorAttachments</code> array with a <code>imageView</code> not equal to <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> <strong class=\"purple\">must</strong> have been created with a sample count equal to the value of <a href=\"#VkPipelineMultisampleStateCreateInfo\">VkPipelineMultisampleStateCreateInfo</a>::<code>rasterizationSamples</code> used to create the currently bound graphics pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-pDepthAttachment-06189",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline was created without a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of <a href=\"#VkPipelineMultisampleStateCreateInfo\">VkPipelineMultisampleStateCreateInfo</a>::<code>rasterizationSamples</code> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the sample count used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-pStencilAttachment-06190",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline was created without a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of <a href=\"#VkPipelineMultisampleStateCreateInfo\">VkPipelineMultisampleStateCreateInfo</a>::<code>rasterizationSamples</code> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the sample count used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-renderPass-06198",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline <strong class=\"purple\">must</strong> have been created with a <a href=\"#VkGraphicsPipelineCreateInfo\">VkGraphicsPipelineCreateInfo</a>::<code>renderPass</code> equal to <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_EXT_primitives_generated_query)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-primitivesGeneratedQueryWithRasterizerDiscard-06708",
|
|
"text": " If the <a href=\"#features-primitivesGeneratedQueryWithRasterizerDiscard\"><code>primitivesGeneratedQueryWithRasterizerDiscard</code></a> feature is not enabled and the <code>VK_QUERY_TYPE_PRIMITIVES_GENERATED_EXT</code> query is active, <a href=\"#primsrast-discard\">rasterization discard</a> <strong class=\"purple\">must</strong> not be enabled."
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_EXT_primitives_generated_query)+(VK_EXT_transform_feedback)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-primitivesGeneratedQueryWithNonZeroStreams-06709",
|
|
"text": " If the <a href=\"#features-primitivesGeneratedQueryWithNonZeroStreams\"><code>primitivesGeneratedQueryWithNonZeroStreams</code></a> feature is not enabled and the <code>VK_QUERY_TYPE_PRIMITIVES_GENERATED_EXT</code> query is active, the bound graphics pipeline <strong class=\"purple\">must</strong> not have been created with a non-zero value in <code>VkPipelineRasterizationStateStreamCreateInfoEXT</code>::<code>rasterizationStream</code>."
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_EXT_vertex_input_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-None-04912",
|
|
"text": " If the bound graphics pipeline was created with both the <code>VK_DYNAMIC_STATE_VERTEX_INPUT_EXT</code> and <code>VK_DYNAMIC_STATE_VERTEX_INPUT_BINDING_STRIDE_EXT</code> dynamic states enabled, then <a href=\"#vkCmdSetVertexInputEXT\">vkCmdSetVertexInputEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this draw command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-pStrides-04913",
|
|
"text": " If the bound graphics pipeline was created with the <code>VK_DYNAMIC_STATE_VERTEX_INPUT_BINDING_STRIDE_EXT</code> dynamic state enabled, but not the <code>VK_DYNAMIC_STATE_VERTEX_INPUT_EXT</code> dynamic state enabled, then <a href=\"#vkCmdBindVertexBuffers2EXT\">vkCmdBindVertexBuffers2EXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this draw command, and the <code>pStrides</code> parameter of <a href=\"#vkCmdBindVertexBuffers2EXT\">vkCmdBindVertexBuffers2EXT</a> <strong class=\"purple\">must</strong> not be <code>NULL</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+!(VK_EXT_vertex_input_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-pStrides-04884",
|
|
"text": " If the bound graphics pipeline was created with the <code>VK_DYNAMIC_STATE_VERTEX_INPUT_BINDING_STRIDE_EXT</code> dynamic state enabled, then <a href=\"#vkCmdBindVertexBuffers2EXT\">vkCmdBindVertexBuffers2EXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>pStrides</code> parameter of <a href=\"#vkCmdBindVertexBuffers2EXT\">vkCmdBindVertexBuffers2EXT</a> <strong class=\"purple\">must</strong> not be <code>NULL</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_EXT_vertex_input_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-None-04914",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VERTEX_INPUT_EXT</code> dynamic state enabled, then <a href=\"#vkCmdSetVertexInputEXT\">vkCmdSetVertexInputEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this draw command"
|
|
}
|
|
],
|
|
"(VK_EXT_multi_draw)+(VK_NV_mesh_shader)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMultiIndexedEXT-stage-06481",
|
|
"text": " The bound graphics pipeline <strong class=\"purple\">must</strong> not have been created with the <a href=\"#VkPipelineShaderStageCreateInfo\">VkPipelineShaderStageCreateInfo</a>::<code>stage</code> member of an element of <a href=\"#VkGraphicsPipelineCreateInfo\">VkGraphicsPipelineCreateInfo</a>::<code>pStages</code> set to <code>VK_SHADER_STAGE_TASK_BIT_NV</code> or <code>VK_SHADER_STAGE_MESH_BIT_NV</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdDrawIndirect": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-magFilter-04553",
|
|
"text": " If a <a href=\"#VkSampler\">VkSampler</a> created with <code>magFilter</code> or <code>minFilter</code> equal to <code>VK_FILTER_LINEAR</code> and <code>compareEnable</code> equal to <code>VK_FALSE</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-mipmapMode-04770",
|
|
"text": " If a <a href=\"#VkSampler\">VkSampler</a> created with <code>mipmapMode</code> equal to <code>VK_SAMPLER_MIPMAP_MODE_LINEAR</code> and <code>compareEnable</code> equal to <code>VK_FALSE</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-None-02691",
|
|
"text": " If a <code>VkImageView</code> is accessed using atomic operations as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_STORAGE_IMAGE_ATOMIC_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-None-02697",
|
|
"text": " For each set <em>n</em> that is statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command, a descriptor set <strong class=\"purple\">must</strong> have been bound to <em>n</em> at the same pipeline bind point, with a <code>VkPipelineLayout</code> that is compatible for set <em>n</em>, with the <code>VkPipelineLayout</code> used to create the current <code>VkPipeline</code>, as described in <a href=\"#descriptorsets-compatibility\">Pipeline Layout Compatibility</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-None-02699",
|
|
"text": " Descriptors in each bound descriptor set, specified via <code>vkCmdBindDescriptorSets</code>, <strong class=\"purple\">must</strong> be valid if they are statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-None-02700",
|
|
"text": " A valid pipeline <strong class=\"purple\">must</strong> be bound to the pipeline bind point used by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-commandBuffer-02701",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command requires any dynamic state, that state <strong class=\"purple\">must</strong> have been set or inherited (if the <code><a href=\"#VK_NV_inherited_viewport_scissor\">VK_NV_inherited_viewport_scissor</a></code> extension is enabled) for <code>commandBuffer</code>, and done so after any previously bound pipeline with the corresponding state not specified as dynamic"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-None-02859",
|
|
"text": " There <strong class=\"purple\">must</strong> not have been any calls to dynamic state setting commands for any state not specified as dynamic in the <code>VkPipeline</code> object bound to the pipeline bind point used by this command, since that pipeline was bound"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-None-02702",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> object that uses unnormalized coordinates, that sampler <strong class=\"purple\">must</strong> not be used to sample from any <code>VkImage</code> with a <code>VkImageView</code> of the type <code>VK_IMAGE_VIEW_TYPE_3D</code>, <code>VK_IMAGE_VIEW_TYPE_CUBE</code>, <code>VK_IMAGE_VIEW_TYPE_1D_ARRAY</code>, <code>VK_IMAGE_VIEW_TYPE_2D_ARRAY</code> or <code>VK_IMAGE_VIEW_TYPE_CUBE_ARRAY</code>, in any shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-None-02703",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> object that uses unnormalized coordinates, that sampler <strong class=\"purple\">must</strong> not be used with any of the SPIR-V <code>OpImageSample*</code> or <code>OpImageSparseSample*</code> instructions with <code>ImplicitLod</code>, <code>Dref</code> or <code>Proj</code> in their name, in any shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-None-02704",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> object that uses unnormalized coordinates, that sampler <strong class=\"purple\">must</strong> not be used with any of the SPIR-V <code>OpImageSample*</code> or <code>OpImageSparseSample*</code> instructions that includes a LOD bias or any offset values, in any shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-None-04115",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> is accessed using <code>OpImageWrite</code> as a result of this command, then the <code>Type</code> of the <code>Texel</code> operand of that instruction <strong class=\"purple\">must</strong> have at least as many components as the image view’s format"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-OpImageWrite-04469",
|
|
"text": " If a <a href=\"#VkBufferView\">VkBufferView</a> is accessed using <code>OpImageWrite</code> as a result of this command, then the <code>Type</code> of the <code>Texel</code> operand of that instruction <strong class=\"purple\">must</strong> have at least as many components as the buffer view’s format"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-renderPass-02684",
|
|
"text": " The current render pass <strong class=\"purple\">must</strong> be <a href=\"#renderpass-compatibility\">compatible</a> with the <code>renderPass</code> member of the <code>VkGraphicsPipelineCreateInfo</code> structure specified when creating the <code>VkPipeline</code> bound to <code>VK_PIPELINE_BIND_POINT_GRAPHICS</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-subpass-02685",
|
|
"text": " The subpass index of the current render pass <strong class=\"purple\">must</strong> be equal to the <code>subpass</code> member of the <code>VkGraphicsPipelineCreateInfo</code> structure specified when creating the <code>VkPipeline</code> bound to <code>VK_PIPELINE_BIND_POINT_GRAPHICS</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-None-02686",
|
|
"text": " Every input attachment used by the current subpass <strong class=\"purple\">must</strong> be bound to the pipeline via a descriptor set"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-None-06537",
|
|
"text": " Memory backing image subresources used as attachments in the current render pass <strong class=\"purple\">must</strong> not be written in any way other than as an attachment by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-None-06538",
|
|
"text": " If any recorded command in the current subpass will write to an image subresource as an attachment, this command <strong class=\"purple\">must</strong> not read from the memory backing that image subresource in any other way than as an attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-None-06539",
|
|
"text": " If any recorded command in the current subpass will read from an image subresource used as an attachment in any way other than as an attachment, this command <strong class=\"purple\">must</strong> not write to that image subresource as an attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-None-06886",
|
|
"text": " If the current render pass instance uses a depth/stencil attachment with a read-only layout for the depth aspect, <a href=\"#fragops-depth-write\">depth writes</a> <strong class=\"purple\">must</strong> be disabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-None-06887",
|
|
"text": " If the current render pass instance uses a depth/stencil attachment with a read-only layout for the stencil aspect and stencil test is enabled, <a href=\"#fragops-stencil\">all stencil ops</a> <strong class=\"purple\">must</strong> be <code>VK_STENCIL_OP_KEEP</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-blendEnable-04727",
|
|
"text": " If rasterization is not disabled in the bound graphics pipeline, then for each color attachment in the subpass, if the corresponding image view’s <a href=\"#resources-image-view-format-features\">format features</a> do not contain <code>VK_FORMAT_FEATURE_COLOR_ATTACHMENT_BLEND_BIT</code>, then the <code>blendEnable</code> member of the corresponding element of the <code>pAttachments</code> member of <code>pColorBlendState</code> <strong class=\"purple\">must</strong> be <code>VK_FALSE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-rasterizationSamples-04740",
|
|
"text": " If rasterization is not disabled in the bound graphics pipeline, and neither the <code><a href=\"#VK_AMD_mixed_attachment_samples\">VK_AMD_mixed_attachment_samples</a></code> nor the <code><a href=\"#VK_NV_framebuffer_mixed_samples\">VK_NV_framebuffer_mixed_samples</a></code> extensions are enabled, then <a href=\"#VkPipelineMultisampleStateCreateInfo\">VkPipelineMultisampleStateCreateInfo</a>::<code>rasterizationSamples</code> <strong class=\"purple\">must</strong> be the same as the current subpass color and/or depth/stencil attachments"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-None-04007",
|
|
"text": " All vertex input bindings accessed via vertex input variables declared in the vertex shader entry point’s interface <strong class=\"purple\">must</strong> have either valid or <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> buffers bound"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-None-04008",
|
|
"text": " If the <a href=\"#features-nullDescriptor\"><code>nullDescriptor</code></a> feature is not enabled, all vertex input bindings accessed via vertex input variables declared in the vertex shader entry point’s interface <strong class=\"purple\">must</strong> not be <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-None-02721",
|
|
"text": " For a given vertex buffer binding, any attribute data fetched <strong class=\"purple\">must</strong> be entirely contained within the corresponding vertex buffer binding, as described in <a href=\"#fxvertex-input\">Vertex Input Description</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-buffer-02708",
|
|
"text": " If <code>buffer</code> is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-buffer-02709",
|
|
"text": " <code>buffer</code> <strong class=\"purple\">must</strong> have been created with the <code>VK_BUFFER_USAGE_INDIRECT_BUFFER_BIT</code> bit set"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-offset-02710",
|
|
"text": " <code>offset</code> <strong class=\"purple\">must</strong> be a multiple of <code>4</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-drawCount-02718",
|
|
"text": " If the <a href=\"#features-multiDrawIndirect\"><code>multiDrawIndirect</code></a> feature is not enabled, <code>drawCount</code> <strong class=\"purple\">must</strong> be <code>0</code> or <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-drawCount-02719",
|
|
"text": " <code>drawCount</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxDrawIndirectCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-firstInstance-00478",
|
|
"text": " If the <a href=\"#features-drawIndirectFirstInstance\"><code>drawIndirectFirstInstance</code></a> feature is not enabled, all the <code>firstInstance</code> members of the <code>VkDrawIndirectCommand</code> structures accessed by this command <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-drawCount-00476",
|
|
"text": " If <code>drawCount</code> is greater than <code>1</code>, <code>stride</code> <strong class=\"purple\">must</strong> be a multiple of <code>4</code> and <strong class=\"purple\">must</strong> be greater than or equal to <code>sizeof</code>(<code>VkDrawIndirectCommand</code>)"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-drawCount-00487",
|
|
"text": " If <code>drawCount</code> is equal to <code>1</code>, <span class=\"eq\">(<code>offset</code> + <code>sizeof</code>(<a href=\"#VkDrawIndirectCommand\">VkDrawIndirectCommand</a>))</span> <strong class=\"purple\">must</strong> be less than or equal to the size of <code>buffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-drawCount-00488",
|
|
"text": " If <code>drawCount</code> is greater than <code>1</code>, <span class=\"eq\">(<code>stride</code> {times} (<code>drawCount</code> - 1) + <code>offset</code> + <code>sizeof</code>(<a href=\"#VkDrawIndirectCommand\">VkDrawIndirectCommand</a>))</span> <strong class=\"purple\">must</strong> be less than or equal to the size of <code>buffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-buffer-parameter",
|
|
"text": " <code>buffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBuffer\">VkBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called inside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-commonparent",
|
|
"text": " Both of <code>buffer</code>, and <code>commandBuffer</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"!(VK_VERSION_1_3,VK_KHR_format_feature_flags2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-aspectMask-06478",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> is sampled with <a href=\"#textures-depth-compare-operation\">depth comparison</a>, the image view <strong class=\"purple\">must</strong> have been created with an <code>aspectMask</code> that contains <code>VK_IMAGE_ASPECT_DEPTH_BIT</code>."
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_format_feature_flags2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-None-06479",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> is sampled with <a href=\"#textures-depth-compare-operation\">depth comparison</a>, the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_SAMPLED_IMAGE_DEPTH_COMPARISON_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-OpTypeImage-06423",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> or <a href=\"#VkBufferView\">VkBufferView</a> being written as a storage image or storage texel buffer where the image format field of the <code>OpTypeImage</code> is <code>Unknown</code> then the view’s format feature <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_STORAGE_WRITE_WITHOUT_FORMAT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-OpTypeImage-06424",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> or <a href=\"#VkBufferView\">VkBufferView</a> being read as a storage image or storage texel buffer where the image format field of the <code>OpTypeImage</code> is <code>Unknown</code> then the view’s format feature <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_STORAGE_READ_WITHOUT_FORMAT_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_IMG_filter_cubic,VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-None-02692",
|
|
"text": " If a <code>VkImageView</code> is sampled with <code>VK_FILTER_CUBIC_EXT</code> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_CUBIC_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_IMG_filter_cubic,VK_EXT_filter_cubic)+!(VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-None-02693",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> being sampled with <code>VK_FILTER_CUBIC_EXT</code> as a result of this command <strong class=\"purple\">must</strong> not have a <a href=\"#VkImageViewType\">VkImageViewType</a> of <code>VK_IMAGE_VIEW_TYPE_3D</code>, <code>VK_IMAGE_VIEW_TYPE_CUBE</code>, or <code>VK_IMAGE_VIEW_TYPE_CUBE_ARRAY</code>"
|
|
}
|
|
],
|
|
"(VK_IMG_filter_cubic,VK_EXT_filter_cubic)+(VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-filterCubic-02694",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> being sampled with <code>VK_FILTER_CUBIC_EXT</code> as a result of this command <strong class=\"purple\">must</strong> have a <a href=\"#VkImageViewType\">VkImageViewType</a> and format that supports cubic filtering, as specified by <code>VkFilterCubicImageViewImageFormatPropertiesEXT</code>::<code>filterCubic</code> returned by <code>vkGetPhysicalDeviceImageFormatProperties2</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-filterCubicMinmax-02695",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> being sampled with <code>VK_FILTER_CUBIC_EXT</code> with a reduction mode of either <code>VK_SAMPLER_REDUCTION_MODE_MIN</code> or <code>VK_SAMPLER_REDUCTION_MODE_MAX</code> as a result of this command <strong class=\"purple\">must</strong> have a <a href=\"#VkImageViewType\">VkImageViewType</a> and format that supports cubic filtering together with minmax filtering, as specified by <code>VkFilterCubicImageViewImageFormatPropertiesEXT</code>::<code>filterCubicMinmax</code> returned by <code>vkGetPhysicalDeviceImageFormatProperties2</code>"
|
|
}
|
|
],
|
|
"(VK_NV_corner_sampled_image)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-flags-02696",
|
|
"text": " Any <a href=\"#VkImage\">VkImage</a> created with a <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a>::<code>flags</code> containing <code>VK_IMAGE_CREATE_CORNER_SAMPLED_BIT_NV</code> sampled as a result of this command <strong class=\"purple\">must</strong> only be sampled using a <a href=\"#VkSamplerAddressMode\">VkSamplerAddressMode</a> of <code>VK_SAMPLER_ADDRESS_MODE_CLAMP_TO_EDGE</code>"
|
|
}
|
|
],
|
|
"!(VK_VERSION_1_3,VK_KHR_maintenance4)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-None-02698",
|
|
"text": " For each push constant that is statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command, a push constant value <strong class=\"purple\">must</strong> have been set for the same pipeline bind point, with a <code>VkPipelineLayout</code> that is compatible for push constants, with the <code>VkPipelineLayout</code> used to create the current <code>VkPipeline</code>, as described in <a href=\"#descriptorsets-compatibility\">Pipeline Layout Compatibility</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_maintenance4)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-maintenance4-06425",
|
|
"text": " If the <a href=\"#features-maintenance4\"><code>maintenance4</code></a> feature is not enabled, then for each push constant that is statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command, a push constant value <strong class=\"purple\">must</strong> have been set for the same pipeline bind point, with a <code>VkPipelineLayout</code> that is compatible for push constants, with the <code>VkPipelineLayout</code> used to create the current <code>VkPipeline</code>, as described in <a href=\"#descriptorsets-compatibility\">Pipeline Layout Compatibility</a>"
|
|
}
|
|
],
|
|
"!(VK_EXT_pipeline_robustness)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-None-02705",
|
|
"text": " If the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, and if the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a uniform buffer, it <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-None-02706",
|
|
"text": " If the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, and if the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a storage buffer, it <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
}
|
|
],
|
|
"(VK_EXT_pipeline_robustness)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-uniformBuffers-06935",
|
|
"text": " If any stage of the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a uniform buffer, and that stage was created without enabling either <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_EXT</code> or <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXT</code> for <code>uniformBuffers</code>, and the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, that stage <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-storageBuffers-06936",
|
|
"text": " If any stage of the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a storage buffer, and that stage was created without enabling either <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_EXT</code> or <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXT</code> for <code>storageBuffers</code>, and the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, that stage <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-commandBuffer-02707",
|
|
"text": " If <code>commandBuffer</code> is an unprotected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, any resource accessed by the <a href=\"#VkPipeline\">VkPipeline</a> object bound to the pipeline bind point used by this command <strong class=\"purple\">must</strong> not be a protected resource"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-commandBuffer-02711",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> not be a protected command buffer"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-None-06550",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> or <code>VkImageView</code> object that enables <a href=\"#samplers-YCbCr-conversion\">sampler {YCbCr} conversion</a>, that object <strong class=\"purple\">must</strong> only be used with <code>OpImageSample*</code> or <code>OpImageSparseSample*</code> instructions"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-ConstOffset-06551",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> or <code>VkImageView</code> object that enables <a href=\"#samplers-YCbCr-conversion\">sampler {YCbCr} conversion</a>, that object <strong class=\"purple\">must</strong> not use the <code>ConstOffset</code> and <code>Offset</code> operands"
|
|
}
|
|
],
|
|
"(VK_EXT_shader_image_atomic_int64)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-SampledType-04470",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a 64-bit component width is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 64"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-SampledType-04471",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a component width less than 64-bit is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 32"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-SampledType-04472",
|
|
"text": " If a <a href=\"#VkBufferView\">VkBufferView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a 64-bit component width is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 64"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-SampledType-04473",
|
|
"text": " If a <a href=\"#VkBufferView\">VkBufferView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a component width less than 64-bit is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 32"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-sparseImageInt64Atomics-04474",
|
|
"text": " If the <a href=\"#features-sparseImageInt64Atomics\"><code>sparseImageInt64Atomics</code></a> feature is not enabled, <a href=\"#VkImage\">VkImage</a> objects created with the <code>VK_IMAGE_CREATE_SPARSE_RESIDENCY_BIT</code> flag <strong class=\"purple\">must</strong> not be accessed by atomic instructions through an <code>OpTypeImage</code> with a <code>SampledType</code> with a <code>Width</code> of 64 by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-sparseImageInt64Atomics-04475",
|
|
"text": " If the <a href=\"#features-sparseImageInt64Atomics\"><code>sparseImageInt64Atomics</code></a> feature is not enabled, <a href=\"#VkBuffer\">VkBuffer</a> objects created with the <code>VK_BUFFER_CREATE_SPARSE_RESIDENCY_BIT</code> flag <strong class=\"purple\">must</strong> not be accessed by atomic instructions through an <code>OpTypeImage</code> with a <code>SampledType</code> with a <code>Width</code> of 64 by this command"
|
|
}
|
|
],
|
|
"(VK_QCOM_image_processing)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-OpImageWeightedSampleQCOM-06971",
|
|
"text": " If <code>OpImageWeightedSampleQCOM</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_WEIGHT_SAMPLED_IMAGE_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-OpImageWeightedSampleQCOM-06972",
|
|
"text": " If <code>OpImageWeightedSampleQCOM</code> uses a <a href=\"#VkImageView\">VkImageView</a> as a sample weight image as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_WEIGHT_IMAGE_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-OpImageBoxFilterQCOM-06973",
|
|
"text": " If <code>OpImageBoxFilterQCOM</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_BOX_FILTER_SAMPLED_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-OpImageBlockMatchSSDQCOM-06974",
|
|
"text": " If <code>OpImageBlockMatchSSDQCOM</code> is used to read from an <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-OpImageBlockMatchSADQCOM-06975",
|
|
"text": " If <code>OpImageBlockMatchSADQCOM</code> is used to read from an <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-OpImageBlockMatchSADQCOM-06976",
|
|
"text": " If <code>OpImageBlockMatchSADQCOM</code> or OpImageBlockMatchSSDQCOM is used to read from a reference image as result of this command, then the specified reference coordinates <strong class=\"purple\">must</strong> not fail <a href=\"#textures-integer-coordinate-validation\">integer texel coordinate validation</a>."
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-OpImageWeightedSampleQCOM-06977",
|
|
"text": " If <code>OpImageWeightedSampleQCOM</code>, <code>OpImageBoxFilterQCOM</code>, <code>OpImageBlockMatchSSDQCOM</code>, or <code>OpImageBlockMatchSADQCOM</code> uses a <a href=\"#VkSampler\">VkSampler</a> as a result of this command, then the sampler <strong class=\"purple\">must</strong> have been created with <code>VK_SAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-OpImageWeightedSampleQCOM-06978",
|
|
"text": " If any command other than <code>OpImageWeightedSampleQCOM</code>, <code>OpImageBoxFilterQCOM</code>, <code>OpImageBlockMatchSSDQCOM</code>, or <code>OpImageBlockMatchSADQCOM</code> uses a <a href=\"#VkSampler\">VkSampler</a> as a result of this command, then the sampler <strong class=\"purple\">must</strong> not have been created with <code>VK_SAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM</code>."
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_multiview)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-maxMultiviewInstanceIndex-02688",
|
|
"text": " If the draw is recorded in a render pass instance with multiview enabled, the maximum instance index <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#VkPhysicalDeviceMultiviewProperties\">VkPhysicalDeviceMultiviewProperties</a>::<code>maxMultiviewInstanceIndex</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_sample_locations)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-sampleLocationsEnable-02689",
|
|
"text": " If the bound graphics pipeline was created with <a href=\"#VkPipelineSampleLocationsStateCreateInfoEXT\">VkPipelineSampleLocationsStateCreateInfoEXT</a>::<code>sampleLocationsEnable</code> set to <code>VK_TRUE</code> and the current subpass has a depth/stencil attachment, then that attachment <strong class=\"purple\">must</strong> have been created with the <code>VK_IMAGE_CREATE_SAMPLE_LOCATIONS_COMPATIBLE_DEPTH_BIT_EXT</code> bit set"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-None-06666",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_SAMPLE_LOCATIONS_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetSampleLocationsEXT\">vkCmdSetSampleLocationsEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-viewportCount-03417",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, but not the <code>VK_DYNAMIC_STATE_SCISSOR_WITH_COUNT</code> dynamic state enabled, then <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>viewportCount</code> parameter of <code>vkCmdSetViewportWithCount</code> <strong class=\"purple\">must</strong> match the <code>VkPipelineViewportStateCreateInfo</code>::<code>scissorCount</code> of the pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-scissorCount-03418",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_SCISSOR_WITH_COUNT</code> dynamic state enabled, but not the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, then <a href=\"#vkCmdSetScissorWithCount\">vkCmdSetScissorWithCount</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>scissorCount</code> parameter of <code>vkCmdSetScissorWithCount</code> <strong class=\"purple\">must</strong> match the <code>VkPipelineViewportStateCreateInfo</code>::<code>viewportCount</code> of the pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-viewportCount-03419",
|
|
"text": " If the bound graphics pipeline state was created with both the <code>VK_DYNAMIC_STATE_SCISSOR_WITH_COUNT</code> and <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic states enabled then both <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a> and <a href=\"#vkCmdSetScissorWithCount\">vkCmdSetScissorWithCount</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>viewportCount</code> parameter of <code>vkCmdSetViewportWithCount</code> <strong class=\"purple\">must</strong> match the <code>scissorCount</code> parameter of <code>vkCmdSetScissorWithCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-primitiveTopology-03420",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_PRIMITIVE_TOPOLOGY_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetPrimitiveTopologyEXT\">vkCmdSetPrimitiveTopologyEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>primitiveTopology</code> parameter of <code>vkCmdSetPrimitiveTopologyEXT</code> <strong class=\"purple\">must</strong> be of the same <a href=\"#drawing-primitive-topology-class\">topology class</a> as the pipeline <a href=\"#VkPipelineInputAssemblyStateCreateInfo\">VkPipelineInputAssemblyStateCreateInfo</a>::<code>topology</code> state"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_NV_clip_space_w_scaling)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-viewportCount-04137",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, but not the <code>VK_DYNAMIC_STATE_VIEWPORT_W_SCALING_NV</code> dynamic state enabled, then the bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <a href=\"#VkPipelineViewportWScalingStateCreateInfoNV\">VkPipelineViewportWScalingStateCreateInfoNV</a>::<code>viewportCount</code> greater or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-viewportCount-04138",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> and <code>VK_DYNAMIC_STATE_VIEWPORT_W_SCALING_NV</code> dynamic states enabled then the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWScalingNV\">vkCmdSetViewportWScalingNV</a> <strong class=\"purple\">must</strong> be greater than or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_NV_shading_rate_image)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-viewportCount-04139",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, but not the <code>VK_DYNAMIC_STATE_VIEWPORT_SHADING_RATE_PALETTE_NV</code> dynamic state enabled, then the bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <a href=\"#VkPipelineViewportShadingRateImageStateCreateInfoNV\">VkPipelineViewportShadingRateImageStateCreateInfoNV</a>::<code>viewportCount</code> greater or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-viewportCount-04140",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> and <code>VK_DYNAMIC_STATE_VIEWPORT_SHADING_RATE_PALETTE_NV</code> dynamic states enabled then the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportShadingRatePaletteNV\">vkCmdSetViewportShadingRatePaletteNV</a> <strong class=\"purple\">must</strong> be greater than or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_NV_viewport_swizzle)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-VkPipelineVieportCreateInfo-04141",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled and a <a href=\"#VkPipelineViewportSwizzleStateCreateInfoNV\">VkPipelineViewportSwizzleStateCreateInfoNV</a> structure chained from <code>VkPipelineVieportCreateInfo</code>, then the bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <a href=\"#VkPipelineViewportSwizzleStateCreateInfoNV\">VkPipelineViewportSwizzleStateCreateInfoNV</a>::<code>viewportCount</code> greater or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_NV_scissor_exclusive)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-VkPipelineVieportCreateInfo-04142",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled and a <a href=\"#VkPipelineViewportExclusiveScissorStateCreateInfoNV\">VkPipelineViewportExclusiveScissorStateCreateInfoNV</a> structure chained from <code>VkPipelineVieportCreateInfo</code>, then the bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <a href=\"#VkPipelineViewportExclusiveScissorStateCreateInfoNV\">VkPipelineViewportExclusiveScissorStateCreateInfoNV</a>::<code>exclusiveScissorCount</code> greater or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-None-04876",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_RASTERIZER_DISCARD_ENABLE</code> dynamic state enabled then <a href=\"#vkCmdSetRasterizerDiscardEnable\">vkCmdSetRasterizerDiscardEnable</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-None-04877",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_DEPTH_BIAS_ENABLE</code> dynamic state enabled then <a href=\"#vkCmdSetDepthBiasEnable\">vkCmdSetDepthBiasEnable</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-logicOp-04878",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_LOGIC_OP_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetLogicOpEXT\">vkCmdSetLogicOpEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command and the <code>logicOp</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkLogicOp\">VkLogicOp</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-None-04875",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_PATCH_CONTROL_POINTS_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetPatchControlPointsEXT\">vkCmdSetPatchControlPointsEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-None-04879",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_PRIMITIVE_RESTART_ENABLE_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetPrimitiveRestartEnableEXT\">vkCmdSetPrimitiveRestartEnableEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command"
|
|
}
|
|
],
|
|
"(VK_KHR_fragment_shading_rate)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-primitiveFragmentShadingRateWithMultipleViewports-04552",
|
|
"text": " If the <a href=\"#limits-primitiveFragmentShadingRateWithMultipleViewports\"><code>primitiveFragmentShadingRateWithMultipleViewports</code></a> limit is not supported, the bound graphics pipeline was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, and any of the shader stages of the bound graphics pipeline write to the <code>PrimitiveShadingRateKHR</code> built-in, then <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>viewportCount</code> parameter of <code>vkCmdSetViewportWithCount</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-imageView-06172",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pDepthAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pDepthAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the depth attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-imageView-06173",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pStencilAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pStencilAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the stencil attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-viewMask-06178",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound graphics pipeline <strong class=\"purple\">must</strong> have been created with a <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>viewMask</code> equal to <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>viewMask</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-colorAttachmentCount-06179",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound graphics pipeline <strong class=\"purple\">must</strong> have been created with a <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>colorAttachmentCount</code> equal to <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>colorAttachmentCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-colorAttachmentCount-06180",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>colorAttachmentCount</code> greater than <code>0</code>, then each element of the <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pColorAttachments</code> array with a <code>imageView</code> not equal to <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> <strong class=\"purple\">must</strong> have been created with a <a href=\"#VkFormat\">VkFormat</a> equal to the corresponding element of <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>pColorAttachmentFormats</code> used to create the currently bound graphics pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-pDepthAttachment-06181",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>depthAttachmentFormat</code> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the <a href=\"#VkFormat\">VkFormat</a> used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-pStencilAttachment-06182",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>stencilAttachmentFormat</code> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the <a href=\"#VkFormat\">VkFormat</a> used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_VERSION_1_1,VK_KHR_maintenance2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-imageView-06174",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pDepthAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pDepthAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_STENCIL_ATTACHMENT_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the depth attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-imageView-06175",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pStencilAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pStencilAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_STENCIL_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the stencil attachment"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_VERSION_1_2,VK_KHR_separate_depth_stencil_layouts)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-imageView-06176",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pDepthAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pDepthAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the depth attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-imageView-06177",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pStencilAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pStencilAttachment</code> is <code>VK_IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the stencil attachment"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_EXT_color_write_enable)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-attachmentCount-06667",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_COLOR_WRITE_ENABLE_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetColorWriteEnableEXT\">vkCmdSetColorWriteEnableEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>attachmentCount</code> parameter of <code>vkCmdSetColorWriteEnableEXT</code> <strong class=\"purple\">must</strong> be greater than or equal to the <code>VkPipelineColorBlendStateCreateInfo</code>::<code>attachmentCount</code> of the currently bound graphics pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-attachmentCount-06815",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_COLOR_WRITE_ENABLE_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetColorWriteEnableEXT\">vkCmdSetColorWriteEnableEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>attachmentCount</code> parameter of <code>vkCmdSetColorWriteEnableEXT</code> <strong class=\"purple\">must</strong> be less than or equal to the <code>maxColorAttachments</code> member of <code>VkPhysicalDeviceLimits</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_KHR_fragment_shading_rate)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-imageView-06183",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingFragmentShadingRateAttachmentInfoKHR\">VkRenderingFragmentShadingRateAttachmentInfoKHR</a>::<code>imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the currently bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <code>VK_PIPELINE_CREATE_RENDERING_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_EXT_fragment_density_map)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-imageView-06184",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingFragmentDensityMapAttachmentInfoEXT\">VkRenderingFragmentDensityMapAttachmentInfoEXT</a>::<code>imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the currently bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <code>VK_PIPELINE_CREATE_RENDERING_FRAGMENT_DENSITY_MAP_ATTACHMENT_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_AMD_mixed_attachment_samples,VK_NV_framebuffer_mixed_samples)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-colorAttachmentCount-06185",
|
|
"text": " If the currently bound pipeline was created with a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> with a <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>colorAttachmentCount</code> parameter greater than <code>0</code>, then each element of the <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pColorAttachments</code> array with a <code>imageView</code> not equal to <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> <strong class=\"purple\">must</strong> have been created with a sample count equal to the corresponding element of the <code>pColorAttachmentSamples</code> member of <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> used to create the currently bound graphics pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-pDepthAttachment-06186",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline was created with a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of the <code>depthStencilAttachmentSamples</code> member of <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the sample count used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-pStencilAttachment-06187",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline was created with a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of the <code>depthStencilAttachmentSamples</code> member of <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the sample count used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-colorAttachmentCount-06188",
|
|
"text": " If the currently bound pipeline was created without a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> with a <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>colorAttachmentCount</code> parameter greater than <code>0</code>, then each element of the <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pColorAttachments</code> array with a <code>imageView</code> not equal to <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> <strong class=\"purple\">must</strong> have been created with a sample count equal to the value of <a href=\"#VkPipelineMultisampleStateCreateInfo\">VkPipelineMultisampleStateCreateInfo</a>::<code>rasterizationSamples</code> used to create the currently bound graphics pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-pDepthAttachment-06189",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline was created without a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of <a href=\"#VkPipelineMultisampleStateCreateInfo\">VkPipelineMultisampleStateCreateInfo</a>::<code>rasterizationSamples</code> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the sample count used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-pStencilAttachment-06190",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline was created without a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of <a href=\"#VkPipelineMultisampleStateCreateInfo\">VkPipelineMultisampleStateCreateInfo</a>::<code>rasterizationSamples</code> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the sample count used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-renderPass-06198",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline <strong class=\"purple\">must</strong> have been created with a <a href=\"#VkGraphicsPipelineCreateInfo\">VkGraphicsPipelineCreateInfo</a>::<code>renderPass</code> equal to <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
}
|
|
],
|
|
"(VK_EXT_primitives_generated_query)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-primitivesGeneratedQueryWithRasterizerDiscard-06708",
|
|
"text": " If the <a href=\"#features-primitivesGeneratedQueryWithRasterizerDiscard\"><code>primitivesGeneratedQueryWithRasterizerDiscard</code></a> feature is not enabled and the <code>VK_QUERY_TYPE_PRIMITIVES_GENERATED_EXT</code> query is active, <a href=\"#primsrast-discard\">rasterization discard</a> <strong class=\"purple\">must</strong> not be enabled."
|
|
}
|
|
],
|
|
"(VK_EXT_primitives_generated_query)+(VK_EXT_transform_feedback)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-primitivesGeneratedQueryWithNonZeroStreams-06709",
|
|
"text": " If the <a href=\"#features-primitivesGeneratedQueryWithNonZeroStreams\"><code>primitivesGeneratedQueryWithNonZeroStreams</code></a> feature is not enabled and the <code>VK_QUERY_TYPE_PRIMITIVES_GENERATED_EXT</code> query is active, the bound graphics pipeline <strong class=\"purple\">must</strong> not have been created with a non-zero value in <code>VkPipelineRasterizationStateStreamCreateInfoEXT</code>::<code>rasterizationStream</code>."
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_EXT_vertex_input_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-None-04912",
|
|
"text": " If the bound graphics pipeline was created with both the <code>VK_DYNAMIC_STATE_VERTEX_INPUT_EXT</code> and <code>VK_DYNAMIC_STATE_VERTEX_INPUT_BINDING_STRIDE_EXT</code> dynamic states enabled, then <a href=\"#vkCmdSetVertexInputEXT\">vkCmdSetVertexInputEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this draw command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-pStrides-04913",
|
|
"text": " If the bound graphics pipeline was created with the <code>VK_DYNAMIC_STATE_VERTEX_INPUT_BINDING_STRIDE_EXT</code> dynamic state enabled, but not the <code>VK_DYNAMIC_STATE_VERTEX_INPUT_EXT</code> dynamic state enabled, then <a href=\"#vkCmdBindVertexBuffers2EXT\">vkCmdBindVertexBuffers2EXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this draw command, and the <code>pStrides</code> parameter of <a href=\"#vkCmdBindVertexBuffers2EXT\">vkCmdBindVertexBuffers2EXT</a> <strong class=\"purple\">must</strong> not be <code>NULL</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+!(VK_EXT_vertex_input_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-pStrides-04884",
|
|
"text": " If the bound graphics pipeline was created with the <code>VK_DYNAMIC_STATE_VERTEX_INPUT_BINDING_STRIDE_EXT</code> dynamic state enabled, then <a href=\"#vkCmdBindVertexBuffers2EXT\">vkCmdBindVertexBuffers2EXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>pStrides</code> parameter of <a href=\"#vkCmdBindVertexBuffers2EXT\">vkCmdBindVertexBuffers2EXT</a> <strong class=\"purple\">must</strong> not be <code>NULL</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_vertex_input_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-None-04914",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VERTEX_INPUT_EXT</code> dynamic state enabled, then <a href=\"#vkCmdSetVertexInputEXT\">vkCmdSetVertexInputEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this draw command"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirect-stage-06481",
|
|
"text": " The bound graphics pipeline <strong class=\"purple\">must</strong> not have been created with the <a href=\"#VkPipelineShaderStageCreateInfo\">VkPipelineShaderStageCreateInfo</a>::<code>stage</code> member of an element of <a href=\"#VkGraphicsPipelineCreateInfo\">VkGraphicsPipelineCreateInfo</a>::<code>pStages</code> set to <code>VK_SHADER_STAGE_TASK_BIT_NV</code> or <code>VK_SHADER_STAGE_MESH_BIT_NV</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkDrawIndirectCommand": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkDrawIndirectCommand-None-00500",
|
|
"text": " For a given vertex buffer binding, any attribute data fetched <strong class=\"purple\">must</strong> be entirely contained within the corresponding vertex buffer binding, as described in <a href=\"#fxvertex-input\">Vertex Input Description</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDrawIndirectCommand-firstInstance-00501",
|
|
"text": " If the <a href=\"#features-drawIndirectFirstInstance\"><code>drawIndirectFirstInstance</code></a> feature is not enabled, <code>firstInstance</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdDrawIndirectCount": {
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-magFilter-04553",
|
|
"text": " If a <a href=\"#VkSampler\">VkSampler</a> created with <code>magFilter</code> or <code>minFilter</code> equal to <code>VK_FILTER_LINEAR</code> and <code>compareEnable</code> equal to <code>VK_FALSE</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-mipmapMode-04770",
|
|
"text": " If a <a href=\"#VkSampler\">VkSampler</a> created with <code>mipmapMode</code> equal to <code>VK_SAMPLER_MIPMAP_MODE_LINEAR</code> and <code>compareEnable</code> equal to <code>VK_FALSE</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-None-02691",
|
|
"text": " If a <code>VkImageView</code> is accessed using atomic operations as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_STORAGE_IMAGE_ATOMIC_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-None-02697",
|
|
"text": " For each set <em>n</em> that is statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command, a descriptor set <strong class=\"purple\">must</strong> have been bound to <em>n</em> at the same pipeline bind point, with a <code>VkPipelineLayout</code> that is compatible for set <em>n</em>, with the <code>VkPipelineLayout</code> used to create the current <code>VkPipeline</code>, as described in <a href=\"#descriptorsets-compatibility\">Pipeline Layout Compatibility</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-None-02699",
|
|
"text": " Descriptors in each bound descriptor set, specified via <code>vkCmdBindDescriptorSets</code>, <strong class=\"purple\">must</strong> be valid if they are statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-None-02700",
|
|
"text": " A valid pipeline <strong class=\"purple\">must</strong> be bound to the pipeline bind point used by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-commandBuffer-02701",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command requires any dynamic state, that state <strong class=\"purple\">must</strong> have been set or inherited (if the <code><a href=\"#VK_NV_inherited_viewport_scissor\">VK_NV_inherited_viewport_scissor</a></code> extension is enabled) for <code>commandBuffer</code>, and done so after any previously bound pipeline with the corresponding state not specified as dynamic"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-None-02859",
|
|
"text": " There <strong class=\"purple\">must</strong> not have been any calls to dynamic state setting commands for any state not specified as dynamic in the <code>VkPipeline</code> object bound to the pipeline bind point used by this command, since that pipeline was bound"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-None-02702",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> object that uses unnormalized coordinates, that sampler <strong class=\"purple\">must</strong> not be used to sample from any <code>VkImage</code> with a <code>VkImageView</code> of the type <code>VK_IMAGE_VIEW_TYPE_3D</code>, <code>VK_IMAGE_VIEW_TYPE_CUBE</code>, <code>VK_IMAGE_VIEW_TYPE_1D_ARRAY</code>, <code>VK_IMAGE_VIEW_TYPE_2D_ARRAY</code> or <code>VK_IMAGE_VIEW_TYPE_CUBE_ARRAY</code>, in any shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-None-02703",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> object that uses unnormalized coordinates, that sampler <strong class=\"purple\">must</strong> not be used with any of the SPIR-V <code>OpImageSample*</code> or <code>OpImageSparseSample*</code> instructions with <code>ImplicitLod</code>, <code>Dref</code> or <code>Proj</code> in their name, in any shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-None-02704",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> object that uses unnormalized coordinates, that sampler <strong class=\"purple\">must</strong> not be used with any of the SPIR-V <code>OpImageSample*</code> or <code>OpImageSparseSample*</code> instructions that includes a LOD bias or any offset values, in any shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-None-04115",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> is accessed using <code>OpImageWrite</code> as a result of this command, then the <code>Type</code> of the <code>Texel</code> operand of that instruction <strong class=\"purple\">must</strong> have at least as many components as the image view’s format"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-OpImageWrite-04469",
|
|
"text": " If a <a href=\"#VkBufferView\">VkBufferView</a> is accessed using <code>OpImageWrite</code> as a result of this command, then the <code>Type</code> of the <code>Texel</code> operand of that instruction <strong class=\"purple\">must</strong> have at least as many components as the buffer view’s format"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-renderPass-02684",
|
|
"text": " The current render pass <strong class=\"purple\">must</strong> be <a href=\"#renderpass-compatibility\">compatible</a> with the <code>renderPass</code> member of the <code>VkGraphicsPipelineCreateInfo</code> structure specified when creating the <code>VkPipeline</code> bound to <code>VK_PIPELINE_BIND_POINT_GRAPHICS</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-subpass-02685",
|
|
"text": " The subpass index of the current render pass <strong class=\"purple\">must</strong> be equal to the <code>subpass</code> member of the <code>VkGraphicsPipelineCreateInfo</code> structure specified when creating the <code>VkPipeline</code> bound to <code>VK_PIPELINE_BIND_POINT_GRAPHICS</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-None-02686",
|
|
"text": " Every input attachment used by the current subpass <strong class=\"purple\">must</strong> be bound to the pipeline via a descriptor set"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-None-06537",
|
|
"text": " Memory backing image subresources used as attachments in the current render pass <strong class=\"purple\">must</strong> not be written in any way other than as an attachment by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-None-06538",
|
|
"text": " If any recorded command in the current subpass will write to an image subresource as an attachment, this command <strong class=\"purple\">must</strong> not read from the memory backing that image subresource in any other way than as an attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-None-06539",
|
|
"text": " If any recorded command in the current subpass will read from an image subresource used as an attachment in any way other than as an attachment, this command <strong class=\"purple\">must</strong> not write to that image subresource as an attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-None-06886",
|
|
"text": " If the current render pass instance uses a depth/stencil attachment with a read-only layout for the depth aspect, <a href=\"#fragops-depth-write\">depth writes</a> <strong class=\"purple\">must</strong> be disabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-None-06887",
|
|
"text": " If the current render pass instance uses a depth/stencil attachment with a read-only layout for the stencil aspect and stencil test is enabled, <a href=\"#fragops-stencil\">all stencil ops</a> <strong class=\"purple\">must</strong> be <code>VK_STENCIL_OP_KEEP</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-blendEnable-04727",
|
|
"text": " If rasterization is not disabled in the bound graphics pipeline, then for each color attachment in the subpass, if the corresponding image view’s <a href=\"#resources-image-view-format-features\">format features</a> do not contain <code>VK_FORMAT_FEATURE_COLOR_ATTACHMENT_BLEND_BIT</code>, then the <code>blendEnable</code> member of the corresponding element of the <code>pAttachments</code> member of <code>pColorBlendState</code> <strong class=\"purple\">must</strong> be <code>VK_FALSE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-rasterizationSamples-04740",
|
|
"text": " If rasterization is not disabled in the bound graphics pipeline, and neither the <code><a href=\"#VK_AMD_mixed_attachment_samples\">VK_AMD_mixed_attachment_samples</a></code> nor the <code><a href=\"#VK_NV_framebuffer_mixed_samples\">VK_NV_framebuffer_mixed_samples</a></code> extensions are enabled, then <a href=\"#VkPipelineMultisampleStateCreateInfo\">VkPipelineMultisampleStateCreateInfo</a>::<code>rasterizationSamples</code> <strong class=\"purple\">must</strong> be the same as the current subpass color and/or depth/stencil attachments"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-None-04007",
|
|
"text": " All vertex input bindings accessed via vertex input variables declared in the vertex shader entry point’s interface <strong class=\"purple\">must</strong> have either valid or <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> buffers bound"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-None-04008",
|
|
"text": " If the <a href=\"#features-nullDescriptor\"><code>nullDescriptor</code></a> feature is not enabled, all vertex input bindings accessed via vertex input variables declared in the vertex shader entry point’s interface <strong class=\"purple\">must</strong> not be <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-None-02721",
|
|
"text": " For a given vertex buffer binding, any attribute data fetched <strong class=\"purple\">must</strong> be entirely contained within the corresponding vertex buffer binding, as described in <a href=\"#fxvertex-input\">Vertex Input Description</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-buffer-02708",
|
|
"text": " If <code>buffer</code> is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-buffer-02709",
|
|
"text": " <code>buffer</code> <strong class=\"purple\">must</strong> have been created with the <code>VK_BUFFER_USAGE_INDIRECT_BUFFER_BIT</code> bit set"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-offset-02710",
|
|
"text": " <code>offset</code> <strong class=\"purple\">must</strong> be a multiple of <code>4</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-countBuffer-02714",
|
|
"text": " If <code>countBuffer</code> is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-countBuffer-02715",
|
|
"text": " <code>countBuffer</code> <strong class=\"purple\">must</strong> have been created with the <code>VK_BUFFER_USAGE_INDIRECT_BUFFER_BIT</code> bit set"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-countBufferOffset-02716",
|
|
"text": " <code>countBufferOffset</code> <strong class=\"purple\">must</strong> be a multiple of <code>4</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-countBuffer-02717",
|
|
"text": " The count stored in <code>countBuffer</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxDrawIndirectCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-countBufferOffset-04129",
|
|
"text": " <span class=\"eq\">(<code>countBufferOffset</code> + <code>sizeof</code>(uint32_t))</span> <strong class=\"purple\">must</strong> be less than or equal to the size of <code>countBuffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-stride-03110",
|
|
"text": " <code>stride</code> <strong class=\"purple\">must</strong> be a multiple of <code>4</code> and <strong class=\"purple\">must</strong> be greater than or equal to sizeof(<code>VkDrawIndirectCommand</code>)"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-maxDrawCount-03111",
|
|
"text": " If <code>maxDrawCount</code> is greater than or equal to <code>1</code>, <span class=\"eq\">(<code>stride</code> {times} (<code>maxDrawCount</code> - 1) + <code>offset</code> + sizeof(<code>VkDrawIndirectCommand</code>))</span> <strong class=\"purple\">must</strong> be less than or equal to the size of <code>buffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-countBuffer-03121",
|
|
"text": " If the count stored in <code>countBuffer</code> is equal to <code>1</code>, <span class=\"eq\">(<code>offset</code> + sizeof(<code>VkDrawIndirectCommand</code>))</span> <strong class=\"purple\">must</strong> be less than or equal to the size of <code>buffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-countBuffer-03122",
|
|
"text": " If the count stored in <code>countBuffer</code> is greater than <code>1</code>, <span class=\"eq\">(<code>stride</code> {times} (<code>drawCount</code> - 1) + <code>offset</code> + sizeof(<code>VkDrawIndirectCommand</code>))</span> <strong class=\"purple\">must</strong> be less than or equal to the size of <code>buffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-buffer-parameter",
|
|
"text": " <code>buffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBuffer\">VkBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-countBuffer-parameter",
|
|
"text": " <code>countBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBuffer\">VkBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called inside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-commonparent",
|
|
"text": " Each of <code>buffer</code>, <code>commandBuffer</code>, and <code>countBuffer</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+!(VK_VERSION_1_3,VK_KHR_format_feature_flags2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-aspectMask-06478",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> is sampled with <a href=\"#textures-depth-compare-operation\">depth comparison</a>, the image view <strong class=\"purple\">must</strong> have been created with an <code>aspectMask</code> that contains <code>VK_IMAGE_ASPECT_DEPTH_BIT</code>."
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_VERSION_1_3,VK_KHR_format_feature_flags2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-None-06479",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> is sampled with <a href=\"#textures-depth-compare-operation\">depth comparison</a>, the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_SAMPLED_IMAGE_DEPTH_COMPARISON_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-OpTypeImage-06423",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> or <a href=\"#VkBufferView\">VkBufferView</a> being written as a storage image or storage texel buffer where the image format field of the <code>OpTypeImage</code> is <code>Unknown</code> then the view’s format feature <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_STORAGE_WRITE_WITHOUT_FORMAT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-OpTypeImage-06424",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> or <a href=\"#VkBufferView\">VkBufferView</a> being read as a storage image or storage texel buffer where the image format field of the <code>OpTypeImage</code> is <code>Unknown</code> then the view’s format feature <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_STORAGE_READ_WITHOUT_FORMAT_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_IMG_filter_cubic,VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-None-02692",
|
|
"text": " If a <code>VkImageView</code> is sampled with <code>VK_FILTER_CUBIC_EXT</code> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_CUBIC_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_IMG_filter_cubic,VK_EXT_filter_cubic)+!(VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-None-02693",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> being sampled with <code>VK_FILTER_CUBIC_EXT</code> as a result of this command <strong class=\"purple\">must</strong> not have a <a href=\"#VkImageViewType\">VkImageViewType</a> of <code>VK_IMAGE_VIEW_TYPE_3D</code>, <code>VK_IMAGE_VIEW_TYPE_CUBE</code>, or <code>VK_IMAGE_VIEW_TYPE_CUBE_ARRAY</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_IMG_filter_cubic,VK_EXT_filter_cubic)+(VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-filterCubic-02694",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> being sampled with <code>VK_FILTER_CUBIC_EXT</code> as a result of this command <strong class=\"purple\">must</strong> have a <a href=\"#VkImageViewType\">VkImageViewType</a> and format that supports cubic filtering, as specified by <code>VkFilterCubicImageViewImageFormatPropertiesEXT</code>::<code>filterCubic</code> returned by <code>vkGetPhysicalDeviceImageFormatProperties2</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-filterCubicMinmax-02695",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> being sampled with <code>VK_FILTER_CUBIC_EXT</code> with a reduction mode of either <code>VK_SAMPLER_REDUCTION_MODE_MIN</code> or <code>VK_SAMPLER_REDUCTION_MODE_MAX</code> as a result of this command <strong class=\"purple\">must</strong> have a <a href=\"#VkImageViewType\">VkImageViewType</a> and format that supports cubic filtering together with minmax filtering, as specified by <code>VkFilterCubicImageViewImageFormatPropertiesEXT</code>::<code>filterCubicMinmax</code> returned by <code>vkGetPhysicalDeviceImageFormatProperties2</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_NV_corner_sampled_image)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-flags-02696",
|
|
"text": " Any <a href=\"#VkImage\">VkImage</a> created with a <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a>::<code>flags</code> containing <code>VK_IMAGE_CREATE_CORNER_SAMPLED_BIT_NV</code> sampled as a result of this command <strong class=\"purple\">must</strong> only be sampled using a <a href=\"#VkSamplerAddressMode\">VkSamplerAddressMode</a> of <code>VK_SAMPLER_ADDRESS_MODE_CLAMP_TO_EDGE</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+!(VK_VERSION_1_3,VK_KHR_maintenance4)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-None-02698",
|
|
"text": " For each push constant that is statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command, a push constant value <strong class=\"purple\">must</strong> have been set for the same pipeline bind point, with a <code>VkPipelineLayout</code> that is compatible for push constants, with the <code>VkPipelineLayout</code> used to create the current <code>VkPipeline</code>, as described in <a href=\"#descriptorsets-compatibility\">Pipeline Layout Compatibility</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_VERSION_1_3,VK_KHR_maintenance4)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-maintenance4-06425",
|
|
"text": " If the <a href=\"#features-maintenance4\"><code>maintenance4</code></a> feature is not enabled, then for each push constant that is statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command, a push constant value <strong class=\"purple\">must</strong> have been set for the same pipeline bind point, with a <code>VkPipelineLayout</code> that is compatible for push constants, with the <code>VkPipelineLayout</code> used to create the current <code>VkPipeline</code>, as described in <a href=\"#descriptorsets-compatibility\">Pipeline Layout Compatibility</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+!(VK_EXT_pipeline_robustness)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-None-02705",
|
|
"text": " If the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, and if the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a uniform buffer, it <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-None-02706",
|
|
"text": " If the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, and if the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a storage buffer, it <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_EXT_pipeline_robustness)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-uniformBuffers-06935",
|
|
"text": " If any stage of the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a uniform buffer, and that stage was created without enabling either <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_EXT</code> or <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXT</code> for <code>uniformBuffers</code>, and the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, that stage <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-storageBuffers-06936",
|
|
"text": " If any stage of the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a storage buffer, and that stage was created without enabling either <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_EXT</code> or <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXT</code> for <code>storageBuffers</code>, and the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, that stage <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-commandBuffer-02707",
|
|
"text": " If <code>commandBuffer</code> is an unprotected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, any resource accessed by the <a href=\"#VkPipeline\">VkPipeline</a> object bound to the pipeline bind point used by this command <strong class=\"purple\">must</strong> not be a protected resource"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-commandBuffer-02711",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> not be a protected command buffer"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-None-06550",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> or <code>VkImageView</code> object that enables <a href=\"#samplers-YCbCr-conversion\">sampler {YCbCr} conversion</a>, that object <strong class=\"purple\">must</strong> only be used with <code>OpImageSample*</code> or <code>OpImageSparseSample*</code> instructions"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-ConstOffset-06551",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> or <code>VkImageView</code> object that enables <a href=\"#samplers-YCbCr-conversion\">sampler {YCbCr} conversion</a>, that object <strong class=\"purple\">must</strong> not use the <code>ConstOffset</code> and <code>Offset</code> operands"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_EXT_shader_image_atomic_int64)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-SampledType-04470",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a 64-bit component width is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 64"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-SampledType-04471",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a component width less than 64-bit is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 32"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-SampledType-04472",
|
|
"text": " If a <a href=\"#VkBufferView\">VkBufferView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a 64-bit component width is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 64"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-SampledType-04473",
|
|
"text": " If a <a href=\"#VkBufferView\">VkBufferView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a component width less than 64-bit is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 32"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-sparseImageInt64Atomics-04474",
|
|
"text": " If the <a href=\"#features-sparseImageInt64Atomics\"><code>sparseImageInt64Atomics</code></a> feature is not enabled, <a href=\"#VkImage\">VkImage</a> objects created with the <code>VK_IMAGE_CREATE_SPARSE_RESIDENCY_BIT</code> flag <strong class=\"purple\">must</strong> not be accessed by atomic instructions through an <code>OpTypeImage</code> with a <code>SampledType</code> with a <code>Width</code> of 64 by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-sparseImageInt64Atomics-04475",
|
|
"text": " If the <a href=\"#features-sparseImageInt64Atomics\"><code>sparseImageInt64Atomics</code></a> feature is not enabled, <a href=\"#VkBuffer\">VkBuffer</a> objects created with the <code>VK_BUFFER_CREATE_SPARSE_RESIDENCY_BIT</code> flag <strong class=\"purple\">must</strong> not be accessed by atomic instructions through an <code>OpTypeImage</code> with a <code>SampledType</code> with a <code>Width</code> of 64 by this command"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_QCOM_image_processing)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-OpImageWeightedSampleQCOM-06971",
|
|
"text": " If <code>OpImageWeightedSampleQCOM</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_WEIGHT_SAMPLED_IMAGE_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-OpImageWeightedSampleQCOM-06972",
|
|
"text": " If <code>OpImageWeightedSampleQCOM</code> uses a <a href=\"#VkImageView\">VkImageView</a> as a sample weight image as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_WEIGHT_IMAGE_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-OpImageBoxFilterQCOM-06973",
|
|
"text": " If <code>OpImageBoxFilterQCOM</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_BOX_FILTER_SAMPLED_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-OpImageBlockMatchSSDQCOM-06974",
|
|
"text": " If <code>OpImageBlockMatchSSDQCOM</code> is used to read from an <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-OpImageBlockMatchSADQCOM-06975",
|
|
"text": " If <code>OpImageBlockMatchSADQCOM</code> is used to read from an <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-OpImageBlockMatchSADQCOM-06976",
|
|
"text": " If <code>OpImageBlockMatchSADQCOM</code> or OpImageBlockMatchSSDQCOM is used to read from a reference image as result of this command, then the specified reference coordinates <strong class=\"purple\">must</strong> not fail <a href=\"#textures-integer-coordinate-validation\">integer texel coordinate validation</a>."
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-OpImageWeightedSampleQCOM-06977",
|
|
"text": " If <code>OpImageWeightedSampleQCOM</code>, <code>OpImageBoxFilterQCOM</code>, <code>OpImageBlockMatchSSDQCOM</code>, or <code>OpImageBlockMatchSADQCOM</code> uses a <a href=\"#VkSampler\">VkSampler</a> as a result of this command, then the sampler <strong class=\"purple\">must</strong> have been created with <code>VK_SAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-OpImageWeightedSampleQCOM-06978",
|
|
"text": " If any command other than <code>OpImageWeightedSampleQCOM</code>, <code>OpImageBoxFilterQCOM</code>, <code>OpImageBlockMatchSSDQCOM</code>, or <code>OpImageBlockMatchSADQCOM</code> uses a <a href=\"#VkSampler\">VkSampler</a> as a result of this command, then the sampler <strong class=\"purple\">must</strong> not have been created with <code>VK_SAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM</code>."
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_VERSION_1_1,VK_KHR_multiview)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-maxMultiviewInstanceIndex-02688",
|
|
"text": " If the draw is recorded in a render pass instance with multiview enabled, the maximum instance index <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#VkPhysicalDeviceMultiviewProperties\">VkPhysicalDeviceMultiviewProperties</a>::<code>maxMultiviewInstanceIndex</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_EXT_sample_locations)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-sampleLocationsEnable-02689",
|
|
"text": " If the bound graphics pipeline was created with <a href=\"#VkPipelineSampleLocationsStateCreateInfoEXT\">VkPipelineSampleLocationsStateCreateInfoEXT</a>::<code>sampleLocationsEnable</code> set to <code>VK_TRUE</code> and the current subpass has a depth/stencil attachment, then that attachment <strong class=\"purple\">must</strong> have been created with the <code>VK_IMAGE_CREATE_SAMPLE_LOCATIONS_COMPATIBLE_DEPTH_BIT_EXT</code> bit set"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-None-06666",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_SAMPLE_LOCATIONS_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetSampleLocationsEXT\">vkCmdSetSampleLocationsEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-viewportCount-03417",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, but not the <code>VK_DYNAMIC_STATE_SCISSOR_WITH_COUNT</code> dynamic state enabled, then <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>viewportCount</code> parameter of <code>vkCmdSetViewportWithCount</code> <strong class=\"purple\">must</strong> match the <code>VkPipelineViewportStateCreateInfo</code>::<code>scissorCount</code> of the pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-scissorCount-03418",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_SCISSOR_WITH_COUNT</code> dynamic state enabled, but not the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, then <a href=\"#vkCmdSetScissorWithCount\">vkCmdSetScissorWithCount</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>scissorCount</code> parameter of <code>vkCmdSetScissorWithCount</code> <strong class=\"purple\">must</strong> match the <code>VkPipelineViewportStateCreateInfo</code>::<code>viewportCount</code> of the pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-viewportCount-03419",
|
|
"text": " If the bound graphics pipeline state was created with both the <code>VK_DYNAMIC_STATE_SCISSOR_WITH_COUNT</code> and <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic states enabled then both <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a> and <a href=\"#vkCmdSetScissorWithCount\">vkCmdSetScissorWithCount</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>viewportCount</code> parameter of <code>vkCmdSetViewportWithCount</code> <strong class=\"purple\">must</strong> match the <code>scissorCount</code> parameter of <code>vkCmdSetScissorWithCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-primitiveTopology-03420",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_PRIMITIVE_TOPOLOGY_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetPrimitiveTopologyEXT\">vkCmdSetPrimitiveTopologyEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>primitiveTopology</code> parameter of <code>vkCmdSetPrimitiveTopologyEXT</code> <strong class=\"purple\">must</strong> be of the same <a href=\"#drawing-primitive-topology-class\">topology class</a> as the pipeline <a href=\"#VkPipelineInputAssemblyStateCreateInfo\">VkPipelineInputAssemblyStateCreateInfo</a>::<code>topology</code> state"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_NV_clip_space_w_scaling)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-viewportCount-04137",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, but not the <code>VK_DYNAMIC_STATE_VIEWPORT_W_SCALING_NV</code> dynamic state enabled, then the bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <a href=\"#VkPipelineViewportWScalingStateCreateInfoNV\">VkPipelineViewportWScalingStateCreateInfoNV</a>::<code>viewportCount</code> greater or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-viewportCount-04138",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> and <code>VK_DYNAMIC_STATE_VIEWPORT_W_SCALING_NV</code> dynamic states enabled then the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWScalingNV\">vkCmdSetViewportWScalingNV</a> <strong class=\"purple\">must</strong> be greater than or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_NV_shading_rate_image)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-viewportCount-04139",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, but not the <code>VK_DYNAMIC_STATE_VIEWPORT_SHADING_RATE_PALETTE_NV</code> dynamic state enabled, then the bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <a href=\"#VkPipelineViewportShadingRateImageStateCreateInfoNV\">VkPipelineViewportShadingRateImageStateCreateInfoNV</a>::<code>viewportCount</code> greater or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-viewportCount-04140",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> and <code>VK_DYNAMIC_STATE_VIEWPORT_SHADING_RATE_PALETTE_NV</code> dynamic states enabled then the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportShadingRatePaletteNV\">vkCmdSetViewportShadingRatePaletteNV</a> <strong class=\"purple\">must</strong> be greater than or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_NV_viewport_swizzle)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-VkPipelineVieportCreateInfo-04141",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled and a <a href=\"#VkPipelineViewportSwizzleStateCreateInfoNV\">VkPipelineViewportSwizzleStateCreateInfoNV</a> structure chained from <code>VkPipelineVieportCreateInfo</code>, then the bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <a href=\"#VkPipelineViewportSwizzleStateCreateInfoNV\">VkPipelineViewportSwizzleStateCreateInfoNV</a>::<code>viewportCount</code> greater or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_NV_scissor_exclusive)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-VkPipelineVieportCreateInfo-04142",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled and a <a href=\"#VkPipelineViewportExclusiveScissorStateCreateInfoNV\">VkPipelineViewportExclusiveScissorStateCreateInfoNV</a> structure chained from <code>VkPipelineVieportCreateInfo</code>, then the bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <a href=\"#VkPipelineViewportExclusiveScissorStateCreateInfoNV\">VkPipelineViewportExclusiveScissorStateCreateInfoNV</a>::<code>exclusiveScissorCount</code> greater or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-None-04876",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_RASTERIZER_DISCARD_ENABLE</code> dynamic state enabled then <a href=\"#vkCmdSetRasterizerDiscardEnable\">vkCmdSetRasterizerDiscardEnable</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-None-04877",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_DEPTH_BIAS_ENABLE</code> dynamic state enabled then <a href=\"#vkCmdSetDepthBiasEnable\">vkCmdSetDepthBiasEnable</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-logicOp-04878",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_LOGIC_OP_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetLogicOpEXT\">vkCmdSetLogicOpEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command and the <code>logicOp</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkLogicOp\">VkLogicOp</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-None-04875",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_PATCH_CONTROL_POINTS_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetPatchControlPointsEXT\">vkCmdSetPatchControlPointsEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-None-04879",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_PRIMITIVE_RESTART_ENABLE_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetPrimitiveRestartEnableEXT\">vkCmdSetPrimitiveRestartEnableEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_KHR_fragment_shading_rate)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-primitiveFragmentShadingRateWithMultipleViewports-04552",
|
|
"text": " If the <a href=\"#limits-primitiveFragmentShadingRateWithMultipleViewports\"><code>primitiveFragmentShadingRateWithMultipleViewports</code></a> limit is not supported, the bound graphics pipeline was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, and any of the shader stages of the bound graphics pipeline write to the <code>PrimitiveShadingRateKHR</code> built-in, then <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>viewportCount</code> parameter of <code>vkCmdSetViewportWithCount</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-imageView-06172",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pDepthAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pDepthAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the depth attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-imageView-06173",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pStencilAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pStencilAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the stencil attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-viewMask-06178",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound graphics pipeline <strong class=\"purple\">must</strong> have been created with a <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>viewMask</code> equal to <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>viewMask</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-colorAttachmentCount-06179",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound graphics pipeline <strong class=\"purple\">must</strong> have been created with a <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>colorAttachmentCount</code> equal to <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>colorAttachmentCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-colorAttachmentCount-06180",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>colorAttachmentCount</code> greater than <code>0</code>, then each element of the <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pColorAttachments</code> array with a <code>imageView</code> not equal to <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> <strong class=\"purple\">must</strong> have been created with a <a href=\"#VkFormat\">VkFormat</a> equal to the corresponding element of <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>pColorAttachmentFormats</code> used to create the currently bound graphics pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-pDepthAttachment-06181",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>depthAttachmentFormat</code> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the <a href=\"#VkFormat\">VkFormat</a> used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-pStencilAttachment-06182",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>stencilAttachmentFormat</code> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the <a href=\"#VkFormat\">VkFormat</a> used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_VERSION_1_1,VK_KHR_maintenance2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-imageView-06174",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pDepthAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pDepthAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_STENCIL_ATTACHMENT_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the depth attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-imageView-06175",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pStencilAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pStencilAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_STENCIL_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the stencil attachment"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_VERSION_1_2,VK_KHR_separate_depth_stencil_layouts)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-imageView-06176",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pDepthAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pDepthAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the depth attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-imageView-06177",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pStencilAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pStencilAttachment</code> is <code>VK_IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the stencil attachment"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_EXT_color_write_enable)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-attachmentCount-06667",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_COLOR_WRITE_ENABLE_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetColorWriteEnableEXT\">vkCmdSetColorWriteEnableEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>attachmentCount</code> parameter of <code>vkCmdSetColorWriteEnableEXT</code> <strong class=\"purple\">must</strong> be greater than or equal to the <code>VkPipelineColorBlendStateCreateInfo</code>::<code>attachmentCount</code> of the currently bound graphics pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-attachmentCount-06815",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_COLOR_WRITE_ENABLE_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetColorWriteEnableEXT\">vkCmdSetColorWriteEnableEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>attachmentCount</code> parameter of <code>vkCmdSetColorWriteEnableEXT</code> <strong class=\"purple\">must</strong> be less than or equal to the <code>maxColorAttachments</code> member of <code>VkPhysicalDeviceLimits</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_KHR_fragment_shading_rate)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-imageView-06183",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingFragmentShadingRateAttachmentInfoKHR\">VkRenderingFragmentShadingRateAttachmentInfoKHR</a>::<code>imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the currently bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <code>VK_PIPELINE_CREATE_RENDERING_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_EXT_fragment_density_map)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-imageView-06184",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingFragmentDensityMapAttachmentInfoEXT\">VkRenderingFragmentDensityMapAttachmentInfoEXT</a>::<code>imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the currently bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <code>VK_PIPELINE_CREATE_RENDERING_FRAGMENT_DENSITY_MAP_ATTACHMENT_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_AMD_mixed_attachment_samples,VK_NV_framebuffer_mixed_samples)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-colorAttachmentCount-06185",
|
|
"text": " If the currently bound pipeline was created with a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> with a <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>colorAttachmentCount</code> parameter greater than <code>0</code>, then each element of the <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pColorAttachments</code> array with a <code>imageView</code> not equal to <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> <strong class=\"purple\">must</strong> have been created with a sample count equal to the corresponding element of the <code>pColorAttachmentSamples</code> member of <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> used to create the currently bound graphics pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-pDepthAttachment-06186",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline was created with a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of the <code>depthStencilAttachmentSamples</code> member of <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the sample count used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-pStencilAttachment-06187",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline was created with a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of the <code>depthStencilAttachmentSamples</code> member of <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the sample count used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-colorAttachmentCount-06188",
|
|
"text": " If the currently bound pipeline was created without a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> with a <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>colorAttachmentCount</code> parameter greater than <code>0</code>, then each element of the <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pColorAttachments</code> array with a <code>imageView</code> not equal to <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> <strong class=\"purple\">must</strong> have been created with a sample count equal to the value of <a href=\"#VkPipelineMultisampleStateCreateInfo\">VkPipelineMultisampleStateCreateInfo</a>::<code>rasterizationSamples</code> used to create the currently bound graphics pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-pDepthAttachment-06189",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline was created without a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of <a href=\"#VkPipelineMultisampleStateCreateInfo\">VkPipelineMultisampleStateCreateInfo</a>::<code>rasterizationSamples</code> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the sample count used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-pStencilAttachment-06190",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline was created without a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of <a href=\"#VkPipelineMultisampleStateCreateInfo\">VkPipelineMultisampleStateCreateInfo</a>::<code>rasterizationSamples</code> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the sample count used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-renderPass-06198",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline <strong class=\"purple\">must</strong> have been created with a <a href=\"#VkGraphicsPipelineCreateInfo\">VkGraphicsPipelineCreateInfo</a>::<code>renderPass</code> equal to <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_EXT_primitives_generated_query)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-primitivesGeneratedQueryWithRasterizerDiscard-06708",
|
|
"text": " If the <a href=\"#features-primitivesGeneratedQueryWithRasterizerDiscard\"><code>primitivesGeneratedQueryWithRasterizerDiscard</code></a> feature is not enabled and the <code>VK_QUERY_TYPE_PRIMITIVES_GENERATED_EXT</code> query is active, <a href=\"#primsrast-discard\">rasterization discard</a> <strong class=\"purple\">must</strong> not be enabled."
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_EXT_primitives_generated_query)+(VK_EXT_transform_feedback)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-primitivesGeneratedQueryWithNonZeroStreams-06709",
|
|
"text": " If the <a href=\"#features-primitivesGeneratedQueryWithNonZeroStreams\"><code>primitivesGeneratedQueryWithNonZeroStreams</code></a> feature is not enabled and the <code>VK_QUERY_TYPE_PRIMITIVES_GENERATED_EXT</code> query is active, the bound graphics pipeline <strong class=\"purple\">must</strong> not have been created with a non-zero value in <code>VkPipelineRasterizationStateStreamCreateInfoEXT</code>::<code>rasterizationStream</code>."
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_EXT_vertex_input_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-None-04912",
|
|
"text": " If the bound graphics pipeline was created with both the <code>VK_DYNAMIC_STATE_VERTEX_INPUT_EXT</code> and <code>VK_DYNAMIC_STATE_VERTEX_INPUT_BINDING_STRIDE_EXT</code> dynamic states enabled, then <a href=\"#vkCmdSetVertexInputEXT\">vkCmdSetVertexInputEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this draw command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-pStrides-04913",
|
|
"text": " If the bound graphics pipeline was created with the <code>VK_DYNAMIC_STATE_VERTEX_INPUT_BINDING_STRIDE_EXT</code> dynamic state enabled, but not the <code>VK_DYNAMIC_STATE_VERTEX_INPUT_EXT</code> dynamic state enabled, then <a href=\"#vkCmdBindVertexBuffers2EXT\">vkCmdBindVertexBuffers2EXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this draw command, and the <code>pStrides</code> parameter of <a href=\"#vkCmdBindVertexBuffers2EXT\">vkCmdBindVertexBuffers2EXT</a> <strong class=\"purple\">must</strong> not be <code>NULL</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+!(VK_EXT_vertex_input_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-pStrides-04884",
|
|
"text": " If the bound graphics pipeline was created with the <code>VK_DYNAMIC_STATE_VERTEX_INPUT_BINDING_STRIDE_EXT</code> dynamic state enabled, then <a href=\"#vkCmdBindVertexBuffers2EXT\">vkCmdBindVertexBuffers2EXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>pStrides</code> parameter of <a href=\"#vkCmdBindVertexBuffers2EXT\">vkCmdBindVertexBuffers2EXT</a> <strong class=\"purple\">must</strong> not be <code>NULL</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_EXT_vertex_input_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-None-04914",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VERTEX_INPUT_EXT</code> dynamic state enabled, then <a href=\"#vkCmdSetVertexInputEXT\">vkCmdSetVertexInputEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this draw command"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_NV_mesh_shader)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-stage-06481",
|
|
"text": " The bound graphics pipeline <strong class=\"purple\">must</strong> not have been created with the <a href=\"#VkPipelineShaderStageCreateInfo\">VkPipelineShaderStageCreateInfo</a>::<code>stage</code> member of an element of <a href=\"#VkGraphicsPipelineCreateInfo\">VkGraphicsPipelineCreateInfo</a>::<code>pStages</code> set to <code>VK_SHADER_STAGE_TASK_BIT_NV</code> or <code>VK_SHADER_STAGE_MESH_BIT_NV</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_VERSION_1_2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectCount-None-04445",
|
|
"text": " If <a href=\"#features-drawIndirectCount\"><code>drawIndirectCount</code></a> is not enabled this function <strong class=\"purple\">must</strong> not be used"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdDrawIndexedIndirect": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-magFilter-04553",
|
|
"text": " If a <a href=\"#VkSampler\">VkSampler</a> created with <code>magFilter</code> or <code>minFilter</code> equal to <code>VK_FILTER_LINEAR</code> and <code>compareEnable</code> equal to <code>VK_FALSE</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-mipmapMode-04770",
|
|
"text": " If a <a href=\"#VkSampler\">VkSampler</a> created with <code>mipmapMode</code> equal to <code>VK_SAMPLER_MIPMAP_MODE_LINEAR</code> and <code>compareEnable</code> equal to <code>VK_FALSE</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-None-02691",
|
|
"text": " If a <code>VkImageView</code> is accessed using atomic operations as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_STORAGE_IMAGE_ATOMIC_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-None-02697",
|
|
"text": " For each set <em>n</em> that is statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command, a descriptor set <strong class=\"purple\">must</strong> have been bound to <em>n</em> at the same pipeline bind point, with a <code>VkPipelineLayout</code> that is compatible for set <em>n</em>, with the <code>VkPipelineLayout</code> used to create the current <code>VkPipeline</code>, as described in <a href=\"#descriptorsets-compatibility\">Pipeline Layout Compatibility</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-None-02699",
|
|
"text": " Descriptors in each bound descriptor set, specified via <code>vkCmdBindDescriptorSets</code>, <strong class=\"purple\">must</strong> be valid if they are statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-None-02700",
|
|
"text": " A valid pipeline <strong class=\"purple\">must</strong> be bound to the pipeline bind point used by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-commandBuffer-02701",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command requires any dynamic state, that state <strong class=\"purple\">must</strong> have been set or inherited (if the <code><a href=\"#VK_NV_inherited_viewport_scissor\">VK_NV_inherited_viewport_scissor</a></code> extension is enabled) for <code>commandBuffer</code>, and done so after any previously bound pipeline with the corresponding state not specified as dynamic"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-None-02859",
|
|
"text": " There <strong class=\"purple\">must</strong> not have been any calls to dynamic state setting commands for any state not specified as dynamic in the <code>VkPipeline</code> object bound to the pipeline bind point used by this command, since that pipeline was bound"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-None-02702",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> object that uses unnormalized coordinates, that sampler <strong class=\"purple\">must</strong> not be used to sample from any <code>VkImage</code> with a <code>VkImageView</code> of the type <code>VK_IMAGE_VIEW_TYPE_3D</code>, <code>VK_IMAGE_VIEW_TYPE_CUBE</code>, <code>VK_IMAGE_VIEW_TYPE_1D_ARRAY</code>, <code>VK_IMAGE_VIEW_TYPE_2D_ARRAY</code> or <code>VK_IMAGE_VIEW_TYPE_CUBE_ARRAY</code>, in any shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-None-02703",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> object that uses unnormalized coordinates, that sampler <strong class=\"purple\">must</strong> not be used with any of the SPIR-V <code>OpImageSample*</code> or <code>OpImageSparseSample*</code> instructions with <code>ImplicitLod</code>, <code>Dref</code> or <code>Proj</code> in their name, in any shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-None-02704",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> object that uses unnormalized coordinates, that sampler <strong class=\"purple\">must</strong> not be used with any of the SPIR-V <code>OpImageSample*</code> or <code>OpImageSparseSample*</code> instructions that includes a LOD bias or any offset values, in any shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-None-04115",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> is accessed using <code>OpImageWrite</code> as a result of this command, then the <code>Type</code> of the <code>Texel</code> operand of that instruction <strong class=\"purple\">must</strong> have at least as many components as the image view’s format"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-OpImageWrite-04469",
|
|
"text": " If a <a href=\"#VkBufferView\">VkBufferView</a> is accessed using <code>OpImageWrite</code> as a result of this command, then the <code>Type</code> of the <code>Texel</code> operand of that instruction <strong class=\"purple\">must</strong> have at least as many components as the buffer view’s format"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-renderPass-02684",
|
|
"text": " The current render pass <strong class=\"purple\">must</strong> be <a href=\"#renderpass-compatibility\">compatible</a> with the <code>renderPass</code> member of the <code>VkGraphicsPipelineCreateInfo</code> structure specified when creating the <code>VkPipeline</code> bound to <code>VK_PIPELINE_BIND_POINT_GRAPHICS</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-subpass-02685",
|
|
"text": " The subpass index of the current render pass <strong class=\"purple\">must</strong> be equal to the <code>subpass</code> member of the <code>VkGraphicsPipelineCreateInfo</code> structure specified when creating the <code>VkPipeline</code> bound to <code>VK_PIPELINE_BIND_POINT_GRAPHICS</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-None-02686",
|
|
"text": " Every input attachment used by the current subpass <strong class=\"purple\">must</strong> be bound to the pipeline via a descriptor set"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-None-06537",
|
|
"text": " Memory backing image subresources used as attachments in the current render pass <strong class=\"purple\">must</strong> not be written in any way other than as an attachment by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-None-06538",
|
|
"text": " If any recorded command in the current subpass will write to an image subresource as an attachment, this command <strong class=\"purple\">must</strong> not read from the memory backing that image subresource in any other way than as an attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-None-06539",
|
|
"text": " If any recorded command in the current subpass will read from an image subresource used as an attachment in any way other than as an attachment, this command <strong class=\"purple\">must</strong> not write to that image subresource as an attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-None-06886",
|
|
"text": " If the current render pass instance uses a depth/stencil attachment with a read-only layout for the depth aspect, <a href=\"#fragops-depth-write\">depth writes</a> <strong class=\"purple\">must</strong> be disabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-None-06887",
|
|
"text": " If the current render pass instance uses a depth/stencil attachment with a read-only layout for the stencil aspect and stencil test is enabled, <a href=\"#fragops-stencil\">all stencil ops</a> <strong class=\"purple\">must</strong> be <code>VK_STENCIL_OP_KEEP</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-blendEnable-04727",
|
|
"text": " If rasterization is not disabled in the bound graphics pipeline, then for each color attachment in the subpass, if the corresponding image view’s <a href=\"#resources-image-view-format-features\">format features</a> do not contain <code>VK_FORMAT_FEATURE_COLOR_ATTACHMENT_BLEND_BIT</code>, then the <code>blendEnable</code> member of the corresponding element of the <code>pAttachments</code> member of <code>pColorBlendState</code> <strong class=\"purple\">must</strong> be <code>VK_FALSE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-rasterizationSamples-04740",
|
|
"text": " If rasterization is not disabled in the bound graphics pipeline, and neither the <code><a href=\"#VK_AMD_mixed_attachment_samples\">VK_AMD_mixed_attachment_samples</a></code> nor the <code><a href=\"#VK_NV_framebuffer_mixed_samples\">VK_NV_framebuffer_mixed_samples</a></code> extensions are enabled, then <a href=\"#VkPipelineMultisampleStateCreateInfo\">VkPipelineMultisampleStateCreateInfo</a>::<code>rasterizationSamples</code> <strong class=\"purple\">must</strong> be the same as the current subpass color and/or depth/stencil attachments"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-None-04007",
|
|
"text": " All vertex input bindings accessed via vertex input variables declared in the vertex shader entry point’s interface <strong class=\"purple\">must</strong> have either valid or <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> buffers bound"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-None-04008",
|
|
"text": " If the <a href=\"#features-nullDescriptor\"><code>nullDescriptor</code></a> feature is not enabled, all vertex input bindings accessed via vertex input variables declared in the vertex shader entry point’s interface <strong class=\"purple\">must</strong> not be <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-None-02721",
|
|
"text": " For a given vertex buffer binding, any attribute data fetched <strong class=\"purple\">must</strong> be entirely contained within the corresponding vertex buffer binding, as described in <a href=\"#fxvertex-input\">Vertex Input Description</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-buffer-02708",
|
|
"text": " If <code>buffer</code> is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-buffer-02709",
|
|
"text": " <code>buffer</code> <strong class=\"purple\">must</strong> have been created with the <code>VK_BUFFER_USAGE_INDIRECT_BUFFER_BIT</code> bit set"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-offset-02710",
|
|
"text": " <code>offset</code> <strong class=\"purple\">must</strong> be a multiple of <code>4</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-drawCount-02718",
|
|
"text": " If the <a href=\"#features-multiDrawIndirect\"><code>multiDrawIndirect</code></a> feature is not enabled, <code>drawCount</code> <strong class=\"purple\">must</strong> be <code>0</code> or <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-drawCount-02719",
|
|
"text": " <code>drawCount</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxDrawIndirectCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-drawCount-00528",
|
|
"text": " If <code>drawCount</code> is greater than <code>1</code>, <code>stride</code> <strong class=\"purple\">must</strong> be a multiple of <code>4</code> and <strong class=\"purple\">must</strong> be greater than or equal to <code>sizeof</code>(<code>VkDrawIndexedIndirectCommand</code>)"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-firstInstance-00530",
|
|
"text": " If the <a href=\"#features-drawIndirectFirstInstance\"><code>drawIndirectFirstInstance</code></a> feature is not enabled, all the <code>firstInstance</code> members of the <code>VkDrawIndexedIndirectCommand</code> structures accessed by this command <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-drawCount-00539",
|
|
"text": " If <code>drawCount</code> is equal to <code>1</code>, <span class=\"eq\">(<code>offset</code> + <code>sizeof</code>(<code>VkDrawIndexedIndirectCommand</code>))</span> <strong class=\"purple\">must</strong> be less than or equal to the size of <code>buffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-drawCount-00540",
|
|
"text": " If <code>drawCount</code> is greater than <code>1</code>, <span class=\"eq\">(<code>stride</code> {times} (<code>drawCount</code> - 1) + <code>offset</code> + <code>sizeof</code>(<code>VkDrawIndexedIndirectCommand</code>))</span> <strong class=\"purple\">must</strong> be less than or equal to the size of <code>buffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-buffer-parameter",
|
|
"text": " <code>buffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBuffer\">VkBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called inside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-commonparent",
|
|
"text": " Both of <code>buffer</code>, and <code>commandBuffer</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"!(VK_VERSION_1_3,VK_KHR_format_feature_flags2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-aspectMask-06478",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> is sampled with <a href=\"#textures-depth-compare-operation\">depth comparison</a>, the image view <strong class=\"purple\">must</strong> have been created with an <code>aspectMask</code> that contains <code>VK_IMAGE_ASPECT_DEPTH_BIT</code>."
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_format_feature_flags2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-None-06479",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> is sampled with <a href=\"#textures-depth-compare-operation\">depth comparison</a>, the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_SAMPLED_IMAGE_DEPTH_COMPARISON_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-OpTypeImage-06423",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> or <a href=\"#VkBufferView\">VkBufferView</a> being written as a storage image or storage texel buffer where the image format field of the <code>OpTypeImage</code> is <code>Unknown</code> then the view’s format feature <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_STORAGE_WRITE_WITHOUT_FORMAT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-OpTypeImage-06424",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> or <a href=\"#VkBufferView\">VkBufferView</a> being read as a storage image or storage texel buffer where the image format field of the <code>OpTypeImage</code> is <code>Unknown</code> then the view’s format feature <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_STORAGE_READ_WITHOUT_FORMAT_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_IMG_filter_cubic,VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-None-02692",
|
|
"text": " If a <code>VkImageView</code> is sampled with <code>VK_FILTER_CUBIC_EXT</code> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_CUBIC_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_IMG_filter_cubic,VK_EXT_filter_cubic)+!(VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-None-02693",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> being sampled with <code>VK_FILTER_CUBIC_EXT</code> as a result of this command <strong class=\"purple\">must</strong> not have a <a href=\"#VkImageViewType\">VkImageViewType</a> of <code>VK_IMAGE_VIEW_TYPE_3D</code>, <code>VK_IMAGE_VIEW_TYPE_CUBE</code>, or <code>VK_IMAGE_VIEW_TYPE_CUBE_ARRAY</code>"
|
|
}
|
|
],
|
|
"(VK_IMG_filter_cubic,VK_EXT_filter_cubic)+(VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-filterCubic-02694",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> being sampled with <code>VK_FILTER_CUBIC_EXT</code> as a result of this command <strong class=\"purple\">must</strong> have a <a href=\"#VkImageViewType\">VkImageViewType</a> and format that supports cubic filtering, as specified by <code>VkFilterCubicImageViewImageFormatPropertiesEXT</code>::<code>filterCubic</code> returned by <code>vkGetPhysicalDeviceImageFormatProperties2</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-filterCubicMinmax-02695",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> being sampled with <code>VK_FILTER_CUBIC_EXT</code> with a reduction mode of either <code>VK_SAMPLER_REDUCTION_MODE_MIN</code> or <code>VK_SAMPLER_REDUCTION_MODE_MAX</code> as a result of this command <strong class=\"purple\">must</strong> have a <a href=\"#VkImageViewType\">VkImageViewType</a> and format that supports cubic filtering together with minmax filtering, as specified by <code>VkFilterCubicImageViewImageFormatPropertiesEXT</code>::<code>filterCubicMinmax</code> returned by <code>vkGetPhysicalDeviceImageFormatProperties2</code>"
|
|
}
|
|
],
|
|
"(VK_NV_corner_sampled_image)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-flags-02696",
|
|
"text": " Any <a href=\"#VkImage\">VkImage</a> created with a <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a>::<code>flags</code> containing <code>VK_IMAGE_CREATE_CORNER_SAMPLED_BIT_NV</code> sampled as a result of this command <strong class=\"purple\">must</strong> only be sampled using a <a href=\"#VkSamplerAddressMode\">VkSamplerAddressMode</a> of <code>VK_SAMPLER_ADDRESS_MODE_CLAMP_TO_EDGE</code>"
|
|
}
|
|
],
|
|
"!(VK_VERSION_1_3,VK_KHR_maintenance4)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-None-02698",
|
|
"text": " For each push constant that is statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command, a push constant value <strong class=\"purple\">must</strong> have been set for the same pipeline bind point, with a <code>VkPipelineLayout</code> that is compatible for push constants, with the <code>VkPipelineLayout</code> used to create the current <code>VkPipeline</code>, as described in <a href=\"#descriptorsets-compatibility\">Pipeline Layout Compatibility</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_maintenance4)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-maintenance4-06425",
|
|
"text": " If the <a href=\"#features-maintenance4\"><code>maintenance4</code></a> feature is not enabled, then for each push constant that is statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command, a push constant value <strong class=\"purple\">must</strong> have been set for the same pipeline bind point, with a <code>VkPipelineLayout</code> that is compatible for push constants, with the <code>VkPipelineLayout</code> used to create the current <code>VkPipeline</code>, as described in <a href=\"#descriptorsets-compatibility\">Pipeline Layout Compatibility</a>"
|
|
}
|
|
],
|
|
"!(VK_EXT_pipeline_robustness)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-None-02705",
|
|
"text": " If the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, and if the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a uniform buffer, it <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-None-02706",
|
|
"text": " If the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, and if the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a storage buffer, it <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
}
|
|
],
|
|
"(VK_EXT_pipeline_robustness)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-uniformBuffers-06935",
|
|
"text": " If any stage of the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a uniform buffer, and that stage was created without enabling either <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_EXT</code> or <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXT</code> for <code>uniformBuffers</code>, and the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, that stage <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-storageBuffers-06936",
|
|
"text": " If any stage of the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a storage buffer, and that stage was created without enabling either <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_EXT</code> or <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXT</code> for <code>storageBuffers</code>, and the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, that stage <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-commandBuffer-02707",
|
|
"text": " If <code>commandBuffer</code> is an unprotected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, any resource accessed by the <a href=\"#VkPipeline\">VkPipeline</a> object bound to the pipeline bind point used by this command <strong class=\"purple\">must</strong> not be a protected resource"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-commandBuffer-02711",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> not be a protected command buffer"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-None-06550",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> or <code>VkImageView</code> object that enables <a href=\"#samplers-YCbCr-conversion\">sampler {YCbCr} conversion</a>, that object <strong class=\"purple\">must</strong> only be used with <code>OpImageSample*</code> or <code>OpImageSparseSample*</code> instructions"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-ConstOffset-06551",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> or <code>VkImageView</code> object that enables <a href=\"#samplers-YCbCr-conversion\">sampler {YCbCr} conversion</a>, that object <strong class=\"purple\">must</strong> not use the <code>ConstOffset</code> and <code>Offset</code> operands"
|
|
}
|
|
],
|
|
"(VK_EXT_shader_image_atomic_int64)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-SampledType-04470",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a 64-bit component width is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 64"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-SampledType-04471",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a component width less than 64-bit is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 32"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-SampledType-04472",
|
|
"text": " If a <a href=\"#VkBufferView\">VkBufferView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a 64-bit component width is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 64"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-SampledType-04473",
|
|
"text": " If a <a href=\"#VkBufferView\">VkBufferView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a component width less than 64-bit is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 32"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-sparseImageInt64Atomics-04474",
|
|
"text": " If the <a href=\"#features-sparseImageInt64Atomics\"><code>sparseImageInt64Atomics</code></a> feature is not enabled, <a href=\"#VkImage\">VkImage</a> objects created with the <code>VK_IMAGE_CREATE_SPARSE_RESIDENCY_BIT</code> flag <strong class=\"purple\">must</strong> not be accessed by atomic instructions through an <code>OpTypeImage</code> with a <code>SampledType</code> with a <code>Width</code> of 64 by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-sparseImageInt64Atomics-04475",
|
|
"text": " If the <a href=\"#features-sparseImageInt64Atomics\"><code>sparseImageInt64Atomics</code></a> feature is not enabled, <a href=\"#VkBuffer\">VkBuffer</a> objects created with the <code>VK_BUFFER_CREATE_SPARSE_RESIDENCY_BIT</code> flag <strong class=\"purple\">must</strong> not be accessed by atomic instructions through an <code>OpTypeImage</code> with a <code>SampledType</code> with a <code>Width</code> of 64 by this command"
|
|
}
|
|
],
|
|
"(VK_QCOM_image_processing)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-OpImageWeightedSampleQCOM-06971",
|
|
"text": " If <code>OpImageWeightedSampleQCOM</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_WEIGHT_SAMPLED_IMAGE_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-OpImageWeightedSampleQCOM-06972",
|
|
"text": " If <code>OpImageWeightedSampleQCOM</code> uses a <a href=\"#VkImageView\">VkImageView</a> as a sample weight image as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_WEIGHT_IMAGE_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-OpImageBoxFilterQCOM-06973",
|
|
"text": " If <code>OpImageBoxFilterQCOM</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_BOX_FILTER_SAMPLED_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-OpImageBlockMatchSSDQCOM-06974",
|
|
"text": " If <code>OpImageBlockMatchSSDQCOM</code> is used to read from an <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-OpImageBlockMatchSADQCOM-06975",
|
|
"text": " If <code>OpImageBlockMatchSADQCOM</code> is used to read from an <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-OpImageBlockMatchSADQCOM-06976",
|
|
"text": " If <code>OpImageBlockMatchSADQCOM</code> or OpImageBlockMatchSSDQCOM is used to read from a reference image as result of this command, then the specified reference coordinates <strong class=\"purple\">must</strong> not fail <a href=\"#textures-integer-coordinate-validation\">integer texel coordinate validation</a>."
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-OpImageWeightedSampleQCOM-06977",
|
|
"text": " If <code>OpImageWeightedSampleQCOM</code>, <code>OpImageBoxFilterQCOM</code>, <code>OpImageBlockMatchSSDQCOM</code>, or <code>OpImageBlockMatchSADQCOM</code> uses a <a href=\"#VkSampler\">VkSampler</a> as a result of this command, then the sampler <strong class=\"purple\">must</strong> have been created with <code>VK_SAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-OpImageWeightedSampleQCOM-06978",
|
|
"text": " If any command other than <code>OpImageWeightedSampleQCOM</code>, <code>OpImageBoxFilterQCOM</code>, <code>OpImageBlockMatchSSDQCOM</code>, or <code>OpImageBlockMatchSADQCOM</code> uses a <a href=\"#VkSampler\">VkSampler</a> as a result of this command, then the sampler <strong class=\"purple\">must</strong> not have been created with <code>VK_SAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM</code>."
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_multiview)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-maxMultiviewInstanceIndex-02688",
|
|
"text": " If the draw is recorded in a render pass instance with multiview enabled, the maximum instance index <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#VkPhysicalDeviceMultiviewProperties\">VkPhysicalDeviceMultiviewProperties</a>::<code>maxMultiviewInstanceIndex</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_sample_locations)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-sampleLocationsEnable-02689",
|
|
"text": " If the bound graphics pipeline was created with <a href=\"#VkPipelineSampleLocationsStateCreateInfoEXT\">VkPipelineSampleLocationsStateCreateInfoEXT</a>::<code>sampleLocationsEnable</code> set to <code>VK_TRUE</code> and the current subpass has a depth/stencil attachment, then that attachment <strong class=\"purple\">must</strong> have been created with the <code>VK_IMAGE_CREATE_SAMPLE_LOCATIONS_COMPATIBLE_DEPTH_BIT_EXT</code> bit set"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-None-06666",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_SAMPLE_LOCATIONS_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetSampleLocationsEXT\">vkCmdSetSampleLocationsEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-viewportCount-03417",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, but not the <code>VK_DYNAMIC_STATE_SCISSOR_WITH_COUNT</code> dynamic state enabled, then <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>viewportCount</code> parameter of <code>vkCmdSetViewportWithCount</code> <strong class=\"purple\">must</strong> match the <code>VkPipelineViewportStateCreateInfo</code>::<code>scissorCount</code> of the pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-scissorCount-03418",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_SCISSOR_WITH_COUNT</code> dynamic state enabled, but not the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, then <a href=\"#vkCmdSetScissorWithCount\">vkCmdSetScissorWithCount</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>scissorCount</code> parameter of <code>vkCmdSetScissorWithCount</code> <strong class=\"purple\">must</strong> match the <code>VkPipelineViewportStateCreateInfo</code>::<code>viewportCount</code> of the pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-viewportCount-03419",
|
|
"text": " If the bound graphics pipeline state was created with both the <code>VK_DYNAMIC_STATE_SCISSOR_WITH_COUNT</code> and <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic states enabled then both <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a> and <a href=\"#vkCmdSetScissorWithCount\">vkCmdSetScissorWithCount</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>viewportCount</code> parameter of <code>vkCmdSetViewportWithCount</code> <strong class=\"purple\">must</strong> match the <code>scissorCount</code> parameter of <code>vkCmdSetScissorWithCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-primitiveTopology-03420",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_PRIMITIVE_TOPOLOGY_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetPrimitiveTopologyEXT\">vkCmdSetPrimitiveTopologyEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>primitiveTopology</code> parameter of <code>vkCmdSetPrimitiveTopologyEXT</code> <strong class=\"purple\">must</strong> be of the same <a href=\"#drawing-primitive-topology-class\">topology class</a> as the pipeline <a href=\"#VkPipelineInputAssemblyStateCreateInfo\">VkPipelineInputAssemblyStateCreateInfo</a>::<code>topology</code> state"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_NV_clip_space_w_scaling)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-viewportCount-04137",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, but not the <code>VK_DYNAMIC_STATE_VIEWPORT_W_SCALING_NV</code> dynamic state enabled, then the bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <a href=\"#VkPipelineViewportWScalingStateCreateInfoNV\">VkPipelineViewportWScalingStateCreateInfoNV</a>::<code>viewportCount</code> greater or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-viewportCount-04138",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> and <code>VK_DYNAMIC_STATE_VIEWPORT_W_SCALING_NV</code> dynamic states enabled then the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWScalingNV\">vkCmdSetViewportWScalingNV</a> <strong class=\"purple\">must</strong> be greater than or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_NV_shading_rate_image)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-viewportCount-04139",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, but not the <code>VK_DYNAMIC_STATE_VIEWPORT_SHADING_RATE_PALETTE_NV</code> dynamic state enabled, then the bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <a href=\"#VkPipelineViewportShadingRateImageStateCreateInfoNV\">VkPipelineViewportShadingRateImageStateCreateInfoNV</a>::<code>viewportCount</code> greater or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-viewportCount-04140",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> and <code>VK_DYNAMIC_STATE_VIEWPORT_SHADING_RATE_PALETTE_NV</code> dynamic states enabled then the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportShadingRatePaletteNV\">vkCmdSetViewportShadingRatePaletteNV</a> <strong class=\"purple\">must</strong> be greater than or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_NV_viewport_swizzle)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-VkPipelineVieportCreateInfo-04141",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled and a <a href=\"#VkPipelineViewportSwizzleStateCreateInfoNV\">VkPipelineViewportSwizzleStateCreateInfoNV</a> structure chained from <code>VkPipelineVieportCreateInfo</code>, then the bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <a href=\"#VkPipelineViewportSwizzleStateCreateInfoNV\">VkPipelineViewportSwizzleStateCreateInfoNV</a>::<code>viewportCount</code> greater or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_NV_scissor_exclusive)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-VkPipelineVieportCreateInfo-04142",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled and a <a href=\"#VkPipelineViewportExclusiveScissorStateCreateInfoNV\">VkPipelineViewportExclusiveScissorStateCreateInfoNV</a> structure chained from <code>VkPipelineVieportCreateInfo</code>, then the bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <a href=\"#VkPipelineViewportExclusiveScissorStateCreateInfoNV\">VkPipelineViewportExclusiveScissorStateCreateInfoNV</a>::<code>exclusiveScissorCount</code> greater or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-None-04876",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_RASTERIZER_DISCARD_ENABLE</code> dynamic state enabled then <a href=\"#vkCmdSetRasterizerDiscardEnable\">vkCmdSetRasterizerDiscardEnable</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-None-04877",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_DEPTH_BIAS_ENABLE</code> dynamic state enabled then <a href=\"#vkCmdSetDepthBiasEnable\">vkCmdSetDepthBiasEnable</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-logicOp-04878",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_LOGIC_OP_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetLogicOpEXT\">vkCmdSetLogicOpEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command and the <code>logicOp</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkLogicOp\">VkLogicOp</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-None-04875",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_PATCH_CONTROL_POINTS_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetPatchControlPointsEXT\">vkCmdSetPatchControlPointsEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-None-04879",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_PRIMITIVE_RESTART_ENABLE_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetPrimitiveRestartEnableEXT\">vkCmdSetPrimitiveRestartEnableEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command"
|
|
}
|
|
],
|
|
"(VK_KHR_fragment_shading_rate)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-primitiveFragmentShadingRateWithMultipleViewports-04552",
|
|
"text": " If the <a href=\"#limits-primitiveFragmentShadingRateWithMultipleViewports\"><code>primitiveFragmentShadingRateWithMultipleViewports</code></a> limit is not supported, the bound graphics pipeline was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, and any of the shader stages of the bound graphics pipeline write to the <code>PrimitiveShadingRateKHR</code> built-in, then <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>viewportCount</code> parameter of <code>vkCmdSetViewportWithCount</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-imageView-06172",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pDepthAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pDepthAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the depth attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-imageView-06173",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pStencilAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pStencilAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the stencil attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-viewMask-06178",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound graphics pipeline <strong class=\"purple\">must</strong> have been created with a <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>viewMask</code> equal to <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>viewMask</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-colorAttachmentCount-06179",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound graphics pipeline <strong class=\"purple\">must</strong> have been created with a <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>colorAttachmentCount</code> equal to <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>colorAttachmentCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-colorAttachmentCount-06180",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>colorAttachmentCount</code> greater than <code>0</code>, then each element of the <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pColorAttachments</code> array with a <code>imageView</code> not equal to <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> <strong class=\"purple\">must</strong> have been created with a <a href=\"#VkFormat\">VkFormat</a> equal to the corresponding element of <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>pColorAttachmentFormats</code> used to create the currently bound graphics pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-pDepthAttachment-06181",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>depthAttachmentFormat</code> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the <a href=\"#VkFormat\">VkFormat</a> used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-pStencilAttachment-06182",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>stencilAttachmentFormat</code> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the <a href=\"#VkFormat\">VkFormat</a> used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_VERSION_1_1,VK_KHR_maintenance2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-imageView-06174",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pDepthAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pDepthAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_STENCIL_ATTACHMENT_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the depth attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-imageView-06175",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pStencilAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pStencilAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_STENCIL_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the stencil attachment"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_VERSION_1_2,VK_KHR_separate_depth_stencil_layouts)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-imageView-06176",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pDepthAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pDepthAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the depth attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-imageView-06177",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pStencilAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pStencilAttachment</code> is <code>VK_IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the stencil attachment"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_EXT_color_write_enable)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-attachmentCount-06667",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_COLOR_WRITE_ENABLE_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetColorWriteEnableEXT\">vkCmdSetColorWriteEnableEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>attachmentCount</code> parameter of <code>vkCmdSetColorWriteEnableEXT</code> <strong class=\"purple\">must</strong> be greater than or equal to the <code>VkPipelineColorBlendStateCreateInfo</code>::<code>attachmentCount</code> of the currently bound graphics pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-attachmentCount-06815",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_COLOR_WRITE_ENABLE_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetColorWriteEnableEXT\">vkCmdSetColorWriteEnableEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>attachmentCount</code> parameter of <code>vkCmdSetColorWriteEnableEXT</code> <strong class=\"purple\">must</strong> be less than or equal to the <code>maxColorAttachments</code> member of <code>VkPhysicalDeviceLimits</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_KHR_fragment_shading_rate)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-imageView-06183",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingFragmentShadingRateAttachmentInfoKHR\">VkRenderingFragmentShadingRateAttachmentInfoKHR</a>::<code>imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the currently bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <code>VK_PIPELINE_CREATE_RENDERING_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_EXT_fragment_density_map)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-imageView-06184",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingFragmentDensityMapAttachmentInfoEXT\">VkRenderingFragmentDensityMapAttachmentInfoEXT</a>::<code>imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the currently bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <code>VK_PIPELINE_CREATE_RENDERING_FRAGMENT_DENSITY_MAP_ATTACHMENT_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_AMD_mixed_attachment_samples,VK_NV_framebuffer_mixed_samples)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-colorAttachmentCount-06185",
|
|
"text": " If the currently bound pipeline was created with a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> with a <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>colorAttachmentCount</code> parameter greater than <code>0</code>, then each element of the <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pColorAttachments</code> array with a <code>imageView</code> not equal to <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> <strong class=\"purple\">must</strong> have been created with a sample count equal to the corresponding element of the <code>pColorAttachmentSamples</code> member of <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> used to create the currently bound graphics pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-pDepthAttachment-06186",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline was created with a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of the <code>depthStencilAttachmentSamples</code> member of <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the sample count used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-pStencilAttachment-06187",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline was created with a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of the <code>depthStencilAttachmentSamples</code> member of <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the sample count used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-colorAttachmentCount-06188",
|
|
"text": " If the currently bound pipeline was created without a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> with a <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>colorAttachmentCount</code> parameter greater than <code>0</code>, then each element of the <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pColorAttachments</code> array with a <code>imageView</code> not equal to <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> <strong class=\"purple\">must</strong> have been created with a sample count equal to the value of <a href=\"#VkPipelineMultisampleStateCreateInfo\">VkPipelineMultisampleStateCreateInfo</a>::<code>rasterizationSamples</code> used to create the currently bound graphics pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-pDepthAttachment-06189",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline was created without a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of <a href=\"#VkPipelineMultisampleStateCreateInfo\">VkPipelineMultisampleStateCreateInfo</a>::<code>rasterizationSamples</code> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the sample count used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-pStencilAttachment-06190",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline was created without a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of <a href=\"#VkPipelineMultisampleStateCreateInfo\">VkPipelineMultisampleStateCreateInfo</a>::<code>rasterizationSamples</code> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the sample count used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-renderPass-06198",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline <strong class=\"purple\">must</strong> have been created with a <a href=\"#VkGraphicsPipelineCreateInfo\">VkGraphicsPipelineCreateInfo</a>::<code>renderPass</code> equal to <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
}
|
|
],
|
|
"(VK_EXT_primitives_generated_query)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-primitivesGeneratedQueryWithRasterizerDiscard-06708",
|
|
"text": " If the <a href=\"#features-primitivesGeneratedQueryWithRasterizerDiscard\"><code>primitivesGeneratedQueryWithRasterizerDiscard</code></a> feature is not enabled and the <code>VK_QUERY_TYPE_PRIMITIVES_GENERATED_EXT</code> query is active, <a href=\"#primsrast-discard\">rasterization discard</a> <strong class=\"purple\">must</strong> not be enabled."
|
|
}
|
|
],
|
|
"(VK_EXT_primitives_generated_query)+(VK_EXT_transform_feedback)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-primitivesGeneratedQueryWithNonZeroStreams-06709",
|
|
"text": " If the <a href=\"#features-primitivesGeneratedQueryWithNonZeroStreams\"><code>primitivesGeneratedQueryWithNonZeroStreams</code></a> feature is not enabled and the <code>VK_QUERY_TYPE_PRIMITIVES_GENERATED_EXT</code> query is active, the bound graphics pipeline <strong class=\"purple\">must</strong> not have been created with a non-zero value in <code>VkPipelineRasterizationStateStreamCreateInfoEXT</code>::<code>rasterizationStream</code>."
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_EXT_vertex_input_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-None-04912",
|
|
"text": " If the bound graphics pipeline was created with both the <code>VK_DYNAMIC_STATE_VERTEX_INPUT_EXT</code> and <code>VK_DYNAMIC_STATE_VERTEX_INPUT_BINDING_STRIDE_EXT</code> dynamic states enabled, then <a href=\"#vkCmdSetVertexInputEXT\">vkCmdSetVertexInputEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this draw command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-pStrides-04913",
|
|
"text": " If the bound graphics pipeline was created with the <code>VK_DYNAMIC_STATE_VERTEX_INPUT_BINDING_STRIDE_EXT</code> dynamic state enabled, but not the <code>VK_DYNAMIC_STATE_VERTEX_INPUT_EXT</code> dynamic state enabled, then <a href=\"#vkCmdBindVertexBuffers2EXT\">vkCmdBindVertexBuffers2EXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this draw command, and the <code>pStrides</code> parameter of <a href=\"#vkCmdBindVertexBuffers2EXT\">vkCmdBindVertexBuffers2EXT</a> <strong class=\"purple\">must</strong> not be <code>NULL</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+!(VK_EXT_vertex_input_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-pStrides-04884",
|
|
"text": " If the bound graphics pipeline was created with the <code>VK_DYNAMIC_STATE_VERTEX_INPUT_BINDING_STRIDE_EXT</code> dynamic state enabled, then <a href=\"#vkCmdBindVertexBuffers2EXT\">vkCmdBindVertexBuffers2EXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>pStrides</code> parameter of <a href=\"#vkCmdBindVertexBuffers2EXT\">vkCmdBindVertexBuffers2EXT</a> <strong class=\"purple\">must</strong> not be <code>NULL</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_vertex_input_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-None-04914",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VERTEX_INPUT_EXT</code> dynamic state enabled, then <a href=\"#vkCmdSetVertexInputEXT\">vkCmdSetVertexInputEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this draw command"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirect-stage-06481",
|
|
"text": " The bound graphics pipeline <strong class=\"purple\">must</strong> not have been created with the <a href=\"#VkPipelineShaderStageCreateInfo\">VkPipelineShaderStageCreateInfo</a>::<code>stage</code> member of an element of <a href=\"#VkGraphicsPipelineCreateInfo\">VkGraphicsPipelineCreateInfo</a>::<code>pStages</code> set to <code>VK_SHADER_STAGE_TASK_BIT_NV</code> or <code>VK_SHADER_STAGE_MESH_BIT_NV</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkDrawIndexedIndirectCommand": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkDrawIndexedIndirectCommand-None-00552",
|
|
"text": " For a given vertex buffer binding, any attribute data fetched <strong class=\"purple\">must</strong> be entirely contained within the corresponding vertex buffer binding, as described in <a href=\"#fxvertex-input\">Vertex Input Description</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDrawIndexedIndirectCommand-indexSize-00553",
|
|
"text": " <span class=\"eq\">(<code>indexSize</code> {times} (<code>firstIndex</code> + <code>indexCount</code>) + <code>offset</code>)</span> <strong class=\"purple\">must</strong> be less than or equal to the size of the bound index buffer, with <code>indexSize</code> being based on the type specified by <code>indexType</code>, where the index buffer, <code>indexType</code>, and <code>offset</code> are specified via <code>vkCmdBindIndexBuffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDrawIndexedIndirectCommand-firstInstance-00554",
|
|
"text": " If the <a href=\"#features-drawIndirectFirstInstance\"><code>drawIndirectFirstInstance</code></a> feature is not enabled, <code>firstInstance</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdDrawIndexedIndirectCount": {
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-magFilter-04553",
|
|
"text": " If a <a href=\"#VkSampler\">VkSampler</a> created with <code>magFilter</code> or <code>minFilter</code> equal to <code>VK_FILTER_LINEAR</code> and <code>compareEnable</code> equal to <code>VK_FALSE</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-mipmapMode-04770",
|
|
"text": " If a <a href=\"#VkSampler\">VkSampler</a> created with <code>mipmapMode</code> equal to <code>VK_SAMPLER_MIPMAP_MODE_LINEAR</code> and <code>compareEnable</code> equal to <code>VK_FALSE</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-None-02691",
|
|
"text": " If a <code>VkImageView</code> is accessed using atomic operations as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_STORAGE_IMAGE_ATOMIC_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-None-02697",
|
|
"text": " For each set <em>n</em> that is statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command, a descriptor set <strong class=\"purple\">must</strong> have been bound to <em>n</em> at the same pipeline bind point, with a <code>VkPipelineLayout</code> that is compatible for set <em>n</em>, with the <code>VkPipelineLayout</code> used to create the current <code>VkPipeline</code>, as described in <a href=\"#descriptorsets-compatibility\">Pipeline Layout Compatibility</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-None-02699",
|
|
"text": " Descriptors in each bound descriptor set, specified via <code>vkCmdBindDescriptorSets</code>, <strong class=\"purple\">must</strong> be valid if they are statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-None-02700",
|
|
"text": " A valid pipeline <strong class=\"purple\">must</strong> be bound to the pipeline bind point used by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-commandBuffer-02701",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command requires any dynamic state, that state <strong class=\"purple\">must</strong> have been set or inherited (if the <code><a href=\"#VK_NV_inherited_viewport_scissor\">VK_NV_inherited_viewport_scissor</a></code> extension is enabled) for <code>commandBuffer</code>, and done so after any previously bound pipeline with the corresponding state not specified as dynamic"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-None-02859",
|
|
"text": " There <strong class=\"purple\">must</strong> not have been any calls to dynamic state setting commands for any state not specified as dynamic in the <code>VkPipeline</code> object bound to the pipeline bind point used by this command, since that pipeline was bound"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-None-02702",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> object that uses unnormalized coordinates, that sampler <strong class=\"purple\">must</strong> not be used to sample from any <code>VkImage</code> with a <code>VkImageView</code> of the type <code>VK_IMAGE_VIEW_TYPE_3D</code>, <code>VK_IMAGE_VIEW_TYPE_CUBE</code>, <code>VK_IMAGE_VIEW_TYPE_1D_ARRAY</code>, <code>VK_IMAGE_VIEW_TYPE_2D_ARRAY</code> or <code>VK_IMAGE_VIEW_TYPE_CUBE_ARRAY</code>, in any shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-None-02703",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> object that uses unnormalized coordinates, that sampler <strong class=\"purple\">must</strong> not be used with any of the SPIR-V <code>OpImageSample*</code> or <code>OpImageSparseSample*</code> instructions with <code>ImplicitLod</code>, <code>Dref</code> or <code>Proj</code> in their name, in any shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-None-02704",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> object that uses unnormalized coordinates, that sampler <strong class=\"purple\">must</strong> not be used with any of the SPIR-V <code>OpImageSample*</code> or <code>OpImageSparseSample*</code> instructions that includes a LOD bias or any offset values, in any shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-None-04115",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> is accessed using <code>OpImageWrite</code> as a result of this command, then the <code>Type</code> of the <code>Texel</code> operand of that instruction <strong class=\"purple\">must</strong> have at least as many components as the image view’s format"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-OpImageWrite-04469",
|
|
"text": " If a <a href=\"#VkBufferView\">VkBufferView</a> is accessed using <code>OpImageWrite</code> as a result of this command, then the <code>Type</code> of the <code>Texel</code> operand of that instruction <strong class=\"purple\">must</strong> have at least as many components as the buffer view’s format"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-renderPass-02684",
|
|
"text": " The current render pass <strong class=\"purple\">must</strong> be <a href=\"#renderpass-compatibility\">compatible</a> with the <code>renderPass</code> member of the <code>VkGraphicsPipelineCreateInfo</code> structure specified when creating the <code>VkPipeline</code> bound to <code>VK_PIPELINE_BIND_POINT_GRAPHICS</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-subpass-02685",
|
|
"text": " The subpass index of the current render pass <strong class=\"purple\">must</strong> be equal to the <code>subpass</code> member of the <code>VkGraphicsPipelineCreateInfo</code> structure specified when creating the <code>VkPipeline</code> bound to <code>VK_PIPELINE_BIND_POINT_GRAPHICS</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-None-02686",
|
|
"text": " Every input attachment used by the current subpass <strong class=\"purple\">must</strong> be bound to the pipeline via a descriptor set"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-None-06537",
|
|
"text": " Memory backing image subresources used as attachments in the current render pass <strong class=\"purple\">must</strong> not be written in any way other than as an attachment by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-None-06538",
|
|
"text": " If any recorded command in the current subpass will write to an image subresource as an attachment, this command <strong class=\"purple\">must</strong> not read from the memory backing that image subresource in any other way than as an attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-None-06539",
|
|
"text": " If any recorded command in the current subpass will read from an image subresource used as an attachment in any way other than as an attachment, this command <strong class=\"purple\">must</strong> not write to that image subresource as an attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-None-06886",
|
|
"text": " If the current render pass instance uses a depth/stencil attachment with a read-only layout for the depth aspect, <a href=\"#fragops-depth-write\">depth writes</a> <strong class=\"purple\">must</strong> be disabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-None-06887",
|
|
"text": " If the current render pass instance uses a depth/stencil attachment with a read-only layout for the stencil aspect and stencil test is enabled, <a href=\"#fragops-stencil\">all stencil ops</a> <strong class=\"purple\">must</strong> be <code>VK_STENCIL_OP_KEEP</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-blendEnable-04727",
|
|
"text": " If rasterization is not disabled in the bound graphics pipeline, then for each color attachment in the subpass, if the corresponding image view’s <a href=\"#resources-image-view-format-features\">format features</a> do not contain <code>VK_FORMAT_FEATURE_COLOR_ATTACHMENT_BLEND_BIT</code>, then the <code>blendEnable</code> member of the corresponding element of the <code>pAttachments</code> member of <code>pColorBlendState</code> <strong class=\"purple\">must</strong> be <code>VK_FALSE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-rasterizationSamples-04740",
|
|
"text": " If rasterization is not disabled in the bound graphics pipeline, and neither the <code><a href=\"#VK_AMD_mixed_attachment_samples\">VK_AMD_mixed_attachment_samples</a></code> nor the <code><a href=\"#VK_NV_framebuffer_mixed_samples\">VK_NV_framebuffer_mixed_samples</a></code> extensions are enabled, then <a href=\"#VkPipelineMultisampleStateCreateInfo\">VkPipelineMultisampleStateCreateInfo</a>::<code>rasterizationSamples</code> <strong class=\"purple\">must</strong> be the same as the current subpass color and/or depth/stencil attachments"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-None-04007",
|
|
"text": " All vertex input bindings accessed via vertex input variables declared in the vertex shader entry point’s interface <strong class=\"purple\">must</strong> have either valid or <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> buffers bound"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-None-04008",
|
|
"text": " If the <a href=\"#features-nullDescriptor\"><code>nullDescriptor</code></a> feature is not enabled, all vertex input bindings accessed via vertex input variables declared in the vertex shader entry point’s interface <strong class=\"purple\">must</strong> not be <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-None-02721",
|
|
"text": " For a given vertex buffer binding, any attribute data fetched <strong class=\"purple\">must</strong> be entirely contained within the corresponding vertex buffer binding, as described in <a href=\"#fxvertex-input\">Vertex Input Description</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-buffer-02708",
|
|
"text": " If <code>buffer</code> is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-buffer-02709",
|
|
"text": " <code>buffer</code> <strong class=\"purple\">must</strong> have been created with the <code>VK_BUFFER_USAGE_INDIRECT_BUFFER_BIT</code> bit set"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-offset-02710",
|
|
"text": " <code>offset</code> <strong class=\"purple\">must</strong> be a multiple of <code>4</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-countBuffer-02714",
|
|
"text": " If <code>countBuffer</code> is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-countBuffer-02715",
|
|
"text": " <code>countBuffer</code> <strong class=\"purple\">must</strong> have been created with the <code>VK_BUFFER_USAGE_INDIRECT_BUFFER_BIT</code> bit set"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-countBufferOffset-02716",
|
|
"text": " <code>countBufferOffset</code> <strong class=\"purple\">must</strong> be a multiple of <code>4</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-countBuffer-02717",
|
|
"text": " The count stored in <code>countBuffer</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxDrawIndirectCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-countBufferOffset-04129",
|
|
"text": " <span class=\"eq\">(<code>countBufferOffset</code> + <code>sizeof</code>(uint32_t))</span> <strong class=\"purple\">must</strong> be less than or equal to the size of <code>countBuffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-stride-03142",
|
|
"text": " <code>stride</code> <strong class=\"purple\">must</strong> be a multiple of <code>4</code> and <strong class=\"purple\">must</strong> be greater than or equal to sizeof(<code>VkDrawIndexedIndirectCommand</code>)"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-maxDrawCount-03143",
|
|
"text": " If <code>maxDrawCount</code> is greater than or equal to <code>1</code>, <span class=\"eq\">(<code>stride</code> {times} (<code>maxDrawCount</code> - 1) + <code>offset</code> + sizeof(<code>VkDrawIndexedIndirectCommand</code>))</span> <strong class=\"purple\">must</strong> be less than or equal to the size of <code>buffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-countBuffer-03153",
|
|
"text": " If count stored in <code>countBuffer</code> is equal to <code>1</code>, <span class=\"eq\">(<code>offset</code> + sizeof(<code>VkDrawIndexedIndirectCommand</code>))</span> <strong class=\"purple\">must</strong> be less than or equal to the size of <code>buffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-countBuffer-03154",
|
|
"text": " If count stored in <code>countBuffer</code> is greater than <code>1</code>, <span class=\"eq\">(<code>stride</code> {times} (<code>drawCount</code> - 1) + <code>offset</code> + sizeof(<code>VkDrawIndexedIndirectCommand</code>))</span> <strong class=\"purple\">must</strong> be less than or equal to the size of <code>buffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-buffer-parameter",
|
|
"text": " <code>buffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBuffer\">VkBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-countBuffer-parameter",
|
|
"text": " <code>countBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBuffer\">VkBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called inside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-commonparent",
|
|
"text": " Each of <code>buffer</code>, <code>commandBuffer</code>, and <code>countBuffer</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+!(VK_VERSION_1_3,VK_KHR_format_feature_flags2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-aspectMask-06478",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> is sampled with <a href=\"#textures-depth-compare-operation\">depth comparison</a>, the image view <strong class=\"purple\">must</strong> have been created with an <code>aspectMask</code> that contains <code>VK_IMAGE_ASPECT_DEPTH_BIT</code>."
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_VERSION_1_3,VK_KHR_format_feature_flags2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-None-06479",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> is sampled with <a href=\"#textures-depth-compare-operation\">depth comparison</a>, the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_SAMPLED_IMAGE_DEPTH_COMPARISON_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-OpTypeImage-06423",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> or <a href=\"#VkBufferView\">VkBufferView</a> being written as a storage image or storage texel buffer where the image format field of the <code>OpTypeImage</code> is <code>Unknown</code> then the view’s format feature <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_STORAGE_WRITE_WITHOUT_FORMAT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-OpTypeImage-06424",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> or <a href=\"#VkBufferView\">VkBufferView</a> being read as a storage image or storage texel buffer where the image format field of the <code>OpTypeImage</code> is <code>Unknown</code> then the view’s format feature <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_STORAGE_READ_WITHOUT_FORMAT_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_IMG_filter_cubic,VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-None-02692",
|
|
"text": " If a <code>VkImageView</code> is sampled with <code>VK_FILTER_CUBIC_EXT</code> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_CUBIC_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_IMG_filter_cubic,VK_EXT_filter_cubic)+!(VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-None-02693",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> being sampled with <code>VK_FILTER_CUBIC_EXT</code> as a result of this command <strong class=\"purple\">must</strong> not have a <a href=\"#VkImageViewType\">VkImageViewType</a> of <code>VK_IMAGE_VIEW_TYPE_3D</code>, <code>VK_IMAGE_VIEW_TYPE_CUBE</code>, or <code>VK_IMAGE_VIEW_TYPE_CUBE_ARRAY</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_IMG_filter_cubic,VK_EXT_filter_cubic)+(VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-filterCubic-02694",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> being sampled with <code>VK_FILTER_CUBIC_EXT</code> as a result of this command <strong class=\"purple\">must</strong> have a <a href=\"#VkImageViewType\">VkImageViewType</a> and format that supports cubic filtering, as specified by <code>VkFilterCubicImageViewImageFormatPropertiesEXT</code>::<code>filterCubic</code> returned by <code>vkGetPhysicalDeviceImageFormatProperties2</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-filterCubicMinmax-02695",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> being sampled with <code>VK_FILTER_CUBIC_EXT</code> with a reduction mode of either <code>VK_SAMPLER_REDUCTION_MODE_MIN</code> or <code>VK_SAMPLER_REDUCTION_MODE_MAX</code> as a result of this command <strong class=\"purple\">must</strong> have a <a href=\"#VkImageViewType\">VkImageViewType</a> and format that supports cubic filtering together with minmax filtering, as specified by <code>VkFilterCubicImageViewImageFormatPropertiesEXT</code>::<code>filterCubicMinmax</code> returned by <code>vkGetPhysicalDeviceImageFormatProperties2</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_NV_corner_sampled_image)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-flags-02696",
|
|
"text": " Any <a href=\"#VkImage\">VkImage</a> created with a <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a>::<code>flags</code> containing <code>VK_IMAGE_CREATE_CORNER_SAMPLED_BIT_NV</code> sampled as a result of this command <strong class=\"purple\">must</strong> only be sampled using a <a href=\"#VkSamplerAddressMode\">VkSamplerAddressMode</a> of <code>VK_SAMPLER_ADDRESS_MODE_CLAMP_TO_EDGE</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+!(VK_VERSION_1_3,VK_KHR_maintenance4)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-None-02698",
|
|
"text": " For each push constant that is statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command, a push constant value <strong class=\"purple\">must</strong> have been set for the same pipeline bind point, with a <code>VkPipelineLayout</code> that is compatible for push constants, with the <code>VkPipelineLayout</code> used to create the current <code>VkPipeline</code>, as described in <a href=\"#descriptorsets-compatibility\">Pipeline Layout Compatibility</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_VERSION_1_3,VK_KHR_maintenance4)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-maintenance4-06425",
|
|
"text": " If the <a href=\"#features-maintenance4\"><code>maintenance4</code></a> feature is not enabled, then for each push constant that is statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command, a push constant value <strong class=\"purple\">must</strong> have been set for the same pipeline bind point, with a <code>VkPipelineLayout</code> that is compatible for push constants, with the <code>VkPipelineLayout</code> used to create the current <code>VkPipeline</code>, as described in <a href=\"#descriptorsets-compatibility\">Pipeline Layout Compatibility</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+!(VK_EXT_pipeline_robustness)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-None-02705",
|
|
"text": " If the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, and if the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a uniform buffer, it <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-None-02706",
|
|
"text": " If the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, and if the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a storage buffer, it <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_EXT_pipeline_robustness)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-uniformBuffers-06935",
|
|
"text": " If any stage of the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a uniform buffer, and that stage was created without enabling either <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_EXT</code> or <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXT</code> for <code>uniformBuffers</code>, and the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, that stage <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-storageBuffers-06936",
|
|
"text": " If any stage of the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a storage buffer, and that stage was created without enabling either <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_EXT</code> or <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXT</code> for <code>storageBuffers</code>, and the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, that stage <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-commandBuffer-02707",
|
|
"text": " If <code>commandBuffer</code> is an unprotected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, any resource accessed by the <a href=\"#VkPipeline\">VkPipeline</a> object bound to the pipeline bind point used by this command <strong class=\"purple\">must</strong> not be a protected resource"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-commandBuffer-02711",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> not be a protected command buffer"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-None-06550",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> or <code>VkImageView</code> object that enables <a href=\"#samplers-YCbCr-conversion\">sampler {YCbCr} conversion</a>, that object <strong class=\"purple\">must</strong> only be used with <code>OpImageSample*</code> or <code>OpImageSparseSample*</code> instructions"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-ConstOffset-06551",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> or <code>VkImageView</code> object that enables <a href=\"#samplers-YCbCr-conversion\">sampler {YCbCr} conversion</a>, that object <strong class=\"purple\">must</strong> not use the <code>ConstOffset</code> and <code>Offset</code> operands"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_EXT_shader_image_atomic_int64)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-SampledType-04470",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a 64-bit component width is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 64"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-SampledType-04471",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a component width less than 64-bit is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 32"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-SampledType-04472",
|
|
"text": " If a <a href=\"#VkBufferView\">VkBufferView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a 64-bit component width is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 64"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-SampledType-04473",
|
|
"text": " If a <a href=\"#VkBufferView\">VkBufferView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a component width less than 64-bit is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 32"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-sparseImageInt64Atomics-04474",
|
|
"text": " If the <a href=\"#features-sparseImageInt64Atomics\"><code>sparseImageInt64Atomics</code></a> feature is not enabled, <a href=\"#VkImage\">VkImage</a> objects created with the <code>VK_IMAGE_CREATE_SPARSE_RESIDENCY_BIT</code> flag <strong class=\"purple\">must</strong> not be accessed by atomic instructions through an <code>OpTypeImage</code> with a <code>SampledType</code> with a <code>Width</code> of 64 by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-sparseImageInt64Atomics-04475",
|
|
"text": " If the <a href=\"#features-sparseImageInt64Atomics\"><code>sparseImageInt64Atomics</code></a> feature is not enabled, <a href=\"#VkBuffer\">VkBuffer</a> objects created with the <code>VK_BUFFER_CREATE_SPARSE_RESIDENCY_BIT</code> flag <strong class=\"purple\">must</strong> not be accessed by atomic instructions through an <code>OpTypeImage</code> with a <code>SampledType</code> with a <code>Width</code> of 64 by this command"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_QCOM_image_processing)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-OpImageWeightedSampleQCOM-06971",
|
|
"text": " If <code>OpImageWeightedSampleQCOM</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_WEIGHT_SAMPLED_IMAGE_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-OpImageWeightedSampleQCOM-06972",
|
|
"text": " If <code>OpImageWeightedSampleQCOM</code> uses a <a href=\"#VkImageView\">VkImageView</a> as a sample weight image as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_WEIGHT_IMAGE_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-OpImageBoxFilterQCOM-06973",
|
|
"text": " If <code>OpImageBoxFilterQCOM</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_BOX_FILTER_SAMPLED_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-OpImageBlockMatchSSDQCOM-06974",
|
|
"text": " If <code>OpImageBlockMatchSSDQCOM</code> is used to read from an <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-OpImageBlockMatchSADQCOM-06975",
|
|
"text": " If <code>OpImageBlockMatchSADQCOM</code> is used to read from an <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-OpImageBlockMatchSADQCOM-06976",
|
|
"text": " If <code>OpImageBlockMatchSADQCOM</code> or OpImageBlockMatchSSDQCOM is used to read from a reference image as result of this command, then the specified reference coordinates <strong class=\"purple\">must</strong> not fail <a href=\"#textures-integer-coordinate-validation\">integer texel coordinate validation</a>."
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-OpImageWeightedSampleQCOM-06977",
|
|
"text": " If <code>OpImageWeightedSampleQCOM</code>, <code>OpImageBoxFilterQCOM</code>, <code>OpImageBlockMatchSSDQCOM</code>, or <code>OpImageBlockMatchSADQCOM</code> uses a <a href=\"#VkSampler\">VkSampler</a> as a result of this command, then the sampler <strong class=\"purple\">must</strong> have been created with <code>VK_SAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-OpImageWeightedSampleQCOM-06978",
|
|
"text": " If any command other than <code>OpImageWeightedSampleQCOM</code>, <code>OpImageBoxFilterQCOM</code>, <code>OpImageBlockMatchSSDQCOM</code>, or <code>OpImageBlockMatchSADQCOM</code> uses a <a href=\"#VkSampler\">VkSampler</a> as a result of this command, then the sampler <strong class=\"purple\">must</strong> not have been created with <code>VK_SAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM</code>."
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_VERSION_1_1,VK_KHR_multiview)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-maxMultiviewInstanceIndex-02688",
|
|
"text": " If the draw is recorded in a render pass instance with multiview enabled, the maximum instance index <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#VkPhysicalDeviceMultiviewProperties\">VkPhysicalDeviceMultiviewProperties</a>::<code>maxMultiviewInstanceIndex</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_EXT_sample_locations)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-sampleLocationsEnable-02689",
|
|
"text": " If the bound graphics pipeline was created with <a href=\"#VkPipelineSampleLocationsStateCreateInfoEXT\">VkPipelineSampleLocationsStateCreateInfoEXT</a>::<code>sampleLocationsEnable</code> set to <code>VK_TRUE</code> and the current subpass has a depth/stencil attachment, then that attachment <strong class=\"purple\">must</strong> have been created with the <code>VK_IMAGE_CREATE_SAMPLE_LOCATIONS_COMPATIBLE_DEPTH_BIT_EXT</code> bit set"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-None-06666",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_SAMPLE_LOCATIONS_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetSampleLocationsEXT\">vkCmdSetSampleLocationsEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-viewportCount-03417",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, but not the <code>VK_DYNAMIC_STATE_SCISSOR_WITH_COUNT</code> dynamic state enabled, then <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>viewportCount</code> parameter of <code>vkCmdSetViewportWithCount</code> <strong class=\"purple\">must</strong> match the <code>VkPipelineViewportStateCreateInfo</code>::<code>scissorCount</code> of the pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-scissorCount-03418",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_SCISSOR_WITH_COUNT</code> dynamic state enabled, but not the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, then <a href=\"#vkCmdSetScissorWithCount\">vkCmdSetScissorWithCount</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>scissorCount</code> parameter of <code>vkCmdSetScissorWithCount</code> <strong class=\"purple\">must</strong> match the <code>VkPipelineViewportStateCreateInfo</code>::<code>viewportCount</code> of the pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-viewportCount-03419",
|
|
"text": " If the bound graphics pipeline state was created with both the <code>VK_DYNAMIC_STATE_SCISSOR_WITH_COUNT</code> and <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic states enabled then both <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a> and <a href=\"#vkCmdSetScissorWithCount\">vkCmdSetScissorWithCount</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>viewportCount</code> parameter of <code>vkCmdSetViewportWithCount</code> <strong class=\"purple\">must</strong> match the <code>scissorCount</code> parameter of <code>vkCmdSetScissorWithCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-primitiveTopology-03420",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_PRIMITIVE_TOPOLOGY_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetPrimitiveTopologyEXT\">vkCmdSetPrimitiveTopologyEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>primitiveTopology</code> parameter of <code>vkCmdSetPrimitiveTopologyEXT</code> <strong class=\"purple\">must</strong> be of the same <a href=\"#drawing-primitive-topology-class\">topology class</a> as the pipeline <a href=\"#VkPipelineInputAssemblyStateCreateInfo\">VkPipelineInputAssemblyStateCreateInfo</a>::<code>topology</code> state"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_NV_clip_space_w_scaling)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-viewportCount-04137",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, but not the <code>VK_DYNAMIC_STATE_VIEWPORT_W_SCALING_NV</code> dynamic state enabled, then the bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <a href=\"#VkPipelineViewportWScalingStateCreateInfoNV\">VkPipelineViewportWScalingStateCreateInfoNV</a>::<code>viewportCount</code> greater or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-viewportCount-04138",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> and <code>VK_DYNAMIC_STATE_VIEWPORT_W_SCALING_NV</code> dynamic states enabled then the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWScalingNV\">vkCmdSetViewportWScalingNV</a> <strong class=\"purple\">must</strong> be greater than or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_NV_shading_rate_image)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-viewportCount-04139",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, but not the <code>VK_DYNAMIC_STATE_VIEWPORT_SHADING_RATE_PALETTE_NV</code> dynamic state enabled, then the bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <a href=\"#VkPipelineViewportShadingRateImageStateCreateInfoNV\">VkPipelineViewportShadingRateImageStateCreateInfoNV</a>::<code>viewportCount</code> greater or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-viewportCount-04140",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> and <code>VK_DYNAMIC_STATE_VIEWPORT_SHADING_RATE_PALETTE_NV</code> dynamic states enabled then the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportShadingRatePaletteNV\">vkCmdSetViewportShadingRatePaletteNV</a> <strong class=\"purple\">must</strong> be greater than or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_NV_viewport_swizzle)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-VkPipelineVieportCreateInfo-04141",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled and a <a href=\"#VkPipelineViewportSwizzleStateCreateInfoNV\">VkPipelineViewportSwizzleStateCreateInfoNV</a> structure chained from <code>VkPipelineVieportCreateInfo</code>, then the bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <a href=\"#VkPipelineViewportSwizzleStateCreateInfoNV\">VkPipelineViewportSwizzleStateCreateInfoNV</a>::<code>viewportCount</code> greater or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_NV_scissor_exclusive)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-VkPipelineVieportCreateInfo-04142",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled and a <a href=\"#VkPipelineViewportExclusiveScissorStateCreateInfoNV\">VkPipelineViewportExclusiveScissorStateCreateInfoNV</a> structure chained from <code>VkPipelineVieportCreateInfo</code>, then the bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <a href=\"#VkPipelineViewportExclusiveScissorStateCreateInfoNV\">VkPipelineViewportExclusiveScissorStateCreateInfoNV</a>::<code>exclusiveScissorCount</code> greater or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-None-04876",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_RASTERIZER_DISCARD_ENABLE</code> dynamic state enabled then <a href=\"#vkCmdSetRasterizerDiscardEnable\">vkCmdSetRasterizerDiscardEnable</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-None-04877",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_DEPTH_BIAS_ENABLE</code> dynamic state enabled then <a href=\"#vkCmdSetDepthBiasEnable\">vkCmdSetDepthBiasEnable</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-logicOp-04878",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_LOGIC_OP_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetLogicOpEXT\">vkCmdSetLogicOpEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command and the <code>logicOp</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkLogicOp\">VkLogicOp</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-None-04875",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_PATCH_CONTROL_POINTS_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetPatchControlPointsEXT\">vkCmdSetPatchControlPointsEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-None-04879",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_PRIMITIVE_RESTART_ENABLE_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetPrimitiveRestartEnableEXT\">vkCmdSetPrimitiveRestartEnableEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_KHR_fragment_shading_rate)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-primitiveFragmentShadingRateWithMultipleViewports-04552",
|
|
"text": " If the <a href=\"#limits-primitiveFragmentShadingRateWithMultipleViewports\"><code>primitiveFragmentShadingRateWithMultipleViewports</code></a> limit is not supported, the bound graphics pipeline was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, and any of the shader stages of the bound graphics pipeline write to the <code>PrimitiveShadingRateKHR</code> built-in, then <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>viewportCount</code> parameter of <code>vkCmdSetViewportWithCount</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-imageView-06172",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pDepthAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pDepthAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the depth attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-imageView-06173",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pStencilAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pStencilAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the stencil attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-viewMask-06178",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound graphics pipeline <strong class=\"purple\">must</strong> have been created with a <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>viewMask</code> equal to <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>viewMask</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-colorAttachmentCount-06179",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound graphics pipeline <strong class=\"purple\">must</strong> have been created with a <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>colorAttachmentCount</code> equal to <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>colorAttachmentCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-colorAttachmentCount-06180",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>colorAttachmentCount</code> greater than <code>0</code>, then each element of the <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pColorAttachments</code> array with a <code>imageView</code> not equal to <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> <strong class=\"purple\">must</strong> have been created with a <a href=\"#VkFormat\">VkFormat</a> equal to the corresponding element of <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>pColorAttachmentFormats</code> used to create the currently bound graphics pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-pDepthAttachment-06181",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>depthAttachmentFormat</code> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the <a href=\"#VkFormat\">VkFormat</a> used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-pStencilAttachment-06182",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>stencilAttachmentFormat</code> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the <a href=\"#VkFormat\">VkFormat</a> used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_VERSION_1_1,VK_KHR_maintenance2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-imageView-06174",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pDepthAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pDepthAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_STENCIL_ATTACHMENT_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the depth attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-imageView-06175",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pStencilAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pStencilAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_STENCIL_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the stencil attachment"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_VERSION_1_2,VK_KHR_separate_depth_stencil_layouts)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-imageView-06176",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pDepthAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pDepthAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the depth attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-imageView-06177",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pStencilAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pStencilAttachment</code> is <code>VK_IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the stencil attachment"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_EXT_color_write_enable)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-attachmentCount-06667",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_COLOR_WRITE_ENABLE_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetColorWriteEnableEXT\">vkCmdSetColorWriteEnableEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>attachmentCount</code> parameter of <code>vkCmdSetColorWriteEnableEXT</code> <strong class=\"purple\">must</strong> be greater than or equal to the <code>VkPipelineColorBlendStateCreateInfo</code>::<code>attachmentCount</code> of the currently bound graphics pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-attachmentCount-06815",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_COLOR_WRITE_ENABLE_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetColorWriteEnableEXT\">vkCmdSetColorWriteEnableEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>attachmentCount</code> parameter of <code>vkCmdSetColorWriteEnableEXT</code> <strong class=\"purple\">must</strong> be less than or equal to the <code>maxColorAttachments</code> member of <code>VkPhysicalDeviceLimits</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_KHR_fragment_shading_rate)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-imageView-06183",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingFragmentShadingRateAttachmentInfoKHR\">VkRenderingFragmentShadingRateAttachmentInfoKHR</a>::<code>imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the currently bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <code>VK_PIPELINE_CREATE_RENDERING_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_EXT_fragment_density_map)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-imageView-06184",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingFragmentDensityMapAttachmentInfoEXT\">VkRenderingFragmentDensityMapAttachmentInfoEXT</a>::<code>imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the currently bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <code>VK_PIPELINE_CREATE_RENDERING_FRAGMENT_DENSITY_MAP_ATTACHMENT_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_AMD_mixed_attachment_samples,VK_NV_framebuffer_mixed_samples)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-colorAttachmentCount-06185",
|
|
"text": " If the currently bound pipeline was created with a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> with a <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>colorAttachmentCount</code> parameter greater than <code>0</code>, then each element of the <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pColorAttachments</code> array with a <code>imageView</code> not equal to <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> <strong class=\"purple\">must</strong> have been created with a sample count equal to the corresponding element of the <code>pColorAttachmentSamples</code> member of <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> used to create the currently bound graphics pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-pDepthAttachment-06186",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline was created with a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of the <code>depthStencilAttachmentSamples</code> member of <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the sample count used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-pStencilAttachment-06187",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline was created with a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of the <code>depthStencilAttachmentSamples</code> member of <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the sample count used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-colorAttachmentCount-06188",
|
|
"text": " If the currently bound pipeline was created without a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> with a <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>colorAttachmentCount</code> parameter greater than <code>0</code>, then each element of the <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pColorAttachments</code> array with a <code>imageView</code> not equal to <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> <strong class=\"purple\">must</strong> have been created with a sample count equal to the value of <a href=\"#VkPipelineMultisampleStateCreateInfo\">VkPipelineMultisampleStateCreateInfo</a>::<code>rasterizationSamples</code> used to create the currently bound graphics pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-pDepthAttachment-06189",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline was created without a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of <a href=\"#VkPipelineMultisampleStateCreateInfo\">VkPipelineMultisampleStateCreateInfo</a>::<code>rasterizationSamples</code> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the sample count used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-pStencilAttachment-06190",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline was created without a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of <a href=\"#VkPipelineMultisampleStateCreateInfo\">VkPipelineMultisampleStateCreateInfo</a>::<code>rasterizationSamples</code> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the sample count used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-renderPass-06198",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline <strong class=\"purple\">must</strong> have been created with a <a href=\"#VkGraphicsPipelineCreateInfo\">VkGraphicsPipelineCreateInfo</a>::<code>renderPass</code> equal to <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_EXT_primitives_generated_query)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-primitivesGeneratedQueryWithRasterizerDiscard-06708",
|
|
"text": " If the <a href=\"#features-primitivesGeneratedQueryWithRasterizerDiscard\"><code>primitivesGeneratedQueryWithRasterizerDiscard</code></a> feature is not enabled and the <code>VK_QUERY_TYPE_PRIMITIVES_GENERATED_EXT</code> query is active, <a href=\"#primsrast-discard\">rasterization discard</a> <strong class=\"purple\">must</strong> not be enabled."
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_EXT_primitives_generated_query)+(VK_EXT_transform_feedback)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-primitivesGeneratedQueryWithNonZeroStreams-06709",
|
|
"text": " If the <a href=\"#features-primitivesGeneratedQueryWithNonZeroStreams\"><code>primitivesGeneratedQueryWithNonZeroStreams</code></a> feature is not enabled and the <code>VK_QUERY_TYPE_PRIMITIVES_GENERATED_EXT</code> query is active, the bound graphics pipeline <strong class=\"purple\">must</strong> not have been created with a non-zero value in <code>VkPipelineRasterizationStateStreamCreateInfoEXT</code>::<code>rasterizationStream</code>."
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_EXT_vertex_input_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-None-04912",
|
|
"text": " If the bound graphics pipeline was created with both the <code>VK_DYNAMIC_STATE_VERTEX_INPUT_EXT</code> and <code>VK_DYNAMIC_STATE_VERTEX_INPUT_BINDING_STRIDE_EXT</code> dynamic states enabled, then <a href=\"#vkCmdSetVertexInputEXT\">vkCmdSetVertexInputEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this draw command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-pStrides-04913",
|
|
"text": " If the bound graphics pipeline was created with the <code>VK_DYNAMIC_STATE_VERTEX_INPUT_BINDING_STRIDE_EXT</code> dynamic state enabled, but not the <code>VK_DYNAMIC_STATE_VERTEX_INPUT_EXT</code> dynamic state enabled, then <a href=\"#vkCmdBindVertexBuffers2EXT\">vkCmdBindVertexBuffers2EXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this draw command, and the <code>pStrides</code> parameter of <a href=\"#vkCmdBindVertexBuffers2EXT\">vkCmdBindVertexBuffers2EXT</a> <strong class=\"purple\">must</strong> not be <code>NULL</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+!(VK_EXT_vertex_input_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-pStrides-04884",
|
|
"text": " If the bound graphics pipeline was created with the <code>VK_DYNAMIC_STATE_VERTEX_INPUT_BINDING_STRIDE_EXT</code> dynamic state enabled, then <a href=\"#vkCmdBindVertexBuffers2EXT\">vkCmdBindVertexBuffers2EXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>pStrides</code> parameter of <a href=\"#vkCmdBindVertexBuffers2EXT\">vkCmdBindVertexBuffers2EXT</a> <strong class=\"purple\">must</strong> not be <code>NULL</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_EXT_vertex_input_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-None-04914",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VERTEX_INPUT_EXT</code> dynamic state enabled, then <a href=\"#vkCmdSetVertexInputEXT\">vkCmdSetVertexInputEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this draw command"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_NV_mesh_shader)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-stage-06481",
|
|
"text": " The bound graphics pipeline <strong class=\"purple\">must</strong> not have been created with the <a href=\"#VkPipelineShaderStageCreateInfo\">VkPipelineShaderStageCreateInfo</a>::<code>stage</code> member of an element of <a href=\"#VkGraphicsPipelineCreateInfo\">VkGraphicsPipelineCreateInfo</a>::<code>pStages</code> set to <code>VK_SHADER_STAGE_TASK_BIT_NV</code> or <code>VK_SHADER_STAGE_MESH_BIT_NV</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_draw_indirect_count)+(VK_VERSION_1_2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndexedIndirectCount-None-04445",
|
|
"text": " If <a href=\"#features-drawIndirectCount\"><code>drawIndirectCount</code></a> is not enabled this function <strong class=\"purple\">must</strong> not be used"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdDrawIndirectByteCountEXT": {
|
|
"(VK_EXT_transform_feedback)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-magFilter-04553",
|
|
"text": " If a <a href=\"#VkSampler\">VkSampler</a> created with <code>magFilter</code> or <code>minFilter</code> equal to <code>VK_FILTER_LINEAR</code> and <code>compareEnable</code> equal to <code>VK_FALSE</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-mipmapMode-04770",
|
|
"text": " If a <a href=\"#VkSampler\">VkSampler</a> created with <code>mipmapMode</code> equal to <code>VK_SAMPLER_MIPMAP_MODE_LINEAR</code> and <code>compareEnable</code> equal to <code>VK_FALSE</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-None-02691",
|
|
"text": " If a <code>VkImageView</code> is accessed using atomic operations as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_STORAGE_IMAGE_ATOMIC_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-None-02697",
|
|
"text": " For each set <em>n</em> that is statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command, a descriptor set <strong class=\"purple\">must</strong> have been bound to <em>n</em> at the same pipeline bind point, with a <code>VkPipelineLayout</code> that is compatible for set <em>n</em>, with the <code>VkPipelineLayout</code> used to create the current <code>VkPipeline</code>, as described in <a href=\"#descriptorsets-compatibility\">Pipeline Layout Compatibility</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-None-02699",
|
|
"text": " Descriptors in each bound descriptor set, specified via <code>vkCmdBindDescriptorSets</code>, <strong class=\"purple\">must</strong> be valid if they are statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-None-02700",
|
|
"text": " A valid pipeline <strong class=\"purple\">must</strong> be bound to the pipeline bind point used by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-commandBuffer-02701",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command requires any dynamic state, that state <strong class=\"purple\">must</strong> have been set or inherited (if the <code><a href=\"#VK_NV_inherited_viewport_scissor\">VK_NV_inherited_viewport_scissor</a></code> extension is enabled) for <code>commandBuffer</code>, and done so after any previously bound pipeline with the corresponding state not specified as dynamic"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-None-02859",
|
|
"text": " There <strong class=\"purple\">must</strong> not have been any calls to dynamic state setting commands for any state not specified as dynamic in the <code>VkPipeline</code> object bound to the pipeline bind point used by this command, since that pipeline was bound"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-None-02702",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> object that uses unnormalized coordinates, that sampler <strong class=\"purple\">must</strong> not be used to sample from any <code>VkImage</code> with a <code>VkImageView</code> of the type <code>VK_IMAGE_VIEW_TYPE_3D</code>, <code>VK_IMAGE_VIEW_TYPE_CUBE</code>, <code>VK_IMAGE_VIEW_TYPE_1D_ARRAY</code>, <code>VK_IMAGE_VIEW_TYPE_2D_ARRAY</code> or <code>VK_IMAGE_VIEW_TYPE_CUBE_ARRAY</code>, in any shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-None-02703",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> object that uses unnormalized coordinates, that sampler <strong class=\"purple\">must</strong> not be used with any of the SPIR-V <code>OpImageSample*</code> or <code>OpImageSparseSample*</code> instructions with <code>ImplicitLod</code>, <code>Dref</code> or <code>Proj</code> in their name, in any shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-None-02704",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> object that uses unnormalized coordinates, that sampler <strong class=\"purple\">must</strong> not be used with any of the SPIR-V <code>OpImageSample*</code> or <code>OpImageSparseSample*</code> instructions that includes a LOD bias or any offset values, in any shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-None-04115",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> is accessed using <code>OpImageWrite</code> as a result of this command, then the <code>Type</code> of the <code>Texel</code> operand of that instruction <strong class=\"purple\">must</strong> have at least as many components as the image view’s format"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-OpImageWrite-04469",
|
|
"text": " If a <a href=\"#VkBufferView\">VkBufferView</a> is accessed using <code>OpImageWrite</code> as a result of this command, then the <code>Type</code> of the <code>Texel</code> operand of that instruction <strong class=\"purple\">must</strong> have at least as many components as the buffer view’s format"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-renderPass-02684",
|
|
"text": " The current render pass <strong class=\"purple\">must</strong> be <a href=\"#renderpass-compatibility\">compatible</a> with the <code>renderPass</code> member of the <code>VkGraphicsPipelineCreateInfo</code> structure specified when creating the <code>VkPipeline</code> bound to <code>VK_PIPELINE_BIND_POINT_GRAPHICS</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-subpass-02685",
|
|
"text": " The subpass index of the current render pass <strong class=\"purple\">must</strong> be equal to the <code>subpass</code> member of the <code>VkGraphicsPipelineCreateInfo</code> structure specified when creating the <code>VkPipeline</code> bound to <code>VK_PIPELINE_BIND_POINT_GRAPHICS</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-None-02686",
|
|
"text": " Every input attachment used by the current subpass <strong class=\"purple\">must</strong> be bound to the pipeline via a descriptor set"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-None-06537",
|
|
"text": " Memory backing image subresources used as attachments in the current render pass <strong class=\"purple\">must</strong> not be written in any way other than as an attachment by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-None-06538",
|
|
"text": " If any recorded command in the current subpass will write to an image subresource as an attachment, this command <strong class=\"purple\">must</strong> not read from the memory backing that image subresource in any other way than as an attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-None-06539",
|
|
"text": " If any recorded command in the current subpass will read from an image subresource used as an attachment in any way other than as an attachment, this command <strong class=\"purple\">must</strong> not write to that image subresource as an attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-None-06886",
|
|
"text": " If the current render pass instance uses a depth/stencil attachment with a read-only layout for the depth aspect, <a href=\"#fragops-depth-write\">depth writes</a> <strong class=\"purple\">must</strong> be disabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-None-06887",
|
|
"text": " If the current render pass instance uses a depth/stencil attachment with a read-only layout for the stencil aspect and stencil test is enabled, <a href=\"#fragops-stencil\">all stencil ops</a> <strong class=\"purple\">must</strong> be <code>VK_STENCIL_OP_KEEP</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-blendEnable-04727",
|
|
"text": " If rasterization is not disabled in the bound graphics pipeline, then for each color attachment in the subpass, if the corresponding image view’s <a href=\"#resources-image-view-format-features\">format features</a> do not contain <code>VK_FORMAT_FEATURE_COLOR_ATTACHMENT_BLEND_BIT</code>, then the <code>blendEnable</code> member of the corresponding element of the <code>pAttachments</code> member of <code>pColorBlendState</code> <strong class=\"purple\">must</strong> be <code>VK_FALSE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-rasterizationSamples-04740",
|
|
"text": " If rasterization is not disabled in the bound graphics pipeline, and neither the <code><a href=\"#VK_AMD_mixed_attachment_samples\">VK_AMD_mixed_attachment_samples</a></code> nor the <code><a href=\"#VK_NV_framebuffer_mixed_samples\">VK_NV_framebuffer_mixed_samples</a></code> extensions are enabled, then <a href=\"#VkPipelineMultisampleStateCreateInfo\">VkPipelineMultisampleStateCreateInfo</a>::<code>rasterizationSamples</code> <strong class=\"purple\">must</strong> be the same as the current subpass color and/or depth/stencil attachments"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-None-04007",
|
|
"text": " All vertex input bindings accessed via vertex input variables declared in the vertex shader entry point’s interface <strong class=\"purple\">must</strong> have either valid or <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> buffers bound"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-None-04008",
|
|
"text": " If the <a href=\"#features-nullDescriptor\"><code>nullDescriptor</code></a> feature is not enabled, all vertex input bindings accessed via vertex input variables declared in the vertex shader entry point’s interface <strong class=\"purple\">must</strong> not be <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-None-02721",
|
|
"text": " For a given vertex buffer binding, any attribute data fetched <strong class=\"purple\">must</strong> be entirely contained within the corresponding vertex buffer binding, as described in <a href=\"#fxvertex-input\">Vertex Input Description</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-transformFeedback-02287",
|
|
"text": " <code>VkPhysicalDeviceTransformFeedbackFeaturesEXT</code>::<code>transformFeedback</code> <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-transformFeedbackDraw-02288",
|
|
"text": " The implementation <strong class=\"purple\">must</strong> support <code>VkPhysicalDeviceTransformFeedbackPropertiesEXT</code>::<code>transformFeedbackDraw</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-vertexStride-02289",
|
|
"text": " <code>vertexStride</code> <strong class=\"purple\">must</strong> be greater than 0 and less than or equal to <a href=\"#VkPhysicalDeviceLimits\">VkPhysicalDeviceLimits</a>::<code>maxTransformFeedbackBufferDataStride</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-counterBuffer-04567",
|
|
"text": " If <code>counterBuffer</code> is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-counterBuffer-02290",
|
|
"text": " <code>counterBuffer</code> <strong class=\"purple\">must</strong> have been created with the <code>VK_BUFFER_USAGE_INDIRECT_BUFFER_BIT</code> bit set"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-counterBufferOffset-04568",
|
|
"text": " <code>counterBufferOffset</code> <strong class=\"purple\">must</strong> be a multiple of <code>4</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-counterBuffer-parameter",
|
|
"text": " <code>counterBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBuffer\">VkBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called inside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-commonparent",
|
|
"text": " Both of <code>commandBuffer</code>, and <code>counterBuffer</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)+!(VK_VERSION_1_3,VK_KHR_format_feature_flags2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-aspectMask-06478",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> is sampled with <a href=\"#textures-depth-compare-operation\">depth comparison</a>, the image view <strong class=\"purple\">must</strong> have been created with an <code>aspectMask</code> that contains <code>VK_IMAGE_ASPECT_DEPTH_BIT</code>."
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)+(VK_VERSION_1_3,VK_KHR_format_feature_flags2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-None-06479",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> is sampled with <a href=\"#textures-depth-compare-operation\">depth comparison</a>, the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_SAMPLED_IMAGE_DEPTH_COMPARISON_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-OpTypeImage-06423",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> or <a href=\"#VkBufferView\">VkBufferView</a> being written as a storage image or storage texel buffer where the image format field of the <code>OpTypeImage</code> is <code>Unknown</code> then the view’s format feature <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_STORAGE_WRITE_WITHOUT_FORMAT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-OpTypeImage-06424",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> or <a href=\"#VkBufferView\">VkBufferView</a> being read as a storage image or storage texel buffer where the image format field of the <code>OpTypeImage</code> is <code>Unknown</code> then the view’s format feature <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_STORAGE_READ_WITHOUT_FORMAT_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)+(VK_IMG_filter_cubic,VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-None-02692",
|
|
"text": " If a <code>VkImageView</code> is sampled with <code>VK_FILTER_CUBIC_EXT</code> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_CUBIC_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)+(VK_IMG_filter_cubic,VK_EXT_filter_cubic)+!(VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-None-02693",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> being sampled with <code>VK_FILTER_CUBIC_EXT</code> as a result of this command <strong class=\"purple\">must</strong> not have a <a href=\"#VkImageViewType\">VkImageViewType</a> of <code>VK_IMAGE_VIEW_TYPE_3D</code>, <code>VK_IMAGE_VIEW_TYPE_CUBE</code>, or <code>VK_IMAGE_VIEW_TYPE_CUBE_ARRAY</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)+(VK_IMG_filter_cubic,VK_EXT_filter_cubic)+(VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-filterCubic-02694",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> being sampled with <code>VK_FILTER_CUBIC_EXT</code> as a result of this command <strong class=\"purple\">must</strong> have a <a href=\"#VkImageViewType\">VkImageViewType</a> and format that supports cubic filtering, as specified by <code>VkFilterCubicImageViewImageFormatPropertiesEXT</code>::<code>filterCubic</code> returned by <code>vkGetPhysicalDeviceImageFormatProperties2</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-filterCubicMinmax-02695",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> being sampled with <code>VK_FILTER_CUBIC_EXT</code> with a reduction mode of either <code>VK_SAMPLER_REDUCTION_MODE_MIN</code> or <code>VK_SAMPLER_REDUCTION_MODE_MAX</code> as a result of this command <strong class=\"purple\">must</strong> have a <a href=\"#VkImageViewType\">VkImageViewType</a> and format that supports cubic filtering together with minmax filtering, as specified by <code>VkFilterCubicImageViewImageFormatPropertiesEXT</code>::<code>filterCubicMinmax</code> returned by <code>vkGetPhysicalDeviceImageFormatProperties2</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)+(VK_NV_corner_sampled_image)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-flags-02696",
|
|
"text": " Any <a href=\"#VkImage\">VkImage</a> created with a <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a>::<code>flags</code> containing <code>VK_IMAGE_CREATE_CORNER_SAMPLED_BIT_NV</code> sampled as a result of this command <strong class=\"purple\">must</strong> only be sampled using a <a href=\"#VkSamplerAddressMode\">VkSamplerAddressMode</a> of <code>VK_SAMPLER_ADDRESS_MODE_CLAMP_TO_EDGE</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)+!(VK_VERSION_1_3,VK_KHR_maintenance4)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-None-02698",
|
|
"text": " For each push constant that is statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command, a push constant value <strong class=\"purple\">must</strong> have been set for the same pipeline bind point, with a <code>VkPipelineLayout</code> that is compatible for push constants, with the <code>VkPipelineLayout</code> used to create the current <code>VkPipeline</code>, as described in <a href=\"#descriptorsets-compatibility\">Pipeline Layout Compatibility</a>"
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)+(VK_VERSION_1_3,VK_KHR_maintenance4)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-maintenance4-06425",
|
|
"text": " If the <a href=\"#features-maintenance4\"><code>maintenance4</code></a> feature is not enabled, then for each push constant that is statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command, a push constant value <strong class=\"purple\">must</strong> have been set for the same pipeline bind point, with a <code>VkPipelineLayout</code> that is compatible for push constants, with the <code>VkPipelineLayout</code> used to create the current <code>VkPipeline</code>, as described in <a href=\"#descriptorsets-compatibility\">Pipeline Layout Compatibility</a>"
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)+!(VK_EXT_pipeline_robustness)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-None-02705",
|
|
"text": " If the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, and if the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a uniform buffer, it <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-None-02706",
|
|
"text": " If the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, and if the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a storage buffer, it <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)+(VK_EXT_pipeline_robustness)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-uniformBuffers-06935",
|
|
"text": " If any stage of the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a uniform buffer, and that stage was created without enabling either <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_EXT</code> or <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXT</code> for <code>uniformBuffers</code>, and the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, that stage <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-storageBuffers-06936",
|
|
"text": " If any stage of the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a storage buffer, and that stage was created without enabling either <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_EXT</code> or <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXT</code> for <code>storageBuffers</code>, and the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, that stage <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)+(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-commandBuffer-02707",
|
|
"text": " If <code>commandBuffer</code> is an unprotected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, any resource accessed by the <a href=\"#VkPipeline\">VkPipeline</a> object bound to the pipeline bind point used by this command <strong class=\"purple\">must</strong> not be a protected resource"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-commandBuffer-02646",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> not be a protected command buffer"
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)+(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-None-06550",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> or <code>VkImageView</code> object that enables <a href=\"#samplers-YCbCr-conversion\">sampler {YCbCr} conversion</a>, that object <strong class=\"purple\">must</strong> only be used with <code>OpImageSample*</code> or <code>OpImageSparseSample*</code> instructions"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-ConstOffset-06551",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> or <code>VkImageView</code> object that enables <a href=\"#samplers-YCbCr-conversion\">sampler {YCbCr} conversion</a>, that object <strong class=\"purple\">must</strong> not use the <code>ConstOffset</code> and <code>Offset</code> operands"
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)+(VK_EXT_shader_image_atomic_int64)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-SampledType-04470",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a 64-bit component width is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 64"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-SampledType-04471",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a component width less than 64-bit is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 32"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-SampledType-04472",
|
|
"text": " If a <a href=\"#VkBufferView\">VkBufferView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a 64-bit component width is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 64"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-SampledType-04473",
|
|
"text": " If a <a href=\"#VkBufferView\">VkBufferView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a component width less than 64-bit is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 32"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-sparseImageInt64Atomics-04474",
|
|
"text": " If the <a href=\"#features-sparseImageInt64Atomics\"><code>sparseImageInt64Atomics</code></a> feature is not enabled, <a href=\"#VkImage\">VkImage</a> objects created with the <code>VK_IMAGE_CREATE_SPARSE_RESIDENCY_BIT</code> flag <strong class=\"purple\">must</strong> not be accessed by atomic instructions through an <code>OpTypeImage</code> with a <code>SampledType</code> with a <code>Width</code> of 64 by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-sparseImageInt64Atomics-04475",
|
|
"text": " If the <a href=\"#features-sparseImageInt64Atomics\"><code>sparseImageInt64Atomics</code></a> feature is not enabled, <a href=\"#VkBuffer\">VkBuffer</a> objects created with the <code>VK_BUFFER_CREATE_SPARSE_RESIDENCY_BIT</code> flag <strong class=\"purple\">must</strong> not be accessed by atomic instructions through an <code>OpTypeImage</code> with a <code>SampledType</code> with a <code>Width</code> of 64 by this command"
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)+(VK_QCOM_image_processing)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-OpImageWeightedSampleQCOM-06971",
|
|
"text": " If <code>OpImageWeightedSampleQCOM</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_WEIGHT_SAMPLED_IMAGE_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-OpImageWeightedSampleQCOM-06972",
|
|
"text": " If <code>OpImageWeightedSampleQCOM</code> uses a <a href=\"#VkImageView\">VkImageView</a> as a sample weight image as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_WEIGHT_IMAGE_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-OpImageBoxFilterQCOM-06973",
|
|
"text": " If <code>OpImageBoxFilterQCOM</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_BOX_FILTER_SAMPLED_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-OpImageBlockMatchSSDQCOM-06974",
|
|
"text": " If <code>OpImageBlockMatchSSDQCOM</code> is used to read from an <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-OpImageBlockMatchSADQCOM-06975",
|
|
"text": " If <code>OpImageBlockMatchSADQCOM</code> is used to read from an <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-OpImageBlockMatchSADQCOM-06976",
|
|
"text": " If <code>OpImageBlockMatchSADQCOM</code> or OpImageBlockMatchSSDQCOM is used to read from a reference image as result of this command, then the specified reference coordinates <strong class=\"purple\">must</strong> not fail <a href=\"#textures-integer-coordinate-validation\">integer texel coordinate validation</a>."
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-OpImageWeightedSampleQCOM-06977",
|
|
"text": " If <code>OpImageWeightedSampleQCOM</code>, <code>OpImageBoxFilterQCOM</code>, <code>OpImageBlockMatchSSDQCOM</code>, or <code>OpImageBlockMatchSADQCOM</code> uses a <a href=\"#VkSampler\">VkSampler</a> as a result of this command, then the sampler <strong class=\"purple\">must</strong> have been created with <code>VK_SAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-OpImageWeightedSampleQCOM-06978",
|
|
"text": " If any command other than <code>OpImageWeightedSampleQCOM</code>, <code>OpImageBoxFilterQCOM</code>, <code>OpImageBlockMatchSSDQCOM</code>, or <code>OpImageBlockMatchSADQCOM</code> uses a <a href=\"#VkSampler\">VkSampler</a> as a result of this command, then the sampler <strong class=\"purple\">must</strong> not have been created with <code>VK_SAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM</code>."
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)+(VK_VERSION_1_1,VK_KHR_multiview)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-maxMultiviewInstanceIndex-02688",
|
|
"text": " If the draw is recorded in a render pass instance with multiview enabled, the maximum instance index <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#VkPhysicalDeviceMultiviewProperties\">VkPhysicalDeviceMultiviewProperties</a>::<code>maxMultiviewInstanceIndex</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)+(VK_EXT_sample_locations)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-sampleLocationsEnable-02689",
|
|
"text": " If the bound graphics pipeline was created with <a href=\"#VkPipelineSampleLocationsStateCreateInfoEXT\">VkPipelineSampleLocationsStateCreateInfoEXT</a>::<code>sampleLocationsEnable</code> set to <code>VK_TRUE</code> and the current subpass has a depth/stencil attachment, then that attachment <strong class=\"purple\">must</strong> have been created with the <code>VK_IMAGE_CREATE_SAMPLE_LOCATIONS_COMPATIBLE_DEPTH_BIT_EXT</code> bit set"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-None-06666",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_SAMPLE_LOCATIONS_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetSampleLocationsEXT\">vkCmdSetSampleLocationsEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command"
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-viewportCount-03417",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, but not the <code>VK_DYNAMIC_STATE_SCISSOR_WITH_COUNT</code> dynamic state enabled, then <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>viewportCount</code> parameter of <code>vkCmdSetViewportWithCount</code> <strong class=\"purple\">must</strong> match the <code>VkPipelineViewportStateCreateInfo</code>::<code>scissorCount</code> of the pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-scissorCount-03418",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_SCISSOR_WITH_COUNT</code> dynamic state enabled, but not the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, then <a href=\"#vkCmdSetScissorWithCount\">vkCmdSetScissorWithCount</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>scissorCount</code> parameter of <code>vkCmdSetScissorWithCount</code> <strong class=\"purple\">must</strong> match the <code>VkPipelineViewportStateCreateInfo</code>::<code>viewportCount</code> of the pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-viewportCount-03419",
|
|
"text": " If the bound graphics pipeline state was created with both the <code>VK_DYNAMIC_STATE_SCISSOR_WITH_COUNT</code> and <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic states enabled then both <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a> and <a href=\"#vkCmdSetScissorWithCount\">vkCmdSetScissorWithCount</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>viewportCount</code> parameter of <code>vkCmdSetViewportWithCount</code> <strong class=\"purple\">must</strong> match the <code>scissorCount</code> parameter of <code>vkCmdSetScissorWithCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-primitiveTopology-03420",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_PRIMITIVE_TOPOLOGY_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetPrimitiveTopologyEXT\">vkCmdSetPrimitiveTopologyEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>primitiveTopology</code> parameter of <code>vkCmdSetPrimitiveTopologyEXT</code> <strong class=\"purple\">must</strong> be of the same <a href=\"#drawing-primitive-topology-class\">topology class</a> as the pipeline <a href=\"#VkPipelineInputAssemblyStateCreateInfo\">VkPipelineInputAssemblyStateCreateInfo</a>::<code>topology</code> state"
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_NV_clip_space_w_scaling)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-viewportCount-04137",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, but not the <code>VK_DYNAMIC_STATE_VIEWPORT_W_SCALING_NV</code> dynamic state enabled, then the bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <a href=\"#VkPipelineViewportWScalingStateCreateInfoNV\">VkPipelineViewportWScalingStateCreateInfoNV</a>::<code>viewportCount</code> greater or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-viewportCount-04138",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> and <code>VK_DYNAMIC_STATE_VIEWPORT_W_SCALING_NV</code> dynamic states enabled then the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWScalingNV\">vkCmdSetViewportWScalingNV</a> <strong class=\"purple\">must</strong> be greater than or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_NV_shading_rate_image)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-viewportCount-04139",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, but not the <code>VK_DYNAMIC_STATE_VIEWPORT_SHADING_RATE_PALETTE_NV</code> dynamic state enabled, then the bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <a href=\"#VkPipelineViewportShadingRateImageStateCreateInfoNV\">VkPipelineViewportShadingRateImageStateCreateInfoNV</a>::<code>viewportCount</code> greater or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-viewportCount-04140",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> and <code>VK_DYNAMIC_STATE_VIEWPORT_SHADING_RATE_PALETTE_NV</code> dynamic states enabled then the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportShadingRatePaletteNV\">vkCmdSetViewportShadingRatePaletteNV</a> <strong class=\"purple\">must</strong> be greater than or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_NV_viewport_swizzle)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-VkPipelineVieportCreateInfo-04141",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled and a <a href=\"#VkPipelineViewportSwizzleStateCreateInfoNV\">VkPipelineViewportSwizzleStateCreateInfoNV</a> structure chained from <code>VkPipelineVieportCreateInfo</code>, then the bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <a href=\"#VkPipelineViewportSwizzleStateCreateInfoNV\">VkPipelineViewportSwizzleStateCreateInfoNV</a>::<code>viewportCount</code> greater or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_NV_scissor_exclusive)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-VkPipelineVieportCreateInfo-04142",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled and a <a href=\"#VkPipelineViewportExclusiveScissorStateCreateInfoNV\">VkPipelineViewportExclusiveScissorStateCreateInfoNV</a> structure chained from <code>VkPipelineVieportCreateInfo</code>, then the bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <a href=\"#VkPipelineViewportExclusiveScissorStateCreateInfoNV\">VkPipelineViewportExclusiveScissorStateCreateInfoNV</a>::<code>exclusiveScissorCount</code> greater or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-None-04876",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_RASTERIZER_DISCARD_ENABLE</code> dynamic state enabled then <a href=\"#vkCmdSetRasterizerDiscardEnable\">vkCmdSetRasterizerDiscardEnable</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-None-04877",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_DEPTH_BIAS_ENABLE</code> dynamic state enabled then <a href=\"#vkCmdSetDepthBiasEnable\">vkCmdSetDepthBiasEnable</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-logicOp-04878",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_LOGIC_OP_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetLogicOpEXT\">vkCmdSetLogicOpEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command and the <code>logicOp</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkLogicOp\">VkLogicOp</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-None-04875",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_PATCH_CONTROL_POINTS_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetPatchControlPointsEXT\">vkCmdSetPatchControlPointsEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-None-04879",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_PRIMITIVE_RESTART_ENABLE_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetPrimitiveRestartEnableEXT\">vkCmdSetPrimitiveRestartEnableEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command"
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)+(VK_KHR_fragment_shading_rate)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-primitiveFragmentShadingRateWithMultipleViewports-04552",
|
|
"text": " If the <a href=\"#limits-primitiveFragmentShadingRateWithMultipleViewports\"><code>primitiveFragmentShadingRateWithMultipleViewports</code></a> limit is not supported, the bound graphics pipeline was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, and any of the shader stages of the bound graphics pipeline write to the <code>PrimitiveShadingRateKHR</code> built-in, then <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>viewportCount</code> parameter of <code>vkCmdSetViewportWithCount</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-imageView-06172",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pDepthAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pDepthAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the depth attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-imageView-06173",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pStencilAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pStencilAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the stencil attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-viewMask-06178",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound graphics pipeline <strong class=\"purple\">must</strong> have been created with a <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>viewMask</code> equal to <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>viewMask</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-colorAttachmentCount-06179",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound graphics pipeline <strong class=\"purple\">must</strong> have been created with a <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>colorAttachmentCount</code> equal to <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>colorAttachmentCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-colorAttachmentCount-06180",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>colorAttachmentCount</code> greater than <code>0</code>, then each element of the <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pColorAttachments</code> array with a <code>imageView</code> not equal to <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> <strong class=\"purple\">must</strong> have been created with a <a href=\"#VkFormat\">VkFormat</a> equal to the corresponding element of <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>pColorAttachmentFormats</code> used to create the currently bound graphics pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-pDepthAttachment-06181",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>depthAttachmentFormat</code> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the <a href=\"#VkFormat\">VkFormat</a> used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-pStencilAttachment-06182",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>stencilAttachmentFormat</code> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the <a href=\"#VkFormat\">VkFormat</a> used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_VERSION_1_1,VK_KHR_maintenance2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-imageView-06174",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pDepthAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pDepthAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_STENCIL_ATTACHMENT_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the depth attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-imageView-06175",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pStencilAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pStencilAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_STENCIL_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the stencil attachment"
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_VERSION_1_2,VK_KHR_separate_depth_stencil_layouts)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-imageView-06176",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pDepthAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pDepthAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the depth attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-imageView-06177",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pStencilAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pStencilAttachment</code> is <code>VK_IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the stencil attachment"
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_EXT_color_write_enable)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-attachmentCount-06667",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_COLOR_WRITE_ENABLE_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetColorWriteEnableEXT\">vkCmdSetColorWriteEnableEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>attachmentCount</code> parameter of <code>vkCmdSetColorWriteEnableEXT</code> <strong class=\"purple\">must</strong> be greater than or equal to the <code>VkPipelineColorBlendStateCreateInfo</code>::<code>attachmentCount</code> of the currently bound graphics pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-attachmentCount-06815",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_COLOR_WRITE_ENABLE_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetColorWriteEnableEXT\">vkCmdSetColorWriteEnableEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>attachmentCount</code> parameter of <code>vkCmdSetColorWriteEnableEXT</code> <strong class=\"purple\">must</strong> be less than or equal to the <code>maxColorAttachments</code> member of <code>VkPhysicalDeviceLimits</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_KHR_fragment_shading_rate)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-imageView-06183",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingFragmentShadingRateAttachmentInfoKHR\">VkRenderingFragmentShadingRateAttachmentInfoKHR</a>::<code>imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the currently bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <code>VK_PIPELINE_CREATE_RENDERING_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_EXT_fragment_density_map)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-imageView-06184",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingFragmentDensityMapAttachmentInfoEXT\">VkRenderingFragmentDensityMapAttachmentInfoEXT</a>::<code>imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the currently bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <code>VK_PIPELINE_CREATE_RENDERING_FRAGMENT_DENSITY_MAP_ATTACHMENT_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_AMD_mixed_attachment_samples,VK_NV_framebuffer_mixed_samples)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-colorAttachmentCount-06185",
|
|
"text": " If the currently bound pipeline was created with a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> with a <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>colorAttachmentCount</code> parameter greater than <code>0</code>, then each element of the <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pColorAttachments</code> array with a <code>imageView</code> not equal to <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> <strong class=\"purple\">must</strong> have been created with a sample count equal to the corresponding element of the <code>pColorAttachmentSamples</code> member of <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> used to create the currently bound graphics pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-pDepthAttachment-06186",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline was created with a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of the <code>depthStencilAttachmentSamples</code> member of <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the sample count used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-pStencilAttachment-06187",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline was created with a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of the <code>depthStencilAttachmentSamples</code> member of <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the sample count used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-colorAttachmentCount-06188",
|
|
"text": " If the currently bound pipeline was created without a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> with a <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>colorAttachmentCount</code> parameter greater than <code>0</code>, then each element of the <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pColorAttachments</code> array with a <code>imageView</code> not equal to <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> <strong class=\"purple\">must</strong> have been created with a sample count equal to the value of <a href=\"#VkPipelineMultisampleStateCreateInfo\">VkPipelineMultisampleStateCreateInfo</a>::<code>rasterizationSamples</code> used to create the currently bound graphics pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-pDepthAttachment-06189",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline was created without a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of <a href=\"#VkPipelineMultisampleStateCreateInfo\">VkPipelineMultisampleStateCreateInfo</a>::<code>rasterizationSamples</code> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the sample count used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-pStencilAttachment-06190",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline was created without a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of <a href=\"#VkPipelineMultisampleStateCreateInfo\">VkPipelineMultisampleStateCreateInfo</a>::<code>rasterizationSamples</code> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the sample count used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-renderPass-06198",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline <strong class=\"purple\">must</strong> have been created with a <a href=\"#VkGraphicsPipelineCreateInfo\">VkGraphicsPipelineCreateInfo</a>::<code>renderPass</code> equal to <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)+(VK_EXT_primitives_generated_query)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-primitivesGeneratedQueryWithRasterizerDiscard-06708",
|
|
"text": " If the <a href=\"#features-primitivesGeneratedQueryWithRasterizerDiscard\"><code>primitivesGeneratedQueryWithRasterizerDiscard</code></a> feature is not enabled and the <code>VK_QUERY_TYPE_PRIMITIVES_GENERATED_EXT</code> query is active, <a href=\"#primsrast-discard\">rasterization discard</a> <strong class=\"purple\">must</strong> not be enabled."
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)+(VK_EXT_primitives_generated_query)+(VK_EXT_transform_feedback)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-primitivesGeneratedQueryWithNonZeroStreams-06709",
|
|
"text": " If the <a href=\"#features-primitivesGeneratedQueryWithNonZeroStreams\"><code>primitivesGeneratedQueryWithNonZeroStreams</code></a> feature is not enabled and the <code>VK_QUERY_TYPE_PRIMITIVES_GENERATED_EXT</code> query is active, the bound graphics pipeline <strong class=\"purple\">must</strong> not have been created with a non-zero value in <code>VkPipelineRasterizationStateStreamCreateInfoEXT</code>::<code>rasterizationStream</code>."
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_EXT_vertex_input_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-None-04912",
|
|
"text": " If the bound graphics pipeline was created with both the <code>VK_DYNAMIC_STATE_VERTEX_INPUT_EXT</code> and <code>VK_DYNAMIC_STATE_VERTEX_INPUT_BINDING_STRIDE_EXT</code> dynamic states enabled, then <a href=\"#vkCmdSetVertexInputEXT\">vkCmdSetVertexInputEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this draw command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-pStrides-04913",
|
|
"text": " If the bound graphics pipeline was created with the <code>VK_DYNAMIC_STATE_VERTEX_INPUT_BINDING_STRIDE_EXT</code> dynamic state enabled, but not the <code>VK_DYNAMIC_STATE_VERTEX_INPUT_EXT</code> dynamic state enabled, then <a href=\"#vkCmdBindVertexBuffers2EXT\">vkCmdBindVertexBuffers2EXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this draw command, and the <code>pStrides</code> parameter of <a href=\"#vkCmdBindVertexBuffers2EXT\">vkCmdBindVertexBuffers2EXT</a> <strong class=\"purple\">must</strong> not be <code>NULL</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+!(VK_EXT_vertex_input_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-pStrides-04884",
|
|
"text": " If the bound graphics pipeline was created with the <code>VK_DYNAMIC_STATE_VERTEX_INPUT_BINDING_STRIDE_EXT</code> dynamic state enabled, then <a href=\"#vkCmdBindVertexBuffers2EXT\">vkCmdBindVertexBuffers2EXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>pStrides</code> parameter of <a href=\"#vkCmdBindVertexBuffers2EXT\">vkCmdBindVertexBuffers2EXT</a> <strong class=\"purple\">must</strong> not be <code>NULL</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)+(VK_EXT_vertex_input_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-None-04914",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VERTEX_INPUT_EXT</code> dynamic state enabled, then <a href=\"#vkCmdSetVertexInputEXT\">vkCmdSetVertexInputEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this draw command"
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)+(VK_NV_mesh_shader)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawIndirectByteCountEXT-stage-06481",
|
|
"text": " The bound graphics pipeline <strong class=\"purple\">must</strong> not have been created with the <a href=\"#VkPipelineShaderStageCreateInfo\">VkPipelineShaderStageCreateInfo</a>::<code>stage</code> member of an element of <a href=\"#VkGraphicsPipelineCreateInfo\">VkGraphicsPipelineCreateInfo</a>::<code>pStages</code> set to <code>VK_SHADER_STAGE_TASK_BIT_NV</code> or <code>VK_SHADER_STAGE_MESH_BIT_NV</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdBeginConditionalRenderingEXT": {
|
|
"(VK_EXT_conditional_rendering)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBeginConditionalRenderingEXT-None-01980",
|
|
"text": " Conditional rendering <strong class=\"purple\">must</strong> not already be <a href=\"#active-conditional-rendering\">active</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginConditionalRenderingEXT-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginConditionalRenderingEXT-pConditionalRenderingBegin-parameter",
|
|
"text": " <code>pConditionalRenderingBegin</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkConditionalRenderingBeginInfoEXT\">VkConditionalRenderingBeginInfoEXT</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginConditionalRenderingEXT-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginConditionalRenderingEXT-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics, or compute operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginConditionalRenderingEXT-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
]
|
|
},
|
|
"VkConditionalRenderingBeginInfoEXT": {
|
|
"(VK_EXT_conditional_rendering)": [
|
|
{
|
|
"vuid": "VUID-VkConditionalRenderingBeginInfoEXT-buffer-01981",
|
|
"text": " If <code>buffer</code> is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkConditionalRenderingBeginInfoEXT-buffer-01982",
|
|
"text": " <code>buffer</code> <strong class=\"purple\">must</strong> have been created with the <code>VK_BUFFER_USAGE_CONDITIONAL_RENDERING_BIT_EXT</code> bit set"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkConditionalRenderingBeginInfoEXT-offset-01983",
|
|
"text": " <code>offset</code> <strong class=\"purple\">must</strong> be less than the size of <code>buffer</code> by at least 32 bits"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkConditionalRenderingBeginInfoEXT-offset-01984",
|
|
"text": " <code>offset</code> <strong class=\"purple\">must</strong> be a multiple of 4"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkConditionalRenderingBeginInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_CONDITIONAL_RENDERING_BEGIN_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkConditionalRenderingBeginInfoEXT-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkConditionalRenderingBeginInfoEXT-buffer-parameter",
|
|
"text": " <code>buffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBuffer\">VkBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkConditionalRenderingBeginInfoEXT-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkConditionalRenderingFlagBitsEXT\">VkConditionalRenderingFlagBitsEXT</a> values"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdEndConditionalRenderingEXT": {
|
|
"(VK_EXT_conditional_rendering)": [
|
|
{
|
|
"vuid": "VUID-vkCmdEndConditionalRenderingEXT-None-01985",
|
|
"text": " Conditional rendering <strong class=\"purple\">must</strong> be <a href=\"#active-conditional-rendering\">active</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndConditionalRenderingEXT-None-01986",
|
|
"text": " If conditional rendering was made <a href=\"#active-conditional-rendering\">active</a> outside of a render pass instance, it <strong class=\"purple\">must</strong> not be ended inside a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndConditionalRenderingEXT-None-01987",
|
|
"text": " If conditional rendering was made <a href=\"#active-conditional-rendering\">active</a> within a subpass it <strong class=\"purple\">must</strong> be ended in the same subpass"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndConditionalRenderingEXT-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndConditionalRenderingEXT-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndConditionalRenderingEXT-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics, or compute operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndConditionalRenderingEXT-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdDrawMeshTasksNV": {
|
|
"(VK_NV_mesh_shader)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-magFilter-04553",
|
|
"text": " If a <a href=\"#VkSampler\">VkSampler</a> created with <code>magFilter</code> or <code>minFilter</code> equal to <code>VK_FILTER_LINEAR</code> and <code>compareEnable</code> equal to <code>VK_FALSE</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-mipmapMode-04770",
|
|
"text": " If a <a href=\"#VkSampler\">VkSampler</a> created with <code>mipmapMode</code> equal to <code>VK_SAMPLER_MIPMAP_MODE_LINEAR</code> and <code>compareEnable</code> equal to <code>VK_FALSE</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-None-02691",
|
|
"text": " If a <code>VkImageView</code> is accessed using atomic operations as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_STORAGE_IMAGE_ATOMIC_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-None-02697",
|
|
"text": " For each set <em>n</em> that is statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command, a descriptor set <strong class=\"purple\">must</strong> have been bound to <em>n</em> at the same pipeline bind point, with a <code>VkPipelineLayout</code> that is compatible for set <em>n</em>, with the <code>VkPipelineLayout</code> used to create the current <code>VkPipeline</code>, as described in <a href=\"#descriptorsets-compatibility\">Pipeline Layout Compatibility</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-None-02699",
|
|
"text": " Descriptors in each bound descriptor set, specified via <code>vkCmdBindDescriptorSets</code>, <strong class=\"purple\">must</strong> be valid if they are statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-None-02700",
|
|
"text": " A valid pipeline <strong class=\"purple\">must</strong> be bound to the pipeline bind point used by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-commandBuffer-02701",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command requires any dynamic state, that state <strong class=\"purple\">must</strong> have been set or inherited (if the <code><a href=\"#VK_NV_inherited_viewport_scissor\">VK_NV_inherited_viewport_scissor</a></code> extension is enabled) for <code>commandBuffer</code>, and done so after any previously bound pipeline with the corresponding state not specified as dynamic"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-None-02859",
|
|
"text": " There <strong class=\"purple\">must</strong> not have been any calls to dynamic state setting commands for any state not specified as dynamic in the <code>VkPipeline</code> object bound to the pipeline bind point used by this command, since that pipeline was bound"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-None-02702",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> object that uses unnormalized coordinates, that sampler <strong class=\"purple\">must</strong> not be used to sample from any <code>VkImage</code> with a <code>VkImageView</code> of the type <code>VK_IMAGE_VIEW_TYPE_3D</code>, <code>VK_IMAGE_VIEW_TYPE_CUBE</code>, <code>VK_IMAGE_VIEW_TYPE_1D_ARRAY</code>, <code>VK_IMAGE_VIEW_TYPE_2D_ARRAY</code> or <code>VK_IMAGE_VIEW_TYPE_CUBE_ARRAY</code>, in any shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-None-02703",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> object that uses unnormalized coordinates, that sampler <strong class=\"purple\">must</strong> not be used with any of the SPIR-V <code>OpImageSample*</code> or <code>OpImageSparseSample*</code> instructions with <code>ImplicitLod</code>, <code>Dref</code> or <code>Proj</code> in their name, in any shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-None-02704",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> object that uses unnormalized coordinates, that sampler <strong class=\"purple\">must</strong> not be used with any of the SPIR-V <code>OpImageSample*</code> or <code>OpImageSparseSample*</code> instructions that includes a LOD bias or any offset values, in any shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-None-04115",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> is accessed using <code>OpImageWrite</code> as a result of this command, then the <code>Type</code> of the <code>Texel</code> operand of that instruction <strong class=\"purple\">must</strong> have at least as many components as the image view’s format"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-OpImageWrite-04469",
|
|
"text": " If a <a href=\"#VkBufferView\">VkBufferView</a> is accessed using <code>OpImageWrite</code> as a result of this command, then the <code>Type</code> of the <code>Texel</code> operand of that instruction <strong class=\"purple\">must</strong> have at least as many components as the buffer view’s format"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-renderPass-02684",
|
|
"text": " The current render pass <strong class=\"purple\">must</strong> be <a href=\"#renderpass-compatibility\">compatible</a> with the <code>renderPass</code> member of the <code>VkGraphicsPipelineCreateInfo</code> structure specified when creating the <code>VkPipeline</code> bound to <code>VK_PIPELINE_BIND_POINT_GRAPHICS</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-subpass-02685",
|
|
"text": " The subpass index of the current render pass <strong class=\"purple\">must</strong> be equal to the <code>subpass</code> member of the <code>VkGraphicsPipelineCreateInfo</code> structure specified when creating the <code>VkPipeline</code> bound to <code>VK_PIPELINE_BIND_POINT_GRAPHICS</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-None-02686",
|
|
"text": " Every input attachment used by the current subpass <strong class=\"purple\">must</strong> be bound to the pipeline via a descriptor set"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-None-06537",
|
|
"text": " Memory backing image subresources used as attachments in the current render pass <strong class=\"purple\">must</strong> not be written in any way other than as an attachment by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-None-06538",
|
|
"text": " If any recorded command in the current subpass will write to an image subresource as an attachment, this command <strong class=\"purple\">must</strong> not read from the memory backing that image subresource in any other way than as an attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-None-06539",
|
|
"text": " If any recorded command in the current subpass will read from an image subresource used as an attachment in any way other than as an attachment, this command <strong class=\"purple\">must</strong> not write to that image subresource as an attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-None-06886",
|
|
"text": " If the current render pass instance uses a depth/stencil attachment with a read-only layout for the depth aspect, <a href=\"#fragops-depth-write\">depth writes</a> <strong class=\"purple\">must</strong> be disabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-None-06887",
|
|
"text": " If the current render pass instance uses a depth/stencil attachment with a read-only layout for the stencil aspect and stencil test is enabled, <a href=\"#fragops-stencil\">all stencil ops</a> <strong class=\"purple\">must</strong> be <code>VK_STENCIL_OP_KEEP</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-blendEnable-04727",
|
|
"text": " If rasterization is not disabled in the bound graphics pipeline, then for each color attachment in the subpass, if the corresponding image view’s <a href=\"#resources-image-view-format-features\">format features</a> do not contain <code>VK_FORMAT_FEATURE_COLOR_ATTACHMENT_BLEND_BIT</code>, then the <code>blendEnable</code> member of the corresponding element of the <code>pAttachments</code> member of <code>pColorBlendState</code> <strong class=\"purple\">must</strong> be <code>VK_FALSE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-rasterizationSamples-04740",
|
|
"text": " If rasterization is not disabled in the bound graphics pipeline, and neither the <code><a href=\"#VK_AMD_mixed_attachment_samples\">VK_AMD_mixed_attachment_samples</a></code> nor the <code><a href=\"#VK_NV_framebuffer_mixed_samples\">VK_NV_framebuffer_mixed_samples</a></code> extensions are enabled, then <a href=\"#VkPipelineMultisampleStateCreateInfo\">VkPipelineMultisampleStateCreateInfo</a>::<code>rasterizationSamples</code> <strong class=\"purple\">must</strong> be the same as the current subpass color and/or depth/stencil attachments"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-taskCount-02119",
|
|
"text": " <code>taskCount</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceMeshShaderPropertiesNV</code>::<code>maxDrawMeshTasksCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called inside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+!(VK_VERSION_1_3,VK_KHR_format_feature_flags2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-aspectMask-06478",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> is sampled with <a href=\"#textures-depth-compare-operation\">depth comparison</a>, the image view <strong class=\"purple\">must</strong> have been created with an <code>aspectMask</code> that contains <code>VK_IMAGE_ASPECT_DEPTH_BIT</code>."
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_VERSION_1_3,VK_KHR_format_feature_flags2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-None-06479",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> is sampled with <a href=\"#textures-depth-compare-operation\">depth comparison</a>, the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_SAMPLED_IMAGE_DEPTH_COMPARISON_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-OpTypeImage-06423",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> or <a href=\"#VkBufferView\">VkBufferView</a> being written as a storage image or storage texel buffer where the image format field of the <code>OpTypeImage</code> is <code>Unknown</code> then the view’s format feature <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_STORAGE_WRITE_WITHOUT_FORMAT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-OpTypeImage-06424",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> or <a href=\"#VkBufferView\">VkBufferView</a> being read as a storage image or storage texel buffer where the image format field of the <code>OpTypeImage</code> is <code>Unknown</code> then the view’s format feature <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_STORAGE_READ_WITHOUT_FORMAT_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_IMG_filter_cubic,VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-None-02692",
|
|
"text": " If a <code>VkImageView</code> is sampled with <code>VK_FILTER_CUBIC_EXT</code> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_CUBIC_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_IMG_filter_cubic,VK_EXT_filter_cubic)+!(VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-None-02693",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> being sampled with <code>VK_FILTER_CUBIC_EXT</code> as a result of this command <strong class=\"purple\">must</strong> not have a <a href=\"#VkImageViewType\">VkImageViewType</a> of <code>VK_IMAGE_VIEW_TYPE_3D</code>, <code>VK_IMAGE_VIEW_TYPE_CUBE</code>, or <code>VK_IMAGE_VIEW_TYPE_CUBE_ARRAY</code>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_IMG_filter_cubic,VK_EXT_filter_cubic)+(VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-filterCubic-02694",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> being sampled with <code>VK_FILTER_CUBIC_EXT</code> as a result of this command <strong class=\"purple\">must</strong> have a <a href=\"#VkImageViewType\">VkImageViewType</a> and format that supports cubic filtering, as specified by <code>VkFilterCubicImageViewImageFormatPropertiesEXT</code>::<code>filterCubic</code> returned by <code>vkGetPhysicalDeviceImageFormatProperties2</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-filterCubicMinmax-02695",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> being sampled with <code>VK_FILTER_CUBIC_EXT</code> with a reduction mode of either <code>VK_SAMPLER_REDUCTION_MODE_MIN</code> or <code>VK_SAMPLER_REDUCTION_MODE_MAX</code> as a result of this command <strong class=\"purple\">must</strong> have a <a href=\"#VkImageViewType\">VkImageViewType</a> and format that supports cubic filtering together with minmax filtering, as specified by <code>VkFilterCubicImageViewImageFormatPropertiesEXT</code>::<code>filterCubicMinmax</code> returned by <code>vkGetPhysicalDeviceImageFormatProperties2</code>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_NV_corner_sampled_image)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-flags-02696",
|
|
"text": " Any <a href=\"#VkImage\">VkImage</a> created with a <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a>::<code>flags</code> containing <code>VK_IMAGE_CREATE_CORNER_SAMPLED_BIT_NV</code> sampled as a result of this command <strong class=\"purple\">must</strong> only be sampled using a <a href=\"#VkSamplerAddressMode\">VkSamplerAddressMode</a> of <code>VK_SAMPLER_ADDRESS_MODE_CLAMP_TO_EDGE</code>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+!(VK_VERSION_1_3,VK_KHR_maintenance4)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-None-02698",
|
|
"text": " For each push constant that is statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command, a push constant value <strong class=\"purple\">must</strong> have been set for the same pipeline bind point, with a <code>VkPipelineLayout</code> that is compatible for push constants, with the <code>VkPipelineLayout</code> used to create the current <code>VkPipeline</code>, as described in <a href=\"#descriptorsets-compatibility\">Pipeline Layout Compatibility</a>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_VERSION_1_3,VK_KHR_maintenance4)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-maintenance4-06425",
|
|
"text": " If the <a href=\"#features-maintenance4\"><code>maintenance4</code></a> feature is not enabled, then for each push constant that is statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command, a push constant value <strong class=\"purple\">must</strong> have been set for the same pipeline bind point, with a <code>VkPipelineLayout</code> that is compatible for push constants, with the <code>VkPipelineLayout</code> used to create the current <code>VkPipeline</code>, as described in <a href=\"#descriptorsets-compatibility\">Pipeline Layout Compatibility</a>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+!(VK_EXT_pipeline_robustness)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-None-02705",
|
|
"text": " If the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, and if the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a uniform buffer, it <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-None-02706",
|
|
"text": " If the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, and if the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a storage buffer, it <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_EXT_pipeline_robustness)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-uniformBuffers-06935",
|
|
"text": " If any stage of the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a uniform buffer, and that stage was created without enabling either <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_EXT</code> or <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXT</code> for <code>uniformBuffers</code>, and the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, that stage <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-storageBuffers-06936",
|
|
"text": " If any stage of the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a storage buffer, and that stage was created without enabling either <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_EXT</code> or <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXT</code> for <code>storageBuffers</code>, and the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, that stage <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-commandBuffer-02707",
|
|
"text": " If <code>commandBuffer</code> is an unprotected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, any resource accessed by the <a href=\"#VkPipeline\">VkPipeline</a> object bound to the pipeline bind point used by this command <strong class=\"purple\">must</strong> not be a protected resource"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-None-06550",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> or <code>VkImageView</code> object that enables <a href=\"#samplers-YCbCr-conversion\">sampler {YCbCr} conversion</a>, that object <strong class=\"purple\">must</strong> only be used with <code>OpImageSample*</code> or <code>OpImageSparseSample*</code> instructions"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-ConstOffset-06551",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> or <code>VkImageView</code> object that enables <a href=\"#samplers-YCbCr-conversion\">sampler {YCbCr} conversion</a>, that object <strong class=\"purple\">must</strong> not use the <code>ConstOffset</code> and <code>Offset</code> operands"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_EXT_shader_image_atomic_int64)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-SampledType-04470",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a 64-bit component width is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 64"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-SampledType-04471",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a component width less than 64-bit is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 32"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-SampledType-04472",
|
|
"text": " If a <a href=\"#VkBufferView\">VkBufferView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a 64-bit component width is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 64"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-SampledType-04473",
|
|
"text": " If a <a href=\"#VkBufferView\">VkBufferView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a component width less than 64-bit is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 32"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-sparseImageInt64Atomics-04474",
|
|
"text": " If the <a href=\"#features-sparseImageInt64Atomics\"><code>sparseImageInt64Atomics</code></a> feature is not enabled, <a href=\"#VkImage\">VkImage</a> objects created with the <code>VK_IMAGE_CREATE_SPARSE_RESIDENCY_BIT</code> flag <strong class=\"purple\">must</strong> not be accessed by atomic instructions through an <code>OpTypeImage</code> with a <code>SampledType</code> with a <code>Width</code> of 64 by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-sparseImageInt64Atomics-04475",
|
|
"text": " If the <a href=\"#features-sparseImageInt64Atomics\"><code>sparseImageInt64Atomics</code></a> feature is not enabled, <a href=\"#VkBuffer\">VkBuffer</a> objects created with the <code>VK_BUFFER_CREATE_SPARSE_RESIDENCY_BIT</code> flag <strong class=\"purple\">must</strong> not be accessed by atomic instructions through an <code>OpTypeImage</code> with a <code>SampledType</code> with a <code>Width</code> of 64 by this command"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_QCOM_image_processing)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-OpImageWeightedSampleQCOM-06971",
|
|
"text": " If <code>OpImageWeightedSampleQCOM</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_WEIGHT_SAMPLED_IMAGE_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-OpImageWeightedSampleQCOM-06972",
|
|
"text": " If <code>OpImageWeightedSampleQCOM</code> uses a <a href=\"#VkImageView\">VkImageView</a> as a sample weight image as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_WEIGHT_IMAGE_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-OpImageBoxFilterQCOM-06973",
|
|
"text": " If <code>OpImageBoxFilterQCOM</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_BOX_FILTER_SAMPLED_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-OpImageBlockMatchSSDQCOM-06974",
|
|
"text": " If <code>OpImageBlockMatchSSDQCOM</code> is used to read from an <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-OpImageBlockMatchSADQCOM-06975",
|
|
"text": " If <code>OpImageBlockMatchSADQCOM</code> is used to read from an <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-OpImageBlockMatchSADQCOM-06976",
|
|
"text": " If <code>OpImageBlockMatchSADQCOM</code> or OpImageBlockMatchSSDQCOM is used to read from a reference image as result of this command, then the specified reference coordinates <strong class=\"purple\">must</strong> not fail <a href=\"#textures-integer-coordinate-validation\">integer texel coordinate validation</a>."
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-OpImageWeightedSampleQCOM-06977",
|
|
"text": " If <code>OpImageWeightedSampleQCOM</code>, <code>OpImageBoxFilterQCOM</code>, <code>OpImageBlockMatchSSDQCOM</code>, or <code>OpImageBlockMatchSADQCOM</code> uses a <a href=\"#VkSampler\">VkSampler</a> as a result of this command, then the sampler <strong class=\"purple\">must</strong> have been created with <code>VK_SAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-OpImageWeightedSampleQCOM-06978",
|
|
"text": " If any command other than <code>OpImageWeightedSampleQCOM</code>, <code>OpImageBoxFilterQCOM</code>, <code>OpImageBlockMatchSSDQCOM</code>, or <code>OpImageBlockMatchSADQCOM</code> uses a <a href=\"#VkSampler\">VkSampler</a> as a result of this command, then the sampler <strong class=\"purple\">must</strong> not have been created with <code>VK_SAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM</code>."
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_VERSION_1_1,VK_KHR_multiview)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-maxMultiviewInstanceIndex-02688",
|
|
"text": " If the draw is recorded in a render pass instance with multiview enabled, the maximum instance index <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#VkPhysicalDeviceMultiviewProperties\">VkPhysicalDeviceMultiviewProperties</a>::<code>maxMultiviewInstanceIndex</code>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_EXT_sample_locations)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-sampleLocationsEnable-02689",
|
|
"text": " If the bound graphics pipeline was created with <a href=\"#VkPipelineSampleLocationsStateCreateInfoEXT\">VkPipelineSampleLocationsStateCreateInfoEXT</a>::<code>sampleLocationsEnable</code> set to <code>VK_TRUE</code> and the current subpass has a depth/stencil attachment, then that attachment <strong class=\"purple\">must</strong> have been created with the <code>VK_IMAGE_CREATE_SAMPLE_LOCATIONS_COMPATIBLE_DEPTH_BIT_EXT</code> bit set"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-None-06666",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_SAMPLE_LOCATIONS_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetSampleLocationsEXT\">vkCmdSetSampleLocationsEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-viewportCount-03417",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, but not the <code>VK_DYNAMIC_STATE_SCISSOR_WITH_COUNT</code> dynamic state enabled, then <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>viewportCount</code> parameter of <code>vkCmdSetViewportWithCount</code> <strong class=\"purple\">must</strong> match the <code>VkPipelineViewportStateCreateInfo</code>::<code>scissorCount</code> of the pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-scissorCount-03418",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_SCISSOR_WITH_COUNT</code> dynamic state enabled, but not the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, then <a href=\"#vkCmdSetScissorWithCount\">vkCmdSetScissorWithCount</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>scissorCount</code> parameter of <code>vkCmdSetScissorWithCount</code> <strong class=\"purple\">must</strong> match the <code>VkPipelineViewportStateCreateInfo</code>::<code>viewportCount</code> of the pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-viewportCount-03419",
|
|
"text": " If the bound graphics pipeline state was created with both the <code>VK_DYNAMIC_STATE_SCISSOR_WITH_COUNT</code> and <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic states enabled then both <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a> and <a href=\"#vkCmdSetScissorWithCount\">vkCmdSetScissorWithCount</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>viewportCount</code> parameter of <code>vkCmdSetViewportWithCount</code> <strong class=\"purple\">must</strong> match the <code>scissorCount</code> parameter of <code>vkCmdSetScissorWithCount</code>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_NV_clip_space_w_scaling)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-viewportCount-04137",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, but not the <code>VK_DYNAMIC_STATE_VIEWPORT_W_SCALING_NV</code> dynamic state enabled, then the bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <a href=\"#VkPipelineViewportWScalingStateCreateInfoNV\">VkPipelineViewportWScalingStateCreateInfoNV</a>::<code>viewportCount</code> greater or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-viewportCount-04138",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> and <code>VK_DYNAMIC_STATE_VIEWPORT_W_SCALING_NV</code> dynamic states enabled then the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWScalingNV\">vkCmdSetViewportWScalingNV</a> <strong class=\"purple\">must</strong> be greater than or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_NV_shading_rate_image)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-viewportCount-04139",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, but not the <code>VK_DYNAMIC_STATE_VIEWPORT_SHADING_RATE_PALETTE_NV</code> dynamic state enabled, then the bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <a href=\"#VkPipelineViewportShadingRateImageStateCreateInfoNV\">VkPipelineViewportShadingRateImageStateCreateInfoNV</a>::<code>viewportCount</code> greater or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-viewportCount-04140",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> and <code>VK_DYNAMIC_STATE_VIEWPORT_SHADING_RATE_PALETTE_NV</code> dynamic states enabled then the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportShadingRatePaletteNV\">vkCmdSetViewportShadingRatePaletteNV</a> <strong class=\"purple\">must</strong> be greater than or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_NV_viewport_swizzle)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-VkPipelineVieportCreateInfo-04141",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled and a <a href=\"#VkPipelineViewportSwizzleStateCreateInfoNV\">VkPipelineViewportSwizzleStateCreateInfoNV</a> structure chained from <code>VkPipelineVieportCreateInfo</code>, then the bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <a href=\"#VkPipelineViewportSwizzleStateCreateInfoNV\">VkPipelineViewportSwizzleStateCreateInfoNV</a>::<code>viewportCount</code> greater or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_NV_scissor_exclusive)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-VkPipelineVieportCreateInfo-04142",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled and a <a href=\"#VkPipelineViewportExclusiveScissorStateCreateInfoNV\">VkPipelineViewportExclusiveScissorStateCreateInfoNV</a> structure chained from <code>VkPipelineVieportCreateInfo</code>, then the bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <a href=\"#VkPipelineViewportExclusiveScissorStateCreateInfoNV\">VkPipelineViewportExclusiveScissorStateCreateInfoNV</a>::<code>exclusiveScissorCount</code> greater or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-None-04876",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_RASTERIZER_DISCARD_ENABLE</code> dynamic state enabled then <a href=\"#vkCmdSetRasterizerDiscardEnable\">vkCmdSetRasterizerDiscardEnable</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-None-04877",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_DEPTH_BIAS_ENABLE</code> dynamic state enabled then <a href=\"#vkCmdSetDepthBiasEnable\">vkCmdSetDepthBiasEnable</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-logicOp-04878",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_LOGIC_OP_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetLogicOpEXT\">vkCmdSetLogicOpEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command and the <code>logicOp</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkLogicOp\">VkLogicOp</a> value"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_KHR_fragment_shading_rate)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-primitiveFragmentShadingRateWithMultipleViewports-04552",
|
|
"text": " If the <a href=\"#limits-primitiveFragmentShadingRateWithMultipleViewports\"><code>primitiveFragmentShadingRateWithMultipleViewports</code></a> limit is not supported, the bound graphics pipeline was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, and any of the shader stages of the bound graphics pipeline write to the <code>PrimitiveShadingRateKHR</code> built-in, then <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>viewportCount</code> parameter of <code>vkCmdSetViewportWithCount</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-imageView-06172",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pDepthAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pDepthAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the depth attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-imageView-06173",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pStencilAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pStencilAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the stencil attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-viewMask-06178",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound graphics pipeline <strong class=\"purple\">must</strong> have been created with a <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>viewMask</code> equal to <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>viewMask</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-colorAttachmentCount-06179",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound graphics pipeline <strong class=\"purple\">must</strong> have been created with a <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>colorAttachmentCount</code> equal to <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>colorAttachmentCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-colorAttachmentCount-06180",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>colorAttachmentCount</code> greater than <code>0</code>, then each element of the <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pColorAttachments</code> array with a <code>imageView</code> not equal to <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> <strong class=\"purple\">must</strong> have been created with a <a href=\"#VkFormat\">VkFormat</a> equal to the corresponding element of <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>pColorAttachmentFormats</code> used to create the currently bound graphics pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-pDepthAttachment-06181",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>depthAttachmentFormat</code> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the <a href=\"#VkFormat\">VkFormat</a> used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-pStencilAttachment-06182",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>stencilAttachmentFormat</code> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the <a href=\"#VkFormat\">VkFormat</a> used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_VERSION_1_1,VK_KHR_maintenance2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-imageView-06174",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pDepthAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pDepthAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_STENCIL_ATTACHMENT_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the depth attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-imageView-06175",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pStencilAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pStencilAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_STENCIL_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the stencil attachment"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_VERSION_1_2,VK_KHR_separate_depth_stencil_layouts)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-imageView-06176",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pDepthAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pDepthAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the depth attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-imageView-06177",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pStencilAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pStencilAttachment</code> is <code>VK_IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the stencil attachment"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_EXT_color_write_enable)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-attachmentCount-06667",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_COLOR_WRITE_ENABLE_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetColorWriteEnableEXT\">vkCmdSetColorWriteEnableEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>attachmentCount</code> parameter of <code>vkCmdSetColorWriteEnableEXT</code> <strong class=\"purple\">must</strong> be greater than or equal to the <code>VkPipelineColorBlendStateCreateInfo</code>::<code>attachmentCount</code> of the currently bound graphics pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-attachmentCount-06815",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_COLOR_WRITE_ENABLE_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetColorWriteEnableEXT\">vkCmdSetColorWriteEnableEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>attachmentCount</code> parameter of <code>vkCmdSetColorWriteEnableEXT</code> <strong class=\"purple\">must</strong> be less than or equal to the <code>maxColorAttachments</code> member of <code>VkPhysicalDeviceLimits</code>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_KHR_fragment_shading_rate)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-imageView-06183",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingFragmentShadingRateAttachmentInfoKHR\">VkRenderingFragmentShadingRateAttachmentInfoKHR</a>::<code>imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the currently bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <code>VK_PIPELINE_CREATE_RENDERING_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR</code>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_EXT_fragment_density_map)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-imageView-06184",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingFragmentDensityMapAttachmentInfoEXT\">VkRenderingFragmentDensityMapAttachmentInfoEXT</a>::<code>imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the currently bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <code>VK_PIPELINE_CREATE_RENDERING_FRAGMENT_DENSITY_MAP_ATTACHMENT_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_AMD_mixed_attachment_samples,VK_NV_framebuffer_mixed_samples)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-colorAttachmentCount-06185",
|
|
"text": " If the currently bound pipeline was created with a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> with a <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>colorAttachmentCount</code> parameter greater than <code>0</code>, then each element of the <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pColorAttachments</code> array with a <code>imageView</code> not equal to <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> <strong class=\"purple\">must</strong> have been created with a sample count equal to the corresponding element of the <code>pColorAttachmentSamples</code> member of <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> used to create the currently bound graphics pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-pDepthAttachment-06186",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline was created with a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of the <code>depthStencilAttachmentSamples</code> member of <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the sample count used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-pStencilAttachment-06187",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline was created with a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of the <code>depthStencilAttachmentSamples</code> member of <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the sample count used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-colorAttachmentCount-06188",
|
|
"text": " If the currently bound pipeline was created without a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> with a <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>colorAttachmentCount</code> parameter greater than <code>0</code>, then each element of the <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pColorAttachments</code> array with a <code>imageView</code> not equal to <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> <strong class=\"purple\">must</strong> have been created with a sample count equal to the value of <a href=\"#VkPipelineMultisampleStateCreateInfo\">VkPipelineMultisampleStateCreateInfo</a>::<code>rasterizationSamples</code> used to create the currently bound graphics pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-pDepthAttachment-06189",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline was created without a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of <a href=\"#VkPipelineMultisampleStateCreateInfo\">VkPipelineMultisampleStateCreateInfo</a>::<code>rasterizationSamples</code> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the sample count used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-pStencilAttachment-06190",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline was created without a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of <a href=\"#VkPipelineMultisampleStateCreateInfo\">VkPipelineMultisampleStateCreateInfo</a>::<code>rasterizationSamples</code> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the sample count used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-renderPass-06198",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline <strong class=\"purple\">must</strong> have been created with a <a href=\"#VkGraphicsPipelineCreateInfo\">VkGraphicsPipelineCreateInfo</a>::<code>renderPass</code> equal to <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_EXT_primitives_generated_query)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-primitivesGeneratedQueryWithRasterizerDiscard-06708",
|
|
"text": " If the <a href=\"#features-primitivesGeneratedQueryWithRasterizerDiscard\"><code>primitivesGeneratedQueryWithRasterizerDiscard</code></a> feature is not enabled and the <code>VK_QUERY_TYPE_PRIMITIVES_GENERATED_EXT</code> query is active, <a href=\"#primsrast-discard\">rasterization discard</a> <strong class=\"purple\">must</strong> not be enabled."
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_EXT_primitives_generated_query)+(VK_EXT_transform_feedback)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-primitivesGeneratedQueryWithNonZeroStreams-06709",
|
|
"text": " If the <a href=\"#features-primitivesGeneratedQueryWithNonZeroStreams\"><code>primitivesGeneratedQueryWithNonZeroStreams</code></a> feature is not enabled and the <code>VK_QUERY_TYPE_PRIMITIVES_GENERATED_EXT</code> query is active, the bound graphics pipeline <strong class=\"purple\">must</strong> not have been created with a non-zero value in <code>VkPipelineRasterizationStateStreamCreateInfoEXT</code>::<code>rasterizationStream</code>."
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_NV_mesh_shader)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksNV-stage-06480",
|
|
"text": " The bound graphics pipeline <strong class=\"purple\">must</strong> not have been created with the <a href=\"#VkPipelineShaderStageCreateInfo\">VkPipelineShaderStageCreateInfo</a>::<code>stage</code> member of an element of <a href=\"#VkGraphicsPipelineCreateInfo\">VkGraphicsPipelineCreateInfo</a>::<code>pStages</code> set to <code>VK_SHADER_STAGE_VERTEX_BIT</code>, <code>VK_SHADER_STAGE_TESSELLATION_CONTROL_BIT</code>, <code>VK_SHADER_STAGE_TESSELLATION_EVALUATION_BIT</code> or <code>VK_SHADER_STAGE_GEOMETRY_BIT</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdDrawMeshTasksIndirectNV": {
|
|
"(VK_NV_mesh_shader)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-magFilter-04553",
|
|
"text": " If a <a href=\"#VkSampler\">VkSampler</a> created with <code>magFilter</code> or <code>minFilter</code> equal to <code>VK_FILTER_LINEAR</code> and <code>compareEnable</code> equal to <code>VK_FALSE</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-mipmapMode-04770",
|
|
"text": " If a <a href=\"#VkSampler\">VkSampler</a> created with <code>mipmapMode</code> equal to <code>VK_SAMPLER_MIPMAP_MODE_LINEAR</code> and <code>compareEnable</code> equal to <code>VK_FALSE</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-None-02691",
|
|
"text": " If a <code>VkImageView</code> is accessed using atomic operations as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_STORAGE_IMAGE_ATOMIC_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-None-02697",
|
|
"text": " For each set <em>n</em> that is statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command, a descriptor set <strong class=\"purple\">must</strong> have been bound to <em>n</em> at the same pipeline bind point, with a <code>VkPipelineLayout</code> that is compatible for set <em>n</em>, with the <code>VkPipelineLayout</code> used to create the current <code>VkPipeline</code>, as described in <a href=\"#descriptorsets-compatibility\">Pipeline Layout Compatibility</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-None-02699",
|
|
"text": " Descriptors in each bound descriptor set, specified via <code>vkCmdBindDescriptorSets</code>, <strong class=\"purple\">must</strong> be valid if they are statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-None-02700",
|
|
"text": " A valid pipeline <strong class=\"purple\">must</strong> be bound to the pipeline bind point used by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-commandBuffer-02701",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command requires any dynamic state, that state <strong class=\"purple\">must</strong> have been set or inherited (if the <code><a href=\"#VK_NV_inherited_viewport_scissor\">VK_NV_inherited_viewport_scissor</a></code> extension is enabled) for <code>commandBuffer</code>, and done so after any previously bound pipeline with the corresponding state not specified as dynamic"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-None-02859",
|
|
"text": " There <strong class=\"purple\">must</strong> not have been any calls to dynamic state setting commands for any state not specified as dynamic in the <code>VkPipeline</code> object bound to the pipeline bind point used by this command, since that pipeline was bound"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-None-02702",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> object that uses unnormalized coordinates, that sampler <strong class=\"purple\">must</strong> not be used to sample from any <code>VkImage</code> with a <code>VkImageView</code> of the type <code>VK_IMAGE_VIEW_TYPE_3D</code>, <code>VK_IMAGE_VIEW_TYPE_CUBE</code>, <code>VK_IMAGE_VIEW_TYPE_1D_ARRAY</code>, <code>VK_IMAGE_VIEW_TYPE_2D_ARRAY</code> or <code>VK_IMAGE_VIEW_TYPE_CUBE_ARRAY</code>, in any shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-None-02703",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> object that uses unnormalized coordinates, that sampler <strong class=\"purple\">must</strong> not be used with any of the SPIR-V <code>OpImageSample*</code> or <code>OpImageSparseSample*</code> instructions with <code>ImplicitLod</code>, <code>Dref</code> or <code>Proj</code> in their name, in any shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-None-02704",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> object that uses unnormalized coordinates, that sampler <strong class=\"purple\">must</strong> not be used with any of the SPIR-V <code>OpImageSample*</code> or <code>OpImageSparseSample*</code> instructions that includes a LOD bias or any offset values, in any shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-None-04115",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> is accessed using <code>OpImageWrite</code> as a result of this command, then the <code>Type</code> of the <code>Texel</code> operand of that instruction <strong class=\"purple\">must</strong> have at least as many components as the image view’s format"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-OpImageWrite-04469",
|
|
"text": " If a <a href=\"#VkBufferView\">VkBufferView</a> is accessed using <code>OpImageWrite</code> as a result of this command, then the <code>Type</code> of the <code>Texel</code> operand of that instruction <strong class=\"purple\">must</strong> have at least as many components as the buffer view’s format"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-renderPass-02684",
|
|
"text": " The current render pass <strong class=\"purple\">must</strong> be <a href=\"#renderpass-compatibility\">compatible</a> with the <code>renderPass</code> member of the <code>VkGraphicsPipelineCreateInfo</code> structure specified when creating the <code>VkPipeline</code> bound to <code>VK_PIPELINE_BIND_POINT_GRAPHICS</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-subpass-02685",
|
|
"text": " The subpass index of the current render pass <strong class=\"purple\">must</strong> be equal to the <code>subpass</code> member of the <code>VkGraphicsPipelineCreateInfo</code> structure specified when creating the <code>VkPipeline</code> bound to <code>VK_PIPELINE_BIND_POINT_GRAPHICS</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-None-02686",
|
|
"text": " Every input attachment used by the current subpass <strong class=\"purple\">must</strong> be bound to the pipeline via a descriptor set"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-None-06537",
|
|
"text": " Memory backing image subresources used as attachments in the current render pass <strong class=\"purple\">must</strong> not be written in any way other than as an attachment by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-None-06538",
|
|
"text": " If any recorded command in the current subpass will write to an image subresource as an attachment, this command <strong class=\"purple\">must</strong> not read from the memory backing that image subresource in any other way than as an attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-None-06539",
|
|
"text": " If any recorded command in the current subpass will read from an image subresource used as an attachment in any way other than as an attachment, this command <strong class=\"purple\">must</strong> not write to that image subresource as an attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-None-06886",
|
|
"text": " If the current render pass instance uses a depth/stencil attachment with a read-only layout for the depth aspect, <a href=\"#fragops-depth-write\">depth writes</a> <strong class=\"purple\">must</strong> be disabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-None-06887",
|
|
"text": " If the current render pass instance uses a depth/stencil attachment with a read-only layout for the stencil aspect and stencil test is enabled, <a href=\"#fragops-stencil\">all stencil ops</a> <strong class=\"purple\">must</strong> be <code>VK_STENCIL_OP_KEEP</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-blendEnable-04727",
|
|
"text": " If rasterization is not disabled in the bound graphics pipeline, then for each color attachment in the subpass, if the corresponding image view’s <a href=\"#resources-image-view-format-features\">format features</a> do not contain <code>VK_FORMAT_FEATURE_COLOR_ATTACHMENT_BLEND_BIT</code>, then the <code>blendEnable</code> member of the corresponding element of the <code>pAttachments</code> member of <code>pColorBlendState</code> <strong class=\"purple\">must</strong> be <code>VK_FALSE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-rasterizationSamples-04740",
|
|
"text": " If rasterization is not disabled in the bound graphics pipeline, and neither the <code><a href=\"#VK_AMD_mixed_attachment_samples\">VK_AMD_mixed_attachment_samples</a></code> nor the <code><a href=\"#VK_NV_framebuffer_mixed_samples\">VK_NV_framebuffer_mixed_samples</a></code> extensions are enabled, then <a href=\"#VkPipelineMultisampleStateCreateInfo\">VkPipelineMultisampleStateCreateInfo</a>::<code>rasterizationSamples</code> <strong class=\"purple\">must</strong> be the same as the current subpass color and/or depth/stencil attachments"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-buffer-02708",
|
|
"text": " If <code>buffer</code> is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-buffer-02709",
|
|
"text": " <code>buffer</code> <strong class=\"purple\">must</strong> have been created with the <code>VK_BUFFER_USAGE_INDIRECT_BUFFER_BIT</code> bit set"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-offset-02710",
|
|
"text": " <code>offset</code> <strong class=\"purple\">must</strong> be a multiple of <code>4</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-drawCount-02718",
|
|
"text": " If the <a href=\"#features-multiDrawIndirect\"><code>multiDrawIndirect</code></a> feature is not enabled, <code>drawCount</code> <strong class=\"purple\">must</strong> be <code>0</code> or <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-drawCount-02719",
|
|
"text": " <code>drawCount</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxDrawIndirectCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-drawCount-02146",
|
|
"text": " If <code>drawCount</code> is greater than <code>1</code>, <code>stride</code> <strong class=\"purple\">must</strong> be a multiple of <code>4</code> and <strong class=\"purple\">must</strong> be greater than or equal to <code>sizeof</code>(<code>VkDrawMeshTasksIndirectCommandNV</code>)"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-drawCount-02156",
|
|
"text": " If <code>drawCount</code> is equal to <code>1</code>, <span class=\"eq\">(<code>offset</code> + <code>sizeof</code>(<a href=\"#VkDrawMeshTasksIndirectCommandNV\">VkDrawMeshTasksIndirectCommandNV</a>))</span> <strong class=\"purple\">must</strong> be less than or equal to the size of <code>buffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-drawCount-02157",
|
|
"text": " If <code>drawCount</code> is greater than <code>1</code>, <span class=\"eq\">(<code>stride</code> {times} (<code>drawCount</code> - 1) + <code>offset</code> + <code>sizeof</code>(<a href=\"#VkDrawMeshTasksIndirectCommandNV\">VkDrawMeshTasksIndirectCommandNV</a>))</span> <strong class=\"purple\">must</strong> be less than or equal to the size of <code>buffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-buffer-parameter",
|
|
"text": " <code>buffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBuffer\">VkBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called inside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-commonparent",
|
|
"text": " Both of <code>buffer</code>, and <code>commandBuffer</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+!(VK_VERSION_1_3,VK_KHR_format_feature_flags2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-aspectMask-06478",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> is sampled with <a href=\"#textures-depth-compare-operation\">depth comparison</a>, the image view <strong class=\"purple\">must</strong> have been created with an <code>aspectMask</code> that contains <code>VK_IMAGE_ASPECT_DEPTH_BIT</code>."
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_VERSION_1_3,VK_KHR_format_feature_flags2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-None-06479",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> is sampled with <a href=\"#textures-depth-compare-operation\">depth comparison</a>, the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_SAMPLED_IMAGE_DEPTH_COMPARISON_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-OpTypeImage-06423",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> or <a href=\"#VkBufferView\">VkBufferView</a> being written as a storage image or storage texel buffer where the image format field of the <code>OpTypeImage</code> is <code>Unknown</code> then the view’s format feature <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_STORAGE_WRITE_WITHOUT_FORMAT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-OpTypeImage-06424",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> or <a href=\"#VkBufferView\">VkBufferView</a> being read as a storage image or storage texel buffer where the image format field of the <code>OpTypeImage</code> is <code>Unknown</code> then the view’s format feature <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_STORAGE_READ_WITHOUT_FORMAT_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_IMG_filter_cubic,VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-None-02692",
|
|
"text": " If a <code>VkImageView</code> is sampled with <code>VK_FILTER_CUBIC_EXT</code> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_CUBIC_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_IMG_filter_cubic,VK_EXT_filter_cubic)+!(VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-None-02693",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> being sampled with <code>VK_FILTER_CUBIC_EXT</code> as a result of this command <strong class=\"purple\">must</strong> not have a <a href=\"#VkImageViewType\">VkImageViewType</a> of <code>VK_IMAGE_VIEW_TYPE_3D</code>, <code>VK_IMAGE_VIEW_TYPE_CUBE</code>, or <code>VK_IMAGE_VIEW_TYPE_CUBE_ARRAY</code>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_IMG_filter_cubic,VK_EXT_filter_cubic)+(VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-filterCubic-02694",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> being sampled with <code>VK_FILTER_CUBIC_EXT</code> as a result of this command <strong class=\"purple\">must</strong> have a <a href=\"#VkImageViewType\">VkImageViewType</a> and format that supports cubic filtering, as specified by <code>VkFilterCubicImageViewImageFormatPropertiesEXT</code>::<code>filterCubic</code> returned by <code>vkGetPhysicalDeviceImageFormatProperties2</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-filterCubicMinmax-02695",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> being sampled with <code>VK_FILTER_CUBIC_EXT</code> with a reduction mode of either <code>VK_SAMPLER_REDUCTION_MODE_MIN</code> or <code>VK_SAMPLER_REDUCTION_MODE_MAX</code> as a result of this command <strong class=\"purple\">must</strong> have a <a href=\"#VkImageViewType\">VkImageViewType</a> and format that supports cubic filtering together with minmax filtering, as specified by <code>VkFilterCubicImageViewImageFormatPropertiesEXT</code>::<code>filterCubicMinmax</code> returned by <code>vkGetPhysicalDeviceImageFormatProperties2</code>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_NV_corner_sampled_image)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-flags-02696",
|
|
"text": " Any <a href=\"#VkImage\">VkImage</a> created with a <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a>::<code>flags</code> containing <code>VK_IMAGE_CREATE_CORNER_SAMPLED_BIT_NV</code> sampled as a result of this command <strong class=\"purple\">must</strong> only be sampled using a <a href=\"#VkSamplerAddressMode\">VkSamplerAddressMode</a> of <code>VK_SAMPLER_ADDRESS_MODE_CLAMP_TO_EDGE</code>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+!(VK_VERSION_1_3,VK_KHR_maintenance4)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-None-02698",
|
|
"text": " For each push constant that is statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command, a push constant value <strong class=\"purple\">must</strong> have been set for the same pipeline bind point, with a <code>VkPipelineLayout</code> that is compatible for push constants, with the <code>VkPipelineLayout</code> used to create the current <code>VkPipeline</code>, as described in <a href=\"#descriptorsets-compatibility\">Pipeline Layout Compatibility</a>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_VERSION_1_3,VK_KHR_maintenance4)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-maintenance4-06425",
|
|
"text": " If the <a href=\"#features-maintenance4\"><code>maintenance4</code></a> feature is not enabled, then for each push constant that is statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command, a push constant value <strong class=\"purple\">must</strong> have been set for the same pipeline bind point, with a <code>VkPipelineLayout</code> that is compatible for push constants, with the <code>VkPipelineLayout</code> used to create the current <code>VkPipeline</code>, as described in <a href=\"#descriptorsets-compatibility\">Pipeline Layout Compatibility</a>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+!(VK_EXT_pipeline_robustness)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-None-02705",
|
|
"text": " If the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, and if the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a uniform buffer, it <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-None-02706",
|
|
"text": " If the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, and if the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a storage buffer, it <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_EXT_pipeline_robustness)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-uniformBuffers-06935",
|
|
"text": " If any stage of the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a uniform buffer, and that stage was created without enabling either <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_EXT</code> or <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXT</code> for <code>uniformBuffers</code>, and the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, that stage <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-storageBuffers-06936",
|
|
"text": " If any stage of the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a storage buffer, and that stage was created without enabling either <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_EXT</code> or <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXT</code> for <code>storageBuffers</code>, and the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, that stage <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-commandBuffer-02707",
|
|
"text": " If <code>commandBuffer</code> is an unprotected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, any resource accessed by the <a href=\"#VkPipeline\">VkPipeline</a> object bound to the pipeline bind point used by this command <strong class=\"purple\">must</strong> not be a protected resource"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-commandBuffer-02711",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> not be a protected command buffer"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-None-06550",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> or <code>VkImageView</code> object that enables <a href=\"#samplers-YCbCr-conversion\">sampler {YCbCr} conversion</a>, that object <strong class=\"purple\">must</strong> only be used with <code>OpImageSample*</code> or <code>OpImageSparseSample*</code> instructions"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-ConstOffset-06551",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> or <code>VkImageView</code> object that enables <a href=\"#samplers-YCbCr-conversion\">sampler {YCbCr} conversion</a>, that object <strong class=\"purple\">must</strong> not use the <code>ConstOffset</code> and <code>Offset</code> operands"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_EXT_shader_image_atomic_int64)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-SampledType-04470",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a 64-bit component width is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 64"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-SampledType-04471",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a component width less than 64-bit is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 32"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-SampledType-04472",
|
|
"text": " If a <a href=\"#VkBufferView\">VkBufferView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a 64-bit component width is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 64"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-SampledType-04473",
|
|
"text": " If a <a href=\"#VkBufferView\">VkBufferView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a component width less than 64-bit is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 32"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-sparseImageInt64Atomics-04474",
|
|
"text": " If the <a href=\"#features-sparseImageInt64Atomics\"><code>sparseImageInt64Atomics</code></a> feature is not enabled, <a href=\"#VkImage\">VkImage</a> objects created with the <code>VK_IMAGE_CREATE_SPARSE_RESIDENCY_BIT</code> flag <strong class=\"purple\">must</strong> not be accessed by atomic instructions through an <code>OpTypeImage</code> with a <code>SampledType</code> with a <code>Width</code> of 64 by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-sparseImageInt64Atomics-04475",
|
|
"text": " If the <a href=\"#features-sparseImageInt64Atomics\"><code>sparseImageInt64Atomics</code></a> feature is not enabled, <a href=\"#VkBuffer\">VkBuffer</a> objects created with the <code>VK_BUFFER_CREATE_SPARSE_RESIDENCY_BIT</code> flag <strong class=\"purple\">must</strong> not be accessed by atomic instructions through an <code>OpTypeImage</code> with a <code>SampledType</code> with a <code>Width</code> of 64 by this command"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_QCOM_image_processing)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-OpImageWeightedSampleQCOM-06971",
|
|
"text": " If <code>OpImageWeightedSampleQCOM</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_WEIGHT_SAMPLED_IMAGE_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-OpImageWeightedSampleQCOM-06972",
|
|
"text": " If <code>OpImageWeightedSampleQCOM</code> uses a <a href=\"#VkImageView\">VkImageView</a> as a sample weight image as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_WEIGHT_IMAGE_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-OpImageBoxFilterQCOM-06973",
|
|
"text": " If <code>OpImageBoxFilterQCOM</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_BOX_FILTER_SAMPLED_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-OpImageBlockMatchSSDQCOM-06974",
|
|
"text": " If <code>OpImageBlockMatchSSDQCOM</code> is used to read from an <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-OpImageBlockMatchSADQCOM-06975",
|
|
"text": " If <code>OpImageBlockMatchSADQCOM</code> is used to read from an <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-OpImageBlockMatchSADQCOM-06976",
|
|
"text": " If <code>OpImageBlockMatchSADQCOM</code> or OpImageBlockMatchSSDQCOM is used to read from a reference image as result of this command, then the specified reference coordinates <strong class=\"purple\">must</strong> not fail <a href=\"#textures-integer-coordinate-validation\">integer texel coordinate validation</a>."
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-OpImageWeightedSampleQCOM-06977",
|
|
"text": " If <code>OpImageWeightedSampleQCOM</code>, <code>OpImageBoxFilterQCOM</code>, <code>OpImageBlockMatchSSDQCOM</code>, or <code>OpImageBlockMatchSADQCOM</code> uses a <a href=\"#VkSampler\">VkSampler</a> as a result of this command, then the sampler <strong class=\"purple\">must</strong> have been created with <code>VK_SAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-OpImageWeightedSampleQCOM-06978",
|
|
"text": " If any command other than <code>OpImageWeightedSampleQCOM</code>, <code>OpImageBoxFilterQCOM</code>, <code>OpImageBlockMatchSSDQCOM</code>, or <code>OpImageBlockMatchSADQCOM</code> uses a <a href=\"#VkSampler\">VkSampler</a> as a result of this command, then the sampler <strong class=\"purple\">must</strong> not have been created with <code>VK_SAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM</code>."
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_VERSION_1_1,VK_KHR_multiview)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-maxMultiviewInstanceIndex-02688",
|
|
"text": " If the draw is recorded in a render pass instance with multiview enabled, the maximum instance index <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#VkPhysicalDeviceMultiviewProperties\">VkPhysicalDeviceMultiviewProperties</a>::<code>maxMultiviewInstanceIndex</code>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_EXT_sample_locations)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-sampleLocationsEnable-02689",
|
|
"text": " If the bound graphics pipeline was created with <a href=\"#VkPipelineSampleLocationsStateCreateInfoEXT\">VkPipelineSampleLocationsStateCreateInfoEXT</a>::<code>sampleLocationsEnable</code> set to <code>VK_TRUE</code> and the current subpass has a depth/stencil attachment, then that attachment <strong class=\"purple\">must</strong> have been created with the <code>VK_IMAGE_CREATE_SAMPLE_LOCATIONS_COMPATIBLE_DEPTH_BIT_EXT</code> bit set"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-None-06666",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_SAMPLE_LOCATIONS_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetSampleLocationsEXT\">vkCmdSetSampleLocationsEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-viewportCount-03417",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, but not the <code>VK_DYNAMIC_STATE_SCISSOR_WITH_COUNT</code> dynamic state enabled, then <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>viewportCount</code> parameter of <code>vkCmdSetViewportWithCount</code> <strong class=\"purple\">must</strong> match the <code>VkPipelineViewportStateCreateInfo</code>::<code>scissorCount</code> of the pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-scissorCount-03418",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_SCISSOR_WITH_COUNT</code> dynamic state enabled, but not the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, then <a href=\"#vkCmdSetScissorWithCount\">vkCmdSetScissorWithCount</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>scissorCount</code> parameter of <code>vkCmdSetScissorWithCount</code> <strong class=\"purple\">must</strong> match the <code>VkPipelineViewportStateCreateInfo</code>::<code>viewportCount</code> of the pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-viewportCount-03419",
|
|
"text": " If the bound graphics pipeline state was created with both the <code>VK_DYNAMIC_STATE_SCISSOR_WITH_COUNT</code> and <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic states enabled then both <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a> and <a href=\"#vkCmdSetScissorWithCount\">vkCmdSetScissorWithCount</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>viewportCount</code> parameter of <code>vkCmdSetViewportWithCount</code> <strong class=\"purple\">must</strong> match the <code>scissorCount</code> parameter of <code>vkCmdSetScissorWithCount</code>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_NV_clip_space_w_scaling)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-viewportCount-04137",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, but not the <code>VK_DYNAMIC_STATE_VIEWPORT_W_SCALING_NV</code> dynamic state enabled, then the bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <a href=\"#VkPipelineViewportWScalingStateCreateInfoNV\">VkPipelineViewportWScalingStateCreateInfoNV</a>::<code>viewportCount</code> greater or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-viewportCount-04138",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> and <code>VK_DYNAMIC_STATE_VIEWPORT_W_SCALING_NV</code> dynamic states enabled then the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWScalingNV\">vkCmdSetViewportWScalingNV</a> <strong class=\"purple\">must</strong> be greater than or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_NV_shading_rate_image)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-viewportCount-04139",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, but not the <code>VK_DYNAMIC_STATE_VIEWPORT_SHADING_RATE_PALETTE_NV</code> dynamic state enabled, then the bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <a href=\"#VkPipelineViewportShadingRateImageStateCreateInfoNV\">VkPipelineViewportShadingRateImageStateCreateInfoNV</a>::<code>viewportCount</code> greater or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-viewportCount-04140",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> and <code>VK_DYNAMIC_STATE_VIEWPORT_SHADING_RATE_PALETTE_NV</code> dynamic states enabled then the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportShadingRatePaletteNV\">vkCmdSetViewportShadingRatePaletteNV</a> <strong class=\"purple\">must</strong> be greater than or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_NV_viewport_swizzle)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-VkPipelineVieportCreateInfo-04141",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled and a <a href=\"#VkPipelineViewportSwizzleStateCreateInfoNV\">VkPipelineViewportSwizzleStateCreateInfoNV</a> structure chained from <code>VkPipelineVieportCreateInfo</code>, then the bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <a href=\"#VkPipelineViewportSwizzleStateCreateInfoNV\">VkPipelineViewportSwizzleStateCreateInfoNV</a>::<code>viewportCount</code> greater or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_NV_scissor_exclusive)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-VkPipelineVieportCreateInfo-04142",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled and a <a href=\"#VkPipelineViewportExclusiveScissorStateCreateInfoNV\">VkPipelineViewportExclusiveScissorStateCreateInfoNV</a> structure chained from <code>VkPipelineVieportCreateInfo</code>, then the bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <a href=\"#VkPipelineViewportExclusiveScissorStateCreateInfoNV\">VkPipelineViewportExclusiveScissorStateCreateInfoNV</a>::<code>exclusiveScissorCount</code> greater or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-None-04876",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_RASTERIZER_DISCARD_ENABLE</code> dynamic state enabled then <a href=\"#vkCmdSetRasterizerDiscardEnable\">vkCmdSetRasterizerDiscardEnable</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-None-04877",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_DEPTH_BIAS_ENABLE</code> dynamic state enabled then <a href=\"#vkCmdSetDepthBiasEnable\">vkCmdSetDepthBiasEnable</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-logicOp-04878",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_LOGIC_OP_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetLogicOpEXT\">vkCmdSetLogicOpEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command and the <code>logicOp</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkLogicOp\">VkLogicOp</a> value"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_KHR_fragment_shading_rate)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-primitiveFragmentShadingRateWithMultipleViewports-04552",
|
|
"text": " If the <a href=\"#limits-primitiveFragmentShadingRateWithMultipleViewports\"><code>primitiveFragmentShadingRateWithMultipleViewports</code></a> limit is not supported, the bound graphics pipeline was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, and any of the shader stages of the bound graphics pipeline write to the <code>PrimitiveShadingRateKHR</code> built-in, then <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>viewportCount</code> parameter of <code>vkCmdSetViewportWithCount</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-imageView-06172",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pDepthAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pDepthAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the depth attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-imageView-06173",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pStencilAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pStencilAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the stencil attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-viewMask-06178",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound graphics pipeline <strong class=\"purple\">must</strong> have been created with a <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>viewMask</code> equal to <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>viewMask</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-colorAttachmentCount-06179",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound graphics pipeline <strong class=\"purple\">must</strong> have been created with a <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>colorAttachmentCount</code> equal to <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>colorAttachmentCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-colorAttachmentCount-06180",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>colorAttachmentCount</code> greater than <code>0</code>, then each element of the <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pColorAttachments</code> array with a <code>imageView</code> not equal to <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> <strong class=\"purple\">must</strong> have been created with a <a href=\"#VkFormat\">VkFormat</a> equal to the corresponding element of <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>pColorAttachmentFormats</code> used to create the currently bound graphics pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-pDepthAttachment-06181",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>depthAttachmentFormat</code> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the <a href=\"#VkFormat\">VkFormat</a> used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-pStencilAttachment-06182",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>stencilAttachmentFormat</code> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the <a href=\"#VkFormat\">VkFormat</a> used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_VERSION_1_1,VK_KHR_maintenance2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-imageView-06174",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pDepthAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pDepthAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_STENCIL_ATTACHMENT_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the depth attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-imageView-06175",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pStencilAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pStencilAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_STENCIL_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the stencil attachment"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_VERSION_1_2,VK_KHR_separate_depth_stencil_layouts)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-imageView-06176",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pDepthAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pDepthAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the depth attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-imageView-06177",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pStencilAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pStencilAttachment</code> is <code>VK_IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the stencil attachment"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_EXT_color_write_enable)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-attachmentCount-06667",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_COLOR_WRITE_ENABLE_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetColorWriteEnableEXT\">vkCmdSetColorWriteEnableEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>attachmentCount</code> parameter of <code>vkCmdSetColorWriteEnableEXT</code> <strong class=\"purple\">must</strong> be greater than or equal to the <code>VkPipelineColorBlendStateCreateInfo</code>::<code>attachmentCount</code> of the currently bound graphics pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-attachmentCount-06815",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_COLOR_WRITE_ENABLE_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetColorWriteEnableEXT\">vkCmdSetColorWriteEnableEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>attachmentCount</code> parameter of <code>vkCmdSetColorWriteEnableEXT</code> <strong class=\"purple\">must</strong> be less than or equal to the <code>maxColorAttachments</code> member of <code>VkPhysicalDeviceLimits</code>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_KHR_fragment_shading_rate)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-imageView-06183",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingFragmentShadingRateAttachmentInfoKHR\">VkRenderingFragmentShadingRateAttachmentInfoKHR</a>::<code>imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the currently bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <code>VK_PIPELINE_CREATE_RENDERING_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR</code>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_EXT_fragment_density_map)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-imageView-06184",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingFragmentDensityMapAttachmentInfoEXT\">VkRenderingFragmentDensityMapAttachmentInfoEXT</a>::<code>imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the currently bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <code>VK_PIPELINE_CREATE_RENDERING_FRAGMENT_DENSITY_MAP_ATTACHMENT_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_AMD_mixed_attachment_samples,VK_NV_framebuffer_mixed_samples)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-colorAttachmentCount-06185",
|
|
"text": " If the currently bound pipeline was created with a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> with a <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>colorAttachmentCount</code> parameter greater than <code>0</code>, then each element of the <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pColorAttachments</code> array with a <code>imageView</code> not equal to <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> <strong class=\"purple\">must</strong> have been created with a sample count equal to the corresponding element of the <code>pColorAttachmentSamples</code> member of <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> used to create the currently bound graphics pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-pDepthAttachment-06186",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline was created with a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of the <code>depthStencilAttachmentSamples</code> member of <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the sample count used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-pStencilAttachment-06187",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline was created with a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of the <code>depthStencilAttachmentSamples</code> member of <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the sample count used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-colorAttachmentCount-06188",
|
|
"text": " If the currently bound pipeline was created without a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> with a <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>colorAttachmentCount</code> parameter greater than <code>0</code>, then each element of the <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pColorAttachments</code> array with a <code>imageView</code> not equal to <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> <strong class=\"purple\">must</strong> have been created with a sample count equal to the value of <a href=\"#VkPipelineMultisampleStateCreateInfo\">VkPipelineMultisampleStateCreateInfo</a>::<code>rasterizationSamples</code> used to create the currently bound graphics pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-pDepthAttachment-06189",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline was created without a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of <a href=\"#VkPipelineMultisampleStateCreateInfo\">VkPipelineMultisampleStateCreateInfo</a>::<code>rasterizationSamples</code> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the sample count used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-pStencilAttachment-06190",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline was created without a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of <a href=\"#VkPipelineMultisampleStateCreateInfo\">VkPipelineMultisampleStateCreateInfo</a>::<code>rasterizationSamples</code> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the sample count used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-renderPass-06198",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline <strong class=\"purple\">must</strong> have been created with a <a href=\"#VkGraphicsPipelineCreateInfo\">VkGraphicsPipelineCreateInfo</a>::<code>renderPass</code> equal to <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_EXT_primitives_generated_query)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-primitivesGeneratedQueryWithRasterizerDiscard-06708",
|
|
"text": " If the <a href=\"#features-primitivesGeneratedQueryWithRasterizerDiscard\"><code>primitivesGeneratedQueryWithRasterizerDiscard</code></a> feature is not enabled and the <code>VK_QUERY_TYPE_PRIMITIVES_GENERATED_EXT</code> query is active, <a href=\"#primsrast-discard\">rasterization discard</a> <strong class=\"purple\">must</strong> not be enabled."
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_EXT_primitives_generated_query)+(VK_EXT_transform_feedback)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-primitivesGeneratedQueryWithNonZeroStreams-06709",
|
|
"text": " If the <a href=\"#features-primitivesGeneratedQueryWithNonZeroStreams\"><code>primitivesGeneratedQueryWithNonZeroStreams</code></a> feature is not enabled and the <code>VK_QUERY_TYPE_PRIMITIVES_GENERATED_EXT</code> query is active, the bound graphics pipeline <strong class=\"purple\">must</strong> not have been created with a non-zero value in <code>VkPipelineRasterizationStateStreamCreateInfoEXT</code>::<code>rasterizationStream</code>."
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_NV_mesh_shader)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectNV-stage-06480",
|
|
"text": " The bound graphics pipeline <strong class=\"purple\">must</strong> not have been created with the <a href=\"#VkPipelineShaderStageCreateInfo\">VkPipelineShaderStageCreateInfo</a>::<code>stage</code> member of an element of <a href=\"#VkGraphicsPipelineCreateInfo\">VkGraphicsPipelineCreateInfo</a>::<code>pStages</code> set to <code>VK_SHADER_STAGE_VERTEX_BIT</code>, <code>VK_SHADER_STAGE_TESSELLATION_CONTROL_BIT</code>, <code>VK_SHADER_STAGE_TESSELLATION_EVALUATION_BIT</code> or <code>VK_SHADER_STAGE_GEOMETRY_BIT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkDrawMeshTasksIndirectCommandNV": {
|
|
"(VK_NV_mesh_shader)": [
|
|
{
|
|
"vuid": "VUID-VkDrawMeshTasksIndirectCommandNV-taskCount-02175",
|
|
"text": " <code>taskCount</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceMeshShaderPropertiesNV</code>::<code>maxDrawMeshTasksCount</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdDrawMeshTasksIndirectCountNV": {
|
|
"(VK_NV_mesh_shader)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-magFilter-04553",
|
|
"text": " If a <a href=\"#VkSampler\">VkSampler</a> created with <code>magFilter</code> or <code>minFilter</code> equal to <code>VK_FILTER_LINEAR</code> and <code>compareEnable</code> equal to <code>VK_FALSE</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-mipmapMode-04770",
|
|
"text": " If a <a href=\"#VkSampler\">VkSampler</a> created with <code>mipmapMode</code> equal to <code>VK_SAMPLER_MIPMAP_MODE_LINEAR</code> and <code>compareEnable</code> equal to <code>VK_FALSE</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-None-02691",
|
|
"text": " If a <code>VkImageView</code> is accessed using atomic operations as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_STORAGE_IMAGE_ATOMIC_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-None-02697",
|
|
"text": " For each set <em>n</em> that is statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command, a descriptor set <strong class=\"purple\">must</strong> have been bound to <em>n</em> at the same pipeline bind point, with a <code>VkPipelineLayout</code> that is compatible for set <em>n</em>, with the <code>VkPipelineLayout</code> used to create the current <code>VkPipeline</code>, as described in <a href=\"#descriptorsets-compatibility\">Pipeline Layout Compatibility</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-None-02699",
|
|
"text": " Descriptors in each bound descriptor set, specified via <code>vkCmdBindDescriptorSets</code>, <strong class=\"purple\">must</strong> be valid if they are statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-None-02700",
|
|
"text": " A valid pipeline <strong class=\"purple\">must</strong> be bound to the pipeline bind point used by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-commandBuffer-02701",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command requires any dynamic state, that state <strong class=\"purple\">must</strong> have been set or inherited (if the <code><a href=\"#VK_NV_inherited_viewport_scissor\">VK_NV_inherited_viewport_scissor</a></code> extension is enabled) for <code>commandBuffer</code>, and done so after any previously bound pipeline with the corresponding state not specified as dynamic"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-None-02859",
|
|
"text": " There <strong class=\"purple\">must</strong> not have been any calls to dynamic state setting commands for any state not specified as dynamic in the <code>VkPipeline</code> object bound to the pipeline bind point used by this command, since that pipeline was bound"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-None-02702",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> object that uses unnormalized coordinates, that sampler <strong class=\"purple\">must</strong> not be used to sample from any <code>VkImage</code> with a <code>VkImageView</code> of the type <code>VK_IMAGE_VIEW_TYPE_3D</code>, <code>VK_IMAGE_VIEW_TYPE_CUBE</code>, <code>VK_IMAGE_VIEW_TYPE_1D_ARRAY</code>, <code>VK_IMAGE_VIEW_TYPE_2D_ARRAY</code> or <code>VK_IMAGE_VIEW_TYPE_CUBE_ARRAY</code>, in any shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-None-02703",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> object that uses unnormalized coordinates, that sampler <strong class=\"purple\">must</strong> not be used with any of the SPIR-V <code>OpImageSample*</code> or <code>OpImageSparseSample*</code> instructions with <code>ImplicitLod</code>, <code>Dref</code> or <code>Proj</code> in their name, in any shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-None-02704",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> object that uses unnormalized coordinates, that sampler <strong class=\"purple\">must</strong> not be used with any of the SPIR-V <code>OpImageSample*</code> or <code>OpImageSparseSample*</code> instructions that includes a LOD bias or any offset values, in any shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-None-04115",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> is accessed using <code>OpImageWrite</code> as a result of this command, then the <code>Type</code> of the <code>Texel</code> operand of that instruction <strong class=\"purple\">must</strong> have at least as many components as the image view’s format"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-OpImageWrite-04469",
|
|
"text": " If a <a href=\"#VkBufferView\">VkBufferView</a> is accessed using <code>OpImageWrite</code> as a result of this command, then the <code>Type</code> of the <code>Texel</code> operand of that instruction <strong class=\"purple\">must</strong> have at least as many components as the buffer view’s format"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-renderPass-02684",
|
|
"text": " The current render pass <strong class=\"purple\">must</strong> be <a href=\"#renderpass-compatibility\">compatible</a> with the <code>renderPass</code> member of the <code>VkGraphicsPipelineCreateInfo</code> structure specified when creating the <code>VkPipeline</code> bound to <code>VK_PIPELINE_BIND_POINT_GRAPHICS</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-subpass-02685",
|
|
"text": " The subpass index of the current render pass <strong class=\"purple\">must</strong> be equal to the <code>subpass</code> member of the <code>VkGraphicsPipelineCreateInfo</code> structure specified when creating the <code>VkPipeline</code> bound to <code>VK_PIPELINE_BIND_POINT_GRAPHICS</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-None-02686",
|
|
"text": " Every input attachment used by the current subpass <strong class=\"purple\">must</strong> be bound to the pipeline via a descriptor set"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-None-06537",
|
|
"text": " Memory backing image subresources used as attachments in the current render pass <strong class=\"purple\">must</strong> not be written in any way other than as an attachment by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-None-06538",
|
|
"text": " If any recorded command in the current subpass will write to an image subresource as an attachment, this command <strong class=\"purple\">must</strong> not read from the memory backing that image subresource in any other way than as an attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-None-06539",
|
|
"text": " If any recorded command in the current subpass will read from an image subresource used as an attachment in any way other than as an attachment, this command <strong class=\"purple\">must</strong> not write to that image subresource as an attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-None-06886",
|
|
"text": " If the current render pass instance uses a depth/stencil attachment with a read-only layout for the depth aspect, <a href=\"#fragops-depth-write\">depth writes</a> <strong class=\"purple\">must</strong> be disabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-None-06887",
|
|
"text": " If the current render pass instance uses a depth/stencil attachment with a read-only layout for the stencil aspect and stencil test is enabled, <a href=\"#fragops-stencil\">all stencil ops</a> <strong class=\"purple\">must</strong> be <code>VK_STENCIL_OP_KEEP</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-blendEnable-04727",
|
|
"text": " If rasterization is not disabled in the bound graphics pipeline, then for each color attachment in the subpass, if the corresponding image view’s <a href=\"#resources-image-view-format-features\">format features</a> do not contain <code>VK_FORMAT_FEATURE_COLOR_ATTACHMENT_BLEND_BIT</code>, then the <code>blendEnable</code> member of the corresponding element of the <code>pAttachments</code> member of <code>pColorBlendState</code> <strong class=\"purple\">must</strong> be <code>VK_FALSE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-rasterizationSamples-04740",
|
|
"text": " If rasterization is not disabled in the bound graphics pipeline, and neither the <code><a href=\"#VK_AMD_mixed_attachment_samples\">VK_AMD_mixed_attachment_samples</a></code> nor the <code><a href=\"#VK_NV_framebuffer_mixed_samples\">VK_NV_framebuffer_mixed_samples</a></code> extensions are enabled, then <a href=\"#VkPipelineMultisampleStateCreateInfo\">VkPipelineMultisampleStateCreateInfo</a>::<code>rasterizationSamples</code> <strong class=\"purple\">must</strong> be the same as the current subpass color and/or depth/stencil attachments"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-buffer-02708",
|
|
"text": " If <code>buffer</code> is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-buffer-02709",
|
|
"text": " <code>buffer</code> <strong class=\"purple\">must</strong> have been created with the <code>VK_BUFFER_USAGE_INDIRECT_BUFFER_BIT</code> bit set"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-offset-02710",
|
|
"text": " <code>offset</code> <strong class=\"purple\">must</strong> be a multiple of <code>4</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-countBuffer-02714",
|
|
"text": " If <code>countBuffer</code> is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-countBuffer-02715",
|
|
"text": " <code>countBuffer</code> <strong class=\"purple\">must</strong> have been created with the <code>VK_BUFFER_USAGE_INDIRECT_BUFFER_BIT</code> bit set"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-countBufferOffset-02716",
|
|
"text": " <code>countBufferOffset</code> <strong class=\"purple\">must</strong> be a multiple of <code>4</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-countBuffer-02717",
|
|
"text": " The count stored in <code>countBuffer</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxDrawIndirectCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-countBufferOffset-04129",
|
|
"text": " <span class=\"eq\">(<code>countBufferOffset</code> + <code>sizeof</code>(uint32_t))</span> <strong class=\"purple\">must</strong> be less than or equal to the size of <code>countBuffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-stride-02182",
|
|
"text": " <code>stride</code> <strong class=\"purple\">must</strong> be a multiple of <code>4</code> and <strong class=\"purple\">must</strong> be greater than or equal to <code>sizeof</code>(<code>VkDrawMeshTasksIndirectCommandNV</code>)"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-maxDrawCount-02183",
|
|
"text": " If <code>maxDrawCount</code> is greater than or equal to <code>1</code>, <span class=\"eq\">(<code>stride</code> {times} (<code>maxDrawCount</code> - 1) + <code>offset</code> + <code>sizeof</code>(<code>VkDrawMeshTasksIndirectCommandNV</code>))</span> <strong class=\"purple\">must</strong> be less than or equal to the size of <code>buffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-countBuffer-02191",
|
|
"text": " If the count stored in <code>countBuffer</code> is equal to <code>1</code>, <span class=\"eq\">(<code>offset</code> + <code>sizeof</code>(<code>VkDrawMeshTasksIndirectCommandNV</code>))</span> <strong class=\"purple\">must</strong> be less than or equal to the size of <code>buffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-countBuffer-02192",
|
|
"text": " If the count stored in <code>countBuffer</code> is greater than <code>1</code>, <span class=\"eq\">(<code>stride</code> {times} (<code>drawCount</code> - 1) + <code>offset</code> + <code>sizeof</code>(<code>VkDrawMeshTasksIndirectCommandNV</code>))</span> <strong class=\"purple\">must</strong> be less than or equal to the size of <code>buffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-buffer-parameter",
|
|
"text": " <code>buffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBuffer\">VkBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-countBuffer-parameter",
|
|
"text": " <code>countBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBuffer\">VkBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called inside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-commonparent",
|
|
"text": " Each of <code>buffer</code>, <code>commandBuffer</code>, and <code>countBuffer</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+!(VK_VERSION_1_3,VK_KHR_format_feature_flags2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-aspectMask-06478",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> is sampled with <a href=\"#textures-depth-compare-operation\">depth comparison</a>, the image view <strong class=\"purple\">must</strong> have been created with an <code>aspectMask</code> that contains <code>VK_IMAGE_ASPECT_DEPTH_BIT</code>."
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_VERSION_1_3,VK_KHR_format_feature_flags2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-None-06479",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> is sampled with <a href=\"#textures-depth-compare-operation\">depth comparison</a>, the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_SAMPLED_IMAGE_DEPTH_COMPARISON_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-OpTypeImage-06423",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> or <a href=\"#VkBufferView\">VkBufferView</a> being written as a storage image or storage texel buffer where the image format field of the <code>OpTypeImage</code> is <code>Unknown</code> then the view’s format feature <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_STORAGE_WRITE_WITHOUT_FORMAT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-OpTypeImage-06424",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> or <a href=\"#VkBufferView\">VkBufferView</a> being read as a storage image or storage texel buffer where the image format field of the <code>OpTypeImage</code> is <code>Unknown</code> then the view’s format feature <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_STORAGE_READ_WITHOUT_FORMAT_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_IMG_filter_cubic,VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-None-02692",
|
|
"text": " If a <code>VkImageView</code> is sampled with <code>VK_FILTER_CUBIC_EXT</code> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_CUBIC_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_IMG_filter_cubic,VK_EXT_filter_cubic)+!(VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-None-02693",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> being sampled with <code>VK_FILTER_CUBIC_EXT</code> as a result of this command <strong class=\"purple\">must</strong> not have a <a href=\"#VkImageViewType\">VkImageViewType</a> of <code>VK_IMAGE_VIEW_TYPE_3D</code>, <code>VK_IMAGE_VIEW_TYPE_CUBE</code>, or <code>VK_IMAGE_VIEW_TYPE_CUBE_ARRAY</code>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_IMG_filter_cubic,VK_EXT_filter_cubic)+(VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-filterCubic-02694",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> being sampled with <code>VK_FILTER_CUBIC_EXT</code> as a result of this command <strong class=\"purple\">must</strong> have a <a href=\"#VkImageViewType\">VkImageViewType</a> and format that supports cubic filtering, as specified by <code>VkFilterCubicImageViewImageFormatPropertiesEXT</code>::<code>filterCubic</code> returned by <code>vkGetPhysicalDeviceImageFormatProperties2</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-filterCubicMinmax-02695",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> being sampled with <code>VK_FILTER_CUBIC_EXT</code> with a reduction mode of either <code>VK_SAMPLER_REDUCTION_MODE_MIN</code> or <code>VK_SAMPLER_REDUCTION_MODE_MAX</code> as a result of this command <strong class=\"purple\">must</strong> have a <a href=\"#VkImageViewType\">VkImageViewType</a> and format that supports cubic filtering together with minmax filtering, as specified by <code>VkFilterCubicImageViewImageFormatPropertiesEXT</code>::<code>filterCubicMinmax</code> returned by <code>vkGetPhysicalDeviceImageFormatProperties2</code>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_NV_corner_sampled_image)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-flags-02696",
|
|
"text": " Any <a href=\"#VkImage\">VkImage</a> created with a <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a>::<code>flags</code> containing <code>VK_IMAGE_CREATE_CORNER_SAMPLED_BIT_NV</code> sampled as a result of this command <strong class=\"purple\">must</strong> only be sampled using a <a href=\"#VkSamplerAddressMode\">VkSamplerAddressMode</a> of <code>VK_SAMPLER_ADDRESS_MODE_CLAMP_TO_EDGE</code>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+!(VK_VERSION_1_3,VK_KHR_maintenance4)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-None-02698",
|
|
"text": " For each push constant that is statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command, a push constant value <strong class=\"purple\">must</strong> have been set for the same pipeline bind point, with a <code>VkPipelineLayout</code> that is compatible for push constants, with the <code>VkPipelineLayout</code> used to create the current <code>VkPipeline</code>, as described in <a href=\"#descriptorsets-compatibility\">Pipeline Layout Compatibility</a>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_VERSION_1_3,VK_KHR_maintenance4)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-maintenance4-06425",
|
|
"text": " If the <a href=\"#features-maintenance4\"><code>maintenance4</code></a> feature is not enabled, then for each push constant that is statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command, a push constant value <strong class=\"purple\">must</strong> have been set for the same pipeline bind point, with a <code>VkPipelineLayout</code> that is compatible for push constants, with the <code>VkPipelineLayout</code> used to create the current <code>VkPipeline</code>, as described in <a href=\"#descriptorsets-compatibility\">Pipeline Layout Compatibility</a>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+!(VK_EXT_pipeline_robustness)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-None-02705",
|
|
"text": " If the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, and if the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a uniform buffer, it <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-None-02706",
|
|
"text": " If the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, and if the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a storage buffer, it <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_EXT_pipeline_robustness)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-uniformBuffers-06935",
|
|
"text": " If any stage of the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a uniform buffer, and that stage was created without enabling either <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_EXT</code> or <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXT</code> for <code>uniformBuffers</code>, and the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, that stage <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-storageBuffers-06936",
|
|
"text": " If any stage of the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a storage buffer, and that stage was created without enabling either <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_EXT</code> or <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXT</code> for <code>storageBuffers</code>, and the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, that stage <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-commandBuffer-02707",
|
|
"text": " If <code>commandBuffer</code> is an unprotected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, any resource accessed by the <a href=\"#VkPipeline\">VkPipeline</a> object bound to the pipeline bind point used by this command <strong class=\"purple\">must</strong> not be a protected resource"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-commandBuffer-02711",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> not be a protected command buffer"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-None-06550",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> or <code>VkImageView</code> object that enables <a href=\"#samplers-YCbCr-conversion\">sampler {YCbCr} conversion</a>, that object <strong class=\"purple\">must</strong> only be used with <code>OpImageSample*</code> or <code>OpImageSparseSample*</code> instructions"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-ConstOffset-06551",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> or <code>VkImageView</code> object that enables <a href=\"#samplers-YCbCr-conversion\">sampler {YCbCr} conversion</a>, that object <strong class=\"purple\">must</strong> not use the <code>ConstOffset</code> and <code>Offset</code> operands"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_EXT_shader_image_atomic_int64)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-SampledType-04470",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a 64-bit component width is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 64"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-SampledType-04471",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a component width less than 64-bit is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 32"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-SampledType-04472",
|
|
"text": " If a <a href=\"#VkBufferView\">VkBufferView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a 64-bit component width is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 64"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-SampledType-04473",
|
|
"text": " If a <a href=\"#VkBufferView\">VkBufferView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a component width less than 64-bit is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 32"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-sparseImageInt64Atomics-04474",
|
|
"text": " If the <a href=\"#features-sparseImageInt64Atomics\"><code>sparseImageInt64Atomics</code></a> feature is not enabled, <a href=\"#VkImage\">VkImage</a> objects created with the <code>VK_IMAGE_CREATE_SPARSE_RESIDENCY_BIT</code> flag <strong class=\"purple\">must</strong> not be accessed by atomic instructions through an <code>OpTypeImage</code> with a <code>SampledType</code> with a <code>Width</code> of 64 by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-sparseImageInt64Atomics-04475",
|
|
"text": " If the <a href=\"#features-sparseImageInt64Atomics\"><code>sparseImageInt64Atomics</code></a> feature is not enabled, <a href=\"#VkBuffer\">VkBuffer</a> objects created with the <code>VK_BUFFER_CREATE_SPARSE_RESIDENCY_BIT</code> flag <strong class=\"purple\">must</strong> not be accessed by atomic instructions through an <code>OpTypeImage</code> with a <code>SampledType</code> with a <code>Width</code> of 64 by this command"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_QCOM_image_processing)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-OpImageWeightedSampleQCOM-06971",
|
|
"text": " If <code>OpImageWeightedSampleQCOM</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_WEIGHT_SAMPLED_IMAGE_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-OpImageWeightedSampleQCOM-06972",
|
|
"text": " If <code>OpImageWeightedSampleQCOM</code> uses a <a href=\"#VkImageView\">VkImageView</a> as a sample weight image as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_WEIGHT_IMAGE_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-OpImageBoxFilterQCOM-06973",
|
|
"text": " If <code>OpImageBoxFilterQCOM</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_BOX_FILTER_SAMPLED_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-OpImageBlockMatchSSDQCOM-06974",
|
|
"text": " If <code>OpImageBlockMatchSSDQCOM</code> is used to read from an <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-OpImageBlockMatchSADQCOM-06975",
|
|
"text": " If <code>OpImageBlockMatchSADQCOM</code> is used to read from an <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-OpImageBlockMatchSADQCOM-06976",
|
|
"text": " If <code>OpImageBlockMatchSADQCOM</code> or OpImageBlockMatchSSDQCOM is used to read from a reference image as result of this command, then the specified reference coordinates <strong class=\"purple\">must</strong> not fail <a href=\"#textures-integer-coordinate-validation\">integer texel coordinate validation</a>."
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-OpImageWeightedSampleQCOM-06977",
|
|
"text": " If <code>OpImageWeightedSampleQCOM</code>, <code>OpImageBoxFilterQCOM</code>, <code>OpImageBlockMatchSSDQCOM</code>, or <code>OpImageBlockMatchSADQCOM</code> uses a <a href=\"#VkSampler\">VkSampler</a> as a result of this command, then the sampler <strong class=\"purple\">must</strong> have been created with <code>VK_SAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-OpImageWeightedSampleQCOM-06978",
|
|
"text": " If any command other than <code>OpImageWeightedSampleQCOM</code>, <code>OpImageBoxFilterQCOM</code>, <code>OpImageBlockMatchSSDQCOM</code>, or <code>OpImageBlockMatchSADQCOM</code> uses a <a href=\"#VkSampler\">VkSampler</a> as a result of this command, then the sampler <strong class=\"purple\">must</strong> not have been created with <code>VK_SAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM</code>."
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_VERSION_1_1,VK_KHR_multiview)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-maxMultiviewInstanceIndex-02688",
|
|
"text": " If the draw is recorded in a render pass instance with multiview enabled, the maximum instance index <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#VkPhysicalDeviceMultiviewProperties\">VkPhysicalDeviceMultiviewProperties</a>::<code>maxMultiviewInstanceIndex</code>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_EXT_sample_locations)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-sampleLocationsEnable-02689",
|
|
"text": " If the bound graphics pipeline was created with <a href=\"#VkPipelineSampleLocationsStateCreateInfoEXT\">VkPipelineSampleLocationsStateCreateInfoEXT</a>::<code>sampleLocationsEnable</code> set to <code>VK_TRUE</code> and the current subpass has a depth/stencil attachment, then that attachment <strong class=\"purple\">must</strong> have been created with the <code>VK_IMAGE_CREATE_SAMPLE_LOCATIONS_COMPATIBLE_DEPTH_BIT_EXT</code> bit set"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-None-06666",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_SAMPLE_LOCATIONS_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetSampleLocationsEXT\">vkCmdSetSampleLocationsEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-viewportCount-03417",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, but not the <code>VK_DYNAMIC_STATE_SCISSOR_WITH_COUNT</code> dynamic state enabled, then <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>viewportCount</code> parameter of <code>vkCmdSetViewportWithCount</code> <strong class=\"purple\">must</strong> match the <code>VkPipelineViewportStateCreateInfo</code>::<code>scissorCount</code> of the pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-scissorCount-03418",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_SCISSOR_WITH_COUNT</code> dynamic state enabled, but not the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, then <a href=\"#vkCmdSetScissorWithCount\">vkCmdSetScissorWithCount</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>scissorCount</code> parameter of <code>vkCmdSetScissorWithCount</code> <strong class=\"purple\">must</strong> match the <code>VkPipelineViewportStateCreateInfo</code>::<code>viewportCount</code> of the pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-viewportCount-03419",
|
|
"text": " If the bound graphics pipeline state was created with both the <code>VK_DYNAMIC_STATE_SCISSOR_WITH_COUNT</code> and <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic states enabled then both <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a> and <a href=\"#vkCmdSetScissorWithCount\">vkCmdSetScissorWithCount</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>viewportCount</code> parameter of <code>vkCmdSetViewportWithCount</code> <strong class=\"purple\">must</strong> match the <code>scissorCount</code> parameter of <code>vkCmdSetScissorWithCount</code>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_NV_clip_space_w_scaling)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-viewportCount-04137",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, but not the <code>VK_DYNAMIC_STATE_VIEWPORT_W_SCALING_NV</code> dynamic state enabled, then the bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <a href=\"#VkPipelineViewportWScalingStateCreateInfoNV\">VkPipelineViewportWScalingStateCreateInfoNV</a>::<code>viewportCount</code> greater or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-viewportCount-04138",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> and <code>VK_DYNAMIC_STATE_VIEWPORT_W_SCALING_NV</code> dynamic states enabled then the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWScalingNV\">vkCmdSetViewportWScalingNV</a> <strong class=\"purple\">must</strong> be greater than or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_NV_shading_rate_image)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-viewportCount-04139",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, but not the <code>VK_DYNAMIC_STATE_VIEWPORT_SHADING_RATE_PALETTE_NV</code> dynamic state enabled, then the bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <a href=\"#VkPipelineViewportShadingRateImageStateCreateInfoNV\">VkPipelineViewportShadingRateImageStateCreateInfoNV</a>::<code>viewportCount</code> greater or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-viewportCount-04140",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> and <code>VK_DYNAMIC_STATE_VIEWPORT_SHADING_RATE_PALETTE_NV</code> dynamic states enabled then the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportShadingRatePaletteNV\">vkCmdSetViewportShadingRatePaletteNV</a> <strong class=\"purple\">must</strong> be greater than or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_NV_viewport_swizzle)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-VkPipelineVieportCreateInfo-04141",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled and a <a href=\"#VkPipelineViewportSwizzleStateCreateInfoNV\">VkPipelineViewportSwizzleStateCreateInfoNV</a> structure chained from <code>VkPipelineVieportCreateInfo</code>, then the bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <a href=\"#VkPipelineViewportSwizzleStateCreateInfoNV\">VkPipelineViewportSwizzleStateCreateInfoNV</a>::<code>viewportCount</code> greater or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_NV_scissor_exclusive)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-VkPipelineVieportCreateInfo-04142",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled and a <a href=\"#VkPipelineViewportExclusiveScissorStateCreateInfoNV\">VkPipelineViewportExclusiveScissorStateCreateInfoNV</a> structure chained from <code>VkPipelineVieportCreateInfo</code>, then the bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <a href=\"#VkPipelineViewportExclusiveScissorStateCreateInfoNV\">VkPipelineViewportExclusiveScissorStateCreateInfoNV</a>::<code>exclusiveScissorCount</code> greater or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-None-04876",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_RASTERIZER_DISCARD_ENABLE</code> dynamic state enabled then <a href=\"#vkCmdSetRasterizerDiscardEnable\">vkCmdSetRasterizerDiscardEnable</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-None-04877",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_DEPTH_BIAS_ENABLE</code> dynamic state enabled then <a href=\"#vkCmdSetDepthBiasEnable\">vkCmdSetDepthBiasEnable</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-logicOp-04878",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_LOGIC_OP_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetLogicOpEXT\">vkCmdSetLogicOpEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command and the <code>logicOp</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkLogicOp\">VkLogicOp</a> value"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_KHR_fragment_shading_rate)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-primitiveFragmentShadingRateWithMultipleViewports-04552",
|
|
"text": " If the <a href=\"#limits-primitiveFragmentShadingRateWithMultipleViewports\"><code>primitiveFragmentShadingRateWithMultipleViewports</code></a> limit is not supported, the bound graphics pipeline was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, and any of the shader stages of the bound graphics pipeline write to the <code>PrimitiveShadingRateKHR</code> built-in, then <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>viewportCount</code> parameter of <code>vkCmdSetViewportWithCount</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-imageView-06172",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pDepthAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pDepthAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the depth attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-imageView-06173",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pStencilAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pStencilAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the stencil attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-viewMask-06178",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound graphics pipeline <strong class=\"purple\">must</strong> have been created with a <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>viewMask</code> equal to <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>viewMask</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-colorAttachmentCount-06179",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound graphics pipeline <strong class=\"purple\">must</strong> have been created with a <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>colorAttachmentCount</code> equal to <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>colorAttachmentCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-colorAttachmentCount-06180",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>colorAttachmentCount</code> greater than <code>0</code>, then each element of the <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pColorAttachments</code> array with a <code>imageView</code> not equal to <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> <strong class=\"purple\">must</strong> have been created with a <a href=\"#VkFormat\">VkFormat</a> equal to the corresponding element of <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>pColorAttachmentFormats</code> used to create the currently bound graphics pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-pDepthAttachment-06181",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>depthAttachmentFormat</code> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the <a href=\"#VkFormat\">VkFormat</a> used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-pStencilAttachment-06182",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>stencilAttachmentFormat</code> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the <a href=\"#VkFormat\">VkFormat</a> used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_VERSION_1_1,VK_KHR_maintenance2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-imageView-06174",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pDepthAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pDepthAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_STENCIL_ATTACHMENT_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the depth attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-imageView-06175",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pStencilAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pStencilAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_STENCIL_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the stencil attachment"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_VERSION_1_2,VK_KHR_separate_depth_stencil_layouts)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-imageView-06176",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pDepthAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pDepthAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the depth attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-imageView-06177",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pStencilAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pStencilAttachment</code> is <code>VK_IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the stencil attachment"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_EXT_color_write_enable)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-attachmentCount-06667",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_COLOR_WRITE_ENABLE_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetColorWriteEnableEXT\">vkCmdSetColorWriteEnableEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>attachmentCount</code> parameter of <code>vkCmdSetColorWriteEnableEXT</code> <strong class=\"purple\">must</strong> be greater than or equal to the <code>VkPipelineColorBlendStateCreateInfo</code>::<code>attachmentCount</code> of the currently bound graphics pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-attachmentCount-06815",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_COLOR_WRITE_ENABLE_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetColorWriteEnableEXT\">vkCmdSetColorWriteEnableEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>attachmentCount</code> parameter of <code>vkCmdSetColorWriteEnableEXT</code> <strong class=\"purple\">must</strong> be less than or equal to the <code>maxColorAttachments</code> member of <code>VkPhysicalDeviceLimits</code>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_KHR_fragment_shading_rate)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-imageView-06183",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingFragmentShadingRateAttachmentInfoKHR\">VkRenderingFragmentShadingRateAttachmentInfoKHR</a>::<code>imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the currently bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <code>VK_PIPELINE_CREATE_RENDERING_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR</code>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_EXT_fragment_density_map)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-imageView-06184",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingFragmentDensityMapAttachmentInfoEXT\">VkRenderingFragmentDensityMapAttachmentInfoEXT</a>::<code>imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the currently bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <code>VK_PIPELINE_CREATE_RENDERING_FRAGMENT_DENSITY_MAP_ATTACHMENT_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_AMD_mixed_attachment_samples,VK_NV_framebuffer_mixed_samples)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-colorAttachmentCount-06185",
|
|
"text": " If the currently bound pipeline was created with a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> with a <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>colorAttachmentCount</code> parameter greater than <code>0</code>, then each element of the <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pColorAttachments</code> array with a <code>imageView</code> not equal to <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> <strong class=\"purple\">must</strong> have been created with a sample count equal to the corresponding element of the <code>pColorAttachmentSamples</code> member of <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> used to create the currently bound graphics pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-pDepthAttachment-06186",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline was created with a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of the <code>depthStencilAttachmentSamples</code> member of <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the sample count used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-pStencilAttachment-06187",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline was created with a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of the <code>depthStencilAttachmentSamples</code> member of <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the sample count used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-colorAttachmentCount-06188",
|
|
"text": " If the currently bound pipeline was created without a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> with a <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>colorAttachmentCount</code> parameter greater than <code>0</code>, then each element of the <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pColorAttachments</code> array with a <code>imageView</code> not equal to <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> <strong class=\"purple\">must</strong> have been created with a sample count equal to the value of <a href=\"#VkPipelineMultisampleStateCreateInfo\">VkPipelineMultisampleStateCreateInfo</a>::<code>rasterizationSamples</code> used to create the currently bound graphics pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-pDepthAttachment-06189",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline was created without a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of <a href=\"#VkPipelineMultisampleStateCreateInfo\">VkPipelineMultisampleStateCreateInfo</a>::<code>rasterizationSamples</code> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the sample count used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-pStencilAttachment-06190",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline was created without a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of <a href=\"#VkPipelineMultisampleStateCreateInfo\">VkPipelineMultisampleStateCreateInfo</a>::<code>rasterizationSamples</code> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the sample count used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-renderPass-06198",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline <strong class=\"purple\">must</strong> have been created with a <a href=\"#VkGraphicsPipelineCreateInfo\">VkGraphicsPipelineCreateInfo</a>::<code>renderPass</code> equal to <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_EXT_primitives_generated_query)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-primitivesGeneratedQueryWithRasterizerDiscard-06708",
|
|
"text": " If the <a href=\"#features-primitivesGeneratedQueryWithRasterizerDiscard\"><code>primitivesGeneratedQueryWithRasterizerDiscard</code></a> feature is not enabled and the <code>VK_QUERY_TYPE_PRIMITIVES_GENERATED_EXT</code> query is active, <a href=\"#primsrast-discard\">rasterization discard</a> <strong class=\"purple\">must</strong> not be enabled."
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_EXT_primitives_generated_query)+(VK_EXT_transform_feedback)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-primitivesGeneratedQueryWithNonZeroStreams-06709",
|
|
"text": " If the <a href=\"#features-primitivesGeneratedQueryWithNonZeroStreams\"><code>primitivesGeneratedQueryWithNonZeroStreams</code></a> feature is not enabled and the <code>VK_QUERY_TYPE_PRIMITIVES_GENERATED_EXT</code> query is active, the bound graphics pipeline <strong class=\"purple\">must</strong> not have been created with a non-zero value in <code>VkPipelineRasterizationStateStreamCreateInfoEXT</code>::<code>rasterizationStream</code>."
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_NV_mesh_shader)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-stage-06480",
|
|
"text": " The bound graphics pipeline <strong class=\"purple\">must</strong> not have been created with the <a href=\"#VkPipelineShaderStageCreateInfo\">VkPipelineShaderStageCreateInfo</a>::<code>stage</code> member of an element of <a href=\"#VkGraphicsPipelineCreateInfo\">VkGraphicsPipelineCreateInfo</a>::<code>pStages</code> set to <code>VK_SHADER_STAGE_VERTEX_BIT</code>, <code>VK_SHADER_STAGE_TESSELLATION_CONTROL_BIT</code>, <code>VK_SHADER_STAGE_TESSELLATION_EVALUATION_BIT</code> or <code>VK_SHADER_STAGE_GEOMETRY_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_NV_mesh_shader)+(VK_VERSION_1_2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDrawMeshTasksIndirectCountNV-None-04445",
|
|
"text": " If <a href=\"#features-drawIndirectCount\"><code>drawIndirectCount</code></a> is not enabled this function <strong class=\"purple\">must</strong> not be used"
|
|
}
|
|
]
|
|
},
|
|
"VkPipelineVertexInputStateCreateInfo": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkPipelineVertexInputStateCreateInfo-vertexBindingDescriptionCount-00613",
|
|
"text": " <code>vertexBindingDescriptionCount</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxVertexInputBindings</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineVertexInputStateCreateInfo-vertexAttributeDescriptionCount-00614",
|
|
"text": " <code>vertexAttributeDescriptionCount</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxVertexInputAttributes</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineVertexInputStateCreateInfo-binding-00615",
|
|
"text": " For every <code>binding</code> specified by each element of <code>pVertexAttributeDescriptions</code>, a <code>VkVertexInputBindingDescription</code> <strong class=\"purple\">must</strong> exist in <code>pVertexBindingDescriptions</code> with the same value of <code>binding</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineVertexInputStateCreateInfo-pVertexBindingDescriptions-00616",
|
|
"text": " All elements of <code>pVertexBindingDescriptions</code> <strong class=\"purple\">must</strong> describe distinct binding numbers"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineVertexInputStateCreateInfo-pVertexAttributeDescriptions-00617",
|
|
"text": " All elements of <code>pVertexAttributeDescriptions</code> <strong class=\"purple\">must</strong> describe distinct attribute locations"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineVertexInputStateCreateInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PIPELINE_VERTEX_INPUT_STATE_CREATE_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineVertexInputStateCreateInfo-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkPipelineVertexInputDivisorStateCreateInfoEXT\">VkPipelineVertexInputDivisorStateCreateInfoEXT</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineVertexInputStateCreateInfo-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineVertexInputStateCreateInfo-flags-zerobitmask",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineVertexInputStateCreateInfo-pVertexBindingDescriptions-parameter",
|
|
"text": " If <code>vertexBindingDescriptionCount</code> is not <code>0</code>, <code>pVertexBindingDescriptions</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>vertexBindingDescriptionCount</code> valid <a href=\"#VkVertexInputBindingDescription\">VkVertexInputBindingDescription</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineVertexInputStateCreateInfo-pVertexAttributeDescriptions-parameter",
|
|
"text": " If <code>vertexAttributeDescriptionCount</code> is not <code>0</code>, <code>pVertexAttributeDescriptions</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>vertexAttributeDescriptionCount</code> valid <a href=\"#VkVertexInputAttributeDescription\">VkVertexInputAttributeDescription</a> structures"
|
|
}
|
|
]
|
|
},
|
|
"VkVertexInputBindingDescription": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkVertexInputBindingDescription-binding-00618",
|
|
"text": " <code>binding</code> <strong class=\"purple\">must</strong> be less than <code>VkPhysicalDeviceLimits</code>::<code>maxVertexInputBindings</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVertexInputBindingDescription-stride-00619",
|
|
"text": " <code>stride</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxVertexInputBindingStride</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVertexInputBindingDescription-inputRate-parameter",
|
|
"text": " <code>inputRate</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkVertexInputRate\">VkVertexInputRate</a> value"
|
|
}
|
|
],
|
|
"(VK_KHR_portability_subset)": [
|
|
{
|
|
"vuid": "VUID-VkVertexInputBindingDescription-stride-04456",
|
|
"text": " If the <code><a href=\"#VK_KHR_portability_subset\">VK_KHR_portability_subset</a></code> extension is enabled, <code>stride</code> <strong class=\"purple\">must</strong> be a multiple of, and at least as large as, <a href=\"#VkPhysicalDevicePortabilitySubsetPropertiesKHR\">VkPhysicalDevicePortabilitySubsetPropertiesKHR</a>::<code>minVertexInputBindingStrideAlignment</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkVertexInputAttributeDescription": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkVertexInputAttributeDescription-location-00620",
|
|
"text": " <code>location</code> <strong class=\"purple\">must</strong> be less than <code>VkPhysicalDeviceLimits</code>::<code>maxVertexInputAttributes</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVertexInputAttributeDescription-binding-00621",
|
|
"text": " <code>binding</code> <strong class=\"purple\">must</strong> be less than <code>VkPhysicalDeviceLimits</code>::<code>maxVertexInputBindings</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVertexInputAttributeDescription-offset-00622",
|
|
"text": " <code>offset</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxVertexInputAttributeOffset</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVertexInputAttributeDescription-format-00623",
|
|
"text": " <code>format</code> <strong class=\"purple\">must</strong> be allowed as a vertex buffer format, as specified by the <code>VK_FORMAT_FEATURE_VERTEX_BUFFER_BIT</code> flag in <code>VkFormatProperties</code>::<code>bufferFeatures</code> returned by <code>vkGetPhysicalDeviceFormatProperties</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVertexInputAttributeDescription-format-parameter",
|
|
"text": " <code>format</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkFormat\">VkFormat</a> value"
|
|
}
|
|
],
|
|
"(VK_KHR_portability_subset)": [
|
|
{
|
|
"vuid": "VUID-VkVertexInputAttributeDescription-vertexAttributeAccessBeyondStride-04457",
|
|
"text": " If the <code><a href=\"#VK_KHR_portability_subset\">VK_KHR_portability_subset</a></code> extension is enabled, and <a href=\"#VkPhysicalDevicePortabilitySubsetFeaturesKHR\">VkPhysicalDevicePortabilitySubsetFeaturesKHR</a>::<code>vertexAttributeAccessBeyondStride</code> is <code>VK_FALSE</code>, the sum of <code>offset</code> plus the size of the vertex attribute data described by <code>format</code> <strong class=\"purple\">must</strong> not be greater than <code>stride</code> in the <a href=\"#VkVertexInputBindingDescription\">VkVertexInputBindingDescription</a> referenced in <code>binding</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdSetVertexInputEXT": {
|
|
"(VK_EXT_vertex_input_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetVertexInputEXT-None-04790",
|
|
"text": " The <a href=\"#features-vertexInputDynamicState\"><code>vertexInputDynamicState</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetVertexInputEXT-vertexBindingDescriptionCount-04791",
|
|
"text": " <code>vertexBindingDescriptionCount</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxVertexInputBindings</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetVertexInputEXT-vertexAttributeDescriptionCount-04792",
|
|
"text": " <code>vertexAttributeDescriptionCount</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxVertexInputAttributes</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetVertexInputEXT-binding-04793",
|
|
"text": " For every <code>binding</code> specified by each element of <code>pVertexAttributeDescriptions</code>, a <code>VkVertexInputBindingDescription2EXT</code> <strong class=\"purple\">must</strong> exist in <code>pVertexBindingDescriptions</code> with the same value of <code>binding</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetVertexInputEXT-pVertexBindingDescriptions-04794",
|
|
"text": " All elements of <code>pVertexBindingDescriptions</code> <strong class=\"purple\">must</strong> describe distinct binding numbers"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetVertexInputEXT-pVertexAttributeDescriptions-04795",
|
|
"text": " All elements of <code>pVertexAttributeDescriptions</code> <strong class=\"purple\">must</strong> describe distinct attribute locations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetVertexInputEXT-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetVertexInputEXT-pVertexBindingDescriptions-parameter",
|
|
"text": " If <code>vertexBindingDescriptionCount</code> is not <code>0</code>, <code>pVertexBindingDescriptions</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>vertexBindingDescriptionCount</code> valid <a href=\"#VkVertexInputBindingDescription2EXT\">VkVertexInputBindingDescription2EXT</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetVertexInputEXT-pVertexAttributeDescriptions-parameter",
|
|
"text": " If <code>vertexAttributeDescriptionCount</code> is not <code>0</code>, <code>pVertexAttributeDescriptions</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>vertexAttributeDescriptionCount</code> valid <a href=\"#VkVertexInputAttributeDescription2EXT\">VkVertexInputAttributeDescription2EXT</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetVertexInputEXT-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetVertexInputEXT-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetVertexInputEXT-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
]
|
|
},
|
|
"VkVertexInputBindingDescription2EXT": {
|
|
"(VK_EXT_vertex_input_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-VkVertexInputBindingDescription2EXT-binding-04796",
|
|
"text": " <code>binding</code> <strong class=\"purple\">must</strong> be less than <code>VkPhysicalDeviceLimits</code>::<code>maxVertexInputBindings</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVertexInputBindingDescription2EXT-stride-04797",
|
|
"text": " <code>stride</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxVertexInputBindingStride</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVertexInputBindingDescription2EXT-divisor-04798",
|
|
"text": " If the <a href=\"#features-vertexAttributeInstanceRateZeroDivisor\"><code>vertexAttributeInstanceRateZeroDivisor</code></a> feature is not enabled, <code>divisor</code> <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVertexInputBindingDescription2EXT-divisor-04799",
|
|
"text": " If the <a href=\"#features-vertexAttributeInstanceRateDivisor\"><code>vertexAttributeInstanceRateDivisor</code></a> feature is not enabled, <code>divisor</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVertexInputBindingDescription2EXT-divisor-06226",
|
|
"text": " <code>divisor</code> <strong class=\"purple\">must</strong> be a value between <code>0</code> and <code>VkPhysicalDeviceVertexAttributeDivisorPropertiesEXT</code>::<code>maxVertexAttribDivisor</code>, inclusive"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVertexInputBindingDescription2EXT-divisor-06227",
|
|
"text": " If <code>divisor</code> is not <code>1</code> then <code>inputRate</code> <strong class=\"purple\">must</strong> be of type <code>VK_VERTEX_INPUT_RATE_INSTANCE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVertexInputBindingDescription2EXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_VERTEX_INPUT_BINDING_DESCRIPTION_2_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVertexInputBindingDescription2EXT-inputRate-parameter",
|
|
"text": " <code>inputRate</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkVertexInputRate\">VkVertexInputRate</a> value"
|
|
}
|
|
]
|
|
},
|
|
"VkVertexInputAttributeDescription2EXT": {
|
|
"(VK_EXT_vertex_input_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-VkVertexInputAttributeDescription2EXT-location-06228",
|
|
"text": " <code>location</code> <strong class=\"purple\">must</strong> be less than <code>VkPhysicalDeviceLimits</code>::<code>maxVertexInputAttributes</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVertexInputAttributeDescription2EXT-binding-06229",
|
|
"text": " <code>binding</code> <strong class=\"purple\">must</strong> be less than <code>VkPhysicalDeviceLimits</code>::<code>maxVertexInputBindings</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVertexInputAttributeDescription2EXT-offset-06230",
|
|
"text": " <code>offset</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxVertexInputAttributeOffset</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVertexInputAttributeDescription2EXT-format-04805",
|
|
"text": " <code>format</code> <strong class=\"purple\">must</strong> be allowed as a vertex buffer format, as specified by the <code>VK_FORMAT_FEATURE_VERTEX_BUFFER_BIT</code> flag in <code>VkFormatProperties</code>::<code>bufferFeatures</code> returned by <code>vkGetPhysicalDeviceFormatProperties</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVertexInputAttributeDescription2EXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_VERTEX_INPUT_ATTRIBUTE_DESCRIPTION_2_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVertexInputAttributeDescription2EXT-format-parameter",
|
|
"text": " <code>format</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkFormat\">VkFormat</a> value"
|
|
}
|
|
],
|
|
"(VK_EXT_vertex_input_dynamic_state)+(VK_KHR_portability_subset)": [
|
|
{
|
|
"vuid": "VUID-VkVertexInputAttributeDescription2EXT-vertexAttributeAccessBeyondStride-04806",
|
|
"text": " If the <code><a href=\"#VK_KHR_portability_subset\">VK_KHR_portability_subset</a></code> extension is enabled, and <a href=\"#VkPhysicalDevicePortabilitySubsetFeaturesKHR\">VkPhysicalDevicePortabilitySubsetFeaturesKHR</a>::<code>vertexAttributeAccessBeyondStride</code> is <code>VK_FALSE</code>, the sum of <code>offset</code> plus the size of the vertex attribute data described by <code>format</code> <strong class=\"purple\">must</strong> not be greater than <code>stride</code> in the <a href=\"#VkVertexInputBindingDescription2EXT\">VkVertexInputBindingDescription2EXT</a> referenced in <code>binding</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdBindVertexBuffers": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCmdBindVertexBuffers-firstBinding-00624",
|
|
"text": " <code>firstBinding</code> <strong class=\"purple\">must</strong> be less than <code>VkPhysicalDeviceLimits</code>::<code>maxVertexInputBindings</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindVertexBuffers-firstBinding-00625",
|
|
"text": " The sum of <code>firstBinding</code> and <code>bindingCount</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxVertexInputBindings</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindVertexBuffers-pOffsets-00626",
|
|
"text": " All elements of <code>pOffsets</code> <strong class=\"purple\">must</strong> be less than the size of the corresponding element in <code>pBuffers</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindVertexBuffers-pBuffers-00627",
|
|
"text": " All elements of <code>pBuffers</code> <strong class=\"purple\">must</strong> have been created with the <code>VK_BUFFER_USAGE_VERTEX_BUFFER_BIT</code> flag"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindVertexBuffers-pBuffers-00628",
|
|
"text": " Each element of <code>pBuffers</code> that is non-sparse <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindVertexBuffers-pBuffers-04001",
|
|
"text": " If the <a href=\"#features-nullDescriptor\"><code>nullDescriptor</code></a> feature is not enabled, all elements of <code>pBuffers</code> <strong class=\"purple\">must</strong> not be <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindVertexBuffers-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindVertexBuffers-pBuffers-parameter",
|
|
"text": " <code>pBuffers</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>bindingCount</code> valid or <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> <a href=\"#VkBuffer\">VkBuffer</a> handles"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindVertexBuffers-pOffsets-parameter",
|
|
"text": " <code>pOffsets</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>bindingCount</code> <code>VkDeviceSize</code> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindVertexBuffers-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindVertexBuffers-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindVertexBuffers-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindVertexBuffers-bindingCount-arraylength",
|
|
"text": " <code>bindingCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindVertexBuffers-commonparent",
|
|
"text": " Both of <code>commandBuffer</code>, and the elements of <code>pBuffers</code> that are valid handles of non-ignored parameters <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"(VK_EXT_robustness2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBindVertexBuffers-pBuffers-04002",
|
|
"text": " If an element of <code>pBuffers</code> is <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, then the corresponding element of <code>pOffsets</code> <strong class=\"purple\">must</strong> be zero"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdBindVertexBuffers2": {
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBindVertexBuffers2-firstBinding-03355",
|
|
"text": " <code>firstBinding</code> <strong class=\"purple\">must</strong> be less than <code>VkPhysicalDeviceLimits</code>::<code>maxVertexInputBindings</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindVertexBuffers2-firstBinding-03356",
|
|
"text": " The sum of <code>firstBinding</code> and <code>bindingCount</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxVertexInputBindings</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindVertexBuffers2-pOffsets-03357",
|
|
"text": " All elements of <code>pOffsets</code> <strong class=\"purple\">must</strong> be less than the size of the corresponding element in <code>pBuffers</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindVertexBuffers2-pSizes-03358",
|
|
"text": " If <code>pSizes</code> is not <code>NULL</code>, all elements of <code>pOffsets</code> plus <code>pSizes</code> <strong class=\"purple\">must</strong> be less than or equal to the size of the corresponding element in <code>pBuffers</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindVertexBuffers2-pBuffers-03359",
|
|
"text": " All elements of <code>pBuffers</code> <strong class=\"purple\">must</strong> have been created with the <code>VK_BUFFER_USAGE_VERTEX_BUFFER_BIT</code> flag"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindVertexBuffers2-pBuffers-03360",
|
|
"text": " Each element of <code>pBuffers</code> that is non-sparse <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindVertexBuffers2-pBuffers-04111",
|
|
"text": " If the <a href=\"#features-nullDescriptor\"><code>nullDescriptor</code></a> feature is not enabled, all elements of <code>pBuffers</code> <strong class=\"purple\">must</strong> not be <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindVertexBuffers2-pStrides-03362",
|
|
"text": " If <code>pStrides</code> is not <code>NULL</code> each element of <code>pStrides</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxVertexInputBindingStride</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindVertexBuffers2-pStrides-06209",
|
|
"text": " If <code>pStrides</code> is not <code>NULL</code> each element of <code>pStrides</code> <strong class=\"purple\">must</strong> be either 0 or greater than or equal to the maximum extent of all vertex input attributes fetched from the corresponding binding, where the extent is calculated as the <a href=\"#VkVertexInputAttributeDescription\">VkVertexInputAttributeDescription</a>::<code>offset</code> plus <a href=\"#VkVertexInputAttributeDescription\">VkVertexInputAttributeDescription</a>::<code>format</code> size"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindVertexBuffers2-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindVertexBuffers2-pBuffers-parameter",
|
|
"text": " <code>pBuffers</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>bindingCount</code> valid or <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> <a href=\"#VkBuffer\">VkBuffer</a> handles"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindVertexBuffers2-pOffsets-parameter",
|
|
"text": " <code>pOffsets</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>bindingCount</code> <code>VkDeviceSize</code> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindVertexBuffers2-pSizes-parameter",
|
|
"text": " If <code>pSizes</code> is not <code>NULL</code>, <code>pSizes</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>bindingCount</code> <code>VkDeviceSize</code> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindVertexBuffers2-pStrides-parameter",
|
|
"text": " If <code>pStrides</code> is not <code>NULL</code>, <code>pStrides</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>bindingCount</code> <code>VkDeviceSize</code> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindVertexBuffers2-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindVertexBuffers2-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindVertexBuffers2-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindVertexBuffers2-bindingCount-arraylength",
|
|
"text": " If any of <code>pSizes</code>, or <code>pStrides</code> are not <code>NULL</code>, <code>bindingCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindVertexBuffers2-commonparent",
|
|
"text": " Both of <code>commandBuffer</code>, and the elements of <code>pBuffers</code> that are valid handles of non-ignored parameters <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_EXT_robustness2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBindVertexBuffers2-pBuffers-04112",
|
|
"text": " If an element of <code>pBuffers</code> is <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, then the corresponding element of <code>pOffsets</code> <strong class=\"purple\">must</strong> be zero"
|
|
}
|
|
]
|
|
},
|
|
"VkPipelineVertexInputDivisorStateCreateInfoEXT": {
|
|
"(VK_EXT_vertex_attribute_divisor)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineVertexInputDivisorStateCreateInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PIPELINE_VERTEX_INPUT_DIVISOR_STATE_CREATE_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineVertexInputDivisorStateCreateInfoEXT-pVertexBindingDivisors-parameter",
|
|
"text": " <code>pVertexBindingDivisors</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>vertexBindingDivisorCount</code> <a href=\"#VkVertexInputBindingDivisorDescriptionEXT\">VkVertexInputBindingDivisorDescriptionEXT</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineVertexInputDivisorStateCreateInfoEXT-vertexBindingDivisorCount-arraylength",
|
|
"text": " <code>vertexBindingDivisorCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkVertexInputBindingDivisorDescriptionEXT": {
|
|
"(VK_EXT_vertex_attribute_divisor)": [
|
|
{
|
|
"vuid": "VUID-VkVertexInputBindingDivisorDescriptionEXT-binding-01869",
|
|
"text": " <code>binding</code> <strong class=\"purple\">must</strong> be less than <code>VkPhysicalDeviceLimits</code>::<code>maxVertexInputBindings</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVertexInputBindingDivisorDescriptionEXT-vertexAttributeInstanceRateZeroDivisor-02228",
|
|
"text": " If the <code>vertexAttributeInstanceRateZeroDivisor</code> feature is not enabled, <code>divisor</code> <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVertexInputBindingDivisorDescriptionEXT-vertexAttributeInstanceRateDivisor-02229",
|
|
"text": " If the <code>vertexAttributeInstanceRateDivisor</code> feature is not enabled, <code>divisor</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVertexInputBindingDivisorDescriptionEXT-divisor-01870",
|
|
"text": " <code>divisor</code> <strong class=\"purple\">must</strong> be a value between <code>0</code> and <code>VkPhysicalDeviceVertexAttributeDivisorPropertiesEXT</code>::<code>maxVertexAttribDivisor</code>, inclusive"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVertexInputBindingDivisorDescriptionEXT-inputRate-01871",
|
|
"text": " <a href=\"#VkVertexInputBindingDescription\">VkVertexInputBindingDescription</a>::<code>inputRate</code> <strong class=\"purple\">must</strong> be of type <code>VK_VERTEX_INPUT_RATE_INSTANCE</code> for this <code>binding</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPipelineTessellationStateCreateInfo": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkPipelineTessellationStateCreateInfo-patchControlPoints-01214",
|
|
"text": " <code>patchControlPoints</code> <strong class=\"purple\">must</strong> be greater than zero and less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxTessellationPatchSize</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineTessellationStateCreateInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PIPELINE_TESSELLATION_STATE_CREATE_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineTessellationStateCreateInfo-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkPipelineTessellationDomainOriginStateCreateInfo\">VkPipelineTessellationDomainOriginStateCreateInfo</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineTessellationStateCreateInfo-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineTessellationStateCreateInfo-flags-zerobitmask",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPipelineTessellationDomainOriginStateCreateInfo": {
|
|
"(VK_VERSION_1_1,VK_KHR_maintenance2)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineTessellationDomainOriginStateCreateInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PIPELINE_TESSELLATION_DOMAIN_ORIGIN_STATE_CREATE_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineTessellationDomainOriginStateCreateInfo-domainOrigin-parameter",
|
|
"text": " <code>domainOrigin</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkTessellationDomainOrigin\">VkTessellationDomainOrigin</a> value"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdBindTransformFeedbackBuffersEXT": {
|
|
"(VK_EXT_transform_feedback)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBindTransformFeedbackBuffersEXT-transformFeedback-02355",
|
|
"text": " <code>VkPhysicalDeviceTransformFeedbackFeaturesEXT</code>::<code>transformFeedback</code> <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindTransformFeedbackBuffersEXT-firstBinding-02356",
|
|
"text": " <code>firstBinding</code> <strong class=\"purple\">must</strong> be less than <code>VkPhysicalDeviceTransformFeedbackPropertiesEXT</code>::<code>maxTransformFeedbackBuffers</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindTransformFeedbackBuffersEXT-firstBinding-02357",
|
|
"text": " The sum of <code>firstBinding</code> and <code>bindingCount</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceTransformFeedbackPropertiesEXT</code>::<code>maxTransformFeedbackBuffers</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindTransformFeedbackBuffersEXT-pOffsets-02358",
|
|
"text": " All elements of <code>pOffsets</code> <strong class=\"purple\">must</strong> be less than the size of the corresponding element in <code>pBuffers</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindTransformFeedbackBuffersEXT-pOffsets-02359",
|
|
"text": " All elements of <code>pOffsets</code> <strong class=\"purple\">must</strong> be a multiple of 4"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindTransformFeedbackBuffersEXT-pBuffers-02360",
|
|
"text": " All elements of <code>pBuffers</code> <strong class=\"purple\">must</strong> have been created with the <code>VK_BUFFER_USAGE_TRANSFORM_FEEDBACK_BUFFER_BIT_EXT</code> flag"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindTransformFeedbackBuffersEXT-pSize-02361",
|
|
"text": " If the optional <code>pSize</code> array is specified, each element of <code>pSizes</code> <strong class=\"purple\">must</strong> either be <code>VK_WHOLE_SIZE</code>, or be less than or equal to <code>VkPhysicalDeviceTransformFeedbackPropertiesEXT</code>::<code>maxTransformFeedbackBufferSize</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindTransformFeedbackBuffersEXT-pSizes-02362",
|
|
"text": " All elements of <code>pSizes</code> <strong class=\"purple\">must</strong> be either <code>VK_WHOLE_SIZE</code>, or less than or equal to the size of the corresponding buffer in <code>pBuffers</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindTransformFeedbackBuffersEXT-pOffsets-02363",
|
|
"text": " All elements of <code>pOffsets</code> plus <code>pSizes</code>, where the <code>pSizes</code>, element is not <code>VK_WHOLE_SIZE</code>, <strong class=\"purple\">must</strong> be less than or equal to the size of the corresponding buffer in <code>pBuffers</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindTransformFeedbackBuffersEXT-pBuffers-02364",
|
|
"text": " Each element of <code>pBuffers</code> that is non-sparse <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindTransformFeedbackBuffersEXT-None-02365",
|
|
"text": " Transform feedback <strong class=\"purple\">must</strong> not be active when the <code>vkCmdBindTransformFeedbackBuffersEXT</code> command is recorded"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindTransformFeedbackBuffersEXT-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindTransformFeedbackBuffersEXT-pBuffers-parameter",
|
|
"text": " <code>pBuffers</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>bindingCount</code> valid <a href=\"#VkBuffer\">VkBuffer</a> handles"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindTransformFeedbackBuffersEXT-pOffsets-parameter",
|
|
"text": " <code>pOffsets</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>bindingCount</code> <code>VkDeviceSize</code> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindTransformFeedbackBuffersEXT-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindTransformFeedbackBuffersEXT-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindTransformFeedbackBuffersEXT-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindTransformFeedbackBuffersEXT-bindingCount-arraylength",
|
|
"text": " <code>bindingCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindTransformFeedbackBuffersEXT-commonparent",
|
|
"text": " Both of <code>commandBuffer</code>, and the elements of <code>pBuffers</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdBeginTransformFeedbackEXT": {
|
|
"(VK_EXT_transform_feedback)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBeginTransformFeedbackEXT-transformFeedback-02366",
|
|
"text": " <code>VkPhysicalDeviceTransformFeedbackFeaturesEXT</code>::<code>transformFeedback</code> <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginTransformFeedbackEXT-None-02367",
|
|
"text": " Transform feedback <strong class=\"purple\">must</strong> not be active"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginTransformFeedbackEXT-firstCounterBuffer-02368",
|
|
"text": " <code>firstCounterBuffer</code> <strong class=\"purple\">must</strong> be less than <code>VkPhysicalDeviceTransformFeedbackPropertiesEXT</code>::<code>maxTransformFeedbackBuffers</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginTransformFeedbackEXT-firstCounterBuffer-02369",
|
|
"text": " The sum of <code>firstCounterBuffer</code> and <code>counterBufferCount</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceTransformFeedbackPropertiesEXT</code>::<code>maxTransformFeedbackBuffers</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginTransformFeedbackEXT-counterBufferCount-02607",
|
|
"text": " If <code>counterBufferCount</code> is not <code>0</code>, and <code>pCounterBuffers</code> is not <code>NULL</code>, <code>pCounterBuffers</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>counterBufferCount</code> <code>VkBuffer</code> handles that are either valid or <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginTransformFeedbackEXT-pCounterBufferOffsets-02370",
|
|
"text": " For each buffer handle in the array, if it is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> it <strong class=\"purple\">must</strong> reference a buffer large enough to hold 4 bytes at the corresponding offset from the <code>pCounterBufferOffsets</code> array"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginTransformFeedbackEXT-pCounterBuffer-02371",
|
|
"text": " If <code>pCounterBuffer</code> is <code>NULL</code>, then <code>pCounterBufferOffsets</code> <strong class=\"purple\">must</strong> also be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginTransformFeedbackEXT-pCounterBuffers-02372",
|
|
"text": " For each buffer handle in the <code>pCounterBuffers</code> array that is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> it <strong class=\"purple\">must</strong> have been created with a <code>usage</code> value containing <code>VK_BUFFER_USAGE_TRANSFORM_FEEDBACK_COUNTER_BUFFER_BIT_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginTransformFeedbackEXT-None-06233",
|
|
"text": " A valid graphics pipeline <strong class=\"purple\">must</strong> be bound to <code>VK_PIPELINE_BIND_POINT_GRAPHICS</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginTransformFeedbackEXT-None-04128",
|
|
"text": " The last <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader stage</a> of the bound graphics pipeline <strong class=\"purple\">must</strong> have been declared with the <code>Xfb</code> execution mode"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginTransformFeedbackEXT-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginTransformFeedbackEXT-pCounterBufferOffsets-parameter",
|
|
"text": " If <code>counterBufferCount</code> is not <code>0</code>, and <code>pCounterBufferOffsets</code> is not <code>NULL</code>, <code>pCounterBufferOffsets</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>counterBufferCount</code> <code>VkDeviceSize</code> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginTransformFeedbackEXT-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginTransformFeedbackEXT-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginTransformFeedbackEXT-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called inside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginTransformFeedbackEXT-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginTransformFeedbackEXT-commonparent",
|
|
"text": " Both of <code>commandBuffer</code>, and the elements of <code>pCounterBuffers</code> that are valid handles of non-ignored parameters <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)+(VK_VERSION_1_1,VK_KHR_multiview)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBeginTransformFeedbackEXT-None-02373",
|
|
"text": " Transform feedback <strong class=\"purple\">must</strong> not be made active in a render pass instance with multiview enabled"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdEndTransformFeedbackEXT": {
|
|
"(VK_EXT_transform_feedback)": [
|
|
{
|
|
"vuid": "VUID-vkCmdEndTransformFeedbackEXT-transformFeedback-02374",
|
|
"text": " <code>VkPhysicalDeviceTransformFeedbackFeaturesEXT</code>::<code>transformFeedback</code> <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndTransformFeedbackEXT-None-02375",
|
|
"text": " Transform feedback <strong class=\"purple\">must</strong> be active"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndTransformFeedbackEXT-firstCounterBuffer-02376",
|
|
"text": " <code>firstCounterBuffer</code> <strong class=\"purple\">must</strong> be less than <code>VkPhysicalDeviceTransformFeedbackPropertiesEXT</code>::<code>maxTransformFeedbackBuffers</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndTransformFeedbackEXT-firstCounterBuffer-02377",
|
|
"text": " The sum of <code>firstCounterBuffer</code> and <code>counterBufferCount</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceTransformFeedbackPropertiesEXT</code>::<code>maxTransformFeedbackBuffers</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndTransformFeedbackEXT-counterBufferCount-02608",
|
|
"text": " If <code>counterBufferCount</code> is not <code>0</code>, and <code>pCounterBuffers</code> is not <code>NULL</code>, <code>pCounterBuffers</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>counterBufferCount</code> <code>VkBuffer</code> handles that are either valid or <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndTransformFeedbackEXT-pCounterBufferOffsets-02378",
|
|
"text": " For each buffer handle in the array, if it is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> it <strong class=\"purple\">must</strong> reference a buffer large enough to hold 4 bytes at the corresponding offset from the <code>pCounterBufferOffsets</code> array"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndTransformFeedbackEXT-pCounterBuffer-02379",
|
|
"text": " If <code>pCounterBuffer</code> is <code>NULL</code>, then <code>pCounterBufferOffsets</code> <strong class=\"purple\">must</strong> also be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndTransformFeedbackEXT-pCounterBuffers-02380",
|
|
"text": " For each buffer handle in the <code>pCounterBuffers</code> array that is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> it <strong class=\"purple\">must</strong> have been created with a <code>usage</code> value containing <code>VK_BUFFER_USAGE_TRANSFORM_FEEDBACK_COUNTER_BUFFER_BIT_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndTransformFeedbackEXT-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndTransformFeedbackEXT-pCounterBufferOffsets-parameter",
|
|
"text": " If <code>counterBufferCount</code> is not <code>0</code>, and <code>pCounterBufferOffsets</code> is not <code>NULL</code>, <code>pCounterBufferOffsets</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>counterBufferCount</code> <code>VkDeviceSize</code> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndTransformFeedbackEXT-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndTransformFeedbackEXT-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndTransformFeedbackEXT-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called inside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndTransformFeedbackEXT-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndTransformFeedbackEXT-commonparent",
|
|
"text": " Both of <code>commandBuffer</code>, and the elements of <code>pCounterBuffers</code> that are valid handles of non-ignored parameters <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
]
|
|
},
|
|
"VkPipelineViewportSwizzleStateCreateInfoNV": {
|
|
"(VK_NV_viewport_swizzle)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineViewportSwizzleStateCreateInfoNV-viewportCount-01215",
|
|
"text": " <code>viewportCount</code> <strong class=\"purple\">must</strong> be greater than or equal to the <code>viewportCount</code> set in <code>VkPipelineViewportStateCreateInfo</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineViewportSwizzleStateCreateInfoNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PIPELINE_VIEWPORT_SWIZZLE_STATE_CREATE_INFO_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineViewportSwizzleStateCreateInfoNV-flags-zerobitmask",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineViewportSwizzleStateCreateInfoNV-pViewportSwizzles-parameter",
|
|
"text": " <code>pViewportSwizzles</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>viewportCount</code> valid <a href=\"#VkViewportSwizzleNV\">VkViewportSwizzleNV</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineViewportSwizzleStateCreateInfoNV-viewportCount-arraylength",
|
|
"text": " <code>viewportCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkViewportSwizzleNV": {
|
|
"(VK_NV_viewport_swizzle)": [
|
|
{
|
|
"vuid": "VUID-VkViewportSwizzleNV-x-parameter",
|
|
"text": " <code>x</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkViewportCoordinateSwizzleNV\">VkViewportCoordinateSwizzleNV</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkViewportSwizzleNV-y-parameter",
|
|
"text": " <code>y</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkViewportCoordinateSwizzleNV\">VkViewportCoordinateSwizzleNV</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkViewportSwizzleNV-z-parameter",
|
|
"text": " <code>z</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkViewportCoordinateSwizzleNV\">VkViewportCoordinateSwizzleNV</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkViewportSwizzleNV-w-parameter",
|
|
"text": " <code>w</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkViewportCoordinateSwizzleNV\">VkViewportCoordinateSwizzleNV</a> value"
|
|
}
|
|
]
|
|
},
|
|
"VkPipelineRasterizationProvokingVertexStateCreateInfoEXT": {
|
|
"(VK_EXT_provoking_vertex)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineRasterizationProvokingVertexStateCreateInfoEXT-provokingVertexMode-04883",
|
|
"text": " If <code>provokingVertexMode</code> is <code>VK_PROVOKING_VERTEX_MODE_LAST_VERTEX_EXT</code>, then the <a href=\"#features-provokingVertexLast\"><code>provokingVertexLast</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineRasterizationProvokingVertexStateCreateInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PIPELINE_RASTERIZATION_PROVOKING_VERTEX_STATE_CREATE_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineRasterizationProvokingVertexStateCreateInfoEXT-provokingVertexMode-parameter",
|
|
"text": " <code>provokingVertexMode</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkProvokingVertexModeEXT\">VkProvokingVertexModeEXT</a> value"
|
|
}
|
|
]
|
|
},
|
|
"VkPipelineViewportDepthClipControlCreateInfoEXT": {
|
|
"(VK_EXT_depth_clip_control)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineViewportDepthClipControlCreateInfoEXT-negativeOneToOne-06470",
|
|
"text": " If <a href=\"#features-depthClipControl\"><code>depthClipControl</code></a> is not enabled, <code>negativeOneToOne</code> <strong class=\"purple\">must</strong> be <code>VK_FALSE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineViewportDepthClipControlCreateInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PIPELINE_VIEWPORT_DEPTH_CLIP_CONTROL_CREATE_INFO_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPipelineViewportWScalingStateCreateInfoNV": {
|
|
"(VK_NV_clip_space_w_scaling)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineViewportWScalingStateCreateInfoNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PIPELINE_VIEWPORT_W_SCALING_STATE_CREATE_INFO_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineViewportWScalingStateCreateInfoNV-viewportCount-arraylength",
|
|
"text": " <code>viewportCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdSetViewportWScalingNV": {
|
|
"(VK_NV_clip_space_w_scaling)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetViewportWScalingNV-firstViewport-01324",
|
|
"text": " The sum of <code>firstViewport</code> and <code>viewportCount</code> <strong class=\"purple\">must</strong> be between <code>1</code> and <a href=\"#VkPhysicalDeviceLimits\">VkPhysicalDeviceLimits</a>::<code>maxViewports</code>, inclusive"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetViewportWScalingNV-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetViewportWScalingNV-pViewportWScalings-parameter",
|
|
"text": " <code>pViewportWScalings</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>viewportCount</code> <a href=\"#VkViewportWScalingNV\">VkViewportWScalingNV</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetViewportWScalingNV-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetViewportWScalingNV-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetViewportWScalingNV-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetViewportWScalingNV-viewportCount-arraylength",
|
|
"text": " <code>viewportCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPipelineViewportStateCreateInfo": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkPipelineViewportStateCreateInfo-viewportCount-01216",
|
|
"text": " If the <a href=\"#features-multiViewport\"><code>multiViewport</code></a> feature is not enabled, <code>viewportCount</code> <strong class=\"purple\">must</strong> not be greater than <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineViewportStateCreateInfo-scissorCount-01217",
|
|
"text": " If the <a href=\"#features-multiViewport\"><code>multiViewport</code></a> feature is not enabled, <code>scissorCount</code> <strong class=\"purple\">must</strong> not be greater than <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineViewportStateCreateInfo-viewportCount-01218",
|
|
"text": " <code>viewportCount</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxViewports</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineViewportStateCreateInfo-scissorCount-01219",
|
|
"text": " <code>scissorCount</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxViewports</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineViewportStateCreateInfo-x-02821",
|
|
"text": " The <code>x</code> and <code>y</code> members of <code>offset</code> member of any element of <code>pScissors</code> <strong class=\"purple\">must</strong> be greater than or equal to <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineViewportStateCreateInfo-offset-02822",
|
|
"text": " Evaluation of <span class=\"eq\">(<code>offset.x</code> + <code>extent.width</code>)</span> <strong class=\"purple\">must</strong> not cause a signed integer addition overflow for any element of <code>pScissors</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineViewportStateCreateInfo-offset-02823",
|
|
"text": " Evaluation of <span class=\"eq\">(<code>offset.y</code> + <code>extent.height</code>)</span> <strong class=\"purple\">must</strong> not cause a signed integer addition overflow for any element of <code>pScissors</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineViewportStateCreateInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PIPELINE_VIEWPORT_STATE_CREATE_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineViewportStateCreateInfo-pNext-pNext",
|
|
"text": " Each <code>pNext</code> member of any structure (including this one) in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be either <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkPipelineViewportCoarseSampleOrderStateCreateInfoNV\">VkPipelineViewportCoarseSampleOrderStateCreateInfoNV</a>, <a href=\"#VkPipelineViewportDepthClipControlCreateInfoEXT\">VkPipelineViewportDepthClipControlCreateInfoEXT</a>, <a href=\"#VkPipelineViewportExclusiveScissorStateCreateInfoNV\">VkPipelineViewportExclusiveScissorStateCreateInfoNV</a>, <a href=\"#VkPipelineViewportShadingRateImageStateCreateInfoNV\">VkPipelineViewportShadingRateImageStateCreateInfoNV</a>, <a href=\"#VkPipelineViewportSwizzleStateCreateInfoNV\">VkPipelineViewportSwizzleStateCreateInfoNV</a>, or <a href=\"#VkPipelineViewportWScalingStateCreateInfoNV\">VkPipelineViewportWScalingStateCreateInfoNV</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineViewportStateCreateInfo-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineViewportStateCreateInfo-flags-zerobitmask",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
}
|
|
],
|
|
"!(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineViewportStateCreateInfo-scissorCount-01220",
|
|
"text": " <code>scissorCount</code> and <code>viewportCount</code> <strong class=\"purple\">must</strong> be identical"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineViewportStateCreateInfo-viewportCount-arraylength",
|
|
"text": " <code>viewportCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineViewportStateCreateInfo-scissorCount-arraylength",
|
|
"text": " <code>scissorCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineViewportStateCreateInfo-scissorCount-04134",
|
|
"text": " If the graphics pipeline is being created without <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> and <code>VK_DYNAMIC_STATE_SCISSOR_WITH_COUNT</code> set then <code>scissorCount</code> and <code>viewportCount</code> <strong class=\"purple\">must</strong> be identical"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineViewportStateCreateInfo-viewportCount-04135",
|
|
"text": " If the graphics pipeline is being created with <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> set then <code>viewportCount</code> <strong class=\"purple\">must</strong> be <code>0</code>, otherwise it <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineViewportStateCreateInfo-scissorCount-04136",
|
|
"text": " If the graphics pipeline is being created with <code>VK_DYNAMIC_STATE_SCISSOR_WITH_COUNT</code> set then <code>scissorCount</code> <strong class=\"purple\">must</strong> be <code>0</code>, otherwise it <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
],
|
|
"(VK_NV_clip_space_w_scaling)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineViewportStateCreateInfo-viewportWScalingEnable-01726",
|
|
"text": " If the <code>viewportWScalingEnable</code> member of a <a href=\"#VkPipelineViewportWScalingStateCreateInfoNV\">VkPipelineViewportWScalingStateCreateInfoNV</a> structure included in the <code>pNext</code> chain is <code>VK_TRUE</code>, the <code>viewportCount</code> member of the <a href=\"#VkPipelineViewportWScalingStateCreateInfoNV\">VkPipelineViewportWScalingStateCreateInfoNV</a> structure <strong class=\"purple\">must</strong> be greater than or equal to <a href=\"#VkPipelineViewportStateCreateInfo\">VkPipelineViewportStateCreateInfo</a>::<code>viewportCount</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdSetViewportWithCount": {
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+!(VK_VERSION_1_3)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetViewportWithCount-None-03393",
|
|
"text": " The <a href=\"#features-extendedDynamicState\"><code>extendedDynamicState</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetViewportWithCount-viewportCount-03394",
|
|
"text": " <code>viewportCount</code> <strong class=\"purple\">must</strong> be between <code>1</code> and <code>VkPhysicalDeviceLimits</code>::<code>maxViewports</code>, inclusive"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetViewportWithCount-viewportCount-03395",
|
|
"text": " If the <a href=\"#features-multiViewport\"><code>multiViewport</code></a> feature is not enabled, <code>viewportCount</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetViewportWithCount-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetViewportWithCount-pViewports-parameter",
|
|
"text": " <code>pViewports</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>viewportCount</code> valid <a href=\"#VkViewport\">VkViewport</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetViewportWithCount-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetViewportWithCount-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetViewportWithCount-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetViewportWithCount-viewportCount-arraylength",
|
|
"text": " <code>viewportCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_NV_inherited_viewport_scissor)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetViewportWithCount-commandBuffer-04819",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> not have <a href=\"#VkCommandBufferInheritanceViewportScissorInfoNV\">VkCommandBufferInheritanceViewportScissorInfoNV</a>::<code>viewportScissor2D</code> enabled"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdSetScissorWithCount": {
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+!(VK_VERSION_1_3)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetScissorWithCount-None-03396",
|
|
"text": " The <a href=\"#features-extendedDynamicState\"><code>extendedDynamicState</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetScissorWithCount-scissorCount-03397",
|
|
"text": " <code>scissorCount</code> <strong class=\"purple\">must</strong> be between <code>1</code> and <code>VkPhysicalDeviceLimits</code>::<code>maxViewports</code>, inclusive"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetScissorWithCount-scissorCount-03398",
|
|
"text": " If the <a href=\"#features-multiViewport\"><code>multiViewport</code></a> feature is not enabled, <code>scissorCount</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetScissorWithCount-x-03399",
|
|
"text": " The <code>x</code> and <code>y</code> members of <code>offset</code> member of any element of <code>pScissors</code> <strong class=\"purple\">must</strong> be greater than or equal to <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetScissorWithCount-offset-03400",
|
|
"text": " Evaluation of <span class=\"eq\">(<code>offset.x</code> + <code>extent.width</code>)</span> <strong class=\"purple\">must</strong> not cause a signed integer addition overflow for any element of <code>pScissors</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetScissorWithCount-offset-03401",
|
|
"text": " Evaluation of <span class=\"eq\">(<code>offset.y</code> + <code>extent.height</code>)</span> <strong class=\"purple\">must</strong> not cause a signed integer addition overflow for any element of <code>pScissors</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetScissorWithCount-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetScissorWithCount-pScissors-parameter",
|
|
"text": " <code>pScissors</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>scissorCount</code> <a href=\"#VkRect2D\">VkRect2D</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetScissorWithCount-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetScissorWithCount-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetScissorWithCount-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetScissorWithCount-scissorCount-arraylength",
|
|
"text": " <code>scissorCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_NV_inherited_viewport_scissor)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetScissorWithCount-commandBuffer-04820",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> not have <a href=\"#VkCommandBufferInheritanceViewportScissorInfoNV\">VkCommandBufferInheritanceViewportScissorInfoNV</a>::<code>viewportScissor2D</code> enabled"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdSetViewport": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetViewport-firstViewport-01223",
|
|
"text": " The sum of <code>firstViewport</code> and <code>viewportCount</code> <strong class=\"purple\">must</strong> be between <code>1</code> and <code>VkPhysicalDeviceLimits</code>::<code>maxViewports</code>, inclusive"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetViewport-firstViewport-01224",
|
|
"text": " If the <a href=\"#features-multiViewport\"><code>multiViewport</code></a> feature is not enabled, <code>firstViewport</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetViewport-viewportCount-01225",
|
|
"text": " If the <a href=\"#features-multiViewport\"><code>multiViewport</code></a> feature is not enabled, <code>viewportCount</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetViewport-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetViewport-pViewports-parameter",
|
|
"text": " <code>pViewports</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>viewportCount</code> valid <a href=\"#VkViewport\">VkViewport</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetViewport-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetViewport-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetViewport-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetViewport-viewportCount-arraylength",
|
|
"text": " <code>viewportCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
],
|
|
"(VK_NV_inherited_viewport_scissor)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetViewport-commandBuffer-04821",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> not have <a href=\"#VkCommandBufferInheritanceViewportScissorInfoNV\">VkCommandBufferInheritanceViewportScissorInfoNV</a>::<code>viewportScissor2D</code> enabled"
|
|
}
|
|
]
|
|
},
|
|
"VkViewport": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkViewport-width-01770",
|
|
"text": " <code>width</code> <strong class=\"purple\">must</strong> be greater than <code>0.0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkViewport-width-01771",
|
|
"text": " <code>width</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxViewportDimensions</code>[0]"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkViewport-height-01773",
|
|
"text": " The absolute value of <code>height</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxViewportDimensions</code>[1]"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkViewport-x-01774",
|
|
"text": " <code>x</code> <strong class=\"purple\">must</strong> be greater than or equal to <code>viewportBoundsRange</code>[0]"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkViewport-x-01232",
|
|
"text": " <span class=\"eq\">(<code>x</code> + <code>width</code>)</span> <strong class=\"purple\">must</strong> be less than or equal to <code>viewportBoundsRange</code>[1]"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkViewport-y-01775",
|
|
"text": " <code>y</code> <strong class=\"purple\">must</strong> be greater than or equal to <code>viewportBoundsRange</code>[0]"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkViewport-y-01233",
|
|
"text": " <span class=\"eq\">(<code>y</code> + <code>height</code>)</span> <strong class=\"purple\">must</strong> be less than or equal to <code>viewportBoundsRange</code>[1]"
|
|
}
|
|
],
|
|
"!(VK_VERSION_1_1,VK_KHR_maintenance1,VK_AMD_negative_viewport_height)": [
|
|
{
|
|
"vuid": "VUID-VkViewport-height-01772",
|
|
"text": " <code>height</code> <strong class=\"purple\">must</strong> be greater than <code>0.0</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_maintenance1,VK_AMD_negative_viewport_height)": [
|
|
{
|
|
"vuid": "VUID-VkViewport-y-01776",
|
|
"text": " <code>y</code> <strong class=\"purple\">must</strong> be less than or equal to <code>viewportBoundsRange</code>[1]"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkViewport-y-01777",
|
|
"text": " <span class=\"eq\">(<code>y</code> + <code>height</code>)</span> <strong class=\"purple\">must</strong> be greater than or equal to <code>viewportBoundsRange</code>[0]"
|
|
}
|
|
],
|
|
"(VK_EXT_depth_range_unrestricted)": [
|
|
{
|
|
"vuid": "VUID-VkViewport-minDepth-01234",
|
|
"text": " Unless <code><a href=\"#VK_EXT_depth_range_unrestricted\">VK_EXT_depth_range_unrestricted</a></code> extension is enabled <code>minDepth</code> <strong class=\"purple\">must</strong> be between <code>0.0</code> and <code>1.0</code>, inclusive"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkViewport-maxDepth-01235",
|
|
"text": " Unless <code><a href=\"#VK_EXT_depth_range_unrestricted\">VK_EXT_depth_range_unrestricted</a></code> extension is enabled <code>maxDepth</code> <strong class=\"purple\">must</strong> be between <code>0.0</code> and <code>1.0</code>, inclusive"
|
|
}
|
|
],
|
|
"!(VK_EXT_depth_range_unrestricted)": [
|
|
{
|
|
"vuid": "VUID-VkViewport-minDepth-02540",
|
|
"text": " <code>minDepth</code> <strong class=\"purple\">must</strong> be between <code>0.0</code> and <code>1.0</code>, inclusive"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkViewport-maxDepth-02541",
|
|
"text": " <code>maxDepth</code> <strong class=\"purple\">must</strong> be between <code>0.0</code> and <code>1.0</code>, inclusive"
|
|
}
|
|
]
|
|
},
|
|
"VkPipelineRasterizationStateCreateInfo": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkPipelineRasterizationStateCreateInfo-depthClampEnable-00782",
|
|
"text": " If the <a href=\"#features-depthClamp\"><code>depthClamp</code></a> feature is not enabled, <code>depthClampEnable</code> <strong class=\"purple\">must</strong> be <code>VK_FALSE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineRasterizationStateCreateInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PIPELINE_RASTERIZATION_STATE_CREATE_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineRasterizationStateCreateInfo-pNext-pNext",
|
|
"text": " Each <code>pNext</code> member of any structure (including this one) in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be either <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkPipelineRasterizationConservativeStateCreateInfoEXT\">VkPipelineRasterizationConservativeStateCreateInfoEXT</a>, <a href=\"#VkPipelineRasterizationDepthClipStateCreateInfoEXT\">VkPipelineRasterizationDepthClipStateCreateInfoEXT</a>, <a href=\"#VkPipelineRasterizationLineStateCreateInfoEXT\">VkPipelineRasterizationLineStateCreateInfoEXT</a>, <a href=\"#VkPipelineRasterizationProvokingVertexStateCreateInfoEXT\">VkPipelineRasterizationProvokingVertexStateCreateInfoEXT</a>, <a href=\"#VkPipelineRasterizationStateRasterizationOrderAMD\">VkPipelineRasterizationStateRasterizationOrderAMD</a>, or <a href=\"#VkPipelineRasterizationStateStreamCreateInfoEXT\">VkPipelineRasterizationStateStreamCreateInfoEXT</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineRasterizationStateCreateInfo-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineRasterizationStateCreateInfo-flags-zerobitmask",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineRasterizationStateCreateInfo-polygonMode-parameter",
|
|
"text": " <code>polygonMode</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPolygonMode\">VkPolygonMode</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineRasterizationStateCreateInfo-cullMode-parameter",
|
|
"text": " <code>cullMode</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkCullModeFlagBits\">VkCullModeFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineRasterizationStateCreateInfo-frontFace-parameter",
|
|
"text": " <code>frontFace</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkFrontFace\">VkFrontFace</a> value"
|
|
}
|
|
],
|
|
"!(VK_NV_fill_rectangle)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineRasterizationStateCreateInfo-polygonMode-01413",
|
|
"text": " If the <a href=\"#features-fillModeNonSolid\"><code>fillModeNonSolid</code></a> feature is not enabled, <code>polygonMode</code> <strong class=\"purple\">must</strong> be <code>VK_POLYGON_MODE_FILL</code>"
|
|
}
|
|
],
|
|
"(VK_NV_fill_rectangle)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineRasterizationStateCreateInfo-polygonMode-01507",
|
|
"text": " If the <a href=\"#features-fillModeNonSolid\"><code>fillModeNonSolid</code></a> feature is not enabled, <code>polygonMode</code> <strong class=\"purple\">must</strong> be <code>VK_POLYGON_MODE_FILL</code> or <code>VK_POLYGON_MODE_FILL_RECTANGLE_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineRasterizationStateCreateInfo-polygonMode-01414",
|
|
"text": " If the <code><a href=\"#VK_NV_fill_rectangle\">VK_NV_fill_rectangle</a></code> extension is not enabled, <code>polygonMode</code> <strong class=\"purple\">must</strong> not be <code>VK_POLYGON_MODE_FILL_RECTANGLE_NV</code>"
|
|
}
|
|
],
|
|
"(VK_KHR_portability_subset)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineRasterizationStateCreateInfo-pointPolygons-04458",
|
|
"text": " If the <code><a href=\"#VK_KHR_portability_subset\">VK_KHR_portability_subset</a></code> extension is enabled, and <a href=\"#VkPhysicalDevicePortabilitySubsetFeaturesKHR\">VkPhysicalDevicePortabilitySubsetFeaturesKHR</a>::<code>pointPolygons</code> is <code>VK_FALSE</code>, and <code>rasterizerDiscardEnable</code> is <code>VK_FALSE</code>, <code>polygonMode</code> <strong class=\"purple\">must</strong> not be <code>VK_POLYGON_MODE_POINT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPipelineRasterizationDepthClipStateCreateInfoEXT": {
|
|
"(VK_EXT_depth_clip_enable)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineRasterizationDepthClipStateCreateInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PIPELINE_RASTERIZATION_DEPTH_CLIP_STATE_CREATE_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineRasterizationDepthClipStateCreateInfoEXT-flags-zerobitmask",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPipelineMultisampleStateCreateInfo": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkPipelineMultisampleStateCreateInfo-sampleShadingEnable-00784",
|
|
"text": " If the <a href=\"#features-sampleRateShading\"><code>sampleRateShading</code></a> feature is not enabled, <code>sampleShadingEnable</code> <strong class=\"purple\">must</strong> be <code>VK_FALSE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineMultisampleStateCreateInfo-alphaToOneEnable-00785",
|
|
"text": " If the <a href=\"#features-alphaToOne\"><code>alphaToOne</code></a> feature is not enabled, <code>alphaToOneEnable</code> <strong class=\"purple\">must</strong> be <code>VK_FALSE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineMultisampleStateCreateInfo-minSampleShading-00786",
|
|
"text": " <code>minSampleShading</code> <strong class=\"purple\">must</strong> be in the range <span class=\"eq\">[0,1]</span>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineMultisampleStateCreateInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PIPELINE_MULTISAMPLE_STATE_CREATE_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineMultisampleStateCreateInfo-pNext-pNext",
|
|
"text": " Each <code>pNext</code> member of any structure (including this one) in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be either <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkPipelineCoverageModulationStateCreateInfoNV\">VkPipelineCoverageModulationStateCreateInfoNV</a>, <a href=\"#VkPipelineCoverageReductionStateCreateInfoNV\">VkPipelineCoverageReductionStateCreateInfoNV</a>, <a href=\"#VkPipelineCoverageToColorStateCreateInfoNV\">VkPipelineCoverageToColorStateCreateInfoNV</a>, or <a href=\"#VkPipelineSampleLocationsStateCreateInfoEXT\">VkPipelineSampleLocationsStateCreateInfoEXT</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineMultisampleStateCreateInfo-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineMultisampleStateCreateInfo-flags-zerobitmask",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineMultisampleStateCreateInfo-rasterizationSamples-parameter",
|
|
"text": " <code>rasterizationSamples</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSampleCountFlagBits\">VkSampleCountFlagBits</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineMultisampleStateCreateInfo-pSampleMask-parameter",
|
|
"text": " If <code>pSampleMask</code> is not <code>NULL</code>, <code>pSampleMask</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of \\(\\lceil{\\mathit{rasterizationSamples} \\over 32}\\rceil\\) <code>VkSampleMask</code> values"
|
|
}
|
|
],
|
|
"(VK_NV_framebuffer_mixed_samples)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineMultisampleStateCreateInfo-rasterizationSamples-01415",
|
|
"text": " If the <code><a href=\"#VK_NV_framebuffer_mixed_samples\">VK_NV_framebuffer_mixed_samples</a></code> extension is enabled, and if the subpass has any color attachments and <code>rasterizationSamples</code> is greater than the number of color samples, then <code>sampleShadingEnable</code> <strong class=\"purple\">must</strong> be <code>VK_FALSE</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdSetRasterizerDiscardEnable": {
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state2)+!(VK_VERSION_1_3)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetRasterizerDiscardEnable-None-04871",
|
|
"text": " The <a href=\"#features-extendedDynamicState2\"><code>extendedDynamicState2</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetRasterizerDiscardEnable-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetRasterizerDiscardEnable-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetRasterizerDiscardEnable-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetRasterizerDiscardEnable-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
]
|
|
},
|
|
"VkPipelineRasterizationStateStreamCreateInfoEXT": {
|
|
"(VK_EXT_transform_feedback)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineRasterizationStateStreamCreateInfoEXT-geometryStreams-02324",
|
|
"text": " <code>VkPhysicalDeviceTransformFeedbackFeaturesEXT</code>::<code>geometryStreams</code> <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineRasterizationStateStreamCreateInfoEXT-rasterizationStream-02325",
|
|
"text": " <code>rasterizationStream</code> <strong class=\"purple\">must</strong> be less than <a href=\"#VkPhysicalDeviceTransformFeedbackPropertiesEXT\">VkPhysicalDeviceTransformFeedbackPropertiesEXT</a>::<code>maxTransformFeedbackStreams</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineRasterizationStateStreamCreateInfoEXT-rasterizationStream-02326",
|
|
"text": " <code>rasterizationStream</code> <strong class=\"purple\">must</strong> be zero if <code>VkPhysicalDeviceTransformFeedbackPropertiesEXT</code>::<code>transformFeedbackRasterizationStreamSelect</code> is <code>VK_FALSE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineRasterizationStateStreamCreateInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PIPELINE_RASTERIZATION_STATE_STREAM_CREATE_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineRasterizationStateStreamCreateInfoEXT-flags-zerobitmask",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPipelineRasterizationStateRasterizationOrderAMD": {
|
|
"(VK_AMD_rasterization_order)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineRasterizationStateRasterizationOrderAMD-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PIPELINE_RASTERIZATION_STATE_RASTERIZATION_ORDER_AMD</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineRasterizationStateRasterizationOrderAMD-rasterizationOrder-parameter",
|
|
"text": " <code>rasterizationOrder</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkRasterizationOrderAMD\">VkRasterizationOrderAMD</a> value"
|
|
}
|
|
]
|
|
},
|
|
"VkPipelineSampleLocationsStateCreateInfoEXT": {
|
|
"(VK_EXT_sample_locations)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineSampleLocationsStateCreateInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PIPELINE_SAMPLE_LOCATIONS_STATE_CREATE_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineSampleLocationsStateCreateInfoEXT-sampleLocationsInfo-parameter",
|
|
"text": " <code>sampleLocationsInfo</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSampleLocationsInfoEXT\">VkSampleLocationsInfoEXT</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkSampleLocationsInfoEXT": {
|
|
"(VK_EXT_sample_locations)": [
|
|
{
|
|
"vuid": "VUID-VkSampleLocationsInfoEXT-sampleLocationsPerPixel-01526",
|
|
"text": " <code>sampleLocationsPerPixel</code> <strong class=\"purple\">must</strong> be a bit value that is set in <a href=\"#VkPhysicalDeviceSampleLocationsPropertiesEXT\">VkPhysicalDeviceSampleLocationsPropertiesEXT</a>::<code>sampleLocationSampleCounts</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSampleLocationsInfoEXT-sampleLocationsCount-01527",
|
|
"text": " <code>sampleLocationsCount</code> <strong class=\"purple\">must</strong> equal <span class=\"eq\"><code>sampleLocationsPerPixel</code> {times} <code>sampleLocationGridSize.width</code> {times} <code>sampleLocationGridSize.height</code></span>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSampleLocationsInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_SAMPLE_LOCATIONS_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSampleLocationsInfoEXT-pSampleLocations-parameter",
|
|
"text": " If <code>sampleLocationsCount</code> is not <code>0</code>, <code>pSampleLocations</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>sampleLocationsCount</code> <a href=\"#VkSampleLocationEXT\">VkSampleLocationEXT</a> structures"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdSetSampleLocationsEXT": {
|
|
"(VK_EXT_sample_locations)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetSampleLocationsEXT-sampleLocationsPerPixel-01529",
|
|
"text": " The <code>sampleLocationsPerPixel</code> member of <code>pSampleLocationsInfo</code> <strong class=\"purple\">must</strong> equal the <code>rasterizationSamples</code> member of the <a href=\"#VkPipelineMultisampleStateCreateInfo\">VkPipelineMultisampleStateCreateInfo</a> structure the bound graphics pipeline has been created with"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetSampleLocationsEXT-variableSampleLocations-01530",
|
|
"text": " If <a href=\"#VkPhysicalDeviceSampleLocationsPropertiesEXT\">VkPhysicalDeviceSampleLocationsPropertiesEXT</a>::<code>variableSampleLocations</code> is <code>VK_FALSE</code> then the current render pass <strong class=\"purple\">must</strong> have been begun by specifying a <a href=\"#VkRenderPassSampleLocationsBeginInfoEXT\">VkRenderPassSampleLocationsBeginInfoEXT</a> structure whose <code>pPostSubpassSampleLocations</code> member contains an element with a <code>subpassIndex</code> matching the current subpass index and the <code>sampleLocationsInfo</code> member of that element <strong class=\"purple\">must</strong> match the sample locations state pointed to by <code>pSampleLocationsInfo</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetSampleLocationsEXT-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetSampleLocationsEXT-pSampleLocationsInfo-parameter",
|
|
"text": " <code>pSampleLocationsInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkSampleLocationsInfoEXT\">VkSampleLocationsInfoEXT</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetSampleLocationsEXT-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetSampleLocationsEXT-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetSampleLocationsEXT-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
]
|
|
},
|
|
"vkGetPhysicalDeviceFragmentShadingRatesKHR": {
|
|
"(VK_KHR_fragment_shading_rate)": [
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceFragmentShadingRatesKHR-physicalDevice-parameter",
|
|
"text": " <code>physicalDevice</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceFragmentShadingRatesKHR-pFragmentShadingRateCount-parameter",
|
|
"text": " <code>pFragmentShadingRateCount</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>uint32_t</code> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceFragmentShadingRatesKHR-pFragmentShadingRates-parameter",
|
|
"text": " If the value referenced by <code>pFragmentShadingRateCount</code> is not <code>0</code>, and <code>pFragmentShadingRates</code> is not <code>NULL</code>, <code>pFragmentShadingRates</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>pFragmentShadingRateCount</code> <a href=\"#VkPhysicalDeviceFragmentShadingRateKHR\">VkPhysicalDeviceFragmentShadingRateKHR</a> structures"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceFragmentShadingRateKHR": {
|
|
"(VK_KHR_fragment_shading_rate)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceFragmentShadingRateKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_FRAGMENT_SHADING_RATE_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceFragmentShadingRateKHR-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPipelineFragmentShadingRateStateCreateInfoKHR": {
|
|
"(VK_KHR_fragment_shading_rate)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineFragmentShadingRateStateCreateInfoKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PIPELINE_FRAGMENT_SHADING_RATE_STATE_CREATE_INFO_KHR</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdSetFragmentShadingRateKHR": {
|
|
"(VK_KHR_fragment_shading_rate)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetFragmentShadingRateKHR-pipelineFragmentShadingRate-04507",
|
|
"text": " If <a href=\"#features-pipelineFragmentShadingRate\"><code>pipelineFragmentShadingRate</code></a> is not enabled, <code>pFragmentSize->width</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetFragmentShadingRateKHR-pipelineFragmentShadingRate-04508",
|
|
"text": " If <a href=\"#features-pipelineFragmentShadingRate\"><code>pipelineFragmentShadingRate</code></a> is not enabled, <code>pFragmentSize->height</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetFragmentShadingRateKHR-pipelineFragmentShadingRate-04509",
|
|
"text": " One of <a href=\"#features-pipelineFragmentShadingRate\"><code>pipelineFragmentShadingRate</code></a>, <a href=\"#features-primitiveFragmentShadingRate\"><code>primitiveFragmentShadingRate</code></a>, or <a href=\"#features-attachmentFragmentShadingRate\"><code>attachmentFragmentShadingRate</code></a> <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetFragmentShadingRateKHR-primitiveFragmentShadingRate-04510",
|
|
"text": " If the <a href=\"#features-primitiveFragmentShadingRate\"><code>primitiveFragmentShadingRate</code></a> feature is not enabled, <code>combinerOps</code>[0] <strong class=\"purple\">must</strong> be <code>VK_FRAGMENT_SHADING_RATE_COMBINER_OP_KEEP_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetFragmentShadingRateKHR-attachmentFragmentShadingRate-04511",
|
|
"text": " If the <a href=\"#features-attachmentFragmentShadingRate\"><code>attachmentFragmentShadingRate</code></a> feature is not enabled, <code>combinerOps</code>[1] <strong class=\"purple\">must</strong> be <code>VK_FRAGMENT_SHADING_RATE_COMBINER_OP_KEEP_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetFragmentShadingRateKHR-fragmentSizeNonTrivialCombinerOps-04512",
|
|
"text": " If the <a href=\"#limits-fragmentShadingRateNonTrivialCombinerOps\"><code>fragmentSizeNonTrivialCombinerOps</code></a> limit is not supported, elements of <code>combinerOps</code> <strong class=\"purple\">must</strong> be either <code>VK_FRAGMENT_SHADING_RATE_COMBINER_OP_KEEP_KHR</code> or <code>VK_FRAGMENT_SHADING_RATE_COMBINER_OP_REPLACE_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetFragmentShadingRateKHR-pFragmentSize-04513",
|
|
"text": " <code>pFragmentSize->width</code> <strong class=\"purple\">must</strong> be greater than or equal to <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetFragmentShadingRateKHR-pFragmentSize-04514",
|
|
"text": " <code>pFragmentSize->height</code> <strong class=\"purple\">must</strong> be greater than or equal to <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetFragmentShadingRateKHR-pFragmentSize-04515",
|
|
"text": " <code>pFragmentSize->width</code> <strong class=\"purple\">must</strong> be a power-of-two value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetFragmentShadingRateKHR-pFragmentSize-04516",
|
|
"text": " <code>pFragmentSize->height</code> <strong class=\"purple\">must</strong> be a power-of-two value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetFragmentShadingRateKHR-pFragmentSize-04517",
|
|
"text": " <code>pFragmentSize->width</code> <strong class=\"purple\">must</strong> be less than or equal to <code>4</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetFragmentShadingRateKHR-pFragmentSize-04518",
|
|
"text": " <code>pFragmentSize->height</code> <strong class=\"purple\">must</strong> be less than or equal to <code>4</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetFragmentShadingRateKHR-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetFragmentShadingRateKHR-pFragmentSize-parameter",
|
|
"text": " <code>pFragmentSize</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkExtent2D\">VkExtent2D</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetFragmentShadingRateKHR-combinerOps-parameter",
|
|
"text": " Any given element of <code>combinerOps</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkFragmentShadingRateCombinerOpKHR\">VkFragmentShadingRateCombinerOpKHR</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetFragmentShadingRateKHR-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetFragmentShadingRateKHR-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetFragmentShadingRateKHR-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
]
|
|
},
|
|
"VkPipelineFragmentShadingRateEnumStateCreateInfoNV": {
|
|
"(VK_NV_fragment_shading_rate_enums)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineFragmentShadingRateEnumStateCreateInfoNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PIPELINE_FRAGMENT_SHADING_RATE_ENUM_STATE_CREATE_INFO_NV</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdSetFragmentShadingRateEnumNV": {
|
|
"(VK_NV_fragment_shading_rate_enums)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetFragmentShadingRateEnumNV-pipelineFragmentShadingRate-04576",
|
|
"text": " If <a href=\"#features-pipelineFragmentShadingRate\"><code>pipelineFragmentShadingRate</code></a> is not enabled, <code>shadingRate</code> <strong class=\"purple\">must</strong> be <code>VK_FRAGMENT_SHADING_RATE_1_INVOCATION_PER_PIXEL_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetFragmentShadingRateEnumNV-supersampleFragmentShadingRates-04577",
|
|
"text": " If <a href=\"#features-supersampleFragmentShadingRates\"><code>supersampleFragmentShadingRates</code></a> is not enabled, <code>shadingRate</code> <strong class=\"purple\">must</strong> not be <code>VK_FRAGMENT_SHADING_RATE_2_INVOCATIONS_PER_PIXEL_NV</code>, <code>VK_FRAGMENT_SHADING_RATE_4_INVOCATIONS_PER_PIXEL_NV</code>, <code>VK_FRAGMENT_SHADING_RATE_8_INVOCATIONS_PER_PIXEL_NV</code>, or <code>VK_FRAGMENT_SHADING_RATE_16_INVOCATIONS_PER_PIXEL_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetFragmentShadingRateEnumNV-noInvocationFragmentShadingRates-04578",
|
|
"text": " If <a href=\"#features-noInvocationFragmentShadingRates\"><code>noInvocationFragmentShadingRates</code></a> is not enabled, <code>shadingRate</code> <strong class=\"purple\">must</strong> not be <code>VK_FRAGMENT_SHADING_RATE_NO_INVOCATIONS_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetFragmentShadingRateEnumNV-fragmentShadingRateEnums-04579",
|
|
"text": " The <a href=\"#features-fragmentShadingRateEnums\"><code>fragmentShadingRateEnums</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetFragmentShadingRateEnumNV-pipelineFragmentShadingRate-04580",
|
|
"text": " One of the <a href=\"#features-pipelineFragmentShadingRate\"><code>pipelineFragmentShadingRate</code></a>, <a href=\"#features-primitiveFragmentShadingRate\"><code>primitiveFragmentShadingRate</code></a>, or <a href=\"#features-attachmentFragmentShadingRate\"><code>attachmentFragmentShadingRate</code></a> features <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetFragmentShadingRateEnumNV-primitiveFragmentShadingRate-04581",
|
|
"text": " If the <a href=\"#features-primitiveFragmentShadingRate\"><code>primitiveFragmentShadingRate</code></a> feature is not enabled, <code>combinerOps</code>[0] <strong class=\"purple\">must</strong> be <code>VK_FRAGMENT_SHADING_RATE_COMBINER_OP_KEEP_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetFragmentShadingRateEnumNV-attachmentFragmentShadingRate-04582",
|
|
"text": " If the <a href=\"#features-attachmentFragmentShadingRate\"><code>attachmentFragmentShadingRate</code></a> feature is not enabled, <code>combinerOps</code>[1] <strong class=\"purple\">must</strong> be <code>VK_FRAGMENT_SHADING_RATE_COMBINER_OP_KEEP_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetFragmentShadingRateEnumNV-fragmentSizeNonTrivialCombinerOps-04583",
|
|
"text": " If the <a href=\"#limits-fragmentShadingRateNonTrivialCombinerOps\"><code>fragmentSizeNonTrivialCombinerOps</code></a> limit is not supported, elements of <code>combinerOps</code> <strong class=\"purple\">must</strong> be either <code>VK_FRAGMENT_SHADING_RATE_COMBINER_OP_KEEP_KHR</code> or <code>VK_FRAGMENT_SHADING_RATE_COMBINER_OP_REPLACE_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetFragmentShadingRateEnumNV-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetFragmentShadingRateEnumNV-shadingRate-parameter",
|
|
"text": " <code>shadingRate</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkFragmentShadingRateNV\">VkFragmentShadingRateNV</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetFragmentShadingRateEnumNV-combinerOps-parameter",
|
|
"text": " Any given element of <code>combinerOps</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkFragmentShadingRateCombinerOpKHR\">VkFragmentShadingRateCombinerOpKHR</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetFragmentShadingRateEnumNV-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetFragmentShadingRateEnumNV-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetFragmentShadingRateEnumNV-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
]
|
|
},
|
|
"VkPipelineViewportShadingRateImageStateCreateInfoNV": {
|
|
"(VK_NV_shading_rate_image)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineViewportShadingRateImageStateCreateInfoNV-viewportCount-02054",
|
|
"text": " If the <a href=\"#features-multiViewport\"><code>multiViewport</code></a> feature is not enabled, <code>viewportCount</code> <strong class=\"purple\">must</strong> be <code>0</code> or <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineViewportShadingRateImageStateCreateInfoNV-viewportCount-02055",
|
|
"text": " <code>viewportCount</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxViewports</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineViewportShadingRateImageStateCreateInfoNV-shadingRateImageEnable-02056",
|
|
"text": " If <code>shadingRateImageEnable</code> is <code>VK_TRUE</code>, <code>viewportCount</code> <strong class=\"purple\">must</strong> be greater or equal to the <code>viewportCount</code> member of <a href=\"#VkPipelineViewportStateCreateInfo\">VkPipelineViewportStateCreateInfo</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineViewportShadingRateImageStateCreateInfoNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PIPELINE_VIEWPORT_SHADING_RATE_IMAGE_STATE_CREATE_INFO_NV</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdBindShadingRateImageNV": {
|
|
"(VK_NV_shading_rate_image)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBindShadingRateImageNV-None-02058",
|
|
"text": " The <a href=\"#features-shadingRateImage\"><code>shadingRateImage</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindShadingRateImageNV-imageView-02059",
|
|
"text": " If <code>imageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, it <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageView\">VkImageView</a> handle of type <code>VK_IMAGE_VIEW_TYPE_2D</code> or <code>VK_IMAGE_VIEW_TYPE_2D_ARRAY</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindShadingRateImageNV-imageView-02060",
|
|
"text": " If <code>imageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, it <strong class=\"purple\">must</strong> have a format of <code>VK_FORMAT_R8_UINT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindShadingRateImageNV-imageView-02061",
|
|
"text": " If <code>imageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, it <strong class=\"purple\">must</strong> have been created with a <code>usage</code> value including <code>VK_IMAGE_USAGE_SHADING_RATE_IMAGE_BIT_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindShadingRateImageNV-imageView-02062",
|
|
"text": " If <code>imageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>imageLayout</code> <strong class=\"purple\">must</strong> match the actual <a href=\"#VkImageLayout\">VkImageLayout</a> of each subresource accessible from <code>imageView</code> at the time the subresource is accessed"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindShadingRateImageNV-imageLayout-02063",
|
|
"text": " If <code>imageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>imageLayout</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_LAYOUT_SHADING_RATE_OPTIMAL_NV</code> or <code>VK_IMAGE_LAYOUT_GENERAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindShadingRateImageNV-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindShadingRateImageNV-imageView-parameter",
|
|
"text": " If <code>imageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>imageView</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageView\">VkImageView</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindShadingRateImageNV-imageLayout-parameter",
|
|
"text": " <code>imageLayout</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageLayout\">VkImageLayout</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindShadingRateImageNV-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindShadingRateImageNV-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindShadingRateImageNV-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindShadingRateImageNV-commonparent",
|
|
"text": " Both of <code>commandBuffer</code>, and <code>imageView</code> that are valid handles of non-ignored parameters <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdSetViewportShadingRatePaletteNV": {
|
|
"(VK_NV_shading_rate_image)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetViewportShadingRatePaletteNV-None-02064",
|
|
"text": " The <a href=\"#features-shadingRateImage\"><code>shadingRateImage</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetViewportShadingRatePaletteNV-firstViewport-02067",
|
|
"text": " The sum of <code>firstViewport</code> and <code>viewportCount</code> <strong class=\"purple\">must</strong> be between <code>1</code> and <code>VkPhysicalDeviceLimits</code>::<code>maxViewports</code>, inclusive"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetViewportShadingRatePaletteNV-firstViewport-02068",
|
|
"text": " If the <a href=\"#features-multiViewport\"><code>multiViewport</code></a> feature is not enabled, <code>firstViewport</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetViewportShadingRatePaletteNV-viewportCount-02069",
|
|
"text": " If the <a href=\"#features-multiViewport\"><code>multiViewport</code></a> feature is not enabled, <code>viewportCount</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetViewportShadingRatePaletteNV-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetViewportShadingRatePaletteNV-pShadingRatePalettes-parameter",
|
|
"text": " <code>pShadingRatePalettes</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>viewportCount</code> valid <a href=\"#VkShadingRatePaletteNV\">VkShadingRatePaletteNV</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetViewportShadingRatePaletteNV-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetViewportShadingRatePaletteNV-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetViewportShadingRatePaletteNV-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetViewportShadingRatePaletteNV-viewportCount-arraylength",
|
|
"text": " <code>viewportCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkShadingRatePaletteNV": {
|
|
"(VK_NV_shading_rate_image)": [
|
|
{
|
|
"vuid": "VUID-VkShadingRatePaletteNV-shadingRatePaletteEntryCount-02071",
|
|
"text": " <code>shadingRatePaletteEntryCount</code> <strong class=\"purple\">must</strong> be between <code>1</code> and <code>VkPhysicalDeviceShadingRateImagePropertiesNV</code>::<code>shadingRatePaletteSize</code>, inclusive"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkShadingRatePaletteNV-pShadingRatePaletteEntries-parameter",
|
|
"text": " <code>pShadingRatePaletteEntries</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>shadingRatePaletteEntryCount</code> valid <a href=\"#VkShadingRatePaletteEntryNV\">VkShadingRatePaletteEntryNV</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkShadingRatePaletteNV-shadingRatePaletteEntryCount-arraylength",
|
|
"text": " <code>shadingRatePaletteEntryCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPipelineViewportCoarseSampleOrderStateCreateInfoNV": {
|
|
"(VK_NV_shading_rate_image)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineViewportCoarseSampleOrderStateCreateInfoNV-sampleOrderType-02072",
|
|
"text": " If <code>sampleOrderType</code> is not <code>VK_COARSE_SAMPLE_ORDER_TYPE_CUSTOM_NV</code>, <code>customSamplerOrderCount</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineViewportCoarseSampleOrderStateCreateInfoNV-pCustomSampleOrders-02234",
|
|
"text": " The array <code>pCustomSampleOrders</code> <strong class=\"purple\">must</strong> not contain two structures with matching values for both the <code>shadingRate</code> and <code>sampleCount</code> members"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineViewportCoarseSampleOrderStateCreateInfoNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PIPELINE_VIEWPORT_COARSE_SAMPLE_ORDER_STATE_CREATE_INFO_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineViewportCoarseSampleOrderStateCreateInfoNV-sampleOrderType-parameter",
|
|
"text": " <code>sampleOrderType</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCoarseSampleOrderTypeNV\">VkCoarseSampleOrderTypeNV</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineViewportCoarseSampleOrderStateCreateInfoNV-pCustomSampleOrders-parameter",
|
|
"text": " If <code>customSampleOrderCount</code> is not <code>0</code>, <code>pCustomSampleOrders</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>customSampleOrderCount</code> valid <a href=\"#VkCoarseSampleOrderCustomNV\">VkCoarseSampleOrderCustomNV</a> structures"
|
|
}
|
|
]
|
|
},
|
|
"VkCoarseSampleOrderCustomNV": {
|
|
"(VK_NV_shading_rate_image)": [
|
|
{
|
|
"vuid": "VUID-VkCoarseSampleOrderCustomNV-shadingRate-02073",
|
|
"text": " <code>shadingRate</code> <strong class=\"purple\">must</strong> be a shading rate that generates fragments with more than one pixel"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCoarseSampleOrderCustomNV-sampleCount-02074",
|
|
"text": " <code>sampleCount</code> <strong class=\"purple\">must</strong> correspond to a sample count enumerated in <a href=\"#VkSampleCountFlags\">VkSampleCountFlags</a> whose corresponding bit is set in <a href=\"#VkPhysicalDeviceLimits\">VkPhysicalDeviceLimits</a>::<code>framebufferNoAttachmentsSampleCounts</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCoarseSampleOrderCustomNV-sampleLocationCount-02075",
|
|
"text": " <code>sampleLocationCount</code> <strong class=\"purple\">must</strong> be equal to the product of <code>sampleCount</code>, the fragment width for <code>shadingRate</code>, and the fragment height for <code>shadingRate</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCoarseSampleOrderCustomNV-sampleLocationCount-02076",
|
|
"text": " <code>sampleLocationCount</code> <strong class=\"purple\">must</strong> be less than or equal to the value of <code>VkPhysicalDeviceShadingRateImagePropertiesNV</code>::<code>shadingRateMaxCoarseSamples</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCoarseSampleOrderCustomNV-pSampleLocations-02077",
|
|
"text": " The array <code>pSampleLocations</code> <strong class=\"purple\">must</strong> contain exactly one entry for every combination of valid values for <code>pixelX</code>, <code>pixelY</code>, and <code>sample</code> in the structure <a href=\"#VkCoarseSampleOrderCustomNV\">VkCoarseSampleOrderCustomNV</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCoarseSampleOrderCustomNV-shadingRate-parameter",
|
|
"text": " <code>shadingRate</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkShadingRatePaletteEntryNV\">VkShadingRatePaletteEntryNV</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCoarseSampleOrderCustomNV-pSampleLocations-parameter",
|
|
"text": " <code>pSampleLocations</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>sampleLocationCount</code> <a href=\"#VkCoarseSampleLocationNV\">VkCoarseSampleLocationNV</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCoarseSampleOrderCustomNV-sampleLocationCount-arraylength",
|
|
"text": " <code>sampleLocationCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkCoarseSampleLocationNV": {
|
|
"(VK_NV_shading_rate_image)": [
|
|
{
|
|
"vuid": "VUID-VkCoarseSampleLocationNV-pixelX-02078",
|
|
"text": " <code>pixelX</code> <strong class=\"purple\">must</strong> be less than the width (in pixels) of the fragment"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCoarseSampleLocationNV-pixelY-02079",
|
|
"text": " <code>pixelY</code> <strong class=\"purple\">must</strong> be less than the height (in pixels) of the fragment"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCoarseSampleLocationNV-sample-02080",
|
|
"text": " <code>sample</code> <strong class=\"purple\">must</strong> be less than the number of coverage samples in each pixel belonging to the fragment"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdSetCoarseSampleOrderNV": {
|
|
"(VK_NV_shading_rate_image)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetCoarseSampleOrderNV-sampleOrderType-02081",
|
|
"text": " If <code>sampleOrderType</code> is not <code>VK_COARSE_SAMPLE_ORDER_TYPE_CUSTOM_NV</code>, <code>customSamplerOrderCount</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetCoarseSampleOrderNV-pCustomSampleOrders-02235",
|
|
"text": " The array <code>pCustomSampleOrders</code> <strong class=\"purple\">must</strong> not contain two structures with matching values for both the <code>shadingRate</code> and <code>sampleCount</code> members"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetCoarseSampleOrderNV-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetCoarseSampleOrderNV-sampleOrderType-parameter",
|
|
"text": " <code>sampleOrderType</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCoarseSampleOrderTypeNV\">VkCoarseSampleOrderTypeNV</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetCoarseSampleOrderNV-pCustomSampleOrders-parameter",
|
|
"text": " If <code>customSampleOrderCount</code> is not <code>0</code>, <code>pCustomSampleOrders</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>customSampleOrderCount</code> valid <a href=\"#VkCoarseSampleOrderCustomNV\">VkCoarseSampleOrderCustomNV</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetCoarseSampleOrderNV-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetCoarseSampleOrderNV-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetCoarseSampleOrderNV-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
]
|
|
},
|
|
"VkPipelineRasterizationLineStateCreateInfoEXT": {
|
|
"(VK_EXT_line_rasterization)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineRasterizationLineStateCreateInfoEXT-lineRasterizationMode-02768",
|
|
"text": " If <code>lineRasterizationMode</code> is <code>VK_LINE_RASTERIZATION_MODE_RECTANGULAR_EXT</code>, then the <a href=\"#features-rectangularLines\"><code>rectangularLines</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineRasterizationLineStateCreateInfoEXT-lineRasterizationMode-02769",
|
|
"text": " If <code>lineRasterizationMode</code> is <code>VK_LINE_RASTERIZATION_MODE_BRESENHAM_EXT</code>, then the <a href=\"#features-bresenhamLines\"><code>bresenhamLines</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineRasterizationLineStateCreateInfoEXT-lineRasterizationMode-02770",
|
|
"text": " If <code>lineRasterizationMode</code> is <code>VK_LINE_RASTERIZATION_MODE_RECTANGULAR_SMOOTH_EXT</code>, then the <a href=\"#features-bresenhamLines\"><code>bresenhamLines</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineRasterizationLineStateCreateInfoEXT-stippledLineEnable-02771",
|
|
"text": " If <code>stippledLineEnable</code> is <code>VK_TRUE</code> and <code>lineRasterizationMode</code> is <code>VK_LINE_RASTERIZATION_MODE_RECTANGULAR_EXT</code>, then the <a href=\"#features-stippledRectangularLines\"><code>stippledRectangularLines</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineRasterizationLineStateCreateInfoEXT-stippledLineEnable-02772",
|
|
"text": " If <code>stippledLineEnable</code> is <code>VK_TRUE</code> and <code>lineRasterizationMode</code> is <code>VK_LINE_RASTERIZATION_MODE_BRESENHAM_EXT</code>, then the <a href=\"#features-stippledBresenhamLines\"><code>stippledBresenhamLines</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineRasterizationLineStateCreateInfoEXT-stippledLineEnable-02773",
|
|
"text": " If <code>stippledLineEnable</code> is <code>VK_TRUE</code> and <code>lineRasterizationMode</code> is <code>VK_LINE_RASTERIZATION_MODE_RECTANGULAR_SMOOTH_EXT</code>, then the <a href=\"#features-stippledSmoothLines\"><code>stippledSmoothLines</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineRasterizationLineStateCreateInfoEXT-stippledLineEnable-02774",
|
|
"text": " If <code>stippledLineEnable</code> is <code>VK_TRUE</code> and <code>lineRasterizationMode</code> is <code>VK_LINE_RASTERIZATION_MODE_DEFAULT_EXT</code>, then the <a href=\"#features-stippledRectangularLines\"><code>stippledRectangularLines</code></a> feature <strong class=\"purple\">must</strong> be enabled and <a href=\"#VkPhysicalDeviceLimits\">VkPhysicalDeviceLimits</a>::<code>strictLines</code> <strong class=\"purple\">must</strong> be <code>VK_TRUE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineRasterizationLineStateCreateInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PIPELINE_RASTERIZATION_LINE_STATE_CREATE_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineRasterizationLineStateCreateInfoEXT-lineRasterizationMode-parameter",
|
|
"text": " <code>lineRasterizationMode</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkLineRasterizationModeEXT\">VkLineRasterizationModeEXT</a> value"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdSetLineWidth": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetLineWidth-lineWidth-00788",
|
|
"text": " If the <a href=\"#features-wideLines\"><code>wideLines</code></a> feature is not enabled, <code>lineWidth</code> <strong class=\"purple\">must</strong> be <code>1.0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetLineWidth-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetLineWidth-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetLineWidth-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetLineWidth-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdSetLineStippleEXT": {
|
|
"(VK_EXT_line_rasterization)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetLineStippleEXT-lineStippleFactor-02776",
|
|
"text": " <code>lineStippleFactor</code> <strong class=\"purple\">must</strong> be in the range <span class=\"eq\">[1,256]</span>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetLineStippleEXT-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetLineStippleEXT-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetLineStippleEXT-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetLineStippleEXT-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdSetFrontFace": {
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+!(VK_VERSION_1_3)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetFrontFace-None-03383",
|
|
"text": " The <a href=\"#features-extendedDynamicState\"><code>extendedDynamicState</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetFrontFace-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetFrontFace-frontFace-parameter",
|
|
"text": " <code>frontFace</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkFrontFace\">VkFrontFace</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetFrontFace-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetFrontFace-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetFrontFace-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdSetCullMode": {
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+!(VK_VERSION_1_3)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetCullMode-None-03384",
|
|
"text": " The <a href=\"#features-extendedDynamicState\"><code>extendedDynamicState</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetCullMode-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetCullMode-cullMode-parameter",
|
|
"text": " <code>cullMode</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkCullModeFlagBits\">VkCullModeFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetCullMode-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetCullMode-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetCullMode-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdSetDepthBiasEnable": {
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state2)+!(VK_VERSION_1_3)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetDepthBiasEnable-None-04872",
|
|
"text": " The <a href=\"#features-extendedDynamicState2\"><code>extendedDynamicState2</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetDepthBiasEnable-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetDepthBiasEnable-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetDepthBiasEnable-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetDepthBiasEnable-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdSetDepthBias": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetDepthBias-depthBiasClamp-00790",
|
|
"text": " If the <a href=\"#features-depthBiasClamp\"><code>depthBiasClamp</code></a> feature is not enabled, <code>depthBiasClamp</code> <strong class=\"purple\">must</strong> be <code>0.0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetDepthBias-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetDepthBias-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetDepthBias-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetDepthBias-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
]
|
|
},
|
|
"VkPipelineRasterizationConservativeStateCreateInfoEXT": {
|
|
"(VK_EXT_conservative_rasterization)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineRasterizationConservativeStateCreateInfoEXT-extraPrimitiveOverestimationSize-01769",
|
|
"text": " <code>extraPrimitiveOverestimationSize</code> <strong class=\"purple\">must</strong> be in the range of <code>0.0</code> to <code>VkPhysicalDeviceConservativeRasterizationPropertiesEXT</code>::<code>maxExtraPrimitiveOverestimationSize</code> inclusive"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineRasterizationConservativeStateCreateInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PIPELINE_RASTERIZATION_CONSERVATIVE_STATE_CREATE_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineRasterizationConservativeStateCreateInfoEXT-flags-zerobitmask",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineRasterizationConservativeStateCreateInfoEXT-conservativeRasterizationMode-parameter",
|
|
"text": " <code>conservativeRasterizationMode</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkConservativeRasterizationModeEXT\">VkConservativeRasterizationModeEXT</a> value"
|
|
}
|
|
]
|
|
},
|
|
"VkPipelineDiscardRectangleStateCreateInfoEXT": {
|
|
"(VK_EXT_discard_rectangles)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineDiscardRectangleStateCreateInfoEXT-discardRectangleCount-00582",
|
|
"text": " <code>discardRectangleCount</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceDiscardRectanglePropertiesEXT</code>::<code>maxDiscardRectangles</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineDiscardRectangleStateCreateInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PIPELINE_DISCARD_RECTANGLE_STATE_CREATE_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineDiscardRectangleStateCreateInfoEXT-flags-zerobitmask",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineDiscardRectangleStateCreateInfoEXT-discardRectangleMode-parameter",
|
|
"text": " <code>discardRectangleMode</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDiscardRectangleModeEXT\">VkDiscardRectangleModeEXT</a> value"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdSetDiscardRectangleEXT": {
|
|
"(VK_EXT_discard_rectangles)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetDiscardRectangleEXT-firstDiscardRectangle-00585",
|
|
"text": " The sum of <code>firstDiscardRectangle</code> and <code>discardRectangleCount</code> <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#VkPhysicalDeviceDiscardRectanglePropertiesEXT\">VkPhysicalDeviceDiscardRectanglePropertiesEXT</a>::<code>maxDiscardRectangles</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetDiscardRectangleEXT-x-00587",
|
|
"text": " The <code>x</code> and <code>y</code> member of <code>offset</code> in each <a href=\"#VkRect2D\">VkRect2D</a> element of <code>pDiscardRectangles</code> <strong class=\"purple\">must</strong> be greater than or equal to <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetDiscardRectangleEXT-offset-00588",
|
|
"text": " Evaluation of <span class=\"eq\">(<code>offset.x</code> + <code>extent.width</code>)</span> in each <a href=\"#VkRect2D\">VkRect2D</a> element of <code>pDiscardRectangles</code> <strong class=\"purple\">must</strong> not cause a signed integer addition overflow"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetDiscardRectangleEXT-offset-00589",
|
|
"text": " Evaluation of <span class=\"eq\">(<code>offset.y</code> + <code>extent.height</code>)</span> in each <a href=\"#VkRect2D\">VkRect2D</a> element of <code>pDiscardRectangles</code> <strong class=\"purple\">must</strong> not cause a signed integer addition overflow"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetDiscardRectangleEXT-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetDiscardRectangleEXT-pDiscardRectangles-parameter",
|
|
"text": " <code>pDiscardRectangles</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>discardRectangleCount</code> <a href=\"#VkRect2D\">VkRect2D</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetDiscardRectangleEXT-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetDiscardRectangleEXT-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetDiscardRectangleEXT-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetDiscardRectangleEXT-discardRectangleCount-arraylength",
|
|
"text": " <code>discardRectangleCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
],
|
|
"(VK_EXT_discard_rectangles)+(VK_NV_inherited_viewport_scissor)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetDiscardRectangleEXT-viewportScissor2D-04788",
|
|
"text": " If this command is recorded in a secondary command buffer with <a href=\"#VkCommandBufferInheritanceViewportScissorInfoNV\">VkCommandBufferInheritanceViewportScissorInfoNV</a>::<code>viewportScissor2D</code> enabled, then this function <strong class=\"purple\">must</strong> not be called"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdSetScissor": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetScissor-firstScissor-00592",
|
|
"text": " The sum of <code>firstScissor</code> and <code>scissorCount</code> <strong class=\"purple\">must</strong> be between <code>1</code> and <code>VkPhysicalDeviceLimits</code>::<code>maxViewports</code>, inclusive"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetScissor-firstScissor-00593",
|
|
"text": " If the <a href=\"#features-multiViewport\"><code>multiViewport</code></a> feature is not enabled, <code>firstScissor</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetScissor-scissorCount-00594",
|
|
"text": " If the <a href=\"#features-multiViewport\"><code>multiViewport</code></a> feature is not enabled, <code>scissorCount</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetScissor-x-00595",
|
|
"text": " The <code>x</code> and <code>y</code> members of <code>offset</code> member of any element of <code>pScissors</code> <strong class=\"purple\">must</strong> be greater than or equal to <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetScissor-offset-00596",
|
|
"text": " Evaluation of <span class=\"eq\">(<code>offset.x</code> + <code>extent.width</code>)</span> <strong class=\"purple\">must</strong> not cause a signed integer addition overflow for any element of <code>pScissors</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetScissor-offset-00597",
|
|
"text": " Evaluation of <span class=\"eq\">(<code>offset.y</code> + <code>extent.height</code>)</span> <strong class=\"purple\">must</strong> not cause a signed integer addition overflow for any element of <code>pScissors</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetScissor-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetScissor-pScissors-parameter",
|
|
"text": " <code>pScissors</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>scissorCount</code> <a href=\"#VkRect2D\">VkRect2D</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetScissor-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetScissor-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetScissor-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetScissor-scissorCount-arraylength",
|
|
"text": " <code>scissorCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
],
|
|
"(VK_NV_inherited_viewport_scissor)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetScissor-viewportScissor2D-04789",
|
|
"text": " If this command is recorded in a secondary command buffer with <a href=\"#VkCommandBufferInheritanceViewportScissorInfoNV\">VkCommandBufferInheritanceViewportScissorInfoNV</a>::<code>viewportScissor2D</code> enabled, then this function <strong class=\"purple\">must</strong> not be called"
|
|
}
|
|
]
|
|
},
|
|
"VkPipelineViewportExclusiveScissorStateCreateInfoNV": {
|
|
"(VK_NV_scissor_exclusive)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineViewportExclusiveScissorStateCreateInfoNV-exclusiveScissorCount-02027",
|
|
"text": " If the <a href=\"#features-multiViewport\"><code>multiViewport</code></a> feature is not enabled, <code>exclusiveScissorCount</code> <strong class=\"purple\">must</strong> be <code>0</code> or <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineViewportExclusiveScissorStateCreateInfoNV-exclusiveScissorCount-02028",
|
|
"text": " <code>exclusiveScissorCount</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxViewports</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineViewportExclusiveScissorStateCreateInfoNV-exclusiveScissorCount-02029",
|
|
"text": " <code>exclusiveScissorCount</code> <strong class=\"purple\">must</strong> be <code>0</code> or greater than or equal to the <code>viewportCount</code> member of <a href=\"#VkPipelineViewportStateCreateInfo\">VkPipelineViewportStateCreateInfo</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineViewportExclusiveScissorStateCreateInfoNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PIPELINE_VIEWPORT_EXCLUSIVE_SCISSOR_STATE_CREATE_INFO_NV</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdSetExclusiveScissorNV": {
|
|
"(VK_NV_scissor_exclusive)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetExclusiveScissorNV-None-02031",
|
|
"text": " The <a href=\"#features-exclusiveScissor\"><code>exclusiveScissor</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetExclusiveScissorNV-firstExclusiveScissor-02034",
|
|
"text": " The sum of <code>firstExclusiveScissor</code> and <code>exclusiveScissorCount</code> <strong class=\"purple\">must</strong> be between <code>1</code> and <code>VkPhysicalDeviceLimits</code>::<code>maxViewports</code>, inclusive"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetExclusiveScissorNV-firstExclusiveScissor-02035",
|
|
"text": " If the <a href=\"#features-multiViewport\"><code>multiViewport</code></a> feature is not enabled, <code>firstExclusiveScissor</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetExclusiveScissorNV-exclusiveScissorCount-02036",
|
|
"text": " If the <a href=\"#features-multiViewport\"><code>multiViewport</code></a> feature is not enabled, <code>exclusiveScissorCount</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetExclusiveScissorNV-x-02037",
|
|
"text": " The <code>x</code> and <code>y</code> members of <code>offset</code> in each member of <code>pExclusiveScissors</code> <strong class=\"purple\">must</strong> be greater than or equal to <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetExclusiveScissorNV-offset-02038",
|
|
"text": " Evaluation of <span class=\"eq\">(<code>offset.x</code> + <code>extent.width</code>)</span> for each member of <code>pExclusiveScissors</code> <strong class=\"purple\">must</strong> not cause a signed integer addition overflow"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetExclusiveScissorNV-offset-02039",
|
|
"text": " Evaluation of <span class=\"eq\">(<code>offset.y</code> + <code>extent.height</code>)</span> for each member of <code>pExclusiveScissors</code> <strong class=\"purple\">must</strong> not cause a signed integer addition overflow"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetExclusiveScissorNV-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetExclusiveScissorNV-pExclusiveScissors-parameter",
|
|
"text": " <code>pExclusiveScissors</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>exclusiveScissorCount</code> <a href=\"#VkRect2D\">VkRect2D</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetExclusiveScissorNV-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetExclusiveScissorNV-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetExclusiveScissorNV-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetExclusiveScissorNV-exclusiveScissorCount-arraylength",
|
|
"text": " <code>exclusiveScissorCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPipelineDepthStencilStateCreateInfo": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkPipelineDepthStencilStateCreateInfo-depthBoundsTestEnable-00598",
|
|
"text": " If the <a href=\"#features-depthBounds\"><code>depthBounds</code></a> feature is not enabled, <code>depthBoundsTestEnable</code> <strong class=\"purple\">must</strong> be <code>VK_FALSE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineDepthStencilStateCreateInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PIPELINE_DEPTH_STENCIL_STATE_CREATE_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineDepthStencilStateCreateInfo-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineDepthStencilStateCreateInfo-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkPipelineDepthStencilStateCreateFlagBits\">VkPipelineDepthStencilStateCreateFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineDepthStencilStateCreateInfo-depthCompareOp-parameter",
|
|
"text": " <code>depthCompareOp</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCompareOp\">VkCompareOp</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineDepthStencilStateCreateInfo-front-parameter",
|
|
"text": " <code>front</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkStencilOpState\">VkStencilOpState</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineDepthStencilStateCreateInfo-back-parameter",
|
|
"text": " <code>back</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkStencilOpState\">VkStencilOpState</a> structure"
|
|
}
|
|
],
|
|
"(VK_KHR_portability_subset)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineDepthStencilStateCreateInfo-separateStencilMaskRef-04453",
|
|
"text": " If the <code><a href=\"#VK_KHR_portability_subset\">VK_KHR_portability_subset</a></code> extension is enabled, and <a href=\"#VkPhysicalDevicePortabilitySubsetFeaturesKHR\">VkPhysicalDevicePortabilitySubsetFeaturesKHR</a>::<code>separateStencilMaskRef</code> is <code>VK_FALSE</code>, and the value of <a href=\"#VkPipelineDepthStencilStateCreateInfo\">VkPipelineDepthStencilStateCreateInfo</a>::<code>stencilTestEnable</code> is <code>VK_TRUE</code>, and the value of <a href=\"#VkPipelineRasterizationStateCreateInfo\">VkPipelineRasterizationStateCreateInfo</a>::<code>cullMode</code> is <code>VK_CULL_MODE_NONE</code>, the value of <code>reference</code> in each of the <a href=\"#VkStencilOpState\">VkStencilOpState</a> structs in <code>front</code> and <code>back</code> <strong class=\"purple\">must</strong> be the same"
|
|
}
|
|
],
|
|
"(VK_ARM_rasterization_order_attachment_access)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineDepthStencilStateCreateInfo-rasterizationOrderDepthAttachmentAccess-06463",
|
|
"text": " If the <a href=\"#features-rasterizationOrderDepthAttachmentAccess\"><code>rasterizationOrderDepthAttachmentAccess</code></a> feature is not enabled, <code>flags</code> <strong class=\"purple\">must</strong> not include <code>VK_PIPELINE_DEPTH_STENCIL_STATE_CREATE_RASTERIZATION_ORDER_ATTACHMENT_DEPTH_ACCESS_BIT_ARM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineDepthStencilStateCreateInfo-rasterizationOrderStencilAttachmentAccess-06464",
|
|
"text": " If the <a href=\"#features-rasterizationOrderStencilAttachmentAccess\"><code>rasterizationOrderStencilAttachmentAccess</code></a> feature is not enabled, <code>flags</code> <strong class=\"purple\">must</strong> not include <code>VK_PIPELINE_DEPTH_STENCIL_STATE_CREATE_RASTERIZATION_ORDER_ATTACHMENT_STENCIL_ACCESS_BIT_ARM</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdSetDepthBoundsTestEnable": {
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+!(VK_VERSION_1_3)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetDepthBoundsTestEnable-None-03349",
|
|
"text": " The <a href=\"#features-extendedDynamicState\"><code>extendedDynamicState</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetDepthBoundsTestEnable-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetDepthBoundsTestEnable-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetDepthBoundsTestEnable-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetDepthBoundsTestEnable-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdSetDepthBounds": {
|
|
"(VK_EXT_depth_range_unrestricted)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetDepthBounds-minDepthBounds-00600",
|
|
"text": " Unless the <code><a href=\"#VK_EXT_depth_range_unrestricted\">VK_EXT_depth_range_unrestricted</a></code> extension is enabled <code>minDepthBounds</code> <strong class=\"purple\">must</strong> be between <code>0.0</code> and <code>1.0</code>, inclusive"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetDepthBounds-maxDepthBounds-00601",
|
|
"text": " Unless the <code><a href=\"#VK_EXT_depth_range_unrestricted\">VK_EXT_depth_range_unrestricted</a></code> extension is enabled <code>maxDepthBounds</code> <strong class=\"purple\">must</strong> be between <code>0.0</code> and <code>1.0</code>, inclusive"
|
|
}
|
|
],
|
|
"!(VK_EXT_depth_range_unrestricted)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetDepthBounds-minDepthBounds-02508",
|
|
"text": " <code>minDepthBounds</code> <strong class=\"purple\">must</strong> be between <code>0.0</code> and <code>1.0</code>, inclusive"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetDepthBounds-maxDepthBounds-02509",
|
|
"text": " <code>maxDepthBounds</code> <strong class=\"purple\">must</strong> be between <code>0.0</code> and <code>1.0</code>, inclusive"
|
|
}
|
|
],
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetDepthBounds-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetDepthBounds-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetDepthBounds-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetDepthBounds-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdSetStencilTestEnable": {
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+!(VK_VERSION_1_3)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetStencilTestEnable-None-03350",
|
|
"text": " The <a href=\"#features-extendedDynamicState\"><code>extendedDynamicState</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetStencilTestEnable-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetStencilTestEnable-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetStencilTestEnable-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetStencilTestEnable-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdSetStencilOp": {
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+!(VK_VERSION_1_3)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetStencilOp-None-03351",
|
|
"text": " The <a href=\"#features-extendedDynamicState\"><code>extendedDynamicState</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetStencilOp-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetStencilOp-faceMask-parameter",
|
|
"text": " <code>faceMask</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkStencilFaceFlagBits\">VkStencilFaceFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetStencilOp-faceMask-requiredbitmask",
|
|
"text": " <code>faceMask</code> <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetStencilOp-failOp-parameter",
|
|
"text": " <code>failOp</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkStencilOp\">VkStencilOp</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetStencilOp-passOp-parameter",
|
|
"text": " <code>passOp</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkStencilOp\">VkStencilOp</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetStencilOp-depthFailOp-parameter",
|
|
"text": " <code>depthFailOp</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkStencilOp\">VkStencilOp</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetStencilOp-compareOp-parameter",
|
|
"text": " <code>compareOp</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCompareOp\">VkCompareOp</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetStencilOp-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetStencilOp-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetStencilOp-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
]
|
|
},
|
|
"VkStencilOpState": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkStencilOpState-failOp-parameter",
|
|
"text": " <code>failOp</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkStencilOp\">VkStencilOp</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkStencilOpState-passOp-parameter",
|
|
"text": " <code>passOp</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkStencilOp\">VkStencilOp</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkStencilOpState-depthFailOp-parameter",
|
|
"text": " <code>depthFailOp</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkStencilOp\">VkStencilOp</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkStencilOpState-compareOp-parameter",
|
|
"text": " <code>compareOp</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCompareOp\">VkCompareOp</a> value"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdSetStencilCompareMask": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetStencilCompareMask-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetStencilCompareMask-faceMask-parameter",
|
|
"text": " <code>faceMask</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkStencilFaceFlagBits\">VkStencilFaceFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetStencilCompareMask-faceMask-requiredbitmask",
|
|
"text": " <code>faceMask</code> <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetStencilCompareMask-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetStencilCompareMask-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetStencilCompareMask-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdSetStencilWriteMask": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetStencilWriteMask-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetStencilWriteMask-faceMask-parameter",
|
|
"text": " <code>faceMask</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkStencilFaceFlagBits\">VkStencilFaceFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetStencilWriteMask-faceMask-requiredbitmask",
|
|
"text": " <code>faceMask</code> <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetStencilWriteMask-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetStencilWriteMask-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetStencilWriteMask-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdSetStencilReference": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetStencilReference-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetStencilReference-faceMask-parameter",
|
|
"text": " <code>faceMask</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkStencilFaceFlagBits\">VkStencilFaceFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetStencilReference-faceMask-requiredbitmask",
|
|
"text": " <code>faceMask</code> <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetStencilReference-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetStencilReference-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetStencilReference-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdSetDepthTestEnable": {
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+!(VK_VERSION_1_3)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetDepthTestEnable-None-03352",
|
|
"text": " The <a href=\"#features-extendedDynamicState\"><code>extendedDynamicState</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetDepthTestEnable-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetDepthTestEnable-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetDepthTestEnable-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetDepthTestEnable-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdSetDepthCompareOp": {
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+!(VK_VERSION_1_3)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetDepthCompareOp-None-03353",
|
|
"text": " The <a href=\"#features-extendedDynamicState\"><code>extendedDynamicState</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetDepthCompareOp-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetDepthCompareOp-depthCompareOp-parameter",
|
|
"text": " <code>depthCompareOp</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCompareOp\">VkCompareOp</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetDepthCompareOp-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetDepthCompareOp-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetDepthCompareOp-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdSetDepthWriteEnable": {
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+!(VK_VERSION_1_3)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetDepthWriteEnable-None-03354",
|
|
"text": " The <a href=\"#features-extendedDynamicState\"><code>extendedDynamicState</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetDepthWriteEnable-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetDepthWriteEnable-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetDepthWriteEnable-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetDepthWriteEnable-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
]
|
|
},
|
|
"VkPipelineRepresentativeFragmentTestStateCreateInfoNV": {
|
|
"(VK_NV_representative_fragment_test)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineRepresentativeFragmentTestStateCreateInfoNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PIPELINE_REPRESENTATIVE_FRAGMENT_TEST_STATE_CREATE_INFO_NV</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPipelineCoverageToColorStateCreateInfoNV": {
|
|
"(VK_NV_fragment_coverage_to_color)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineCoverageToColorStateCreateInfoNV-coverageToColorEnable-01404",
|
|
"text": " If <code>coverageToColorEnable</code> is <code>VK_TRUE</code>, then the render pass subpass indicated by <a href=\"#VkGraphicsPipelineCreateInfo\">VkGraphicsPipelineCreateInfo</a>::<code>renderPass</code> and <a href=\"#VkGraphicsPipelineCreateInfo\">VkGraphicsPipelineCreateInfo</a>::<code>subpass</code> <strong class=\"purple\">must</strong> have a color attachment at the location selected by <code>coverageToColorLocation</code>, with a <a href=\"#VkFormat\">VkFormat</a> of <code>VK_FORMAT_R8_UINT</code>, <code>VK_FORMAT_R8_SINT</code>, <code>VK_FORMAT_R16_UINT</code>, <code>VK_FORMAT_R16_SINT</code>, <code>VK_FORMAT_R32_UINT</code>, or <code>VK_FORMAT_R32_SINT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineCoverageToColorStateCreateInfoNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PIPELINE_COVERAGE_TO_COLOR_STATE_CREATE_INFO_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineCoverageToColorStateCreateInfoNV-flags-zerobitmask",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPipelineCoverageReductionStateCreateInfoNV": {
|
|
"(VK_NV_framebuffer_mixed_samples)+(VK_NV_coverage_reduction_mode)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineCoverageReductionStateCreateInfoNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PIPELINE_COVERAGE_REDUCTION_STATE_CREATE_INFO_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineCoverageReductionStateCreateInfoNV-flags-zerobitmask",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineCoverageReductionStateCreateInfoNV-coverageReductionMode-parameter",
|
|
"text": " <code>coverageReductionMode</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCoverageReductionModeNV\">VkCoverageReductionModeNV</a> value"
|
|
}
|
|
]
|
|
},
|
|
"vkGetPhysicalDeviceSupportedFramebufferMixedSamplesCombinationsNV": {
|
|
"(VK_NV_framebuffer_mixed_samples)+(VK_NV_coverage_reduction_mode)": [
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSupportedFramebufferMixedSamplesCombinationsNV-physicalDevice-parameter",
|
|
"text": " <code>physicalDevice</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSupportedFramebufferMixedSamplesCombinationsNV-pCombinationCount-parameter",
|
|
"text": " <code>pCombinationCount</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>uint32_t</code> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSupportedFramebufferMixedSamplesCombinationsNV-pCombinations-parameter",
|
|
"text": " If the value referenced by <code>pCombinationCount</code> is not <code>0</code>, and <code>pCombinations</code> is not <code>NULL</code>, <code>pCombinations</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>pCombinationCount</code> <a href=\"#VkFramebufferMixedSamplesCombinationNV\">VkFramebufferMixedSamplesCombinationNV</a> structures"
|
|
}
|
|
]
|
|
},
|
|
"VkFramebufferMixedSamplesCombinationNV": {
|
|
"(VK_NV_framebuffer_mixed_samples)+(VK_NV_coverage_reduction_mode)": [
|
|
{
|
|
"vuid": "VUID-VkFramebufferMixedSamplesCombinationNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_FRAMEBUFFER_MIXED_SAMPLES_COMBINATION_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFramebufferMixedSamplesCombinationNV-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPipelineCoverageModulationStateCreateInfoNV": {
|
|
"(VK_NV_framebuffer_mixed_samples)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineCoverageModulationStateCreateInfoNV-coverageModulationTableEnable-01405",
|
|
"text": " If <code>coverageModulationTableEnable</code> is <code>VK_TRUE</code>, <code>coverageModulationTableCount</code> <strong class=\"purple\">must</strong> be equal to the number of rasterization samples divided by the number of color samples in the subpass"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineCoverageModulationStateCreateInfoNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PIPELINE_COVERAGE_MODULATION_STATE_CREATE_INFO_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineCoverageModulationStateCreateInfoNV-flags-zerobitmask",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineCoverageModulationStateCreateInfoNV-coverageModulationMode-parameter",
|
|
"text": " <code>coverageModulationMode</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCoverageModulationModeNV\">VkCoverageModulationModeNV</a> value"
|
|
}
|
|
]
|
|
},
|
|
"VkPipelineColorBlendStateCreateInfo": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkPipelineColorBlendStateCreateInfo-pAttachments-00605",
|
|
"text": " If the <a href=\"#features-independentBlend\"><code>independentBlend</code></a> feature is not enabled, all elements of <code>pAttachments</code> <strong class=\"purple\">must</strong> be identical"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineColorBlendStateCreateInfo-logicOpEnable-00606",
|
|
"text": " If the <a href=\"#features-logicOp\"><code>logicOp</code></a> feature is not enabled, <code>logicOpEnable</code> <strong class=\"purple\">must</strong> be <code>VK_FALSE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineColorBlendStateCreateInfo-logicOpEnable-00607",
|
|
"text": " If <code>logicOpEnable</code> is <code>VK_TRUE</code>, <code>logicOp</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkLogicOp\">VkLogicOp</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineColorBlendStateCreateInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PIPELINE_COLOR_BLEND_STATE_CREATE_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineColorBlendStateCreateInfo-pNext-pNext",
|
|
"text": " Each <code>pNext</code> member of any structure (including this one) in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be either <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkPipelineColorBlendAdvancedStateCreateInfoEXT\">VkPipelineColorBlendAdvancedStateCreateInfoEXT</a> or <a href=\"#VkPipelineColorWriteCreateInfoEXT\">VkPipelineColorWriteCreateInfoEXT</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineColorBlendStateCreateInfo-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineColorBlendStateCreateInfo-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkPipelineColorBlendStateCreateFlagBits\">VkPipelineColorBlendStateCreateFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineColorBlendStateCreateInfo-pAttachments-parameter",
|
|
"text": " If <code>attachmentCount</code> is not <code>0</code>, <code>pAttachments</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>attachmentCount</code> valid <a href=\"#VkPipelineColorBlendAttachmentState\">VkPipelineColorBlendAttachmentState</a> structures"
|
|
}
|
|
],
|
|
"(VK_ARM_rasterization_order_attachment_access)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineColorBlendStateCreateInfo-rasterizationOrderColorAttachmentAccess-06465",
|
|
"text": " If the <a href=\"#features-rasterizationOrderColorAttachmentAccess\"><code>rasterizationOrderColorAttachmentAccess</code></a> feature is not enabled, <code>flags</code> <strong class=\"purple\">must</strong> not include <code>VK_PIPELINE_COLOR_BLEND_STATE_CREATE_RASTERIZATION_ORDER_ATTACHMENT_ACCESS_BIT_ARM</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPipelineColorBlendAttachmentState": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkPipelineColorBlendAttachmentState-srcColorBlendFactor-00608",
|
|
"text": " If the <a href=\"#features-dualSrcBlend\"><code>dualSrcBlend</code></a> feature is not enabled, <code>srcColorBlendFactor</code> <strong class=\"purple\">must</strong> not be <code>VK_BLEND_FACTOR_SRC1_COLOR</code>, <code>VK_BLEND_FACTOR_ONE_MINUS_SRC1_COLOR</code>, <code>VK_BLEND_FACTOR_SRC1_ALPHA</code>, or <code>VK_BLEND_FACTOR_ONE_MINUS_SRC1_ALPHA</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineColorBlendAttachmentState-dstColorBlendFactor-00609",
|
|
"text": " If the <a href=\"#features-dualSrcBlend\"><code>dualSrcBlend</code></a> feature is not enabled, <code>dstColorBlendFactor</code> <strong class=\"purple\">must</strong> not be <code>VK_BLEND_FACTOR_SRC1_COLOR</code>, <code>VK_BLEND_FACTOR_ONE_MINUS_SRC1_COLOR</code>, <code>VK_BLEND_FACTOR_SRC1_ALPHA</code>, or <code>VK_BLEND_FACTOR_ONE_MINUS_SRC1_ALPHA</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineColorBlendAttachmentState-srcAlphaBlendFactor-00610",
|
|
"text": " If the <a href=\"#features-dualSrcBlend\"><code>dualSrcBlend</code></a> feature is not enabled, <code>srcAlphaBlendFactor</code> <strong class=\"purple\">must</strong> not be <code>VK_BLEND_FACTOR_SRC1_COLOR</code>, <code>VK_BLEND_FACTOR_ONE_MINUS_SRC1_COLOR</code>, <code>VK_BLEND_FACTOR_SRC1_ALPHA</code>, or <code>VK_BLEND_FACTOR_ONE_MINUS_SRC1_ALPHA</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineColorBlendAttachmentState-dstAlphaBlendFactor-00611",
|
|
"text": " If the <a href=\"#features-dualSrcBlend\"><code>dualSrcBlend</code></a> feature is not enabled, <code>dstAlphaBlendFactor</code> <strong class=\"purple\">must</strong> not be <code>VK_BLEND_FACTOR_SRC1_COLOR</code>, <code>VK_BLEND_FACTOR_ONE_MINUS_SRC1_COLOR</code>, <code>VK_BLEND_FACTOR_SRC1_ALPHA</code>, or <code>VK_BLEND_FACTOR_ONE_MINUS_SRC1_ALPHA</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineColorBlendAttachmentState-srcColorBlendFactor-parameter",
|
|
"text": " <code>srcColorBlendFactor</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBlendFactor\">VkBlendFactor</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineColorBlendAttachmentState-dstColorBlendFactor-parameter",
|
|
"text": " <code>dstColorBlendFactor</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBlendFactor\">VkBlendFactor</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineColorBlendAttachmentState-colorBlendOp-parameter",
|
|
"text": " <code>colorBlendOp</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBlendOp\">VkBlendOp</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineColorBlendAttachmentState-srcAlphaBlendFactor-parameter",
|
|
"text": " <code>srcAlphaBlendFactor</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBlendFactor\">VkBlendFactor</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineColorBlendAttachmentState-dstAlphaBlendFactor-parameter",
|
|
"text": " <code>dstAlphaBlendFactor</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBlendFactor\">VkBlendFactor</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineColorBlendAttachmentState-alphaBlendOp-parameter",
|
|
"text": " <code>alphaBlendOp</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBlendOp\">VkBlendOp</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineColorBlendAttachmentState-colorWriteMask-parameter",
|
|
"text": " <code>colorWriteMask</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkColorComponentFlagBits\">VkColorComponentFlagBits</a> values"
|
|
}
|
|
],
|
|
"(VK_EXT_blend_operation_advanced)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineColorBlendAttachmentState-colorBlendOp-01406",
|
|
"text": " If either of <code>colorBlendOp</code> or <code>alphaBlendOp</code> is an <a href=\"#framebuffer-blend-advanced\">advanced blend operation</a>, then <code>colorBlendOp</code> <strong class=\"purple\">must</strong> equal <code>alphaBlendOp</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineColorBlendAttachmentState-advancedBlendIndependentBlend-01407",
|
|
"text": " If <a href=\"#VkPhysicalDeviceBlendOperationAdvancedPropertiesEXT\">VkPhysicalDeviceBlendOperationAdvancedPropertiesEXT</a>::<code>advancedBlendIndependentBlend</code> is <code>VK_FALSE</code> and <code>colorBlendOp</code> is an <a href=\"#framebuffer-blend-advanced\">advanced blend operation</a>, then <code>colorBlendOp</code> <strong class=\"purple\">must</strong> be the same for all attachments"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineColorBlendAttachmentState-advancedBlendIndependentBlend-01408",
|
|
"text": " If <a href=\"#VkPhysicalDeviceBlendOperationAdvancedPropertiesEXT\">VkPhysicalDeviceBlendOperationAdvancedPropertiesEXT</a>::<code>advancedBlendIndependentBlend</code> is <code>VK_FALSE</code> and <code>alphaBlendOp</code> is an <a href=\"#framebuffer-blend-advanced\">advanced blend operation</a>, then <code>alphaBlendOp</code> <strong class=\"purple\">must</strong> be the same for all attachments"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineColorBlendAttachmentState-advancedBlendAllOperations-01409",
|
|
"text": " If <a href=\"#VkPhysicalDeviceBlendOperationAdvancedPropertiesEXT\">VkPhysicalDeviceBlendOperationAdvancedPropertiesEXT</a>::<code>advancedBlendAllOperations</code> is <code>VK_FALSE</code>, then <code>colorBlendOp</code> <strong class=\"purple\">must</strong> not be <code>VK_BLEND_OP_ZERO_EXT</code>, <code>VK_BLEND_OP_SRC_EXT</code>, <code>VK_BLEND_OP_DST_EXT</code>, <code>VK_BLEND_OP_SRC_OVER_EXT</code>, <code>VK_BLEND_OP_DST_OVER_EXT</code>, <code>VK_BLEND_OP_SRC_IN_EXT</code>, <code>VK_BLEND_OP_DST_IN_EXT</code>, <code>VK_BLEND_OP_SRC_OUT_EXT</code>, <code>VK_BLEND_OP_DST_OUT_EXT</code>, <code>VK_BLEND_OP_SRC_ATOP_EXT</code>, <code>VK_BLEND_OP_DST_ATOP_EXT</code>, <code>VK_BLEND_OP_XOR_EXT</code>, <code>VK_BLEND_OP_INVERT_EXT</code>, <code>VK_BLEND_OP_INVERT_RGB_EXT</code>, <code>VK_BLEND_OP_LINEARDODGE_EXT</code>, <code>VK_BLEND_OP_LINEARBURN_EXT</code>, <code>VK_BLEND_OP_VIVIDLIGHT_EXT</code>, <code>VK_BLEND_OP_LINEARLIGHT_EXT</code>, <code>VK_BLEND_OP_PINLIGHT_EXT</code>, <code>VK_BLEND_OP_HARDMIX_EXT</code>, <code>VK_BLEND_OP_PLUS_EXT</code>, <code>VK_BLEND_OP_PLUS_CLAMPED_EXT</code>, <code>VK_BLEND_OP_PLUS_CLAMPED_ALPHA_EXT</code>, <code>VK_BLEND_OP_PLUS_DARKER_EXT</code>, <code>VK_BLEND_OP_MINUS_EXT</code>, <code>VK_BLEND_OP_MINUS_CLAMPED_EXT</code>, <code>VK_BLEND_OP_CONTRAST_EXT</code>, <code>VK_BLEND_OP_INVERT_OVG_EXT</code>, <code>VK_BLEND_OP_RED_EXT</code>, <code>VK_BLEND_OP_GREEN_EXT</code>, or <code>VK_BLEND_OP_BLUE_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineColorBlendAttachmentState-colorBlendOp-01410",
|
|
"text": " If <code>colorBlendOp</code> or <code>alphaBlendOp</code> is an <a href=\"#framebuffer-blend-advanced\">advanced blend operation</a>, then <code>colorAttachmentCount</code> of the subpass this pipeline is compiled against <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#VkPhysicalDeviceBlendOperationAdvancedPropertiesEXT\">VkPhysicalDeviceBlendOperationAdvancedPropertiesEXT</a>::<code>advancedBlendMaxColorAttachments</code>"
|
|
}
|
|
],
|
|
"(VK_KHR_portability_subset)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineColorBlendAttachmentState-constantAlphaColorBlendFactors-04454",
|
|
"text": " If the <code><a href=\"#VK_KHR_portability_subset\">VK_KHR_portability_subset</a></code> extension is enabled, and <a href=\"#VkPhysicalDevicePortabilitySubsetFeaturesKHR\">VkPhysicalDevicePortabilitySubsetFeaturesKHR</a>::<code>constantAlphaColorBlendFactors</code> is <code>VK_FALSE</code>, <code>srcColorBlendFactor</code> <strong class=\"purple\">must</strong> not be <code>VK_BLEND_FACTOR_CONSTANT_ALPHA</code> or <code>VK_BLEND_FACTOR_ONE_MINUS_CONSTANT_ALPHA</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineColorBlendAttachmentState-constantAlphaColorBlendFactors-04455",
|
|
"text": " If the <code><a href=\"#VK_KHR_portability_subset\">VK_KHR_portability_subset</a></code> extension is enabled, and <a href=\"#VkPhysicalDevicePortabilitySubsetFeaturesKHR\">VkPhysicalDevicePortabilitySubsetFeaturesKHR</a>::<code>constantAlphaColorBlendFactors</code> is <code>VK_FALSE</code>, <code>dstColorBlendFactor</code> <strong class=\"purple\">must</strong> not be <code>VK_BLEND_FACTOR_CONSTANT_ALPHA</code> or <code>VK_BLEND_FACTOR_ONE_MINUS_CONSTANT_ALPHA</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdSetBlendConstants": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetBlendConstants-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetBlendConstants-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetBlendConstants-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetBlendConstants-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
]
|
|
},
|
|
"VkPipelineColorBlendAdvancedStateCreateInfoEXT": {
|
|
"(VK_EXT_blend_operation_advanced)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineColorBlendAdvancedStateCreateInfoEXT-srcPremultiplied-01424",
|
|
"text": " If the <a href=\"#limits-advancedBlendNonPremultipliedSrcColor\">non-premultiplied source color</a> property is not supported, <code>srcPremultiplied</code> <strong class=\"purple\">must</strong> be <code>VK_TRUE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineColorBlendAdvancedStateCreateInfoEXT-dstPremultiplied-01425",
|
|
"text": " If the <a href=\"#limits-advancedBlendNonPremultipliedDstColor\">non-premultiplied destination color</a> property is not supported, <code>dstPremultiplied</code> <strong class=\"purple\">must</strong> be <code>VK_TRUE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineColorBlendAdvancedStateCreateInfoEXT-blendOverlap-01426",
|
|
"text": " If the <a href=\"#limits-advancedBlendCorrelatedOverlap\">correlated overlap</a> property is not supported, <code>blendOverlap</code> <strong class=\"purple\">must</strong> be <code>VK_BLEND_OVERLAP_UNCORRELATED_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineColorBlendAdvancedStateCreateInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PIPELINE_COLOR_BLEND_ADVANCED_STATE_CREATE_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineColorBlendAdvancedStateCreateInfoEXT-blendOverlap-parameter",
|
|
"text": " <code>blendOverlap</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBlendOverlapEXT\">VkBlendOverlapEXT</a> value"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdSetLogicOpEXT": {
|
|
"(VK_EXT_extended_dynamic_state2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetLogicOpEXT-None-04867",
|
|
"text": " The <a href=\"#features-extendedDynamicState2LogicOp\"><code>extendedDynamicState2LogicOp</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetLogicOpEXT-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetLogicOpEXT-logicOp-parameter",
|
|
"text": " <code>logicOp</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkLogicOp\">VkLogicOp</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetLogicOpEXT-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetLogicOpEXT-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetLogicOpEXT-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
]
|
|
},
|
|
"VkPipelineColorWriteCreateInfoEXT": {
|
|
"(VK_EXT_color_write_enable)": [
|
|
{
|
|
"vuid": "VUID-VkPipelineColorWriteCreateInfoEXT-pAttachments-04801",
|
|
"text": " If the <a href=\"#features-colorWriteEnable\"><code>colorWriteEnable</code></a> feature is not enabled, all elements of <code>pColorWriteEnables</code> <strong class=\"purple\">must</strong> be <code>VK_TRUE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineColorWriteCreateInfoEXT-attachmentCount-04802",
|
|
"text": " <code>attachmentCount</code> <strong class=\"purple\">must</strong> be equal to the <code>attachmentCount</code> member of the <code>VkPipelineColorBlendStateCreateInfo</code> structure specified during pipeline creation"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineColorWriteCreateInfoEXT-attachmentCount-06655",
|
|
"text": " <code>attachmentCount</code> <strong class=\"purple\">must</strong> be less than or equal to the <code>maxColorAttachments</code> member of <code>VkPhysicalDeviceLimits</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineColorWriteCreateInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PIPELINE_COLOR_WRITE_CREATE_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPipelineColorWriteCreateInfoEXT-pColorWriteEnables-parameter",
|
|
"text": " If <code>attachmentCount</code> is not <code>0</code>, <code>pColorWriteEnables</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>attachmentCount</code> <code>VkBool32</code> values"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdSetColorWriteEnableEXT": {
|
|
"(VK_EXT_color_write_enable)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetColorWriteEnableEXT-None-04803",
|
|
"text": " The <a href=\"#features-colorWriteEnable\"><code>colorWriteEnable</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetColorWriteEnableEXT-attachmentCount-06656",
|
|
"text": " <code>attachmentCount</code> <strong class=\"purple\">must</strong> be less than or equal to the <code>maxColorAttachments</code> member of <code>VkPhysicalDeviceLimits</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetColorWriteEnableEXT-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetColorWriteEnableEXT-pColorWriteEnables-parameter",
|
|
"text": " <code>pColorWriteEnables</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>attachmentCount</code> <code>VkBool32</code> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetColorWriteEnableEXT-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetColorWriteEnableEXT-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetColorWriteEnableEXT-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetColorWriteEnableEXT-attachmentCount-arraylength",
|
|
"text": " <code>attachmentCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetFramebufferTilePropertiesQCOM": {
|
|
"(VK_QCOM_tile_properties)": [
|
|
{
|
|
"vuid": "VUID-vkGetFramebufferTilePropertiesQCOM-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetFramebufferTilePropertiesQCOM-framebuffer-parameter",
|
|
"text": " <code>framebuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkFramebuffer\">VkFramebuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetFramebufferTilePropertiesQCOM-pPropertiesCount-parameter",
|
|
"text": " <code>pPropertiesCount</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>uint32_t</code> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetFramebufferTilePropertiesQCOM-pProperties-parameter",
|
|
"text": " If the value referenced by <code>pPropertiesCount</code> is not <code>0</code>, and <code>pProperties</code> is not <code>NULL</code>, <code>pProperties</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>pPropertiesCount</code> <a href=\"#VkTilePropertiesQCOM\">VkTilePropertiesQCOM</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetFramebufferTilePropertiesQCOM-framebuffer-parent",
|
|
"text": " <code>framebuffer</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdDispatch": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCmdDispatch-magFilter-04553",
|
|
"text": " If a <a href=\"#VkSampler\">VkSampler</a> created with <code>magFilter</code> or <code>minFilter</code> equal to <code>VK_FILTER_LINEAR</code> and <code>compareEnable</code> equal to <code>VK_FALSE</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatch-mipmapMode-04770",
|
|
"text": " If a <a href=\"#VkSampler\">VkSampler</a> created with <code>mipmapMode</code> equal to <code>VK_SAMPLER_MIPMAP_MODE_LINEAR</code> and <code>compareEnable</code> equal to <code>VK_FALSE</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatch-None-02691",
|
|
"text": " If a <code>VkImageView</code> is accessed using atomic operations as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_STORAGE_IMAGE_ATOMIC_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatch-None-02697",
|
|
"text": " For each set <em>n</em> that is statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command, a descriptor set <strong class=\"purple\">must</strong> have been bound to <em>n</em> at the same pipeline bind point, with a <code>VkPipelineLayout</code> that is compatible for set <em>n</em>, with the <code>VkPipelineLayout</code> used to create the current <code>VkPipeline</code>, as described in <a href=\"#descriptorsets-compatibility\">Pipeline Layout Compatibility</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatch-None-02699",
|
|
"text": " Descriptors in each bound descriptor set, specified via <code>vkCmdBindDescriptorSets</code>, <strong class=\"purple\">must</strong> be valid if they are statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatch-None-02700",
|
|
"text": " A valid pipeline <strong class=\"purple\">must</strong> be bound to the pipeline bind point used by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatch-commandBuffer-02701",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command requires any dynamic state, that state <strong class=\"purple\">must</strong> have been set or inherited (if the <code><a href=\"#VK_NV_inherited_viewport_scissor\">VK_NV_inherited_viewport_scissor</a></code> extension is enabled) for <code>commandBuffer</code>, and done so after any previously bound pipeline with the corresponding state not specified as dynamic"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatch-None-02859",
|
|
"text": " There <strong class=\"purple\">must</strong> not have been any calls to dynamic state setting commands for any state not specified as dynamic in the <code>VkPipeline</code> object bound to the pipeline bind point used by this command, since that pipeline was bound"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatch-None-02702",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> object that uses unnormalized coordinates, that sampler <strong class=\"purple\">must</strong> not be used to sample from any <code>VkImage</code> with a <code>VkImageView</code> of the type <code>VK_IMAGE_VIEW_TYPE_3D</code>, <code>VK_IMAGE_VIEW_TYPE_CUBE</code>, <code>VK_IMAGE_VIEW_TYPE_1D_ARRAY</code>, <code>VK_IMAGE_VIEW_TYPE_2D_ARRAY</code> or <code>VK_IMAGE_VIEW_TYPE_CUBE_ARRAY</code>, in any shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatch-None-02703",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> object that uses unnormalized coordinates, that sampler <strong class=\"purple\">must</strong> not be used with any of the SPIR-V <code>OpImageSample*</code> or <code>OpImageSparseSample*</code> instructions with <code>ImplicitLod</code>, <code>Dref</code> or <code>Proj</code> in their name, in any shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatch-None-02704",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> object that uses unnormalized coordinates, that sampler <strong class=\"purple\">must</strong> not be used with any of the SPIR-V <code>OpImageSample*</code> or <code>OpImageSparseSample*</code> instructions that includes a LOD bias or any offset values, in any shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatch-None-04115",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> is accessed using <code>OpImageWrite</code> as a result of this command, then the <code>Type</code> of the <code>Texel</code> operand of that instruction <strong class=\"purple\">must</strong> have at least as many components as the image view’s format"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatch-OpImageWrite-04469",
|
|
"text": " If a <a href=\"#VkBufferView\">VkBufferView</a> is accessed using <code>OpImageWrite</code> as a result of this command, then the <code>Type</code> of the <code>Texel</code> operand of that instruction <strong class=\"purple\">must</strong> have at least as many components as the buffer view’s format"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatch-groupCountX-00386",
|
|
"text": " <code>groupCountX</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxComputeWorkGroupCount</code>[0]"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatch-groupCountY-00387",
|
|
"text": " <code>groupCountY</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxComputeWorkGroupCount</code>[1]"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatch-groupCountZ-00388",
|
|
"text": " <code>groupCountZ</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxComputeWorkGroupCount</code>[2]"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatch-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatch-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatch-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support compute operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatch-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatch-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
],
|
|
"!(VK_VERSION_1_3,VK_KHR_format_feature_flags2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDispatch-aspectMask-06478",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> is sampled with <a href=\"#textures-depth-compare-operation\">depth comparison</a>, the image view <strong class=\"purple\">must</strong> have been created with an <code>aspectMask</code> that contains <code>VK_IMAGE_ASPECT_DEPTH_BIT</code>."
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_format_feature_flags2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDispatch-None-06479",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> is sampled with <a href=\"#textures-depth-compare-operation\">depth comparison</a>, the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_SAMPLED_IMAGE_DEPTH_COMPARISON_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatch-OpTypeImage-06423",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> or <a href=\"#VkBufferView\">VkBufferView</a> being written as a storage image or storage texel buffer where the image format field of the <code>OpTypeImage</code> is <code>Unknown</code> then the view’s format feature <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_STORAGE_WRITE_WITHOUT_FORMAT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatch-OpTypeImage-06424",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> or <a href=\"#VkBufferView\">VkBufferView</a> being read as a storage image or storage texel buffer where the image format field of the <code>OpTypeImage</code> is <code>Unknown</code> then the view’s format feature <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_STORAGE_READ_WITHOUT_FORMAT_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_IMG_filter_cubic,VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDispatch-None-02692",
|
|
"text": " If a <code>VkImageView</code> is sampled with <code>VK_FILTER_CUBIC_EXT</code> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_CUBIC_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_IMG_filter_cubic,VK_EXT_filter_cubic)+!(VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDispatch-None-02693",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> being sampled with <code>VK_FILTER_CUBIC_EXT</code> as a result of this command <strong class=\"purple\">must</strong> not have a <a href=\"#VkImageViewType\">VkImageViewType</a> of <code>VK_IMAGE_VIEW_TYPE_3D</code>, <code>VK_IMAGE_VIEW_TYPE_CUBE</code>, or <code>VK_IMAGE_VIEW_TYPE_CUBE_ARRAY</code>"
|
|
}
|
|
],
|
|
"(VK_IMG_filter_cubic,VK_EXT_filter_cubic)+(VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDispatch-filterCubic-02694",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> being sampled with <code>VK_FILTER_CUBIC_EXT</code> as a result of this command <strong class=\"purple\">must</strong> have a <a href=\"#VkImageViewType\">VkImageViewType</a> and format that supports cubic filtering, as specified by <code>VkFilterCubicImageViewImageFormatPropertiesEXT</code>::<code>filterCubic</code> returned by <code>vkGetPhysicalDeviceImageFormatProperties2</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatch-filterCubicMinmax-02695",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> being sampled with <code>VK_FILTER_CUBIC_EXT</code> with a reduction mode of either <code>VK_SAMPLER_REDUCTION_MODE_MIN</code> or <code>VK_SAMPLER_REDUCTION_MODE_MAX</code> as a result of this command <strong class=\"purple\">must</strong> have a <a href=\"#VkImageViewType\">VkImageViewType</a> and format that supports cubic filtering together with minmax filtering, as specified by <code>VkFilterCubicImageViewImageFormatPropertiesEXT</code>::<code>filterCubicMinmax</code> returned by <code>vkGetPhysicalDeviceImageFormatProperties2</code>"
|
|
}
|
|
],
|
|
"(VK_NV_corner_sampled_image)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDispatch-flags-02696",
|
|
"text": " Any <a href=\"#VkImage\">VkImage</a> created with a <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a>::<code>flags</code> containing <code>VK_IMAGE_CREATE_CORNER_SAMPLED_BIT_NV</code> sampled as a result of this command <strong class=\"purple\">must</strong> only be sampled using a <a href=\"#VkSamplerAddressMode\">VkSamplerAddressMode</a> of <code>VK_SAMPLER_ADDRESS_MODE_CLAMP_TO_EDGE</code>"
|
|
}
|
|
],
|
|
"!(VK_VERSION_1_3,VK_KHR_maintenance4)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDispatch-None-02698",
|
|
"text": " For each push constant that is statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command, a push constant value <strong class=\"purple\">must</strong> have been set for the same pipeline bind point, with a <code>VkPipelineLayout</code> that is compatible for push constants, with the <code>VkPipelineLayout</code> used to create the current <code>VkPipeline</code>, as described in <a href=\"#descriptorsets-compatibility\">Pipeline Layout Compatibility</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_maintenance4)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDispatch-maintenance4-06425",
|
|
"text": " If the <a href=\"#features-maintenance4\"><code>maintenance4</code></a> feature is not enabled, then for each push constant that is statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command, a push constant value <strong class=\"purple\">must</strong> have been set for the same pipeline bind point, with a <code>VkPipelineLayout</code> that is compatible for push constants, with the <code>VkPipelineLayout</code> used to create the current <code>VkPipeline</code>, as described in <a href=\"#descriptorsets-compatibility\">Pipeline Layout Compatibility</a>"
|
|
}
|
|
],
|
|
"!(VK_EXT_pipeline_robustness)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDispatch-None-02705",
|
|
"text": " If the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, and if the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a uniform buffer, it <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatch-None-02706",
|
|
"text": " If the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, and if the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a storage buffer, it <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
}
|
|
],
|
|
"(VK_EXT_pipeline_robustness)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDispatch-uniformBuffers-06935",
|
|
"text": " If any stage of the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a uniform buffer, and that stage was created without enabling either <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_EXT</code> or <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXT</code> for <code>uniformBuffers</code>, and the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, that stage <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatch-storageBuffers-06936",
|
|
"text": " If any stage of the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a storage buffer, and that stage was created without enabling either <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_EXT</code> or <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXT</code> for <code>storageBuffers</code>, and the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, that stage <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDispatch-commandBuffer-02707",
|
|
"text": " If <code>commandBuffer</code> is an unprotected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, any resource accessed by the <a href=\"#VkPipeline\">VkPipeline</a> object bound to the pipeline bind point used by this command <strong class=\"purple\">must</strong> not be a protected resource"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatch-commandBuffer-02712",
|
|
"text": " If <code>commandBuffer</code> is a protected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, any resource written to by the <code>VkPipeline</code> object bound to the pipeline bind point used by this command <strong class=\"purple\">must</strong> not be an unprotected resource"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatch-commandBuffer-02713",
|
|
"text": " If <code>commandBuffer</code> is a protected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, pipeline stages other than the framebuffer-space and compute stages in the <code>VkPipeline</code> object bound to the pipeline bind point used by this command <strong class=\"purple\">must</strong> not write to any resource"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatch-commandBuffer-04617",
|
|
"text": " If any of the shader stages of the <code>VkPipeline</code> bound to the pipeline bind point used by this command uses the <a href=\"#spirvenv-capabilities-table-RayQueryKHR\"><code>RayQueryKHR</code></a> capability, then <code>commandBuffer</code> <strong class=\"purple\">must</strong> not be a protected command buffer"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDispatch-None-06550",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> or <code>VkImageView</code> object that enables <a href=\"#samplers-YCbCr-conversion\">sampler {YCbCr} conversion</a>, that object <strong class=\"purple\">must</strong> only be used with <code>OpImageSample*</code> or <code>OpImageSparseSample*</code> instructions"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatch-ConstOffset-06551",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> or <code>VkImageView</code> object that enables <a href=\"#samplers-YCbCr-conversion\">sampler {YCbCr} conversion</a>, that object <strong class=\"purple\">must</strong> not use the <code>ConstOffset</code> and <code>Offset</code> operands"
|
|
}
|
|
],
|
|
"(VK_EXT_shader_image_atomic_int64)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDispatch-SampledType-04470",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a 64-bit component width is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 64"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatch-SampledType-04471",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a component width less than 64-bit is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 32"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatch-SampledType-04472",
|
|
"text": " If a <a href=\"#VkBufferView\">VkBufferView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a 64-bit component width is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 64"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatch-SampledType-04473",
|
|
"text": " If a <a href=\"#VkBufferView\">VkBufferView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a component width less than 64-bit is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 32"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatch-sparseImageInt64Atomics-04474",
|
|
"text": " If the <a href=\"#features-sparseImageInt64Atomics\"><code>sparseImageInt64Atomics</code></a> feature is not enabled, <a href=\"#VkImage\">VkImage</a> objects created with the <code>VK_IMAGE_CREATE_SPARSE_RESIDENCY_BIT</code> flag <strong class=\"purple\">must</strong> not be accessed by atomic instructions through an <code>OpTypeImage</code> with a <code>SampledType</code> with a <code>Width</code> of 64 by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatch-sparseImageInt64Atomics-04475",
|
|
"text": " If the <a href=\"#features-sparseImageInt64Atomics\"><code>sparseImageInt64Atomics</code></a> feature is not enabled, <a href=\"#VkBuffer\">VkBuffer</a> objects created with the <code>VK_BUFFER_CREATE_SPARSE_RESIDENCY_BIT</code> flag <strong class=\"purple\">must</strong> not be accessed by atomic instructions through an <code>OpTypeImage</code> with a <code>SampledType</code> with a <code>Width</code> of 64 by this command"
|
|
}
|
|
],
|
|
"(VK_QCOM_image_processing)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDispatch-OpImageWeightedSampleQCOM-06971",
|
|
"text": " If <code>OpImageWeightedSampleQCOM</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_WEIGHT_SAMPLED_IMAGE_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatch-OpImageWeightedSampleQCOM-06972",
|
|
"text": " If <code>OpImageWeightedSampleQCOM</code> uses a <a href=\"#VkImageView\">VkImageView</a> as a sample weight image as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_WEIGHT_IMAGE_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatch-OpImageBoxFilterQCOM-06973",
|
|
"text": " If <code>OpImageBoxFilterQCOM</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_BOX_FILTER_SAMPLED_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatch-OpImageBlockMatchSSDQCOM-06974",
|
|
"text": " If <code>OpImageBlockMatchSSDQCOM</code> is used to read from an <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatch-OpImageBlockMatchSADQCOM-06975",
|
|
"text": " If <code>OpImageBlockMatchSADQCOM</code> is used to read from an <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatch-OpImageBlockMatchSADQCOM-06976",
|
|
"text": " If <code>OpImageBlockMatchSADQCOM</code> or OpImageBlockMatchSSDQCOM is used to read from a reference image as result of this command, then the specified reference coordinates <strong class=\"purple\">must</strong> not fail <a href=\"#textures-integer-coordinate-validation\">integer texel coordinate validation</a>."
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatch-OpImageWeightedSampleQCOM-06977",
|
|
"text": " If <code>OpImageWeightedSampleQCOM</code>, <code>OpImageBoxFilterQCOM</code>, <code>OpImageBlockMatchSSDQCOM</code>, or <code>OpImageBlockMatchSADQCOM</code> uses a <a href=\"#VkSampler\">VkSampler</a> as a result of this command, then the sampler <strong class=\"purple\">must</strong> have been created with <code>VK_SAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatch-OpImageWeightedSampleQCOM-06978",
|
|
"text": " If any command other than <code>OpImageWeightedSampleQCOM</code>, <code>OpImageBoxFilterQCOM</code>, <code>OpImageBlockMatchSSDQCOM</code>, or <code>OpImageBlockMatchSADQCOM</code> uses a <a href=\"#VkSampler\">VkSampler</a> as a result of this command, then the sampler <strong class=\"purple\">must</strong> not have been created with <code>VK_SAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM</code>."
|
|
}
|
|
]
|
|
},
|
|
"vkCmdDispatchIndirect": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchIndirect-magFilter-04553",
|
|
"text": " If a <a href=\"#VkSampler\">VkSampler</a> created with <code>magFilter</code> or <code>minFilter</code> equal to <code>VK_FILTER_LINEAR</code> and <code>compareEnable</code> equal to <code>VK_FALSE</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchIndirect-mipmapMode-04770",
|
|
"text": " If a <a href=\"#VkSampler\">VkSampler</a> created with <code>mipmapMode</code> equal to <code>VK_SAMPLER_MIPMAP_MODE_LINEAR</code> and <code>compareEnable</code> equal to <code>VK_FALSE</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchIndirect-None-02691",
|
|
"text": " If a <code>VkImageView</code> is accessed using atomic operations as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_STORAGE_IMAGE_ATOMIC_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchIndirect-None-02697",
|
|
"text": " For each set <em>n</em> that is statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command, a descriptor set <strong class=\"purple\">must</strong> have been bound to <em>n</em> at the same pipeline bind point, with a <code>VkPipelineLayout</code> that is compatible for set <em>n</em>, with the <code>VkPipelineLayout</code> used to create the current <code>VkPipeline</code>, as described in <a href=\"#descriptorsets-compatibility\">Pipeline Layout Compatibility</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchIndirect-None-02699",
|
|
"text": " Descriptors in each bound descriptor set, specified via <code>vkCmdBindDescriptorSets</code>, <strong class=\"purple\">must</strong> be valid if they are statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchIndirect-None-02700",
|
|
"text": " A valid pipeline <strong class=\"purple\">must</strong> be bound to the pipeline bind point used by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchIndirect-commandBuffer-02701",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command requires any dynamic state, that state <strong class=\"purple\">must</strong> have been set or inherited (if the <code><a href=\"#VK_NV_inherited_viewport_scissor\">VK_NV_inherited_viewport_scissor</a></code> extension is enabled) for <code>commandBuffer</code>, and done so after any previously bound pipeline with the corresponding state not specified as dynamic"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchIndirect-None-02859",
|
|
"text": " There <strong class=\"purple\">must</strong> not have been any calls to dynamic state setting commands for any state not specified as dynamic in the <code>VkPipeline</code> object bound to the pipeline bind point used by this command, since that pipeline was bound"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchIndirect-None-02702",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> object that uses unnormalized coordinates, that sampler <strong class=\"purple\">must</strong> not be used to sample from any <code>VkImage</code> with a <code>VkImageView</code> of the type <code>VK_IMAGE_VIEW_TYPE_3D</code>, <code>VK_IMAGE_VIEW_TYPE_CUBE</code>, <code>VK_IMAGE_VIEW_TYPE_1D_ARRAY</code>, <code>VK_IMAGE_VIEW_TYPE_2D_ARRAY</code> or <code>VK_IMAGE_VIEW_TYPE_CUBE_ARRAY</code>, in any shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchIndirect-None-02703",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> object that uses unnormalized coordinates, that sampler <strong class=\"purple\">must</strong> not be used with any of the SPIR-V <code>OpImageSample*</code> or <code>OpImageSparseSample*</code> instructions with <code>ImplicitLod</code>, <code>Dref</code> or <code>Proj</code> in their name, in any shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchIndirect-None-02704",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> object that uses unnormalized coordinates, that sampler <strong class=\"purple\">must</strong> not be used with any of the SPIR-V <code>OpImageSample*</code> or <code>OpImageSparseSample*</code> instructions that includes a LOD bias or any offset values, in any shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchIndirect-None-04115",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> is accessed using <code>OpImageWrite</code> as a result of this command, then the <code>Type</code> of the <code>Texel</code> operand of that instruction <strong class=\"purple\">must</strong> have at least as many components as the image view’s format"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchIndirect-OpImageWrite-04469",
|
|
"text": " If a <a href=\"#VkBufferView\">VkBufferView</a> is accessed using <code>OpImageWrite</code> as a result of this command, then the <code>Type</code> of the <code>Texel</code> operand of that instruction <strong class=\"purple\">must</strong> have at least as many components as the buffer view’s format"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchIndirect-buffer-02708",
|
|
"text": " If <code>buffer</code> is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchIndirect-buffer-02709",
|
|
"text": " <code>buffer</code> <strong class=\"purple\">must</strong> have been created with the <code>VK_BUFFER_USAGE_INDIRECT_BUFFER_BIT</code> bit set"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchIndirect-offset-02710",
|
|
"text": " <code>offset</code> <strong class=\"purple\">must</strong> be a multiple of <code>4</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchIndirect-offset-00407",
|
|
"text": " The sum of <code>offset</code> and the size of <code>VkDispatchIndirectCommand</code> <strong class=\"purple\">must</strong> be less than or equal to the size of <code>buffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchIndirect-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchIndirect-buffer-parameter",
|
|
"text": " <code>buffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBuffer\">VkBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchIndirect-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchIndirect-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support compute operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchIndirect-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchIndirect-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchIndirect-commonparent",
|
|
"text": " Both of <code>buffer</code>, and <code>commandBuffer</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"!(VK_VERSION_1_3,VK_KHR_format_feature_flags2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchIndirect-aspectMask-06478",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> is sampled with <a href=\"#textures-depth-compare-operation\">depth comparison</a>, the image view <strong class=\"purple\">must</strong> have been created with an <code>aspectMask</code> that contains <code>VK_IMAGE_ASPECT_DEPTH_BIT</code>."
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_format_feature_flags2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchIndirect-None-06479",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> is sampled with <a href=\"#textures-depth-compare-operation\">depth comparison</a>, the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_SAMPLED_IMAGE_DEPTH_COMPARISON_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchIndirect-OpTypeImage-06423",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> or <a href=\"#VkBufferView\">VkBufferView</a> being written as a storage image or storage texel buffer where the image format field of the <code>OpTypeImage</code> is <code>Unknown</code> then the view’s format feature <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_STORAGE_WRITE_WITHOUT_FORMAT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchIndirect-OpTypeImage-06424",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> or <a href=\"#VkBufferView\">VkBufferView</a> being read as a storage image or storage texel buffer where the image format field of the <code>OpTypeImage</code> is <code>Unknown</code> then the view’s format feature <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_STORAGE_READ_WITHOUT_FORMAT_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_IMG_filter_cubic,VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchIndirect-None-02692",
|
|
"text": " If a <code>VkImageView</code> is sampled with <code>VK_FILTER_CUBIC_EXT</code> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_CUBIC_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_IMG_filter_cubic,VK_EXT_filter_cubic)+!(VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchIndirect-None-02693",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> being sampled with <code>VK_FILTER_CUBIC_EXT</code> as a result of this command <strong class=\"purple\">must</strong> not have a <a href=\"#VkImageViewType\">VkImageViewType</a> of <code>VK_IMAGE_VIEW_TYPE_3D</code>, <code>VK_IMAGE_VIEW_TYPE_CUBE</code>, or <code>VK_IMAGE_VIEW_TYPE_CUBE_ARRAY</code>"
|
|
}
|
|
],
|
|
"(VK_IMG_filter_cubic,VK_EXT_filter_cubic)+(VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchIndirect-filterCubic-02694",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> being sampled with <code>VK_FILTER_CUBIC_EXT</code> as a result of this command <strong class=\"purple\">must</strong> have a <a href=\"#VkImageViewType\">VkImageViewType</a> and format that supports cubic filtering, as specified by <code>VkFilterCubicImageViewImageFormatPropertiesEXT</code>::<code>filterCubic</code> returned by <code>vkGetPhysicalDeviceImageFormatProperties2</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchIndirect-filterCubicMinmax-02695",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> being sampled with <code>VK_FILTER_CUBIC_EXT</code> with a reduction mode of either <code>VK_SAMPLER_REDUCTION_MODE_MIN</code> or <code>VK_SAMPLER_REDUCTION_MODE_MAX</code> as a result of this command <strong class=\"purple\">must</strong> have a <a href=\"#VkImageViewType\">VkImageViewType</a> and format that supports cubic filtering together with minmax filtering, as specified by <code>VkFilterCubicImageViewImageFormatPropertiesEXT</code>::<code>filterCubicMinmax</code> returned by <code>vkGetPhysicalDeviceImageFormatProperties2</code>"
|
|
}
|
|
],
|
|
"(VK_NV_corner_sampled_image)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchIndirect-flags-02696",
|
|
"text": " Any <a href=\"#VkImage\">VkImage</a> created with a <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a>::<code>flags</code> containing <code>VK_IMAGE_CREATE_CORNER_SAMPLED_BIT_NV</code> sampled as a result of this command <strong class=\"purple\">must</strong> only be sampled using a <a href=\"#VkSamplerAddressMode\">VkSamplerAddressMode</a> of <code>VK_SAMPLER_ADDRESS_MODE_CLAMP_TO_EDGE</code>"
|
|
}
|
|
],
|
|
"!(VK_VERSION_1_3,VK_KHR_maintenance4)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchIndirect-None-02698",
|
|
"text": " For each push constant that is statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command, a push constant value <strong class=\"purple\">must</strong> have been set for the same pipeline bind point, with a <code>VkPipelineLayout</code> that is compatible for push constants, with the <code>VkPipelineLayout</code> used to create the current <code>VkPipeline</code>, as described in <a href=\"#descriptorsets-compatibility\">Pipeline Layout Compatibility</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_maintenance4)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchIndirect-maintenance4-06425",
|
|
"text": " If the <a href=\"#features-maintenance4\"><code>maintenance4</code></a> feature is not enabled, then for each push constant that is statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command, a push constant value <strong class=\"purple\">must</strong> have been set for the same pipeline bind point, with a <code>VkPipelineLayout</code> that is compatible for push constants, with the <code>VkPipelineLayout</code> used to create the current <code>VkPipeline</code>, as described in <a href=\"#descriptorsets-compatibility\">Pipeline Layout Compatibility</a>"
|
|
}
|
|
],
|
|
"!(VK_EXT_pipeline_robustness)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchIndirect-None-02705",
|
|
"text": " If the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, and if the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a uniform buffer, it <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchIndirect-None-02706",
|
|
"text": " If the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, and if the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a storage buffer, it <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
}
|
|
],
|
|
"(VK_EXT_pipeline_robustness)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchIndirect-uniformBuffers-06935",
|
|
"text": " If any stage of the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a uniform buffer, and that stage was created without enabling either <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_EXT</code> or <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXT</code> for <code>uniformBuffers</code>, and the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, that stage <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchIndirect-storageBuffers-06936",
|
|
"text": " If any stage of the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a storage buffer, and that stage was created without enabling either <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_EXT</code> or <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXT</code> for <code>storageBuffers</code>, and the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, that stage <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchIndirect-commandBuffer-02707",
|
|
"text": " If <code>commandBuffer</code> is an unprotected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, any resource accessed by the <a href=\"#VkPipeline\">VkPipeline</a> object bound to the pipeline bind point used by this command <strong class=\"purple\">must</strong> not be a protected resource"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchIndirect-commandBuffer-02711",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> not be a protected command buffer"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchIndirect-None-06550",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> or <code>VkImageView</code> object that enables <a href=\"#samplers-YCbCr-conversion\">sampler {YCbCr} conversion</a>, that object <strong class=\"purple\">must</strong> only be used with <code>OpImageSample*</code> or <code>OpImageSparseSample*</code> instructions"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchIndirect-ConstOffset-06551",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> or <code>VkImageView</code> object that enables <a href=\"#samplers-YCbCr-conversion\">sampler {YCbCr} conversion</a>, that object <strong class=\"purple\">must</strong> not use the <code>ConstOffset</code> and <code>Offset</code> operands"
|
|
}
|
|
],
|
|
"(VK_EXT_shader_image_atomic_int64)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchIndirect-SampledType-04470",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a 64-bit component width is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 64"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchIndirect-SampledType-04471",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a component width less than 64-bit is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 32"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchIndirect-SampledType-04472",
|
|
"text": " If a <a href=\"#VkBufferView\">VkBufferView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a 64-bit component width is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 64"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchIndirect-SampledType-04473",
|
|
"text": " If a <a href=\"#VkBufferView\">VkBufferView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a component width less than 64-bit is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 32"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchIndirect-sparseImageInt64Atomics-04474",
|
|
"text": " If the <a href=\"#features-sparseImageInt64Atomics\"><code>sparseImageInt64Atomics</code></a> feature is not enabled, <a href=\"#VkImage\">VkImage</a> objects created with the <code>VK_IMAGE_CREATE_SPARSE_RESIDENCY_BIT</code> flag <strong class=\"purple\">must</strong> not be accessed by atomic instructions through an <code>OpTypeImage</code> with a <code>SampledType</code> with a <code>Width</code> of 64 by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchIndirect-sparseImageInt64Atomics-04475",
|
|
"text": " If the <a href=\"#features-sparseImageInt64Atomics\"><code>sparseImageInt64Atomics</code></a> feature is not enabled, <a href=\"#VkBuffer\">VkBuffer</a> objects created with the <code>VK_BUFFER_CREATE_SPARSE_RESIDENCY_BIT</code> flag <strong class=\"purple\">must</strong> not be accessed by atomic instructions through an <code>OpTypeImage</code> with a <code>SampledType</code> with a <code>Width</code> of 64 by this command"
|
|
}
|
|
],
|
|
"(VK_QCOM_image_processing)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchIndirect-OpImageWeightedSampleQCOM-06971",
|
|
"text": " If <code>OpImageWeightedSampleQCOM</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_WEIGHT_SAMPLED_IMAGE_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchIndirect-OpImageWeightedSampleQCOM-06972",
|
|
"text": " If <code>OpImageWeightedSampleQCOM</code> uses a <a href=\"#VkImageView\">VkImageView</a> as a sample weight image as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_WEIGHT_IMAGE_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchIndirect-OpImageBoxFilterQCOM-06973",
|
|
"text": " If <code>OpImageBoxFilterQCOM</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_BOX_FILTER_SAMPLED_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchIndirect-OpImageBlockMatchSSDQCOM-06974",
|
|
"text": " If <code>OpImageBlockMatchSSDQCOM</code> is used to read from an <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchIndirect-OpImageBlockMatchSADQCOM-06975",
|
|
"text": " If <code>OpImageBlockMatchSADQCOM</code> is used to read from an <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchIndirect-OpImageBlockMatchSADQCOM-06976",
|
|
"text": " If <code>OpImageBlockMatchSADQCOM</code> or OpImageBlockMatchSSDQCOM is used to read from a reference image as result of this command, then the specified reference coordinates <strong class=\"purple\">must</strong> not fail <a href=\"#textures-integer-coordinate-validation\">integer texel coordinate validation</a>."
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchIndirect-OpImageWeightedSampleQCOM-06977",
|
|
"text": " If <code>OpImageWeightedSampleQCOM</code>, <code>OpImageBoxFilterQCOM</code>, <code>OpImageBlockMatchSSDQCOM</code>, or <code>OpImageBlockMatchSADQCOM</code> uses a <a href=\"#VkSampler\">VkSampler</a> as a result of this command, then the sampler <strong class=\"purple\">must</strong> have been created with <code>VK_SAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchIndirect-OpImageWeightedSampleQCOM-06978",
|
|
"text": " If any command other than <code>OpImageWeightedSampleQCOM</code>, <code>OpImageBoxFilterQCOM</code>, <code>OpImageBlockMatchSSDQCOM</code>, or <code>OpImageBlockMatchSADQCOM</code> uses a <a href=\"#VkSampler\">VkSampler</a> as a result of this command, then the sampler <strong class=\"purple\">must</strong> not have been created with <code>VK_SAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM</code>."
|
|
}
|
|
]
|
|
},
|
|
"VkDispatchIndirectCommand": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkDispatchIndirectCommand-x-00417",
|
|
"text": " <code>x</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxComputeWorkGroupCount</code>[0]"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDispatchIndirectCommand-y-00418",
|
|
"text": " <code>y</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxComputeWorkGroupCount</code>[1]"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDispatchIndirectCommand-z-00419",
|
|
"text": " <code>z</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxComputeWorkGroupCount</code>[2]"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdDispatchBase": {
|
|
"(VK_VERSION_1_1,VK_KHR_device_group)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchBase-magFilter-04553",
|
|
"text": " If a <a href=\"#VkSampler\">VkSampler</a> created with <code>magFilter</code> or <code>minFilter</code> equal to <code>VK_FILTER_LINEAR</code> and <code>compareEnable</code> equal to <code>VK_FALSE</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchBase-mipmapMode-04770",
|
|
"text": " If a <a href=\"#VkSampler\">VkSampler</a> created with <code>mipmapMode</code> equal to <code>VK_SAMPLER_MIPMAP_MODE_LINEAR</code> and <code>compareEnable</code> equal to <code>VK_FALSE</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchBase-None-02691",
|
|
"text": " If a <code>VkImageView</code> is accessed using atomic operations as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_STORAGE_IMAGE_ATOMIC_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchBase-None-02697",
|
|
"text": " For each set <em>n</em> that is statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command, a descriptor set <strong class=\"purple\">must</strong> have been bound to <em>n</em> at the same pipeline bind point, with a <code>VkPipelineLayout</code> that is compatible for set <em>n</em>, with the <code>VkPipelineLayout</code> used to create the current <code>VkPipeline</code>, as described in <a href=\"#descriptorsets-compatibility\">Pipeline Layout Compatibility</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchBase-None-02699",
|
|
"text": " Descriptors in each bound descriptor set, specified via <code>vkCmdBindDescriptorSets</code>, <strong class=\"purple\">must</strong> be valid if they are statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchBase-None-02700",
|
|
"text": " A valid pipeline <strong class=\"purple\">must</strong> be bound to the pipeline bind point used by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchBase-commandBuffer-02701",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command requires any dynamic state, that state <strong class=\"purple\">must</strong> have been set or inherited (if the <code><a href=\"#VK_NV_inherited_viewport_scissor\">VK_NV_inherited_viewport_scissor</a></code> extension is enabled) for <code>commandBuffer</code>, and done so after any previously bound pipeline with the corresponding state not specified as dynamic"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchBase-None-02859",
|
|
"text": " There <strong class=\"purple\">must</strong> not have been any calls to dynamic state setting commands for any state not specified as dynamic in the <code>VkPipeline</code> object bound to the pipeline bind point used by this command, since that pipeline was bound"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchBase-None-02702",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> object that uses unnormalized coordinates, that sampler <strong class=\"purple\">must</strong> not be used to sample from any <code>VkImage</code> with a <code>VkImageView</code> of the type <code>VK_IMAGE_VIEW_TYPE_3D</code>, <code>VK_IMAGE_VIEW_TYPE_CUBE</code>, <code>VK_IMAGE_VIEW_TYPE_1D_ARRAY</code>, <code>VK_IMAGE_VIEW_TYPE_2D_ARRAY</code> or <code>VK_IMAGE_VIEW_TYPE_CUBE_ARRAY</code>, in any shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchBase-None-02703",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> object that uses unnormalized coordinates, that sampler <strong class=\"purple\">must</strong> not be used with any of the SPIR-V <code>OpImageSample*</code> or <code>OpImageSparseSample*</code> instructions with <code>ImplicitLod</code>, <code>Dref</code> or <code>Proj</code> in their name, in any shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchBase-None-02704",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> object that uses unnormalized coordinates, that sampler <strong class=\"purple\">must</strong> not be used with any of the SPIR-V <code>OpImageSample*</code> or <code>OpImageSparseSample*</code> instructions that includes a LOD bias or any offset values, in any shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchBase-None-04115",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> is accessed using <code>OpImageWrite</code> as a result of this command, then the <code>Type</code> of the <code>Texel</code> operand of that instruction <strong class=\"purple\">must</strong> have at least as many components as the image view’s format"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchBase-OpImageWrite-04469",
|
|
"text": " If a <a href=\"#VkBufferView\">VkBufferView</a> is accessed using <code>OpImageWrite</code> as a result of this command, then the <code>Type</code> of the <code>Texel</code> operand of that instruction <strong class=\"purple\">must</strong> have at least as many components as the buffer view’s format"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchBase-baseGroupX-00421",
|
|
"text": " <code>baseGroupX</code> <strong class=\"purple\">must</strong> be less than <code>VkPhysicalDeviceLimits</code>::<code>maxComputeWorkGroupCount</code>[0]"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchBase-baseGroupX-00422",
|
|
"text": " <code>baseGroupY</code> <strong class=\"purple\">must</strong> be less than <code>VkPhysicalDeviceLimits</code>::<code>maxComputeWorkGroupCount</code>[1]"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchBase-baseGroupZ-00423",
|
|
"text": " <code>baseGroupZ</code> <strong class=\"purple\">must</strong> be less than <code>VkPhysicalDeviceLimits</code>::<code>maxComputeWorkGroupCount</code>[2]"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchBase-groupCountX-00424",
|
|
"text": " <code>groupCountX</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxComputeWorkGroupCount</code>[0] minus <code>baseGroupX</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchBase-groupCountY-00425",
|
|
"text": " <code>groupCountY</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxComputeWorkGroupCount</code>[1] minus <code>baseGroupY</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchBase-groupCountZ-00426",
|
|
"text": " <code>groupCountZ</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxComputeWorkGroupCount</code>[2] minus <code>baseGroupZ</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchBase-baseGroupX-00427",
|
|
"text": " If any of <code>baseGroupX</code>, <code>baseGroupY</code>, or <code>baseGroupZ</code> are not zero, then the bound compute pipeline <strong class=\"purple\">must</strong> have been created with the <code>VK_PIPELINE_CREATE_DISPATCH_BASE</code> flag"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchBase-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchBase-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchBase-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support compute operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchBase-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchBase-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_device_group)+!(VK_VERSION_1_3,VK_KHR_format_feature_flags2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchBase-aspectMask-06478",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> is sampled with <a href=\"#textures-depth-compare-operation\">depth comparison</a>, the image view <strong class=\"purple\">must</strong> have been created with an <code>aspectMask</code> that contains <code>VK_IMAGE_ASPECT_DEPTH_BIT</code>."
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_device_group)+(VK_VERSION_1_3,VK_KHR_format_feature_flags2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchBase-None-06479",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> is sampled with <a href=\"#textures-depth-compare-operation\">depth comparison</a>, the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_SAMPLED_IMAGE_DEPTH_COMPARISON_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchBase-OpTypeImage-06423",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> or <a href=\"#VkBufferView\">VkBufferView</a> being written as a storage image or storage texel buffer where the image format field of the <code>OpTypeImage</code> is <code>Unknown</code> then the view’s format feature <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_STORAGE_WRITE_WITHOUT_FORMAT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchBase-OpTypeImage-06424",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> or <a href=\"#VkBufferView\">VkBufferView</a> being read as a storage image or storage texel buffer where the image format field of the <code>OpTypeImage</code> is <code>Unknown</code> then the view’s format feature <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_STORAGE_READ_WITHOUT_FORMAT_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_device_group)+(VK_IMG_filter_cubic,VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchBase-None-02692",
|
|
"text": " If a <code>VkImageView</code> is sampled with <code>VK_FILTER_CUBIC_EXT</code> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_CUBIC_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_device_group)+(VK_IMG_filter_cubic,VK_EXT_filter_cubic)+!(VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchBase-None-02693",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> being sampled with <code>VK_FILTER_CUBIC_EXT</code> as a result of this command <strong class=\"purple\">must</strong> not have a <a href=\"#VkImageViewType\">VkImageViewType</a> of <code>VK_IMAGE_VIEW_TYPE_3D</code>, <code>VK_IMAGE_VIEW_TYPE_CUBE</code>, or <code>VK_IMAGE_VIEW_TYPE_CUBE_ARRAY</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_device_group)+(VK_IMG_filter_cubic,VK_EXT_filter_cubic)+(VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchBase-filterCubic-02694",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> being sampled with <code>VK_FILTER_CUBIC_EXT</code> as a result of this command <strong class=\"purple\">must</strong> have a <a href=\"#VkImageViewType\">VkImageViewType</a> and format that supports cubic filtering, as specified by <code>VkFilterCubicImageViewImageFormatPropertiesEXT</code>::<code>filterCubic</code> returned by <code>vkGetPhysicalDeviceImageFormatProperties2</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchBase-filterCubicMinmax-02695",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> being sampled with <code>VK_FILTER_CUBIC_EXT</code> with a reduction mode of either <code>VK_SAMPLER_REDUCTION_MODE_MIN</code> or <code>VK_SAMPLER_REDUCTION_MODE_MAX</code> as a result of this command <strong class=\"purple\">must</strong> have a <a href=\"#VkImageViewType\">VkImageViewType</a> and format that supports cubic filtering together with minmax filtering, as specified by <code>VkFilterCubicImageViewImageFormatPropertiesEXT</code>::<code>filterCubicMinmax</code> returned by <code>vkGetPhysicalDeviceImageFormatProperties2</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_device_group)+(VK_NV_corner_sampled_image)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchBase-flags-02696",
|
|
"text": " Any <a href=\"#VkImage\">VkImage</a> created with a <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a>::<code>flags</code> containing <code>VK_IMAGE_CREATE_CORNER_SAMPLED_BIT_NV</code> sampled as a result of this command <strong class=\"purple\">must</strong> only be sampled using a <a href=\"#VkSamplerAddressMode\">VkSamplerAddressMode</a> of <code>VK_SAMPLER_ADDRESS_MODE_CLAMP_TO_EDGE</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_device_group)+!(VK_VERSION_1_3,VK_KHR_maintenance4)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchBase-None-02698",
|
|
"text": " For each push constant that is statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command, a push constant value <strong class=\"purple\">must</strong> have been set for the same pipeline bind point, with a <code>VkPipelineLayout</code> that is compatible for push constants, with the <code>VkPipelineLayout</code> used to create the current <code>VkPipeline</code>, as described in <a href=\"#descriptorsets-compatibility\">Pipeline Layout Compatibility</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_device_group)+(VK_VERSION_1_3,VK_KHR_maintenance4)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchBase-maintenance4-06425",
|
|
"text": " If the <a href=\"#features-maintenance4\"><code>maintenance4</code></a> feature is not enabled, then for each push constant that is statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command, a push constant value <strong class=\"purple\">must</strong> have been set for the same pipeline bind point, with a <code>VkPipelineLayout</code> that is compatible for push constants, with the <code>VkPipelineLayout</code> used to create the current <code>VkPipeline</code>, as described in <a href=\"#descriptorsets-compatibility\">Pipeline Layout Compatibility</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_device_group)+!(VK_EXT_pipeline_robustness)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchBase-None-02705",
|
|
"text": " If the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, and if the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a uniform buffer, it <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchBase-None-02706",
|
|
"text": " If the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, and if the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a storage buffer, it <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_device_group)+(VK_EXT_pipeline_robustness)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchBase-uniformBuffers-06935",
|
|
"text": " If any stage of the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a uniform buffer, and that stage was created without enabling either <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_EXT</code> or <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXT</code> for <code>uniformBuffers</code>, and the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, that stage <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchBase-storageBuffers-06936",
|
|
"text": " If any stage of the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a storage buffer, and that stage was created without enabling either <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_EXT</code> or <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXT</code> for <code>storageBuffers</code>, and the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, that stage <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_device_group)+(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchBase-commandBuffer-02707",
|
|
"text": " If <code>commandBuffer</code> is an unprotected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, any resource accessed by the <a href=\"#VkPipeline\">VkPipeline</a> object bound to the pipeline bind point used by this command <strong class=\"purple\">must</strong> not be a protected resource"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchBase-commandBuffer-02712",
|
|
"text": " If <code>commandBuffer</code> is a protected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, any resource written to by the <code>VkPipeline</code> object bound to the pipeline bind point used by this command <strong class=\"purple\">must</strong> not be an unprotected resource"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchBase-commandBuffer-02713",
|
|
"text": " If <code>commandBuffer</code> is a protected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, pipeline stages other than the framebuffer-space and compute stages in the <code>VkPipeline</code> object bound to the pipeline bind point used by this command <strong class=\"purple\">must</strong> not write to any resource"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchBase-commandBuffer-04617",
|
|
"text": " If any of the shader stages of the <code>VkPipeline</code> bound to the pipeline bind point used by this command uses the <a href=\"#spirvenv-capabilities-table-RayQueryKHR\"><code>RayQueryKHR</code></a> capability, then <code>commandBuffer</code> <strong class=\"purple\">must</strong> not be a protected command buffer"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_device_group)+(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchBase-None-06550",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> or <code>VkImageView</code> object that enables <a href=\"#samplers-YCbCr-conversion\">sampler {YCbCr} conversion</a>, that object <strong class=\"purple\">must</strong> only be used with <code>OpImageSample*</code> or <code>OpImageSparseSample*</code> instructions"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchBase-ConstOffset-06551",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> or <code>VkImageView</code> object that enables <a href=\"#samplers-YCbCr-conversion\">sampler {YCbCr} conversion</a>, that object <strong class=\"purple\">must</strong> not use the <code>ConstOffset</code> and <code>Offset</code> operands"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_device_group)+(VK_EXT_shader_image_atomic_int64)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchBase-SampledType-04470",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a 64-bit component width is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 64"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchBase-SampledType-04471",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a component width less than 64-bit is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 32"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchBase-SampledType-04472",
|
|
"text": " If a <a href=\"#VkBufferView\">VkBufferView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a 64-bit component width is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 64"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchBase-SampledType-04473",
|
|
"text": " If a <a href=\"#VkBufferView\">VkBufferView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a component width less than 64-bit is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 32"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchBase-sparseImageInt64Atomics-04474",
|
|
"text": " If the <a href=\"#features-sparseImageInt64Atomics\"><code>sparseImageInt64Atomics</code></a> feature is not enabled, <a href=\"#VkImage\">VkImage</a> objects created with the <code>VK_IMAGE_CREATE_SPARSE_RESIDENCY_BIT</code> flag <strong class=\"purple\">must</strong> not be accessed by atomic instructions through an <code>OpTypeImage</code> with a <code>SampledType</code> with a <code>Width</code> of 64 by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchBase-sparseImageInt64Atomics-04475",
|
|
"text": " If the <a href=\"#features-sparseImageInt64Atomics\"><code>sparseImageInt64Atomics</code></a> feature is not enabled, <a href=\"#VkBuffer\">VkBuffer</a> objects created with the <code>VK_BUFFER_CREATE_SPARSE_RESIDENCY_BIT</code> flag <strong class=\"purple\">must</strong> not be accessed by atomic instructions through an <code>OpTypeImage</code> with a <code>SampledType</code> with a <code>Width</code> of 64 by this command"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_device_group)+(VK_QCOM_image_processing)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchBase-OpImageWeightedSampleQCOM-06971",
|
|
"text": " If <code>OpImageWeightedSampleQCOM</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_WEIGHT_SAMPLED_IMAGE_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchBase-OpImageWeightedSampleQCOM-06972",
|
|
"text": " If <code>OpImageWeightedSampleQCOM</code> uses a <a href=\"#VkImageView\">VkImageView</a> as a sample weight image as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_WEIGHT_IMAGE_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchBase-OpImageBoxFilterQCOM-06973",
|
|
"text": " If <code>OpImageBoxFilterQCOM</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_BOX_FILTER_SAMPLED_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchBase-OpImageBlockMatchSSDQCOM-06974",
|
|
"text": " If <code>OpImageBlockMatchSSDQCOM</code> is used to read from an <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchBase-OpImageBlockMatchSADQCOM-06975",
|
|
"text": " If <code>OpImageBlockMatchSADQCOM</code> is used to read from an <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchBase-OpImageBlockMatchSADQCOM-06976",
|
|
"text": " If <code>OpImageBlockMatchSADQCOM</code> or OpImageBlockMatchSSDQCOM is used to read from a reference image as result of this command, then the specified reference coordinates <strong class=\"purple\">must</strong> not fail <a href=\"#textures-integer-coordinate-validation\">integer texel coordinate validation</a>."
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchBase-OpImageWeightedSampleQCOM-06977",
|
|
"text": " If <code>OpImageWeightedSampleQCOM</code>, <code>OpImageBoxFilterQCOM</code>, <code>OpImageBlockMatchSSDQCOM</code>, or <code>OpImageBlockMatchSADQCOM</code> uses a <a href=\"#VkSampler\">VkSampler</a> as a result of this command, then the sampler <strong class=\"purple\">must</strong> have been created with <code>VK_SAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDispatchBase-OpImageWeightedSampleQCOM-06978",
|
|
"text": " If any command other than <code>OpImageWeightedSampleQCOM</code>, <code>OpImageBoxFilterQCOM</code>, <code>OpImageBlockMatchSSDQCOM</code>, or <code>OpImageBlockMatchSADQCOM</code> uses a <a href=\"#VkSampler\">VkSampler</a> as a result of this command, then the sampler <strong class=\"purple\">must</strong> not have been created with <code>VK_SAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM</code>."
|
|
}
|
|
]
|
|
},
|
|
"vkCmdSubpassShadingHUAWEI": {
|
|
"(VK_HUAWEI_subpass_shading)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSubpassShadingHUAWEI-magFilter-04553",
|
|
"text": " If a <a href=\"#VkSampler\">VkSampler</a> created with <code>magFilter</code> or <code>minFilter</code> equal to <code>VK_FILTER_LINEAR</code> and <code>compareEnable</code> equal to <code>VK_FALSE</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSubpassShadingHUAWEI-mipmapMode-04770",
|
|
"text": " If a <a href=\"#VkSampler\">VkSampler</a> created with <code>mipmapMode</code> equal to <code>VK_SAMPLER_MIPMAP_MODE_LINEAR</code> and <code>compareEnable</code> equal to <code>VK_FALSE</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSubpassShadingHUAWEI-None-02691",
|
|
"text": " If a <code>VkImageView</code> is accessed using atomic operations as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_STORAGE_IMAGE_ATOMIC_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSubpassShadingHUAWEI-None-02697",
|
|
"text": " For each set <em>n</em> that is statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command, a descriptor set <strong class=\"purple\">must</strong> have been bound to <em>n</em> at the same pipeline bind point, with a <code>VkPipelineLayout</code> that is compatible for set <em>n</em>, with the <code>VkPipelineLayout</code> used to create the current <code>VkPipeline</code>, as described in <a href=\"#descriptorsets-compatibility\">Pipeline Layout Compatibility</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSubpassShadingHUAWEI-None-02699",
|
|
"text": " Descriptors in each bound descriptor set, specified via <code>vkCmdBindDescriptorSets</code>, <strong class=\"purple\">must</strong> be valid if they are statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSubpassShadingHUAWEI-None-02700",
|
|
"text": " A valid pipeline <strong class=\"purple\">must</strong> be bound to the pipeline bind point used by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSubpassShadingHUAWEI-commandBuffer-02701",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command requires any dynamic state, that state <strong class=\"purple\">must</strong> have been set or inherited (if the <code><a href=\"#VK_NV_inherited_viewport_scissor\">VK_NV_inherited_viewport_scissor</a></code> extension is enabled) for <code>commandBuffer</code>, and done so after any previously bound pipeline with the corresponding state not specified as dynamic"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSubpassShadingHUAWEI-None-02859",
|
|
"text": " There <strong class=\"purple\">must</strong> not have been any calls to dynamic state setting commands for any state not specified as dynamic in the <code>VkPipeline</code> object bound to the pipeline bind point used by this command, since that pipeline was bound"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSubpassShadingHUAWEI-None-02702",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> object that uses unnormalized coordinates, that sampler <strong class=\"purple\">must</strong> not be used to sample from any <code>VkImage</code> with a <code>VkImageView</code> of the type <code>VK_IMAGE_VIEW_TYPE_3D</code>, <code>VK_IMAGE_VIEW_TYPE_CUBE</code>, <code>VK_IMAGE_VIEW_TYPE_1D_ARRAY</code>, <code>VK_IMAGE_VIEW_TYPE_2D_ARRAY</code> or <code>VK_IMAGE_VIEW_TYPE_CUBE_ARRAY</code>, in any shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSubpassShadingHUAWEI-None-02703",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> object that uses unnormalized coordinates, that sampler <strong class=\"purple\">must</strong> not be used with any of the SPIR-V <code>OpImageSample*</code> or <code>OpImageSparseSample*</code> instructions with <code>ImplicitLod</code>, <code>Dref</code> or <code>Proj</code> in their name, in any shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSubpassShadingHUAWEI-None-02704",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> object that uses unnormalized coordinates, that sampler <strong class=\"purple\">must</strong> not be used with any of the SPIR-V <code>OpImageSample*</code> or <code>OpImageSparseSample*</code> instructions that includes a LOD bias or any offset values, in any shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSubpassShadingHUAWEI-None-04115",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> is accessed using <code>OpImageWrite</code> as a result of this command, then the <code>Type</code> of the <code>Texel</code> operand of that instruction <strong class=\"purple\">must</strong> have at least as many components as the image view’s format"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSubpassShadingHUAWEI-OpImageWrite-04469",
|
|
"text": " If a <a href=\"#VkBufferView\">VkBufferView</a> is accessed using <code>OpImageWrite</code> as a result of this command, then the <code>Type</code> of the <code>Texel</code> operand of that instruction <strong class=\"purple\">must</strong> have at least as many components as the buffer view’s format"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSubpassShadingHUAWEI-None-04931",
|
|
"text": " This command must be called in a subpass with bind point <code>VK_PIPELINE_BIND_POINT_SUBPASS_SHADING_HUAWEI</code>. No draw commands can be called in the same subpass. Only one <a href=\"#vkCmdSubpassShadingHUAWEI\">vkCmdSubpassShadingHUAWEI</a> command can be called in a subpass"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSubpassShadingHUAWEI-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSubpassShadingHUAWEI-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSubpassShadingHUAWEI-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSubpassShadingHUAWEI-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called inside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSubpassShadingHUAWEI-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
],
|
|
"(VK_HUAWEI_subpass_shading)+!(VK_VERSION_1_3,VK_KHR_format_feature_flags2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSubpassShadingHUAWEI-aspectMask-06478",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> is sampled with <a href=\"#textures-depth-compare-operation\">depth comparison</a>, the image view <strong class=\"purple\">must</strong> have been created with an <code>aspectMask</code> that contains <code>VK_IMAGE_ASPECT_DEPTH_BIT</code>."
|
|
}
|
|
],
|
|
"(VK_HUAWEI_subpass_shading)+(VK_VERSION_1_3,VK_KHR_format_feature_flags2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSubpassShadingHUAWEI-None-06479",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> is sampled with <a href=\"#textures-depth-compare-operation\">depth comparison</a>, the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_SAMPLED_IMAGE_DEPTH_COMPARISON_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSubpassShadingHUAWEI-OpTypeImage-06423",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> or <a href=\"#VkBufferView\">VkBufferView</a> being written as a storage image or storage texel buffer where the image format field of the <code>OpTypeImage</code> is <code>Unknown</code> then the view’s format feature <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_STORAGE_WRITE_WITHOUT_FORMAT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSubpassShadingHUAWEI-OpTypeImage-06424",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> or <a href=\"#VkBufferView\">VkBufferView</a> being read as a storage image or storage texel buffer where the image format field of the <code>OpTypeImage</code> is <code>Unknown</code> then the view’s format feature <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_STORAGE_READ_WITHOUT_FORMAT_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_HUAWEI_subpass_shading)+(VK_IMG_filter_cubic,VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSubpassShadingHUAWEI-None-02692",
|
|
"text": " If a <code>VkImageView</code> is sampled with <code>VK_FILTER_CUBIC_EXT</code> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_CUBIC_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_HUAWEI_subpass_shading)+(VK_IMG_filter_cubic,VK_EXT_filter_cubic)+!(VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSubpassShadingHUAWEI-None-02693",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> being sampled with <code>VK_FILTER_CUBIC_EXT</code> as a result of this command <strong class=\"purple\">must</strong> not have a <a href=\"#VkImageViewType\">VkImageViewType</a> of <code>VK_IMAGE_VIEW_TYPE_3D</code>, <code>VK_IMAGE_VIEW_TYPE_CUBE</code>, or <code>VK_IMAGE_VIEW_TYPE_CUBE_ARRAY</code>"
|
|
}
|
|
],
|
|
"(VK_HUAWEI_subpass_shading)+(VK_IMG_filter_cubic,VK_EXT_filter_cubic)+(VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSubpassShadingHUAWEI-filterCubic-02694",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> being sampled with <code>VK_FILTER_CUBIC_EXT</code> as a result of this command <strong class=\"purple\">must</strong> have a <a href=\"#VkImageViewType\">VkImageViewType</a> and format that supports cubic filtering, as specified by <code>VkFilterCubicImageViewImageFormatPropertiesEXT</code>::<code>filterCubic</code> returned by <code>vkGetPhysicalDeviceImageFormatProperties2</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSubpassShadingHUAWEI-filterCubicMinmax-02695",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> being sampled with <code>VK_FILTER_CUBIC_EXT</code> with a reduction mode of either <code>VK_SAMPLER_REDUCTION_MODE_MIN</code> or <code>VK_SAMPLER_REDUCTION_MODE_MAX</code> as a result of this command <strong class=\"purple\">must</strong> have a <a href=\"#VkImageViewType\">VkImageViewType</a> and format that supports cubic filtering together with minmax filtering, as specified by <code>VkFilterCubicImageViewImageFormatPropertiesEXT</code>::<code>filterCubicMinmax</code> returned by <code>vkGetPhysicalDeviceImageFormatProperties2</code>"
|
|
}
|
|
],
|
|
"(VK_HUAWEI_subpass_shading)+(VK_NV_corner_sampled_image)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSubpassShadingHUAWEI-flags-02696",
|
|
"text": " Any <a href=\"#VkImage\">VkImage</a> created with a <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a>::<code>flags</code> containing <code>VK_IMAGE_CREATE_CORNER_SAMPLED_BIT_NV</code> sampled as a result of this command <strong class=\"purple\">must</strong> only be sampled using a <a href=\"#VkSamplerAddressMode\">VkSamplerAddressMode</a> of <code>VK_SAMPLER_ADDRESS_MODE_CLAMP_TO_EDGE</code>"
|
|
}
|
|
],
|
|
"(VK_HUAWEI_subpass_shading)+!(VK_VERSION_1_3,VK_KHR_maintenance4)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSubpassShadingHUAWEI-None-02698",
|
|
"text": " For each push constant that is statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command, a push constant value <strong class=\"purple\">must</strong> have been set for the same pipeline bind point, with a <code>VkPipelineLayout</code> that is compatible for push constants, with the <code>VkPipelineLayout</code> used to create the current <code>VkPipeline</code>, as described in <a href=\"#descriptorsets-compatibility\">Pipeline Layout Compatibility</a>"
|
|
}
|
|
],
|
|
"(VK_HUAWEI_subpass_shading)+(VK_VERSION_1_3,VK_KHR_maintenance4)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSubpassShadingHUAWEI-maintenance4-06425",
|
|
"text": " If the <a href=\"#features-maintenance4\"><code>maintenance4</code></a> feature is not enabled, then for each push constant that is statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command, a push constant value <strong class=\"purple\">must</strong> have been set for the same pipeline bind point, with a <code>VkPipelineLayout</code> that is compatible for push constants, with the <code>VkPipelineLayout</code> used to create the current <code>VkPipeline</code>, as described in <a href=\"#descriptorsets-compatibility\">Pipeline Layout Compatibility</a>"
|
|
}
|
|
],
|
|
"(VK_HUAWEI_subpass_shading)+!(VK_EXT_pipeline_robustness)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSubpassShadingHUAWEI-None-02705",
|
|
"text": " If the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, and if the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a uniform buffer, it <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSubpassShadingHUAWEI-None-02706",
|
|
"text": " If the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, and if the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a storage buffer, it <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
}
|
|
],
|
|
"(VK_HUAWEI_subpass_shading)+(VK_EXT_pipeline_robustness)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSubpassShadingHUAWEI-uniformBuffers-06935",
|
|
"text": " If any stage of the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a uniform buffer, and that stage was created without enabling either <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_EXT</code> or <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXT</code> for <code>uniformBuffers</code>, and the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, that stage <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSubpassShadingHUAWEI-storageBuffers-06936",
|
|
"text": " If any stage of the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a storage buffer, and that stage was created without enabling either <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_EXT</code> or <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXT</code> for <code>storageBuffers</code>, and the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, that stage <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
}
|
|
],
|
|
"(VK_HUAWEI_subpass_shading)+(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSubpassShadingHUAWEI-commandBuffer-02707",
|
|
"text": " If <code>commandBuffer</code> is an unprotected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, any resource accessed by the <a href=\"#VkPipeline\">VkPipeline</a> object bound to the pipeline bind point used by this command <strong class=\"purple\">must</strong> not be a protected resource"
|
|
}
|
|
],
|
|
"(VK_HUAWEI_subpass_shading)+(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSubpassShadingHUAWEI-None-06550",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> or <code>VkImageView</code> object that enables <a href=\"#samplers-YCbCr-conversion\">sampler {YCbCr} conversion</a>, that object <strong class=\"purple\">must</strong> only be used with <code>OpImageSample*</code> or <code>OpImageSparseSample*</code> instructions"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSubpassShadingHUAWEI-ConstOffset-06551",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> or <code>VkImageView</code> object that enables <a href=\"#samplers-YCbCr-conversion\">sampler {YCbCr} conversion</a>, that object <strong class=\"purple\">must</strong> not use the <code>ConstOffset</code> and <code>Offset</code> operands"
|
|
}
|
|
],
|
|
"(VK_HUAWEI_subpass_shading)+(VK_EXT_shader_image_atomic_int64)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSubpassShadingHUAWEI-SampledType-04470",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a 64-bit component width is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 64"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSubpassShadingHUAWEI-SampledType-04471",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a component width less than 64-bit is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 32"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSubpassShadingHUAWEI-SampledType-04472",
|
|
"text": " If a <a href=\"#VkBufferView\">VkBufferView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a 64-bit component width is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 64"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSubpassShadingHUAWEI-SampledType-04473",
|
|
"text": " If a <a href=\"#VkBufferView\">VkBufferView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a component width less than 64-bit is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 32"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSubpassShadingHUAWEI-sparseImageInt64Atomics-04474",
|
|
"text": " If the <a href=\"#features-sparseImageInt64Atomics\"><code>sparseImageInt64Atomics</code></a> feature is not enabled, <a href=\"#VkImage\">VkImage</a> objects created with the <code>VK_IMAGE_CREATE_SPARSE_RESIDENCY_BIT</code> flag <strong class=\"purple\">must</strong> not be accessed by atomic instructions through an <code>OpTypeImage</code> with a <code>SampledType</code> with a <code>Width</code> of 64 by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSubpassShadingHUAWEI-sparseImageInt64Atomics-04475",
|
|
"text": " If the <a href=\"#features-sparseImageInt64Atomics\"><code>sparseImageInt64Atomics</code></a> feature is not enabled, <a href=\"#VkBuffer\">VkBuffer</a> objects created with the <code>VK_BUFFER_CREATE_SPARSE_RESIDENCY_BIT</code> flag <strong class=\"purple\">must</strong> not be accessed by atomic instructions through an <code>OpTypeImage</code> with a <code>SampledType</code> with a <code>Width</code> of 64 by this command"
|
|
}
|
|
],
|
|
"(VK_HUAWEI_subpass_shading)+(VK_QCOM_image_processing)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSubpassShadingHUAWEI-OpImageWeightedSampleQCOM-06971",
|
|
"text": " If <code>OpImageWeightedSampleQCOM</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_WEIGHT_SAMPLED_IMAGE_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSubpassShadingHUAWEI-OpImageWeightedSampleQCOM-06972",
|
|
"text": " If <code>OpImageWeightedSampleQCOM</code> uses a <a href=\"#VkImageView\">VkImageView</a> as a sample weight image as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_WEIGHT_IMAGE_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSubpassShadingHUAWEI-OpImageBoxFilterQCOM-06973",
|
|
"text": " If <code>OpImageBoxFilterQCOM</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_BOX_FILTER_SAMPLED_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSubpassShadingHUAWEI-OpImageBlockMatchSSDQCOM-06974",
|
|
"text": " If <code>OpImageBlockMatchSSDQCOM</code> is used to read from an <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSubpassShadingHUAWEI-OpImageBlockMatchSADQCOM-06975",
|
|
"text": " If <code>OpImageBlockMatchSADQCOM</code> is used to read from an <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSubpassShadingHUAWEI-OpImageBlockMatchSADQCOM-06976",
|
|
"text": " If <code>OpImageBlockMatchSADQCOM</code> or OpImageBlockMatchSSDQCOM is used to read from a reference image as result of this command, then the specified reference coordinates <strong class=\"purple\">must</strong> not fail <a href=\"#textures-integer-coordinate-validation\">integer texel coordinate validation</a>."
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSubpassShadingHUAWEI-OpImageWeightedSampleQCOM-06977",
|
|
"text": " If <code>OpImageWeightedSampleQCOM</code>, <code>OpImageBoxFilterQCOM</code>, <code>OpImageBlockMatchSSDQCOM</code>, or <code>OpImageBlockMatchSADQCOM</code> uses a <a href=\"#VkSampler\">VkSampler</a> as a result of this command, then the sampler <strong class=\"purple\">must</strong> have been created with <code>VK_SAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSubpassShadingHUAWEI-OpImageWeightedSampleQCOM-06978",
|
|
"text": " If any command other than <code>OpImageWeightedSampleQCOM</code>, <code>OpImageBoxFilterQCOM</code>, <code>OpImageBlockMatchSSDQCOM</code>, or <code>OpImageBlockMatchSADQCOM</code> uses a <a href=\"#VkSampler\">VkSampler</a> as a result of this command, then the sampler <strong class=\"purple\">must</strong> not have been created with <code>VK_SAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM</code>."
|
|
}
|
|
]
|
|
},
|
|
"vkCreateIndirectCommandsLayoutNV": {
|
|
"(VK_NV_device_generated_commands)": [
|
|
{
|
|
"vuid": "VUID-vkCreateIndirectCommandsLayoutNV-deviceGeneratedCommands-02929",
|
|
"text": " The <a href=\"#features-deviceGeneratedCommands\"><code>VkPhysicalDeviceDeviceGeneratedCommandsFeaturesNV</code>::<code>deviceGeneratedCommands</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateIndirectCommandsLayoutNV-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateIndirectCommandsLayoutNV-pCreateInfo-parameter",
|
|
"text": " <code>pCreateInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkIndirectCommandsLayoutCreateInfoNV\">VkIndirectCommandsLayoutCreateInfoNV</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateIndirectCommandsLayoutNV-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateIndirectCommandsLayoutNV-pIndirectCommandsLayout-parameter",
|
|
"text": " <code>pIndirectCommandsLayout</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkIndirectCommandsLayoutNV\">VkIndirectCommandsLayoutNV</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkIndirectCommandsLayoutCreateInfoNV": {
|
|
"(VK_NV_device_generated_commands)": [
|
|
{
|
|
"vuid": "VUID-VkIndirectCommandsLayoutCreateInfoNV-pipelineBindPoint-02930",
|
|
"text": " The <code>pipelineBindPoint</code> <strong class=\"purple\">must</strong> be <code>VK_PIPELINE_BIND_POINT_GRAPHICS</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkIndirectCommandsLayoutCreateInfoNV-tokenCount-02931",
|
|
"text": " <code>tokenCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code> and less than or equal to <code>VkPhysicalDeviceDeviceGeneratedCommandsPropertiesNV</code>::<code>maxIndirectCommandsTokenCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkIndirectCommandsLayoutCreateInfoNV-pTokens-02932",
|
|
"text": " If <code>pTokens</code> contains an entry of <code>VK_INDIRECT_COMMANDS_TOKEN_TYPE_SHADER_GROUP_NV</code> it <strong class=\"purple\">must</strong> be the first element of the array and there <strong class=\"purple\">must</strong> be only a single element of such token type"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkIndirectCommandsLayoutCreateInfoNV-pTokens-02933",
|
|
"text": " If <code>pTokens</code> contains an entry of <code>VK_INDIRECT_COMMANDS_TOKEN_TYPE_STATE_FLAGS_NV</code> there <strong class=\"purple\">must</strong> be only a single element of such token type"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkIndirectCommandsLayoutCreateInfoNV-pTokens-02934",
|
|
"text": " All state tokens in <code>pTokens</code> <strong class=\"purple\">must</strong> occur prior work provoking tokens (<code>VK_INDIRECT_COMMANDS_TOKEN_TYPE_DRAW_NV</code>, <code>VK_INDIRECT_COMMANDS_TOKEN_TYPE_DRAW_INDEXED_NV</code>, <code>VK_INDIRECT_COMMANDS_TOKEN_TYPE_DRAW_TASKS_NV</code>)"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkIndirectCommandsLayoutCreateInfoNV-pTokens-02935",
|
|
"text": " The content of <code>pTokens</code> <strong class=\"purple\">must</strong> include one single work provoking token that is compatible with the <code>pipelineBindPoint</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkIndirectCommandsLayoutCreateInfoNV-streamCount-02936",
|
|
"text": " <code>streamCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code> and less or equal to <code>VkPhysicalDeviceDeviceGeneratedCommandsPropertiesNV</code>::<code>maxIndirectCommandsStreamCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkIndirectCommandsLayoutCreateInfoNV-pStreamStrides-02937",
|
|
"text": " each element of <code>pStreamStrides</code> <strong class=\"purple\">must</strong> be greater than `0`and less than or equal to <code>VkPhysicalDeviceDeviceGeneratedCommandsPropertiesNV</code>::<code>maxIndirectCommandsStreamStride</code>. Furthermore the alignment of each token input <strong class=\"purple\">must</strong> be ensured"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkIndirectCommandsLayoutCreateInfoNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_INDIRECT_COMMANDS_LAYOUT_CREATE_INFO_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkIndirectCommandsLayoutCreateInfoNV-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkIndirectCommandsLayoutCreateInfoNV-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkIndirectCommandsLayoutUsageFlagBitsNV\">VkIndirectCommandsLayoutUsageFlagBitsNV</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkIndirectCommandsLayoutCreateInfoNV-pipelineBindPoint-parameter",
|
|
"text": " <code>pipelineBindPoint</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPipelineBindPoint\">VkPipelineBindPoint</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkIndirectCommandsLayoutCreateInfoNV-pTokens-parameter",
|
|
"text": " <code>pTokens</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>tokenCount</code> valid <a href=\"#VkIndirectCommandsLayoutTokenNV\">VkIndirectCommandsLayoutTokenNV</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkIndirectCommandsLayoutCreateInfoNV-pStreamStrides-parameter",
|
|
"text": " <code>pStreamStrides</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>streamCount</code> <code>uint32_t</code> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkIndirectCommandsLayoutCreateInfoNV-tokenCount-arraylength",
|
|
"text": " <code>tokenCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkIndirectCommandsLayoutCreateInfoNV-streamCount-arraylength",
|
|
"text": " <code>streamCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkDestroyIndirectCommandsLayoutNV": {
|
|
"(VK_NV_device_generated_commands)": [
|
|
{
|
|
"vuid": "VUID-vkDestroyIndirectCommandsLayoutNV-indirectCommandsLayout-02938",
|
|
"text": " All submitted commands that refer to <code>indirectCommandsLayout</code> <strong class=\"purple\">must</strong> have completed execution"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyIndirectCommandsLayoutNV-indirectCommandsLayout-02939",
|
|
"text": " If <code>VkAllocationCallbacks</code> were provided when <code>indirectCommandsLayout</code> was created, a compatible set of callbacks <strong class=\"purple\">must</strong> be provided here"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyIndirectCommandsLayoutNV-indirectCommandsLayout-02940",
|
|
"text": " If no <code>VkAllocationCallbacks</code> were provided when <code>indirectCommandsLayout</code> was created, <code>pAllocator</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyIndirectCommandsLayoutNV-deviceGeneratedCommands-02941",
|
|
"text": " The <a href=\"#features-deviceGeneratedCommands\"><code>VkPhysicalDeviceDeviceGeneratedCommandsFeaturesNV</code>::<code>deviceGeneratedCommands</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyIndirectCommandsLayoutNV-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyIndirectCommandsLayoutNV-indirectCommandsLayout-parameter",
|
|
"text": " If <code>indirectCommandsLayout</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>indirectCommandsLayout</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkIndirectCommandsLayoutNV\">VkIndirectCommandsLayoutNV</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyIndirectCommandsLayoutNV-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyIndirectCommandsLayoutNV-indirectCommandsLayout-parent",
|
|
"text": " If <code>indirectCommandsLayout</code> is a valid handle, it <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkIndirectCommandsStreamNV": {
|
|
"(VK_NV_device_generated_commands)": [
|
|
{
|
|
"vuid": "VUID-VkIndirectCommandsStreamNV-buffer-02942",
|
|
"text": " The <code>buffer</code>’s usage flag <strong class=\"purple\">must</strong> have the <code>VK_BUFFER_USAGE_INDIRECT_BUFFER_BIT</code> bit set"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkIndirectCommandsStreamNV-offset-02943",
|
|
"text": " The <code>offset</code> <strong class=\"purple\">must</strong> be aligned to <code>VkPhysicalDeviceDeviceGeneratedCommandsPropertiesNV</code>::<code>minIndirectCommandsBufferOffsetAlignment</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkIndirectCommandsStreamNV-buffer-02975",
|
|
"text": " If <code>buffer</code> is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkIndirectCommandsStreamNV-buffer-parameter",
|
|
"text": " <code>buffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBuffer\">VkBuffer</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkBindShaderGroupIndirectCommandNV": {
|
|
"(VK_NV_device_generated_commands)": [
|
|
{
|
|
"vuid": "VUID-VkBindShaderGroupIndirectCommandNV-None-02944",
|
|
"text": " The current bound graphics pipeline, as well as the pipelines it may reference, <strong class=\"purple\">must</strong> have been created with <code>VK_PIPELINE_CREATE_INDIRECT_BINDABLE_BIT_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindShaderGroupIndirectCommandNV-index-02945",
|
|
"text": " The <code>index</code> <strong class=\"purple\">must</strong> be within range of the accessible shader groups of the current bound graphics pipeline. See <a href=\"#vkCmdBindPipelineShaderGroupNV\">vkCmdBindPipelineShaderGroupNV</a> for further details"
|
|
}
|
|
]
|
|
},
|
|
"VkBindIndexBufferIndirectCommandNV": {
|
|
"(VK_NV_device_generated_commands)": [
|
|
{
|
|
"vuid": "VUID-VkBindIndexBufferIndirectCommandNV-None-02946",
|
|
"text": " The buffer’s usage flag from which the address was acquired <strong class=\"purple\">must</strong> have the <code>VK_BUFFER_USAGE_INDEX_BUFFER_BIT</code> bit set"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindIndexBufferIndirectCommandNV-bufferAddress-02947",
|
|
"text": " The <code>bufferAddress</code> <strong class=\"purple\">must</strong> be aligned to the <code>indexType</code> used"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindIndexBufferIndirectCommandNV-None-02948",
|
|
"text": " Each element of the buffer from which the address was acquired and that is non-sparse <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindIndexBufferIndirectCommandNV-indexType-parameter",
|
|
"text": " <code>indexType</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkIndexType\">VkIndexType</a> value"
|
|
}
|
|
]
|
|
},
|
|
"VkBindVertexBufferIndirectCommandNV": {
|
|
"(VK_NV_device_generated_commands)": [
|
|
{
|
|
"vuid": "VUID-VkBindVertexBufferIndirectCommandNV-None-02949",
|
|
"text": " The buffer’s usage flag from which the address was acquired <strong class=\"purple\">must</strong> have the <code>VK_BUFFER_USAGE_VERTEX_BUFFER_BIT</code> bit set"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindVertexBufferIndirectCommandNV-None-02950",
|
|
"text": " Each element of the buffer from which the address was acquired and that is non-sparse <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
}
|
|
]
|
|
},
|
|
"VkIndirectCommandsLayoutTokenNV": {
|
|
"(VK_NV_device_generated_commands)": [
|
|
{
|
|
"vuid": "VUID-VkIndirectCommandsLayoutTokenNV-stream-02951",
|
|
"text": " <code>stream</code> <strong class=\"purple\">must</strong> be smaller than <code>VkIndirectCommandsLayoutCreateInfoNV</code>::<code>streamCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkIndirectCommandsLayoutTokenNV-offset-02952",
|
|
"text": " <code>offset</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceDeviceGeneratedCommandsPropertiesNV</code>::<code>maxIndirectCommandsTokenOffset</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkIndirectCommandsLayoutTokenNV-offset-06888",
|
|
"text": " <code>offset</code> <strong class=\"purple\">must</strong> be aligned to the scalar alignment of <code>tokenType</code> or <code>minIndirectCommandsBufferOffsetAlignment</code>, whichever is lower"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkIndirectCommandsLayoutTokenNV-tokenType-02976",
|
|
"text": " If <code>tokenType</code> is <code>VK_INDIRECT_COMMANDS_TOKEN_TYPE_VERTEX_BUFFER_NV</code>, <code>vertexBindingUnit</code> <strong class=\"purple\">must</strong> stay within device supported limits for the appropriate commands"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkIndirectCommandsLayoutTokenNV-tokenType-02977",
|
|
"text": " If <code>tokenType</code> is <code>VK_INDIRECT_COMMANDS_TOKEN_TYPE_PUSH_CONSTANT_NV</code>, <code>pushconstantPipelineLayout</code> <strong class=\"purple\">must</strong> be valid"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkIndirectCommandsLayoutTokenNV-tokenType-02978",
|
|
"text": " If <code>tokenType</code> is <code>VK_INDIRECT_COMMANDS_TOKEN_TYPE_PUSH_CONSTANT_NV</code>, <code>pushconstantOffset</code> <strong class=\"purple\">must</strong> be a multiple of <code>4</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkIndirectCommandsLayoutTokenNV-tokenType-02979",
|
|
"text": " If <code>tokenType</code> is <code>VK_INDIRECT_COMMANDS_TOKEN_TYPE_PUSH_CONSTANT_NV</code>, <code>pushconstantSize</code> <strong class=\"purple\">must</strong> be a multiple of <code>4</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkIndirectCommandsLayoutTokenNV-tokenType-02980",
|
|
"text": " If <code>tokenType</code> is <code>VK_INDIRECT_COMMANDS_TOKEN_TYPE_PUSH_CONSTANT_NV</code>, <code>pushconstantOffset</code> <strong class=\"purple\">must</strong> be less than <code>VkPhysicalDeviceLimits</code>::<code>maxPushConstantsSize</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkIndirectCommandsLayoutTokenNV-tokenType-02981",
|
|
"text": " If <code>tokenType</code> is <code>VK_INDIRECT_COMMANDS_TOKEN_TYPE_PUSH_CONSTANT_NV</code>, <code>pushconstantSize</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxPushConstantsSize</code> minus <code>pushconstantOffset</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkIndirectCommandsLayoutTokenNV-tokenType-02982",
|
|
"text": " If <code>tokenType</code> is <code>VK_INDIRECT_COMMANDS_TOKEN_TYPE_PUSH_CONSTANT_NV</code>, for each byte in the range specified by <code>pushconstantOffset</code> and <code>pushconstantSize</code> and for each shader stage in <code>pushconstantShaderStageFlags</code>, there <strong class=\"purple\">must</strong> be a push constant range in <code>pushconstantPipelineLayout</code> that includes that byte and that stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkIndirectCommandsLayoutTokenNV-tokenType-02983",
|
|
"text": " If <code>tokenType</code> is <code>VK_INDIRECT_COMMANDS_TOKEN_TYPE_PUSH_CONSTANT_NV</code>, for each byte in the range specified by <code>pushconstantOffset</code> and <code>pushconstantSize</code> and for each push constant range that overlaps that byte, <code>pushconstantShaderStageFlags</code> <strong class=\"purple\">must</strong> include all stages in that push constant range’s <a href=\"#VkPushConstantRange\">VkPushConstantRange</a>::<code>stageFlags</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkIndirectCommandsLayoutTokenNV-tokenType-02984",
|
|
"text": " If <code>tokenType</code> is <code>VK_INDIRECT_COMMANDS_TOKEN_TYPE_STATE_FLAGS_NV</code>, <code>indirectStateFlags</code> <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkIndirectCommandsLayoutTokenNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_INDIRECT_COMMANDS_LAYOUT_TOKEN_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkIndirectCommandsLayoutTokenNV-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkIndirectCommandsLayoutTokenNV-tokenType-parameter",
|
|
"text": " <code>tokenType</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkIndirectCommandsTokenTypeNV\">VkIndirectCommandsTokenTypeNV</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkIndirectCommandsLayoutTokenNV-pushconstantPipelineLayout-parameter",
|
|
"text": " If <code>pushconstantPipelineLayout</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>pushconstantPipelineLayout</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPipelineLayout\">VkPipelineLayout</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkIndirectCommandsLayoutTokenNV-pushconstantShaderStageFlags-parameter",
|
|
"text": " <code>pushconstantShaderStageFlags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkShaderStageFlagBits\">VkShaderStageFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkIndirectCommandsLayoutTokenNV-indirectStateFlags-parameter",
|
|
"text": " <code>indirectStateFlags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkIndirectStateFlagBitsNV\">VkIndirectStateFlagBitsNV</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkIndirectCommandsLayoutTokenNV-pIndexTypes-parameter",
|
|
"text": " If <code>indexTypeCount</code> is not <code>0</code>, <code>pIndexTypes</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>indexTypeCount</code> valid <a href=\"#VkIndexType\">VkIndexType</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkIndirectCommandsLayoutTokenNV-pIndexTypeValues-parameter",
|
|
"text": " If <code>indexTypeCount</code> is not <code>0</code>, <code>pIndexTypeValues</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>indexTypeCount</code> <code>uint32_t</code> values"
|
|
}
|
|
]
|
|
},
|
|
"vkGetGeneratedCommandsMemoryRequirementsNV": {
|
|
"(VK_NV_device_generated_commands)": [
|
|
{
|
|
"vuid": "VUID-vkGetGeneratedCommandsMemoryRequirementsNV-deviceGeneratedCommands-02906",
|
|
"text": " The <a href=\"#features-deviceGeneratedCommands\"><code>VkPhysicalDeviceDeviceGeneratedCommandsFeaturesNV</code>::<code>deviceGeneratedCommands</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetGeneratedCommandsMemoryRequirementsNV-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetGeneratedCommandsMemoryRequirementsNV-pInfo-parameter",
|
|
"text": " <code>pInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkGeneratedCommandsMemoryRequirementsInfoNV\">VkGeneratedCommandsMemoryRequirementsInfoNV</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetGeneratedCommandsMemoryRequirementsNV-pMemoryRequirements-parameter",
|
|
"text": " <code>pMemoryRequirements</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkMemoryRequirements2\">VkMemoryRequirements2</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkGeneratedCommandsMemoryRequirementsInfoNV": {
|
|
"(VK_NV_device_generated_commands)": [
|
|
{
|
|
"vuid": "VUID-VkGeneratedCommandsMemoryRequirementsInfoNV-maxSequencesCount-02907",
|
|
"text": " <code>maxSequencesCount</code> <strong class=\"purple\">must</strong> be less or equal to <a href=\"#VkPhysicalDeviceDeviceGeneratedCommandsPropertiesNV\">VkPhysicalDeviceDeviceGeneratedCommandsPropertiesNV</a>::<code>maxIndirectSequenceCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGeneratedCommandsMemoryRequirementsInfoNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_GENERATED_COMMANDS_MEMORY_REQUIREMENTS_INFO_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGeneratedCommandsMemoryRequirementsInfoNV-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGeneratedCommandsMemoryRequirementsInfoNV-pipelineBindPoint-parameter",
|
|
"text": " <code>pipelineBindPoint</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPipelineBindPoint\">VkPipelineBindPoint</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGeneratedCommandsMemoryRequirementsInfoNV-pipeline-parameter",
|
|
"text": " <code>pipeline</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPipeline\">VkPipeline</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGeneratedCommandsMemoryRequirementsInfoNV-indirectCommandsLayout-parameter",
|
|
"text": " <code>indirectCommandsLayout</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkIndirectCommandsLayoutNV\">VkIndirectCommandsLayoutNV</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGeneratedCommandsMemoryRequirementsInfoNV-commonparent",
|
|
"text": " Both of <code>indirectCommandsLayout</code>, and <code>pipeline</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdExecuteGeneratedCommandsNV": {
|
|
"(VK_NV_device_generated_commands)": [
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-magFilter-04553",
|
|
"text": " If a <a href=\"#VkSampler\">VkSampler</a> created with <code>magFilter</code> or <code>minFilter</code> equal to <code>VK_FILTER_LINEAR</code> and <code>compareEnable</code> equal to <code>VK_FALSE</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-mipmapMode-04770",
|
|
"text": " If a <a href=\"#VkSampler\">VkSampler</a> created with <code>mipmapMode</code> equal to <code>VK_SAMPLER_MIPMAP_MODE_LINEAR</code> and <code>compareEnable</code> equal to <code>VK_FALSE</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-None-02691",
|
|
"text": " If a <code>VkImageView</code> is accessed using atomic operations as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_STORAGE_IMAGE_ATOMIC_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-None-02697",
|
|
"text": " For each set <em>n</em> that is statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command, a descriptor set <strong class=\"purple\">must</strong> have been bound to <em>n</em> at the same pipeline bind point, with a <code>VkPipelineLayout</code> that is compatible for set <em>n</em>, with the <code>VkPipelineLayout</code> used to create the current <code>VkPipeline</code>, as described in <a href=\"#descriptorsets-compatibility\">Pipeline Layout Compatibility</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-None-02699",
|
|
"text": " Descriptors in each bound descriptor set, specified via <code>vkCmdBindDescriptorSets</code>, <strong class=\"purple\">must</strong> be valid if they are statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-None-02700",
|
|
"text": " A valid pipeline <strong class=\"purple\">must</strong> be bound to the pipeline bind point used by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-commandBuffer-02701",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command requires any dynamic state, that state <strong class=\"purple\">must</strong> have been set or inherited (if the <code><a href=\"#VK_NV_inherited_viewport_scissor\">VK_NV_inherited_viewport_scissor</a></code> extension is enabled) for <code>commandBuffer</code>, and done so after any previously bound pipeline with the corresponding state not specified as dynamic"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-None-02859",
|
|
"text": " There <strong class=\"purple\">must</strong> not have been any calls to dynamic state setting commands for any state not specified as dynamic in the <code>VkPipeline</code> object bound to the pipeline bind point used by this command, since that pipeline was bound"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-None-02702",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> object that uses unnormalized coordinates, that sampler <strong class=\"purple\">must</strong> not be used to sample from any <code>VkImage</code> with a <code>VkImageView</code> of the type <code>VK_IMAGE_VIEW_TYPE_3D</code>, <code>VK_IMAGE_VIEW_TYPE_CUBE</code>, <code>VK_IMAGE_VIEW_TYPE_1D_ARRAY</code>, <code>VK_IMAGE_VIEW_TYPE_2D_ARRAY</code> or <code>VK_IMAGE_VIEW_TYPE_CUBE_ARRAY</code>, in any shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-None-02703",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> object that uses unnormalized coordinates, that sampler <strong class=\"purple\">must</strong> not be used with any of the SPIR-V <code>OpImageSample*</code> or <code>OpImageSparseSample*</code> instructions with <code>ImplicitLod</code>, <code>Dref</code> or <code>Proj</code> in their name, in any shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-None-02704",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> object that uses unnormalized coordinates, that sampler <strong class=\"purple\">must</strong> not be used with any of the SPIR-V <code>OpImageSample*</code> or <code>OpImageSparseSample*</code> instructions that includes a LOD bias or any offset values, in any shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-None-04115",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> is accessed using <code>OpImageWrite</code> as a result of this command, then the <code>Type</code> of the <code>Texel</code> operand of that instruction <strong class=\"purple\">must</strong> have at least as many components as the image view’s format"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-OpImageWrite-04469",
|
|
"text": " If a <a href=\"#VkBufferView\">VkBufferView</a> is accessed using <code>OpImageWrite</code> as a result of this command, then the <code>Type</code> of the <code>Texel</code> operand of that instruction <strong class=\"purple\">must</strong> have at least as many components as the buffer view’s format"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-renderPass-02684",
|
|
"text": " The current render pass <strong class=\"purple\">must</strong> be <a href=\"#renderpass-compatibility\">compatible</a> with the <code>renderPass</code> member of the <code>VkGraphicsPipelineCreateInfo</code> structure specified when creating the <code>VkPipeline</code> bound to <code>VK_PIPELINE_BIND_POINT_GRAPHICS</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-subpass-02685",
|
|
"text": " The subpass index of the current render pass <strong class=\"purple\">must</strong> be equal to the <code>subpass</code> member of the <code>VkGraphicsPipelineCreateInfo</code> structure specified when creating the <code>VkPipeline</code> bound to <code>VK_PIPELINE_BIND_POINT_GRAPHICS</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-None-02686",
|
|
"text": " Every input attachment used by the current subpass <strong class=\"purple\">must</strong> be bound to the pipeline via a descriptor set"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-None-06537",
|
|
"text": " Memory backing image subresources used as attachments in the current render pass <strong class=\"purple\">must</strong> not be written in any way other than as an attachment by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-None-06538",
|
|
"text": " If any recorded command in the current subpass will write to an image subresource as an attachment, this command <strong class=\"purple\">must</strong> not read from the memory backing that image subresource in any other way than as an attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-None-06539",
|
|
"text": " If any recorded command in the current subpass will read from an image subresource used as an attachment in any way other than as an attachment, this command <strong class=\"purple\">must</strong> not write to that image subresource as an attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-None-06886",
|
|
"text": " If the current render pass instance uses a depth/stencil attachment with a read-only layout for the depth aspect, <a href=\"#fragops-depth-write\">depth writes</a> <strong class=\"purple\">must</strong> be disabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-None-06887",
|
|
"text": " If the current render pass instance uses a depth/stencil attachment with a read-only layout for the stencil aspect and stencil test is enabled, <a href=\"#fragops-stencil\">all stencil ops</a> <strong class=\"purple\">must</strong> be <code>VK_STENCIL_OP_KEEP</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-blendEnable-04727",
|
|
"text": " If rasterization is not disabled in the bound graphics pipeline, then for each color attachment in the subpass, if the corresponding image view’s <a href=\"#resources-image-view-format-features\">format features</a> do not contain <code>VK_FORMAT_FEATURE_COLOR_ATTACHMENT_BLEND_BIT</code>, then the <code>blendEnable</code> member of the corresponding element of the <code>pAttachments</code> member of <code>pColorBlendState</code> <strong class=\"purple\">must</strong> be <code>VK_FALSE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-rasterizationSamples-04740",
|
|
"text": " If rasterization is not disabled in the bound graphics pipeline, and neither the <code><a href=\"#VK_AMD_mixed_attachment_samples\">VK_AMD_mixed_attachment_samples</a></code> nor the <code><a href=\"#VK_NV_framebuffer_mixed_samples\">VK_NV_framebuffer_mixed_samples</a></code> extensions are enabled, then <a href=\"#VkPipelineMultisampleStateCreateInfo\">VkPipelineMultisampleStateCreateInfo</a>::<code>rasterizationSamples</code> <strong class=\"purple\">must</strong> be the same as the current subpass color and/or depth/stencil attachments"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-None-04007",
|
|
"text": " All vertex input bindings accessed via vertex input variables declared in the vertex shader entry point’s interface <strong class=\"purple\">must</strong> have either valid or <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> buffers bound"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-None-04008",
|
|
"text": " If the <a href=\"#features-nullDescriptor\"><code>nullDescriptor</code></a> feature is not enabled, all vertex input bindings accessed via vertex input variables declared in the vertex shader entry point’s interface <strong class=\"purple\">must</strong> not be <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-None-02721",
|
|
"text": " For a given vertex buffer binding, any attribute data fetched <strong class=\"purple\">must</strong> be entirely contained within the corresponding vertex buffer binding, as described in <a href=\"#fxvertex-input\">Vertex Input Description</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-isPreprocessed-02908",
|
|
"text": " If <code>isPreprocessed</code> is <code>VK_TRUE</code> then <a href=\"#vkCmdPreprocessGeneratedCommandsNV\">vkCmdPreprocessGeneratedCommandsNV</a> <strong class=\"purple\">must</strong> have already been executed on the device, using the same <code>pGeneratedCommandsInfo</code> content as well as the content of the input buffers it references (all except <a href=\"#VkGeneratedCommandsInfoNV\">VkGeneratedCommandsInfoNV</a>::<code>preprocessBuffer</code>). Furthermore <code>pGeneratedCommandsInfo</code>`s <code>indirectCommandsLayout</code> <strong class=\"purple\">must</strong> have been created with the <code>VK_INDIRECT_COMMANDS_LAYOUT_USAGE_EXPLICIT_PREPROCESS_BIT_NV</code> bit set"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-pipeline-02909",
|
|
"text": " <code>VkGeneratedCommandsInfoNV</code>::<code>pipeline</code> <strong class=\"purple\">must</strong> match the current bound pipeline at <code>VkGeneratedCommandsInfoNV</code>::<code>pipelineBindPoint</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-deviceGeneratedCommands-02911",
|
|
"text": " The <a href=\"#features-deviceGeneratedCommands\"><code>VkPhysicalDeviceDeviceGeneratedCommandsFeaturesNV</code>::<code>deviceGeneratedCommands</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-pGeneratedCommandsInfo-parameter",
|
|
"text": " <code>pGeneratedCommandsInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkGeneratedCommandsInfoNV\">VkGeneratedCommandsInfoNV</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics, or compute operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called inside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
],
|
|
"(VK_NV_device_generated_commands)+!(VK_VERSION_1_3,VK_KHR_format_feature_flags2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-aspectMask-06478",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> is sampled with <a href=\"#textures-depth-compare-operation\">depth comparison</a>, the image view <strong class=\"purple\">must</strong> have been created with an <code>aspectMask</code> that contains <code>VK_IMAGE_ASPECT_DEPTH_BIT</code>."
|
|
}
|
|
],
|
|
"(VK_NV_device_generated_commands)+(VK_VERSION_1_3,VK_KHR_format_feature_flags2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-None-06479",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> is sampled with <a href=\"#textures-depth-compare-operation\">depth comparison</a>, the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_SAMPLED_IMAGE_DEPTH_COMPARISON_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-OpTypeImage-06423",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> or <a href=\"#VkBufferView\">VkBufferView</a> being written as a storage image or storage texel buffer where the image format field of the <code>OpTypeImage</code> is <code>Unknown</code> then the view’s format feature <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_STORAGE_WRITE_WITHOUT_FORMAT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-OpTypeImage-06424",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> or <a href=\"#VkBufferView\">VkBufferView</a> being read as a storage image or storage texel buffer where the image format field of the <code>OpTypeImage</code> is <code>Unknown</code> then the view’s format feature <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_STORAGE_READ_WITHOUT_FORMAT_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_NV_device_generated_commands)+(VK_IMG_filter_cubic,VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-None-02692",
|
|
"text": " If a <code>VkImageView</code> is sampled with <code>VK_FILTER_CUBIC_EXT</code> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_CUBIC_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_NV_device_generated_commands)+(VK_IMG_filter_cubic,VK_EXT_filter_cubic)+!(VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-None-02693",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> being sampled with <code>VK_FILTER_CUBIC_EXT</code> as a result of this command <strong class=\"purple\">must</strong> not have a <a href=\"#VkImageViewType\">VkImageViewType</a> of <code>VK_IMAGE_VIEW_TYPE_3D</code>, <code>VK_IMAGE_VIEW_TYPE_CUBE</code>, or <code>VK_IMAGE_VIEW_TYPE_CUBE_ARRAY</code>"
|
|
}
|
|
],
|
|
"(VK_NV_device_generated_commands)+(VK_IMG_filter_cubic,VK_EXT_filter_cubic)+(VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-filterCubic-02694",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> being sampled with <code>VK_FILTER_CUBIC_EXT</code> as a result of this command <strong class=\"purple\">must</strong> have a <a href=\"#VkImageViewType\">VkImageViewType</a> and format that supports cubic filtering, as specified by <code>VkFilterCubicImageViewImageFormatPropertiesEXT</code>::<code>filterCubic</code> returned by <code>vkGetPhysicalDeviceImageFormatProperties2</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-filterCubicMinmax-02695",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> being sampled with <code>VK_FILTER_CUBIC_EXT</code> with a reduction mode of either <code>VK_SAMPLER_REDUCTION_MODE_MIN</code> or <code>VK_SAMPLER_REDUCTION_MODE_MAX</code> as a result of this command <strong class=\"purple\">must</strong> have a <a href=\"#VkImageViewType\">VkImageViewType</a> and format that supports cubic filtering together with minmax filtering, as specified by <code>VkFilterCubicImageViewImageFormatPropertiesEXT</code>::<code>filterCubicMinmax</code> returned by <code>vkGetPhysicalDeviceImageFormatProperties2</code>"
|
|
}
|
|
],
|
|
"(VK_NV_device_generated_commands)+(VK_NV_corner_sampled_image)": [
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-flags-02696",
|
|
"text": " Any <a href=\"#VkImage\">VkImage</a> created with a <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a>::<code>flags</code> containing <code>VK_IMAGE_CREATE_CORNER_SAMPLED_BIT_NV</code> sampled as a result of this command <strong class=\"purple\">must</strong> only be sampled using a <a href=\"#VkSamplerAddressMode\">VkSamplerAddressMode</a> of <code>VK_SAMPLER_ADDRESS_MODE_CLAMP_TO_EDGE</code>"
|
|
}
|
|
],
|
|
"(VK_NV_device_generated_commands)+!(VK_VERSION_1_3,VK_KHR_maintenance4)": [
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-None-02698",
|
|
"text": " For each push constant that is statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command, a push constant value <strong class=\"purple\">must</strong> have been set for the same pipeline bind point, with a <code>VkPipelineLayout</code> that is compatible for push constants, with the <code>VkPipelineLayout</code> used to create the current <code>VkPipeline</code>, as described in <a href=\"#descriptorsets-compatibility\">Pipeline Layout Compatibility</a>"
|
|
}
|
|
],
|
|
"(VK_NV_device_generated_commands)+(VK_VERSION_1_3,VK_KHR_maintenance4)": [
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-maintenance4-06425",
|
|
"text": " If the <a href=\"#features-maintenance4\"><code>maintenance4</code></a> feature is not enabled, then for each push constant that is statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command, a push constant value <strong class=\"purple\">must</strong> have been set for the same pipeline bind point, with a <code>VkPipelineLayout</code> that is compatible for push constants, with the <code>VkPipelineLayout</code> used to create the current <code>VkPipeline</code>, as described in <a href=\"#descriptorsets-compatibility\">Pipeline Layout Compatibility</a>"
|
|
}
|
|
],
|
|
"(VK_NV_device_generated_commands)+!(VK_EXT_pipeline_robustness)": [
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-None-02705",
|
|
"text": " If the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, and if the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a uniform buffer, it <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-None-02706",
|
|
"text": " If the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, and if the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a storage buffer, it <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
}
|
|
],
|
|
"(VK_NV_device_generated_commands)+(VK_EXT_pipeline_robustness)": [
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-uniformBuffers-06935",
|
|
"text": " If any stage of the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a uniform buffer, and that stage was created without enabling either <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_EXT</code> or <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXT</code> for <code>uniformBuffers</code>, and the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, that stage <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-storageBuffers-06936",
|
|
"text": " If any stage of the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a storage buffer, and that stage was created without enabling either <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_EXT</code> or <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXT</code> for <code>storageBuffers</code>, and the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, that stage <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
}
|
|
],
|
|
"(VK_NV_device_generated_commands)+(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-commandBuffer-02707",
|
|
"text": " If <code>commandBuffer</code> is an unprotected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, any resource accessed by the <a href=\"#VkPipeline\">VkPipeline</a> object bound to the pipeline bind point used by this command <strong class=\"purple\">must</strong> not be a protected resource"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-commandBuffer-02970",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> not be a protected command buffer"
|
|
}
|
|
],
|
|
"(VK_NV_device_generated_commands)+(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-None-06550",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> or <code>VkImageView</code> object that enables <a href=\"#samplers-YCbCr-conversion\">sampler {YCbCr} conversion</a>, that object <strong class=\"purple\">must</strong> only be used with <code>OpImageSample*</code> or <code>OpImageSparseSample*</code> instructions"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-ConstOffset-06551",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> or <code>VkImageView</code> object that enables <a href=\"#samplers-YCbCr-conversion\">sampler {YCbCr} conversion</a>, that object <strong class=\"purple\">must</strong> not use the <code>ConstOffset</code> and <code>Offset</code> operands"
|
|
}
|
|
],
|
|
"(VK_NV_device_generated_commands)+(VK_EXT_shader_image_atomic_int64)": [
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-SampledType-04470",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a 64-bit component width is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 64"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-SampledType-04471",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a component width less than 64-bit is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 32"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-SampledType-04472",
|
|
"text": " If a <a href=\"#VkBufferView\">VkBufferView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a 64-bit component width is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 64"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-SampledType-04473",
|
|
"text": " If a <a href=\"#VkBufferView\">VkBufferView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a component width less than 64-bit is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 32"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-sparseImageInt64Atomics-04474",
|
|
"text": " If the <a href=\"#features-sparseImageInt64Atomics\"><code>sparseImageInt64Atomics</code></a> feature is not enabled, <a href=\"#VkImage\">VkImage</a> objects created with the <code>VK_IMAGE_CREATE_SPARSE_RESIDENCY_BIT</code> flag <strong class=\"purple\">must</strong> not be accessed by atomic instructions through an <code>OpTypeImage</code> with a <code>SampledType</code> with a <code>Width</code> of 64 by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-sparseImageInt64Atomics-04475",
|
|
"text": " If the <a href=\"#features-sparseImageInt64Atomics\"><code>sparseImageInt64Atomics</code></a> feature is not enabled, <a href=\"#VkBuffer\">VkBuffer</a> objects created with the <code>VK_BUFFER_CREATE_SPARSE_RESIDENCY_BIT</code> flag <strong class=\"purple\">must</strong> not be accessed by atomic instructions through an <code>OpTypeImage</code> with a <code>SampledType</code> with a <code>Width</code> of 64 by this command"
|
|
}
|
|
],
|
|
"(VK_NV_device_generated_commands)+(VK_QCOM_image_processing)": [
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-OpImageWeightedSampleQCOM-06971",
|
|
"text": " If <code>OpImageWeightedSampleQCOM</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_WEIGHT_SAMPLED_IMAGE_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-OpImageWeightedSampleQCOM-06972",
|
|
"text": " If <code>OpImageWeightedSampleQCOM</code> uses a <a href=\"#VkImageView\">VkImageView</a> as a sample weight image as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_WEIGHT_IMAGE_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-OpImageBoxFilterQCOM-06973",
|
|
"text": " If <code>OpImageBoxFilterQCOM</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_BOX_FILTER_SAMPLED_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-OpImageBlockMatchSSDQCOM-06974",
|
|
"text": " If <code>OpImageBlockMatchSSDQCOM</code> is used to read from an <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-OpImageBlockMatchSADQCOM-06975",
|
|
"text": " If <code>OpImageBlockMatchSADQCOM</code> is used to read from an <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-OpImageBlockMatchSADQCOM-06976",
|
|
"text": " If <code>OpImageBlockMatchSADQCOM</code> or OpImageBlockMatchSSDQCOM is used to read from a reference image as result of this command, then the specified reference coordinates <strong class=\"purple\">must</strong> not fail <a href=\"#textures-integer-coordinate-validation\">integer texel coordinate validation</a>."
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-OpImageWeightedSampleQCOM-06977",
|
|
"text": " If <code>OpImageWeightedSampleQCOM</code>, <code>OpImageBoxFilterQCOM</code>, <code>OpImageBlockMatchSSDQCOM</code>, or <code>OpImageBlockMatchSADQCOM</code> uses a <a href=\"#VkSampler\">VkSampler</a> as a result of this command, then the sampler <strong class=\"purple\">must</strong> have been created with <code>VK_SAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-OpImageWeightedSampleQCOM-06978",
|
|
"text": " If any command other than <code>OpImageWeightedSampleQCOM</code>, <code>OpImageBoxFilterQCOM</code>, <code>OpImageBlockMatchSSDQCOM</code>, or <code>OpImageBlockMatchSADQCOM</code> uses a <a href=\"#VkSampler\">VkSampler</a> as a result of this command, then the sampler <strong class=\"purple\">must</strong> not have been created with <code>VK_SAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM</code>."
|
|
}
|
|
],
|
|
"(VK_NV_device_generated_commands)+(VK_VERSION_1_1,VK_KHR_multiview)": [
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-maxMultiviewInstanceIndex-02688",
|
|
"text": " If the draw is recorded in a render pass instance with multiview enabled, the maximum instance index <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#VkPhysicalDeviceMultiviewProperties\">VkPhysicalDeviceMultiviewProperties</a>::<code>maxMultiviewInstanceIndex</code>"
|
|
}
|
|
],
|
|
"(VK_NV_device_generated_commands)+(VK_EXT_sample_locations)": [
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-sampleLocationsEnable-02689",
|
|
"text": " If the bound graphics pipeline was created with <a href=\"#VkPipelineSampleLocationsStateCreateInfoEXT\">VkPipelineSampleLocationsStateCreateInfoEXT</a>::<code>sampleLocationsEnable</code> set to <code>VK_TRUE</code> and the current subpass has a depth/stencil attachment, then that attachment <strong class=\"purple\">must</strong> have been created with the <code>VK_IMAGE_CREATE_SAMPLE_LOCATIONS_COMPATIBLE_DEPTH_BIT_EXT</code> bit set"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-None-06666",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_SAMPLE_LOCATIONS_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetSampleLocationsEXT\">vkCmdSetSampleLocationsEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command"
|
|
}
|
|
],
|
|
"(VK_NV_device_generated_commands)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-viewportCount-03417",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, but not the <code>VK_DYNAMIC_STATE_SCISSOR_WITH_COUNT</code> dynamic state enabled, then <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>viewportCount</code> parameter of <code>vkCmdSetViewportWithCount</code> <strong class=\"purple\">must</strong> match the <code>VkPipelineViewportStateCreateInfo</code>::<code>scissorCount</code> of the pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-scissorCount-03418",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_SCISSOR_WITH_COUNT</code> dynamic state enabled, but not the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, then <a href=\"#vkCmdSetScissorWithCount\">vkCmdSetScissorWithCount</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>scissorCount</code> parameter of <code>vkCmdSetScissorWithCount</code> <strong class=\"purple\">must</strong> match the <code>VkPipelineViewportStateCreateInfo</code>::<code>viewportCount</code> of the pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-viewportCount-03419",
|
|
"text": " If the bound graphics pipeline state was created with both the <code>VK_DYNAMIC_STATE_SCISSOR_WITH_COUNT</code> and <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic states enabled then both <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a> and <a href=\"#vkCmdSetScissorWithCount\">vkCmdSetScissorWithCount</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>viewportCount</code> parameter of <code>vkCmdSetViewportWithCount</code> <strong class=\"purple\">must</strong> match the <code>scissorCount</code> parameter of <code>vkCmdSetScissorWithCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-primitiveTopology-03420",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_PRIMITIVE_TOPOLOGY_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetPrimitiveTopologyEXT\">vkCmdSetPrimitiveTopologyEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>primitiveTopology</code> parameter of <code>vkCmdSetPrimitiveTopologyEXT</code> <strong class=\"purple\">must</strong> be of the same <a href=\"#drawing-primitive-topology-class\">topology class</a> as the pipeline <a href=\"#VkPipelineInputAssemblyStateCreateInfo\">VkPipelineInputAssemblyStateCreateInfo</a>::<code>topology</code> state"
|
|
}
|
|
],
|
|
"(VK_NV_device_generated_commands)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_NV_clip_space_w_scaling)": [
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-viewportCount-04137",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, but not the <code>VK_DYNAMIC_STATE_VIEWPORT_W_SCALING_NV</code> dynamic state enabled, then the bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <a href=\"#VkPipelineViewportWScalingStateCreateInfoNV\">VkPipelineViewportWScalingStateCreateInfoNV</a>::<code>viewportCount</code> greater or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-viewportCount-04138",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> and <code>VK_DYNAMIC_STATE_VIEWPORT_W_SCALING_NV</code> dynamic states enabled then the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWScalingNV\">vkCmdSetViewportWScalingNV</a> <strong class=\"purple\">must</strong> be greater than or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
}
|
|
],
|
|
"(VK_NV_device_generated_commands)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_NV_shading_rate_image)": [
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-viewportCount-04139",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, but not the <code>VK_DYNAMIC_STATE_VIEWPORT_SHADING_RATE_PALETTE_NV</code> dynamic state enabled, then the bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <a href=\"#VkPipelineViewportShadingRateImageStateCreateInfoNV\">VkPipelineViewportShadingRateImageStateCreateInfoNV</a>::<code>viewportCount</code> greater or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-viewportCount-04140",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> and <code>VK_DYNAMIC_STATE_VIEWPORT_SHADING_RATE_PALETTE_NV</code> dynamic states enabled then the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportShadingRatePaletteNV\">vkCmdSetViewportShadingRatePaletteNV</a> <strong class=\"purple\">must</strong> be greater than or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
}
|
|
],
|
|
"(VK_NV_device_generated_commands)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_NV_viewport_swizzle)": [
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-VkPipelineVieportCreateInfo-04141",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled and a <a href=\"#VkPipelineViewportSwizzleStateCreateInfoNV\">VkPipelineViewportSwizzleStateCreateInfoNV</a> structure chained from <code>VkPipelineVieportCreateInfo</code>, then the bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <a href=\"#VkPipelineViewportSwizzleStateCreateInfoNV\">VkPipelineViewportSwizzleStateCreateInfoNV</a>::<code>viewportCount</code> greater or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
}
|
|
],
|
|
"(VK_NV_device_generated_commands)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_NV_scissor_exclusive)": [
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-VkPipelineVieportCreateInfo-04142",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled and a <a href=\"#VkPipelineViewportExclusiveScissorStateCreateInfoNV\">VkPipelineViewportExclusiveScissorStateCreateInfoNV</a> structure chained from <code>VkPipelineVieportCreateInfo</code>, then the bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <a href=\"#VkPipelineViewportExclusiveScissorStateCreateInfoNV\">VkPipelineViewportExclusiveScissorStateCreateInfoNV</a>::<code>exclusiveScissorCount</code> greater or equal to the <code>viewportCount</code> parameter in the last call to <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a>"
|
|
}
|
|
],
|
|
"(VK_NV_device_generated_commands)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-None-04876",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_RASTERIZER_DISCARD_ENABLE</code> dynamic state enabled then <a href=\"#vkCmdSetRasterizerDiscardEnable\">vkCmdSetRasterizerDiscardEnable</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-None-04877",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_DEPTH_BIAS_ENABLE</code> dynamic state enabled then <a href=\"#vkCmdSetDepthBiasEnable\">vkCmdSetDepthBiasEnable</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-logicOp-04878",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_LOGIC_OP_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetLogicOpEXT\">vkCmdSetLogicOpEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command and the <code>logicOp</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkLogicOp\">VkLogicOp</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-None-04875",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_PATCH_CONTROL_POINTS_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetPatchControlPointsEXT\">vkCmdSetPatchControlPointsEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-None-04879",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_PRIMITIVE_RESTART_ENABLE_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetPrimitiveRestartEnableEXT\">vkCmdSetPrimitiveRestartEnableEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command"
|
|
}
|
|
],
|
|
"(VK_NV_device_generated_commands)+(VK_KHR_fragment_shading_rate)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-primitiveFragmentShadingRateWithMultipleViewports-04552",
|
|
"text": " If the <a href=\"#limits-primitiveFragmentShadingRateWithMultipleViewports\"><code>primitiveFragmentShadingRateWithMultipleViewports</code></a> limit is not supported, the bound graphics pipeline was created with the <code>VK_DYNAMIC_STATE_VIEWPORT_WITH_COUNT</code> dynamic state enabled, and any of the shader stages of the bound graphics pipeline write to the <code>PrimitiveShadingRateKHR</code> built-in, then <a href=\"#vkCmdSetViewportWithCount\">vkCmdSetViewportWithCount</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>viewportCount</code> parameter of <code>vkCmdSetViewportWithCount</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
}
|
|
],
|
|
"(VK_NV_device_generated_commands)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)": [
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-imageView-06172",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pDepthAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pDepthAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the depth attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-imageView-06173",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pStencilAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pStencilAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the stencil attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-viewMask-06178",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound graphics pipeline <strong class=\"purple\">must</strong> have been created with a <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>viewMask</code> equal to <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>viewMask</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-colorAttachmentCount-06179",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound graphics pipeline <strong class=\"purple\">must</strong> have been created with a <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>colorAttachmentCount</code> equal to <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>colorAttachmentCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-colorAttachmentCount-06180",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>colorAttachmentCount</code> greater than <code>0</code>, then each element of the <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pColorAttachments</code> array with a <code>imageView</code> not equal to <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> <strong class=\"purple\">must</strong> have been created with a <a href=\"#VkFormat\">VkFormat</a> equal to the corresponding element of <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>pColorAttachmentFormats</code> used to create the currently bound graphics pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-pDepthAttachment-06181",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>depthAttachmentFormat</code> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the <a href=\"#VkFormat\">VkFormat</a> used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-pStencilAttachment-06182",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of <a href=\"#VkPipelineRenderingCreateInfo\">VkPipelineRenderingCreateInfo</a>::<code>stencilAttachmentFormat</code> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the <a href=\"#VkFormat\">VkFormat</a> used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code>"
|
|
}
|
|
],
|
|
"(VK_NV_device_generated_commands)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_VERSION_1_1,VK_KHR_maintenance2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-imageView-06174",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pDepthAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pDepthAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_STENCIL_ATTACHMENT_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the depth attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-imageView-06175",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pStencilAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pStencilAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_STENCIL_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the stencil attachment"
|
|
}
|
|
],
|
|
"(VK_NV_device_generated_commands)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_VERSION_1_2,VK_KHR_separate_depth_stencil_layouts)": [
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-imageView-06176",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pDepthAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pDepthAttachment</code> is <code>VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the depth attachment"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-imageView-06177",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the <code>imageView</code> member of <code>pStencilAttachment</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, and the <code>layout</code> member of <code>pStencilAttachment</code> is <code>VK_IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL</code>, this command <strong class=\"purple\">must</strong> not write any values to the stencil attachment"
|
|
}
|
|
],
|
|
"(VK_NV_device_generated_commands)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_EXT_color_write_enable)": [
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-attachmentCount-06667",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_COLOR_WRITE_ENABLE_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetColorWriteEnableEXT\">vkCmdSetColorWriteEnableEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>attachmentCount</code> parameter of <code>vkCmdSetColorWriteEnableEXT</code> <strong class=\"purple\">must</strong> be greater than or equal to the <code>VkPipelineColorBlendStateCreateInfo</code>::<code>attachmentCount</code> of the currently bound graphics pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-attachmentCount-06815",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_COLOR_WRITE_ENABLE_EXT</code> dynamic state enabled then <a href=\"#vkCmdSetColorWriteEnableEXT\">vkCmdSetColorWriteEnableEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>attachmentCount</code> parameter of <code>vkCmdSetColorWriteEnableEXT</code> <strong class=\"purple\">must</strong> be less than or equal to the <code>maxColorAttachments</code> member of <code>VkPhysicalDeviceLimits</code>"
|
|
}
|
|
],
|
|
"(VK_NV_device_generated_commands)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_KHR_fragment_shading_rate)": [
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-imageView-06183",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingFragmentShadingRateAttachmentInfoKHR\">VkRenderingFragmentShadingRateAttachmentInfoKHR</a>::<code>imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the currently bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <code>VK_PIPELINE_CREATE_RENDERING_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR</code>"
|
|
}
|
|
],
|
|
"(VK_NV_device_generated_commands)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_EXT_fragment_density_map)": [
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-imageView-06184",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> and <a href=\"#VkRenderingFragmentDensityMapAttachmentInfoEXT\">VkRenderingFragmentDensityMapAttachmentInfoEXT</a>::<code>imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the currently bound graphics pipeline <strong class=\"purple\">must</strong> have been created with <code>VK_PIPELINE_CREATE_RENDERING_FRAGMENT_DENSITY_MAP_ATTACHMENT_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_NV_device_generated_commands)+(VK_VERSION_1_3,VK_KHR_dynamic_rendering)+(VK_AMD_mixed_attachment_samples,VK_NV_framebuffer_mixed_samples)": [
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-colorAttachmentCount-06185",
|
|
"text": " If the currently bound pipeline was created with a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> with a <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>colorAttachmentCount</code> parameter greater than <code>0</code>, then each element of the <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pColorAttachments</code> array with a <code>imageView</code> not equal to <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> <strong class=\"purple\">must</strong> have been created with a sample count equal to the corresponding element of the <code>pColorAttachmentSamples</code> member of <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> used to create the currently bound graphics pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-pDepthAttachment-06186",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline was created with a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of the <code>depthStencilAttachmentSamples</code> member of <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the sample count used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-pStencilAttachment-06187",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline was created with a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of the <code>depthStencilAttachmentSamples</code> member of <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the sample count used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-colorAttachmentCount-06188",
|
|
"text": " If the currently bound pipeline was created without a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a> with a <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>colorAttachmentCount</code> parameter greater than <code>0</code>, then each element of the <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pColorAttachments</code> array with a <code>imageView</code> not equal to <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> <strong class=\"purple\">must</strong> have been created with a sample count equal to the value of <a href=\"#VkPipelineMultisampleStateCreateInfo\">VkPipelineMultisampleStateCreateInfo</a>::<code>rasterizationSamples</code> used to create the currently bound graphics pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-pDepthAttachment-06189",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline was created without a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of <a href=\"#VkPipelineMultisampleStateCreateInfo\">VkPipelineMultisampleStateCreateInfo</a>::<code>rasterizationSamples</code> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the sample count used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pDepthAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-pStencilAttachment-06190",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline was created without a <a href=\"#VkAttachmentSampleCountInfoAMD\">VkAttachmentSampleCountInfoAMD</a> or <a href=\"#VkAttachmentSampleCountInfoNV\">VkAttachmentSampleCountInfoNV</a> structure, and <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code> was not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the value of <a href=\"#VkPipelineMultisampleStateCreateInfo\">VkPipelineMultisampleStateCreateInfo</a>::<code>rasterizationSamples</code> used to create the currently bound graphics pipeline <strong class=\"purple\">must</strong> be equal to the sample count used to create <a href=\"#VkRenderingInfo\">VkRenderingInfo</a>::<code>pStencilAttachment->imageView</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-renderPass-06198",
|
|
"text": " If the current render pass instance was begun with <a href=\"#vkCmdBeginRendering\">vkCmdBeginRendering</a>, the currently bound pipeline <strong class=\"purple\">must</strong> have been created with a <a href=\"#VkGraphicsPipelineCreateInfo\">VkGraphicsPipelineCreateInfo</a>::<code>renderPass</code> equal to <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
}
|
|
],
|
|
"(VK_NV_device_generated_commands)+(VK_EXT_primitives_generated_query)": [
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-primitivesGeneratedQueryWithRasterizerDiscard-06708",
|
|
"text": " If the <a href=\"#features-primitivesGeneratedQueryWithRasterizerDiscard\"><code>primitivesGeneratedQueryWithRasterizerDiscard</code></a> feature is not enabled and the <code>VK_QUERY_TYPE_PRIMITIVES_GENERATED_EXT</code> query is active, <a href=\"#primsrast-discard\">rasterization discard</a> <strong class=\"purple\">must</strong> not be enabled."
|
|
}
|
|
],
|
|
"(VK_NV_device_generated_commands)+(VK_EXT_primitives_generated_query)+(VK_EXT_transform_feedback)": [
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-primitivesGeneratedQueryWithNonZeroStreams-06709",
|
|
"text": " If the <a href=\"#features-primitivesGeneratedQueryWithNonZeroStreams\"><code>primitivesGeneratedQueryWithNonZeroStreams</code></a> feature is not enabled and the <code>VK_QUERY_TYPE_PRIMITIVES_GENERATED_EXT</code> query is active, the bound graphics pipeline <strong class=\"purple\">must</strong> not have been created with a non-zero value in <code>VkPipelineRasterizationStateStreamCreateInfoEXT</code>::<code>rasterizationStream</code>."
|
|
}
|
|
],
|
|
"(VK_NV_device_generated_commands)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+(VK_EXT_vertex_input_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-None-04912",
|
|
"text": " If the bound graphics pipeline was created with both the <code>VK_DYNAMIC_STATE_VERTEX_INPUT_EXT</code> and <code>VK_DYNAMIC_STATE_VERTEX_INPUT_BINDING_STRIDE_EXT</code> dynamic states enabled, then <a href=\"#vkCmdSetVertexInputEXT\">vkCmdSetVertexInputEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this draw command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-pStrides-04913",
|
|
"text": " If the bound graphics pipeline was created with the <code>VK_DYNAMIC_STATE_VERTEX_INPUT_BINDING_STRIDE_EXT</code> dynamic state enabled, but not the <code>VK_DYNAMIC_STATE_VERTEX_INPUT_EXT</code> dynamic state enabled, then <a href=\"#vkCmdBindVertexBuffers2EXT\">vkCmdBindVertexBuffers2EXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this draw command, and the <code>pStrides</code> parameter of <a href=\"#vkCmdBindVertexBuffers2EXT\">vkCmdBindVertexBuffers2EXT</a> <strong class=\"purple\">must</strong> not be <code>NULL</code>"
|
|
}
|
|
],
|
|
"(VK_NV_device_generated_commands)+(VK_VERSION_1_3,VK_EXT_extended_dynamic_state)+!(VK_EXT_vertex_input_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-pStrides-04884",
|
|
"text": " If the bound graphics pipeline was created with the <code>VK_DYNAMIC_STATE_VERTEX_INPUT_BINDING_STRIDE_EXT</code> dynamic state enabled, then <a href=\"#vkCmdBindVertexBuffers2EXT\">vkCmdBindVertexBuffers2EXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this drawing command, and the <code>pStrides</code> parameter of <a href=\"#vkCmdBindVertexBuffers2EXT\">vkCmdBindVertexBuffers2EXT</a> <strong class=\"purple\">must</strong> not be <code>NULL</code>"
|
|
}
|
|
],
|
|
"(VK_NV_device_generated_commands)+(VK_EXT_vertex_input_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-None-04914",
|
|
"text": " If the bound graphics pipeline state was created with the <code>VK_DYNAMIC_STATE_VERTEX_INPUT_EXT</code> dynamic state enabled, then <a href=\"#vkCmdSetVertexInputEXT\">vkCmdSetVertexInputEXT</a> <strong class=\"purple\">must</strong> have been called in the current command buffer prior to this draw command"
|
|
}
|
|
],
|
|
"(VK_NV_device_generated_commands)+(VK_NV_mesh_shader)": [
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-stage-06481",
|
|
"text": " The bound graphics pipeline <strong class=\"purple\">must</strong> not have been created with the <a href=\"#VkPipelineShaderStageCreateInfo\">VkPipelineShaderStageCreateInfo</a>::<code>stage</code> member of an element of <a href=\"#VkGraphicsPipelineCreateInfo\">VkGraphicsPipelineCreateInfo</a>::<code>pStages</code> set to <code>VK_SHADER_STAGE_TASK_BIT_NV</code> or <code>VK_SHADER_STAGE_MESH_BIT_NV</code>"
|
|
}
|
|
],
|
|
"(VK_NV_device_generated_commands)+(VK_EXT_transform_feedback)": [
|
|
{
|
|
"vuid": "VUID-vkCmdExecuteGeneratedCommandsNV-None-02910",
|
|
"text": " Transform feedback <strong class=\"purple\">must</strong> not be active"
|
|
}
|
|
]
|
|
},
|
|
"VkGeneratedCommandsInfoNV": {
|
|
"(VK_NV_device_generated_commands)": [
|
|
{
|
|
"vuid": "VUID-VkGeneratedCommandsInfoNV-pipeline-02912",
|
|
"text": " The provided <code>pipeline</code> <strong class=\"purple\">must</strong> match the pipeline bound at execution time"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGeneratedCommandsInfoNV-indirectCommandsLayout-02913",
|
|
"text": " If the <code>indirectCommandsLayout</code> uses a token of <code>VK_INDIRECT_COMMANDS_TOKEN_TYPE_SHADER_GROUP_NV</code>, then the <code>pipeline</code> <strong class=\"purple\">must</strong> have been created with multiple shader groups"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGeneratedCommandsInfoNV-indirectCommandsLayout-02914",
|
|
"text": " If the <code>indirectCommandsLayout</code> uses a token of <code>VK_INDIRECT_COMMANDS_TOKEN_TYPE_SHADER_GROUP_NV</code>, then the <code>pipeline</code> <strong class=\"purple\">must</strong> have been created with <code>VK_PIPELINE_CREATE_INDIRECT_BINDABLE_BIT_NV</code> set in <code>VkGraphicsPipelineCreateInfo</code>::<code>flags</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGeneratedCommandsInfoNV-indirectCommandsLayout-02915",
|
|
"text": " If the <code>indirectCommandsLayout</code> uses a token of <code>VK_INDIRECT_COMMANDS_TOKEN_TYPE_PUSH_CONSTANT_NV</code>, then the <code>pipeline</code>`s <code>VkPipelineLayout</code> <strong class=\"purple\">must</strong> match the <a href=\"#VkIndirectCommandsLayoutTokenNV\">VkIndirectCommandsLayoutTokenNV</a>::<code>pushconstantPipelineLayout</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGeneratedCommandsInfoNV-streamCount-02916",
|
|
"text": " <code>streamCount</code> <strong class=\"purple\">must</strong> match the <code>indirectCommandsLayout</code>’s <code>streamCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGeneratedCommandsInfoNV-sequencesCount-02917",
|
|
"text": " <code>sequencesCount</code> <strong class=\"purple\">must</strong> be less or equal to <a href=\"#VkPhysicalDeviceDeviceGeneratedCommandsPropertiesNV\">VkPhysicalDeviceDeviceGeneratedCommandsPropertiesNV</a>::<code>maxIndirectSequenceCount</code> and <a href=\"#VkGeneratedCommandsMemoryRequirementsInfoNV\">VkGeneratedCommandsMemoryRequirementsInfoNV</a>::<code>maxSequencesCount</code> that was used to determine the <code>preprocessSize</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGeneratedCommandsInfoNV-preprocessBuffer-02918",
|
|
"text": " <code>preprocessBuffer</code> <strong class=\"purple\">must</strong> have the <code>VK_BUFFER_USAGE_INDIRECT_BUFFER_BIT</code> bit set in its usage flag"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGeneratedCommandsInfoNV-preprocessOffset-02919",
|
|
"text": " <code>preprocessOffset</code> <strong class=\"purple\">must</strong> be aligned to <a href=\"#VkPhysicalDeviceDeviceGeneratedCommandsPropertiesNV\">VkPhysicalDeviceDeviceGeneratedCommandsPropertiesNV</a>::<code>minIndirectCommandsBufferOffsetAlignment</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGeneratedCommandsInfoNV-preprocessBuffer-02971",
|
|
"text": " If <code>preprocessBuffer</code> is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGeneratedCommandsInfoNV-preprocessSize-02920",
|
|
"text": " <code>preprocessSize</code> <strong class=\"purple\">must</strong> be at least equal to the memory requirement`s size returned by <a href=\"#vkGetGeneratedCommandsMemoryRequirementsNV\">vkGetGeneratedCommandsMemoryRequirementsNV</a> using the matching inputs (<code>indirectCommandsLayout</code>, …​) as within this structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGeneratedCommandsInfoNV-sequencesCountBuffer-02921",
|
|
"text": " <code>sequencesCountBuffer</code> <strong class=\"purple\">can</strong> be set if the actual used count of sequences is sourced from the provided buffer. In that case the <code>sequencesCount</code> serves as upper bound"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGeneratedCommandsInfoNV-sequencesCountBuffer-02922",
|
|
"text": " If <code>sequencesCountBuffer</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, its usage flag <strong class=\"purple\">must</strong> have the <code>VK_BUFFER_USAGE_INDIRECT_BUFFER_BIT</code> bit set"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGeneratedCommandsInfoNV-sequencesCountBuffer-02923",
|
|
"text": " If <code>sequencesCountBuffer</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>sequencesCountOffset</code> <strong class=\"purple\">must</strong> be aligned to <code>VkPhysicalDeviceDeviceGeneratedCommandsPropertiesNV</code>::<code>minSequencesCountBufferOffsetAlignment</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGeneratedCommandsInfoNV-sequencesCountBuffer-02972",
|
|
"text": " If <code>sequencesCountBuffer</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> and is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGeneratedCommandsInfoNV-sequencesIndexBuffer-02924",
|
|
"text": " If <code>indirectCommandsLayout</code>’s <code>VK_INDIRECT_COMMANDS_LAYOUT_USAGE_INDEXED_SEQUENCES_BIT_NV</code> is set, <code>sequencesIndexBuffer</code> <strong class=\"purple\">must</strong> be set otherwise it <strong class=\"purple\">must</strong> be <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGeneratedCommandsInfoNV-sequencesIndexBuffer-02925",
|
|
"text": " If <code>sequencesIndexBuffer</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, its usage flag <strong class=\"purple\">must</strong> have the <code>VK_BUFFER_USAGE_INDIRECT_BUFFER_BIT</code> bit set"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGeneratedCommandsInfoNV-sequencesIndexBuffer-02926",
|
|
"text": " If <code>sequencesIndexBuffer</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>sequencesIndexOffset</code> <strong class=\"purple\">must</strong> be aligned to <code>VkPhysicalDeviceDeviceGeneratedCommandsPropertiesNV</code>::<code>minSequencesIndexBufferOffsetAlignment</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGeneratedCommandsInfoNV-sequencesIndexBuffer-02973",
|
|
"text": " If <code>sequencesIndexBuffer</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> and is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGeneratedCommandsInfoNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_GENERATED_COMMANDS_INFO_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGeneratedCommandsInfoNV-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGeneratedCommandsInfoNV-pipelineBindPoint-parameter",
|
|
"text": " <code>pipelineBindPoint</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPipelineBindPoint\">VkPipelineBindPoint</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGeneratedCommandsInfoNV-pipeline-parameter",
|
|
"text": " <code>pipeline</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPipeline\">VkPipeline</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGeneratedCommandsInfoNV-indirectCommandsLayout-parameter",
|
|
"text": " <code>indirectCommandsLayout</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkIndirectCommandsLayoutNV\">VkIndirectCommandsLayoutNV</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGeneratedCommandsInfoNV-pStreams-parameter",
|
|
"text": " <code>pStreams</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>streamCount</code> valid <a href=\"#VkIndirectCommandsStreamNV\">VkIndirectCommandsStreamNV</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGeneratedCommandsInfoNV-preprocessBuffer-parameter",
|
|
"text": " <code>preprocessBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBuffer\">VkBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGeneratedCommandsInfoNV-sequencesCountBuffer-parameter",
|
|
"text": " If <code>sequencesCountBuffer</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>sequencesCountBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBuffer\">VkBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGeneratedCommandsInfoNV-sequencesIndexBuffer-parameter",
|
|
"text": " If <code>sequencesIndexBuffer</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>sequencesIndexBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBuffer\">VkBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGeneratedCommandsInfoNV-streamCount-arraylength",
|
|
"text": " <code>streamCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkGeneratedCommandsInfoNV-commonparent",
|
|
"text": " Each of <code>indirectCommandsLayout</code>, <code>pipeline</code>, <code>preprocessBuffer</code>, <code>sequencesCountBuffer</code>, and <code>sequencesIndexBuffer</code> that are valid handles of non-ignored parameters <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdPreprocessGeneratedCommandsNV": {
|
|
"(VK_NV_device_generated_commands)+(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-vkCmdPreprocessGeneratedCommandsNV-commandBuffer-02974",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> not be a protected command buffer"
|
|
}
|
|
],
|
|
"(VK_NV_device_generated_commands)": [
|
|
{
|
|
"vuid": "VUID-vkCmdPreprocessGeneratedCommandsNV-pGeneratedCommandsInfo-02927",
|
|
"text": " <code>pGeneratedCommandsInfo</code>`s <code>indirectCommandsLayout</code> <strong class=\"purple\">must</strong> have been created with the <code>VK_INDIRECT_COMMANDS_LAYOUT_USAGE_EXPLICIT_PREPROCESS_BIT_NV</code> bit set"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPreprocessGeneratedCommandsNV-deviceGeneratedCommands-02928",
|
|
"text": " The <a href=\"#features-deviceGeneratedCommands\"><code>VkPhysicalDeviceDeviceGeneratedCommandsFeaturesNV</code>::<code>deviceGeneratedCommands</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPreprocessGeneratedCommandsNV-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPreprocessGeneratedCommandsNV-pGeneratedCommandsInfo-parameter",
|
|
"text": " <code>pGeneratedCommandsInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkGeneratedCommandsInfoNV\">VkGeneratedCommandsInfoNV</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPreprocessGeneratedCommandsNV-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPreprocessGeneratedCommandsNV-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics, or compute operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPreprocessGeneratedCommandsNV-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdPreprocessGeneratedCommandsNV-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
]
|
|
},
|
|
"vkGetPhysicalDeviceSparseImageFormatProperties": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSparseImageFormatProperties-samples-01094",
|
|
"text": " <code>samples</code> <strong class=\"purple\">must</strong> be a bit value that is set in <code>VkImageFormatProperties</code>::<code>sampleCounts</code> returned by <code>vkGetPhysicalDeviceImageFormatProperties</code> with <code>format</code>, <code>type</code>, <code>tiling</code>, and <code>usage</code> equal to those in this command and <code>flags</code> equal to the value that is set in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a>::<code>flags</code> when the image is created"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSparseImageFormatProperties-physicalDevice-parameter",
|
|
"text": " <code>physicalDevice</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSparseImageFormatProperties-format-parameter",
|
|
"text": " <code>format</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkFormat\">VkFormat</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSparseImageFormatProperties-type-parameter",
|
|
"text": " <code>type</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageType\">VkImageType</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSparseImageFormatProperties-samples-parameter",
|
|
"text": " <code>samples</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSampleCountFlagBits\">VkSampleCountFlagBits</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSparseImageFormatProperties-usage-parameter",
|
|
"text": " <code>usage</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkImageUsageFlagBits\">VkImageUsageFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSparseImageFormatProperties-usage-requiredbitmask",
|
|
"text": " <code>usage</code> <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSparseImageFormatProperties-tiling-parameter",
|
|
"text": " <code>tiling</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageTiling\">VkImageTiling</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSparseImageFormatProperties-pPropertyCount-parameter",
|
|
"text": " <code>pPropertyCount</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>uint32_t</code> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSparseImageFormatProperties-pProperties-parameter",
|
|
"text": " If the value referenced by <code>pPropertyCount</code> is not <code>0</code>, and <code>pProperties</code> is not <code>NULL</code>, <code>pProperties</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>pPropertyCount</code> <a href=\"#VkSparseImageFormatProperties\">VkSparseImageFormatProperties</a> structures"
|
|
}
|
|
]
|
|
},
|
|
"vkGetPhysicalDeviceSparseImageFormatProperties2": {
|
|
"(VK_VERSION_1_1,VK_KHR_get_physical_device_properties2)": [
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSparseImageFormatProperties2-physicalDevice-parameter",
|
|
"text": " <code>physicalDevice</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSparseImageFormatProperties2-pFormatInfo-parameter",
|
|
"text": " <code>pFormatInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkPhysicalDeviceSparseImageFormatInfo2\">VkPhysicalDeviceSparseImageFormatInfo2</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSparseImageFormatProperties2-pPropertyCount-parameter",
|
|
"text": " <code>pPropertyCount</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>uint32_t</code> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSparseImageFormatProperties2-pProperties-parameter",
|
|
"text": " If the value referenced by <code>pPropertyCount</code> is not <code>0</code>, and <code>pProperties</code> is not <code>NULL</code>, <code>pProperties</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>pPropertyCount</code> <a href=\"#VkSparseImageFormatProperties2\">VkSparseImageFormatProperties2</a> structures"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceSparseImageFormatInfo2": {
|
|
"(VK_VERSION_1_1,VK_KHR_get_physical_device_properties2)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceSparseImageFormatInfo2-samples-01095",
|
|
"text": " <code>samples</code> <strong class=\"purple\">must</strong> be a bit value that is set in <code>VkImageFormatProperties</code>::<code>sampleCounts</code> returned by <code>vkGetPhysicalDeviceImageFormatProperties</code> with <code>format</code>, <code>type</code>, <code>tiling</code>, and <code>usage</code> equal to those in this command and <code>flags</code> equal to the value that is set in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a>::<code>flags</code> when the image is created"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceSparseImageFormatInfo2-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_SPARSE_IMAGE_FORMAT_INFO_2</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceSparseImageFormatInfo2-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceSparseImageFormatInfo2-format-parameter",
|
|
"text": " <code>format</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkFormat\">VkFormat</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceSparseImageFormatInfo2-type-parameter",
|
|
"text": " <code>type</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageType\">VkImageType</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceSparseImageFormatInfo2-samples-parameter",
|
|
"text": " <code>samples</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSampleCountFlagBits\">VkSampleCountFlagBits</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceSparseImageFormatInfo2-usage-parameter",
|
|
"text": " <code>usage</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkImageUsageFlagBits\">VkImageUsageFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceSparseImageFormatInfo2-usage-requiredbitmask",
|
|
"text": " <code>usage</code> <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceSparseImageFormatInfo2-tiling-parameter",
|
|
"text": " <code>tiling</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageTiling\">VkImageTiling</a> value"
|
|
}
|
|
]
|
|
},
|
|
"VkSparseImageFormatProperties2": {
|
|
"(VK_VERSION_1_1,VK_KHR_get_physical_device_properties2)": [
|
|
{
|
|
"vuid": "VUID-VkSparseImageFormatProperties2-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_SPARSE_IMAGE_FORMAT_PROPERTIES_2</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSparseImageFormatProperties2-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetImageSparseMemoryRequirements": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkGetImageSparseMemoryRequirements-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetImageSparseMemoryRequirements-image-parameter",
|
|
"text": " <code>image</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImage\">VkImage</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetImageSparseMemoryRequirements-pSparseMemoryRequirementCount-parameter",
|
|
"text": " <code>pSparseMemoryRequirementCount</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>uint32_t</code> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetImageSparseMemoryRequirements-pSparseMemoryRequirements-parameter",
|
|
"text": " If the value referenced by <code>pSparseMemoryRequirementCount</code> is not <code>0</code>, and <code>pSparseMemoryRequirements</code> is not <code>NULL</code>, <code>pSparseMemoryRequirements</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>pSparseMemoryRequirementCount</code> <a href=\"#VkSparseImageMemoryRequirements\">VkSparseImageMemoryRequirements</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetImageSparseMemoryRequirements-image-parent",
|
|
"text": " <code>image</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetImageSparseMemoryRequirements2": {
|
|
"(VK_VERSION_1_1,VK_KHR_get_memory_requirements2)": [
|
|
{
|
|
"vuid": "VUID-vkGetImageSparseMemoryRequirements2-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetImageSparseMemoryRequirements2-pInfo-parameter",
|
|
"text": " <code>pInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkImageSparseMemoryRequirementsInfo2\">VkImageSparseMemoryRequirementsInfo2</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetImageSparseMemoryRequirements2-pSparseMemoryRequirementCount-parameter",
|
|
"text": " <code>pSparseMemoryRequirementCount</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>uint32_t</code> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetImageSparseMemoryRequirements2-pSparseMemoryRequirements-parameter",
|
|
"text": " If the value referenced by <code>pSparseMemoryRequirementCount</code> is not <code>0</code>, and <code>pSparseMemoryRequirements</code> is not <code>NULL</code>, <code>pSparseMemoryRequirements</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>pSparseMemoryRequirementCount</code> <a href=\"#VkSparseImageMemoryRequirements2\">VkSparseImageMemoryRequirements2</a> structures"
|
|
}
|
|
]
|
|
},
|
|
"vkGetDeviceImageSparseMemoryRequirements": {
|
|
"(VK_VERSION_1_1,VK_KHR_get_memory_requirements2)+(VK_VERSION_1_3,VK_KHR_maintenance4)": [
|
|
{
|
|
"vuid": "VUID-vkGetDeviceImageSparseMemoryRequirements-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDeviceImageSparseMemoryRequirements-pInfo-parameter",
|
|
"text": " <code>pInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkDeviceImageMemoryRequirements\">VkDeviceImageMemoryRequirements</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDeviceImageSparseMemoryRequirements-pSparseMemoryRequirementCount-parameter",
|
|
"text": " <code>pSparseMemoryRequirementCount</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>uint32_t</code> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDeviceImageSparseMemoryRequirements-pSparseMemoryRequirements-parameter",
|
|
"text": " If the value referenced by <code>pSparseMemoryRequirementCount</code> is not <code>0</code>, and <code>pSparseMemoryRequirements</code> is not <code>NULL</code>, <code>pSparseMemoryRequirements</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>pSparseMemoryRequirementCount</code> <a href=\"#VkSparseImageMemoryRequirements2\">VkSparseImageMemoryRequirements2</a> structures"
|
|
}
|
|
]
|
|
},
|
|
"VkImageSparseMemoryRequirementsInfo2": {
|
|
"(VK_VERSION_1_1,VK_KHR_get_memory_requirements2)": [
|
|
{
|
|
"vuid": "VUID-VkImageSparseMemoryRequirementsInfo2-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_IMAGE_SPARSE_MEMORY_REQUIREMENTS_INFO_2</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageSparseMemoryRequirementsInfo2-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageSparseMemoryRequirementsInfo2-image-parameter",
|
|
"text": " <code>image</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImage\">VkImage</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkSparseImageMemoryRequirements2": {
|
|
"(VK_VERSION_1_1,VK_KHR_get_memory_requirements2)": [
|
|
{
|
|
"vuid": "VUID-VkSparseImageMemoryRequirements2-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_SPARSE_IMAGE_MEMORY_REQUIREMENTS_2</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSparseImageMemoryRequirements2-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkSparseMemoryBind": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkSparseMemoryBind-memory-01096",
|
|
"text": " If <code>memory</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>memory</code> and <code>memoryOffset</code> <strong class=\"purple\">must</strong> match the memory requirements of the resource, as described in section <a href=\"#resources-association\">Resource Memory Association</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSparseMemoryBind-memory-01097",
|
|
"text": " If <code>memory</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>memory</code> <strong class=\"purple\">must</strong> not have been created with a memory type that reports <code>VK_MEMORY_PROPERTY_LAZILY_ALLOCATED_BIT</code> bit set"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSparseMemoryBind-size-01098",
|
|
"text": " <code>size</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSparseMemoryBind-resourceOffset-01099",
|
|
"text": " <code>resourceOffset</code> <strong class=\"purple\">must</strong> be less than the size of the resource"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSparseMemoryBind-size-01100",
|
|
"text": " <code>size</code> <strong class=\"purple\">must</strong> be less than or equal to the size of the resource minus <code>resourceOffset</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSparseMemoryBind-memoryOffset-01101",
|
|
"text": " <code>memoryOffset</code> <strong class=\"purple\">must</strong> be less than the size of <code>memory</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSparseMemoryBind-size-01102",
|
|
"text": " <code>size</code> <strong class=\"purple\">must</strong> be less than or equal to the size of <code>memory</code> minus <code>memoryOffset</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSparseMemoryBind-memory-parameter",
|
|
"text": " If <code>memory</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>memory</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDeviceMemory\">VkDeviceMemory</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSparseMemoryBind-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkSparseMemoryBindFlagBits\">VkSparseMemoryBindFlagBits</a> values"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_external_memory)": [
|
|
{
|
|
"vuid": "VUID-VkSparseMemoryBind-memory-02730",
|
|
"text": " If <code>memory</code> was created with <a href=\"#VkExportMemoryAllocateInfo\">VkExportMemoryAllocateInfo</a>::<code>handleTypes</code> not equal to <code>0</code>, at least one handle type it contained <strong class=\"purple\">must</strong> also have been set in <a href=\"#VkExternalMemoryBufferCreateInfo\">VkExternalMemoryBufferCreateInfo</a>::<code>handleTypes</code> or <a href=\"#VkExternalMemoryImageCreateInfo\">VkExternalMemoryImageCreateInfo</a>::<code>handleTypes</code> when the resource was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSparseMemoryBind-memory-02731",
|
|
"text": " If <code>memory</code> was created by a memory import operation, the external handle type of the imported memory <strong class=\"purple\">must</strong> also have been set in <a href=\"#VkExternalMemoryBufferCreateInfo\">VkExternalMemoryBufferCreateInfo</a>::<code>handleTypes</code> or <a href=\"#VkExternalMemoryImageCreateInfo\">VkExternalMemoryImageCreateInfo</a>::<code>handleTypes</code> when the resource was created"
|
|
}
|
|
]
|
|
},
|
|
"VkSparseBufferMemoryBindInfo": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkSparseBufferMemoryBindInfo-buffer-parameter",
|
|
"text": " <code>buffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBuffer\">VkBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSparseBufferMemoryBindInfo-pBinds-parameter",
|
|
"text": " <code>pBinds</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>bindCount</code> valid <a href=\"#VkSparseMemoryBind\">VkSparseMemoryBind</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSparseBufferMemoryBindInfo-bindCount-arraylength",
|
|
"text": " <code>bindCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkSparseImageOpaqueMemoryBindInfo": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkSparseImageOpaqueMemoryBindInfo-pBinds-01103",
|
|
"text": " If the <code>flags</code> member of any element of <code>pBinds</code> contains <code>VK_SPARSE_MEMORY_BIND_METADATA_BIT</code>, the binding range defined <strong class=\"purple\">must</strong> be within the mip tail region of the metadata aspect of <code>image</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSparseImageOpaqueMemoryBindInfo-image-parameter",
|
|
"text": " <code>image</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImage\">VkImage</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSparseImageOpaqueMemoryBindInfo-pBinds-parameter",
|
|
"text": " <code>pBinds</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>bindCount</code> valid <a href=\"#VkSparseMemoryBind\">VkSparseMemoryBind</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSparseImageOpaqueMemoryBindInfo-bindCount-arraylength",
|
|
"text": " <code>bindCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkSparseImageMemoryBindInfo": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkSparseImageMemoryBindInfo-subresource-01722",
|
|
"text": " The <code>subresource.mipLevel</code> member of each element of <code>pBinds</code> <strong class=\"purple\">must</strong> be less than the <code>mipLevels</code> specified in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> when <code>image</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSparseImageMemoryBindInfo-subresource-01723",
|
|
"text": " The <code>subresource.arrayLayer</code> member of each element of <code>pBinds</code> <strong class=\"purple\">must</strong> be less than the <code>arrayLayers</code> specified in <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a> when <code>image</code> was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSparseImageMemoryBindInfo-image-02901",
|
|
"text": " <code>image</code> <strong class=\"purple\">must</strong> have been created with <code>VK_IMAGE_CREATE_SPARSE_RESIDENCY_BIT</code> set"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSparseImageMemoryBindInfo-image-parameter",
|
|
"text": " <code>image</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImage\">VkImage</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSparseImageMemoryBindInfo-pBinds-parameter",
|
|
"text": " <code>pBinds</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>bindCount</code> valid <a href=\"#VkSparseImageMemoryBind\">VkSparseImageMemoryBind</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSparseImageMemoryBindInfo-bindCount-arraylength",
|
|
"text": " <code>bindCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkSparseImageMemoryBind": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkSparseImageMemoryBind-memory-01104",
|
|
"text": " If the <a href=\"#features-sparseResidencyAliased\"><code>sparseResidencyAliased</code></a> feature is not enabled, and if any other resources are bound to ranges of <code>memory</code>, the range of <code>memory</code> being bound <strong class=\"purple\">must</strong> not overlap with those bound ranges"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSparseImageMemoryBind-memory-01105",
|
|
"text": " <code>memory</code> and <code>memoryOffset</code> <strong class=\"purple\">must</strong> match the memory requirements of the calling command’s <code>image</code>, as described in section <a href=\"#resources-association\">Resource Memory Association</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSparseImageMemoryBind-subresource-01106",
|
|
"text": " <code>subresource</code> <strong class=\"purple\">must</strong> be a valid image subresource for <code>image</code> (see <a href=\"#resources-image-views\">Image Views</a>)"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSparseImageMemoryBind-offset-01107",
|
|
"text": " <code>offset.x</code> <strong class=\"purple\">must</strong> be a multiple of the sparse image block width (<code>VkSparseImageFormatProperties</code>::<code>imageGranularity.width</code>) of the image"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSparseImageMemoryBind-extent-01108",
|
|
"text": " <code>extent.width</code> <strong class=\"purple\">must</strong> either be a multiple of the sparse image block width of the image, or else <span class=\"eq\">(<code>extent.width</code> + <code>offset.x</code>)</span> <strong class=\"purple\">must</strong> equal the width of the image subresource"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSparseImageMemoryBind-offset-01109",
|
|
"text": " <code>offset.y</code> <strong class=\"purple\">must</strong> be a multiple of the sparse image block height (<code>VkSparseImageFormatProperties</code>::<code>imageGranularity.height</code>) of the image"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSparseImageMemoryBind-extent-01110",
|
|
"text": " <code>extent.height</code> <strong class=\"purple\">must</strong> either be a multiple of the sparse image block height of the image, or else <span class=\"eq\">(<code>extent.height</code> + <code>offset.y</code>)</span> <strong class=\"purple\">must</strong> equal the height of the image subresource"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSparseImageMemoryBind-offset-01111",
|
|
"text": " <code>offset.z</code> <strong class=\"purple\">must</strong> be a multiple of the sparse image block depth (<code>VkSparseImageFormatProperties</code>::<code>imageGranularity.depth</code>) of the image"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSparseImageMemoryBind-extent-01112",
|
|
"text": " <code>extent.depth</code> <strong class=\"purple\">must</strong> either be a multiple of the sparse image block depth of the image, or else <span class=\"eq\">(<code>extent.depth</code> + <code>offset.z</code>)</span> <strong class=\"purple\">must</strong> equal the depth of the image subresource"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSparseImageMemoryBind-subresource-parameter",
|
|
"text": " <code>subresource</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageSubresource\">VkImageSubresource</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSparseImageMemoryBind-memory-parameter",
|
|
"text": " If <code>memory</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>memory</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDeviceMemory\">VkDeviceMemory</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSparseImageMemoryBind-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkSparseMemoryBindFlagBits\">VkSparseMemoryBindFlagBits</a> values"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_external_memory)": [
|
|
{
|
|
"vuid": "VUID-VkSparseImageMemoryBind-memory-02732",
|
|
"text": " If <code>memory</code> was created with <a href=\"#VkExportMemoryAllocateInfo\">VkExportMemoryAllocateInfo</a>::<code>handleTypes</code> not equal to <code>0</code>, at least one handle type it contained <strong class=\"purple\">must</strong> also have been set in <a href=\"#VkExternalMemoryImageCreateInfo\">VkExternalMemoryImageCreateInfo</a>::<code>handleTypes</code> when the image was created"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSparseImageMemoryBind-memory-02733",
|
|
"text": " If <code>memory</code> was created by a memory import operation, the external handle type of the imported memory <strong class=\"purple\">must</strong> also have been set in <a href=\"#VkExternalMemoryImageCreateInfo\">VkExternalMemoryImageCreateInfo</a>::<code>handleTypes</code> when <code>image</code> was created"
|
|
}
|
|
]
|
|
},
|
|
"vkQueueBindSparse": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkQueueBindSparse-fence-01113",
|
|
"text": " If <code>fence</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>fence</code> <strong class=\"purple\">must</strong> be unsignaled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkQueueBindSparse-fence-01114",
|
|
"text": " If <code>fence</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>fence</code> <strong class=\"purple\">must</strong> not be associated with any other queue command that has not yet completed execution on that queue"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkQueueBindSparse-pSignalSemaphores-01115",
|
|
"text": " Each element of the <code>pSignalSemaphores</code> member of each element of <code>pBindInfo</code> <strong class=\"purple\">must</strong> be unsignaled when the semaphore signal operation it defines is executed on the device"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkQueueBindSparse-pWaitSemaphores-01116",
|
|
"text": " When a semaphore wait operation referring to a binary semaphore defined by any element of the <code>pWaitSemaphores</code> member of any element of <code>pBindInfo</code> executes on <code>queue</code>, there <strong class=\"purple\">must</strong> be no other queues waiting on the same semaphore"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkQueueBindSparse-pWaitSemaphores-01117",
|
|
"text": " All elements of the <code>pWaitSemaphores</code> member of all elements of the <code>pBindInfo</code> parameter referring to a binary semaphore <strong class=\"purple\">must</strong> be semaphores that are signaled, or have <a href=\"#synchronization-semaphores-signaling\">semaphore signal operations</a> previously submitted for execution"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkQueueBindSparse-queue-parameter",
|
|
"text": " <code>queue</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkQueue\">VkQueue</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkQueueBindSparse-pBindInfo-parameter",
|
|
"text": " If <code>bindInfoCount</code> is not <code>0</code>, <code>pBindInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>bindInfoCount</code> valid <a href=\"#VkBindSparseInfo\">VkBindSparseInfo</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkQueueBindSparse-fence-parameter",
|
|
"text": " If <code>fence</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>fence</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkFence\">VkFence</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkQueueBindSparse-queuetype",
|
|
"text": " The <code>queue</code> <strong class=\"purple\">must</strong> support sparse binding operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkQueueBindSparse-commonparent",
|
|
"text": " Both of <code>fence</code>, and <code>queue</code> that are valid handles of non-ignored parameters <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_timeline_semaphore)": [
|
|
{
|
|
"vuid": "VUID-vkQueueBindSparse-pWaitSemaphores-03245",
|
|
"text": " All elements of the <code>pWaitSemaphores</code> member of all elements of <code>pBindInfo</code> created with a <a href=\"#VkSemaphoreType\">VkSemaphoreType</a> of <code>VK_SEMAPHORE_TYPE_BINARY</code> <strong class=\"purple\">must</strong> reference a semaphore signal operation that has been submitted for execution and any semaphore signal operations on which it depends (if any) <strong class=\"purple\">must</strong> have also been submitted for execution"
|
|
}
|
|
]
|
|
},
|
|
"VkBindSparseInfo": {
|
|
"(VK_VERSION_1_2,VK_KHR_timeline_semaphore)": [
|
|
{
|
|
"vuid": "VUID-VkBindSparseInfo-pWaitSemaphores-03246",
|
|
"text": " If any element of <code>pWaitSemaphores</code> or <code>pSignalSemaphores</code> was created with a <a href=\"#VkSemaphoreType\">VkSemaphoreType</a> of <code>VK_SEMAPHORE_TYPE_TIMELINE</code> then the <code>pNext</code> chain <strong class=\"purple\">must</strong> include a <a href=\"#VkTimelineSemaphoreSubmitInfo\">VkTimelineSemaphoreSubmitInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindSparseInfo-pNext-03247",
|
|
"text": " If the <code>pNext</code> chain of this structure includes a <a href=\"#VkTimelineSemaphoreSubmitInfo\">VkTimelineSemaphoreSubmitInfo</a> structure and any element of <code>pWaitSemaphores</code> was created with a <a href=\"#VkSemaphoreType\">VkSemaphoreType</a> of <code>VK_SEMAPHORE_TYPE_TIMELINE</code> then its <code>waitSemaphoreValueCount</code> member <strong class=\"purple\">must</strong> equal <code>waitSemaphoreCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindSparseInfo-pNext-03248",
|
|
"text": " If the <code>pNext</code> chain of this structure includes a <a href=\"#VkTimelineSemaphoreSubmitInfo\">VkTimelineSemaphoreSubmitInfo</a> structure and any element of <code>pSignalSemaphores</code> was created with a <a href=\"#VkSemaphoreType\">VkSemaphoreType</a> of <code>VK_SEMAPHORE_TYPE_TIMELINE</code> then its <code>signalSemaphoreValueCount</code> member <strong class=\"purple\">must</strong> equal <code>signalSemaphoreCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindSparseInfo-pSignalSemaphores-03249",
|
|
"text": " For each element of <code>pSignalSemaphores</code> created with a <a href=\"#VkSemaphoreType\">VkSemaphoreType</a> of <code>VK_SEMAPHORE_TYPE_TIMELINE</code> the corresponding element of <a href=\"#VkTimelineSemaphoreSubmitInfo\">VkTimelineSemaphoreSubmitInfo</a>::<code>pSignalSemaphoreValues</code> <strong class=\"purple\">must</strong> have a value greater than the current value of the semaphore when the <a href=\"#synchronization-semaphores-signaling\">semaphore signal operation</a> is executed"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindSparseInfo-pWaitSemaphores-03250",
|
|
"text": " For each element of <code>pWaitSemaphores</code> created with a <a href=\"#VkSemaphoreType\">VkSemaphoreType</a> of <code>VK_SEMAPHORE_TYPE_TIMELINE</code> the corresponding element of <a href=\"#VkTimelineSemaphoreSubmitInfo\">VkTimelineSemaphoreSubmitInfo</a>::<code>pWaitSemaphoreValues</code> <strong class=\"purple\">must</strong> have a value which does not differ from the current value of the semaphore or from the value of any outstanding semaphore wait or signal operation on that semaphore by more than <a href=\"#limits-maxTimelineSemaphoreValueDifference\"><code>maxTimelineSemaphoreValueDifference</code></a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindSparseInfo-pSignalSemaphores-03251",
|
|
"text": " For each element of <code>pSignalSemaphores</code> created with a <a href=\"#VkSemaphoreType\">VkSemaphoreType</a> of <code>VK_SEMAPHORE_TYPE_TIMELINE</code> the corresponding element of <a href=\"#VkTimelineSemaphoreSubmitInfo\">VkTimelineSemaphoreSubmitInfo</a>::<code>pSignalSemaphoreValues</code> <strong class=\"purple\">must</strong> have a value which does not differ from the current value of the semaphore or from the value of any outstanding semaphore wait or signal operation on that semaphore by more than <a href=\"#limits-maxTimelineSemaphoreValueDifference\"><code>maxTimelineSemaphoreValueDifference</code></a>"
|
|
}
|
|
],
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-VkBindSparseInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_BIND_SPARSE_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindSparseInfo-pNext-pNext",
|
|
"text": " Each <code>pNext</code> member of any structure (including this one) in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be either <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkDeviceGroupBindSparseInfo\">VkDeviceGroupBindSparseInfo</a> or <a href=\"#VkTimelineSemaphoreSubmitInfo\">VkTimelineSemaphoreSubmitInfo</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindSparseInfo-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindSparseInfo-pWaitSemaphores-parameter",
|
|
"text": " If <code>waitSemaphoreCount</code> is not <code>0</code>, <code>pWaitSemaphores</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>waitSemaphoreCount</code> valid <a href=\"#VkSemaphore\">VkSemaphore</a> handles"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindSparseInfo-pBufferBinds-parameter",
|
|
"text": " If <code>bufferBindCount</code> is not <code>0</code>, <code>pBufferBinds</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>bufferBindCount</code> valid <a href=\"#VkSparseBufferMemoryBindInfo\">VkSparseBufferMemoryBindInfo</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindSparseInfo-pImageOpaqueBinds-parameter",
|
|
"text": " If <code>imageOpaqueBindCount</code> is not <code>0</code>, <code>pImageOpaqueBinds</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>imageOpaqueBindCount</code> valid <a href=\"#VkSparseImageOpaqueMemoryBindInfo\">VkSparseImageOpaqueMemoryBindInfo</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindSparseInfo-pImageBinds-parameter",
|
|
"text": " If <code>imageBindCount</code> is not <code>0</code>, <code>pImageBinds</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>imageBindCount</code> valid <a href=\"#VkSparseImageMemoryBindInfo\">VkSparseImageMemoryBindInfo</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindSparseInfo-pSignalSemaphores-parameter",
|
|
"text": " If <code>signalSemaphoreCount</code> is not <code>0</code>, <code>pSignalSemaphores</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>signalSemaphoreCount</code> valid <a href=\"#VkSemaphore\">VkSemaphore</a> handles"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkBindSparseInfo-commonparent",
|
|
"text": " Both of the elements of <code>pSignalSemaphores</code>, and the elements of <code>pWaitSemaphores</code> that are valid handles of non-ignored parameters <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
]
|
|
},
|
|
"VkDeviceGroupBindSparseInfo": {
|
|
"(VK_VERSION_1_1,VK_KHR_device_group)": [
|
|
{
|
|
"vuid": "VUID-VkDeviceGroupBindSparseInfo-resourceDeviceIndex-01118",
|
|
"text": " <code>resourceDeviceIndex</code> and <code>memoryDeviceIndex</code> <strong class=\"purple\">must</strong> both be valid device indices"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceGroupBindSparseInfo-memoryDeviceIndex-01119",
|
|
"text": " Each memory allocation bound in this batch <strong class=\"purple\">must</strong> have allocated an instance for <code>memoryDeviceIndex</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceGroupBindSparseInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_DEVICE_GROUP_BIND_SPARSE_INFO</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCreateAndroidSurfaceKHR": {
|
|
"(VK_KHR_surface)+(VK_KHR_android_surface)": [
|
|
{
|
|
"vuid": "VUID-vkCreateAndroidSurfaceKHR-instance-parameter",
|
|
"text": " <code>instance</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkInstance\">VkInstance</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateAndroidSurfaceKHR-pCreateInfo-parameter",
|
|
"text": " <code>pCreateInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAndroidSurfaceCreateInfoKHR\">VkAndroidSurfaceCreateInfoKHR</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateAndroidSurfaceKHR-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateAndroidSurfaceKHR-pSurface-parameter",
|
|
"text": " <code>pSurface</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkSurfaceKHR\">VkSurfaceKHR</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkAndroidSurfaceCreateInfoKHR": {
|
|
"(VK_KHR_surface)+(VK_KHR_android_surface)": [
|
|
{
|
|
"vuid": "VUID-VkAndroidSurfaceCreateInfoKHR-window-01248",
|
|
"text": " <code>window</code> <strong class=\"purple\">must</strong> point to a valid Android <code>ANativeWindow</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAndroidSurfaceCreateInfoKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_ANDROID_SURFACE_CREATE_INFO_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAndroidSurfaceCreateInfoKHR-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAndroidSurfaceCreateInfoKHR-flags-zerobitmask",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCreateWaylandSurfaceKHR": {
|
|
"(VK_KHR_surface)+(VK_KHR_wayland_surface)": [
|
|
{
|
|
"vuid": "VUID-vkCreateWaylandSurfaceKHR-instance-parameter",
|
|
"text": " <code>instance</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkInstance\">VkInstance</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateWaylandSurfaceKHR-pCreateInfo-parameter",
|
|
"text": " <code>pCreateInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkWaylandSurfaceCreateInfoKHR\">VkWaylandSurfaceCreateInfoKHR</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateWaylandSurfaceKHR-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateWaylandSurfaceKHR-pSurface-parameter",
|
|
"text": " <code>pSurface</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkSurfaceKHR\">VkSurfaceKHR</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkWaylandSurfaceCreateInfoKHR": {
|
|
"(VK_KHR_surface)+(VK_KHR_wayland_surface)": [
|
|
{
|
|
"vuid": "VUID-VkWaylandSurfaceCreateInfoKHR-display-01304",
|
|
"text": " <code>display</code> <strong class=\"purple\">must</strong> point to a valid Wayland <code>wl_display</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWaylandSurfaceCreateInfoKHR-surface-01305",
|
|
"text": " <code>surface</code> <strong class=\"purple\">must</strong> point to a valid Wayland <code>wl_surface</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWaylandSurfaceCreateInfoKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_WAYLAND_SURFACE_CREATE_INFO_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWaylandSurfaceCreateInfoKHR-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWaylandSurfaceCreateInfoKHR-flags-zerobitmask",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCreateWin32SurfaceKHR": {
|
|
"(VK_KHR_surface)+(VK_KHR_win32_surface)": [
|
|
{
|
|
"vuid": "VUID-vkCreateWin32SurfaceKHR-instance-parameter",
|
|
"text": " <code>instance</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkInstance\">VkInstance</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateWin32SurfaceKHR-pCreateInfo-parameter",
|
|
"text": " <code>pCreateInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkWin32SurfaceCreateInfoKHR\">VkWin32SurfaceCreateInfoKHR</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateWin32SurfaceKHR-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateWin32SurfaceKHR-pSurface-parameter",
|
|
"text": " <code>pSurface</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkSurfaceKHR\">VkSurfaceKHR</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkWin32SurfaceCreateInfoKHR": {
|
|
"(VK_KHR_surface)+(VK_KHR_win32_surface)": [
|
|
{
|
|
"vuid": "VUID-VkWin32SurfaceCreateInfoKHR-hinstance-01307",
|
|
"text": " <code>hinstance</code> <strong class=\"purple\">must</strong> be a valid Win32 <code>HINSTANCE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWin32SurfaceCreateInfoKHR-hwnd-01308",
|
|
"text": " <code>hwnd</code> <strong class=\"purple\">must</strong> be a valid Win32 <code>HWND</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWin32SurfaceCreateInfoKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_WIN32_SURFACE_CREATE_INFO_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWin32SurfaceCreateInfoKHR-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkWin32SurfaceCreateInfoKHR-flags-zerobitmask",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCreateXcbSurfaceKHR": {
|
|
"(VK_KHR_surface)+(VK_KHR_xcb_surface)": [
|
|
{
|
|
"vuid": "VUID-vkCreateXcbSurfaceKHR-instance-parameter",
|
|
"text": " <code>instance</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkInstance\">VkInstance</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateXcbSurfaceKHR-pCreateInfo-parameter",
|
|
"text": " <code>pCreateInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkXcbSurfaceCreateInfoKHR\">VkXcbSurfaceCreateInfoKHR</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateXcbSurfaceKHR-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateXcbSurfaceKHR-pSurface-parameter",
|
|
"text": " <code>pSurface</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkSurfaceKHR\">VkSurfaceKHR</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkXcbSurfaceCreateInfoKHR": {
|
|
"(VK_KHR_surface)+(VK_KHR_xcb_surface)": [
|
|
{
|
|
"vuid": "VUID-VkXcbSurfaceCreateInfoKHR-connection-01310",
|
|
"text": " <code>connection</code> <strong class=\"purple\">must</strong> point to a valid X11 <code>xcb_connection_t</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkXcbSurfaceCreateInfoKHR-window-01311",
|
|
"text": " <code>window</code> <strong class=\"purple\">must</strong> be a valid X11 <code>xcb_window_t</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkXcbSurfaceCreateInfoKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_XCB_SURFACE_CREATE_INFO_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkXcbSurfaceCreateInfoKHR-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkXcbSurfaceCreateInfoKHR-flags-zerobitmask",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCreateXlibSurfaceKHR": {
|
|
"(VK_KHR_surface)+(VK_KHR_xlib_surface)": [
|
|
{
|
|
"vuid": "VUID-vkCreateXlibSurfaceKHR-instance-parameter",
|
|
"text": " <code>instance</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkInstance\">VkInstance</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateXlibSurfaceKHR-pCreateInfo-parameter",
|
|
"text": " <code>pCreateInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkXlibSurfaceCreateInfoKHR\">VkXlibSurfaceCreateInfoKHR</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateXlibSurfaceKHR-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateXlibSurfaceKHR-pSurface-parameter",
|
|
"text": " <code>pSurface</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkSurfaceKHR\">VkSurfaceKHR</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkXlibSurfaceCreateInfoKHR": {
|
|
"(VK_KHR_surface)+(VK_KHR_xlib_surface)": [
|
|
{
|
|
"vuid": "VUID-VkXlibSurfaceCreateInfoKHR-dpy-01313",
|
|
"text": " <code>dpy</code> <strong class=\"purple\">must</strong> point to a valid Xlib <code>Display</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkXlibSurfaceCreateInfoKHR-window-01314",
|
|
"text": " <code>window</code> <strong class=\"purple\">must</strong> be a valid Xlib <code>Window</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkXlibSurfaceCreateInfoKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_XLIB_SURFACE_CREATE_INFO_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkXlibSurfaceCreateInfoKHR-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkXlibSurfaceCreateInfoKHR-flags-zerobitmask",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCreateDirectFBSurfaceEXT": {
|
|
"(VK_KHR_surface)+(VK_EXT_directfb_surface)": [
|
|
{
|
|
"vuid": "VUID-vkCreateDirectFBSurfaceEXT-instance-parameter",
|
|
"text": " <code>instance</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkInstance\">VkInstance</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateDirectFBSurfaceEXT-pCreateInfo-parameter",
|
|
"text": " <code>pCreateInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkDirectFBSurfaceCreateInfoEXT\">VkDirectFBSurfaceCreateInfoEXT</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateDirectFBSurfaceEXT-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateDirectFBSurfaceEXT-pSurface-parameter",
|
|
"text": " <code>pSurface</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkSurfaceKHR\">VkSurfaceKHR</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkDirectFBSurfaceCreateInfoEXT": {
|
|
"(VK_KHR_surface)+(VK_EXT_directfb_surface)": [
|
|
{
|
|
"vuid": "VUID-VkDirectFBSurfaceCreateInfoEXT-dfb-04117",
|
|
"text": " <code>dfb</code> <strong class=\"purple\">must</strong> point to a valid DirectFB <code>IDirectFB</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDirectFBSurfaceCreateInfoEXT-surface-04118",
|
|
"text": " <code>surface</code> <strong class=\"purple\">must</strong> point to a valid DirectFB <code>IDirectFBSurface</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDirectFBSurfaceCreateInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_DIRECTFB_SURFACE_CREATE_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDirectFBSurfaceCreateInfoEXT-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDirectFBSurfaceCreateInfoEXT-flags-zerobitmask",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCreateImagePipeSurfaceFUCHSIA": {
|
|
"(VK_KHR_surface)+(VK_FUCHSIA_imagepipe_surface)": [
|
|
{
|
|
"vuid": "VUID-vkCreateImagePipeSurfaceFUCHSIA-instance-parameter",
|
|
"text": " <code>instance</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkInstance\">VkInstance</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateImagePipeSurfaceFUCHSIA-pCreateInfo-parameter",
|
|
"text": " <code>pCreateInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkImagePipeSurfaceCreateInfoFUCHSIA\">VkImagePipeSurfaceCreateInfoFUCHSIA</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateImagePipeSurfaceFUCHSIA-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateImagePipeSurfaceFUCHSIA-pSurface-parameter",
|
|
"text": " <code>pSurface</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkSurfaceKHR\">VkSurfaceKHR</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkImagePipeSurfaceCreateInfoFUCHSIA": {
|
|
"(VK_KHR_surface)+(VK_FUCHSIA_imagepipe_surface)": [
|
|
{
|
|
"vuid": "VUID-VkImagePipeSurfaceCreateInfoFUCHSIA-imagePipeHandle-04863",
|
|
"text": " <code>imagePipeHandle</code> <strong class=\"purple\">must</strong> be a valid <code>zx_handle_t</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImagePipeSurfaceCreateInfoFUCHSIA-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_IMAGEPIPE_SURFACE_CREATE_INFO_FUCHSIA</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImagePipeSurfaceCreateInfoFUCHSIA-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImagePipeSurfaceCreateInfoFUCHSIA-flags-zerobitmask",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCreateStreamDescriptorSurfaceGGP": {
|
|
"(VK_KHR_surface)+(VK_GGP_stream_descriptor_surface)": [
|
|
{
|
|
"vuid": "VUID-vkCreateStreamDescriptorSurfaceGGP-instance-parameter",
|
|
"text": " <code>instance</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkInstance\">VkInstance</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateStreamDescriptorSurfaceGGP-pCreateInfo-parameter",
|
|
"text": " <code>pCreateInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkStreamDescriptorSurfaceCreateInfoGGP\">VkStreamDescriptorSurfaceCreateInfoGGP</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateStreamDescriptorSurfaceGGP-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateStreamDescriptorSurfaceGGP-pSurface-parameter",
|
|
"text": " <code>pSurface</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkSurfaceKHR\">VkSurfaceKHR</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkStreamDescriptorSurfaceCreateInfoGGP": {
|
|
"(VK_KHR_surface)+(VK_GGP_stream_descriptor_surface)": [
|
|
{
|
|
"vuid": "VUID-VkStreamDescriptorSurfaceCreateInfoGGP-streamDescriptor-02681",
|
|
"text": " <code>streamDescriptor</code> <strong class=\"purple\">must</strong> be a valid <code>GgpStreamDescriptor</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkStreamDescriptorSurfaceCreateInfoGGP-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_STREAM_DESCRIPTOR_SURFACE_CREATE_INFO_GGP</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkStreamDescriptorSurfaceCreateInfoGGP-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkStreamDescriptorSurfaceCreateInfoGGP-flags-zerobitmask",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCreateIOSSurfaceMVK": {
|
|
"(VK_KHR_surface)+(VK_MVK_ios_surface)": [
|
|
{
|
|
"vuid": "VUID-vkCreateIOSSurfaceMVK-instance-parameter",
|
|
"text": " <code>instance</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkInstance\">VkInstance</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateIOSSurfaceMVK-pCreateInfo-parameter",
|
|
"text": " <code>pCreateInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkIOSSurfaceCreateInfoMVK\">VkIOSSurfaceCreateInfoMVK</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateIOSSurfaceMVK-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateIOSSurfaceMVK-pSurface-parameter",
|
|
"text": " <code>pSurface</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkSurfaceKHR\">VkSurfaceKHR</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkIOSSurfaceCreateInfoMVK": {
|
|
"(VK_KHR_surface)+(VK_MVK_ios_surface)": [
|
|
{
|
|
"vuid": "VUID-VkIOSSurfaceCreateInfoMVK-pView-04143",
|
|
"text": " If <code>pView</code> is a <code>CAMetalLayer</code> object, it <strong class=\"purple\">must</strong> be a valid <code>CAMetalLayer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkIOSSurfaceCreateInfoMVK-pView-01316",
|
|
"text": " If <code>pView</code> is a <code>UIView</code> object, it <strong class=\"purple\">must</strong> be a valid <code>UIView</code>, <strong class=\"purple\">must</strong> be backed by a <code>CALayer</code> object of type <code>CAMetalLayer</code>, and <a href=\"#vkCreateIOSSurfaceMVK\">vkCreateIOSSurfaceMVK</a> <strong class=\"purple\">must</strong> be called on the main thread"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkIOSSurfaceCreateInfoMVK-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_IOS_SURFACE_CREATE_INFO_MVK</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkIOSSurfaceCreateInfoMVK-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkIOSSurfaceCreateInfoMVK-flags-zerobitmask",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCreateMacOSSurfaceMVK": {
|
|
"(VK_KHR_surface)+(VK_MVK_macos_surface)": [
|
|
{
|
|
"vuid": "VUID-vkCreateMacOSSurfaceMVK-instance-parameter",
|
|
"text": " <code>instance</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkInstance\">VkInstance</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateMacOSSurfaceMVK-pCreateInfo-parameter",
|
|
"text": " <code>pCreateInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkMacOSSurfaceCreateInfoMVK\">VkMacOSSurfaceCreateInfoMVK</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateMacOSSurfaceMVK-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateMacOSSurfaceMVK-pSurface-parameter",
|
|
"text": " <code>pSurface</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkSurfaceKHR\">VkSurfaceKHR</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkMacOSSurfaceCreateInfoMVK": {
|
|
"(VK_KHR_surface)+(VK_MVK_macos_surface)": [
|
|
{
|
|
"vuid": "VUID-VkMacOSSurfaceCreateInfoMVK-pView-04144",
|
|
"text": " If <code>pView</code> is a <code>CAMetalLayer</code> object, it <strong class=\"purple\">must</strong> be a valid <code>CAMetalLayer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMacOSSurfaceCreateInfoMVK-pView-01317",
|
|
"text": " If <code>pView</code> is an <code>NSView</code> object, it <strong class=\"purple\">must</strong> be a valid <code>NSView</code>, <strong class=\"purple\">must</strong> be backed by a <code>CALayer</code> object of type <code>CAMetalLayer</code>, and <a href=\"#vkCreateMacOSSurfaceMVK\">vkCreateMacOSSurfaceMVK</a> <strong class=\"purple\">must</strong> be called on the main thread"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMacOSSurfaceCreateInfoMVK-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_MACOS_SURFACE_CREATE_INFO_MVK</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMacOSSurfaceCreateInfoMVK-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMacOSSurfaceCreateInfoMVK-flags-zerobitmask",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCreateViSurfaceNN": {
|
|
"(VK_KHR_surface)+(VK_NN_vi_surface)": [
|
|
{
|
|
"vuid": "VUID-vkCreateViSurfaceNN-instance-parameter",
|
|
"text": " <code>instance</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkInstance\">VkInstance</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateViSurfaceNN-pCreateInfo-parameter",
|
|
"text": " <code>pCreateInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkViSurfaceCreateInfoNN\">VkViSurfaceCreateInfoNN</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateViSurfaceNN-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateViSurfaceNN-pSurface-parameter",
|
|
"text": " <code>pSurface</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkSurfaceKHR\">VkSurfaceKHR</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkViSurfaceCreateInfoNN": {
|
|
"(VK_KHR_surface)+(VK_NN_vi_surface)": [
|
|
{
|
|
"vuid": "VUID-VkViSurfaceCreateInfoNN-window-01318",
|
|
"text": " <code>window</code> <strong class=\"purple\">must</strong> be a valid <code>nn</code>::<code>vi</code>::<code>NativeWindowHandle</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkViSurfaceCreateInfoNN-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_VI_SURFACE_CREATE_INFO_NN</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkViSurfaceCreateInfoNN-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkViSurfaceCreateInfoNN-flags-zerobitmask",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCreateMetalSurfaceEXT": {
|
|
"(VK_KHR_surface)+(VK_EXT_metal_surface)": [
|
|
{
|
|
"vuid": "VUID-vkCreateMetalSurfaceEXT-instance-parameter",
|
|
"text": " <code>instance</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkInstance\">VkInstance</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateMetalSurfaceEXT-pCreateInfo-parameter",
|
|
"text": " <code>pCreateInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkMetalSurfaceCreateInfoEXT\">VkMetalSurfaceCreateInfoEXT</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateMetalSurfaceEXT-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateMetalSurfaceEXT-pSurface-parameter",
|
|
"text": " <code>pSurface</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkSurfaceKHR\">VkSurfaceKHR</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkMetalSurfaceCreateInfoEXT": {
|
|
"(VK_KHR_surface)+(VK_EXT_metal_surface)": [
|
|
{
|
|
"vuid": "VUID-VkMetalSurfaceCreateInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_METAL_SURFACE_CREATE_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMetalSurfaceCreateInfoEXT-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMetalSurfaceCreateInfoEXT-flags-zerobitmask",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCreateScreenSurfaceQNX": {
|
|
"(VK_KHR_surface)+(VK_QNX_screen_surface)": [
|
|
{
|
|
"vuid": "VUID-vkCreateScreenSurfaceQNX-instance-parameter",
|
|
"text": " <code>instance</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkInstance\">VkInstance</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateScreenSurfaceQNX-pCreateInfo-parameter",
|
|
"text": " <code>pCreateInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkScreenSurfaceCreateInfoQNX\">VkScreenSurfaceCreateInfoQNX</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateScreenSurfaceQNX-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateScreenSurfaceQNX-pSurface-parameter",
|
|
"text": " <code>pSurface</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkSurfaceKHR\">VkSurfaceKHR</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkScreenSurfaceCreateInfoQNX": {
|
|
"(VK_KHR_surface)+(VK_QNX_screen_surface)": [
|
|
{
|
|
"vuid": "VUID-VkScreenSurfaceCreateInfoQNX-context-04741",
|
|
"text": " <code>context</code> <strong class=\"purple\">must</strong> point to a valid QNX Screen <code>struct</code> _screen_context"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkScreenSurfaceCreateInfoQNX-window-04742",
|
|
"text": " <code>window</code> <strong class=\"purple\">must</strong> point to a valid QNX Screen <code>struct</code> _screen_window"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkScreenSurfaceCreateInfoQNX-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_SCREEN_SURFACE_CREATE_INFO_QNX</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkScreenSurfaceCreateInfoQNX-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkScreenSurfaceCreateInfoQNX-flags-zerobitmask",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkDestroySurfaceKHR": {
|
|
"(VK_KHR_surface)": [
|
|
{
|
|
"vuid": "VUID-vkDestroySurfaceKHR-surface-01266",
|
|
"text": " All <code>VkSwapchainKHR</code> objects created for <code>surface</code> <strong class=\"purple\">must</strong> have been destroyed prior to destroying <code>surface</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroySurfaceKHR-surface-01267",
|
|
"text": " If <code>VkAllocationCallbacks</code> were provided when <code>surface</code> was created, a compatible set of callbacks <strong class=\"purple\">must</strong> be provided here"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroySurfaceKHR-surface-01268",
|
|
"text": " If no <code>VkAllocationCallbacks</code> were provided when <code>surface</code> was created, <code>pAllocator</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroySurfaceKHR-instance-parameter",
|
|
"text": " <code>instance</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkInstance\">VkInstance</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroySurfaceKHR-surface-parameter",
|
|
"text": " If <code>surface</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>surface</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSurfaceKHR\">VkSurfaceKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroySurfaceKHR-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroySurfaceKHR-surface-parent",
|
|
"text": " If <code>surface</code> is a valid handle, it <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>instance</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetPhysicalDeviceDisplayPropertiesKHR": {
|
|
"(VK_KHR_surface)+(VK_KHR_display)": [
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceDisplayPropertiesKHR-physicalDevice-parameter",
|
|
"text": " <code>physicalDevice</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceDisplayPropertiesKHR-pPropertyCount-parameter",
|
|
"text": " <code>pPropertyCount</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>uint32_t</code> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceDisplayPropertiesKHR-pProperties-parameter",
|
|
"text": " If the value referenced by <code>pPropertyCount</code> is not <code>0</code>, and <code>pProperties</code> is not <code>NULL</code>, <code>pProperties</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>pPropertyCount</code> <a href=\"#VkDisplayPropertiesKHR\">VkDisplayPropertiesKHR</a> structures"
|
|
}
|
|
]
|
|
},
|
|
"vkGetPhysicalDeviceDisplayProperties2KHR": {
|
|
"(VK_KHR_surface)+(VK_KHR_display)+(VK_KHR_get_display_properties2)": [
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceDisplayProperties2KHR-physicalDevice-parameter",
|
|
"text": " <code>physicalDevice</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceDisplayProperties2KHR-pPropertyCount-parameter",
|
|
"text": " <code>pPropertyCount</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>uint32_t</code> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceDisplayProperties2KHR-pProperties-parameter",
|
|
"text": " If the value referenced by <code>pPropertyCount</code> is not <code>0</code>, and <code>pProperties</code> is not <code>NULL</code>, <code>pProperties</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>pPropertyCount</code> <a href=\"#VkDisplayProperties2KHR\">VkDisplayProperties2KHR</a> structures"
|
|
}
|
|
]
|
|
},
|
|
"VkDisplayProperties2KHR": {
|
|
"(VK_KHR_surface)+(VK_KHR_display)+(VK_KHR_get_display_properties2)": [
|
|
{
|
|
"vuid": "VUID-VkDisplayProperties2KHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_DISPLAY_PROPERTIES_2_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDisplayProperties2KHR-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkAcquireXlibDisplayEXT": {
|
|
"(VK_KHR_surface)+(VK_KHR_display)+(VK_EXT_direct_mode_display)+(VK_EXT_acquire_xlib_display)": [
|
|
{
|
|
"vuid": "VUID-vkAcquireXlibDisplayEXT-physicalDevice-parameter",
|
|
"text": " <code>physicalDevice</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkAcquireXlibDisplayEXT-dpy-parameter",
|
|
"text": " <code>dpy</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>Display</code> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkAcquireXlibDisplayEXT-display-parameter",
|
|
"text": " <code>display</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDisplayKHR\">VkDisplayKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkAcquireXlibDisplayEXT-display-parent",
|
|
"text": " <code>display</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>physicalDevice</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetRandROutputDisplayEXT": {
|
|
"(VK_KHR_surface)+(VK_KHR_display)+(VK_EXT_direct_mode_display)+(VK_EXT_acquire_xlib_display)": [
|
|
{
|
|
"vuid": "VUID-vkGetRandROutputDisplayEXT-physicalDevice-parameter",
|
|
"text": " <code>physicalDevice</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetRandROutputDisplayEXT-dpy-parameter",
|
|
"text": " <code>dpy</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>Display</code> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetRandROutputDisplayEXT-pDisplay-parameter",
|
|
"text": " <code>pDisplay</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkDisplayKHR\">VkDisplayKHR</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"vkAcquireWinrtDisplayNV": {
|
|
"(VK_KHR_surface)+(VK_KHR_display)+(VK_EXT_direct_mode_display)+(VK_NV_acquire_winrt_display)": [
|
|
{
|
|
"vuid": "VUID-vkAcquireWinrtDisplayNV-physicalDevice-parameter",
|
|
"text": " <code>physicalDevice</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkAcquireWinrtDisplayNV-display-parameter",
|
|
"text": " <code>display</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDisplayKHR\">VkDisplayKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkAcquireWinrtDisplayNV-display-parent",
|
|
"text": " <code>display</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>physicalDevice</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetWinrtDisplayNV": {
|
|
"(VK_KHR_surface)+(VK_KHR_display)+(VK_EXT_direct_mode_display)+(VK_NV_acquire_winrt_display)": [
|
|
{
|
|
"vuid": "VUID-vkGetWinrtDisplayNV-physicalDevice-parameter",
|
|
"text": " <code>physicalDevice</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetWinrtDisplayNV-pDisplay-parameter",
|
|
"text": " <code>pDisplay</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkDisplayKHR\">VkDisplayKHR</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"vkAcquireDrmDisplayEXT": {
|
|
"(VK_KHR_surface)+(VK_KHR_display)+(VK_EXT_direct_mode_display)+(VK_EXT_acquire_drm_display)": [
|
|
{
|
|
"vuid": "VUID-vkAcquireDrmDisplayEXT-physicalDevice-parameter",
|
|
"text": " <code>physicalDevice</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkAcquireDrmDisplayEXT-display-parameter",
|
|
"text": " <code>display</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDisplayKHR\">VkDisplayKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkAcquireDrmDisplayEXT-display-parent",
|
|
"text": " <code>display</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>physicalDevice</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetDrmDisplayEXT": {
|
|
"(VK_KHR_surface)+(VK_KHR_display)+(VK_EXT_direct_mode_display)+(VK_EXT_acquire_drm_display)": [
|
|
{
|
|
"vuid": "VUID-vkGetDrmDisplayEXT-physicalDevice-parameter",
|
|
"text": " <code>physicalDevice</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDrmDisplayEXT-display-parameter",
|
|
"text": " <code>display</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkDisplayKHR\">VkDisplayKHR</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"vkReleaseDisplayEXT": {
|
|
"(VK_KHR_surface)+(VK_KHR_display)+(VK_EXT_direct_mode_display)": [
|
|
{
|
|
"vuid": "VUID-vkReleaseDisplayEXT-physicalDevice-parameter",
|
|
"text": " <code>physicalDevice</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkReleaseDisplayEXT-display-parameter",
|
|
"text": " <code>display</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDisplayKHR\">VkDisplayKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkReleaseDisplayEXT-display-parent",
|
|
"text": " <code>display</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>physicalDevice</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetPhysicalDeviceDisplayPlanePropertiesKHR": {
|
|
"(VK_KHR_surface)+(VK_KHR_display)": [
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceDisplayPlanePropertiesKHR-physicalDevice-parameter",
|
|
"text": " <code>physicalDevice</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceDisplayPlanePropertiesKHR-pPropertyCount-parameter",
|
|
"text": " <code>pPropertyCount</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>uint32_t</code> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceDisplayPlanePropertiesKHR-pProperties-parameter",
|
|
"text": " If the value referenced by <code>pPropertyCount</code> is not <code>0</code>, and <code>pProperties</code> is not <code>NULL</code>, <code>pProperties</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>pPropertyCount</code> <a href=\"#VkDisplayPlanePropertiesKHR\">VkDisplayPlanePropertiesKHR</a> structures"
|
|
}
|
|
]
|
|
},
|
|
"vkGetPhysicalDeviceDisplayPlaneProperties2KHR": {
|
|
"(VK_KHR_surface)+(VK_KHR_display)+(VK_KHR_get_display_properties2)": [
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceDisplayPlaneProperties2KHR-physicalDevice-parameter",
|
|
"text": " <code>physicalDevice</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceDisplayPlaneProperties2KHR-pPropertyCount-parameter",
|
|
"text": " <code>pPropertyCount</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>uint32_t</code> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceDisplayPlaneProperties2KHR-pProperties-parameter",
|
|
"text": " If the value referenced by <code>pPropertyCount</code> is not <code>0</code>, and <code>pProperties</code> is not <code>NULL</code>, <code>pProperties</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>pPropertyCount</code> <a href=\"#VkDisplayPlaneProperties2KHR\">VkDisplayPlaneProperties2KHR</a> structures"
|
|
}
|
|
]
|
|
},
|
|
"VkDisplayPlaneProperties2KHR": {
|
|
"(VK_KHR_surface)+(VK_KHR_display)+(VK_KHR_get_display_properties2)": [
|
|
{
|
|
"vuid": "VUID-VkDisplayPlaneProperties2KHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_DISPLAY_PLANE_PROPERTIES_2_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDisplayPlaneProperties2KHR-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetDisplayPlaneSupportedDisplaysKHR": {
|
|
"(VK_KHR_surface)+(VK_KHR_display)": [
|
|
{
|
|
"vuid": "VUID-vkGetDisplayPlaneSupportedDisplaysKHR-planeIndex-01249",
|
|
"text": " <code>planeIndex</code> <strong class=\"purple\">must</strong> be less than the number of display planes supported by the device as determined by calling <code>vkGetPhysicalDeviceDisplayPlanePropertiesKHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDisplayPlaneSupportedDisplaysKHR-physicalDevice-parameter",
|
|
"text": " <code>physicalDevice</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDisplayPlaneSupportedDisplaysKHR-pDisplayCount-parameter",
|
|
"text": " <code>pDisplayCount</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>uint32_t</code> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDisplayPlaneSupportedDisplaysKHR-pDisplays-parameter",
|
|
"text": " If the value referenced by <code>pDisplayCount</code> is not <code>0</code>, and <code>pDisplays</code> is not <code>NULL</code>, <code>pDisplays</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>pDisplayCount</code> <a href=\"#VkDisplayKHR\">VkDisplayKHR</a> handles"
|
|
}
|
|
]
|
|
},
|
|
"vkGetDisplayModePropertiesKHR": {
|
|
"(VK_KHR_surface)+(VK_KHR_display)": [
|
|
{
|
|
"vuid": "VUID-vkGetDisplayModePropertiesKHR-physicalDevice-parameter",
|
|
"text": " <code>physicalDevice</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDisplayModePropertiesKHR-display-parameter",
|
|
"text": " <code>display</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDisplayKHR\">VkDisplayKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDisplayModePropertiesKHR-pPropertyCount-parameter",
|
|
"text": " <code>pPropertyCount</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>uint32_t</code> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDisplayModePropertiesKHR-pProperties-parameter",
|
|
"text": " If the value referenced by <code>pPropertyCount</code> is not <code>0</code>, and <code>pProperties</code> is not <code>NULL</code>, <code>pProperties</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>pPropertyCount</code> <a href=\"#VkDisplayModePropertiesKHR\">VkDisplayModePropertiesKHR</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDisplayModePropertiesKHR-display-parent",
|
|
"text": " <code>display</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>physicalDevice</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetDisplayModeProperties2KHR": {
|
|
"(VK_KHR_surface)+(VK_KHR_display)+(VK_KHR_get_display_properties2)": [
|
|
{
|
|
"vuid": "VUID-vkGetDisplayModeProperties2KHR-physicalDevice-parameter",
|
|
"text": " <code>physicalDevice</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDisplayModeProperties2KHR-display-parameter",
|
|
"text": " <code>display</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDisplayKHR\">VkDisplayKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDisplayModeProperties2KHR-pPropertyCount-parameter",
|
|
"text": " <code>pPropertyCount</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>uint32_t</code> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDisplayModeProperties2KHR-pProperties-parameter",
|
|
"text": " If the value referenced by <code>pPropertyCount</code> is not <code>0</code>, and <code>pProperties</code> is not <code>NULL</code>, <code>pProperties</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>pPropertyCount</code> <a href=\"#VkDisplayModeProperties2KHR\">VkDisplayModeProperties2KHR</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDisplayModeProperties2KHR-display-parent",
|
|
"text": " <code>display</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>physicalDevice</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkDisplayModeProperties2KHR": {
|
|
"(VK_KHR_surface)+(VK_KHR_display)+(VK_KHR_get_display_properties2)": [
|
|
{
|
|
"vuid": "VUID-VkDisplayModeProperties2KHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_DISPLAY_MODE_PROPERTIES_2_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDisplayModeProperties2KHR-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkDisplayModeParametersKHR": {
|
|
"(VK_KHR_surface)+(VK_KHR_display)": [
|
|
{
|
|
"vuid": "VUID-VkDisplayModeParametersKHR-width-01990",
|
|
"text": " The <code>width</code> member of <code>visibleRegion</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDisplayModeParametersKHR-height-01991",
|
|
"text": " The <code>height</code> member of <code>visibleRegion</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDisplayModeParametersKHR-refreshRate-01992",
|
|
"text": " <code>refreshRate</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCreateDisplayModeKHR": {
|
|
"(VK_KHR_surface)+(VK_KHR_display)": [
|
|
{
|
|
"vuid": "VUID-vkCreateDisplayModeKHR-physicalDevice-parameter",
|
|
"text": " <code>physicalDevice</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateDisplayModeKHR-display-parameter",
|
|
"text": " <code>display</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDisplayKHR\">VkDisplayKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateDisplayModeKHR-pCreateInfo-parameter",
|
|
"text": " <code>pCreateInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkDisplayModeCreateInfoKHR\">VkDisplayModeCreateInfoKHR</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateDisplayModeKHR-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateDisplayModeKHR-pMode-parameter",
|
|
"text": " <code>pMode</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkDisplayModeKHR\">VkDisplayModeKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateDisplayModeKHR-display-parent",
|
|
"text": " <code>display</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>physicalDevice</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkDisplayModeCreateInfoKHR": {
|
|
"(VK_KHR_surface)+(VK_KHR_display)": [
|
|
{
|
|
"vuid": "VUID-VkDisplayModeCreateInfoKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_DISPLAY_MODE_CREATE_INFO_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDisplayModeCreateInfoKHR-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDisplayModeCreateInfoKHR-flags-zerobitmask",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDisplayModeCreateInfoKHR-parameters-parameter",
|
|
"text": " <code>parameters</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDisplayModeParametersKHR\">VkDisplayModeParametersKHR</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"vkGetDisplayPlaneCapabilitiesKHR": {
|
|
"(VK_KHR_surface)+(VK_KHR_display)": [
|
|
{
|
|
"vuid": "VUID-vkGetDisplayPlaneCapabilitiesKHR-physicalDevice-parameter",
|
|
"text": " <code>physicalDevice</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDisplayPlaneCapabilitiesKHR-mode-parameter",
|
|
"text": " <code>mode</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDisplayModeKHR\">VkDisplayModeKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDisplayPlaneCapabilitiesKHR-pCapabilities-parameter",
|
|
"text": " <code>pCapabilities</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkDisplayPlaneCapabilitiesKHR\">VkDisplayPlaneCapabilitiesKHR</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"vkGetDisplayPlaneCapabilities2KHR": {
|
|
"(VK_KHR_surface)+(VK_KHR_display)+(VK_KHR_get_display_properties2)": [
|
|
{
|
|
"vuid": "VUID-vkGetDisplayPlaneCapabilities2KHR-physicalDevice-parameter",
|
|
"text": " <code>physicalDevice</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDisplayPlaneCapabilities2KHR-pDisplayPlaneInfo-parameter",
|
|
"text": " <code>pDisplayPlaneInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkDisplayPlaneInfo2KHR\">VkDisplayPlaneInfo2KHR</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDisplayPlaneCapabilities2KHR-pCapabilities-parameter",
|
|
"text": " <code>pCapabilities</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkDisplayPlaneCapabilities2KHR\">VkDisplayPlaneCapabilities2KHR</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkDisplayPlaneInfo2KHR": {
|
|
"(VK_KHR_surface)+(VK_KHR_display)+(VK_KHR_get_display_properties2)": [
|
|
{
|
|
"vuid": "VUID-VkDisplayPlaneInfo2KHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_DISPLAY_PLANE_INFO_2_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDisplayPlaneInfo2KHR-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDisplayPlaneInfo2KHR-mode-parameter",
|
|
"text": " <code>mode</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDisplayModeKHR\">VkDisplayModeKHR</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkDisplayPlaneCapabilities2KHR": {
|
|
"(VK_KHR_surface)+(VK_KHR_display)+(VK_KHR_get_display_properties2)": [
|
|
{
|
|
"vuid": "VUID-VkDisplayPlaneCapabilities2KHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_DISPLAY_PLANE_CAPABILITIES_2_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDisplayPlaneCapabilities2KHR-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkDisplayPowerControlEXT": {
|
|
"(VK_KHR_surface)+(VK_KHR_display)+(VK_EXT_display_control)": [
|
|
{
|
|
"vuid": "VUID-vkDisplayPowerControlEXT-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDisplayPowerControlEXT-display-parameter",
|
|
"text": " <code>display</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDisplayKHR\">VkDisplayKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDisplayPowerControlEXT-pDisplayPowerInfo-parameter",
|
|
"text": " <code>pDisplayPowerInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkDisplayPowerInfoEXT\">VkDisplayPowerInfoEXT</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDisplayPowerControlEXT-commonparent",
|
|
"text": " Both of <code>device</code>, and <code>display</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a>"
|
|
}
|
|
]
|
|
},
|
|
"VkDisplayPowerInfoEXT": {
|
|
"(VK_KHR_surface)+(VK_KHR_display)+(VK_EXT_display_control)": [
|
|
{
|
|
"vuid": "VUID-VkDisplayPowerInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_DISPLAY_POWER_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDisplayPowerInfoEXT-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDisplayPowerInfoEXT-powerState-parameter",
|
|
"text": " <code>powerState</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDisplayPowerStateEXT\">VkDisplayPowerStateEXT</a> value"
|
|
}
|
|
]
|
|
},
|
|
"vkCreateDisplayPlaneSurfaceKHR": {
|
|
"(VK_KHR_surface)+(VK_KHR_display)": [
|
|
{
|
|
"vuid": "VUID-vkCreateDisplayPlaneSurfaceKHR-instance-parameter",
|
|
"text": " <code>instance</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkInstance\">VkInstance</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateDisplayPlaneSurfaceKHR-pCreateInfo-parameter",
|
|
"text": " <code>pCreateInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkDisplaySurfaceCreateInfoKHR\">VkDisplaySurfaceCreateInfoKHR</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateDisplayPlaneSurfaceKHR-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateDisplayPlaneSurfaceKHR-pSurface-parameter",
|
|
"text": " <code>pSurface</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkSurfaceKHR\">VkSurfaceKHR</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkDisplaySurfaceCreateInfoKHR": {
|
|
"(VK_KHR_surface)+(VK_KHR_display)": [
|
|
{
|
|
"vuid": "VUID-VkDisplaySurfaceCreateInfoKHR-planeIndex-01252",
|
|
"text": " <code>planeIndex</code> <strong class=\"purple\">must</strong> be less than the number of display planes supported by the device as determined by calling <code>vkGetPhysicalDeviceDisplayPlanePropertiesKHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDisplaySurfaceCreateInfoKHR-planeReorderPossible-01253",
|
|
"text": " If the <code>planeReorderPossible</code> member of the <code>VkDisplayPropertiesKHR</code> structure returned by <code>vkGetPhysicalDeviceDisplayPropertiesKHR</code> for the display corresponding to <code>displayMode</code> is <code>VK_TRUE</code> then <code>planeStackIndex</code> <strong class=\"purple\">must</strong> be less than the number of display planes supported by the device as determined by calling <code>vkGetPhysicalDeviceDisplayPlanePropertiesKHR</code>; otherwise <code>planeStackIndex</code> <strong class=\"purple\">must</strong> equal the <code>currentStackIndex</code> member of <code>VkDisplayPlanePropertiesKHR</code> returned by <code>vkGetPhysicalDeviceDisplayPlanePropertiesKHR</code> for the display plane corresponding to <code>displayMode</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDisplaySurfaceCreateInfoKHR-alphaMode-01254",
|
|
"text": " If <code>alphaMode</code> is <code>VK_DISPLAY_PLANE_ALPHA_GLOBAL_BIT_KHR</code> then <code>globalAlpha</code> <strong class=\"purple\">must</strong> be between <code>0</code> and <code>1</code>, inclusive"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDisplaySurfaceCreateInfoKHR-alphaMode-01255",
|
|
"text": " <code>alphaMode</code> <strong class=\"purple\">must</strong> be one of the bits present in the <code>supportedAlpha</code> member of <code>VkDisplayPlaneCapabilitiesKHR</code> for the display plane corresponding to <code>displayMode</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDisplaySurfaceCreateInfoKHR-transform-06740",
|
|
"text": " <code>transform</code> <strong class=\"purple\">must</strong> be one of the bits present in the <code>supportedTransforms</code> member of <code>VkDisplayPropertiesKHR</code> for the display corresponding to <code>displayMode</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDisplaySurfaceCreateInfoKHR-width-01256",
|
|
"text": " The <code>width</code> and <code>height</code> members of <code>imageExtent</code> <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#VkPhysicalDeviceLimits\">VkPhysicalDeviceLimits</a>::<code>maxImageDimension2D</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDisplaySurfaceCreateInfoKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_DISPLAY_SURFACE_CREATE_INFO_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDisplaySurfaceCreateInfoKHR-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDisplaySurfaceCreateInfoKHR-flags-zerobitmask",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDisplaySurfaceCreateInfoKHR-displayMode-parameter",
|
|
"text": " <code>displayMode</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDisplayModeKHR\">VkDisplayModeKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDisplaySurfaceCreateInfoKHR-transform-parameter",
|
|
"text": " <code>transform</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSurfaceTransformFlagBitsKHR\">VkSurfaceTransformFlagBitsKHR</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDisplaySurfaceCreateInfoKHR-alphaMode-parameter",
|
|
"text": " <code>alphaMode</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDisplayPlaneAlphaFlagBitsKHR\">VkDisplayPlaneAlphaFlagBitsKHR</a> value"
|
|
}
|
|
]
|
|
},
|
|
"vkCreateHeadlessSurfaceEXT": {
|
|
"(VK_KHR_surface)+(VK_EXT_headless_surface)": [
|
|
{
|
|
"vuid": "VUID-vkCreateHeadlessSurfaceEXT-instance-parameter",
|
|
"text": " <code>instance</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkInstance\">VkInstance</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateHeadlessSurfaceEXT-pCreateInfo-parameter",
|
|
"text": " <code>pCreateInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkHeadlessSurfaceCreateInfoEXT\">VkHeadlessSurfaceCreateInfoEXT</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateHeadlessSurfaceEXT-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateHeadlessSurfaceEXT-pSurface-parameter",
|
|
"text": " <code>pSurface</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkSurfaceKHR\">VkSurfaceKHR</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkHeadlessSurfaceCreateInfoEXT": {
|
|
"(VK_KHR_surface)+(VK_EXT_headless_surface)": [
|
|
{
|
|
"vuid": "VUID-VkHeadlessSurfaceCreateInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_HEADLESS_SURFACE_CREATE_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkHeadlessSurfaceCreateInfoEXT-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkHeadlessSurfaceCreateInfoEXT-flags-zerobitmask",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetPhysicalDeviceSurfaceSupportKHR": {
|
|
"(VK_KHR_surface)": [
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSurfaceSupportKHR-queueFamilyIndex-01269",
|
|
"text": " <code>queueFamilyIndex</code> <strong class=\"purple\">must</strong> be less than <code>pQueueFamilyPropertyCount</code> returned by <code>vkGetPhysicalDeviceQueueFamilyProperties</code> for the given <code>physicalDevice</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSurfaceSupportKHR-physicalDevice-parameter",
|
|
"text": " <code>physicalDevice</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSurfaceSupportKHR-surface-parameter",
|
|
"text": " <code>surface</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSurfaceKHR\">VkSurfaceKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSurfaceSupportKHR-pSupported-parameter",
|
|
"text": " <code>pSupported</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>VkBool32</code> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSurfaceSupportKHR-commonparent",
|
|
"text": " Both of <code>physicalDevice</code>, and <code>surface</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkInstance\">VkInstance</a>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetPhysicalDeviceWaylandPresentationSupportKHR": {
|
|
"(VK_KHR_surface)+(VK_KHR_wayland_surface)": [
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceWaylandPresentationSupportKHR-queueFamilyIndex-01306",
|
|
"text": " <code>queueFamilyIndex</code> <strong class=\"purple\">must</strong> be less than <code>pQueueFamilyPropertyCount</code> returned by <code>vkGetPhysicalDeviceQueueFamilyProperties</code> for the given <code>physicalDevice</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceWaylandPresentationSupportKHR-physicalDevice-parameter",
|
|
"text": " <code>physicalDevice</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceWaylandPresentationSupportKHR-display-parameter",
|
|
"text": " <code>display</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>wl_display</code> value"
|
|
}
|
|
]
|
|
},
|
|
"vkGetPhysicalDeviceWin32PresentationSupportKHR": {
|
|
"(VK_KHR_surface)+(VK_KHR_win32_surface)": [
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceWin32PresentationSupportKHR-queueFamilyIndex-01309",
|
|
"text": " <code>queueFamilyIndex</code> <strong class=\"purple\">must</strong> be less than <code>pQueueFamilyPropertyCount</code> returned by <code>vkGetPhysicalDeviceQueueFamilyProperties</code> for the given <code>physicalDevice</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceWin32PresentationSupportKHR-physicalDevice-parameter",
|
|
"text": " <code>physicalDevice</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"vkGetPhysicalDeviceXcbPresentationSupportKHR": {
|
|
"(VK_KHR_surface)+(VK_KHR_xcb_surface)": [
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceXcbPresentationSupportKHR-queueFamilyIndex-01312",
|
|
"text": " <code>queueFamilyIndex</code> <strong class=\"purple\">must</strong> be less than <code>pQueueFamilyPropertyCount</code> returned by <code>vkGetPhysicalDeviceQueueFamilyProperties</code> for the given <code>physicalDevice</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceXcbPresentationSupportKHR-physicalDevice-parameter",
|
|
"text": " <code>physicalDevice</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceXcbPresentationSupportKHR-connection-parameter",
|
|
"text": " <code>connection</code> <strong class=\"purple\">must</strong> be a valid pointer to an <code>xcb_connection_t</code> value"
|
|
}
|
|
]
|
|
},
|
|
"vkGetPhysicalDeviceXlibPresentationSupportKHR": {
|
|
"(VK_KHR_surface)+(VK_KHR_xlib_surface)": [
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceXlibPresentationSupportKHR-queueFamilyIndex-01315",
|
|
"text": " <code>queueFamilyIndex</code> <strong class=\"purple\">must</strong> be less than <code>pQueueFamilyPropertyCount</code> returned by <code>vkGetPhysicalDeviceQueueFamilyProperties</code> for the given <code>physicalDevice</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceXlibPresentationSupportKHR-physicalDevice-parameter",
|
|
"text": " <code>physicalDevice</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceXlibPresentationSupportKHR-dpy-parameter",
|
|
"text": " <code>dpy</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>Display</code> value"
|
|
}
|
|
]
|
|
},
|
|
"vkGetPhysicalDeviceDirectFBPresentationSupportEXT": {
|
|
"(VK_KHR_surface)+(VK_EXT_directfb_surface)": [
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceDirectFBPresentationSupportEXT-queueFamilyIndex-04119",
|
|
"text": " <code>queueFamilyIndex</code> <strong class=\"purple\">must</strong> be less than <code>pQueueFamilyPropertyCount</code> returned by <code>vkGetPhysicalDeviceQueueFamilyProperties</code> for the given <code>physicalDevice</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceDirectFBPresentationSupportEXT-physicalDevice-parameter",
|
|
"text": " <code>physicalDevice</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceDirectFBPresentationSupportEXT-dfb-parameter",
|
|
"text": " <code>dfb</code> <strong class=\"purple\">must</strong> be a valid pointer to an <code>IDirectFB</code> value"
|
|
}
|
|
]
|
|
},
|
|
"vkGetPhysicalDeviceScreenPresentationSupportQNX": {
|
|
"(VK_KHR_surface)+(VK_QNX_screen_surface)": [
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceScreenPresentationSupportQNX-queueFamilyIndex-04743",
|
|
"text": " <code>queueFamilyIndex</code> <strong class=\"purple\">must</strong> be less than <code>pQueueFamilyPropertyCount</code> returned by <code>vkGetPhysicalDeviceQueueFamilyProperties</code> for the given <code>physicalDevice</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceScreenPresentationSupportQNX-physicalDevice-parameter",
|
|
"text": " <code>physicalDevice</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceScreenPresentationSupportQNX-window-parameter",
|
|
"text": " <code>window</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>_screen_window</code> value"
|
|
}
|
|
]
|
|
},
|
|
"vkGetPhysicalDeviceSurfaceCapabilitiesKHR": {
|
|
"(VK_KHR_surface)": [
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSurfaceCapabilitiesKHR-surface-06523",
|
|
"text": " <code>surface</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSurfaceKHR\">VkSurfaceKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSurfaceCapabilitiesKHR-surface-06211",
|
|
"text": " <code>surface</code> <strong class=\"purple\">must</strong> be supported by <code>physicalDevice</code>, as reported by <a href=\"#vkGetPhysicalDeviceSurfaceSupportKHR\">vkGetPhysicalDeviceSurfaceSupportKHR</a> or an equivalent platform-specific mechanism"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSurfaceCapabilitiesKHR-physicalDevice-parameter",
|
|
"text": " <code>physicalDevice</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSurfaceCapabilitiesKHR-surface-parameter",
|
|
"text": " <code>surface</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSurfaceKHR\">VkSurfaceKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSurfaceCapabilitiesKHR-pSurfaceCapabilities-parameter",
|
|
"text": " <code>pSurfaceCapabilities</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkSurfaceCapabilitiesKHR\">VkSurfaceCapabilitiesKHR</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSurfaceCapabilitiesKHR-commonparent",
|
|
"text": " Both of <code>physicalDevice</code>, and <code>surface</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkInstance\">VkInstance</a>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetPhysicalDeviceSurfaceCapabilities2KHR": {
|
|
"(VK_KHR_surface)+(VK_KHR_get_surface_capabilities2)+(VK_EXT_full_screen_exclusive+VK_KHR_win32_surface)": [
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSurfaceCapabilities2KHR-pSurfaceInfo-06520",
|
|
"text": " <code>pSurfaceInfo->surface</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSurfaceKHR\">VkSurfaceKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSurfaceCapabilities2KHR-pSurfaceInfo-06210",
|
|
"text": " <code>pSurfaceInfo->surface</code> <strong class=\"purple\">must</strong> be supported by <code>physicalDevice</code>, as reported by <a href=\"#vkGetPhysicalDeviceSurfaceSupportKHR\">vkGetPhysicalDeviceSurfaceSupportKHR</a> or an equivalent platform-specific mechanism"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSurfaceCapabilities2KHR-pNext-02671",
|
|
"text": " If a <a href=\"#VkSurfaceCapabilitiesFullScreenExclusiveEXT\">VkSurfaceCapabilitiesFullScreenExclusiveEXT</a> structure is included in the <code>pNext</code> chain of <code>pSurfaceCapabilities</code>, a <a href=\"#VkSurfaceFullScreenExclusiveWin32InfoEXT\">VkSurfaceFullScreenExclusiveWin32InfoEXT</a> structure <strong class=\"purple\">must</strong> be included in the <code>pNext</code> chain of <code>pSurfaceInfo</code>"
|
|
}
|
|
],
|
|
"(VK_KHR_surface)+(VK_KHR_get_surface_capabilities2)": [
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSurfaceCapabilities2KHR-physicalDevice-parameter",
|
|
"text": " <code>physicalDevice</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSurfaceCapabilities2KHR-pSurfaceInfo-parameter",
|
|
"text": " <code>pSurfaceInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkPhysicalDeviceSurfaceInfo2KHR\">VkPhysicalDeviceSurfaceInfo2KHR</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSurfaceCapabilities2KHR-pSurfaceCapabilities-parameter",
|
|
"text": " <code>pSurfaceCapabilities</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkSurfaceCapabilities2KHR\">VkSurfaceCapabilities2KHR</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceSurfaceInfo2KHR": {
|
|
"(VK_KHR_surface)+(VK_KHR_get_surface_capabilities2)+(VK_KHR_win32_surface+VK_EXT_full_screen_exclusive)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceSurfaceInfo2KHR-pNext-02672",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkSurfaceFullScreenExclusiveInfoEXT\">VkSurfaceFullScreenExclusiveInfoEXT</a> structure with its <code>fullScreenExclusive</code> member set to <code>VK_FULL_SCREEN_EXCLUSIVE_APPLICATION_CONTROLLED_EXT</code>, and <code>surface</code> was created using <a href=\"#vkCreateWin32SurfaceKHR\">vkCreateWin32SurfaceKHR</a>, a <a href=\"#VkSurfaceFullScreenExclusiveWin32InfoEXT\">VkSurfaceFullScreenExclusiveWin32InfoEXT</a> structure <strong class=\"purple\">must</strong> be included in the <code>pNext</code> chain"
|
|
}
|
|
],
|
|
"(VK_KHR_surface)+(VK_KHR_get_surface_capabilities2)+(VK_KHR_win32_surface+VK_EXT_full_screen_exclusive)+(VK_GOOGLE_surfaceless_query)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceSurfaceInfo2KHR-pSurfaceInfo-06526",
|
|
"text": " When passed as the <code>pSurfaceInfo</code> parameter of <a href=\"#vkGetPhysicalDeviceSurfaceCapabilities2KHR\">vkGetPhysicalDeviceSurfaceCapabilities2KHR</a>, if the <code><a href=\"#VK_GOOGLE_surfaceless_query\">VK_GOOGLE_surfaceless_query</a></code> extension is enabled and the <code>pNext</code> chain of the <code>pSurfaceCapabilities</code> parameter includes <code>VkSurfaceProtectedCapabilitiesKHR</code>, then <code>surface</code> <strong class=\"purple\">can</strong> be <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>. Otherwise, <code>surface</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSurfaceKHR\">VkSurfaceKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceSurfaceInfo2KHR-pSurfaceInfo-06527",
|
|
"text": " When passed as the <code>pSurfaceInfo</code> parameter of <a href=\"#vkGetPhysicalDeviceSurfaceFormats2KHR\">vkGetPhysicalDeviceSurfaceFormats2KHR</a>, if the <code><a href=\"#VK_GOOGLE_surfaceless_query\">VK_GOOGLE_surfaceless_query</a></code> extension is enabled, then <code>surface</code> <strong class=\"purple\">can</strong> be <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>. Otherwise, <code>surface</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSurfaceKHR\">VkSurfaceKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceSurfaceInfo2KHR-pSurfaceInfo-06528",
|
|
"text": " When passed as the <code>pSurfaceInfo</code> parameter of <a href=\"#vkGetPhysicalDeviceSurfacePresentModes2EXT\">vkGetPhysicalDeviceSurfacePresentModes2EXT</a>, if the <code><a href=\"#VK_GOOGLE_surfaceless_query\">VK_GOOGLE_surfaceless_query</a></code> extension is enabled, then <code>surface</code> <strong class=\"purple\">can</strong> be <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>. Otherwise, <code>surface</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSurfaceKHR\">VkSurfaceKHR</a> handle"
|
|
}
|
|
],
|
|
"(VK_KHR_surface)+(VK_KHR_get_surface_capabilities2)+(VK_KHR_win32_surface+VK_EXT_full_screen_exclusive)+!(VK_GOOGLE_surfaceless_query)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceSurfaceInfo2KHR-surface-06529",
|
|
"text": " <code>surface</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSurfaceKHR\">VkSurfaceKHR</a> handle"
|
|
}
|
|
],
|
|
"(VK_KHR_surface)+(VK_KHR_get_surface_capabilities2)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceSurfaceInfo2KHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_SURFACE_INFO_2_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceSurfaceInfo2KHR-pNext-pNext",
|
|
"text": " Each <code>pNext</code> member of any structure (including this one) in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be either <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkSurfaceFullScreenExclusiveInfoEXT\">VkSurfaceFullScreenExclusiveInfoEXT</a> or <a href=\"#VkSurfaceFullScreenExclusiveWin32InfoEXT\">VkSurfaceFullScreenExclusiveWin32InfoEXT</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceSurfaceInfo2KHR-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceSurfaceInfo2KHR-surface-parameter",
|
|
"text": " If <code>surface</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>surface</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSurfaceKHR\">VkSurfaceKHR</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkSurfaceFullScreenExclusiveInfoEXT": {
|
|
"(VK_KHR_surface)+(VK_KHR_get_surface_capabilities2)+(VK_EXT_full_screen_exclusive)": [
|
|
{
|
|
"vuid": "VUID-VkSurfaceFullScreenExclusiveInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_SURFACE_FULL_SCREEN_EXCLUSIVE_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSurfaceFullScreenExclusiveInfoEXT-fullScreenExclusive-parameter",
|
|
"text": " <code>fullScreenExclusive</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkFullScreenExclusiveEXT\">VkFullScreenExclusiveEXT</a> value"
|
|
}
|
|
]
|
|
},
|
|
"VkSurfaceFullScreenExclusiveWin32InfoEXT": {
|
|
"(VK_KHR_surface)+(VK_KHR_get_surface_capabilities2)+(VK_EXT_full_screen_exclusive)+(VK_KHR_win32_surface)": [
|
|
{
|
|
"vuid": "VUID-VkSurfaceFullScreenExclusiveWin32InfoEXT-hmonitor-02673",
|
|
"text": " <code>hmonitor</code> <strong class=\"purple\">must</strong> be a valid <code>HMONITOR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSurfaceFullScreenExclusiveWin32InfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_SURFACE_FULL_SCREEN_EXCLUSIVE_WIN32_INFO_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkSurfaceCapabilities2KHR": {
|
|
"(VK_KHR_surface)+(VK_KHR_get_surface_capabilities2)": [
|
|
{
|
|
"vuid": "VUID-VkSurfaceCapabilities2KHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_SURFACE_CAPABILITIES_2_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSurfaceCapabilities2KHR-pNext-pNext",
|
|
"text": " Each <code>pNext</code> member of any structure (including this one) in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be either <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkDisplayNativeHdrSurfaceCapabilitiesAMD\">VkDisplayNativeHdrSurfaceCapabilitiesAMD</a>, <a href=\"#VkSharedPresentSurfaceCapabilitiesKHR\">VkSharedPresentSurfaceCapabilitiesKHR</a>, <a href=\"#VkSurfaceCapabilitiesFullScreenExclusiveEXT\">VkSurfaceCapabilitiesFullScreenExclusiveEXT</a>, or <a href=\"#VkSurfaceProtectedCapabilitiesKHR\">VkSurfaceProtectedCapabilitiesKHR</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSurfaceCapabilities2KHR-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
}
|
|
]
|
|
},
|
|
"VkSurfaceProtectedCapabilitiesKHR": {
|
|
"(VK_KHR_surface)+(VK_KHR_get_surface_capabilities2)+(VK_KHR_surface_protected_capabilities)": [
|
|
{
|
|
"vuid": "VUID-VkSurfaceProtectedCapabilitiesKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_SURFACE_PROTECTED_CAPABILITIES_KHR</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkSharedPresentSurfaceCapabilitiesKHR": {
|
|
"(VK_KHR_surface)+(VK_KHR_get_surface_capabilities2)+(VK_KHR_shared_presentable_image)": [
|
|
{
|
|
"vuid": "VUID-VkSharedPresentSurfaceCapabilitiesKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_SHARED_PRESENT_SURFACE_CAPABILITIES_KHR</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkDisplayNativeHdrSurfaceCapabilitiesAMD": {
|
|
"(VK_KHR_surface)+(VK_KHR_get_surface_capabilities2)+(VK_AMD_display_native_hdr)": [
|
|
{
|
|
"vuid": "VUID-VkDisplayNativeHdrSurfaceCapabilitiesAMD-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_DISPLAY_NATIVE_HDR_SURFACE_CAPABILITIES_AMD</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkSurfaceCapabilitiesFullScreenExclusiveEXT": {
|
|
"(VK_KHR_surface)+(VK_KHR_get_surface_capabilities2)+(VK_EXT_full_screen_exclusive)": [
|
|
{
|
|
"vuid": "VUID-VkSurfaceCapabilitiesFullScreenExclusiveEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_SURFACE_CAPABILITIES_FULL_SCREEN_EXCLUSIVE_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetPhysicalDeviceSurfaceCapabilities2EXT": {
|
|
"(VK_KHR_surface)+(VK_EXT_display_surface_counter)": [
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSurfaceCapabilities2EXT-surface-06523",
|
|
"text": " <code>surface</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSurfaceKHR\">VkSurfaceKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSurfaceCapabilities2EXT-surface-06211",
|
|
"text": " <code>surface</code> <strong class=\"purple\">must</strong> be supported by <code>physicalDevice</code>, as reported by <a href=\"#vkGetPhysicalDeviceSurfaceSupportKHR\">vkGetPhysicalDeviceSurfaceSupportKHR</a> or an equivalent platform-specific mechanism"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSurfaceCapabilities2EXT-physicalDevice-parameter",
|
|
"text": " <code>physicalDevice</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSurfaceCapabilities2EXT-surface-parameter",
|
|
"text": " <code>surface</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSurfaceKHR\">VkSurfaceKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSurfaceCapabilities2EXT-pSurfaceCapabilities-parameter",
|
|
"text": " <code>pSurfaceCapabilities</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkSurfaceCapabilities2EXT\">VkSurfaceCapabilities2EXT</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSurfaceCapabilities2EXT-commonparent",
|
|
"text": " Both of <code>physicalDevice</code>, and <code>surface</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkInstance\">VkInstance</a>"
|
|
}
|
|
]
|
|
},
|
|
"VkSurfaceCapabilities2EXT": {
|
|
"(VK_KHR_surface)+(VK_EXT_display_surface_counter)": [
|
|
{
|
|
"vuid": "VUID-VkSurfaceCapabilities2EXT-supportedSurfaceCounters-01246",
|
|
"text": " <code>supportedSurfaceCounters</code> <strong class=\"purple\">must</strong> not include <code>VK_SURFACE_COUNTER_VBLANK_BIT_EXT</code> unless the surface queried is a <a href=\"#wsi-display-surfaces\">display surface</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSurfaceCapabilities2EXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_SURFACE_CAPABILITIES_2_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSurfaceCapabilities2EXT-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetPhysicalDeviceSurfaceFormatsKHR": {
|
|
"(VK_KHR_surface)+(VK_GOOGLE_surfaceless_query)": [
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSurfaceFormatsKHR-surface-06524",
|
|
"text": " If the <code><a href=\"#VK_GOOGLE_surfaceless_query\">VK_GOOGLE_surfaceless_query</a></code> extension is not enabled, <code>surface</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSurfaceKHR\">VkSurfaceKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSurfaceFormatsKHR-surface-06525",
|
|
"text": " If <code>surface</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, it <strong class=\"purple\">must</strong> be supported by <code>physicalDevice</code>, as reported by <a href=\"#vkGetPhysicalDeviceSurfaceSupportKHR\">vkGetPhysicalDeviceSurfaceSupportKHR</a> or an equivalent platform-specific mechanism"
|
|
}
|
|
],
|
|
"(VK_KHR_surface)+!(VK_GOOGLE_surfaceless_query)": [
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSurfaceFormatsKHR-surface-06523",
|
|
"text": " <code>surface</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSurfaceKHR\">VkSurfaceKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSurfaceFormatsKHR-surface-06211",
|
|
"text": " <code>surface</code> <strong class=\"purple\">must</strong> be supported by <code>physicalDevice</code>, as reported by <a href=\"#vkGetPhysicalDeviceSurfaceSupportKHR\">vkGetPhysicalDeviceSurfaceSupportKHR</a> or an equivalent platform-specific mechanism"
|
|
}
|
|
],
|
|
"(VK_KHR_surface)": [
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSurfaceFormatsKHR-physicalDevice-parameter",
|
|
"text": " <code>physicalDevice</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSurfaceFormatsKHR-surface-parameter",
|
|
"text": " If <code>surface</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>surface</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSurfaceKHR\">VkSurfaceKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSurfaceFormatsKHR-pSurfaceFormatCount-parameter",
|
|
"text": " <code>pSurfaceFormatCount</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>uint32_t</code> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSurfaceFormatsKHR-pSurfaceFormats-parameter",
|
|
"text": " If the value referenced by <code>pSurfaceFormatCount</code> is not <code>0</code>, and <code>pSurfaceFormats</code> is not <code>NULL</code>, <code>pSurfaceFormats</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>pSurfaceFormatCount</code> <a href=\"#VkSurfaceFormatKHR\">VkSurfaceFormatKHR</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSurfaceFormatsKHR-commonparent",
|
|
"text": " Both of <code>physicalDevice</code>, and <code>surface</code> that are valid handles of non-ignored parameters <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkInstance\">VkInstance</a>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetPhysicalDeviceSurfaceFormats2KHR": {
|
|
"(VK_KHR_surface)+(VK_KHR_get_surface_capabilities2)+(VK_GOOGLE_surfaceless_query)": [
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSurfaceFormats2KHR-pSurfaceInfo-06521",
|
|
"text": " If the <code><a href=\"#VK_GOOGLE_surfaceless_query\">VK_GOOGLE_surfaceless_query</a></code> extension is not enabled, <code>pSurfaceInfo->surface</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSurfaceKHR\">VkSurfaceKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSurfaceFormats2KHR-pSurfaceInfo-06522",
|
|
"text": " If <code>pSurfaceInfo->surface</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, it <strong class=\"purple\">must</strong> be supported by <code>physicalDevice</code>, as reported by <a href=\"#vkGetPhysicalDeviceSurfaceSupportKHR\">vkGetPhysicalDeviceSurfaceSupportKHR</a> or an equivalent platform-specific mechanism"
|
|
}
|
|
],
|
|
"(VK_KHR_surface)+(VK_KHR_get_surface_capabilities2)+!(VK_GOOGLE_surfaceless_query)": [
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSurfaceFormats2KHR-pSurfaceInfo-06520",
|
|
"text": " <code>pSurfaceInfo->surface</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSurfaceKHR\">VkSurfaceKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSurfaceFormats2KHR-pSurfaceInfo-06210",
|
|
"text": " <code>pSurfaceInfo->surface</code> <strong class=\"purple\">must</strong> be supported by <code>physicalDevice</code>, as reported by <a href=\"#vkGetPhysicalDeviceSurfaceSupportKHR\">vkGetPhysicalDeviceSurfaceSupportKHR</a> or an equivalent platform-specific mechanism"
|
|
}
|
|
],
|
|
"(VK_KHR_surface)+(VK_KHR_get_surface_capabilities2)": [
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSurfaceFormats2KHR-physicalDevice-parameter",
|
|
"text": " <code>physicalDevice</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSurfaceFormats2KHR-pSurfaceInfo-parameter",
|
|
"text": " <code>pSurfaceInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkPhysicalDeviceSurfaceInfo2KHR\">VkPhysicalDeviceSurfaceInfo2KHR</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSurfaceFormats2KHR-pSurfaceFormatCount-parameter",
|
|
"text": " <code>pSurfaceFormatCount</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>uint32_t</code> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSurfaceFormats2KHR-pSurfaceFormats-parameter",
|
|
"text": " If the value referenced by <code>pSurfaceFormatCount</code> is not <code>0</code>, and <code>pSurfaceFormats</code> is not <code>NULL</code>, <code>pSurfaceFormats</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>pSurfaceFormatCount</code> <a href=\"#VkSurfaceFormat2KHR\">VkSurfaceFormat2KHR</a> structures"
|
|
}
|
|
]
|
|
},
|
|
"VkSurfaceFormat2KHR": {
|
|
"(VK_KHR_surface)+(VK_KHR_get_surface_capabilities2)+(VK_EXT_image_compression_control)+!(VK_EXT_image_compression_control_swapchain)": [
|
|
{
|
|
"vuid": "VUID-VkSurfaceFormat2KHR-pNext-06749",
|
|
"text": " The <code>pNext</code> chain <strong class=\"purple\">must</strong> not include an <a href=\"#VkImageCompressionPropertiesEXT\">VkImageCompressionPropertiesEXT</a> structure"
|
|
}
|
|
],
|
|
"(VK_KHR_surface)+(VK_KHR_get_surface_capabilities2)+(VK_EXT_image_compression_control)+(VK_EXT_image_compression_control_swapchain)": [
|
|
{
|
|
"vuid": "VUID-VkSurfaceFormat2KHR-pNext-06750",
|
|
"text": " If the <a href=\"#features-imageCompressionControlSwapchain\"><code>imageCompressionControlSwapchain</code></a> feature is not enabled, the <code>pNext</code> chain <strong class=\"purple\">must</strong> not include an <a href=\"#VkImageCompressionPropertiesEXT\">VkImageCompressionPropertiesEXT</a> structure"
|
|
}
|
|
],
|
|
"(VK_KHR_surface)+(VK_KHR_get_surface_capabilities2)": [
|
|
{
|
|
"vuid": "VUID-VkSurfaceFormat2KHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_SURFACE_FORMAT_2_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSurfaceFormat2KHR-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkImageCompressionPropertiesEXT\">VkImageCompressionPropertiesEXT</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSurfaceFormat2KHR-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
}
|
|
]
|
|
},
|
|
"vkGetPhysicalDeviceSurfacePresentModesKHR": {
|
|
"(VK_KHR_surface)+(VK_GOOGLE_surfaceless_query)": [
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSurfacePresentModesKHR-surface-06524",
|
|
"text": " If the <code><a href=\"#VK_GOOGLE_surfaceless_query\">VK_GOOGLE_surfaceless_query</a></code> extension is not enabled, <code>surface</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSurfaceKHR\">VkSurfaceKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSurfacePresentModesKHR-surface-06525",
|
|
"text": " If <code>surface</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, it <strong class=\"purple\">must</strong> be supported by <code>physicalDevice</code>, as reported by <a href=\"#vkGetPhysicalDeviceSurfaceSupportKHR\">vkGetPhysicalDeviceSurfaceSupportKHR</a> or an equivalent platform-specific mechanism"
|
|
}
|
|
],
|
|
"(VK_KHR_surface)+!(VK_GOOGLE_surfaceless_query)": [
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSurfacePresentModesKHR-surface-06523",
|
|
"text": " <code>surface</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSurfaceKHR\">VkSurfaceKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSurfacePresentModesKHR-surface-06211",
|
|
"text": " <code>surface</code> <strong class=\"purple\">must</strong> be supported by <code>physicalDevice</code>, as reported by <a href=\"#vkGetPhysicalDeviceSurfaceSupportKHR\">vkGetPhysicalDeviceSurfaceSupportKHR</a> or an equivalent platform-specific mechanism"
|
|
}
|
|
],
|
|
"(VK_KHR_surface)": [
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSurfacePresentModesKHR-physicalDevice-parameter",
|
|
"text": " <code>physicalDevice</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSurfacePresentModesKHR-surface-parameter",
|
|
"text": " If <code>surface</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>surface</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSurfaceKHR\">VkSurfaceKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSurfacePresentModesKHR-pPresentModeCount-parameter",
|
|
"text": " <code>pPresentModeCount</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>uint32_t</code> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSurfacePresentModesKHR-pPresentModes-parameter",
|
|
"text": " If the value referenced by <code>pPresentModeCount</code> is not <code>0</code>, and <code>pPresentModes</code> is not <code>NULL</code>, <code>pPresentModes</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>pPresentModeCount</code> <a href=\"#VkPresentModeKHR\">VkPresentModeKHR</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSurfacePresentModesKHR-commonparent",
|
|
"text": " Both of <code>physicalDevice</code>, and <code>surface</code> that are valid handles of non-ignored parameters <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkInstance\">VkInstance</a>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetPhysicalDeviceSurfacePresentModes2EXT": {
|
|
"(VK_KHR_surface)+(VK_EXT_full_screen_exclusive)+(VK_GOOGLE_surfaceless_query)": [
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSurfacePresentModes2EXT-pSurfaceInfo-06521",
|
|
"text": " If the <code><a href=\"#VK_GOOGLE_surfaceless_query\">VK_GOOGLE_surfaceless_query</a></code> extension is not enabled, <code>pSurfaceInfo->surface</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSurfaceKHR\">VkSurfaceKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSurfacePresentModes2EXT-pSurfaceInfo-06522",
|
|
"text": " If <code>pSurfaceInfo->surface</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, it <strong class=\"purple\">must</strong> be supported by <code>physicalDevice</code>, as reported by <a href=\"#vkGetPhysicalDeviceSurfaceSupportKHR\">vkGetPhysicalDeviceSurfaceSupportKHR</a> or an equivalent platform-specific mechanism"
|
|
}
|
|
],
|
|
"(VK_KHR_surface)+(VK_EXT_full_screen_exclusive)+!(VK_GOOGLE_surfaceless_query)": [
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSurfacePresentModes2EXT-pSurfaceInfo-06520",
|
|
"text": " <code>pSurfaceInfo->surface</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSurfaceKHR\">VkSurfaceKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSurfacePresentModes2EXT-pSurfaceInfo-06210",
|
|
"text": " <code>pSurfaceInfo->surface</code> <strong class=\"purple\">must</strong> be supported by <code>physicalDevice</code>, as reported by <a href=\"#vkGetPhysicalDeviceSurfaceSupportKHR\">vkGetPhysicalDeviceSurfaceSupportKHR</a> or an equivalent platform-specific mechanism"
|
|
}
|
|
],
|
|
"(VK_KHR_surface)+(VK_EXT_full_screen_exclusive)": [
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSurfacePresentModes2EXT-physicalDevice-parameter",
|
|
"text": " <code>physicalDevice</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSurfacePresentModes2EXT-pSurfaceInfo-parameter",
|
|
"text": " <code>pSurfaceInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkPhysicalDeviceSurfaceInfo2KHR\">VkPhysicalDeviceSurfaceInfo2KHR</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSurfacePresentModes2EXT-pPresentModeCount-parameter",
|
|
"text": " <code>pPresentModeCount</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>uint32_t</code> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceSurfacePresentModes2EXT-pPresentModes-parameter",
|
|
"text": " If the value referenced by <code>pPresentModeCount</code> is not <code>0</code>, and <code>pPresentModes</code> is not <code>NULL</code>, <code>pPresentModes</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>pPresentModeCount</code> <a href=\"#VkPresentModeKHR\">VkPresentModeKHR</a> values"
|
|
}
|
|
]
|
|
},
|
|
"vkAcquireFullScreenExclusiveModeEXT": {
|
|
"(VK_KHR_surface)+(VK_EXT_full_screen_exclusive)": [
|
|
{
|
|
"vuid": "VUID-vkAcquireFullScreenExclusiveModeEXT-swapchain-02674",
|
|
"text": " <code>swapchain</code> <strong class=\"purple\">must</strong> not be in the retired state"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkAcquireFullScreenExclusiveModeEXT-swapchain-02675",
|
|
"text": " <code>swapchain</code> <strong class=\"purple\">must</strong> be a swapchain created with a <a href=\"#VkSurfaceFullScreenExclusiveInfoEXT\">VkSurfaceFullScreenExclusiveInfoEXT</a> structure, with <code>fullScreenExclusive</code> set to <code>VK_FULL_SCREEN_EXCLUSIVE_APPLICATION_CONTROLLED_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkAcquireFullScreenExclusiveModeEXT-swapchain-02676",
|
|
"text": " <code>swapchain</code> <strong class=\"purple\">must</strong> not currently have exclusive full-screen access"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkAcquireFullScreenExclusiveModeEXT-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkAcquireFullScreenExclusiveModeEXT-swapchain-parameter",
|
|
"text": " <code>swapchain</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSwapchainKHR\">VkSwapchainKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkAcquireFullScreenExclusiveModeEXT-commonparent",
|
|
"text": " Both of <code>device</code>, and <code>swapchain</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkInstance\">VkInstance</a>"
|
|
}
|
|
]
|
|
},
|
|
"vkReleaseFullScreenExclusiveModeEXT": {
|
|
"(VK_KHR_surface)+(VK_EXT_full_screen_exclusive)": [
|
|
{
|
|
"vuid": "VUID-vkReleaseFullScreenExclusiveModeEXT-swapchain-02677",
|
|
"text": " <code>swapchain</code> <strong class=\"purple\">must</strong> not be in the retired state"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkReleaseFullScreenExclusiveModeEXT-swapchain-02678",
|
|
"text": " <code>swapchain</code> <strong class=\"purple\">must</strong> be a swapchain created with a <a href=\"#VkSurfaceFullScreenExclusiveInfoEXT\">VkSurfaceFullScreenExclusiveInfoEXT</a> structure, with <code>fullScreenExclusive</code> set to <code>VK_FULL_SCREEN_EXCLUSIVE_APPLICATION_CONTROLLED_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetDeviceGroupPresentCapabilitiesKHR": {
|
|
"(VK_KHR_surface)+(VK_KHR_swapchain)+(VK_VERSION_1_1,VK_KHR_device_group)": [
|
|
{
|
|
"vuid": "VUID-vkGetDeviceGroupPresentCapabilitiesKHR-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDeviceGroupPresentCapabilitiesKHR-pDeviceGroupPresentCapabilities-parameter",
|
|
"text": " <code>pDeviceGroupPresentCapabilities</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkDeviceGroupPresentCapabilitiesKHR\">VkDeviceGroupPresentCapabilitiesKHR</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkDeviceGroupPresentCapabilitiesKHR": {
|
|
"(VK_KHR_surface)+(VK_KHR_swapchain)+(VK_VERSION_1_1,VK_KHR_device_group)": [
|
|
{
|
|
"vuid": "VUID-VkDeviceGroupPresentCapabilitiesKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_DEVICE_GROUP_PRESENT_CAPABILITIES_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceGroupPresentCapabilitiesKHR-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetDeviceGroupSurfacePresentModesKHR": {
|
|
"(VK_KHR_surface)+(VK_KHR_swapchain)+(VK_VERSION_1_1,VK_KHR_device_group)": [
|
|
{
|
|
"vuid": "VUID-vkGetDeviceGroupSurfacePresentModesKHR-surface-06212",
|
|
"text": " <code>surface</code> <strong class=\"purple\">must</strong> be supported by all physical devices associated with <code>device</code>, as reported by <a href=\"#vkGetPhysicalDeviceSurfaceSupportKHR\">vkGetPhysicalDeviceSurfaceSupportKHR</a> or an equivalent platform-specific mechanism"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDeviceGroupSurfacePresentModesKHR-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDeviceGroupSurfacePresentModesKHR-surface-parameter",
|
|
"text": " <code>surface</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSurfaceKHR\">VkSurfaceKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDeviceGroupSurfacePresentModesKHR-pModes-parameter",
|
|
"text": " <code>pModes</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkDeviceGroupPresentModeFlagsKHR\">VkDeviceGroupPresentModeFlagsKHR</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDeviceGroupSurfacePresentModesKHR-commonparent",
|
|
"text": " Both of <code>device</code>, and <code>surface</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkInstance\">VkInstance</a>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetDeviceGroupSurfacePresentModes2EXT": {
|
|
"(VK_KHR_surface)+(VK_KHR_swapchain)+(VK_VERSION_1_1,VK_KHR_device_group)+(VK_EXT_full_screen_exclusive)": [
|
|
{
|
|
"vuid": "VUID-vkGetDeviceGroupSurfacePresentModes2EXT-pSurfaceInfo-06213",
|
|
"text": " <code>pSurfaceInfo->surface</code> <strong class=\"purple\">must</strong> be supported by all physical devices associated with <code>device</code>, as reported by <a href=\"#vkGetPhysicalDeviceSurfaceSupportKHR\">vkGetPhysicalDeviceSurfaceSupportKHR</a> or an equivalent platform-specific mechanism"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDeviceGroupSurfacePresentModes2EXT-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDeviceGroupSurfacePresentModes2EXT-pSurfaceInfo-parameter",
|
|
"text": " <code>pSurfaceInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkPhysicalDeviceSurfaceInfo2KHR\">VkPhysicalDeviceSurfaceInfo2KHR</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDeviceGroupSurfacePresentModes2EXT-pModes-parameter",
|
|
"text": " <code>pModes</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkDeviceGroupPresentModeFlagsKHR\">VkDeviceGroupPresentModeFlagsKHR</a> value"
|
|
}
|
|
]
|
|
},
|
|
"vkGetPhysicalDevicePresentRectanglesKHR": {
|
|
"(VK_KHR_surface)+(VK_KHR_swapchain)+(VK_VERSION_1_1,VK_KHR_device_group)": [
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDevicePresentRectanglesKHR-surface-06523",
|
|
"text": " <code>surface</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSurfaceKHR\">VkSurfaceKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDevicePresentRectanglesKHR-surface-06211",
|
|
"text": " <code>surface</code> <strong class=\"purple\">must</strong> be supported by <code>physicalDevice</code>, as reported by <a href=\"#vkGetPhysicalDeviceSurfaceSupportKHR\">vkGetPhysicalDeviceSurfaceSupportKHR</a> or an equivalent platform-specific mechanism"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDevicePresentRectanglesKHR-physicalDevice-parameter",
|
|
"text": " <code>physicalDevice</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDevicePresentRectanglesKHR-surface-parameter",
|
|
"text": " <code>surface</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSurfaceKHR\">VkSurfaceKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDevicePresentRectanglesKHR-pRectCount-parameter",
|
|
"text": " <code>pRectCount</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>uint32_t</code> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDevicePresentRectanglesKHR-pRects-parameter",
|
|
"text": " If the value referenced by <code>pRectCount</code> is not <code>0</code>, and <code>pRects</code> is not <code>NULL</code>, <code>pRects</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>pRectCount</code> <a href=\"#VkRect2D\">VkRect2D</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDevicePresentRectanglesKHR-commonparent",
|
|
"text": " Both of <code>physicalDevice</code>, and <code>surface</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkInstance\">VkInstance</a>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetRefreshCycleDurationGOOGLE": {
|
|
"(VK_KHR_surface)+(VK_KHR_swapchain)+(VK_GOOGLE_display_timing)": [
|
|
{
|
|
"vuid": "VUID-vkGetRefreshCycleDurationGOOGLE-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetRefreshCycleDurationGOOGLE-swapchain-parameter",
|
|
"text": " <code>swapchain</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSwapchainKHR\">VkSwapchainKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetRefreshCycleDurationGOOGLE-pDisplayTimingProperties-parameter",
|
|
"text": " <code>pDisplayTimingProperties</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkRefreshCycleDurationGOOGLE\">VkRefreshCycleDurationGOOGLE</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetRefreshCycleDurationGOOGLE-commonparent",
|
|
"text": " Both of <code>device</code>, and <code>swapchain</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkInstance\">VkInstance</a>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetPastPresentationTimingGOOGLE": {
|
|
"(VK_KHR_surface)+(VK_KHR_swapchain)+(VK_GOOGLE_display_timing)": [
|
|
{
|
|
"vuid": "VUID-vkGetPastPresentationTimingGOOGLE-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPastPresentationTimingGOOGLE-swapchain-parameter",
|
|
"text": " <code>swapchain</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSwapchainKHR\">VkSwapchainKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPastPresentationTimingGOOGLE-pPresentationTimingCount-parameter",
|
|
"text": " <code>pPresentationTimingCount</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>uint32_t</code> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPastPresentationTimingGOOGLE-pPresentationTimings-parameter",
|
|
"text": " If the value referenced by <code>pPresentationTimingCount</code> is not <code>0</code>, and <code>pPresentationTimings</code> is not <code>NULL</code>, <code>pPresentationTimings</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>pPresentationTimingCount</code> <a href=\"#VkPastPresentationTimingGOOGLE\">VkPastPresentationTimingGOOGLE</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPastPresentationTimingGOOGLE-commonparent",
|
|
"text": " Both of <code>device</code>, and <code>swapchain</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkInstance\">VkInstance</a>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetSwapchainStatusKHR": {
|
|
"(VK_KHR_surface)+(VK_KHR_swapchain)+(VK_KHR_shared_presentable_image)": [
|
|
{
|
|
"vuid": "VUID-vkGetSwapchainStatusKHR-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetSwapchainStatusKHR-swapchain-parameter",
|
|
"text": " <code>swapchain</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSwapchainKHR\">VkSwapchainKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetSwapchainStatusKHR-commonparent",
|
|
"text": " Both of <code>device</code>, and <code>swapchain</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkInstance\">VkInstance</a>"
|
|
}
|
|
]
|
|
},
|
|
"vkCreateSwapchainKHR": {
|
|
"(VK_KHR_surface)+(VK_KHR_swapchain)": [
|
|
{
|
|
"vuid": "VUID-vkCreateSwapchainKHR-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateSwapchainKHR-pCreateInfo-parameter",
|
|
"text": " <code>pCreateInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkSwapchainCreateInfoKHR\">VkSwapchainCreateInfoKHR</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateSwapchainKHR-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateSwapchainKHR-pSwapchain-parameter",
|
|
"text": " <code>pSwapchain</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkSwapchainKHR\">VkSwapchainKHR</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkSwapchainCreateInfoKHR": {
|
|
"(VK_KHR_surface)+(VK_KHR_swapchain)": [
|
|
{
|
|
"vuid": "VUID-VkSwapchainCreateInfoKHR-surface-01270",
|
|
"text": " <code>surface</code> <strong class=\"purple\">must</strong> be a surface that is supported by the device as determined using <a href=\"#vkGetPhysicalDeviceSurfaceSupportKHR\">vkGetPhysicalDeviceSurfaceSupportKHR</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSwapchainCreateInfoKHR-minImageCount-01272",
|
|
"text": " <code>minImageCount</code> <strong class=\"purple\">must</strong> be less than or equal to the value returned in the <code>maxImageCount</code> member of the <code>VkSurfaceCapabilitiesKHR</code> structure returned by <code>vkGetPhysicalDeviceSurfaceCapabilitiesKHR</code> for the surface if the returned <code>maxImageCount</code> is not zero"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSwapchainCreateInfoKHR-imageFormat-01273",
|
|
"text": " <code>imageFormat</code> and <code>imageColorSpace</code> <strong class=\"purple\">must</strong> match the <code>format</code> and <code>colorSpace</code> members, respectively, of one of the <code>VkSurfaceFormatKHR</code> structures returned by <code>vkGetPhysicalDeviceSurfaceFormatsKHR</code> for the surface"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSwapchainCreateInfoKHR-imageExtent-01274",
|
|
"text": " <code>imageExtent</code> <strong class=\"purple\">must</strong> be between <code>minImageExtent</code> and <code>maxImageExtent</code>, inclusive, where <code>minImageExtent</code> and <code>maxImageExtent</code> are members of the <code>VkSurfaceCapabilitiesKHR</code> structure returned by <code>vkGetPhysicalDeviceSurfaceCapabilitiesKHR</code> for the surface"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSwapchainCreateInfoKHR-imageExtent-01689",
|
|
"text": " <code>imageExtent</code> members <code>width</code> and <code>height</code> <strong class=\"purple\">must</strong> both be non-zero"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSwapchainCreateInfoKHR-imageArrayLayers-01275",
|
|
"text": " <code>imageArrayLayers</code> <strong class=\"purple\">must</strong> be greater than <code>0</code> and less than or equal to the <code>maxImageArrayLayers</code> member of the <code>VkSurfaceCapabilitiesKHR</code> structure returned by <code>vkGetPhysicalDeviceSurfaceCapabilitiesKHR</code> for the surface"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSwapchainCreateInfoKHR-imageSharingMode-01277",
|
|
"text": " If <code>imageSharingMode</code> is <code>VK_SHARING_MODE_CONCURRENT</code>, <code>pQueueFamilyIndices</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>queueFamilyIndexCount</code> <code>uint32_t</code> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSwapchainCreateInfoKHR-imageSharingMode-01278",
|
|
"text": " If <code>imageSharingMode</code> is <code>VK_SHARING_MODE_CONCURRENT</code>, <code>queueFamilyIndexCount</code> <strong class=\"purple\">must</strong> be greater than <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSwapchainCreateInfoKHR-preTransform-01279",
|
|
"text": " <code>preTransform</code> <strong class=\"purple\">must</strong> be one of the bits present in the <code>supportedTransforms</code> member of the <code>VkSurfaceCapabilitiesKHR</code> structure returned by <code>vkGetPhysicalDeviceSurfaceCapabilitiesKHR</code> for the surface"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSwapchainCreateInfoKHR-compositeAlpha-01280",
|
|
"text": " <code>compositeAlpha</code> <strong class=\"purple\">must</strong> be one of the bits present in the <code>supportedCompositeAlpha</code> member of the <code>VkSurfaceCapabilitiesKHR</code> structure returned by <code>vkGetPhysicalDeviceSurfaceCapabilitiesKHR</code> for the surface"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSwapchainCreateInfoKHR-presentMode-01281",
|
|
"text": " <code>presentMode</code> <strong class=\"purple\">must</strong> be one of the <a href=\"#VkPresentModeKHR\">VkPresentModeKHR</a> values returned by <code>vkGetPhysicalDeviceSurfacePresentModesKHR</code> for the surface"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSwapchainCreateInfoKHR-oldSwapchain-01933",
|
|
"text": " If <code>oldSwapchain</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>oldSwapchain</code> <strong class=\"purple\">must</strong> be a non-retired swapchain associated with native window referred to by <code>surface</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSwapchainCreateInfoKHR-imageFormat-01778",
|
|
"text": " The <a href=\"#swapchain-wsi-image-create-info\">implied image creation parameters</a> of the swapchain <strong class=\"purple\">must</strong> be supported as reported by <a href=\"#vkGetPhysicalDeviceImageFormatProperties\">vkGetPhysicalDeviceImageFormatProperties</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSwapchainCreateInfoKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_SWAPCHAIN_CREATE_INFO_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSwapchainCreateInfoKHR-pNext-pNext",
|
|
"text": " Each <code>pNext</code> member of any structure (including this one) in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be either <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkDeviceGroupSwapchainCreateInfoKHR\">VkDeviceGroupSwapchainCreateInfoKHR</a>, <a href=\"#VkImageCompressionControlEXT\">VkImageCompressionControlEXT</a>, <a href=\"#VkImageFormatListCreateInfo\">VkImageFormatListCreateInfo</a>, <a href=\"#VkSurfaceFullScreenExclusiveInfoEXT\">VkSurfaceFullScreenExclusiveInfoEXT</a>, <a href=\"#VkSurfaceFullScreenExclusiveWin32InfoEXT\">VkSurfaceFullScreenExclusiveWin32InfoEXT</a>, <a href=\"#VkSwapchainCounterCreateInfoEXT\">VkSwapchainCounterCreateInfoEXT</a>, or <a href=\"#VkSwapchainDisplayNativeHdrCreateInfoAMD\">VkSwapchainDisplayNativeHdrCreateInfoAMD</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSwapchainCreateInfoKHR-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSwapchainCreateInfoKHR-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkSwapchainCreateFlagBitsKHR\">VkSwapchainCreateFlagBitsKHR</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSwapchainCreateInfoKHR-surface-parameter",
|
|
"text": " <code>surface</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSurfaceKHR\">VkSurfaceKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSwapchainCreateInfoKHR-imageFormat-parameter",
|
|
"text": " <code>imageFormat</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkFormat\">VkFormat</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSwapchainCreateInfoKHR-imageColorSpace-parameter",
|
|
"text": " <code>imageColorSpace</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkColorSpaceKHR\">VkColorSpaceKHR</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSwapchainCreateInfoKHR-imageUsage-parameter",
|
|
"text": " <code>imageUsage</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkImageUsageFlagBits\">VkImageUsageFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSwapchainCreateInfoKHR-imageUsage-requiredbitmask",
|
|
"text": " <code>imageUsage</code> <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSwapchainCreateInfoKHR-imageSharingMode-parameter",
|
|
"text": " <code>imageSharingMode</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSharingMode\">VkSharingMode</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSwapchainCreateInfoKHR-preTransform-parameter",
|
|
"text": " <code>preTransform</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSurfaceTransformFlagBitsKHR\">VkSurfaceTransformFlagBitsKHR</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSwapchainCreateInfoKHR-compositeAlpha-parameter",
|
|
"text": " <code>compositeAlpha</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCompositeAlphaFlagBitsKHR\">VkCompositeAlphaFlagBitsKHR</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSwapchainCreateInfoKHR-presentMode-parameter",
|
|
"text": " <code>presentMode</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPresentModeKHR\">VkPresentModeKHR</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSwapchainCreateInfoKHR-oldSwapchain-parameter",
|
|
"text": " If <code>oldSwapchain</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>oldSwapchain</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSwapchainKHR\">VkSwapchainKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSwapchainCreateInfoKHR-oldSwapchain-parent",
|
|
"text": " If <code>oldSwapchain</code> is a valid handle, it <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>surface</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSwapchainCreateInfoKHR-commonparent",
|
|
"text": " Both of <code>oldSwapchain</code>, and <code>surface</code> that are valid handles of non-ignored parameters <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkInstance\">VkInstance</a>"
|
|
}
|
|
],
|
|
"(VK_KHR_surface)+(VK_KHR_swapchain)+!(VK_KHR_shared_presentable_image)": [
|
|
{
|
|
"vuid": "VUID-VkSwapchainCreateInfoKHR-minImageCount-01271",
|
|
"text": " <code>minImageCount</code> <strong class=\"purple\">must</strong> be greater than or equal to the value returned in the <code>minImageCount</code> member of the <code>VkSurfaceCapabilitiesKHR</code> structure returned by <a href=\"#vkGetPhysicalDeviceSurfaceCapabilitiesKHR\">vkGetPhysicalDeviceSurfaceCapabilitiesKHR</a> for the surface"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSwapchainCreateInfoKHR-imageUsage-01276",
|
|
"text": " <code>imageUsage</code> <strong class=\"purple\">must</strong> be a subset of the supported usage flags present in the <code>supportedUsageFlags</code> member of the <code>VkSurfaceCapabilitiesKHR</code> structure returned by <code>vkGetPhysicalDeviceSurfaceCapabilitiesKHR</code> for the surface"
|
|
}
|
|
],
|
|
"(VK_KHR_surface)+(VK_KHR_swapchain)+(VK_KHR_shared_presentable_image)": [
|
|
{
|
|
"vuid": "VUID-VkSwapchainCreateInfoKHR-presentMode-02839",
|
|
"text": " If <code>presentMode</code> is not <code>VK_PRESENT_MODE_SHARED_DEMAND_REFRESH_KHR</code> nor <code>VK_PRESENT_MODE_SHARED_CONTINUOUS_REFRESH_KHR</code>, then <code>minImageCount</code> <strong class=\"purple\">must</strong> be greater than or equal to the value returned in the <code>minImageCount</code> member of the <code>VkSurfaceCapabilitiesKHR</code> structure returned by <a href=\"#vkGetPhysicalDeviceSurfaceCapabilitiesKHR\">vkGetPhysicalDeviceSurfaceCapabilitiesKHR</a> for the surface"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSwapchainCreateInfoKHR-minImageCount-01383",
|
|
"text": " <code>minImageCount</code> <strong class=\"purple\">must</strong> be <code>1</code> if <code>presentMode</code> is either <code>VK_PRESENT_MODE_SHARED_DEMAND_REFRESH_KHR</code> or <code>VK_PRESENT_MODE_SHARED_CONTINUOUS_REFRESH_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSwapchainCreateInfoKHR-presentMode-01427",
|
|
"text": " If <code>presentMode</code> is <code>VK_PRESENT_MODE_IMMEDIATE_KHR</code>, <code>VK_PRESENT_MODE_MAILBOX_KHR</code>, <code>VK_PRESENT_MODE_FIFO_KHR</code> or <code>VK_PRESENT_MODE_FIFO_RELAXED_KHR</code>, <code>imageUsage</code> <strong class=\"purple\">must</strong> be a subset of the supported usage flags present in the <code>supportedUsageFlags</code> member of the <a href=\"#VkSurfaceCapabilitiesKHR\">VkSurfaceCapabilitiesKHR</a> structure returned by <a href=\"#vkGetPhysicalDeviceSurfaceCapabilitiesKHR\">vkGetPhysicalDeviceSurfaceCapabilitiesKHR</a> for <code>surface</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSwapchainCreateInfoKHR-imageUsage-01384",
|
|
"text": " If <code>presentMode</code> is <code>VK_PRESENT_MODE_SHARED_DEMAND_REFRESH_KHR</code> or <code>VK_PRESENT_MODE_SHARED_CONTINUOUS_REFRESH_KHR</code>, <code>imageUsage</code> <strong class=\"purple\">must</strong> be a subset of the supported usage flags present in the <code>sharedPresentSupportedUsageFlags</code> member of the <a href=\"#VkSharedPresentSurfaceCapabilitiesKHR\">VkSharedPresentSurfaceCapabilitiesKHR</a> structure returned by <a href=\"#vkGetPhysicalDeviceSurfaceCapabilities2KHR\">vkGetPhysicalDeviceSurfaceCapabilities2KHR</a> for <code>surface</code>"
|
|
}
|
|
],
|
|
"(VK_KHR_surface)+(VK_KHR_swapchain)+!(VK_VERSION_1_1,VK_KHR_get_physical_device_properties2)": [
|
|
{
|
|
"vuid": "VUID-VkSwapchainCreateInfoKHR-imageSharingMode-01393",
|
|
"text": " If <code>imageSharingMode</code> is <code>VK_SHARING_MODE_CONCURRENT</code>, each element of <code>pQueueFamilyIndices</code> <strong class=\"purple\">must</strong> be unique and <strong class=\"purple\">must</strong> be less than <code>pQueueFamilyPropertyCount</code> returned by <a href=\"#vkGetPhysicalDeviceQueueFamilyProperties\">vkGetPhysicalDeviceQueueFamilyProperties</a> for the <code>physicalDevice</code> that was used to create <code>device</code>"
|
|
}
|
|
],
|
|
"(VK_KHR_surface)+(VK_KHR_swapchain)+(VK_VERSION_1_1,VK_KHR_get_physical_device_properties2)": [
|
|
{
|
|
"vuid": "VUID-VkSwapchainCreateInfoKHR-imageSharingMode-01428",
|
|
"text": " If <code>imageSharingMode</code> is <code>VK_SHARING_MODE_CONCURRENT</code>, each element of <code>pQueueFamilyIndices</code> <strong class=\"purple\">must</strong> be unique and <strong class=\"purple\">must</strong> be less than <code>pQueueFamilyPropertyCount</code> returned by either <a href=\"#vkGetPhysicalDeviceQueueFamilyProperties\">vkGetPhysicalDeviceQueueFamilyProperties</a> or <a href=\"#vkGetPhysicalDeviceQueueFamilyProperties2\">vkGetPhysicalDeviceQueueFamilyProperties2</a> for the <code>physicalDevice</code> that was used to create <code>device</code>"
|
|
}
|
|
],
|
|
"(VK_KHR_surface)+(VK_KHR_swapchain)+(VK_VERSION_1_1,VK_KHR_device_group)": [
|
|
{
|
|
"vuid": "VUID-VkSwapchainCreateInfoKHR-physicalDeviceCount-01429",
|
|
"text": " If the logical device was created with <a href=\"#VkDeviceGroupDeviceCreateInfo\">VkDeviceGroupDeviceCreateInfo</a>::<code>physicalDeviceCount</code> equal to 1, <code>flags</code> <strong class=\"purple\">must</strong> not contain <code>VK_SWAPCHAIN_CREATE_SPLIT_INSTANCE_BIND_REGIONS_BIT_KHR</code>"
|
|
}
|
|
],
|
|
"(VK_KHR_surface)+(VK_KHR_swapchain)+(VK_KHR_swapchain_mutable_format)": [
|
|
{
|
|
"vuid": "VUID-VkSwapchainCreateInfoKHR-flags-03168",
|
|
"text": " If <code>flags</code> contains <code>VK_SWAPCHAIN_CREATE_MUTABLE_FORMAT_BIT_KHR</code> then the <code>pNext</code> chain <strong class=\"purple\">must</strong> include a <a href=\"#VkImageFormatListCreateInfo\">VkImageFormatListCreateInfo</a> structure with a <code>viewFormatCount</code> greater than zero and <code>pViewFormats</code> <strong class=\"purple\">must</strong> have an element equal to <code>imageFormat</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSwapchainCreateInfoKHR-pNext-04099",
|
|
"text": " If a <a href=\"#VkImageFormatListCreateInfo\">VkImageFormatListCreateInfo</a> structure was included in the <code>pNext</code> chain and <a href=\"#VkImageFormatListCreateInfo\">VkImageFormatListCreateInfo</a>::<code>viewFormatCount</code> is not zero then all of the formats in <a href=\"#VkImageFormatListCreateInfo\">VkImageFormatListCreateInfo</a>::<code>pViewFormats</code> <strong class=\"purple\">must</strong> be compatible with the <code>format</code> as described in the <a href=\"#formats-compatibility\">compatibility table</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSwapchainCreateInfoKHR-flags-04100",
|
|
"text": " If <code>flags</code> does not contain <code>VK_SWAPCHAIN_CREATE_MUTABLE_FORMAT_BIT_KHR</code> and the <code>pNext</code> chain include a <a href=\"#VkImageFormatListCreateInfo\">VkImageFormatListCreateInfo</a> structure then <a href=\"#VkImageFormatListCreateInfo\">VkImageFormatListCreateInfo</a>::<code>viewFormatCount</code> <strong class=\"purple\">must</strong> be <code>0</code> or <code>1</code>"
|
|
}
|
|
],
|
|
"(VK_KHR_surface)+(VK_KHR_swapchain)+(VK_KHR_surface_protected_capabilities)": [
|
|
{
|
|
"vuid": "VUID-VkSwapchainCreateInfoKHR-flags-03187",
|
|
"text": " If <code>flags</code> contains <code>VK_SWAPCHAIN_CREATE_PROTECTED_BIT_KHR</code>, then <code>VkSurfaceProtectedCapabilitiesKHR</code>::<code>supportsProtected</code> <strong class=\"purple\">must</strong> be <code>VK_TRUE</code> in the <a href=\"#VkSurfaceProtectedCapabilitiesKHR\">VkSurfaceProtectedCapabilitiesKHR</a> structure returned by <a href=\"#vkGetPhysicalDeviceSurfaceCapabilities2KHR\">vkGetPhysicalDeviceSurfaceCapabilities2KHR</a> for <code>surface</code>"
|
|
}
|
|
],
|
|
"(VK_KHR_surface)+(VK_KHR_swapchain)+(VK_EXT_full_screen_exclusive+VK_KHR_win32_surface)": [
|
|
{
|
|
"vuid": "VUID-VkSwapchainCreateInfoKHR-pNext-02679",
|
|
"text": " If the <code>pNext</code> chain includes a <a href=\"#VkSurfaceFullScreenExclusiveInfoEXT\">VkSurfaceFullScreenExclusiveInfoEXT</a> structure with its <code>fullScreenExclusive</code> member set to <code>VK_FULL_SCREEN_EXCLUSIVE_APPLICATION_CONTROLLED_EXT</code>, and <code>surface</code> was created using <a href=\"#vkCreateWin32SurfaceKHR\">vkCreateWin32SurfaceKHR</a>, a <a href=\"#VkSurfaceFullScreenExclusiveWin32InfoEXT\">VkSurfaceFullScreenExclusiveWin32InfoEXT</a> structure <strong class=\"purple\">must</strong> be included in the <code>pNext</code> chain"
|
|
}
|
|
],
|
|
"(VK_KHR_surface)+(VK_KHR_swapchain)+(VK_EXT_image_compression_control)+!(VK_EXT_image_compression_control_swapchain)": [
|
|
{
|
|
"vuid": "VUID-VkSwapchainCreateInfoKHR-pNext-06751",
|
|
"text": " The <code>pNext</code> chain <strong class=\"purple\">must</strong> not include an <a href=\"#VkImageCompressionControlEXT\">VkImageCompressionControlEXT</a> structure"
|
|
}
|
|
],
|
|
"(VK_KHR_surface)+(VK_KHR_swapchain)+(VK_EXT_image_compression_control)+(VK_EXT_image_compression_control_swapchain)": [
|
|
{
|
|
"vuid": "VUID-VkSwapchainCreateInfoKHR-pNext-06752",
|
|
"text": " If the <a href=\"#features-imageCompressionControlSwapchain\"><code>imageCompressionControlSwapchain</code></a> feature is not enabled, the <code>pNext</code> chain <strong class=\"purple\">must</strong> not include an <a href=\"#VkImageCompressionControlEXT\">VkImageCompressionControlEXT</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkDeviceGroupSwapchainCreateInfoKHR": {
|
|
"(VK_KHR_surface)+(VK_KHR_swapchain)+(VK_VERSION_1_1,VK_KHR_device_group)": [
|
|
{
|
|
"vuid": "VUID-VkDeviceGroupSwapchainCreateInfoKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_DEVICE_GROUP_SWAPCHAIN_CREATE_INFO_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceGroupSwapchainCreateInfoKHR-modes-parameter",
|
|
"text": " <code>modes</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkDeviceGroupPresentModeFlagBitsKHR\">VkDeviceGroupPresentModeFlagBitsKHR</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceGroupSwapchainCreateInfoKHR-modes-requiredbitmask",
|
|
"text": " <code>modes</code> <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkSwapchainDisplayNativeHdrCreateInfoAMD": {
|
|
"(VK_KHR_surface)+(VK_KHR_swapchain)+(VK_AMD_display_native_hdr)": [
|
|
{
|
|
"vuid": "VUID-VkSwapchainDisplayNativeHdrCreateInfoAMD-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_SWAPCHAIN_DISPLAY_NATIVE_HDR_CREATE_INFO_AMD</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSwapchainDisplayNativeHdrCreateInfoAMD-localDimmingEnable-04449",
|
|
"text": " It is only valid to set <code>localDimmingEnable</code> to <code>VK_TRUE</code> if <a href=\"#VkDisplayNativeHdrSurfaceCapabilitiesAMD\">VkDisplayNativeHdrSurfaceCapabilitiesAMD</a>::<code>localDimmingSupport</code> is supported"
|
|
}
|
|
]
|
|
},
|
|
"vkSetLocalDimmingAMD": {
|
|
"(VK_KHR_surface)+(VK_KHR_swapchain)+(VK_AMD_display_native_hdr)": [
|
|
{
|
|
"vuid": "VUID-vkSetLocalDimmingAMD-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkSetLocalDimmingAMD-swapChain-parameter",
|
|
"text": " <code>swapChain</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSwapchainKHR\">VkSwapchainKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkSetLocalDimmingAMD-commonparent",
|
|
"text": " Both of <code>device</code>, and <code>swapChain</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkInstance\">VkInstance</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkSetLocalDimmingAMD-localDimmingSupport-04618",
|
|
"text": " <a href=\"#VkDisplayNativeHdrSurfaceCapabilitiesAMD\">VkDisplayNativeHdrSurfaceCapabilitiesAMD</a>::<code>localDimmingSupport</code> <strong class=\"purple\">must</strong> be supported"
|
|
}
|
|
]
|
|
},
|
|
"VkSwapchainCounterCreateInfoEXT": {
|
|
"(VK_KHR_surface)+(VK_KHR_swapchain)+(VK_EXT_display_control)": [
|
|
{
|
|
"vuid": "VUID-VkSwapchainCounterCreateInfoEXT-surfaceCounters-01244",
|
|
"text": " The bits in <code>surfaceCounters</code> <strong class=\"purple\">must</strong> be supported by <a href=\"#VkSwapchainCreateInfoKHR\">VkSwapchainCreateInfoKHR</a>::<code>surface</code>, as reported by <a href=\"#vkGetPhysicalDeviceSurfaceCapabilities2EXT\">vkGetPhysicalDeviceSurfaceCapabilities2EXT</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSwapchainCounterCreateInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_SWAPCHAIN_COUNTER_CREATE_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkSwapchainCounterCreateInfoEXT-surfaceCounters-parameter",
|
|
"text": " <code>surfaceCounters</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkSurfaceCounterFlagBitsEXT\">VkSurfaceCounterFlagBitsEXT</a> values"
|
|
}
|
|
]
|
|
},
|
|
"vkGetSwapchainCounterEXT": {
|
|
"(VK_KHR_surface)+(VK_KHR_swapchain)+(VK_EXT_display_control)": [
|
|
{
|
|
"vuid": "VUID-vkGetSwapchainCounterEXT-swapchain-01245",
|
|
"text": " One or more present commands on <code>swapchain</code> <strong class=\"purple\">must</strong> have been processed by the presentation engine"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetSwapchainCounterEXT-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetSwapchainCounterEXT-swapchain-parameter",
|
|
"text": " <code>swapchain</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSwapchainKHR\">VkSwapchainKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetSwapchainCounterEXT-counter-parameter",
|
|
"text": " <code>counter</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSurfaceCounterFlagBitsEXT\">VkSurfaceCounterFlagBitsEXT</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetSwapchainCounterEXT-pCounterValue-parameter",
|
|
"text": " <code>pCounterValue</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>uint64_t</code> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetSwapchainCounterEXT-commonparent",
|
|
"text": " Both of <code>device</code>, and <code>swapchain</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkInstance\">VkInstance</a>"
|
|
}
|
|
]
|
|
},
|
|
"vkDestroySwapchainKHR": {
|
|
"(VK_KHR_surface)+(VK_KHR_swapchain)": [
|
|
{
|
|
"vuid": "VUID-vkDestroySwapchainKHR-swapchain-01282",
|
|
"text": " All uses of presentable images acquired from <code>swapchain</code> <strong class=\"purple\">must</strong> have completed execution"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroySwapchainKHR-swapchain-01283",
|
|
"text": " If <code>VkAllocationCallbacks</code> were provided when <code>swapchain</code> was created, a compatible set of callbacks <strong class=\"purple\">must</strong> be provided here"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroySwapchainKHR-swapchain-01284",
|
|
"text": " If no <code>VkAllocationCallbacks</code> were provided when <code>swapchain</code> was created, <code>pAllocator</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroySwapchainKHR-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroySwapchainKHR-swapchain-parameter",
|
|
"text": " If <code>swapchain</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>swapchain</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSwapchainKHR\">VkSwapchainKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroySwapchainKHR-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroySwapchainKHR-commonparent",
|
|
"text": " Both of <code>device</code>, and <code>swapchain</code> that are valid handles of non-ignored parameters <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkInstance\">VkInstance</a>"
|
|
}
|
|
]
|
|
},
|
|
"vkCreateSharedSwapchainsKHR": {
|
|
"(VK_KHR_surface)+(VK_KHR_swapchain)+(VK_KHR_display_swapchain)": [
|
|
{
|
|
"vuid": "VUID-vkCreateSharedSwapchainsKHR-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateSharedSwapchainsKHR-pCreateInfos-parameter",
|
|
"text": " <code>pCreateInfos</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>swapchainCount</code> valid <a href=\"#VkSwapchainCreateInfoKHR\">VkSwapchainCreateInfoKHR</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateSharedSwapchainsKHR-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateSharedSwapchainsKHR-pSwapchains-parameter",
|
|
"text": " <code>pSwapchains</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>swapchainCount</code> <a href=\"#VkSwapchainKHR\">VkSwapchainKHR</a> handles"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateSharedSwapchainsKHR-swapchainCount-arraylength",
|
|
"text": " <code>swapchainCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetSwapchainImagesKHR": {
|
|
"(VK_KHR_surface)+(VK_KHR_swapchain)": [
|
|
{
|
|
"vuid": "VUID-vkGetSwapchainImagesKHR-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetSwapchainImagesKHR-swapchain-parameter",
|
|
"text": " <code>swapchain</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSwapchainKHR\">VkSwapchainKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetSwapchainImagesKHR-pSwapchainImageCount-parameter",
|
|
"text": " <code>pSwapchainImageCount</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>uint32_t</code> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetSwapchainImagesKHR-pSwapchainImages-parameter",
|
|
"text": " If the value referenced by <code>pSwapchainImageCount</code> is not <code>0</code>, and <code>pSwapchainImages</code> is not <code>NULL</code>, <code>pSwapchainImages</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>pSwapchainImageCount</code> <a href=\"#VkImage\">VkImage</a> handles"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetSwapchainImagesKHR-commonparent",
|
|
"text": " Both of <code>device</code>, and <code>swapchain</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkInstance\">VkInstance</a>"
|
|
}
|
|
]
|
|
},
|
|
"vkAcquireNextImageKHR": {
|
|
"(VK_KHR_surface)+(VK_KHR_swapchain)": [
|
|
{
|
|
"vuid": "VUID-vkAcquireNextImageKHR-swapchain-01285",
|
|
"text": " <code>swapchain</code> <strong class=\"purple\">must</strong> not be in the retired state"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkAcquireNextImageKHR-semaphore-01286",
|
|
"text": " If <code>semaphore</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> it <strong class=\"purple\">must</strong> be unsignaled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkAcquireNextImageKHR-semaphore-01779",
|
|
"text": " If <code>semaphore</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> it <strong class=\"purple\">must</strong> not have any uncompleted signal or wait operations pending"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkAcquireNextImageKHR-fence-01287",
|
|
"text": " If <code>fence</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> it <strong class=\"purple\">must</strong> be unsignaled and <strong class=\"purple\">must</strong> not be associated with any other queue command that has not yet completed execution on that queue"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkAcquireNextImageKHR-semaphore-01780",
|
|
"text": " <code>semaphore</code> and <code>fence</code> <strong class=\"purple\">must</strong> not both be equal to <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkAcquireNextImageKHR-swapchain-01802",
|
|
"text": " If the number of currently acquired images is greater than the difference between the number of images in <code>swapchain</code> and the value of <a href=\"#VkSurfaceCapabilitiesKHR\">VkSurfaceCapabilitiesKHR</a>::<code>minImageCount</code> as returned by a call to <a href=\"#vkGetPhysicalDeviceSurfaceCapabilities2KHR\">vkGetPhysicalDeviceSurfaceCapabilities2KHR</a> with the <code>surface</code> used to create <code>swapchain</code>, <code>timeout</code> <strong class=\"purple\">must</strong> not be <code>UINT64_MAX</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkAcquireNextImageKHR-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkAcquireNextImageKHR-swapchain-parameter",
|
|
"text": " <code>swapchain</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSwapchainKHR\">VkSwapchainKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkAcquireNextImageKHR-semaphore-parameter",
|
|
"text": " If <code>semaphore</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>semaphore</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSemaphore\">VkSemaphore</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkAcquireNextImageKHR-fence-parameter",
|
|
"text": " If <code>fence</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>fence</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkFence\">VkFence</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkAcquireNextImageKHR-pImageIndex-parameter",
|
|
"text": " <code>pImageIndex</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>uint32_t</code> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkAcquireNextImageKHR-semaphore-parent",
|
|
"text": " If <code>semaphore</code> is a valid handle, it <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkAcquireNextImageKHR-fence-parent",
|
|
"text": " If <code>fence</code> is a valid handle, it <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkAcquireNextImageKHR-commonparent",
|
|
"text": " Both of <code>device</code>, and <code>swapchain</code> that are valid handles of non-ignored parameters <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkInstance\">VkInstance</a>"
|
|
}
|
|
],
|
|
"(VK_KHR_surface)+(VK_KHR_swapchain)+(VK_VERSION_1_2,VK_KHR_timeline_semaphore)": [
|
|
{
|
|
"vuid": "VUID-vkAcquireNextImageKHR-semaphore-03265",
|
|
"text": " <code>semaphore</code> <strong class=\"purple\">must</strong> have a <a href=\"#VkSemaphoreType\">VkSemaphoreType</a> of <code>VK_SEMAPHORE_TYPE_BINARY</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkAcquireNextImage2KHR": {
|
|
"(VK_KHR_surface)+(VK_KHR_swapchain)+(VK_VERSION_1_1,VK_KHR_device_group)": [
|
|
{
|
|
"vuid": "VUID-vkAcquireNextImage2KHR-swapchain-01803",
|
|
"text": " If the number of currently acquired images is greater than the difference between the number of images in the <code>swapchain</code> member of <code>pAcquireInfo</code> and the value of <a href=\"#VkSurfaceCapabilitiesKHR\">VkSurfaceCapabilitiesKHR</a>::<code>minImageCount</code> as returned by a call to <a href=\"#vkGetPhysicalDeviceSurfaceCapabilities2KHR\">vkGetPhysicalDeviceSurfaceCapabilities2KHR</a> with the <code>surface</code> used to create <code>swapchain</code>, the <code>timeout</code> member of <code>pAcquireInfo</code> <strong class=\"purple\">must</strong> not be <code>UINT64_MAX</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkAcquireNextImage2KHR-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkAcquireNextImage2KHR-pAcquireInfo-parameter",
|
|
"text": " <code>pAcquireInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAcquireNextImageInfoKHR\">VkAcquireNextImageInfoKHR</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkAcquireNextImage2KHR-pImageIndex-parameter",
|
|
"text": " <code>pImageIndex</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>uint32_t</code> value"
|
|
}
|
|
]
|
|
},
|
|
"VkAcquireNextImageInfoKHR": {
|
|
"(VK_KHR_surface)+(VK_KHR_swapchain)+(VK_VERSION_1_1,VK_KHR_device_group)": [
|
|
{
|
|
"vuid": "VUID-VkAcquireNextImageInfoKHR-swapchain-01675",
|
|
"text": " <code>swapchain</code> <strong class=\"purple\">must</strong> not be in the retired state"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAcquireNextImageInfoKHR-semaphore-01288",
|
|
"text": " If <code>semaphore</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> it <strong class=\"purple\">must</strong> be unsignaled"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAcquireNextImageInfoKHR-semaphore-01781",
|
|
"text": " If <code>semaphore</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> it <strong class=\"purple\">must</strong> not have any uncompleted signal or wait operations pending"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAcquireNextImageInfoKHR-fence-01289",
|
|
"text": " If <code>fence</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> it <strong class=\"purple\">must</strong> be unsignaled and <strong class=\"purple\">must</strong> not be associated with any other queue command that has not yet completed execution on that queue"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAcquireNextImageInfoKHR-semaphore-01782",
|
|
"text": " <code>semaphore</code> and <code>fence</code> <strong class=\"purple\">must</strong> not both be equal to <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAcquireNextImageInfoKHR-deviceMask-01290",
|
|
"text": " <code>deviceMask</code> <strong class=\"purple\">must</strong> be a valid device mask"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAcquireNextImageInfoKHR-deviceMask-01291",
|
|
"text": " <code>deviceMask</code> <strong class=\"purple\">must</strong> not be zero"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAcquireNextImageInfoKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_ACQUIRE_NEXT_IMAGE_INFO_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAcquireNextImageInfoKHR-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAcquireNextImageInfoKHR-swapchain-parameter",
|
|
"text": " <code>swapchain</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSwapchainKHR\">VkSwapchainKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAcquireNextImageInfoKHR-semaphore-parameter",
|
|
"text": " If <code>semaphore</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>semaphore</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSemaphore\">VkSemaphore</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAcquireNextImageInfoKHR-fence-parameter",
|
|
"text": " If <code>fence</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>fence</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkFence\">VkFence</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAcquireNextImageInfoKHR-commonparent",
|
|
"text": " Each of <code>fence</code>, <code>semaphore</code>, and <code>swapchain</code> that are valid handles of non-ignored parameters <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkInstance\">VkInstance</a>"
|
|
}
|
|
],
|
|
"(VK_KHR_surface)+(VK_KHR_swapchain)+(VK_VERSION_1_1,VK_KHR_device_group)+(VK_VERSION_1_2,VK_KHR_timeline_semaphore)": [
|
|
{
|
|
"vuid": "VUID-VkAcquireNextImageInfoKHR-semaphore-03266",
|
|
"text": " <code>semaphore</code> <strong class=\"purple\">must</strong> have a <a href=\"#VkSemaphoreType\">VkSemaphoreType</a> of <code>VK_SEMAPHORE_TYPE_BINARY</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkQueuePresentKHR": {
|
|
"(VK_KHR_surface)+(VK_KHR_swapchain)": [
|
|
{
|
|
"vuid": "VUID-vkQueuePresentKHR-pSwapchains-01292",
|
|
"text": " Each element of <code>pSwapchains</code> member of <code>pPresentInfo</code> <strong class=\"purple\">must</strong> be a swapchain that is created for a surface for which presentation is supported from <code>queue</code> as determined using a call to <code>vkGetPhysicalDeviceSurfaceSupportKHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkQueuePresentKHR-pWaitSemaphores-01294",
|
|
"text": " When a semaphore wait operation referring to a binary semaphore defined by the elements of the <code>pWaitSemaphores</code> member of <code>pPresentInfo</code> executes on <code>queue</code>, there <strong class=\"purple\">must</strong> be no other queues waiting on the same semaphore"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkQueuePresentKHR-pWaitSemaphores-01295",
|
|
"text": " All elements of the <code>pWaitSemaphores</code> member of <code>pPresentInfo</code> <strong class=\"purple\">must</strong> be semaphores that are signaled, or have <a href=\"#synchronization-semaphores-signaling\">semaphore signal operations</a> previously submitted for execution"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkQueuePresentKHR-queue-parameter",
|
|
"text": " <code>queue</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkQueue\">VkQueue</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkQueuePresentKHR-pPresentInfo-parameter",
|
|
"text": " <code>pPresentInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkPresentInfoKHR\">VkPresentInfoKHR</a> structure"
|
|
}
|
|
],
|
|
"(VK_KHR_surface)+(VK_KHR_swapchain)+(VK_KHR_display_swapchain)": [
|
|
{
|
|
"vuid": "VUID-vkQueuePresentKHR-pSwapchains-01293",
|
|
"text": " If more than one member of <code>pSwapchains</code> was created from a display surface, all display surfaces referenced that refer to the same display <strong class=\"purple\">must</strong> use the same display mode"
|
|
}
|
|
],
|
|
"(VK_KHR_surface)+(VK_KHR_swapchain)+(VK_VERSION_1_2,VK_KHR_timeline_semaphore)": [
|
|
{
|
|
"vuid": "VUID-vkQueuePresentKHR-pWaitSemaphores-03267",
|
|
"text": " All elements of the <code>pWaitSemaphores</code> member of <code>pPresentInfo</code> <strong class=\"purple\">must</strong> be created with a <a href=\"#VkSemaphoreType\">VkSemaphoreType</a> of <code>VK_SEMAPHORE_TYPE_BINARY</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkQueuePresentKHR-pWaitSemaphores-03268",
|
|
"text": " All elements of the <code>pWaitSemaphores</code> member of <code>pPresentInfo</code> <strong class=\"purple\">must</strong> reference a semaphore signal operation that has been submitted for execution and any semaphore signal operations on which it depends (if any) <strong class=\"purple\">must</strong> have also been submitted for execution"
|
|
}
|
|
]
|
|
},
|
|
"VkPresentInfoKHR": {
|
|
"(VK_KHR_surface)+(VK_KHR_swapchain)+!(VK_KHR_shared_presentable_image)": [
|
|
{
|
|
"vuid": "VUID-VkPresentInfoKHR-pImageIndices-01296",
|
|
"text": " Each element of <code>pImageIndices</code> <strong class=\"purple\">must</strong> be the index of a presentable image acquired from the swapchain specified by the corresponding element of the <code>pSwapchains</code> array, and the presented image subresource <strong class=\"purple\">must</strong> be in the <code>VK_IMAGE_LAYOUT_PRESENT_SRC_KHR</code> layout at the time the operation is executed on a <code>VkDevice</code>"
|
|
}
|
|
],
|
|
"(VK_KHR_surface)+(VK_KHR_swapchain)+(VK_KHR_shared_presentable_image)": [
|
|
{
|
|
"vuid": "VUID-VkPresentInfoKHR-pImageIndices-01430",
|
|
"text": " Each element of <code>pImageIndices</code> <strong class=\"purple\">must</strong> be the index of a presentable image acquired from the swapchain specified by the corresponding element of the <code>pSwapchains</code> array, and the presented image subresource <strong class=\"purple\">must</strong> be in the <code>VK_IMAGE_LAYOUT_PRESENT_SRC_KHR</code> or <code>VK_IMAGE_LAYOUT_SHARED_PRESENT_KHR</code> layout at the time the operation is executed on a <code>VkDevice</code>"
|
|
}
|
|
],
|
|
"(VK_KHR_surface)+(VK_KHR_swapchain)+(VK_KHR_present_id)": [
|
|
{
|
|
"vuid": "VUID-VkPresentInfoKHR-pNext-06235",
|
|
"text": " If a <a href=\"#VkPresentIdKHR\">VkPresentIdKHR</a> structure is included in the <code>pNext</code> chain, and the <a href=\"#features-presentId\"><code>presentId</code></a> feature is not enabled, each <code>presentIds</code> entry in that structure <strong class=\"purple\">must</strong> be NULL"
|
|
}
|
|
],
|
|
"(VK_KHR_surface)+(VK_KHR_swapchain)": [
|
|
{
|
|
"vuid": "VUID-VkPresentInfoKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PRESENT_INFO_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPresentInfoKHR-pNext-pNext",
|
|
"text": " Each <code>pNext</code> member of any structure (including this one) in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be either <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkDeviceGroupPresentInfoKHR\">VkDeviceGroupPresentInfoKHR</a>, <a href=\"#VkDisplayPresentInfoKHR\">VkDisplayPresentInfoKHR</a>, <a href=\"#VkPresentFrameTokenGGP\">VkPresentFrameTokenGGP</a>, <a href=\"#VkPresentIdKHR\">VkPresentIdKHR</a>, <a href=\"#VkPresentRegionsKHR\">VkPresentRegionsKHR</a>, or <a href=\"#VkPresentTimesInfoGOOGLE\">VkPresentTimesInfoGOOGLE</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPresentInfoKHR-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPresentInfoKHR-pWaitSemaphores-parameter",
|
|
"text": " If <code>waitSemaphoreCount</code> is not <code>0</code>, <code>pWaitSemaphores</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>waitSemaphoreCount</code> valid <a href=\"#VkSemaphore\">VkSemaphore</a> handles"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPresentInfoKHR-pSwapchains-parameter",
|
|
"text": " <code>pSwapchains</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>swapchainCount</code> valid <a href=\"#VkSwapchainKHR\">VkSwapchainKHR</a> handles"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPresentInfoKHR-pImageIndices-parameter",
|
|
"text": " <code>pImageIndices</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>swapchainCount</code> <code>uint32_t</code> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPresentInfoKHR-pResults-parameter",
|
|
"text": " If <code>pResults</code> is not <code>NULL</code>, <code>pResults</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>swapchainCount</code> <a href=\"#VkResult\">VkResult</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPresentInfoKHR-swapchainCount-arraylength",
|
|
"text": " <code>swapchainCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPresentInfoKHR-commonparent",
|
|
"text": " Both of the elements of <code>pSwapchains</code>, and the elements of <code>pWaitSemaphores</code> that are valid handles of non-ignored parameters <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkInstance\">VkInstance</a>"
|
|
}
|
|
]
|
|
},
|
|
"VkPresentRegionsKHR": {
|
|
"(VK_KHR_surface)+(VK_KHR_swapchain)+(VK_KHR_incremental_present)": [
|
|
{
|
|
"vuid": "VUID-VkPresentRegionsKHR-swapchainCount-01260",
|
|
"text": " <code>swapchainCount</code> <strong class=\"purple\">must</strong> be the same value as <code>VkPresentInfoKHR</code>::<code>swapchainCount</code>, where <code>VkPresentInfoKHR</code> is included in the <code>pNext</code> chain of this <code>VkPresentRegionsKHR</code> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPresentRegionsKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PRESENT_REGIONS_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPresentRegionsKHR-pRegions-parameter",
|
|
"text": " If <code>pRegions</code> is not <code>NULL</code>, <code>pRegions</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>swapchainCount</code> valid <a href=\"#VkPresentRegionKHR\">VkPresentRegionKHR</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPresentRegionsKHR-swapchainCount-arraylength",
|
|
"text": " <code>swapchainCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPresentRegionKHR": {
|
|
"(VK_KHR_surface)+(VK_KHR_swapchain)+(VK_KHR_incremental_present)": [
|
|
{
|
|
"vuid": "VUID-VkPresentRegionKHR-pRectangles-parameter",
|
|
"text": " If <code>rectangleCount</code> is not <code>0</code>, and <code>pRectangles</code> is not <code>NULL</code>, <code>pRectangles</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>rectangleCount</code> valid <a href=\"#VkRectLayerKHR\">VkRectLayerKHR</a> structures"
|
|
}
|
|
]
|
|
},
|
|
"VkRectLayerKHR": {
|
|
"(VK_KHR_surface)+(VK_KHR_swapchain)+(VK_KHR_incremental_present)": [
|
|
{
|
|
"vuid": "VUID-VkRectLayerKHR-offset-04864",
|
|
"text": " The sum of <code>offset</code> and <code>extent</code>, after being transformed according to the <code>preTransform</code> member of the <a href=\"#VkSwapchainCreateInfoKHR\">VkSwapchainCreateInfoKHR</a> structure, <strong class=\"purple\">must</strong> be no greater than the <code>imageExtent</code> member of the <a href=\"#VkSwapchainCreateInfoKHR\">VkSwapchainCreateInfoKHR</a> structure passed to <a href=\"#vkCreateSwapchainKHR\">vkCreateSwapchainKHR</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkRectLayerKHR-layer-01262",
|
|
"text": " <code>layer</code> <strong class=\"purple\">must</strong> be less than the <code>imageArrayLayers</code> member of the <a href=\"#VkSwapchainCreateInfoKHR\">VkSwapchainCreateInfoKHR</a> structure passed to <a href=\"#vkCreateSwapchainKHR\">vkCreateSwapchainKHR</a>"
|
|
}
|
|
]
|
|
},
|
|
"VkDisplayPresentInfoKHR": {
|
|
"(VK_KHR_surface)+(VK_KHR_swapchain)+(VK_KHR_display_swapchain)": [
|
|
{
|
|
"vuid": "VUID-VkDisplayPresentInfoKHR-srcRect-01257",
|
|
"text": " <code>srcRect</code> <strong class=\"purple\">must</strong> specify a rectangular region that is a subset of the image being presented"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDisplayPresentInfoKHR-dstRect-01258",
|
|
"text": " <code>dstRect</code> <strong class=\"purple\">must</strong> specify a rectangular region that is a subset of the <code>visibleRegion</code> parameter of the display mode the swapchain being presented uses"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDisplayPresentInfoKHR-persistentContent-01259",
|
|
"text": " If the <code>persistentContent</code> member of the <code>VkDisplayPropertiesKHR</code> structure returned by <code>vkGetPhysicalDeviceDisplayPropertiesKHR</code> for the display the present operation targets is <code>VK_FALSE</code>, then <code>persistent</code> <strong class=\"purple\">must</strong> be <code>VK_FALSE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDisplayPresentInfoKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_DISPLAY_PRESENT_INFO_KHR</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkDeviceGroupPresentInfoKHR": {
|
|
"(VK_KHR_surface)+(VK_KHR_swapchain)+(VK_VERSION_1_1,VK_KHR_device_group)": [
|
|
{
|
|
"vuid": "VUID-VkDeviceGroupPresentInfoKHR-swapchainCount-01297",
|
|
"text": " <code>swapchainCount</code> <strong class=\"purple\">must</strong> equal <code>0</code> or <a href=\"#VkPresentInfoKHR\">VkPresentInfoKHR</a>::<code>swapchainCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceGroupPresentInfoKHR-mode-01298",
|
|
"text": " If <code>mode</code> is <code>VK_DEVICE_GROUP_PRESENT_MODE_LOCAL_BIT_KHR</code>, then each element of <code>pDeviceMasks</code> <strong class=\"purple\">must</strong> have exactly one bit set, and the corresponding element of <a href=\"#VkDeviceGroupPresentCapabilitiesKHR\">VkDeviceGroupPresentCapabilitiesKHR</a>::<code>presentMask</code> <strong class=\"purple\">must</strong> be non-zero"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceGroupPresentInfoKHR-mode-01299",
|
|
"text": " If <code>mode</code> is <code>VK_DEVICE_GROUP_PRESENT_MODE_REMOTE_BIT_KHR</code>, then each element of <code>pDeviceMasks</code> <strong class=\"purple\">must</strong> have exactly one bit set, and some physical device in the logical device <strong class=\"purple\">must</strong> include that bit in its <a href=\"#VkDeviceGroupPresentCapabilitiesKHR\">VkDeviceGroupPresentCapabilitiesKHR</a>::<code>presentMask</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceGroupPresentInfoKHR-mode-01300",
|
|
"text": " If <code>mode</code> is <code>VK_DEVICE_GROUP_PRESENT_MODE_SUM_BIT_KHR</code>, then each element of <code>pDeviceMasks</code> <strong class=\"purple\">must</strong> have a value for which all set bits are set in one of the elements of <a href=\"#VkDeviceGroupPresentCapabilitiesKHR\">VkDeviceGroupPresentCapabilitiesKHR</a>::<code>presentMask</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceGroupPresentInfoKHR-mode-01301",
|
|
"text": " If <code>mode</code> is <code>VK_DEVICE_GROUP_PRESENT_MODE_LOCAL_MULTI_DEVICE_BIT_KHR</code>, then for each bit set in each element of <code>pDeviceMasks</code>, the corresponding element of <a href=\"#VkDeviceGroupPresentCapabilitiesKHR\">VkDeviceGroupPresentCapabilitiesKHR</a>::<code>presentMask</code> <strong class=\"purple\">must</strong> be non-zero"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceGroupPresentInfoKHR-pDeviceMasks-01302",
|
|
"text": " The value of each element of <code>pDeviceMasks</code> <strong class=\"purple\">must</strong> be equal to the device mask passed in <a href=\"#VkAcquireNextImageInfoKHR\">VkAcquireNextImageInfoKHR</a>::<code>deviceMask</code> when the image index was last acquired"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceGroupPresentInfoKHR-mode-01303",
|
|
"text": " <code>mode</code> <strong class=\"purple\">must</strong> have exactly one bit set, and that bit <strong class=\"purple\">must</strong> have been included in <a href=\"#VkDeviceGroupSwapchainCreateInfoKHR\">VkDeviceGroupSwapchainCreateInfoKHR</a>::<code>modes</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceGroupPresentInfoKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_DEVICE_GROUP_PRESENT_INFO_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceGroupPresentInfoKHR-pDeviceMasks-parameter",
|
|
"text": " If <code>swapchainCount</code> is not <code>0</code>, <code>pDeviceMasks</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>swapchainCount</code> <code>uint32_t</code> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDeviceGroupPresentInfoKHR-mode-parameter",
|
|
"text": " <code>mode</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDeviceGroupPresentModeFlagBitsKHR\">VkDeviceGroupPresentModeFlagBitsKHR</a> value"
|
|
}
|
|
]
|
|
},
|
|
"VkPresentTimesInfoGOOGLE": {
|
|
"(VK_KHR_surface)+(VK_KHR_swapchain)+(VK_GOOGLE_display_timing)": [
|
|
{
|
|
"vuid": "VUID-VkPresentTimesInfoGOOGLE-swapchainCount-01247",
|
|
"text": " <code>swapchainCount</code> <strong class=\"purple\">must</strong> be the same value as <code>VkPresentInfoKHR</code>::<code>swapchainCount</code>, where <code>VkPresentInfoKHR</code> is included in the <code>pNext</code> chain of this <code>VkPresentTimesInfoGOOGLE</code> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPresentTimesInfoGOOGLE-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PRESENT_TIMES_INFO_GOOGLE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPresentTimesInfoGOOGLE-pTimes-parameter",
|
|
"text": " If <code>pTimes</code> is not <code>NULL</code>, <code>pTimes</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>swapchainCount</code> <a href=\"#VkPresentTimeGOOGLE\">VkPresentTimeGOOGLE</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPresentTimesInfoGOOGLE-swapchainCount-arraylength",
|
|
"text": " <code>swapchainCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPresentIdKHR": {
|
|
"(VK_KHR_surface)+(VK_KHR_swapchain)+(VK_KHR_present_id)": [
|
|
{
|
|
"vuid": "VUID-VkPresentIdKHR-swapchainCount-04998",
|
|
"text": " <code>swapchainCount</code> <strong class=\"purple\">must</strong> be the same value as <code>VkPresentInfoKHR</code>::<code>swapchainCount</code>, where this <code>VkPresentIdKHR</code> is in the <code>pNext</code> chain of the <code>VkPresentInfoKHR</code> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPresentIdKHR-presentIds-04999",
|
|
"text": " Each <code>presentIds</code> entry <strong class=\"purple\">must</strong> be greater than any previous <code>presentIds</code> entry passed for the associated <code>pSwapchains</code> entry"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPresentIdKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PRESENT_ID_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPresentIdKHR-pPresentIds-parameter",
|
|
"text": " If <code>pPresentIds</code> is not <code>NULL</code>, <code>pPresentIds</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>swapchainCount</code> <code>uint64_t</code> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPresentIdKHR-swapchainCount-arraylength",
|
|
"text": " <code>swapchainCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkWaitForPresentKHR": {
|
|
"(VK_KHR_surface)+(VK_KHR_swapchain)+(VK_KHR_present_id)+(VK_KHR_present_wait)": [
|
|
{
|
|
"vuid": "VUID-vkWaitForPresentKHR-swapchain-04997",
|
|
"text": " <code>swapchain</code> <strong class=\"purple\">must</strong> not be in the retired state"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkWaitForPresentKHR-presentWait-06234",
|
|
"text": " The <a href=\"#features-presentWait\"><code>presentWait</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkWaitForPresentKHR-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkWaitForPresentKHR-swapchain-parameter",
|
|
"text": " <code>swapchain</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSwapchainKHR\">VkSwapchainKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkWaitForPresentKHR-commonparent",
|
|
"text": " Both of <code>device</code>, and <code>swapchain</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkInstance\">VkInstance</a>"
|
|
}
|
|
]
|
|
},
|
|
"VkPresentFrameTokenGGP": {
|
|
"(VK_KHR_surface)+(VK_KHR_swapchain)+(VK_GGP_frame_token)": [
|
|
{
|
|
"vuid": "VUID-VkPresentFrameTokenGGP-frameToken-02680",
|
|
"text": " <code>frameToken</code> <strong class=\"purple\">must</strong> be a valid <code>GgpFrameToken</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPresentFrameTokenGGP-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PRESENT_FRAME_TOKEN_GGP</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkSetHdrMetadataEXT": {
|
|
"(VK_KHR_surface)+(VK_KHR_swapchain)+(VK_EXT_hdr_metadata)": [
|
|
{
|
|
"vuid": "VUID-vkSetHdrMetadataEXT-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkSetHdrMetadataEXT-pSwapchains-parameter",
|
|
"text": " <code>pSwapchains</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>swapchainCount</code> valid <a href=\"#VkSwapchainKHR\">VkSwapchainKHR</a> handles"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkSetHdrMetadataEXT-pMetadata-parameter",
|
|
"text": " <code>pMetadata</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>swapchainCount</code> valid <a href=\"#VkHdrMetadataEXT\">VkHdrMetadataEXT</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkSetHdrMetadataEXT-swapchainCount-arraylength",
|
|
"text": " <code>swapchainCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkSetHdrMetadataEXT-commonparent",
|
|
"text": " Both of <code>device</code>, and the elements of <code>pSwapchains</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkInstance\">VkInstance</a>"
|
|
}
|
|
]
|
|
},
|
|
"VkHdrMetadataEXT": {
|
|
"(VK_KHR_surface)+(VK_KHR_swapchain)+(VK_EXT_hdr_metadata)": [
|
|
{
|
|
"vuid": "VUID-VkHdrMetadataEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_HDR_METADATA_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkHdrMetadataEXT-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCreateDeferredOperationKHR": {
|
|
"(VK_KHR_deferred_host_operations)": [
|
|
{
|
|
"vuid": "VUID-vkCreateDeferredOperationKHR-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateDeferredOperationKHR-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateDeferredOperationKHR-pDeferredOperation-parameter",
|
|
"text": " <code>pDeferredOperation</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkDeferredOperationKHR\">VkDeferredOperationKHR</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"vkDeferredOperationJoinKHR": {
|
|
"(VK_KHR_deferred_host_operations)": [
|
|
{
|
|
"vuid": "VUID-vkDeferredOperationJoinKHR-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDeferredOperationJoinKHR-operation-parameter",
|
|
"text": " <code>operation</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDeferredOperationKHR\">VkDeferredOperationKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDeferredOperationJoinKHR-operation-parent",
|
|
"text": " <code>operation</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkDestroyDeferredOperationKHR": {
|
|
"(VK_KHR_deferred_host_operations)": [
|
|
{
|
|
"vuid": "VUID-vkDestroyDeferredOperationKHR-operation-03434",
|
|
"text": " If <code>VkAllocationCallbacks</code> were provided when <code>operation</code> was created, a compatible set of callbacks <strong class=\"purple\">must</strong> be provided here"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyDeferredOperationKHR-operation-03435",
|
|
"text": " If no <code>VkAllocationCallbacks</code> were provided when <code>operation</code> was created, <code>pAllocator</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyDeferredOperationKHR-operation-03436",
|
|
"text": " <code>operation</code> <strong class=\"purple\">must</strong> be completed"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyDeferredOperationKHR-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyDeferredOperationKHR-operation-parameter",
|
|
"text": " If <code>operation</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>operation</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDeferredOperationKHR\">VkDeferredOperationKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyDeferredOperationKHR-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyDeferredOperationKHR-operation-parent",
|
|
"text": " If <code>operation</code> is a valid handle, it <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetDeferredOperationMaxConcurrencyKHR": {
|
|
"(VK_KHR_deferred_host_operations)": [
|
|
{
|
|
"vuid": "VUID-vkGetDeferredOperationMaxConcurrencyKHR-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDeferredOperationMaxConcurrencyKHR-operation-parameter",
|
|
"text": " <code>operation</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDeferredOperationKHR\">VkDeferredOperationKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDeferredOperationMaxConcurrencyKHR-operation-parent",
|
|
"text": " <code>operation</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetDeferredOperationResultKHR": {
|
|
"(VK_KHR_deferred_host_operations)": [
|
|
{
|
|
"vuid": "VUID-vkGetDeferredOperationResultKHR-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDeferredOperationResultKHR-operation-parameter",
|
|
"text": " <code>operation</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDeferredOperationKHR\">VkDeferredOperationKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDeferredOperationResultKHR-operation-parent",
|
|
"text": " <code>operation</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCreatePrivateDataSlot": {
|
|
"(VK_VERSION_1_3,VK_EXT_private_data)": [
|
|
{
|
|
"vuid": "VUID-vkCreatePrivateDataSlot-privateData-04564",
|
|
"text": " The <a href=\"#features-privateData\"><code>privateData</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreatePrivateDataSlot-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreatePrivateDataSlot-pCreateInfo-parameter",
|
|
"text": " <code>pCreateInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkPrivateDataSlotCreateInfo\">VkPrivateDataSlotCreateInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreatePrivateDataSlot-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreatePrivateDataSlot-pPrivateDataSlot-parameter",
|
|
"text": " <code>pPrivateDataSlot</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkPrivateDataSlot\">VkPrivateDataSlot</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkPrivateDataSlotCreateInfo": {
|
|
"(VK_VERSION_1_3,VK_EXT_private_data)": [
|
|
{
|
|
"vuid": "VUID-VkPrivateDataSlotCreateInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PRIVATE_DATA_SLOT_CREATE_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPrivateDataSlotCreateInfo-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPrivateDataSlotCreateInfo-flags-zerobitmask",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkDestroyPrivateDataSlot": {
|
|
"(VK_VERSION_1_3,VK_EXT_private_data)": [
|
|
{
|
|
"vuid": "VUID-vkDestroyPrivateDataSlot-privateDataSlot-04062",
|
|
"text": " If <code>VkAllocationCallbacks</code> were provided when <code>privateDataSlot</code> was created, a compatible set of callbacks <strong class=\"purple\">must</strong> be provided here"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyPrivateDataSlot-privateDataSlot-04063",
|
|
"text": " If no <code>VkAllocationCallbacks</code> were provided when <code>privateDataSlot</code> was created, <code>pAllocator</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyPrivateDataSlot-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyPrivateDataSlot-privateDataSlot-parameter",
|
|
"text": " If <code>privateDataSlot</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>privateDataSlot</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPrivateDataSlot\">VkPrivateDataSlot</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyPrivateDataSlot-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyPrivateDataSlot-privateDataSlot-parent",
|
|
"text": " If <code>privateDataSlot</code> is a valid handle, it <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkSetPrivateData": {
|
|
"(VK_VERSION_1_3,VK_EXT_private_data)": [
|
|
{
|
|
"vuid": "VUID-vkSetPrivateData-objectHandle-04016",
|
|
"text": " <code>objectHandle</code> <strong class=\"purple\">must</strong> be <code>device</code> or a child of <code>device</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkSetPrivateData-objectHandle-04017",
|
|
"text": " <code>objectHandle</code> <strong class=\"purple\">must</strong> be a valid handle to an object of type <code>objectType</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkSetPrivateData-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkSetPrivateData-objectType-parameter",
|
|
"text": " <code>objectType</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkObjectType\">VkObjectType</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkSetPrivateData-privateDataSlot-parameter",
|
|
"text": " <code>privateDataSlot</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPrivateDataSlot\">VkPrivateDataSlot</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkSetPrivateData-privateDataSlot-parent",
|
|
"text": " <code>privateDataSlot</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetPrivateData": {
|
|
"(VK_VERSION_1_3,VK_EXT_private_data)": [
|
|
{
|
|
"vuid": "VUID-vkGetPrivateData-objectType-04018",
|
|
"text": " <code>objectType</code> <strong class=\"purple\">must</strong> be <code>VK_OBJECT_TYPE_DEVICE</code>, or an object type whose parent is <a href=\"#VkDevice\">VkDevice</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPrivateData-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPrivateData-objectType-parameter",
|
|
"text": " <code>objectType</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkObjectType\">VkObjectType</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPrivateData-privateDataSlot-parameter",
|
|
"text": " <code>privateDataSlot</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPrivateDataSlot\">VkPrivateDataSlot</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPrivateData-pData-parameter",
|
|
"text": " <code>pData</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>uint64_t</code> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPrivateData-privateDataSlot-parent",
|
|
"text": " <code>privateDataSlot</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdBuildAccelerationStructureNV": {
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)+(VK_NV_ray_tracing)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructureNV-geometryCount-02241",
|
|
"text": " <code>geometryCount</code> <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#VkPhysicalDeviceRayTracingPropertiesNV\">VkPhysicalDeviceRayTracingPropertiesNV</a>::<code>maxGeometryCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructureNV-dst-02488",
|
|
"text": " <code>dst</code> <strong class=\"purple\">must</strong> have been created with compatible <a href=\"#VkAccelerationStructureInfoNV\">VkAccelerationStructureInfoNV</a> where <a href=\"#VkAccelerationStructureInfoNV\">VkAccelerationStructureInfoNV</a>::<code>type</code> and <a href=\"#VkAccelerationStructureInfoNV\">VkAccelerationStructureInfoNV</a>::<code>flags</code> are identical, <a href=\"#VkAccelerationStructureInfoNV\">VkAccelerationStructureInfoNV</a>::<code>instanceCount</code> and <a href=\"#VkAccelerationStructureInfoNV\">VkAccelerationStructureInfoNV</a>::<code>geometryCount</code> for <code>dst</code> are greater than or equal to the build size and each geometry in <a href=\"#VkAccelerationStructureInfoNV\">VkAccelerationStructureInfoNV</a>::<code>pGeometries</code> for <code>dst</code> has greater than or equal to the number of vertices, indices, and AABBs"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructureNV-update-02489",
|
|
"text": " If <code>update</code> is <code>VK_TRUE</code>, <code>src</code> <strong class=\"purple\">must</strong> not be <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructureNV-update-02490",
|
|
"text": " If <code>update</code> is <code>VK_TRUE</code>, <code>src</code> <strong class=\"purple\">must</strong> have previously been constructed with <code>VK_BUILD_ACCELERATION_STRUCTURE_ALLOW_UPDATE_BIT_NV</code> set in <a href=\"#VkAccelerationStructureInfoNV\">VkAccelerationStructureInfoNV</a>::<code>flags</code> in the original build"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructureNV-update-02491",
|
|
"text": " If <code>update</code> is <code>VK_FALSE</code>, the <code>size</code> member of the <a href=\"#VkMemoryRequirements\">VkMemoryRequirements</a> structure returned from a call to <a href=\"#vkGetAccelerationStructureMemoryRequirementsNV\">vkGetAccelerationStructureMemoryRequirementsNV</a> with <a href=\"#VkAccelerationStructureMemoryRequirementsInfoNV\">VkAccelerationStructureMemoryRequirementsInfoNV</a>::<code>accelerationStructure</code> set to <code>dst</code> and <a href=\"#VkAccelerationStructureMemoryRequirementsInfoNV\">VkAccelerationStructureMemoryRequirementsInfoNV</a>::<code>type</code> set to <code>VK_ACCELERATION_STRUCTURE_MEMORY_REQUIREMENTS_TYPE_BUILD_SCRATCH_NV</code> <strong class=\"purple\">must</strong> be less than or equal to the size of <code>scratch</code> minus <code>scratchOffset</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructureNV-update-02492",
|
|
"text": " If <code>update</code> is <code>VK_TRUE</code>, the <code>size</code> member of the <a href=\"#VkMemoryRequirements\">VkMemoryRequirements</a> structure returned from a call to <a href=\"#vkGetAccelerationStructureMemoryRequirementsNV\">vkGetAccelerationStructureMemoryRequirementsNV</a> with <a href=\"#VkAccelerationStructureMemoryRequirementsInfoNV\">VkAccelerationStructureMemoryRequirementsInfoNV</a>::<code>accelerationStructure</code> set to <code>dst</code> and <a href=\"#VkAccelerationStructureMemoryRequirementsInfoNV\">VkAccelerationStructureMemoryRequirementsInfoNV</a>::<code>type</code> set to <code>VK_ACCELERATION_STRUCTURE_MEMORY_REQUIREMENTS_TYPE_UPDATE_SCRATCH_NV</code> <strong class=\"purple\">must</strong> be less than or equal to the size of <code>scratch</code> minus <code>scratchOffset</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructureNV-scratch-03522",
|
|
"text": " <code>scratch</code> <strong class=\"purple\">must</strong> have been created with <code>VK_BUFFER_USAGE_RAY_TRACING_BIT_NV</code> usage flag"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructureNV-instanceData-03523",
|
|
"text": " If <code>instanceData</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>instanceData</code> <strong class=\"purple\">must</strong> have been created with <code>VK_BUFFER_USAGE_RAY_TRACING_BIT_NV</code> usage flag"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructureNV-accelerationStructureReference-03786",
|
|
"text": " Each <a href=\"#VkAccelerationStructureInstanceKHR\">VkAccelerationStructureInstanceKHR</a>::<code>accelerationStructureReference</code> value in <code>instanceData</code> <strong class=\"purple\">must</strong> be a valid device address containing a value obtained from <a href=\"#vkGetAccelerationStructureHandleNV\">vkGetAccelerationStructureHandleNV</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructureNV-update-03524",
|
|
"text": " If <code>update</code> is <code>VK_TRUE</code>, then objects that were previously active <strong class=\"purple\">must</strong> not be made inactive as per <a href=\"#acceleration-structure-inactive-prims\">Inactive Primitives and Instances</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructureNV-update-03525",
|
|
"text": " If <code>update</code> is <code>VK_TRUE</code>, then objects that were previously inactive <strong class=\"purple\">must</strong> not be made active as per <a href=\"#acceleration-structure-inactive-prims\">Inactive Primitives and Instances</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructureNV-update-03526",
|
|
"text": " If <code>update</code> is <code>VK_TRUE</code>, the <code>src</code> and <code>dst</code> objects <strong class=\"purple\">must</strong> either be the same object or not have any <a href=\"#resources-memory-aliasing\">memory aliasing</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructureNV-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructureNV-pInfo-parameter",
|
|
"text": " <code>pInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAccelerationStructureInfoNV\">VkAccelerationStructureInfoNV</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructureNV-instanceData-parameter",
|
|
"text": " If <code>instanceData</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>instanceData</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBuffer\">VkBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructureNV-dst-parameter",
|
|
"text": " <code>dst</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkAccelerationStructureNV\">VkAccelerationStructureNV</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructureNV-src-parameter",
|
|
"text": " If <code>src</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>src</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkAccelerationStructureNV\">VkAccelerationStructureNV</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructureNV-scratch-parameter",
|
|
"text": " <code>scratch</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBuffer\">VkBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructureNV-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructureNV-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support compute operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructureNV-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructureNV-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructureNV-commonparent",
|
|
"text": " Each of <code>commandBuffer</code>, <code>dst</code>, <code>instanceData</code>, <code>scratch</code>, and <code>src</code> that are valid handles of non-ignored parameters <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdBuildAccelerationStructuresKHR": {
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)+(VK_KHR_acceleration_structure)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-mode-04628",
|
|
"text": " The <code>mode</code> member of each element of <code>pInfos</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBuildAccelerationStructureModeKHR\">VkBuildAccelerationStructureModeKHR</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-srcAccelerationStructure-04629",
|
|
"text": " If the <code>srcAccelerationStructure</code> member of any element of <code>pInfos</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the <code>srcAccelerationStructure</code> member <strong class=\"purple\">must</strong> be a valid <a href=\"#VkAccelerationStructureKHR\">VkAccelerationStructureKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-pInfos-04630",
|
|
"text": " For each element of <code>pInfos</code>, if its <code>mode</code> member is <code>VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR</code>, its <code>srcAccelerationStructure</code> member <strong class=\"purple\">must</strong> not be <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-pInfos-03403",
|
|
"text": " The <code>srcAccelerationStructure</code> member of any element of <code>pInfos</code> <strong class=\"purple\">must</strong> not be the same acceleration structure as the <code>dstAccelerationStructure</code> member of any other element of <code>pInfos</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-dstAccelerationStructure-03698",
|
|
"text": " The <code>dstAccelerationStructure</code> member of any element of <code>pInfos</code> <strong class=\"purple\">must</strong> not be the same acceleration structure as the <code>dstAccelerationStructure</code> member of any other element of <code>pInfos</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-dstAccelerationStructure-03800",
|
|
"text": " The <code>dstAccelerationStructure</code> member of any element of <code>pInfos</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkAccelerationStructureKHR\">VkAccelerationStructureKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-pInfos-03699",
|
|
"text": " For each element of <code>pInfos</code>, if its <code>type</code> member is <code>VK_ACCELERATION_STRUCTURE_TYPE_TOP_LEVEL_KHR</code>, its <code>dstAccelerationStructure</code> member <strong class=\"purple\">must</strong> have been created with a value of <a href=\"#VkAccelerationStructureCreateInfoKHR\">VkAccelerationStructureCreateInfoKHR</a>::<code>type</code> equal to either <code>VK_ACCELERATION_STRUCTURE_TYPE_TOP_LEVEL_KHR</code> or <code>VK_ACCELERATION_STRUCTURE_TYPE_GENERIC_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-pInfos-03700",
|
|
"text": " For each element of <code>pInfos</code>, if its <code>type</code> member is <code>VK_ACCELERATION_STRUCTURE_TYPE_BOTTOM_LEVEL_KHR</code>, its <code>dstAccelerationStructure</code> member <strong class=\"purple\">must</strong> have been created with a value of <a href=\"#VkAccelerationStructureCreateInfoKHR\">VkAccelerationStructureCreateInfoKHR</a>::<code>type</code> equal to either <code>VK_ACCELERATION_STRUCTURE_TYPE_BOTTOM_LEVEL_KHR</code> or <code>VK_ACCELERATION_STRUCTURE_TYPE_GENERIC_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-pInfos-03663",
|
|
"text": " For each element of <code>pInfos</code>, if its <code>mode</code> member is <code>VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR</code>, <a href=\"#acceleration-structure-inactive-prims\">inactive primitives</a> in its <code>srcAccelerationStructure</code> member <strong class=\"purple\">must</strong> not be made active"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-pInfos-03664",
|
|
"text": " For each element of <code>pInfos</code>, if its <code>mode</code> member is <code>VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR</code>, active primitives in its <code>srcAccelerationStructure</code> member <strong class=\"purple\">must</strong> not be made <a href=\"#acceleration-structure-inactive-prims\">inactive</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-None-03407",
|
|
"text": " The <code>dstAccelerationStructure</code> member of any element of <code>pInfos</code> <strong class=\"purple\">must</strong> not be referenced by the <code>geometry.instances.data</code> member of any element of <code>pGeometries</code> or <code>ppGeometries</code> with a <code>geometryType</code> of <code>VK_GEOMETRY_TYPE_INSTANCES_KHR</code> in any other element of <code>pInfos</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-dstAccelerationStructure-03701",
|
|
"text": " The range of memory backing the <code>dstAccelerationStructure</code> member of any element of <code>pInfos</code> that is accessed by this command <strong class=\"purple\">must</strong> not overlap the memory backing the <code>srcAccelerationStructure</code> member of any other element of <code>pInfos</code> with a <code>mode</code> equal to <code>VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR</code>, which is accessed by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-dstAccelerationStructure-03702",
|
|
"text": " The range of memory backing the <code>dstAccelerationStructure</code> member of any element of <code>pInfos</code> that is accessed by this command <strong class=\"purple\">must</strong> not overlap the memory backing the <code>dstAccelerationStructure</code> member of any other element of <code>pInfos</code>, which is accessed by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-dstAccelerationStructure-03703",
|
|
"text": " The range of memory backing the <code>dstAccelerationStructure</code> member of any element of <code>pInfos</code> that is accessed by this command <strong class=\"purple\">must</strong> not overlap the memory backing the <code>scratchData</code> member of any element of <code>pInfos</code> (including the same element), which is accessed by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-scratchData-03704",
|
|
"text": " The range of memory backing the <code>scratchData</code> member of any element of <code>pInfos</code> that is accessed by this command <strong class=\"purple\">must</strong> not overlap the memory backing the <code>scratchData</code> member of any other element of <code>pInfos</code>, which is accessed by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-scratchData-03705",
|
|
"text": " The range of memory backing the <code>scratchData</code> member of any element of <code>pInfos</code> that is accessed by this command <strong class=\"purple\">must</strong> not overlap the memory backing the <code>srcAccelerationStructure</code> member of any element of <code>pInfos</code> with a <code>mode</code> equal to <code>VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR</code> (including the same element), which is accessed by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-dstAccelerationStructure-03706",
|
|
"text": " The range of memory backing the <code>dstAccelerationStructure</code> member of any element of <code>pInfos</code> that is accessed by this command <strong class=\"purple\">must</strong> not overlap the memory backing any acceleration structure referenced by the <code>geometry.instances.data</code> member of any element of <code>pGeometries</code> or <code>ppGeometries</code> with a <code>geometryType</code> of <code>VK_GEOMETRY_TYPE_INSTANCES_KHR</code> in any other element of <code>pInfos</code>, which is accessed by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-pInfos-03667",
|
|
"text": " For each element of <code>pInfos</code>, if its <code>mode</code> member is <code>VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR</code>, its <code>srcAccelerationStructure</code> member <strong class=\"purple\">must</strong> have previously been constructed with <code>VK_BUILD_ACCELERATION_STRUCTURE_ALLOW_UPDATE_BIT_KHR</code> set in <a href=\"#VkAccelerationStructureBuildGeometryInfoKHR\">VkAccelerationStructureBuildGeometryInfoKHR</a>::<code>flags</code> in the build"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-pInfos-03668",
|
|
"text": " For each element of <code>pInfos</code>, if its <code>mode</code> member is <code>VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR</code>, its <code>srcAccelerationStructure</code> and <code>dstAccelerationStructure</code> members <strong class=\"purple\">must</strong> either be the same <a href=\"#VkAccelerationStructureKHR\">VkAccelerationStructureKHR</a>, or not have any <a href=\"#resources-memory-aliasing\">memory aliasing</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-pInfos-03758",
|
|
"text": " For each element of <code>pInfos</code>, if its <code>mode</code> member is <code>VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR</code>, its <code>geometryCount</code> member <strong class=\"purple\">must</strong> have the same value which was specified when <code>srcAccelerationStructure</code> was last built"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-pInfos-03759",
|
|
"text": " For each element of <code>pInfos</code>, if its <code>mode</code> member is <code>VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR</code>, its <code>flags</code> member <strong class=\"purple\">must</strong> have the same value which was specified when <code>srcAccelerationStructure</code> was last built"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-pInfos-03760",
|
|
"text": " For each element of <code>pInfos</code>, if its <code>mode</code> member is <code>VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR</code>, its <code>type</code> member <strong class=\"purple\">must</strong> have the same value which was specified when <code>srcAccelerationStructure</code> was last built"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-pInfos-03761",
|
|
"text": " For each element of <code>pInfos</code>, if its <code>mode</code> member is <code>VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR</code>, then for each <code>VkAccelerationStructureGeometryKHR</code> structure referred to by its <code>pGeometries</code> or <code>ppGeometries</code> members, its <code>geometryType</code> member <strong class=\"purple\">must</strong> have the same value which was specified when <code>srcAccelerationStructure</code> was last built"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-pInfos-03762",
|
|
"text": " For each element of <code>pInfos</code>, if its <code>mode</code> member is <code>VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR</code>, then for each <code>VkAccelerationStructureGeometryKHR</code> structure referred to by its <code>pGeometries</code> or <code>ppGeometries</code> members, its <code>flags</code> member <strong class=\"purple\">must</strong> have the same value which was specified when <code>srcAccelerationStructure</code> was last built"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-pInfos-03763",
|
|
"text": " For each element of <code>pInfos</code>, if its <code>mode</code> member is <code>VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR</code>, then for each <code>VkAccelerationStructureGeometryKHR</code> structure referred to by its <code>pGeometries</code> or <code>ppGeometries</code> members, if <code>geometryType</code> is <code>VK_GEOMETRY_TYPE_TRIANGLES_KHR</code>, its <code>geometry.triangles.vertexFormat</code> member <strong class=\"purple\">must</strong> have the same value which was specified when <code>srcAccelerationStructure</code> was last built"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-pInfos-03764",
|
|
"text": " For each element of <code>pInfos</code>, if its <code>mode</code> member is <code>VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR</code>, then for each <code>VkAccelerationStructureGeometryKHR</code> structure referred to by its <code>pGeometries</code> or <code>ppGeometries</code> members, if <code>geometryType</code> is <code>VK_GEOMETRY_TYPE_TRIANGLES_KHR</code>, its <code>geometry.triangles.maxVertex</code> member <strong class=\"purple\">must</strong> have the same value which was specified when <code>srcAccelerationStructure</code> was last built"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-pInfos-03765",
|
|
"text": " For each element of <code>pInfos</code>, if its <code>mode</code> member is <code>VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR</code>, then for each <code>VkAccelerationStructureGeometryKHR</code> structure referred to by its <code>pGeometries</code> or <code>ppGeometries</code> members, if <code>geometryType</code> is <code>VK_GEOMETRY_TYPE_TRIANGLES_KHR</code>, its <code>geometry.triangles.indexType</code> member <strong class=\"purple\">must</strong> have the same value which was specified when <code>srcAccelerationStructure</code> was last built"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-pInfos-03766",
|
|
"text": " For each element of <code>pInfos</code>, if its <code>mode</code> member is <code>VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR</code>, then for each <code>VkAccelerationStructureGeometryKHR</code> structure referred to by its <code>pGeometries</code> or <code>ppGeometries</code> members, if <code>geometryType</code> is <code>VK_GEOMETRY_TYPE_TRIANGLES_KHR</code>, if its <code>geometry.triangles.transformData</code> address was <code>NULL</code> when <code>srcAccelerationStructure</code> was last built, then it <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-pInfos-03767",
|
|
"text": " For each element of <code>pInfos</code>, if its <code>mode</code> member is <code>VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR</code>, then for each <code>VkAccelerationStructureGeometryKHR</code> structure referred to by its <code>pGeometries</code> or <code>ppGeometries</code> members, if <code>geometryType</code> is <code>VK_GEOMETRY_TYPE_TRIANGLES_KHR</code>, if its <code>geometry.triangles.transformData</code> address was not <code>NULL</code> when <code>srcAccelerationStructure</code> was last built, then it <strong class=\"purple\">must</strong> not be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-pInfos-03768",
|
|
"text": " For each element of <code>pInfos</code>, if its <code>mode</code> member is <code>VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR</code>, then for each <code>VkAccelerationStructureGeometryKHR</code> structure referred to by its <code>pGeometries</code> or <code>ppGeometries</code> members, if <code>geometryType</code> is <code>VK_GEOMETRY_TYPE_TRIANGLES_KHR</code>, and <code>geometry.triangles.indexType</code> is not <code>VK_INDEX_TYPE_NONE_KHR</code>, then the value of each index referenced <strong class=\"purple\">must</strong> be the same as the corresponding index value when <code>srcAccelerationStructure</code> was last built"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-primitiveCount-03769",
|
|
"text": " For each <code>VkAccelerationStructureBuildRangeInfoKHR</code> referenced by this command, its <code>primitiveCount</code> member <strong class=\"purple\">must</strong> have the same value which was specified when <code>srcAccelerationStructure</code> was last built"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-firstVertex-03770",
|
|
"text": " For each <code>VkAccelerationStructureBuildRangeInfoKHR</code> referenced by this command, if the corresponding geometry uses indices, its <code>firstVertex</code> member <strong class=\"purple\">must</strong> have the same value which was specified when <code>srcAccelerationStructure</code> was last built"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-pInfos-03801",
|
|
"text": " For each element of <code>pInfos</code>[i].<code>pGeometries</code> or <code>pInfos</code>[i].<code>ppGeometries</code> with a <code>geometryType</code> of <code>VK_GEOMETRY_TYPE_INSTANCES_KHR</code>, the corresponding pname:ppBuildRangeInfos[i][j].pname:primitiveCount <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#VkPhysicalDeviceAccelerationStructurePropertiesKHR\">VkPhysicalDeviceAccelerationStructurePropertiesKHR</a>::<code>maxInstanceCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-pInfos-03707",
|
|
"text": " For each element of <code>pInfos</code>, the <code>buffer</code> used to create its <code>dstAccelerationStructure</code> member <strong class=\"purple\">must</strong> be bound to device memory"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-pInfos-03708",
|
|
"text": " For each element of <code>pInfos</code>, if its <code>mode</code> member is <code>VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR</code> the <code>buffer</code> used to create its <code>srcAccelerationStructure</code> member <strong class=\"purple\">must</strong> be bound to device memory"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-pInfos-03709",
|
|
"text": " For each element of <code>pInfos</code>, the <code>buffer</code> used to create each acceleration structure referenced by the <code>geometry.instances.data</code> member of any element of <code>pGeometries</code> or <code>ppGeometries</code> with a <code>geometryType</code> of <code>VK_GEOMETRY_TYPE_INSTANCES_KHR</code> <strong class=\"purple\">must</strong> be bound to device memory"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-pInfos-03671",
|
|
"text": " If <code>pInfos</code>[i].<code>mode</code> is <code>VK_BUILD_ACCELERATION_STRUCTURE_MODE_BUILD_KHR</code>, all addresses between <code>pInfos</code>[i].<code>scratchData.deviceAddress</code> and <code>pInfos</code>[i].<code>scratchData.deviceAddress</code> + N - 1 <strong class=\"purple\">must</strong> be in the buffer device address range of the same buffer, where N is given by the <code>buildScratchSize</code> member of the <a href=\"#VkAccelerationStructureBuildSizesInfoKHR\">VkAccelerationStructureBuildSizesInfoKHR</a> structure returned from a call to <a href=\"#vkGetAccelerationStructureBuildSizesKHR\">vkGetAccelerationStructureBuildSizesKHR</a> with an identical <a href=\"#VkAccelerationStructureBuildGeometryInfoKHR\">VkAccelerationStructureBuildGeometryInfoKHR</a> structure and primitive count"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-pInfos-03672",
|
|
"text": " If <code>pInfos</code>[i].<code>mode</code> is <code>VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR</code>, all addresses between <code>pInfos</code>[i].<code>scratchData.deviceAddress</code> and <code>pInfos</code>[i].<code>scratchData.deviceAddress</code> + N - 1 <strong class=\"purple\">must</strong> be in the buffer device address range of the same buffer, where N is given by the <code>updateScratchSize</code> member of the <a href=\"#VkAccelerationStructureBuildSizesInfoKHR\">VkAccelerationStructureBuildSizesInfoKHR</a> structure returned from a call to <a href=\"#vkGetAccelerationStructureBuildSizesKHR\">vkGetAccelerationStructureBuildSizesKHR</a> with an identical <a href=\"#VkAccelerationStructureBuildGeometryInfoKHR\">VkAccelerationStructureBuildGeometryInfoKHR</a> structure and primitive count"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-geometry-03673",
|
|
"text": " The buffers from which the buffer device addresses for all of the <code>geometry.triangles.vertexData</code>, <code>geometry.triangles.indexData</code>, <code>geometry.triangles.transformData</code>, <code>geometry.aabbs.data</code>, and <code>geometry.instances.data</code> members of all <code>pInfos</code>[i].<code>pGeometries</code> and <code>pInfos</code>[i].<code>ppGeometries</code> are queried <strong class=\"purple\">must</strong> have been created with the <code>VK_BUFFER_USAGE_ACCELERATION_STRUCTURE_BUILD_INPUT_READ_ONLY_BIT_KHR</code> usage flag"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-pInfos-03674",
|
|
"text": " The buffer from which the buffer device address <code>pInfos</code>[i].<code>scratchData.deviceAddress</code> is queried <strong class=\"purple\">must</strong> have been created with <code>VK_BUFFER_USAGE_STORAGE_BUFFER_BIT</code> usage flag"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-pInfos-03802",
|
|
"text": " For each element of <code>pInfos</code>, its <code>scratchData.deviceAddress</code> member <strong class=\"purple\">must</strong> be a valid device address obtained from <a href=\"#vkGetBufferDeviceAddress\">vkGetBufferDeviceAddress</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-pInfos-03803",
|
|
"text": " For each element of <code>pInfos</code>, if <code>scratchData.deviceAddress</code> is the address of a non-sparse buffer then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <a href=\"#VkDeviceMemory\">VkDeviceMemory</a> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-pInfos-03710",
|
|
"text": " For each element of <code>pInfos</code>, its <code>scratchData.deviceAddress</code> member <strong class=\"purple\">must</strong> be a multiple of <a href=\"#VkPhysicalDeviceAccelerationStructurePropertiesKHR\">VkPhysicalDeviceAccelerationStructurePropertiesKHR</a>::<code>minAccelerationStructureScratchOffsetAlignment</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-pInfos-03804",
|
|
"text": " For any element of <code>pInfos</code>[i].<code>pGeometries</code> or <code>pInfos</code>[i].<code>ppGeometries</code> with a <code>geometryType</code> of <code>VK_GEOMETRY_TYPE_TRIANGLES_KHR</code>, <code>geometry.triangles.vertexData.deviceAddress</code> <strong class=\"purple\">must</strong> be a valid device address obtained from <a href=\"#vkGetBufferDeviceAddress\">vkGetBufferDeviceAddress</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-pInfos-03805",
|
|
"text": " For any element of <code>pInfos</code>[i].<code>pGeometries</code> or <code>pInfos</code>[i].<code>ppGeometries</code> with a <code>geometryType</code> of <code>VK_GEOMETRY_TYPE_TRIANGLES_KHR</code>, if <code>geometry.triangles.vertexData.deviceAddress</code> is the address of a non-sparse buffer then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <a href=\"#VkDeviceMemory\">VkDeviceMemory</a> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-pInfos-03711",
|
|
"text": " For any element of <code>pInfos</code>[i].<code>pGeometries</code> or <code>pInfos</code>[i].<code>ppGeometries</code> with a <code>geometryType</code> of <code>VK_GEOMETRY_TYPE_TRIANGLES_KHR</code>, <code>geometry.triangles.vertexData.deviceAddress</code> <strong class=\"purple\">must</strong> be aligned to the size in bytes of the smallest component of the format in <code>vertexFormat</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-pInfos-03806",
|
|
"text": " For any element of <code>pInfos</code>[i].<code>pGeometries</code> or <code>pInfos</code>[i].<code>ppGeometries</code> with a <code>geometryType</code> of <code>VK_GEOMETRY_TYPE_TRIANGLES_KHR</code>, if <code>geometry.triangles.indexType</code> is not <code>VK_INDEX_TYPE_NONE_KHR</code>, <code>geometry.triangles.indexData.deviceAddress</code> <strong class=\"purple\">must</strong> be a valid device address obtained from <a href=\"#vkGetBufferDeviceAddress\">vkGetBufferDeviceAddress</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-pInfos-03807",
|
|
"text": " For any element of <code>pInfos</code>[i].<code>pGeometries</code> or <code>pInfos</code>[i].<code>ppGeometries</code> with a <code>geometryType</code> of <code>VK_GEOMETRY_TYPE_TRIANGLES_KHR</code>, if <code>geometry.triangles.indexType</code> is not <code>VK_INDEX_TYPE_NONE_KHR</code>, if <code>geometry.triangles.indexData.deviceAddress</code> is the address of a non-sparse buffer then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <a href=\"#VkDeviceMemory\">VkDeviceMemory</a> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-pInfos-03712",
|
|
"text": " For any element of <code>pInfos</code>[i].<code>pGeometries</code> or <code>pInfos</code>[i].<code>ppGeometries</code> with a <code>geometryType</code> of <code>VK_GEOMETRY_TYPE_TRIANGLES_KHR</code>, and with <code>geometry.triangles.indexType</code> not equal to <code>VK_INDEX_TYPE_NONE_KHR</code>, <code>geometry.triangles.indexData.deviceAddress</code> <strong class=\"purple\">must</strong> be aligned to the size in bytes of the type in <code>indexType</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-pInfos-03808",
|
|
"text": " For any element of <code>pInfos</code>[i].<code>pGeometries</code> or <code>pInfos</code>[i].<code>ppGeometries</code> with a <code>geometryType</code> of <code>VK_GEOMETRY_TYPE_TRIANGLES_KHR</code>, if <code>geometry.triangles.transformData.deviceAddress</code> is not <code>0</code>, it <strong class=\"purple\">must</strong> be a valid device address obtained from <a href=\"#vkGetBufferDeviceAddress\">vkGetBufferDeviceAddress</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-pInfos-03809",
|
|
"text": " For any element of <code>pInfos</code>[i].<code>pGeometries</code> or <code>pInfos</code>[i].<code>ppGeometries</code> with a <code>geometryType</code> of <code>VK_GEOMETRY_TYPE_TRIANGLES_KHR</code>, if <code>geometry.triangles.transformData.deviceAddress</code> is the address of a non-sparse buffer then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <a href=\"#VkDeviceMemory\">VkDeviceMemory</a> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-pInfos-03810",
|
|
"text": " For any element of <code>pInfos</code>[i].<code>pGeometries</code> or <code>pInfos</code>[i].<code>ppGeometries</code> with a <code>geometryType</code> of <code>VK_GEOMETRY_TYPE_TRIANGLES_KHR</code>, if <code>geometry.triangles.transformData.deviceAddress</code> is not <code>0</code>, it <strong class=\"purple\">must</strong> be aligned to <code>16</code> bytes"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-pInfos-03811",
|
|
"text": " For any element of <code>pInfos</code>[i].<code>pGeometries</code> or <code>pInfos</code>[i].<code>ppGeometries</code> with a <code>geometryType</code> of <code>VK_GEOMETRY_TYPE_AABBS_KHR</code>, <code>geometry.aabbs.data.deviceAddress</code> <strong class=\"purple\">must</strong> be a valid device address obtained from <a href=\"#vkGetBufferDeviceAddress\">vkGetBufferDeviceAddress</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-pInfos-03812",
|
|
"text": " For any element of <code>pInfos</code>[i].<code>pGeometries</code> or <code>pInfos</code>[i].<code>ppGeometries</code> with a <code>geometryType</code> of <code>VK_GEOMETRY_TYPE_AABBS_KHR</code>, if <code>geometry.aabbs.data.deviceAddress</code> is the address of a non-sparse buffer then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <a href=\"#VkDeviceMemory\">VkDeviceMemory</a> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-pInfos-03714",
|
|
"text": " For any element of <code>pInfos</code>[i].<code>pGeometries</code> or <code>pInfos</code>[i].<code>ppGeometries</code> with a <code>geometryType</code> of <code>VK_GEOMETRY_TYPE_AABBS_KHR</code>, <code>geometry.aabbs.data.deviceAddress</code> <strong class=\"purple\">must</strong> be aligned to <code>8</code> bytes"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-pInfos-03715",
|
|
"text": " For any element of <code>pInfos</code>[i].<code>pGeometries</code> or <code>pInfos</code>[i].<code>ppGeometries</code> with a <code>geometryType</code> of <code>VK_GEOMETRY_TYPE_INSTANCES_KHR</code>, if <code>geometry.arrayOfPointers</code> is <code>VK_FALSE</code>, <code>geometry.instances.data.deviceAddress</code> <strong class=\"purple\">must</strong> be aligned to <code>16</code> bytes"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-pInfos-03716",
|
|
"text": " For any element of <code>pInfos</code>[i].<code>pGeometries</code> or <code>pInfos</code>[i].<code>ppGeometries</code> with a <code>geometryType</code> of <code>VK_GEOMETRY_TYPE_INSTANCES_KHR</code>, if <code>geometry.arrayOfPointers</code> is <code>VK_TRUE</code>, <code>geometry.instances.data.deviceAddress</code> <strong class=\"purple\">must</strong> be aligned to <code>8</code> bytes"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-pInfos-03717",
|
|
"text": " For any element of <code>pInfos</code>[i].<code>pGeometries</code> or <code>pInfos</code>[i].<code>ppGeometries</code> with a <code>geometryType</code> of <code>VK_GEOMETRY_TYPE_INSTANCES_KHR</code>, if <code>geometry.arrayOfPointers</code> is <code>VK_TRUE</code>, each element of <code>geometry.instances.data.deviceAddress</code> in device memory <strong class=\"purple\">must</strong> be aligned to <code>16</code> bytes"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-pInfos-03813",
|
|
"text": " For any element of <code>pInfos</code>[i].<code>pGeometries</code> or <code>pInfos</code>[i].<code>ppGeometries</code> with a <code>geometryType</code> of <code>VK_GEOMETRY_TYPE_INSTANCES_KHR</code>, <code>geometry.instances.data.deviceAddress</code> <strong class=\"purple\">must</strong> be a valid device address obtained from <a href=\"#vkGetBufferDeviceAddress\">vkGetBufferDeviceAddress</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-pInfos-03814",
|
|
"text": " For any element of <code>pInfos</code>[i].<code>pGeometries</code> or <code>pInfos</code>[i].<code>ppGeometries</code> with a <code>geometryType</code> of <code>VK_GEOMETRY_TYPE_INSTANCES_KHR</code>, if <code>geometry.instances.data.deviceAddress</code> is the address of a non-sparse buffer then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <a href=\"#VkDeviceMemory\">VkDeviceMemory</a> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-pInfos-06707",
|
|
"text": " For any element of <code>pInfos</code>[i].<code>pGeometries</code> or <code>pInfos</code>[i].<code>ppGeometries</code> with a <code>geometryType</code> of <code>VK_GEOMETRY_TYPE_INSTANCES_KHR</code>, each <a href=\"#VkAccelerationStructureInstanceKHR\">VkAccelerationStructureInstanceKHR</a>::<code>accelerationStructureReference</code> value in <code>geometry.instances.data.deviceAddress</code> <strong class=\"purple\">must</strong> be a valid device address containing a value obtained from <a href=\"#vkGetAccelerationStructureDeviceAddressKHR\">vkGetAccelerationStructureDeviceAddressKHR</a> or <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-pInfos-03675",
|
|
"text": " For each <code>pInfos</code>[i], <code>dstAccelerationStructure</code> <strong class=\"purple\">must</strong> have been created with a value of <a href=\"#VkAccelerationStructureCreateInfoKHR\">VkAccelerationStructureCreateInfoKHR</a>::<code>size</code> greater than or equal to the memory size required by the build operation, as returned by <a href=\"#vkGetAccelerationStructureBuildSizesKHR\">vkGetAccelerationStructureBuildSizesKHR</a> with <span class=\"eq\"><code>pBuildInfo</code> = <code>pInfos</code>[i]</span> and with each element of the <code>pMaxPrimitiveCounts</code> array greater than or equal to the equivalent <code>ppBuildRangeInfos</code>[i][j].<code>primitiveCount</code> values for <code>j</code> in <span class=\"eq\">[0,<code>pInfos</code>[i].<code>geometryCount</code>)</span>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-ppBuildRangeInfos-03676",
|
|
"text": " Each element of <code>ppBuildRangeInfos</code>[i] <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>pInfos</code>[i].<code>geometryCount</code> <code>VkAccelerationStructureBuildRangeInfoKHR</code> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-pInfos-parameter",
|
|
"text": " <code>pInfos</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>infoCount</code> valid <a href=\"#VkAccelerationStructureBuildGeometryInfoKHR\">VkAccelerationStructureBuildGeometryInfoKHR</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-ppBuildRangeInfos-parameter",
|
|
"text": " <code>ppBuildRangeInfos</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>infoCount</code> <a href=\"#VkAccelerationStructureBuildRangeInfoKHR\">VkAccelerationStructureBuildRangeInfoKHR</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support compute operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresKHR-infoCount-arraylength",
|
|
"text": " <code>infoCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdBuildAccelerationStructuresIndirectKHR": {
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)+(VK_KHR_acceleration_structure)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-mode-04628",
|
|
"text": " The <code>mode</code> member of each element of <code>pInfos</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBuildAccelerationStructureModeKHR\">VkBuildAccelerationStructureModeKHR</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-srcAccelerationStructure-04629",
|
|
"text": " If the <code>srcAccelerationStructure</code> member of any element of <code>pInfos</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the <code>srcAccelerationStructure</code> member <strong class=\"purple\">must</strong> be a valid <a href=\"#VkAccelerationStructureKHR\">VkAccelerationStructureKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-04630",
|
|
"text": " For each element of <code>pInfos</code>, if its <code>mode</code> member is <code>VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR</code>, its <code>srcAccelerationStructure</code> member <strong class=\"purple\">must</strong> not be <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03403",
|
|
"text": " The <code>srcAccelerationStructure</code> member of any element of <code>pInfos</code> <strong class=\"purple\">must</strong> not be the same acceleration structure as the <code>dstAccelerationStructure</code> member of any other element of <code>pInfos</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-dstAccelerationStructure-03698",
|
|
"text": " The <code>dstAccelerationStructure</code> member of any element of <code>pInfos</code> <strong class=\"purple\">must</strong> not be the same acceleration structure as the <code>dstAccelerationStructure</code> member of any other element of <code>pInfos</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-dstAccelerationStructure-03800",
|
|
"text": " The <code>dstAccelerationStructure</code> member of any element of <code>pInfos</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkAccelerationStructureKHR\">VkAccelerationStructureKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03699",
|
|
"text": " For each element of <code>pInfos</code>, if its <code>type</code> member is <code>VK_ACCELERATION_STRUCTURE_TYPE_TOP_LEVEL_KHR</code>, its <code>dstAccelerationStructure</code> member <strong class=\"purple\">must</strong> have been created with a value of <a href=\"#VkAccelerationStructureCreateInfoKHR\">VkAccelerationStructureCreateInfoKHR</a>::<code>type</code> equal to either <code>VK_ACCELERATION_STRUCTURE_TYPE_TOP_LEVEL_KHR</code> or <code>VK_ACCELERATION_STRUCTURE_TYPE_GENERIC_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03700",
|
|
"text": " For each element of <code>pInfos</code>, if its <code>type</code> member is <code>VK_ACCELERATION_STRUCTURE_TYPE_BOTTOM_LEVEL_KHR</code>, its <code>dstAccelerationStructure</code> member <strong class=\"purple\">must</strong> have been created with a value of <a href=\"#VkAccelerationStructureCreateInfoKHR\">VkAccelerationStructureCreateInfoKHR</a>::<code>type</code> equal to either <code>VK_ACCELERATION_STRUCTURE_TYPE_BOTTOM_LEVEL_KHR</code> or <code>VK_ACCELERATION_STRUCTURE_TYPE_GENERIC_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03663",
|
|
"text": " For each element of <code>pInfos</code>, if its <code>mode</code> member is <code>VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR</code>, <a href=\"#acceleration-structure-inactive-prims\">inactive primitives</a> in its <code>srcAccelerationStructure</code> member <strong class=\"purple\">must</strong> not be made active"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03664",
|
|
"text": " For each element of <code>pInfos</code>, if its <code>mode</code> member is <code>VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR</code>, active primitives in its <code>srcAccelerationStructure</code> member <strong class=\"purple\">must</strong> not be made <a href=\"#acceleration-structure-inactive-prims\">inactive</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-None-03407",
|
|
"text": " The <code>dstAccelerationStructure</code> member of any element of <code>pInfos</code> <strong class=\"purple\">must</strong> not be referenced by the <code>geometry.instances.data</code> member of any element of <code>pGeometries</code> or <code>ppGeometries</code> with a <code>geometryType</code> of <code>VK_GEOMETRY_TYPE_INSTANCES_KHR</code> in any other element of <code>pInfos</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-dstAccelerationStructure-03701",
|
|
"text": " The range of memory backing the <code>dstAccelerationStructure</code> member of any element of <code>pInfos</code> that is accessed by this command <strong class=\"purple\">must</strong> not overlap the memory backing the <code>srcAccelerationStructure</code> member of any other element of <code>pInfos</code> with a <code>mode</code> equal to <code>VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR</code>, which is accessed by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-dstAccelerationStructure-03702",
|
|
"text": " The range of memory backing the <code>dstAccelerationStructure</code> member of any element of <code>pInfos</code> that is accessed by this command <strong class=\"purple\">must</strong> not overlap the memory backing the <code>dstAccelerationStructure</code> member of any other element of <code>pInfos</code>, which is accessed by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-dstAccelerationStructure-03703",
|
|
"text": " The range of memory backing the <code>dstAccelerationStructure</code> member of any element of <code>pInfos</code> that is accessed by this command <strong class=\"purple\">must</strong> not overlap the memory backing the <code>scratchData</code> member of any element of <code>pInfos</code> (including the same element), which is accessed by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-scratchData-03704",
|
|
"text": " The range of memory backing the <code>scratchData</code> member of any element of <code>pInfos</code> that is accessed by this command <strong class=\"purple\">must</strong> not overlap the memory backing the <code>scratchData</code> member of any other element of <code>pInfos</code>, which is accessed by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-scratchData-03705",
|
|
"text": " The range of memory backing the <code>scratchData</code> member of any element of <code>pInfos</code> that is accessed by this command <strong class=\"purple\">must</strong> not overlap the memory backing the <code>srcAccelerationStructure</code> member of any element of <code>pInfos</code> with a <code>mode</code> equal to <code>VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR</code> (including the same element), which is accessed by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-dstAccelerationStructure-03706",
|
|
"text": " The range of memory backing the <code>dstAccelerationStructure</code> member of any element of <code>pInfos</code> that is accessed by this command <strong class=\"purple\">must</strong> not overlap the memory backing any acceleration structure referenced by the <code>geometry.instances.data</code> member of any element of <code>pGeometries</code> or <code>ppGeometries</code> with a <code>geometryType</code> of <code>VK_GEOMETRY_TYPE_INSTANCES_KHR</code> in any other element of <code>pInfos</code>, which is accessed by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03667",
|
|
"text": " For each element of <code>pInfos</code>, if its <code>mode</code> member is <code>VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR</code>, its <code>srcAccelerationStructure</code> member <strong class=\"purple\">must</strong> have previously been constructed with <code>VK_BUILD_ACCELERATION_STRUCTURE_ALLOW_UPDATE_BIT_KHR</code> set in <a href=\"#VkAccelerationStructureBuildGeometryInfoKHR\">VkAccelerationStructureBuildGeometryInfoKHR</a>::<code>flags</code> in the build"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03668",
|
|
"text": " For each element of <code>pInfos</code>, if its <code>mode</code> member is <code>VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR</code>, its <code>srcAccelerationStructure</code> and <code>dstAccelerationStructure</code> members <strong class=\"purple\">must</strong> either be the same <a href=\"#VkAccelerationStructureKHR\">VkAccelerationStructureKHR</a>, or not have any <a href=\"#resources-memory-aliasing\">memory aliasing</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03758",
|
|
"text": " For each element of <code>pInfos</code>, if its <code>mode</code> member is <code>VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR</code>, its <code>geometryCount</code> member <strong class=\"purple\">must</strong> have the same value which was specified when <code>srcAccelerationStructure</code> was last built"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03759",
|
|
"text": " For each element of <code>pInfos</code>, if its <code>mode</code> member is <code>VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR</code>, its <code>flags</code> member <strong class=\"purple\">must</strong> have the same value which was specified when <code>srcAccelerationStructure</code> was last built"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03760",
|
|
"text": " For each element of <code>pInfos</code>, if its <code>mode</code> member is <code>VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR</code>, its <code>type</code> member <strong class=\"purple\">must</strong> have the same value which was specified when <code>srcAccelerationStructure</code> was last built"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03761",
|
|
"text": " For each element of <code>pInfos</code>, if its <code>mode</code> member is <code>VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR</code>, then for each <code>VkAccelerationStructureGeometryKHR</code> structure referred to by its <code>pGeometries</code> or <code>ppGeometries</code> members, its <code>geometryType</code> member <strong class=\"purple\">must</strong> have the same value which was specified when <code>srcAccelerationStructure</code> was last built"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03762",
|
|
"text": " For each element of <code>pInfos</code>, if its <code>mode</code> member is <code>VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR</code>, then for each <code>VkAccelerationStructureGeometryKHR</code> structure referred to by its <code>pGeometries</code> or <code>ppGeometries</code> members, its <code>flags</code> member <strong class=\"purple\">must</strong> have the same value which was specified when <code>srcAccelerationStructure</code> was last built"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03763",
|
|
"text": " For each element of <code>pInfos</code>, if its <code>mode</code> member is <code>VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR</code>, then for each <code>VkAccelerationStructureGeometryKHR</code> structure referred to by its <code>pGeometries</code> or <code>ppGeometries</code> members, if <code>geometryType</code> is <code>VK_GEOMETRY_TYPE_TRIANGLES_KHR</code>, its <code>geometry.triangles.vertexFormat</code> member <strong class=\"purple\">must</strong> have the same value which was specified when <code>srcAccelerationStructure</code> was last built"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03764",
|
|
"text": " For each element of <code>pInfos</code>, if its <code>mode</code> member is <code>VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR</code>, then for each <code>VkAccelerationStructureGeometryKHR</code> structure referred to by its <code>pGeometries</code> or <code>ppGeometries</code> members, if <code>geometryType</code> is <code>VK_GEOMETRY_TYPE_TRIANGLES_KHR</code>, its <code>geometry.triangles.maxVertex</code> member <strong class=\"purple\">must</strong> have the same value which was specified when <code>srcAccelerationStructure</code> was last built"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03765",
|
|
"text": " For each element of <code>pInfos</code>, if its <code>mode</code> member is <code>VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR</code>, then for each <code>VkAccelerationStructureGeometryKHR</code> structure referred to by its <code>pGeometries</code> or <code>ppGeometries</code> members, if <code>geometryType</code> is <code>VK_GEOMETRY_TYPE_TRIANGLES_KHR</code>, its <code>geometry.triangles.indexType</code> member <strong class=\"purple\">must</strong> have the same value which was specified when <code>srcAccelerationStructure</code> was last built"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03766",
|
|
"text": " For each element of <code>pInfos</code>, if its <code>mode</code> member is <code>VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR</code>, then for each <code>VkAccelerationStructureGeometryKHR</code> structure referred to by its <code>pGeometries</code> or <code>ppGeometries</code> members, if <code>geometryType</code> is <code>VK_GEOMETRY_TYPE_TRIANGLES_KHR</code>, if its <code>geometry.triangles.transformData</code> address was <code>NULL</code> when <code>srcAccelerationStructure</code> was last built, then it <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03767",
|
|
"text": " For each element of <code>pInfos</code>, if its <code>mode</code> member is <code>VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR</code>, then for each <code>VkAccelerationStructureGeometryKHR</code> structure referred to by its <code>pGeometries</code> or <code>ppGeometries</code> members, if <code>geometryType</code> is <code>VK_GEOMETRY_TYPE_TRIANGLES_KHR</code>, if its <code>geometry.triangles.transformData</code> address was not <code>NULL</code> when <code>srcAccelerationStructure</code> was last built, then it <strong class=\"purple\">must</strong> not be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03768",
|
|
"text": " For each element of <code>pInfos</code>, if its <code>mode</code> member is <code>VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR</code>, then for each <code>VkAccelerationStructureGeometryKHR</code> structure referred to by its <code>pGeometries</code> or <code>ppGeometries</code> members, if <code>geometryType</code> is <code>VK_GEOMETRY_TYPE_TRIANGLES_KHR</code>, and <code>geometry.triangles.indexType</code> is not <code>VK_INDEX_TYPE_NONE_KHR</code>, then the value of each index referenced <strong class=\"purple\">must</strong> be the same as the corresponding index value when <code>srcAccelerationStructure</code> was last built"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-primitiveCount-03769",
|
|
"text": " For each <code>VkAccelerationStructureBuildRangeInfoKHR</code> referenced by this command, its <code>primitiveCount</code> member <strong class=\"purple\">must</strong> have the same value which was specified when <code>srcAccelerationStructure</code> was last built"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-firstVertex-03770",
|
|
"text": " For each <code>VkAccelerationStructureBuildRangeInfoKHR</code> referenced by this command, if the corresponding geometry uses indices, its <code>firstVertex</code> member <strong class=\"purple\">must</strong> have the same value which was specified when <code>srcAccelerationStructure</code> was last built"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03801",
|
|
"text": " For each element of <code>pInfos</code>[i].<code>pGeometries</code> or <code>pInfos</code>[i].<code>ppGeometries</code> with a <code>geometryType</code> of <code>VK_GEOMETRY_TYPE_INSTANCES_KHR</code>, the corresponding pname:ppMaxPrimitiveCounts[i][j] <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#VkPhysicalDeviceAccelerationStructurePropertiesKHR\">VkPhysicalDeviceAccelerationStructurePropertiesKHR</a>::<code>maxInstanceCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03707",
|
|
"text": " For each element of <code>pInfos</code>, the <code>buffer</code> used to create its <code>dstAccelerationStructure</code> member <strong class=\"purple\">must</strong> be bound to device memory"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03708",
|
|
"text": " For each element of <code>pInfos</code>, if its <code>mode</code> member is <code>VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR</code> the <code>buffer</code> used to create its <code>srcAccelerationStructure</code> member <strong class=\"purple\">must</strong> be bound to device memory"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03709",
|
|
"text": " For each element of <code>pInfos</code>, the <code>buffer</code> used to create each acceleration structure referenced by the <code>geometry.instances.data</code> member of any element of <code>pGeometries</code> or <code>ppGeometries</code> with a <code>geometryType</code> of <code>VK_GEOMETRY_TYPE_INSTANCES_KHR</code> <strong class=\"purple\">must</strong> be bound to device memory"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03671",
|
|
"text": " If <code>pInfos</code>[i].<code>mode</code> is <code>VK_BUILD_ACCELERATION_STRUCTURE_MODE_BUILD_KHR</code>, all addresses between <code>pInfos</code>[i].<code>scratchData.deviceAddress</code> and <code>pInfos</code>[i].<code>scratchData.deviceAddress</code> + N - 1 <strong class=\"purple\">must</strong> be in the buffer device address range of the same buffer, where N is given by the <code>buildScratchSize</code> member of the <a href=\"#VkAccelerationStructureBuildSizesInfoKHR\">VkAccelerationStructureBuildSizesInfoKHR</a> structure returned from a call to <a href=\"#vkGetAccelerationStructureBuildSizesKHR\">vkGetAccelerationStructureBuildSizesKHR</a> with an identical <a href=\"#VkAccelerationStructureBuildGeometryInfoKHR\">VkAccelerationStructureBuildGeometryInfoKHR</a> structure and primitive count"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03672",
|
|
"text": " If <code>pInfos</code>[i].<code>mode</code> is <code>VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR</code>, all addresses between <code>pInfos</code>[i].<code>scratchData.deviceAddress</code> and <code>pInfos</code>[i].<code>scratchData.deviceAddress</code> + N - 1 <strong class=\"purple\">must</strong> be in the buffer device address range of the same buffer, where N is given by the <code>updateScratchSize</code> member of the <a href=\"#VkAccelerationStructureBuildSizesInfoKHR\">VkAccelerationStructureBuildSizesInfoKHR</a> structure returned from a call to <a href=\"#vkGetAccelerationStructureBuildSizesKHR\">vkGetAccelerationStructureBuildSizesKHR</a> with an identical <a href=\"#VkAccelerationStructureBuildGeometryInfoKHR\">VkAccelerationStructureBuildGeometryInfoKHR</a> structure and primitive count"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-geometry-03673",
|
|
"text": " The buffers from which the buffer device addresses for all of the <code>geometry.triangles.vertexData</code>, <code>geometry.triangles.indexData</code>, <code>geometry.triangles.transformData</code>, <code>geometry.aabbs.data</code>, and <code>geometry.instances.data</code> members of all <code>pInfos</code>[i].<code>pGeometries</code> and <code>pInfos</code>[i].<code>ppGeometries</code> are queried <strong class=\"purple\">must</strong> have been created with the <code>VK_BUFFER_USAGE_ACCELERATION_STRUCTURE_BUILD_INPUT_READ_ONLY_BIT_KHR</code> usage flag"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03674",
|
|
"text": " The buffer from which the buffer device address <code>pInfos</code>[i].<code>scratchData.deviceAddress</code> is queried <strong class=\"purple\">must</strong> have been created with <code>VK_BUFFER_USAGE_STORAGE_BUFFER_BIT</code> usage flag"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03802",
|
|
"text": " For each element of <code>pInfos</code>, its <code>scratchData.deviceAddress</code> member <strong class=\"purple\">must</strong> be a valid device address obtained from <a href=\"#vkGetBufferDeviceAddress\">vkGetBufferDeviceAddress</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03803",
|
|
"text": " For each element of <code>pInfos</code>, if <code>scratchData.deviceAddress</code> is the address of a non-sparse buffer then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <a href=\"#VkDeviceMemory\">VkDeviceMemory</a> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03710",
|
|
"text": " For each element of <code>pInfos</code>, its <code>scratchData.deviceAddress</code> member <strong class=\"purple\">must</strong> be a multiple of <a href=\"#VkPhysicalDeviceAccelerationStructurePropertiesKHR\">VkPhysicalDeviceAccelerationStructurePropertiesKHR</a>::<code>minAccelerationStructureScratchOffsetAlignment</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03804",
|
|
"text": " For any element of <code>pInfos</code>[i].<code>pGeometries</code> or <code>pInfos</code>[i].<code>ppGeometries</code> with a <code>geometryType</code> of <code>VK_GEOMETRY_TYPE_TRIANGLES_KHR</code>, <code>geometry.triangles.vertexData.deviceAddress</code> <strong class=\"purple\">must</strong> be a valid device address obtained from <a href=\"#vkGetBufferDeviceAddress\">vkGetBufferDeviceAddress</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03805",
|
|
"text": " For any element of <code>pInfos</code>[i].<code>pGeometries</code> or <code>pInfos</code>[i].<code>ppGeometries</code> with a <code>geometryType</code> of <code>VK_GEOMETRY_TYPE_TRIANGLES_KHR</code>, if <code>geometry.triangles.vertexData.deviceAddress</code> is the address of a non-sparse buffer then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <a href=\"#VkDeviceMemory\">VkDeviceMemory</a> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03711",
|
|
"text": " For any element of <code>pInfos</code>[i].<code>pGeometries</code> or <code>pInfos</code>[i].<code>ppGeometries</code> with a <code>geometryType</code> of <code>VK_GEOMETRY_TYPE_TRIANGLES_KHR</code>, <code>geometry.triangles.vertexData.deviceAddress</code> <strong class=\"purple\">must</strong> be aligned to the size in bytes of the smallest component of the format in <code>vertexFormat</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03806",
|
|
"text": " For any element of <code>pInfos</code>[i].<code>pGeometries</code> or <code>pInfos</code>[i].<code>ppGeometries</code> with a <code>geometryType</code> of <code>VK_GEOMETRY_TYPE_TRIANGLES_KHR</code>, if <code>geometry.triangles.indexType</code> is not <code>VK_INDEX_TYPE_NONE_KHR</code>, <code>geometry.triangles.indexData.deviceAddress</code> <strong class=\"purple\">must</strong> be a valid device address obtained from <a href=\"#vkGetBufferDeviceAddress\">vkGetBufferDeviceAddress</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03807",
|
|
"text": " For any element of <code>pInfos</code>[i].<code>pGeometries</code> or <code>pInfos</code>[i].<code>ppGeometries</code> with a <code>geometryType</code> of <code>VK_GEOMETRY_TYPE_TRIANGLES_KHR</code>, if <code>geometry.triangles.indexType</code> is not <code>VK_INDEX_TYPE_NONE_KHR</code>, if <code>geometry.triangles.indexData.deviceAddress</code> is the address of a non-sparse buffer then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <a href=\"#VkDeviceMemory\">VkDeviceMemory</a> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03712",
|
|
"text": " For any element of <code>pInfos</code>[i].<code>pGeometries</code> or <code>pInfos</code>[i].<code>ppGeometries</code> with a <code>geometryType</code> of <code>VK_GEOMETRY_TYPE_TRIANGLES_KHR</code>, and with <code>geometry.triangles.indexType</code> not equal to <code>VK_INDEX_TYPE_NONE_KHR</code>, <code>geometry.triangles.indexData.deviceAddress</code> <strong class=\"purple\">must</strong> be aligned to the size in bytes of the type in <code>indexType</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03808",
|
|
"text": " For any element of <code>pInfos</code>[i].<code>pGeometries</code> or <code>pInfos</code>[i].<code>ppGeometries</code> with a <code>geometryType</code> of <code>VK_GEOMETRY_TYPE_TRIANGLES_KHR</code>, if <code>geometry.triangles.transformData.deviceAddress</code> is not <code>0</code>, it <strong class=\"purple\">must</strong> be a valid device address obtained from <a href=\"#vkGetBufferDeviceAddress\">vkGetBufferDeviceAddress</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03809",
|
|
"text": " For any element of <code>pInfos</code>[i].<code>pGeometries</code> or <code>pInfos</code>[i].<code>ppGeometries</code> with a <code>geometryType</code> of <code>VK_GEOMETRY_TYPE_TRIANGLES_KHR</code>, if <code>geometry.triangles.transformData.deviceAddress</code> is the address of a non-sparse buffer then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <a href=\"#VkDeviceMemory\">VkDeviceMemory</a> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03810",
|
|
"text": " For any element of <code>pInfos</code>[i].<code>pGeometries</code> or <code>pInfos</code>[i].<code>ppGeometries</code> with a <code>geometryType</code> of <code>VK_GEOMETRY_TYPE_TRIANGLES_KHR</code>, if <code>geometry.triangles.transformData.deviceAddress</code> is not <code>0</code>, it <strong class=\"purple\">must</strong> be aligned to <code>16</code> bytes"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03811",
|
|
"text": " For any element of <code>pInfos</code>[i].<code>pGeometries</code> or <code>pInfos</code>[i].<code>ppGeometries</code> with a <code>geometryType</code> of <code>VK_GEOMETRY_TYPE_AABBS_KHR</code>, <code>geometry.aabbs.data.deviceAddress</code> <strong class=\"purple\">must</strong> be a valid device address obtained from <a href=\"#vkGetBufferDeviceAddress\">vkGetBufferDeviceAddress</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03812",
|
|
"text": " For any element of <code>pInfos</code>[i].<code>pGeometries</code> or <code>pInfos</code>[i].<code>ppGeometries</code> with a <code>geometryType</code> of <code>VK_GEOMETRY_TYPE_AABBS_KHR</code>, if <code>geometry.aabbs.data.deviceAddress</code> is the address of a non-sparse buffer then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <a href=\"#VkDeviceMemory\">VkDeviceMemory</a> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03714",
|
|
"text": " For any element of <code>pInfos</code>[i].<code>pGeometries</code> or <code>pInfos</code>[i].<code>ppGeometries</code> with a <code>geometryType</code> of <code>VK_GEOMETRY_TYPE_AABBS_KHR</code>, <code>geometry.aabbs.data.deviceAddress</code> <strong class=\"purple\">must</strong> be aligned to <code>8</code> bytes"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03715",
|
|
"text": " For any element of <code>pInfos</code>[i].<code>pGeometries</code> or <code>pInfos</code>[i].<code>ppGeometries</code> with a <code>geometryType</code> of <code>VK_GEOMETRY_TYPE_INSTANCES_KHR</code>, if <code>geometry.arrayOfPointers</code> is <code>VK_FALSE</code>, <code>geometry.instances.data.deviceAddress</code> <strong class=\"purple\">must</strong> be aligned to <code>16</code> bytes"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03716",
|
|
"text": " For any element of <code>pInfos</code>[i].<code>pGeometries</code> or <code>pInfos</code>[i].<code>ppGeometries</code> with a <code>geometryType</code> of <code>VK_GEOMETRY_TYPE_INSTANCES_KHR</code>, if <code>geometry.arrayOfPointers</code> is <code>VK_TRUE</code>, <code>geometry.instances.data.deviceAddress</code> <strong class=\"purple\">must</strong> be aligned to <code>8</code> bytes"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03717",
|
|
"text": " For any element of <code>pInfos</code>[i].<code>pGeometries</code> or <code>pInfos</code>[i].<code>ppGeometries</code> with a <code>geometryType</code> of <code>VK_GEOMETRY_TYPE_INSTANCES_KHR</code>, if <code>geometry.arrayOfPointers</code> is <code>VK_TRUE</code>, each element of <code>geometry.instances.data.deviceAddress</code> in device memory <strong class=\"purple\">must</strong> be aligned to <code>16</code> bytes"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03813",
|
|
"text": " For any element of <code>pInfos</code>[i].<code>pGeometries</code> or <code>pInfos</code>[i].<code>ppGeometries</code> with a <code>geometryType</code> of <code>VK_GEOMETRY_TYPE_INSTANCES_KHR</code>, <code>geometry.instances.data.deviceAddress</code> <strong class=\"purple\">must</strong> be a valid device address obtained from <a href=\"#vkGetBufferDeviceAddress\">vkGetBufferDeviceAddress</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03814",
|
|
"text": " For any element of <code>pInfos</code>[i].<code>pGeometries</code> or <code>pInfos</code>[i].<code>ppGeometries</code> with a <code>geometryType</code> of <code>VK_GEOMETRY_TYPE_INSTANCES_KHR</code>, if <code>geometry.instances.data.deviceAddress</code> is the address of a non-sparse buffer then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <a href=\"#VkDeviceMemory\">VkDeviceMemory</a> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-06707",
|
|
"text": " For any element of <code>pInfos</code>[i].<code>pGeometries</code> or <code>pInfos</code>[i].<code>ppGeometries</code> with a <code>geometryType</code> of <code>VK_GEOMETRY_TYPE_INSTANCES_KHR</code>, each <a href=\"#VkAccelerationStructureInstanceKHR\">VkAccelerationStructureInstanceKHR</a>::<code>accelerationStructureReference</code> value in <code>geometry.instances.data.deviceAddress</code> <strong class=\"purple\">must</strong> be a valid device address containing a value obtained from <a href=\"#vkGetAccelerationStructureDeviceAddressKHR\">vkGetAccelerationStructureDeviceAddressKHR</a> or <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pIndirectDeviceAddresses-03645",
|
|
"text": " For any element of <code>pIndirectDeviceAddresses</code>, if the buffer from which it was queried is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <a href=\"#VkDeviceMemory\">VkDeviceMemory</a> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pIndirectDeviceAddresses-03646",
|
|
"text": " For any element of <code>pIndirectDeviceAddresses</code>[i], all device addresses between <code>pIndirectDeviceAddresses</code>[i] and <span class=\"eq\"><code>pIndirectDeviceAddresses</code>[i] + (<code>pInfos</code>[i].<code>geometryCount</code> {times} <code>pIndirectStrides</code>[i]) - 1</span> <strong class=\"purple\">must</strong> be in the buffer device address range of the same buffer"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pIndirectDeviceAddresses-03647",
|
|
"text": " For any element of <code>pIndirectDeviceAddresses</code>, the buffer from which it was queried <strong class=\"purple\">must</strong> have been created with the <code>VK_BUFFER_USAGE_INDIRECT_BUFFER_BIT</code> bit set"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pIndirectDeviceAddresses-03648",
|
|
"text": " Each element of <code>pIndirectDeviceAddresses</code> <strong class=\"purple\">must</strong> be a multiple of <code>4</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pIndirectStrides-03787",
|
|
"text": " Each element of <code>pIndirectStrides</code> <strong class=\"purple\">must</strong> be a multiple of <code>4</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-commandBuffer-03649",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> not be a protected command buffer"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-accelerationStructureIndirectBuild-03650",
|
|
"text": " The <a href=\"#features-accelerationStructureIndirectBuild\"><code>VkPhysicalDeviceAccelerationStructureFeaturesKHR</code>::<code>accelerationStructureIndirectBuild</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pIndirectDeviceAddresses-03651",
|
|
"text": " Each <a href=\"#VkAccelerationStructureBuildRangeInfoKHR\">VkAccelerationStructureBuildRangeInfoKHR</a> structure referenced by any element of <code>pIndirectDeviceAddresses</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkAccelerationStructureBuildRangeInfoKHR\">VkAccelerationStructureBuildRangeInfoKHR</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03652",
|
|
"text": " <code>pInfos</code>[i].<code>dstAccelerationStructure</code> <strong class=\"purple\">must</strong> have been created with a value of <a href=\"#VkAccelerationStructureCreateInfoKHR\">VkAccelerationStructureCreateInfoKHR</a>::<code>size</code> greater than or equal to the memory size required by the build operation, as returned by <a href=\"#vkGetAccelerationStructureBuildSizesKHR\">vkGetAccelerationStructureBuildSizesKHR</a> with <span class=\"eq\"><code>pBuildInfo</code> = <code>pInfos</code>[i]</span> and <span class=\"eq\"><code>pMaxPrimitiveCounts</code> = <code>ppMaxPrimitiveCounts</code>[i]</span>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-ppMaxPrimitiveCounts-03653",
|
|
"text": " Each <code>ppMaxPrimitiveCounts</code>[i][j] <strong class=\"purple\">must</strong> be greater than or equal to the the <code>primitiveCount</code> value specified by the <a href=\"#VkAccelerationStructureBuildRangeInfoKHR\">VkAccelerationStructureBuildRangeInfoKHR</a> structure located at <span class=\"eq\"><code>pIndirectDeviceAddresses</code>[i] + (<code>j</code> {times} <code>pIndirectStrides</code>[i])</span>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-parameter",
|
|
"text": " <code>pInfos</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>infoCount</code> valid <a href=\"#VkAccelerationStructureBuildGeometryInfoKHR\">VkAccelerationStructureBuildGeometryInfoKHR</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pIndirectDeviceAddresses-parameter",
|
|
"text": " <code>pIndirectDeviceAddresses</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>infoCount</code> <code>VkDeviceAddress</code> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pIndirectStrides-parameter",
|
|
"text": " <code>pIndirectStrides</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>infoCount</code> <code>uint32_t</code> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-ppMaxPrimitiveCounts-parameter",
|
|
"text": " <code>ppMaxPrimitiveCounts</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>infoCount</code> <code>uint32_t</code> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support compute operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBuildAccelerationStructuresIndirectKHR-infoCount-arraylength",
|
|
"text": " <code>infoCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkAccelerationStructureBuildGeometryInfoKHR": {
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)+(VK_KHR_acceleration_structure)": [
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureBuildGeometryInfoKHR-type-03654",
|
|
"text": " <code>type</code> <strong class=\"purple\">must</strong> not be <code>VK_ACCELERATION_STRUCTURE_TYPE_GENERIC_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureBuildGeometryInfoKHR-pGeometries-03788",
|
|
"text": " Only one of <code>pGeometries</code> or <code>ppGeometries</code> <strong class=\"purple\">can</strong> be a valid pointer, the other <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureBuildGeometryInfoKHR-type-03789",
|
|
"text": " If <code>type</code> is <code>VK_ACCELERATION_STRUCTURE_TYPE_TOP_LEVEL_KHR</code>, the <code>geometryType</code> member of elements of either <code>pGeometries</code> or <code>ppGeometries</code> <strong class=\"purple\">must</strong> be <code>VK_GEOMETRY_TYPE_INSTANCES_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureBuildGeometryInfoKHR-type-03790",
|
|
"text": " If <code>type</code> is <code>VK_ACCELERATION_STRUCTURE_TYPE_TOP_LEVEL_KHR</code>, <code>geometryCount</code> <strong class=\"purple\">must</strong> be <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureBuildGeometryInfoKHR-type-03791",
|
|
"text": " If <code>type</code> is <code>VK_ACCELERATION_STRUCTURE_TYPE_BOTTOM_LEVEL_KHR</code> the <code>geometryType</code> member of elements of either <code>pGeometries</code> or <code>ppGeometries</code> <strong class=\"purple\">must</strong> not be <code>VK_GEOMETRY_TYPE_INSTANCES_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureBuildGeometryInfoKHR-type-03792",
|
|
"text": " If <code>type</code> is <code>VK_ACCELERATION_STRUCTURE_TYPE_BOTTOM_LEVEL_KHR</code> then the <code>geometryType</code> member of each geometry in either <code>pGeometries</code> or <code>ppGeometries</code> <strong class=\"purple\">must</strong> be the same"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureBuildGeometryInfoKHR-type-03793",
|
|
"text": " If <code>type</code> is <code>VK_ACCELERATION_STRUCTURE_TYPE_BOTTOM_LEVEL_KHR</code> then <code>geometryCount</code> <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#VkPhysicalDeviceAccelerationStructurePropertiesKHR\">VkPhysicalDeviceAccelerationStructurePropertiesKHR</a>::<code>maxGeometryCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureBuildGeometryInfoKHR-type-03794",
|
|
"text": " If <code>type</code> is <code>VK_ACCELERATION_STRUCTURE_TYPE_BOTTOM_LEVEL_KHR</code> and the <code>geometryType</code> member of either <code>pGeometries</code> or <code>ppGeometries</code> is <code>VK_GEOMETRY_TYPE_AABBS_KHR</code>, the total number of AABBs in all geometries <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#VkPhysicalDeviceAccelerationStructurePropertiesKHR\">VkPhysicalDeviceAccelerationStructurePropertiesKHR</a>::<code>maxPrimitiveCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureBuildGeometryInfoKHR-type-03795",
|
|
"text": " If <code>type</code> is <code>VK_ACCELERATION_STRUCTURE_TYPE_BOTTOM_LEVEL_KHR</code> and the <code>geometryType</code> member of either <code>pGeometries</code> or <code>ppGeometries</code> is <code>VK_GEOMETRY_TYPE_TRIANGLES_KHR</code>, the total number of triangles in all geometries <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#VkPhysicalDeviceAccelerationStructurePropertiesKHR\">VkPhysicalDeviceAccelerationStructurePropertiesKHR</a>::<code>maxPrimitiveCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureBuildGeometryInfoKHR-flags-03796",
|
|
"text": " If <code>flags</code> has the <code>VK_BUILD_ACCELERATION_STRUCTURE_PREFER_FAST_TRACE_BIT_KHR</code> bit set, then it <strong class=\"purple\">must</strong> not have the <code>VK_BUILD_ACCELERATION_STRUCTURE_PREFER_FAST_BUILD_BIT_KHR</code> bit set"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureBuildGeometryInfoKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_ACCELERATION_STRUCTURE_BUILD_GEOMETRY_INFO_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureBuildGeometryInfoKHR-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureBuildGeometryInfoKHR-type-parameter",
|
|
"text": " <code>type</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkAccelerationStructureTypeKHR\">VkAccelerationStructureTypeKHR</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureBuildGeometryInfoKHR-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkBuildAccelerationStructureFlagBitsKHR\">VkBuildAccelerationStructureFlagBitsKHR</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureBuildGeometryInfoKHR-pGeometries-parameter",
|
|
"text": " If <code>geometryCount</code> is not <code>0</code>, and <code>pGeometries</code> is not <code>NULL</code>, <code>pGeometries</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>geometryCount</code> valid <a href=\"#VkAccelerationStructureGeometryKHR\">VkAccelerationStructureGeometryKHR</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureBuildGeometryInfoKHR-ppGeometries-parameter",
|
|
"text": " If <code>geometryCount</code> is not <code>0</code>, and <code>ppGeometries</code> is not <code>NULL</code>, <code>ppGeometries</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>geometryCount</code> valid pointers to valid <a href=\"#VkAccelerationStructureGeometryKHR\">VkAccelerationStructureGeometryKHR</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureBuildGeometryInfoKHR-commonparent",
|
|
"text": " Both of <code>dstAccelerationStructure</code>, and <code>srcAccelerationStructure</code> that are valid handles of non-ignored parameters <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)+(VK_KHR_acceleration_structure)+(VK_NV_ray_tracing_motion_blur)": [
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureBuildGeometryInfoKHR-dstAccelerationStructure-04927",
|
|
"text": " If <code>dstAccelerationStructure</code> was created with <code>VK_ACCELERATION_STRUCTURE_CREATE_MOTION_BIT_NV</code> set in <a href=\"#VkAccelerationStructureCreateInfoKHR\">VkAccelerationStructureCreateInfoKHR</a>::<code>flags</code>, <code>VK_BUILD_ACCELERATION_STRUCTURE_MOTION_BIT_NV</code> <strong class=\"purple\">must</strong> be set in <code>flags</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureBuildGeometryInfoKHR-flags-04928",
|
|
"text": " If <code>VK_BUILD_ACCELERATION_STRUCTURE_MOTION_BIT_NV</code> is set in <code>flags</code>, <code>dstAccelerationStructure</code> <strong class=\"purple\">must</strong> have been created with <code>VK_ACCELERATION_STRUCTURE_CREATE_MOTION_BIT_NV</code> set in <a href=\"#VkAccelerationStructureCreateInfoKHR\">VkAccelerationStructureCreateInfoKHR</a>::<code>flags</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureBuildGeometryInfoKHR-flags-04929",
|
|
"text": " If <code>VK_BUILD_ACCELERATION_STRUCTURE_MOTION_BIT_NV</code> is set in <code>flags</code>, <code>type</code> <strong class=\"purple\">must</strong> not be <code>VK_ACCELERATION_STRUCTURE_TYPE_GENERIC_KHR</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkAccelerationStructureGeometryKHR": {
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)+(VK_KHR_acceleration_structure)": [
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureGeometryKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_ACCELERATION_STRUCTURE_GEOMETRY_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureGeometryKHR-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureGeometryKHR-geometryType-parameter",
|
|
"text": " <code>geometryType</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkGeometryTypeKHR\">VkGeometryTypeKHR</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureGeometryKHR-triangles-parameter",
|
|
"text": " If <code>geometryType</code> is <code>VK_GEOMETRY_TYPE_TRIANGLES_KHR</code>, the <code>triangles</code> member of <code>geometry</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkAccelerationStructureGeometryTrianglesDataKHR\">VkAccelerationStructureGeometryTrianglesDataKHR</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureGeometryKHR-aabbs-parameter",
|
|
"text": " If <code>geometryType</code> is <code>VK_GEOMETRY_TYPE_AABBS_KHR</code>, the <code>aabbs</code> member of <code>geometry</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkAccelerationStructureGeometryAabbsDataKHR\">VkAccelerationStructureGeometryAabbsDataKHR</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureGeometryKHR-instances-parameter",
|
|
"text": " If <code>geometryType</code> is <code>VK_GEOMETRY_TYPE_INSTANCES_KHR</code>, the <code>instances</code> member of <code>geometry</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkAccelerationStructureGeometryInstancesDataKHR\">VkAccelerationStructureGeometryInstancesDataKHR</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureGeometryKHR-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkGeometryFlagBitsKHR\">VkGeometryFlagBitsKHR</a> values"
|
|
}
|
|
]
|
|
},
|
|
"VkAccelerationStructureGeometryTrianglesDataKHR": {
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)+(VK_KHR_acceleration_structure)": [
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureGeometryTrianglesDataKHR-vertexStride-03735",
|
|
"text": " <code>vertexStride</code> <strong class=\"purple\">must</strong> be a multiple of the size in bytes of the smallest component of <code>vertexFormat</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureGeometryTrianglesDataKHR-vertexStride-03819",
|
|
"text": " <code>vertexStride</code> <strong class=\"purple\">must</strong> be less than or equal to <span class=\"eq\">2<sup>32</sup>-1</span>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureGeometryTrianglesDataKHR-vertexFormat-03797",
|
|
"text": " <code>vertexFormat</code> <strong class=\"purple\">must</strong> support the <code>VK_FORMAT_FEATURE_ACCELERATION_STRUCTURE_VERTEX_BUFFER_BIT_KHR</code> in <a href=\"#VkFormatProperties\">VkFormatProperties</a>::<code>bufferFeatures</code> as returned by <a href=\"#vkGetPhysicalDeviceFormatProperties2\">vkGetPhysicalDeviceFormatProperties2</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureGeometryTrianglesDataKHR-indexType-03798",
|
|
"text": " <code>indexType</code> <strong class=\"purple\">must</strong> be <code>VK_INDEX_TYPE_UINT16</code>, <code>VK_INDEX_TYPE_UINT32</code>, or <code>VK_INDEX_TYPE_NONE_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureGeometryTrianglesDataKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_ACCELERATION_STRUCTURE_GEOMETRY_TRIANGLES_DATA_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureGeometryTrianglesDataKHR-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkAccelerationStructureGeometryMotionTrianglesDataNV\">VkAccelerationStructureGeometryMotionTrianglesDataNV</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureGeometryTrianglesDataKHR-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureGeometryTrianglesDataKHR-vertexFormat-parameter",
|
|
"text": " <code>vertexFormat</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkFormat\">VkFormat</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureGeometryTrianglesDataKHR-indexType-parameter",
|
|
"text": " <code>indexType</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkIndexType\">VkIndexType</a> value"
|
|
}
|
|
]
|
|
},
|
|
"VkAccelerationStructureGeometryMotionTrianglesDataNV": {
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)+(VK_KHR_acceleration_structure)+(VK_NV_ray_tracing_motion_blur)": [
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureGeometryMotionTrianglesDataNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_ACCELERATION_STRUCTURE_GEOMETRY_MOTION_TRIANGLES_DATA_NV</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkTransformMatrixKHR": {
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)": [
|
|
{
|
|
"vuid": "VUID-VkTransformMatrixKHR-matrix-03799",
|
|
"text": " The first three columns of <code>matrix</code> <strong class=\"purple\">must</strong> define an invertible 3x3 matrix"
|
|
}
|
|
]
|
|
},
|
|
"VkAccelerationStructureGeometryAabbsDataKHR": {
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)+(VK_KHR_acceleration_structure)": [
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureGeometryAabbsDataKHR-stride-03545",
|
|
"text": " <code>stride</code> <strong class=\"purple\">must</strong> be a multiple of <code>8</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureGeometryAabbsDataKHR-stride-03820",
|
|
"text": " <code>stride</code> <strong class=\"purple\">must</strong> be less than or equal to <span class=\"eq\">2<sup>32</sup>-1</span>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureGeometryAabbsDataKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_ACCELERATION_STRUCTURE_GEOMETRY_AABBS_DATA_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureGeometryAabbsDataKHR-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkAabbPositionsKHR": {
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)": [
|
|
{
|
|
"vuid": "VUID-VkAabbPositionsKHR-minX-03546",
|
|
"text": " <code>minX</code> <strong class=\"purple\">must</strong> be less than or equal to <code>maxX</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAabbPositionsKHR-minY-03547",
|
|
"text": " <code>minY</code> <strong class=\"purple\">must</strong> be less than or equal to <code>maxY</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAabbPositionsKHR-minZ-03548",
|
|
"text": " <code>minZ</code> <strong class=\"purple\">must</strong> be less than or equal to <code>maxZ</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkAccelerationStructureGeometryInstancesDataKHR": {
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)+(VK_KHR_acceleration_structure)": [
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureGeometryInstancesDataKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_ACCELERATION_STRUCTURE_GEOMETRY_INSTANCES_DATA_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureGeometryInstancesDataKHR-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkAccelerationStructureInstanceKHR": {
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)": [
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureInstanceKHR-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkGeometryInstanceFlagBitsKHR\">VkGeometryInstanceFlagBitsKHR</a> values"
|
|
}
|
|
]
|
|
},
|
|
"VkAccelerationStructureMotionInstanceNV": {
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)+(VK_NV_ray_tracing_motion_blur)": [
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureMotionInstanceNV-type-parameter",
|
|
"text": " <code>type</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkAccelerationStructureMotionInstanceTypeNV\">VkAccelerationStructureMotionInstanceTypeNV</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureMotionInstanceNV-flags-zerobitmask",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureMotionInstanceNV-staticInstance-parameter",
|
|
"text": " If <code>type</code> is <code>VK_ACCELERATION_STRUCTURE_MOTION_INSTANCE_TYPE_STATIC_NV</code>, the <code>staticInstance</code> member of <code>data</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkAccelerationStructureInstanceKHR\">VkAccelerationStructureInstanceKHR</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureMotionInstanceNV-matrixMotionInstance-parameter",
|
|
"text": " If <code>type</code> is <code>VK_ACCELERATION_STRUCTURE_MOTION_INSTANCE_TYPE_MATRIX_MOTION_NV</code>, the <code>matrixMotionInstance</code> member of <code>data</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkAccelerationStructureMatrixMotionInstanceNV\">VkAccelerationStructureMatrixMotionInstanceNV</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureMotionInstanceNV-srtMotionInstance-parameter",
|
|
"text": " If <code>type</code> is <code>VK_ACCELERATION_STRUCTURE_MOTION_INSTANCE_TYPE_SRT_MOTION_NV</code>, the <code>srtMotionInstance</code> member of <code>data</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkAccelerationStructureSRTMotionInstanceNV\">VkAccelerationStructureSRTMotionInstanceNV</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkAccelerationStructureMatrixMotionInstanceNV": {
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)+(VK_NV_ray_tracing_motion_blur)": [
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureMatrixMotionInstanceNV-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkGeometryInstanceFlagBitsKHR\">VkGeometryInstanceFlagBitsKHR</a> values"
|
|
}
|
|
]
|
|
},
|
|
"VkAccelerationStructureSRTMotionInstanceNV": {
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)+(VK_NV_ray_tracing_motion_blur)": [
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureSRTMotionInstanceNV-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkGeometryInstanceFlagBitsKHR\">VkGeometryInstanceFlagBitsKHR</a> values"
|
|
}
|
|
]
|
|
},
|
|
"VkAccelerationStructureBuildRangeInfoKHR": {
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)+(VK_KHR_acceleration_structure)": [
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureBuildRangeInfoKHR-primitiveOffset-03656",
|
|
"text": " For geometries of type <code>VK_GEOMETRY_TYPE_TRIANGLES_KHR</code>, if the geometry uses indices, the offset <code>primitiveOffset</code> from <a href=\"#VkAccelerationStructureGeometryTrianglesDataKHR\">VkAccelerationStructureGeometryTrianglesDataKHR</a>::<code>indexData</code> <strong class=\"purple\">must</strong> be a multiple of the element size of <a href=\"#VkAccelerationStructureGeometryTrianglesDataKHR\">VkAccelerationStructureGeometryTrianglesDataKHR</a>::<code>indexType</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureBuildRangeInfoKHR-primitiveOffset-03657",
|
|
"text": " For geometries of type <code>VK_GEOMETRY_TYPE_TRIANGLES_KHR</code>, if the geometry does not use indices, the offset <code>primitiveOffset</code> from <a href=\"#VkAccelerationStructureGeometryTrianglesDataKHR\">VkAccelerationStructureGeometryTrianglesDataKHR</a>::<code>vertexData</code> <strong class=\"purple\">must</strong> be a multiple of the component size of <a href=\"#VkAccelerationStructureGeometryTrianglesDataKHR\">VkAccelerationStructureGeometryTrianglesDataKHR</a>::<code>vertexFormat</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureBuildRangeInfoKHR-transformOffset-03658",
|
|
"text": " For geometries of type <code>VK_GEOMETRY_TYPE_TRIANGLES_KHR</code>, the offset <code>transformOffset</code> from <a href=\"#VkAccelerationStructureGeometryTrianglesDataKHR\">VkAccelerationStructureGeometryTrianglesDataKHR</a>::<code>transformData</code> <strong class=\"purple\">must</strong> be a multiple of 16"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureBuildRangeInfoKHR-primitiveOffset-03659",
|
|
"text": " For geometries of type <code>VK_GEOMETRY_TYPE_AABBS_KHR</code>, the offset <code>primitiveOffset</code> from <a href=\"#VkAccelerationStructureGeometryAabbsDataKHR\">VkAccelerationStructureGeometryAabbsDataKHR</a>::<code>data</code> <strong class=\"purple\">must</strong> be a multiple of 8"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureBuildRangeInfoKHR-primitiveOffset-03660",
|
|
"text": " For geometries of type <code>VK_GEOMETRY_TYPE_INSTANCES_KHR</code>, the offset <code>primitiveOffset</code> from <a href=\"#VkAccelerationStructureGeometryInstancesDataKHR\">VkAccelerationStructureGeometryInstancesDataKHR</a>::<code>data</code> <strong class=\"purple\">must</strong> be a multiple of 16"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdWriteAccelerationStructuresPropertiesKHR": {
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)": [
|
|
{
|
|
"vuid": "VUID-vkCmdWriteAccelerationStructuresPropertiesKHR-queryPool-02493",
|
|
"text": " <code>queryPool</code> <strong class=\"purple\">must</strong> have been created with a <code>queryType</code> matching <code>queryType</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteAccelerationStructuresPropertiesKHR-queryPool-02494",
|
|
"text": " The queries identified by <code>queryPool</code> and <code>firstQuery</code> <strong class=\"purple\">must</strong> be <em>unavailable</em>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteAccelerationStructuresPropertiesKHR-buffer-03736",
|
|
"text": " The <code>buffer</code> used to create each acceleration structure in <code>pAccelerationStructures</code> <strong class=\"purple\">must</strong> be bound to device memory"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteAccelerationStructuresPropertiesKHR-query-04880",
|
|
"text": " The sum of <code>query</code> plus <code>accelerationStructureCount</code> <strong class=\"purple\">must</strong> be less than or equal to the number of queries in <code>queryPool</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteAccelerationStructuresPropertiesKHR-pAccelerationStructures-04964",
|
|
"text": " All acceleration structures in <code>pAccelerationStructures</code> <strong class=\"purple\">must</strong> have been built prior to the execution of this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteAccelerationStructuresPropertiesKHR-accelerationStructures-03431",
|
|
"text": " All acceleration structures in <code>pAccelerationStructures</code> <strong class=\"purple\">must</strong> have been built with <code>VK_BUILD_ACCELERATION_STRUCTURE_ALLOW_COMPACTION_BIT_KHR</code> if <code>queryType</code> is <code>VK_QUERY_TYPE_ACCELERATION_STRUCTURE_COMPACTED_SIZE_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteAccelerationStructuresPropertiesKHR-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteAccelerationStructuresPropertiesKHR-pAccelerationStructures-parameter",
|
|
"text": " <code>pAccelerationStructures</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>accelerationStructureCount</code> valid <a href=\"#VkAccelerationStructureKHR\">VkAccelerationStructureKHR</a> handles"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteAccelerationStructuresPropertiesKHR-queryType-parameter",
|
|
"text": " <code>queryType</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkQueryType\">VkQueryType</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteAccelerationStructuresPropertiesKHR-queryPool-parameter",
|
|
"text": " <code>queryPool</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkQueryPool\">VkQueryPool</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteAccelerationStructuresPropertiesKHR-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteAccelerationStructuresPropertiesKHR-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support compute operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteAccelerationStructuresPropertiesKHR-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteAccelerationStructuresPropertiesKHR-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteAccelerationStructuresPropertiesKHR-accelerationStructureCount-arraylength",
|
|
"text": " <code>accelerationStructureCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteAccelerationStructuresPropertiesKHR-commonparent",
|
|
"text": " Each of <code>commandBuffer</code>, <code>queryPool</code>, and the elements of <code>pAccelerationStructures</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)+(VK_KHR_ray_tracing_maintenance1)": [
|
|
{
|
|
"vuid": "VUID-vkCmdWriteAccelerationStructuresPropertiesKHR-queryType-06742",
|
|
"text": " <code>queryType</code> <strong class=\"purple\">must</strong> be <code>VK_QUERY_TYPE_ACCELERATION_STRUCTURE_SIZE_KHR</code>, <code>VK_QUERY_TYPE_ACCELERATION_STRUCTURE_SERIALIZATION_BOTTOM_LEVEL_POINTERS_KHR</code>, <code>VK_QUERY_TYPE_ACCELERATION_STRUCTURE_COMPACTED_SIZE_KHR</code> or <code>VK_QUERY_TYPE_ACCELERATION_STRUCTURE_SERIALIZATION_SIZE_KHR</code>"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)+!(VK_KHR_ray_tracing_maintenance1)": [
|
|
{
|
|
"vuid": "VUID-vkCmdWriteAccelerationStructuresPropertiesKHR-queryType-03432",
|
|
"text": " <code>queryType</code> <strong class=\"purple\">must</strong> be <code>VK_QUERY_TYPE_ACCELERATION_STRUCTURE_COMPACTED_SIZE_KHR</code> or <code>VK_QUERY_TYPE_ACCELERATION_STRUCTURE_SERIALIZATION_SIZE_KHR</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdWriteAccelerationStructuresPropertiesNV": {
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)+(VK_NV_ray_tracing)": [
|
|
{
|
|
"vuid": "VUID-vkCmdWriteAccelerationStructuresPropertiesNV-queryPool-03755",
|
|
"text": " <code>queryPool</code> <strong class=\"purple\">must</strong> have been created with a <code>queryType</code> matching <code>queryType</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteAccelerationStructuresPropertiesNV-queryPool-03756",
|
|
"text": " The queries identified by <code>queryPool</code> and <code>firstQuery</code> <strong class=\"purple\">must</strong> be <em>unavailable</em>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteAccelerationStructuresPropertiesNV-accelerationStructure-03757",
|
|
"text": " <code>accelerationStructure</code> <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object via <a href=\"#vkBindAccelerationStructureMemoryNV\">vkBindAccelerationStructureMemoryNV</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteAccelerationStructuresPropertiesNV-pAccelerationStructures-04958",
|
|
"text": " All acceleration structures in <code>pAccelerationStructures</code> <strong class=\"purple\">must</strong> have been built prior to the execution of this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteAccelerationStructuresPropertiesNV-pAccelerationStructures-06215",
|
|
"text": " All acceleration structures in <code>pAccelerationStructures</code> <strong class=\"purple\">must</strong> have been built with <code>VK_BUILD_ACCELERATION_STRUCTURE_ALLOW_COMPACTION_BIT_KHR</code> if <code>queryType</code> is <code>VK_QUERY_TYPE_ACCELERATION_STRUCTURE_COMPACTED_SIZE_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteAccelerationStructuresPropertiesNV-queryType-06216",
|
|
"text": " <code>queryType</code> <strong class=\"purple\">must</strong> be <code>VK_QUERY_TYPE_ACCELERATION_STRUCTURE_COMPACTED_SIZE_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteAccelerationStructuresPropertiesNV-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteAccelerationStructuresPropertiesNV-pAccelerationStructures-parameter",
|
|
"text": " <code>pAccelerationStructures</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>accelerationStructureCount</code> valid <a href=\"#VkAccelerationStructureNV\">VkAccelerationStructureNV</a> handles"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteAccelerationStructuresPropertiesNV-queryType-parameter",
|
|
"text": " <code>queryType</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkQueryType\">VkQueryType</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteAccelerationStructuresPropertiesNV-queryPool-parameter",
|
|
"text": " <code>queryPool</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkQueryPool\">VkQueryPool</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteAccelerationStructuresPropertiesNV-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteAccelerationStructuresPropertiesNV-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support compute operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteAccelerationStructuresPropertiesNV-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteAccelerationStructuresPropertiesNV-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteAccelerationStructuresPropertiesNV-accelerationStructureCount-arraylength",
|
|
"text": " <code>accelerationStructureCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdWriteAccelerationStructuresPropertiesNV-commonparent",
|
|
"text": " Each of <code>commandBuffer</code>, <code>queryPool</code>, and the elements of <code>pAccelerationStructures</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdCopyAccelerationStructureNV": {
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)+(VK_NV_ray_tracing)": [
|
|
{
|
|
"vuid": "VUID-vkCmdCopyAccelerationStructureNV-mode-03410",
|
|
"text": " <code>mode</code> <strong class=\"purple\">must</strong> be <code>VK_COPY_ACCELERATION_STRUCTURE_MODE_COMPACT_KHR</code> or <code>VK_COPY_ACCELERATION_STRUCTURE_MODE_CLONE_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyAccelerationStructureNV-src-04963",
|
|
"text": " The source acceleration structure <code>src</code> <strong class=\"purple\">must</strong> have been constructed prior to the execution of this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyAccelerationStructureNV-src-03411",
|
|
"text": " If <code>mode</code> is <code>VK_COPY_ACCELERATION_STRUCTURE_MODE_COMPACT_KHR</code>, <code>src</code> <strong class=\"purple\">must</strong> have been constructed with <code>VK_BUILD_ACCELERATION_STRUCTURE_ALLOW_COMPACTION_BIT_KHR</code> in the build"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyAccelerationStructureNV-buffer-03718",
|
|
"text": " The <code>buffer</code> used to create <code>src</code> <strong class=\"purple\">must</strong> be bound to device memory"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyAccelerationStructureNV-buffer-03719",
|
|
"text": " The <code>buffer</code> used to create <code>dst</code> <strong class=\"purple\">must</strong> be bound to device memory"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyAccelerationStructureNV-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyAccelerationStructureNV-dst-parameter",
|
|
"text": " <code>dst</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkAccelerationStructureNV\">VkAccelerationStructureNV</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyAccelerationStructureNV-src-parameter",
|
|
"text": " <code>src</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkAccelerationStructureNV\">VkAccelerationStructureNV</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyAccelerationStructureNV-mode-parameter",
|
|
"text": " <code>mode</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCopyAccelerationStructureModeKHR\">VkCopyAccelerationStructureModeKHR</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyAccelerationStructureNV-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyAccelerationStructureNV-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support compute operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyAccelerationStructureNV-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyAccelerationStructureNV-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyAccelerationStructureNV-commonparent",
|
|
"text": " Each of <code>commandBuffer</code>, <code>dst</code>, and <code>src</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdCopyAccelerationStructureKHR": {
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)+(VK_KHR_acceleration_structure)": [
|
|
{
|
|
"vuid": "VUID-vkCmdCopyAccelerationStructureKHR-buffer-03737",
|
|
"text": " The <code>buffer</code> used to create <code>pInfo->src</code> <strong class=\"purple\">must</strong> be bound to device memory"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyAccelerationStructureKHR-buffer-03738",
|
|
"text": " The <code>buffer</code> used to create <code>pInfo->dst</code> <strong class=\"purple\">must</strong> be bound to device memory"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyAccelerationStructureKHR-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyAccelerationStructureKHR-pInfo-parameter",
|
|
"text": " <code>pInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkCopyAccelerationStructureInfoKHR\">VkCopyAccelerationStructureInfoKHR</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyAccelerationStructureKHR-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyAccelerationStructureKHR-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support compute operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyAccelerationStructureKHR-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyAccelerationStructureKHR-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
]
|
|
},
|
|
"VkCopyAccelerationStructureInfoKHR": {
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)+(VK_KHR_acceleration_structure)": [
|
|
{
|
|
"vuid": "VUID-VkCopyAccelerationStructureInfoKHR-mode-03410",
|
|
"text": " <code>mode</code> <strong class=\"purple\">must</strong> be <code>VK_COPY_ACCELERATION_STRUCTURE_MODE_COMPACT_KHR</code> or <code>VK_COPY_ACCELERATION_STRUCTURE_MODE_CLONE_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyAccelerationStructureInfoKHR-src-04963",
|
|
"text": " The source acceleration structure <code>src</code> <strong class=\"purple\">must</strong> have been constructed prior to the execution of this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyAccelerationStructureInfoKHR-src-03411",
|
|
"text": " If <code>mode</code> is <code>VK_COPY_ACCELERATION_STRUCTURE_MODE_COMPACT_KHR</code>, <code>src</code> <strong class=\"purple\">must</strong> have been constructed with <code>VK_BUILD_ACCELERATION_STRUCTURE_ALLOW_COMPACTION_BIT_KHR</code> in the build"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyAccelerationStructureInfoKHR-buffer-03718",
|
|
"text": " The <code>buffer</code> used to create <code>src</code> <strong class=\"purple\">must</strong> be bound to device memory"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyAccelerationStructureInfoKHR-buffer-03719",
|
|
"text": " The <code>buffer</code> used to create <code>dst</code> <strong class=\"purple\">must</strong> be bound to device memory"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyAccelerationStructureInfoKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_COPY_ACCELERATION_STRUCTURE_INFO_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyAccelerationStructureInfoKHR-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyAccelerationStructureInfoKHR-src-parameter",
|
|
"text": " <code>src</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkAccelerationStructureKHR\">VkAccelerationStructureKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyAccelerationStructureInfoKHR-dst-parameter",
|
|
"text": " <code>dst</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkAccelerationStructureKHR\">VkAccelerationStructureKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyAccelerationStructureInfoKHR-mode-parameter",
|
|
"text": " <code>mode</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCopyAccelerationStructureModeKHR\">VkCopyAccelerationStructureModeKHR</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyAccelerationStructureInfoKHR-commonparent",
|
|
"text": " Both of <code>dst</code>, and <code>src</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdCopyAccelerationStructureToMemoryKHR": {
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)": [
|
|
{
|
|
"vuid": "VUID-vkCmdCopyAccelerationStructureToMemoryKHR-pInfo-03739",
|
|
"text": " <code>pInfo->dst.deviceAddress</code> <strong class=\"purple\">must</strong> be a valid device address for a buffer bound to device memory"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyAccelerationStructureToMemoryKHR-pInfo-03740",
|
|
"text": " <code>pInfo->dst.deviceAddress</code> <strong class=\"purple\">must</strong> be aligned to <code>256</code> bytes"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyAccelerationStructureToMemoryKHR-pInfo-03741",
|
|
"text": " If the buffer pointed to by <code>pInfo->dst.deviceAddress</code> is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <a href=\"#VkDeviceMemory\">VkDeviceMemory</a> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyAccelerationStructureToMemoryKHR-None-03559",
|
|
"text": " The <code>buffer</code> used to create <code>pInfo->src</code> <strong class=\"purple\">must</strong> be bound to device memory"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyAccelerationStructureToMemoryKHR-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyAccelerationStructureToMemoryKHR-pInfo-parameter",
|
|
"text": " <code>pInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkCopyAccelerationStructureToMemoryInfoKHR\">VkCopyAccelerationStructureToMemoryInfoKHR</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyAccelerationStructureToMemoryKHR-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyAccelerationStructureToMemoryKHR-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support compute operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyAccelerationStructureToMemoryKHR-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyAccelerationStructureToMemoryKHR-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
]
|
|
},
|
|
"VkCopyAccelerationStructureToMemoryInfoKHR": {
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)": [
|
|
{
|
|
"vuid": "VUID-VkCopyAccelerationStructureToMemoryInfoKHR-src-04959",
|
|
"text": " The source acceleration structure <code>src</code> <strong class=\"purple\">must</strong> have been constructed prior to the execution of this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyAccelerationStructureToMemoryInfoKHR-dst-03561",
|
|
"text": " The memory pointed to by <code>dst</code> <strong class=\"purple\">must</strong> be at least as large as the serialization size of <code>src</code>, as reported by <a href=\"#vkWriteAccelerationStructuresPropertiesKHR\">vkWriteAccelerationStructuresPropertiesKHR</a> or <a href=\"#vkCmdWriteAccelerationStructuresPropertiesKHR\">vkCmdWriteAccelerationStructuresPropertiesKHR</a> with a query type of <code>VK_QUERY_TYPE_ACCELERATION_STRUCTURE_SERIALIZATION_SIZE_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyAccelerationStructureToMemoryInfoKHR-mode-03412",
|
|
"text": " <code>mode</code> <strong class=\"purple\">must</strong> be <code>VK_COPY_ACCELERATION_STRUCTURE_MODE_SERIALIZE_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyAccelerationStructureToMemoryInfoKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_COPY_ACCELERATION_STRUCTURE_TO_MEMORY_INFO_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyAccelerationStructureToMemoryInfoKHR-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyAccelerationStructureToMemoryInfoKHR-src-parameter",
|
|
"text": " <code>src</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkAccelerationStructureKHR\">VkAccelerationStructureKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyAccelerationStructureToMemoryInfoKHR-mode-parameter",
|
|
"text": " <code>mode</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCopyAccelerationStructureModeKHR\">VkCopyAccelerationStructureModeKHR</a> value"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdCopyMemoryToAccelerationStructureKHR": {
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)": [
|
|
{
|
|
"vuid": "VUID-vkCmdCopyMemoryToAccelerationStructureKHR-pInfo-03742",
|
|
"text": " <code>pInfo->src.deviceAddress</code> <strong class=\"purple\">must</strong> be a valid device address for a buffer bound to device memory"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyMemoryToAccelerationStructureKHR-pInfo-03743",
|
|
"text": " <code>pInfo->src.deviceAddress</code> <strong class=\"purple\">must</strong> be aligned to <code>256</code> bytes"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyMemoryToAccelerationStructureKHR-pInfo-03744",
|
|
"text": " If the buffer pointed to by <code>pInfo->src.deviceAddress</code> is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <a href=\"#VkDeviceMemory\">VkDeviceMemory</a> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyMemoryToAccelerationStructureKHR-buffer-03745",
|
|
"text": " The <code>buffer</code> used to create <code>pInfo->dst</code> <strong class=\"purple\">must</strong> be bound to device memory"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyMemoryToAccelerationStructureKHR-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyMemoryToAccelerationStructureKHR-pInfo-parameter",
|
|
"text": " <code>pInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkCopyMemoryToAccelerationStructureInfoKHR\">VkCopyMemoryToAccelerationStructureInfoKHR</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyMemoryToAccelerationStructureKHR-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyMemoryToAccelerationStructureKHR-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support compute operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyMemoryToAccelerationStructureKHR-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCopyMemoryToAccelerationStructureKHR-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
]
|
|
},
|
|
"VkCopyMemoryToAccelerationStructureInfoKHR": {
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)": [
|
|
{
|
|
"vuid": "VUID-VkCopyMemoryToAccelerationStructureInfoKHR-src-04960",
|
|
"text": " The source memory pointed to by <code>src</code> <strong class=\"purple\">must</strong> contain data previously serialized using <a href=\"#vkCmdCopyAccelerationStructureToMemoryKHR\">vkCmdCopyAccelerationStructureToMemoryKHR</a>, potentially modified to relocate acceleration structure references as described in that command"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyMemoryToAccelerationStructureInfoKHR-mode-03413",
|
|
"text": " <code>mode</code> <strong class=\"purple\">must</strong> be <code>VK_COPY_ACCELERATION_STRUCTURE_MODE_DESERIALIZE_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyMemoryToAccelerationStructureInfoKHR-pInfo-03414",
|
|
"text": " The data in <code>src</code> <strong class=\"purple\">must</strong> have a format compatible with the destination physical device as returned by <a href=\"#vkGetDeviceAccelerationStructureCompatibilityKHR\">vkGetDeviceAccelerationStructureCompatibilityKHR</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyMemoryToAccelerationStructureInfoKHR-dst-03746",
|
|
"text": " <code>dst</code> <strong class=\"purple\">must</strong> have been created with a <code>size</code> greater than or equal to that used to serialize the data in <code>src</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyMemoryToAccelerationStructureInfoKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_COPY_MEMORY_TO_ACCELERATION_STRUCTURE_INFO_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyMemoryToAccelerationStructureInfoKHR-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyMemoryToAccelerationStructureInfoKHR-dst-parameter",
|
|
"text": " <code>dst</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkAccelerationStructureKHR\">VkAccelerationStructureKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCopyMemoryToAccelerationStructureInfoKHR-mode-parameter",
|
|
"text": " <code>mode</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCopyAccelerationStructureModeKHR\">VkCopyAccelerationStructureModeKHR</a> value"
|
|
}
|
|
]
|
|
},
|
|
"vkGetDeviceAccelerationStructureCompatibilityKHR": {
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)": [
|
|
{
|
|
"vuid": "VUID-vkGetDeviceAccelerationStructureCompatibilityKHR-rayTracingPipeline-03661",
|
|
"text": " The <a href=\"#features-rayTracingPipeline\"><code>rayTracingPipeline</code></a> or <a href=\"#features-rayQuery\"><code>rayQuery</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDeviceAccelerationStructureCompatibilityKHR-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDeviceAccelerationStructureCompatibilityKHR-pVersionInfo-parameter",
|
|
"text": " <code>pVersionInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAccelerationStructureVersionInfoKHR\">VkAccelerationStructureVersionInfoKHR</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDeviceAccelerationStructureCompatibilityKHR-pCompatibility-parameter",
|
|
"text": " <code>pCompatibility</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkAccelerationStructureCompatibilityKHR\">VkAccelerationStructureCompatibilityKHR</a> value"
|
|
}
|
|
]
|
|
},
|
|
"VkAccelerationStructureVersionInfoKHR": {
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)": [
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureVersionInfoKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_ACCELERATION_STRUCTURE_VERSION_INFO_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureVersionInfoKHR-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkAccelerationStructureVersionInfoKHR-pVersionData-parameter",
|
|
"text": " <code>pVersionData</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of \\(2 \\times \\mathtt{VK\\_UUID\\_SIZE}\\) <code>uint8_t</code> values"
|
|
}
|
|
]
|
|
},
|
|
"vkBuildAccelerationStructuresKHR": {
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)": [
|
|
{
|
|
"vuid": "VUID-vkBuildAccelerationStructuresKHR-mode-04628",
|
|
"text": " The <code>mode</code> member of each element of <code>pInfos</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBuildAccelerationStructureModeKHR\">VkBuildAccelerationStructureModeKHR</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBuildAccelerationStructuresKHR-srcAccelerationStructure-04629",
|
|
"text": " If the <code>srcAccelerationStructure</code> member of any element of <code>pInfos</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, the <code>srcAccelerationStructure</code> member <strong class=\"purple\">must</strong> be a valid <a href=\"#VkAccelerationStructureKHR\">VkAccelerationStructureKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBuildAccelerationStructuresKHR-pInfos-04630",
|
|
"text": " For each element of <code>pInfos</code>, if its <code>mode</code> member is <code>VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR</code>, its <code>srcAccelerationStructure</code> member <strong class=\"purple\">must</strong> not be <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBuildAccelerationStructuresKHR-pInfos-03403",
|
|
"text": " The <code>srcAccelerationStructure</code> member of any element of <code>pInfos</code> <strong class=\"purple\">must</strong> not be the same acceleration structure as the <code>dstAccelerationStructure</code> member of any other element of <code>pInfos</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBuildAccelerationStructuresKHR-dstAccelerationStructure-03698",
|
|
"text": " The <code>dstAccelerationStructure</code> member of any element of <code>pInfos</code> <strong class=\"purple\">must</strong> not be the same acceleration structure as the <code>dstAccelerationStructure</code> member of any other element of <code>pInfos</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBuildAccelerationStructuresKHR-dstAccelerationStructure-03800",
|
|
"text": " The <code>dstAccelerationStructure</code> member of any element of <code>pInfos</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkAccelerationStructureKHR\">VkAccelerationStructureKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBuildAccelerationStructuresKHR-pInfos-03699",
|
|
"text": " For each element of <code>pInfos</code>, if its <code>type</code> member is <code>VK_ACCELERATION_STRUCTURE_TYPE_TOP_LEVEL_KHR</code>, its <code>dstAccelerationStructure</code> member <strong class=\"purple\">must</strong> have been created with a value of <a href=\"#VkAccelerationStructureCreateInfoKHR\">VkAccelerationStructureCreateInfoKHR</a>::<code>type</code> equal to either <code>VK_ACCELERATION_STRUCTURE_TYPE_TOP_LEVEL_KHR</code> or <code>VK_ACCELERATION_STRUCTURE_TYPE_GENERIC_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBuildAccelerationStructuresKHR-pInfos-03700",
|
|
"text": " For each element of <code>pInfos</code>, if its <code>type</code> member is <code>VK_ACCELERATION_STRUCTURE_TYPE_BOTTOM_LEVEL_KHR</code>, its <code>dstAccelerationStructure</code> member <strong class=\"purple\">must</strong> have been created with a value of <a href=\"#VkAccelerationStructureCreateInfoKHR\">VkAccelerationStructureCreateInfoKHR</a>::<code>type</code> equal to either <code>VK_ACCELERATION_STRUCTURE_TYPE_BOTTOM_LEVEL_KHR</code> or <code>VK_ACCELERATION_STRUCTURE_TYPE_GENERIC_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBuildAccelerationStructuresKHR-pInfos-03663",
|
|
"text": " For each element of <code>pInfos</code>, if its <code>mode</code> member is <code>VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR</code>, <a href=\"#acceleration-structure-inactive-prims\">inactive primitives</a> in its <code>srcAccelerationStructure</code> member <strong class=\"purple\">must</strong> not be made active"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBuildAccelerationStructuresKHR-pInfos-03664",
|
|
"text": " For each element of <code>pInfos</code>, if its <code>mode</code> member is <code>VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR</code>, active primitives in its <code>srcAccelerationStructure</code> member <strong class=\"purple\">must</strong> not be made <a href=\"#acceleration-structure-inactive-prims\">inactive</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBuildAccelerationStructuresKHR-None-03407",
|
|
"text": " The <code>dstAccelerationStructure</code> member of any element of <code>pInfos</code> <strong class=\"purple\">must</strong> not be referenced by the <code>geometry.instances.data</code> member of any element of <code>pGeometries</code> or <code>ppGeometries</code> with a <code>geometryType</code> of <code>VK_GEOMETRY_TYPE_INSTANCES_KHR</code> in any other element of <code>pInfos</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBuildAccelerationStructuresKHR-dstAccelerationStructure-03701",
|
|
"text": " The range of memory backing the <code>dstAccelerationStructure</code> member of any element of <code>pInfos</code> that is accessed by this command <strong class=\"purple\">must</strong> not overlap the memory backing the <code>srcAccelerationStructure</code> member of any other element of <code>pInfos</code> with a <code>mode</code> equal to <code>VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR</code>, which is accessed by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBuildAccelerationStructuresKHR-dstAccelerationStructure-03702",
|
|
"text": " The range of memory backing the <code>dstAccelerationStructure</code> member of any element of <code>pInfos</code> that is accessed by this command <strong class=\"purple\">must</strong> not overlap the memory backing the <code>dstAccelerationStructure</code> member of any other element of <code>pInfos</code>, which is accessed by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBuildAccelerationStructuresKHR-dstAccelerationStructure-03703",
|
|
"text": " The range of memory backing the <code>dstAccelerationStructure</code> member of any element of <code>pInfos</code> that is accessed by this command <strong class=\"purple\">must</strong> not overlap the memory backing the <code>scratchData</code> member of any element of <code>pInfos</code> (including the same element), which is accessed by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBuildAccelerationStructuresKHR-scratchData-03704",
|
|
"text": " The range of memory backing the <code>scratchData</code> member of any element of <code>pInfos</code> that is accessed by this command <strong class=\"purple\">must</strong> not overlap the memory backing the <code>scratchData</code> member of any other element of <code>pInfos</code>, which is accessed by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBuildAccelerationStructuresKHR-scratchData-03705",
|
|
"text": " The range of memory backing the <code>scratchData</code> member of any element of <code>pInfos</code> that is accessed by this command <strong class=\"purple\">must</strong> not overlap the memory backing the <code>srcAccelerationStructure</code> member of any element of <code>pInfos</code> with a <code>mode</code> equal to <code>VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR</code> (including the same element), which is accessed by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBuildAccelerationStructuresKHR-dstAccelerationStructure-03706",
|
|
"text": " The range of memory backing the <code>dstAccelerationStructure</code> member of any element of <code>pInfos</code> that is accessed by this command <strong class=\"purple\">must</strong> not overlap the memory backing any acceleration structure referenced by the <code>geometry.instances.data</code> member of any element of <code>pGeometries</code> or <code>ppGeometries</code> with a <code>geometryType</code> of <code>VK_GEOMETRY_TYPE_INSTANCES_KHR</code> in any other element of <code>pInfos</code>, which is accessed by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBuildAccelerationStructuresKHR-pInfos-03667",
|
|
"text": " For each element of <code>pInfos</code>, if its <code>mode</code> member is <code>VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR</code>, its <code>srcAccelerationStructure</code> member <strong class=\"purple\">must</strong> have previously been constructed with <code>VK_BUILD_ACCELERATION_STRUCTURE_ALLOW_UPDATE_BIT_KHR</code> set in <a href=\"#VkAccelerationStructureBuildGeometryInfoKHR\">VkAccelerationStructureBuildGeometryInfoKHR</a>::<code>flags</code> in the build"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBuildAccelerationStructuresKHR-pInfos-03668",
|
|
"text": " For each element of <code>pInfos</code>, if its <code>mode</code> member is <code>VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR</code>, its <code>srcAccelerationStructure</code> and <code>dstAccelerationStructure</code> members <strong class=\"purple\">must</strong> either be the same <a href=\"#VkAccelerationStructureKHR\">VkAccelerationStructureKHR</a>, or not have any <a href=\"#resources-memory-aliasing\">memory aliasing</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBuildAccelerationStructuresKHR-pInfos-03758",
|
|
"text": " For each element of <code>pInfos</code>, if its <code>mode</code> member is <code>VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR</code>, its <code>geometryCount</code> member <strong class=\"purple\">must</strong> have the same value which was specified when <code>srcAccelerationStructure</code> was last built"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBuildAccelerationStructuresKHR-pInfos-03759",
|
|
"text": " For each element of <code>pInfos</code>, if its <code>mode</code> member is <code>VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR</code>, its <code>flags</code> member <strong class=\"purple\">must</strong> have the same value which was specified when <code>srcAccelerationStructure</code> was last built"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBuildAccelerationStructuresKHR-pInfos-03760",
|
|
"text": " For each element of <code>pInfos</code>, if its <code>mode</code> member is <code>VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR</code>, its <code>type</code> member <strong class=\"purple\">must</strong> have the same value which was specified when <code>srcAccelerationStructure</code> was last built"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBuildAccelerationStructuresKHR-pInfos-03761",
|
|
"text": " For each element of <code>pInfos</code>, if its <code>mode</code> member is <code>VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR</code>, then for each <code>VkAccelerationStructureGeometryKHR</code> structure referred to by its <code>pGeometries</code> or <code>ppGeometries</code> members, its <code>geometryType</code> member <strong class=\"purple\">must</strong> have the same value which was specified when <code>srcAccelerationStructure</code> was last built"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBuildAccelerationStructuresKHR-pInfos-03762",
|
|
"text": " For each element of <code>pInfos</code>, if its <code>mode</code> member is <code>VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR</code>, then for each <code>VkAccelerationStructureGeometryKHR</code> structure referred to by its <code>pGeometries</code> or <code>ppGeometries</code> members, its <code>flags</code> member <strong class=\"purple\">must</strong> have the same value which was specified when <code>srcAccelerationStructure</code> was last built"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBuildAccelerationStructuresKHR-pInfos-03763",
|
|
"text": " For each element of <code>pInfos</code>, if its <code>mode</code> member is <code>VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR</code>, then for each <code>VkAccelerationStructureGeometryKHR</code> structure referred to by its <code>pGeometries</code> or <code>ppGeometries</code> members, if <code>geometryType</code> is <code>VK_GEOMETRY_TYPE_TRIANGLES_KHR</code>, its <code>geometry.triangles.vertexFormat</code> member <strong class=\"purple\">must</strong> have the same value which was specified when <code>srcAccelerationStructure</code> was last built"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBuildAccelerationStructuresKHR-pInfos-03764",
|
|
"text": " For each element of <code>pInfos</code>, if its <code>mode</code> member is <code>VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR</code>, then for each <code>VkAccelerationStructureGeometryKHR</code> structure referred to by its <code>pGeometries</code> or <code>ppGeometries</code> members, if <code>geometryType</code> is <code>VK_GEOMETRY_TYPE_TRIANGLES_KHR</code>, its <code>geometry.triangles.maxVertex</code> member <strong class=\"purple\">must</strong> have the same value which was specified when <code>srcAccelerationStructure</code> was last built"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBuildAccelerationStructuresKHR-pInfos-03765",
|
|
"text": " For each element of <code>pInfos</code>, if its <code>mode</code> member is <code>VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR</code>, then for each <code>VkAccelerationStructureGeometryKHR</code> structure referred to by its <code>pGeometries</code> or <code>ppGeometries</code> members, if <code>geometryType</code> is <code>VK_GEOMETRY_TYPE_TRIANGLES_KHR</code>, its <code>geometry.triangles.indexType</code> member <strong class=\"purple\">must</strong> have the same value which was specified when <code>srcAccelerationStructure</code> was last built"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBuildAccelerationStructuresKHR-pInfos-03766",
|
|
"text": " For each element of <code>pInfos</code>, if its <code>mode</code> member is <code>VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR</code>, then for each <code>VkAccelerationStructureGeometryKHR</code> structure referred to by its <code>pGeometries</code> or <code>ppGeometries</code> members, if <code>geometryType</code> is <code>VK_GEOMETRY_TYPE_TRIANGLES_KHR</code>, if its <code>geometry.triangles.transformData</code> address was <code>NULL</code> when <code>srcAccelerationStructure</code> was last built, then it <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBuildAccelerationStructuresKHR-pInfos-03767",
|
|
"text": " For each element of <code>pInfos</code>, if its <code>mode</code> member is <code>VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR</code>, then for each <code>VkAccelerationStructureGeometryKHR</code> structure referred to by its <code>pGeometries</code> or <code>ppGeometries</code> members, if <code>geometryType</code> is <code>VK_GEOMETRY_TYPE_TRIANGLES_KHR</code>, if its <code>geometry.triangles.transformData</code> address was not <code>NULL</code> when <code>srcAccelerationStructure</code> was last built, then it <strong class=\"purple\">must</strong> not be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBuildAccelerationStructuresKHR-pInfos-03768",
|
|
"text": " For each element of <code>pInfos</code>, if its <code>mode</code> member is <code>VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR</code>, then for each <code>VkAccelerationStructureGeometryKHR</code> structure referred to by its <code>pGeometries</code> or <code>ppGeometries</code> members, if <code>geometryType</code> is <code>VK_GEOMETRY_TYPE_TRIANGLES_KHR</code>, and <code>geometry.triangles.indexType</code> is not <code>VK_INDEX_TYPE_NONE_KHR</code>, then the value of each index referenced <strong class=\"purple\">must</strong> be the same as the corresponding index value when <code>srcAccelerationStructure</code> was last built"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBuildAccelerationStructuresKHR-primitiveCount-03769",
|
|
"text": " For each <code>VkAccelerationStructureBuildRangeInfoKHR</code> referenced by this command, its <code>primitiveCount</code> member <strong class=\"purple\">must</strong> have the same value which was specified when <code>srcAccelerationStructure</code> was last built"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBuildAccelerationStructuresKHR-firstVertex-03770",
|
|
"text": " For each <code>VkAccelerationStructureBuildRangeInfoKHR</code> referenced by this command, if the corresponding geometry uses indices, its <code>firstVertex</code> member <strong class=\"purple\">must</strong> have the same value which was specified when <code>srcAccelerationStructure</code> was last built"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBuildAccelerationStructuresKHR-pInfos-03801",
|
|
"text": " For each element of <code>pInfos</code>[i].<code>pGeometries</code> or <code>pInfos</code>[i].<code>ppGeometries</code> with a <code>geometryType</code> of <code>VK_GEOMETRY_TYPE_INSTANCES_KHR</code>, the corresponding pname:ppBuildRangeInfos[i][j].pname:primitiveCount <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#VkPhysicalDeviceAccelerationStructurePropertiesKHR\">VkPhysicalDeviceAccelerationStructurePropertiesKHR</a>::<code>maxInstanceCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBuildAccelerationStructuresKHR-pInfos-03675",
|
|
"text": " For each <code>pInfos</code>[i], <code>dstAccelerationStructure</code> <strong class=\"purple\">must</strong> have been created with a value of <a href=\"#VkAccelerationStructureCreateInfoKHR\">VkAccelerationStructureCreateInfoKHR</a>::<code>size</code> greater than or equal to the memory size required by the build operation, as returned by <a href=\"#vkGetAccelerationStructureBuildSizesKHR\">vkGetAccelerationStructureBuildSizesKHR</a> with <span class=\"eq\"><code>pBuildInfo</code> = <code>pInfos</code>[i]</span> and with each element of the <code>pMaxPrimitiveCounts</code> array greater than or equal to the equivalent <code>ppBuildRangeInfos</code>[i][j].<code>primitiveCount</code> values for <code>j</code> in <span class=\"eq\">[0,<code>pInfos</code>[i].<code>geometryCount</code>)</span>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBuildAccelerationStructuresKHR-ppBuildRangeInfos-03676",
|
|
"text": " Each element of <code>ppBuildRangeInfos</code>[i] <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>pInfos</code>[i].<code>geometryCount</code> <code>VkAccelerationStructureBuildRangeInfoKHR</code> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBuildAccelerationStructuresKHR-deferredOperation-03677",
|
|
"text": " If <code>deferredOperation</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, it <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDeferredOperationKHR\">VkDeferredOperationKHR</a> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBuildAccelerationStructuresKHR-deferredOperation-03678",
|
|
"text": " Any previous deferred operation that was associated with <code>deferredOperation</code> <strong class=\"purple\">must</strong> be complete"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBuildAccelerationStructuresKHR-pInfos-03722",
|
|
"text": " For each element of <code>pInfos</code>, the <code>buffer</code> used to create its <code>dstAccelerationStructure</code> member <strong class=\"purple\">must</strong> be bound to host-visible device memory"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBuildAccelerationStructuresKHR-pInfos-03723",
|
|
"text": " For each element of <code>pInfos</code>, if its <code>mode</code> member is <code>VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR</code> the <code>buffer</code> used to create its <code>srcAccelerationStructure</code> member <strong class=\"purple\">must</strong> be bound to host-visible device memory"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBuildAccelerationStructuresKHR-pInfos-03724",
|
|
"text": " For each element of <code>pInfos</code>, the <code>buffer</code> used to create each acceleration structure referenced by the <code>geometry.instances.data</code> member of any element of <code>pGeometries</code> or <code>ppGeometries</code> with a <code>geometryType</code> of <code>VK_GEOMETRY_TYPE_INSTANCES_KHR</code> <strong class=\"purple\">must</strong> be bound to host-visible device memory"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBuildAccelerationStructuresKHR-accelerationStructureHostCommands-03581",
|
|
"text": " The <a href=\"#features-accelerationStructureHostCommands\"><code>VkPhysicalDeviceAccelerationStructureFeaturesKHR</code>::<code>accelerationStructureHostCommands</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBuildAccelerationStructuresKHR-pInfos-03725",
|
|
"text": " If <code>pInfos</code>[i].<code>mode</code> is <code>VK_BUILD_ACCELERATION_STRUCTURE_MODE_BUILD_KHR</code>, all addresses between <code>pInfos</code>[i].<code>scratchData.hostAddress</code> and <code>pInfos</code>[i].<code>scratchData.hostAddress</code> + N - 1 <strong class=\"purple\">must</strong> be valid host memory, where N is given by the <code>buildScratchSize</code> member of the <a href=\"#VkAccelerationStructureBuildSizesInfoKHR\">VkAccelerationStructureBuildSizesInfoKHR</a> structure returned from a call to <a href=\"#vkGetAccelerationStructureBuildSizesKHR\">vkGetAccelerationStructureBuildSizesKHR</a> with an identical <a href=\"#VkAccelerationStructureBuildGeometryInfoKHR\">VkAccelerationStructureBuildGeometryInfoKHR</a> structure and primitive count"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBuildAccelerationStructuresKHR-pInfos-03726",
|
|
"text": " If <code>pInfos</code>[i].<code>mode</code> is <code>VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR</code>, all addresses between <code>pInfos</code>[i].<code>scratchData.hostAddress</code> and <code>pInfos</code>[i].<code>scratchData.hostAddress</code> + N - 1 <strong class=\"purple\">must</strong> be valid host memory, where N is given by the <code>updateScratchSize</code> member of the <a href=\"#VkAccelerationStructureBuildSizesInfoKHR\">VkAccelerationStructureBuildSizesInfoKHR</a> structure returned from a call to <a href=\"#vkGetAccelerationStructureBuildSizesKHR\">vkGetAccelerationStructureBuildSizesKHR</a> with an identical <a href=\"#VkAccelerationStructureBuildGeometryInfoKHR\">VkAccelerationStructureBuildGeometryInfoKHR</a> structure and primitive count"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBuildAccelerationStructuresKHR-pInfos-03771",
|
|
"text": " For any element of <code>pInfos</code>[i].<code>pGeometries</code> or <code>pInfos</code>[i].<code>ppGeometries</code> with a <code>geometryType</code> of <code>VK_GEOMETRY_TYPE_TRIANGLES_KHR</code>, <code>geometry.triangles.vertexData.hostAddress</code> <strong class=\"purple\">must</strong> be a valid host address"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBuildAccelerationStructuresKHR-pInfos-03772",
|
|
"text": " For any element of <code>pInfos</code>[i].<code>pGeometries</code> or <code>pInfos</code>[i].<code>ppGeometries</code> with a <code>geometryType</code> of <code>VK_GEOMETRY_TYPE_TRIANGLES_KHR</code>, if <code>geometry.triangles.indexType</code> is not <code>VK_INDEX_TYPE_NONE_KHR</code>, <code>geometry.triangles.indexData.hostAddress</code> <strong class=\"purple\">must</strong> be a valid host address"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBuildAccelerationStructuresKHR-pInfos-03773",
|
|
"text": " For any element of <code>pInfos</code>[i].<code>pGeometries</code> or <code>pInfos</code>[i].<code>ppGeometries</code> with a <code>geometryType</code> of <code>VK_GEOMETRY_TYPE_TRIANGLES_KHR</code>, if <code>geometry.triangles.transformData.hostAddress</code> is not <code>0</code>, it <strong class=\"purple\">must</strong> be a valid host address"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBuildAccelerationStructuresKHR-pInfos-03774",
|
|
"text": " For any element of <code>pInfos</code>[i].<code>pGeometries</code> or <code>pInfos</code>[i].<code>ppGeometries</code> with a <code>geometryType</code> of <code>VK_GEOMETRY_TYPE_AABBS_KHR</code>, <code>geometry.aabbs.data.hostAddress</code> <strong class=\"purple\">must</strong> be a valid host address"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBuildAccelerationStructuresKHR-pInfos-03778",
|
|
"text": " For any element of <code>pInfos</code>[i].<code>pGeometries</code> or <code>pInfos</code>[i].<code>ppGeometries</code> with a <code>geometryType</code> of <code>VK_GEOMETRY_TYPE_INSTANCES_KHR</code>, <code>geometry.instances.data.hostAddress</code> <strong class=\"purple\">must</strong> be a valid host address"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBuildAccelerationStructuresKHR-pInfos-03779",
|
|
"text": " For any element of <code>pInfos</code>[i].<code>pGeometries</code> or <code>pInfos</code>[i].<code>ppGeometries</code> with a <code>geometryType</code> of <code>VK_GEOMETRY_TYPE_INSTANCES_KHR</code>, each <a href=\"#VkAccelerationStructureInstanceKHR\">VkAccelerationStructureInstanceKHR</a>::<code>accelerationStructureReference</code> value in <code>geometry.instances.data.hostAddress</code> must be a valid <a href=\"#VkAccelerationStructureKHR\">VkAccelerationStructureKHR</a> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBuildAccelerationStructuresKHR-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBuildAccelerationStructuresKHR-deferredOperation-parameter",
|
|
"text": " If <code>deferredOperation</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>deferredOperation</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDeferredOperationKHR\">VkDeferredOperationKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBuildAccelerationStructuresKHR-pInfos-parameter",
|
|
"text": " <code>pInfos</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>infoCount</code> valid <a href=\"#VkAccelerationStructureBuildGeometryInfoKHR\">VkAccelerationStructureBuildGeometryInfoKHR</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBuildAccelerationStructuresKHR-ppBuildRangeInfos-parameter",
|
|
"text": " <code>ppBuildRangeInfos</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>infoCount</code> <a href=\"#VkAccelerationStructureBuildRangeInfoKHR\">VkAccelerationStructureBuildRangeInfoKHR</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBuildAccelerationStructuresKHR-infoCount-arraylength",
|
|
"text": " <code>infoCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBuildAccelerationStructuresKHR-deferredOperation-parent",
|
|
"text": " If <code>deferredOperation</code> is a valid handle, it <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)+(VK_KHR_device_group,VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-vkBuildAccelerationStructuresKHR-pInfos-03775",
|
|
"text": " For each element of <code>pInfos</code>, the <code>buffer</code> used to create its <code>dstAccelerationStructure</code> member <strong class=\"purple\">must</strong> be bound to memory that was not allocated with multiple instances"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBuildAccelerationStructuresKHR-pInfos-03776",
|
|
"text": " For each element of <code>pInfos</code>, if its <code>mode</code> member is <code>VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR</code> the <code>buffer</code> used to create its <code>srcAccelerationStructure</code> member <strong class=\"purple\">must</strong> be bound to memory that was not allocated with multiple instances"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBuildAccelerationStructuresKHR-pInfos-03777",
|
|
"text": " For each element of <code>pInfos</code>, the <code>buffer</code> used to create each acceleration structure referenced by the <code>geometry.instances.data</code> member of any element of <code>pGeometries</code> or <code>ppGeometries</code> with a <code>geometryType</code> of <code>VK_GEOMETRY_TYPE_INSTANCES_KHR</code> <strong class=\"purple\">must</strong> be bound to memory that was not allocated with multiple instances"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)+(VK_NV_ray_tracing_motion_blur)": [
|
|
{
|
|
"vuid": "VUID-vkBuildAccelerationStructuresKHR-pInfos-04930",
|
|
"text": " For any element of <code>pInfos</code>[i].<code>pGeometries</code> or <code>pInfos</code>[i].<code>ppGeometries</code> with a <code>geometryType</code> of <code>VK_GEOMETRY_TYPE_INSTANCES_KHR</code> with <code>VK_BUILD_ACCELERATION_STRUCTURE_MOTION_BIT_NV</code> set, each <code>accelerationStructureReference</code> in any structure in <a href=\"#VkAccelerationStructureMotionInstanceNV\">VkAccelerationStructureMotionInstanceNV</a> value in <code>geometry.instances.data.hostAddress</code> must be a valid <a href=\"#VkAccelerationStructureKHR\">VkAccelerationStructureKHR</a> object"
|
|
}
|
|
]
|
|
},
|
|
"vkCopyAccelerationStructureKHR": {
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)": [
|
|
{
|
|
"vuid": "VUID-vkCopyAccelerationStructureKHR-deferredOperation-03677",
|
|
"text": " If <code>deferredOperation</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, it <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDeferredOperationKHR\">VkDeferredOperationKHR</a> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCopyAccelerationStructureKHR-deferredOperation-03678",
|
|
"text": " Any previous deferred operation that was associated with <code>deferredOperation</code> <strong class=\"purple\">must</strong> be complete"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCopyAccelerationStructureKHR-buffer-03727",
|
|
"text": " The <code>buffer</code> used to create <code>pInfo->src</code> <strong class=\"purple\">must</strong> be bound to host-visible device memory"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCopyAccelerationStructureKHR-buffer-03728",
|
|
"text": " The <code>buffer</code> used to create <code>pInfo->dst</code> <strong class=\"purple\">must</strong> be bound to host-visible device memory"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCopyAccelerationStructureKHR-accelerationStructureHostCommands-03582",
|
|
"text": " The <a href=\"#features-accelerationStructureHostCommands\"><code>VkPhysicalDeviceAccelerationStructureFeaturesKHR</code>::<code>accelerationStructureHostCommands</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCopyAccelerationStructureKHR-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCopyAccelerationStructureKHR-deferredOperation-parameter",
|
|
"text": " If <code>deferredOperation</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>deferredOperation</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDeferredOperationKHR\">VkDeferredOperationKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCopyAccelerationStructureKHR-pInfo-parameter",
|
|
"text": " <code>pInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkCopyAccelerationStructureInfoKHR\">VkCopyAccelerationStructureInfoKHR</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCopyAccelerationStructureKHR-deferredOperation-parent",
|
|
"text": " If <code>deferredOperation</code> is a valid handle, it <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)+(VK_KHR_device_group,VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-vkCopyAccelerationStructureKHR-buffer-03780",
|
|
"text": " The <code>buffer</code> used to create <code>pInfo->src</code> <strong class=\"purple\">must</strong> be bound to memory that was not allocated with multiple instances"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCopyAccelerationStructureKHR-buffer-03781",
|
|
"text": " The <code>buffer</code> used to create <code>pInfo->dst</code> <strong class=\"purple\">must</strong> be bound to memory that was not allocated with multiple instances"
|
|
}
|
|
]
|
|
},
|
|
"vkCopyMemoryToAccelerationStructureKHR": {
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)": [
|
|
{
|
|
"vuid": "VUID-vkCopyMemoryToAccelerationStructureKHR-deferredOperation-03677",
|
|
"text": " If <code>deferredOperation</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, it <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDeferredOperationKHR\">VkDeferredOperationKHR</a> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCopyMemoryToAccelerationStructureKHR-deferredOperation-03678",
|
|
"text": " Any previous deferred operation that was associated with <code>deferredOperation</code> <strong class=\"purple\">must</strong> be complete"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCopyMemoryToAccelerationStructureKHR-pInfo-03729",
|
|
"text": " <code>pInfo->src.hostAddress</code> <strong class=\"purple\">must</strong> be a valid host pointer"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCopyMemoryToAccelerationStructureKHR-pInfo-03750",
|
|
"text": " <code>pInfo->src.hostAddress</code> <strong class=\"purple\">must</strong> be aligned to 16 bytes"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCopyMemoryToAccelerationStructureKHR-buffer-03730",
|
|
"text": " The <code>buffer</code> used to create <code>pInfo->dst</code> <strong class=\"purple\">must</strong> be bound to host-visible device memory"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCopyMemoryToAccelerationStructureKHR-accelerationStructureHostCommands-03583",
|
|
"text": " The <a href=\"#features-accelerationStructureHostCommands\"><code>VkPhysicalDeviceAccelerationStructureFeaturesKHR</code>::<code>accelerationStructureHostCommands</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCopyMemoryToAccelerationStructureKHR-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCopyMemoryToAccelerationStructureKHR-deferredOperation-parameter",
|
|
"text": " If <code>deferredOperation</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>deferredOperation</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDeferredOperationKHR\">VkDeferredOperationKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCopyMemoryToAccelerationStructureKHR-pInfo-parameter",
|
|
"text": " <code>pInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkCopyMemoryToAccelerationStructureInfoKHR\">VkCopyMemoryToAccelerationStructureInfoKHR</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCopyMemoryToAccelerationStructureKHR-deferredOperation-parent",
|
|
"text": " If <code>deferredOperation</code> is a valid handle, it <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)+(VK_KHR_device_group,VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-vkCopyMemoryToAccelerationStructureKHR-buffer-03782",
|
|
"text": " The <code>buffer</code> used to create <code>pInfo->dst</code> <strong class=\"purple\">must</strong> be bound to memory that was not allocated with multiple instances"
|
|
}
|
|
]
|
|
},
|
|
"vkCopyAccelerationStructureToMemoryKHR": {
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)": [
|
|
{
|
|
"vuid": "VUID-vkCopyAccelerationStructureToMemoryKHR-deferredOperation-03677",
|
|
"text": " If <code>deferredOperation</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, it <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDeferredOperationKHR\">VkDeferredOperationKHR</a> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCopyAccelerationStructureToMemoryKHR-deferredOperation-03678",
|
|
"text": " Any previous deferred operation that was associated with <code>deferredOperation</code> <strong class=\"purple\">must</strong> be complete"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCopyAccelerationStructureToMemoryKHR-buffer-03731",
|
|
"text": " The <code>buffer</code> used to create <code>pInfo->src</code> <strong class=\"purple\">must</strong> be bound to host-visible device memory"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCopyAccelerationStructureToMemoryKHR-pInfo-03732",
|
|
"text": " <code>pInfo->dst.hostAddress</code> <strong class=\"purple\">must</strong> be a valid host pointer"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCopyAccelerationStructureToMemoryKHR-pInfo-03751",
|
|
"text": " <code>pInfo->dst.hostAddress</code> <strong class=\"purple\">must</strong> be aligned to 16 bytes"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCopyAccelerationStructureToMemoryKHR-accelerationStructureHostCommands-03584",
|
|
"text": " The <a href=\"#features-accelerationStructureHostCommands\"><code>VkPhysicalDeviceAccelerationStructureFeaturesKHR</code>::<code>accelerationStructureHostCommands</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCopyAccelerationStructureToMemoryKHR-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCopyAccelerationStructureToMemoryKHR-deferredOperation-parameter",
|
|
"text": " If <code>deferredOperation</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>deferredOperation</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDeferredOperationKHR\">VkDeferredOperationKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCopyAccelerationStructureToMemoryKHR-pInfo-parameter",
|
|
"text": " <code>pInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkCopyAccelerationStructureToMemoryInfoKHR\">VkCopyAccelerationStructureToMemoryInfoKHR</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCopyAccelerationStructureToMemoryKHR-deferredOperation-parent",
|
|
"text": " If <code>deferredOperation</code> is a valid handle, it <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)+(VK_KHR_device_group,VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-vkCopyAccelerationStructureToMemoryKHR-buffer-03783",
|
|
"text": " The <code>buffer</code> used to create <code>pInfo->src</code> <strong class=\"purple\">must</strong> be bound to memory that was not allocated with multiple instances"
|
|
}
|
|
]
|
|
},
|
|
"vkWriteAccelerationStructuresPropertiesKHR": {
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)": [
|
|
{
|
|
"vuid": "VUID-vkWriteAccelerationStructuresPropertiesKHR-pAccelerationStructures-04964",
|
|
"text": " All acceleration structures in <code>pAccelerationStructures</code> <strong class=\"purple\">must</strong> have been built prior to the execution of this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkWriteAccelerationStructuresPropertiesKHR-accelerationStructures-03431",
|
|
"text": " All acceleration structures in <code>pAccelerationStructures</code> <strong class=\"purple\">must</strong> have been built with <code>VK_BUILD_ACCELERATION_STRUCTURE_ALLOW_COMPACTION_BIT_KHR</code> if <code>queryType</code> is <code>VK_QUERY_TYPE_ACCELERATION_STRUCTURE_COMPACTED_SIZE_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkWriteAccelerationStructuresPropertiesKHR-queryType-03448",
|
|
"text": " If <code>queryType</code> is <code>VK_QUERY_TYPE_ACCELERATION_STRUCTURE_COMPACTED_SIZE_KHR</code>, then <code>stride</code> <strong class=\"purple\">must</strong> be a multiple of the size of <code>VkDeviceSize</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkWriteAccelerationStructuresPropertiesKHR-queryType-03449",
|
|
"text": " If <code>queryType</code> is <code>VK_QUERY_TYPE_ACCELERATION_STRUCTURE_COMPACTED_SIZE_KHR</code>, then <code>pData</code> <strong class=\"purple\">must</strong> point to a <code>VkDeviceSize</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkWriteAccelerationStructuresPropertiesKHR-queryType-03450",
|
|
"text": " If <code>queryType</code> is <code>VK_QUERY_TYPE_ACCELERATION_STRUCTURE_SERIALIZATION_SIZE_KHR</code>, then <code>stride</code> <strong class=\"purple\">must</strong> be a multiple of the size of <code>VkDeviceSize</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkWriteAccelerationStructuresPropertiesKHR-queryType-03451",
|
|
"text": " If <code>queryType</code> is <code>VK_QUERY_TYPE_ACCELERATION_STRUCTURE_SERIALIZATION_SIZE_KHR</code>, then <code>pData</code> <strong class=\"purple\">must</strong> point to a <code>VkDeviceSize</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkWriteAccelerationStructuresPropertiesKHR-dataSize-03452",
|
|
"text": " <code>dataSize</code> <strong class=\"purple\">must</strong> be greater than or equal to <span class=\"eq\"><code>accelerationStructureCount</code>*<code>stride</code></span>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkWriteAccelerationStructuresPropertiesKHR-buffer-03733",
|
|
"text": " The <code>buffer</code> used to create each acceleration structure in <code>pAccelerationStructures</code> <strong class=\"purple\">must</strong> be bound to host-visible device memory"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkWriteAccelerationStructuresPropertiesKHR-accelerationStructureHostCommands-03585",
|
|
"text": " The <a href=\"#features-accelerationStructureHostCommands\"><code>VkPhysicalDeviceAccelerationStructureFeaturesKHR</code>::<code>accelerationStructureHostCommands</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkWriteAccelerationStructuresPropertiesKHR-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkWriteAccelerationStructuresPropertiesKHR-pAccelerationStructures-parameter",
|
|
"text": " <code>pAccelerationStructures</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>accelerationStructureCount</code> valid <a href=\"#VkAccelerationStructureKHR\">VkAccelerationStructureKHR</a> handles"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkWriteAccelerationStructuresPropertiesKHR-queryType-parameter",
|
|
"text": " <code>queryType</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkQueryType\">VkQueryType</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkWriteAccelerationStructuresPropertiesKHR-pData-parameter",
|
|
"text": " <code>pData</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>dataSize</code> bytes"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkWriteAccelerationStructuresPropertiesKHR-accelerationStructureCount-arraylength",
|
|
"text": " <code>accelerationStructureCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkWriteAccelerationStructuresPropertiesKHR-dataSize-arraylength",
|
|
"text": " <code>dataSize</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkWriteAccelerationStructuresPropertiesKHR-pAccelerationStructures-parent",
|
|
"text": " Each element of <code>pAccelerationStructures</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)+(VK_KHR_ray_tracing_maintenance1)": [
|
|
{
|
|
"vuid": "VUID-vkWriteAccelerationStructuresPropertiesKHR-queryType-06742",
|
|
"text": " <code>queryType</code> <strong class=\"purple\">must</strong> be <code>VK_QUERY_TYPE_ACCELERATION_STRUCTURE_SIZE_KHR</code>, <code>VK_QUERY_TYPE_ACCELERATION_STRUCTURE_SERIALIZATION_BOTTOM_LEVEL_POINTERS_KHR</code>, <code>VK_QUERY_TYPE_ACCELERATION_STRUCTURE_COMPACTED_SIZE_KHR</code> or <code>VK_QUERY_TYPE_ACCELERATION_STRUCTURE_SERIALIZATION_SIZE_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkWriteAccelerationStructuresPropertiesKHR-queryType-06731",
|
|
"text": " If <code>queryType</code> is <code>VK_QUERY_TYPE_ACCELERATION_STRUCTURE_SIZE_KHR</code>, then <code>stride</code> <strong class=\"purple\">must</strong> be a multiple of the size of <code>VkDeviceSize</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkWriteAccelerationStructuresPropertiesKHR-queryType-06732",
|
|
"text": " If <code>queryType</code> is <code>VK_QUERY_TYPE_ACCELERATION_STRUCTURE_SIZE_KHR</code>, then <code>pData</code> <strong class=\"purple\">must</strong> point to a <code>VkDeviceSize</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkWriteAccelerationStructuresPropertiesKHR-queryType-06733",
|
|
"text": " If <code>queryType</code> is <code>VK_QUERY_TYPE_ACCELERATION_STRUCTURE_SERIALIZATION_BOTTOM_LEVEL_POINTERS_KHR</code>, then <code>stride</code> <strong class=\"purple\">must</strong> be a multiple of the size of <code>VkDeviceSize</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkWriteAccelerationStructuresPropertiesKHR-queryType-06734",
|
|
"text": " If <code>queryType</code> is <code>VK_QUERY_TYPE_ACCELERATION_STRUCTURE_SERIALIZATION_BOTTOM_LEVEL_POINTERS_KHR</code>, then <code>pData</code> <strong class=\"purple\">must</strong> point to a <code>VkDeviceSize</code>"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)+!(VK_KHR_ray_tracing_maintenance1)": [
|
|
{
|
|
"vuid": "VUID-vkWriteAccelerationStructuresPropertiesKHR-queryType-03432",
|
|
"text": " <code>queryType</code> <strong class=\"purple\">must</strong> be <code>VK_QUERY_TYPE_ACCELERATION_STRUCTURE_COMPACTED_SIZE_KHR</code> or <code>VK_QUERY_TYPE_ACCELERATION_STRUCTURE_SERIALIZATION_SIZE_KHR</code>"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_acceleration_structure)+(VK_KHR_device_group,VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-vkWriteAccelerationStructuresPropertiesKHR-buffer-03784",
|
|
"text": " The <code>buffer</code> used to create each acceleration structure in <code>pAccelerationStructures</code> <strong class=\"purple\">must</strong> be bound to memory that was not allocated with multiple instances"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdTraceRaysNV": {
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_NV_ray_tracing)": [
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-magFilter-04553",
|
|
"text": " If a <a href=\"#VkSampler\">VkSampler</a> created with <code>magFilter</code> or <code>minFilter</code> equal to <code>VK_FILTER_LINEAR</code> and <code>compareEnable</code> equal to <code>VK_FALSE</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-mipmapMode-04770",
|
|
"text": " If a <a href=\"#VkSampler\">VkSampler</a> created with <code>mipmapMode</code> equal to <code>VK_SAMPLER_MIPMAP_MODE_LINEAR</code> and <code>compareEnable</code> equal to <code>VK_FALSE</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-None-02691",
|
|
"text": " If a <code>VkImageView</code> is accessed using atomic operations as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_STORAGE_IMAGE_ATOMIC_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-None-02697",
|
|
"text": " For each set <em>n</em> that is statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command, a descriptor set <strong class=\"purple\">must</strong> have been bound to <em>n</em> at the same pipeline bind point, with a <code>VkPipelineLayout</code> that is compatible for set <em>n</em>, with the <code>VkPipelineLayout</code> used to create the current <code>VkPipeline</code>, as described in <a href=\"#descriptorsets-compatibility\">Pipeline Layout Compatibility</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-None-02699",
|
|
"text": " Descriptors in each bound descriptor set, specified via <code>vkCmdBindDescriptorSets</code>, <strong class=\"purple\">must</strong> be valid if they are statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-None-02700",
|
|
"text": " A valid pipeline <strong class=\"purple\">must</strong> be bound to the pipeline bind point used by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-commandBuffer-02701",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command requires any dynamic state, that state <strong class=\"purple\">must</strong> have been set or inherited (if the <code><a href=\"#VK_NV_inherited_viewport_scissor\">VK_NV_inherited_viewport_scissor</a></code> extension is enabled) for <code>commandBuffer</code>, and done so after any previously bound pipeline with the corresponding state not specified as dynamic"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-None-02859",
|
|
"text": " There <strong class=\"purple\">must</strong> not have been any calls to dynamic state setting commands for any state not specified as dynamic in the <code>VkPipeline</code> object bound to the pipeline bind point used by this command, since that pipeline was bound"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-None-02702",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> object that uses unnormalized coordinates, that sampler <strong class=\"purple\">must</strong> not be used to sample from any <code>VkImage</code> with a <code>VkImageView</code> of the type <code>VK_IMAGE_VIEW_TYPE_3D</code>, <code>VK_IMAGE_VIEW_TYPE_CUBE</code>, <code>VK_IMAGE_VIEW_TYPE_1D_ARRAY</code>, <code>VK_IMAGE_VIEW_TYPE_2D_ARRAY</code> or <code>VK_IMAGE_VIEW_TYPE_CUBE_ARRAY</code>, in any shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-None-02703",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> object that uses unnormalized coordinates, that sampler <strong class=\"purple\">must</strong> not be used with any of the SPIR-V <code>OpImageSample*</code> or <code>OpImageSparseSample*</code> instructions with <code>ImplicitLod</code>, <code>Dref</code> or <code>Proj</code> in their name, in any shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-None-02704",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> object that uses unnormalized coordinates, that sampler <strong class=\"purple\">must</strong> not be used with any of the SPIR-V <code>OpImageSample*</code> or <code>OpImageSparseSample*</code> instructions that includes a LOD bias or any offset values, in any shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-None-04115",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> is accessed using <code>OpImageWrite</code> as a result of this command, then the <code>Type</code> of the <code>Texel</code> operand of that instruction <strong class=\"purple\">must</strong> have at least as many components as the image view’s format"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-OpImageWrite-04469",
|
|
"text": " If a <a href=\"#VkBufferView\">VkBufferView</a> is accessed using <code>OpImageWrite</code> as a result of this command, then the <code>Type</code> of the <code>Texel</code> operand of that instruction <strong class=\"purple\">must</strong> have at least as many components as the buffer view’s format"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-None-03429",
|
|
"text": " Any shader group handle referenced by this call <strong class=\"purple\">must</strong> have been queried from the currently bound ray tracing pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-commandBuffer-04624",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> not be a protected command buffer"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-maxRecursionDepth-03625",
|
|
"text": " This command <strong class=\"purple\">must</strong> not cause a pipeline trace ray instruction to be executed from a shader invocation with a <a href=\"#ray-tracing-recursion-depth\">recursion depth</a> greater than the value of <code>maxRecursionDepth</code> used to create the bound ray tracing pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-raygenShaderBindingTableBuffer-04042",
|
|
"text": " If <code>raygenShaderBindingTableBuffer</code> is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-raygenShaderBindingOffset-02455",
|
|
"text": " <code>raygenShaderBindingOffset</code> <strong class=\"purple\">must</strong> be less than the size of <code>raygenShaderBindingTableBuffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-raygenShaderBindingOffset-02456",
|
|
"text": " <code>raygenShaderBindingOffset</code> <strong class=\"purple\">must</strong> be a multiple of <code>VkPhysicalDeviceRayTracingPropertiesNV</code>::<code>shaderGroupBaseAlignment</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-missShaderBindingTableBuffer-04043",
|
|
"text": " If <code>missShaderBindingTableBuffer</code> is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-missShaderBindingOffset-02457",
|
|
"text": " <code>missShaderBindingOffset</code> <strong class=\"purple\">must</strong> be less than the size of <code>missShaderBindingTableBuffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-missShaderBindingOffset-02458",
|
|
"text": " <code>missShaderBindingOffset</code> <strong class=\"purple\">must</strong> be a multiple of <code>VkPhysicalDeviceRayTracingPropertiesNV</code>::<code>shaderGroupBaseAlignment</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-hitShaderBindingTableBuffer-04044",
|
|
"text": " If <code>hitShaderBindingTableBuffer</code> is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-hitShaderBindingOffset-02459",
|
|
"text": " <code>hitShaderBindingOffset</code> <strong class=\"purple\">must</strong> be less than the size of <code>hitShaderBindingTableBuffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-hitShaderBindingOffset-02460",
|
|
"text": " <code>hitShaderBindingOffset</code> <strong class=\"purple\">must</strong> be a multiple of <code>VkPhysicalDeviceRayTracingPropertiesNV</code>::<code>shaderGroupBaseAlignment</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-callableShaderBindingTableBuffer-04045",
|
|
"text": " If <code>callableShaderBindingTableBuffer</code> is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-callableShaderBindingOffset-02461",
|
|
"text": " <code>callableShaderBindingOffset</code> <strong class=\"purple\">must</strong> be less than the size of <code>callableShaderBindingTableBuffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-callableShaderBindingOffset-02462",
|
|
"text": " <code>callableShaderBindingOffset</code> <strong class=\"purple\">must</strong> be a multiple of <code>VkPhysicalDeviceRayTracingPropertiesNV</code>::<code>shaderGroupBaseAlignment</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-missShaderBindingStride-02463",
|
|
"text": " <code>missShaderBindingStride</code> <strong class=\"purple\">must</strong> be a multiple of <code>VkPhysicalDeviceRayTracingPropertiesNV</code>::<code>shaderGroupHandleSize</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-hitShaderBindingStride-02464",
|
|
"text": " <code>hitShaderBindingStride</code> <strong class=\"purple\">must</strong> be a multiple of <code>VkPhysicalDeviceRayTracingPropertiesNV</code>::<code>shaderGroupHandleSize</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-callableShaderBindingStride-02465",
|
|
"text": " <code>callableShaderBindingStride</code> <strong class=\"purple\">must</strong> be a multiple of <code>VkPhysicalDeviceRayTracingPropertiesNV</code>::<code>shaderGroupHandleSize</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-missShaderBindingStride-02466",
|
|
"text": " <code>missShaderBindingStride</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceRayTracingPropertiesNV</code>::<code>maxShaderGroupStride</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-hitShaderBindingStride-02467",
|
|
"text": " <code>hitShaderBindingStride</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceRayTracingPropertiesNV</code>::<code>maxShaderGroupStride</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-callableShaderBindingStride-02468",
|
|
"text": " <code>callableShaderBindingStride</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceRayTracingPropertiesNV</code>::<code>maxShaderGroupStride</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-width-02469",
|
|
"text": " <code>width</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxComputeWorkGroupCount</code>[0]"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-height-02470",
|
|
"text": " <code>height</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxComputeWorkGroupCount</code>[1]"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-depth-02471",
|
|
"text": " <code>depth</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxComputeWorkGroupCount</code>[2]"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-raygenShaderBindingTableBuffer-parameter",
|
|
"text": " <code>raygenShaderBindingTableBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBuffer\">VkBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-missShaderBindingTableBuffer-parameter",
|
|
"text": " If <code>missShaderBindingTableBuffer</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>missShaderBindingTableBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBuffer\">VkBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-hitShaderBindingTableBuffer-parameter",
|
|
"text": " If <code>hitShaderBindingTableBuffer</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>hitShaderBindingTableBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBuffer\">VkBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-callableShaderBindingTableBuffer-parameter",
|
|
"text": " If <code>callableShaderBindingTableBuffer</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>callableShaderBindingTableBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBuffer\">VkBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support compute operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-commonparent",
|
|
"text": " Each of <code>callableShaderBindingTableBuffer</code>, <code>commandBuffer</code>, <code>hitShaderBindingTableBuffer</code>, <code>missShaderBindingTableBuffer</code>, and <code>raygenShaderBindingTableBuffer</code> that are valid handles of non-ignored parameters <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_NV_ray_tracing)+!(VK_VERSION_1_3,VK_KHR_format_feature_flags2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-aspectMask-06478",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> is sampled with <a href=\"#textures-depth-compare-operation\">depth comparison</a>, the image view <strong class=\"purple\">must</strong> have been created with an <code>aspectMask</code> that contains <code>VK_IMAGE_ASPECT_DEPTH_BIT</code>."
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_NV_ray_tracing)+(VK_VERSION_1_3,VK_KHR_format_feature_flags2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-None-06479",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> is sampled with <a href=\"#textures-depth-compare-operation\">depth comparison</a>, the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_SAMPLED_IMAGE_DEPTH_COMPARISON_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-OpTypeImage-06423",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> or <a href=\"#VkBufferView\">VkBufferView</a> being written as a storage image or storage texel buffer where the image format field of the <code>OpTypeImage</code> is <code>Unknown</code> then the view’s format feature <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_STORAGE_WRITE_WITHOUT_FORMAT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-OpTypeImage-06424",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> or <a href=\"#VkBufferView\">VkBufferView</a> being read as a storage image or storage texel buffer where the image format field of the <code>OpTypeImage</code> is <code>Unknown</code> then the view’s format feature <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_STORAGE_READ_WITHOUT_FORMAT_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_NV_ray_tracing)+(VK_IMG_filter_cubic,VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-None-02692",
|
|
"text": " If a <code>VkImageView</code> is sampled with <code>VK_FILTER_CUBIC_EXT</code> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_CUBIC_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_NV_ray_tracing)+(VK_IMG_filter_cubic,VK_EXT_filter_cubic)+!(VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-None-02693",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> being sampled with <code>VK_FILTER_CUBIC_EXT</code> as a result of this command <strong class=\"purple\">must</strong> not have a <a href=\"#VkImageViewType\">VkImageViewType</a> of <code>VK_IMAGE_VIEW_TYPE_3D</code>, <code>VK_IMAGE_VIEW_TYPE_CUBE</code>, or <code>VK_IMAGE_VIEW_TYPE_CUBE_ARRAY</code>"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_NV_ray_tracing)+(VK_IMG_filter_cubic,VK_EXT_filter_cubic)+(VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-filterCubic-02694",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> being sampled with <code>VK_FILTER_CUBIC_EXT</code> as a result of this command <strong class=\"purple\">must</strong> have a <a href=\"#VkImageViewType\">VkImageViewType</a> and format that supports cubic filtering, as specified by <code>VkFilterCubicImageViewImageFormatPropertiesEXT</code>::<code>filterCubic</code> returned by <code>vkGetPhysicalDeviceImageFormatProperties2</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-filterCubicMinmax-02695",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> being sampled with <code>VK_FILTER_CUBIC_EXT</code> with a reduction mode of either <code>VK_SAMPLER_REDUCTION_MODE_MIN</code> or <code>VK_SAMPLER_REDUCTION_MODE_MAX</code> as a result of this command <strong class=\"purple\">must</strong> have a <a href=\"#VkImageViewType\">VkImageViewType</a> and format that supports cubic filtering together with minmax filtering, as specified by <code>VkFilterCubicImageViewImageFormatPropertiesEXT</code>::<code>filterCubicMinmax</code> returned by <code>vkGetPhysicalDeviceImageFormatProperties2</code>"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_NV_ray_tracing)+(VK_NV_corner_sampled_image)": [
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-flags-02696",
|
|
"text": " Any <a href=\"#VkImage\">VkImage</a> created with a <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a>::<code>flags</code> containing <code>VK_IMAGE_CREATE_CORNER_SAMPLED_BIT_NV</code> sampled as a result of this command <strong class=\"purple\">must</strong> only be sampled using a <a href=\"#VkSamplerAddressMode\">VkSamplerAddressMode</a> of <code>VK_SAMPLER_ADDRESS_MODE_CLAMP_TO_EDGE</code>"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_NV_ray_tracing)+!(VK_VERSION_1_3,VK_KHR_maintenance4)": [
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-None-02698",
|
|
"text": " For each push constant that is statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command, a push constant value <strong class=\"purple\">must</strong> have been set for the same pipeline bind point, with a <code>VkPipelineLayout</code> that is compatible for push constants, with the <code>VkPipelineLayout</code> used to create the current <code>VkPipeline</code>, as described in <a href=\"#descriptorsets-compatibility\">Pipeline Layout Compatibility</a>"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_NV_ray_tracing)+(VK_VERSION_1_3,VK_KHR_maintenance4)": [
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-maintenance4-06425",
|
|
"text": " If the <a href=\"#features-maintenance4\"><code>maintenance4</code></a> feature is not enabled, then for each push constant that is statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command, a push constant value <strong class=\"purple\">must</strong> have been set for the same pipeline bind point, with a <code>VkPipelineLayout</code> that is compatible for push constants, with the <code>VkPipelineLayout</code> used to create the current <code>VkPipeline</code>, as described in <a href=\"#descriptorsets-compatibility\">Pipeline Layout Compatibility</a>"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_NV_ray_tracing)+!(VK_EXT_pipeline_robustness)": [
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-None-02705",
|
|
"text": " If the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, and if the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a uniform buffer, it <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-None-02706",
|
|
"text": " If the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, and if the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a storage buffer, it <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_NV_ray_tracing)+(VK_EXT_pipeline_robustness)": [
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-uniformBuffers-06935",
|
|
"text": " If any stage of the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a uniform buffer, and that stage was created without enabling either <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_EXT</code> or <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXT</code> for <code>uniformBuffers</code>, and the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, that stage <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-storageBuffers-06936",
|
|
"text": " If any stage of the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a storage buffer, and that stage was created without enabling either <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_EXT</code> or <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXT</code> for <code>storageBuffers</code>, and the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, that stage <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_NV_ray_tracing)+(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-commandBuffer-02707",
|
|
"text": " If <code>commandBuffer</code> is an unprotected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, any resource accessed by the <a href=\"#VkPipeline\">VkPipeline</a> object bound to the pipeline bind point used by this command <strong class=\"purple\">must</strong> not be a protected resource"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_NV_ray_tracing)+(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-None-06550",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> or <code>VkImageView</code> object that enables <a href=\"#samplers-YCbCr-conversion\">sampler {YCbCr} conversion</a>, that object <strong class=\"purple\">must</strong> only be used with <code>OpImageSample*</code> or <code>OpImageSparseSample*</code> instructions"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-ConstOffset-06551",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> or <code>VkImageView</code> object that enables <a href=\"#samplers-YCbCr-conversion\">sampler {YCbCr} conversion</a>, that object <strong class=\"purple\">must</strong> not use the <code>ConstOffset</code> and <code>Offset</code> operands"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_NV_ray_tracing)+(VK_EXT_shader_image_atomic_int64)": [
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-SampledType-04470",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a 64-bit component width is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 64"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-SampledType-04471",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a component width less than 64-bit is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 32"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-SampledType-04472",
|
|
"text": " If a <a href=\"#VkBufferView\">VkBufferView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a 64-bit component width is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 64"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-SampledType-04473",
|
|
"text": " If a <a href=\"#VkBufferView\">VkBufferView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a component width less than 64-bit is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 32"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-sparseImageInt64Atomics-04474",
|
|
"text": " If the <a href=\"#features-sparseImageInt64Atomics\"><code>sparseImageInt64Atomics</code></a> feature is not enabled, <a href=\"#VkImage\">VkImage</a> objects created with the <code>VK_IMAGE_CREATE_SPARSE_RESIDENCY_BIT</code> flag <strong class=\"purple\">must</strong> not be accessed by atomic instructions through an <code>OpTypeImage</code> with a <code>SampledType</code> with a <code>Width</code> of 64 by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-sparseImageInt64Atomics-04475",
|
|
"text": " If the <a href=\"#features-sparseImageInt64Atomics\"><code>sparseImageInt64Atomics</code></a> feature is not enabled, <a href=\"#VkBuffer\">VkBuffer</a> objects created with the <code>VK_BUFFER_CREATE_SPARSE_RESIDENCY_BIT</code> flag <strong class=\"purple\">must</strong> not be accessed by atomic instructions through an <code>OpTypeImage</code> with a <code>SampledType</code> with a <code>Width</code> of 64 by this command"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_NV_ray_tracing)+(VK_QCOM_image_processing)": [
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-OpImageWeightedSampleQCOM-06971",
|
|
"text": " If <code>OpImageWeightedSampleQCOM</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_WEIGHT_SAMPLED_IMAGE_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-OpImageWeightedSampleQCOM-06972",
|
|
"text": " If <code>OpImageWeightedSampleQCOM</code> uses a <a href=\"#VkImageView\">VkImageView</a> as a sample weight image as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_WEIGHT_IMAGE_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-OpImageBoxFilterQCOM-06973",
|
|
"text": " If <code>OpImageBoxFilterQCOM</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_BOX_FILTER_SAMPLED_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-OpImageBlockMatchSSDQCOM-06974",
|
|
"text": " If <code>OpImageBlockMatchSSDQCOM</code> is used to read from an <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-OpImageBlockMatchSADQCOM-06975",
|
|
"text": " If <code>OpImageBlockMatchSADQCOM</code> is used to read from an <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-OpImageBlockMatchSADQCOM-06976",
|
|
"text": " If <code>OpImageBlockMatchSADQCOM</code> or OpImageBlockMatchSSDQCOM is used to read from a reference image as result of this command, then the specified reference coordinates <strong class=\"purple\">must</strong> not fail <a href=\"#textures-integer-coordinate-validation\">integer texel coordinate validation</a>."
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-OpImageWeightedSampleQCOM-06977",
|
|
"text": " If <code>OpImageWeightedSampleQCOM</code>, <code>OpImageBoxFilterQCOM</code>, <code>OpImageBlockMatchSSDQCOM</code>, or <code>OpImageBlockMatchSADQCOM</code> uses a <a href=\"#VkSampler\">VkSampler</a> as a result of this command, then the sampler <strong class=\"purple\">must</strong> have been created with <code>VK_SAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysNV-OpImageWeightedSampleQCOM-06978",
|
|
"text": " If any command other than <code>OpImageWeightedSampleQCOM</code>, <code>OpImageBoxFilterQCOM</code>, <code>OpImageBlockMatchSSDQCOM</code>, or <code>OpImageBlockMatchSADQCOM</code> uses a <a href=\"#VkSampler\">VkSampler</a> as a result of this command, then the sampler <strong class=\"purple\">must</strong> not have been created with <code>VK_SAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM</code>."
|
|
}
|
|
]
|
|
},
|
|
"vkCmdTraceRaysKHR": {
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)": [
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-magFilter-04553",
|
|
"text": " If a <a href=\"#VkSampler\">VkSampler</a> created with <code>magFilter</code> or <code>minFilter</code> equal to <code>VK_FILTER_LINEAR</code> and <code>compareEnable</code> equal to <code>VK_FALSE</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-mipmapMode-04770",
|
|
"text": " If a <a href=\"#VkSampler\">VkSampler</a> created with <code>mipmapMode</code> equal to <code>VK_SAMPLER_MIPMAP_MODE_LINEAR</code> and <code>compareEnable</code> equal to <code>VK_FALSE</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-None-02691",
|
|
"text": " If a <code>VkImageView</code> is accessed using atomic operations as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_STORAGE_IMAGE_ATOMIC_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-None-02697",
|
|
"text": " For each set <em>n</em> that is statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command, a descriptor set <strong class=\"purple\">must</strong> have been bound to <em>n</em> at the same pipeline bind point, with a <code>VkPipelineLayout</code> that is compatible for set <em>n</em>, with the <code>VkPipelineLayout</code> used to create the current <code>VkPipeline</code>, as described in <a href=\"#descriptorsets-compatibility\">Pipeline Layout Compatibility</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-None-02699",
|
|
"text": " Descriptors in each bound descriptor set, specified via <code>vkCmdBindDescriptorSets</code>, <strong class=\"purple\">must</strong> be valid if they are statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-None-02700",
|
|
"text": " A valid pipeline <strong class=\"purple\">must</strong> be bound to the pipeline bind point used by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-commandBuffer-02701",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command requires any dynamic state, that state <strong class=\"purple\">must</strong> have been set or inherited (if the <code><a href=\"#VK_NV_inherited_viewport_scissor\">VK_NV_inherited_viewport_scissor</a></code> extension is enabled) for <code>commandBuffer</code>, and done so after any previously bound pipeline with the corresponding state not specified as dynamic"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-None-02859",
|
|
"text": " There <strong class=\"purple\">must</strong> not have been any calls to dynamic state setting commands for any state not specified as dynamic in the <code>VkPipeline</code> object bound to the pipeline bind point used by this command, since that pipeline was bound"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-None-02702",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> object that uses unnormalized coordinates, that sampler <strong class=\"purple\">must</strong> not be used to sample from any <code>VkImage</code> with a <code>VkImageView</code> of the type <code>VK_IMAGE_VIEW_TYPE_3D</code>, <code>VK_IMAGE_VIEW_TYPE_CUBE</code>, <code>VK_IMAGE_VIEW_TYPE_1D_ARRAY</code>, <code>VK_IMAGE_VIEW_TYPE_2D_ARRAY</code> or <code>VK_IMAGE_VIEW_TYPE_CUBE_ARRAY</code>, in any shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-None-02703",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> object that uses unnormalized coordinates, that sampler <strong class=\"purple\">must</strong> not be used with any of the SPIR-V <code>OpImageSample*</code> or <code>OpImageSparseSample*</code> instructions with <code>ImplicitLod</code>, <code>Dref</code> or <code>Proj</code> in their name, in any shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-None-02704",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> object that uses unnormalized coordinates, that sampler <strong class=\"purple\">must</strong> not be used with any of the SPIR-V <code>OpImageSample*</code> or <code>OpImageSparseSample*</code> instructions that includes a LOD bias or any offset values, in any shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-None-04115",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> is accessed using <code>OpImageWrite</code> as a result of this command, then the <code>Type</code> of the <code>Texel</code> operand of that instruction <strong class=\"purple\">must</strong> have at least as many components as the image view’s format"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-OpImageWrite-04469",
|
|
"text": " If a <a href=\"#VkBufferView\">VkBufferView</a> is accessed using <code>OpImageWrite</code> as a result of this command, then the <code>Type</code> of the <code>Texel</code> operand of that instruction <strong class=\"purple\">must</strong> have at least as many components as the buffer view’s format"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-None-03429",
|
|
"text": " Any shader group handle referenced by this call <strong class=\"purple\">must</strong> have been queried from the currently bound ray tracing pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-maxPipelineRayRecursionDepth-03679",
|
|
"text": " This command <strong class=\"purple\">must</strong> not cause a shader call instruction to be executed from a shader invocation with a <a href=\"#ray-tracing-recursion-depth\">recursion depth</a> greater than the value of <code>maxPipelineRayRecursionDepth</code> used to create the bound ray tracing pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-commandBuffer-03635",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> not be a protected command buffer"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-size-04023",
|
|
"text": " The <code>size</code> member of <code>pRayGenShaderBindingTable</code> <strong class=\"purple\">must</strong> be equal to its <code>stride</code> member"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-pRayGenShaderBindingTable-03680",
|
|
"text": " If the buffer from which pname:pRayGenShaderBindingTable->deviceAddress was queried is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-pRayGenShaderBindingTable-03681",
|
|
"text": " The buffer from which the pname:pRayGenShaderBindingTable->deviceAddress is queried <strong class=\"purple\">must</strong> have been created with the <code>VK_BUFFER_USAGE_SHADER_BINDING_TABLE_BIT_KHR</code> usage flag"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-pRayGenShaderBindingTable-03682",
|
|
"text": " pname:pRayGenShaderBindingTable->deviceAddress <strong class=\"purple\">must</strong> be a multiple of <code>VkPhysicalDeviceRayTracingPipelinePropertiesKHR</code>::<code>shaderGroupBaseAlignment</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-pMissShaderBindingTable-03683",
|
|
"text": " If the buffer from which pname:pMissShaderBindingTable->deviceAddress was queried is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-pMissShaderBindingTable-03684",
|
|
"text": " The buffer from which the pname:pMissShaderBindingTable->deviceAddress is queried <strong class=\"purple\">must</strong> have been created with the <code>VK_BUFFER_USAGE_SHADER_BINDING_TABLE_BIT_KHR</code> usage flag"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-pMissShaderBindingTable-03685",
|
|
"text": " pname:pMissShaderBindingTable->deviceAddress <strong class=\"purple\">must</strong> be a multiple of <code>VkPhysicalDeviceRayTracingPipelinePropertiesKHR</code>::<code>shaderGroupBaseAlignment</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-stride-03686",
|
|
"text": " pname:pMissShaderBindingTable->stride <strong class=\"purple\">must</strong> be a multiple of <code>VkPhysicalDeviceRayTracingPipelinePropertiesKHR</code>::<code>shaderGroupHandleAlignment</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-stride-04029",
|
|
"text": " pname:pMissShaderBindingTable->stride <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceRayTracingPipelinePropertiesKHR</code>::<code>maxShaderGroupStride</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-pHitShaderBindingTable-03687",
|
|
"text": " If the buffer from which pname:pHitShaderBindingTable->deviceAddress was queried is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-pHitShaderBindingTable-03688",
|
|
"text": " The buffer from which the pname:pHitShaderBindingTable->deviceAddress is queried <strong class=\"purple\">must</strong> have been created with the <code>VK_BUFFER_USAGE_SHADER_BINDING_TABLE_BIT_KHR</code> usage flag"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-pHitShaderBindingTable-03689",
|
|
"text": " pname:pHitShaderBindingTable->deviceAddress <strong class=\"purple\">must</strong> be a multiple of <code>VkPhysicalDeviceRayTracingPipelinePropertiesKHR</code>::<code>shaderGroupBaseAlignment</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-stride-03690",
|
|
"text": " pname:pHitShaderBindingTable->stride <strong class=\"purple\">must</strong> be a multiple of <code>VkPhysicalDeviceRayTracingPipelinePropertiesKHR</code>::<code>shaderGroupHandleAlignment</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-stride-04035",
|
|
"text": " pname:pHitShaderBindingTable->stride <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceRayTracingPipelinePropertiesKHR</code>::<code>maxShaderGroupStride</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-pCallableShaderBindingTable-03691",
|
|
"text": " If the buffer from which pname:pCallableShaderBindingTable->deviceAddress was queried is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-pCallableShaderBindingTable-03692",
|
|
"text": " The buffer from which the pname:pCallableShaderBindingTable->deviceAddress is queried <strong class=\"purple\">must</strong> have been created with the <code>VK_BUFFER_USAGE_SHADER_BINDING_TABLE_BIT_KHR</code> usage flag"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-pCallableShaderBindingTable-03693",
|
|
"text": " pname:pCallableShaderBindingTable->deviceAddress <strong class=\"purple\">must</strong> be a multiple of <code>VkPhysicalDeviceRayTracingPipelinePropertiesKHR</code>::<code>shaderGroupBaseAlignment</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-stride-03694",
|
|
"text": " pname:pCallableShaderBindingTable->stride <strong class=\"purple\">must</strong> be a multiple of <code>VkPhysicalDeviceRayTracingPipelinePropertiesKHR</code>::<code>shaderGroupHandleAlignment</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-stride-04041",
|
|
"text": " pname:pCallableShaderBindingTable->stride <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceRayTracingPipelinePropertiesKHR</code>::<code>maxShaderGroupStride</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-flags-03696",
|
|
"text": " If the currently bound ray tracing pipeline was created with <code>flags</code> that included <code>VK_PIPELINE_CREATE_RAY_TRACING_NO_NULL_CLOSEST_HIT_SHADERS_BIT_KHR</code>, pname:pHitShaderBindingTable->deviceAddress <strong class=\"purple\">must</strong> not be zero"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-flags-03697",
|
|
"text": " If the currently bound ray tracing pipeline was created with <code>flags</code> that included <code>VK_PIPELINE_CREATE_RAY_TRACING_NO_NULL_INTERSECTION_SHADERS_BIT_KHR</code>, pname:pHitShaderBindingTable->deviceAddress <strong class=\"purple\">must</strong> not be zero"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-flags-03511",
|
|
"text": " If the currently bound ray tracing pipeline was created with <code>flags</code> that included <code>VK_PIPELINE_CREATE_RAY_TRACING_NO_NULL_MISS_SHADERS_BIT_KHR</code>, the shader group handle identified by pname:pMissShaderBindingTable->deviceAddress <strong class=\"purple\">must</strong> not be set to zero"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-flags-03512",
|
|
"text": " If the currently bound ray tracing pipeline was created with <code>flags</code> that included <code>VK_PIPELINE_CREATE_RAY_TRACING_NO_NULL_ANY_HIT_SHADERS_BIT_KHR</code>, entries in the table identified by pname:pHitShaderBindingTable->deviceAddress accessed as a result of this command in order to execute an any-hit shader <strong class=\"purple\">must</strong> not be set to zero"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-flags-03513",
|
|
"text": " If the currently bound ray tracing pipeline was created with <code>flags</code> that included <code>VK_PIPELINE_CREATE_RAY_TRACING_NO_NULL_CLOSEST_HIT_SHADERS_BIT_KHR</code>, entries in the table identified by pname:pHitShaderBindingTable->deviceAddress accessed as a result of this command in order to execute a closest hit shader <strong class=\"purple\">must</strong> not be set to zero"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-flags-03514",
|
|
"text": " If the currently bound ray tracing pipeline was created with <code>flags</code> that included <code>VK_PIPELINE_CREATE_RAY_TRACING_NO_NULL_INTERSECTION_SHADERS_BIT_KHR</code>, entries in the table identified by pname:pHitShaderBindingTable->deviceAddress accessed as a result of this command in order to execute an intersection shader <strong class=\"purple\">must</strong> not be set to zero"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-pHitShaderBindingTable-04735",
|
|
"text": " Any non-zero hit shader group entries in the table identified by pname:pHitShaderBindingTable->deviceAddress accessed by this call from a geometry with a <code>geometryType</code> of <code>VK_GEOMETRY_TYPE_TRIANGLES_KHR</code> <strong class=\"purple\">must</strong> have been created with <code>VK_RAY_TRACING_SHADER_GROUP_TYPE_TRIANGLES_HIT_GROUP_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-pHitShaderBindingTable-04736",
|
|
"text": " Any non-zero hit shader group entries in the table identified by pname:pHitShaderBindingTable->deviceAddress accessed by this call from a geometry with a <code>geometryType</code> of <code>VK_GEOMETRY_TYPE_AABBS_KHR</code> <strong class=\"purple\">must</strong> have been created with <code>VK_RAY_TRACING_SHADER_GROUP_TYPE_PROCEDURAL_HIT_GROUP_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-width-03638",
|
|
"text": " <code>width</code> <strong class=\"purple\">must</strong> be less than or equal to <span class=\"eq\"><code>VkPhysicalDeviceLimits</code>::<code>maxComputeWorkGroupCount</code>[0] {times} <code>VkPhysicalDeviceLimits</code>::<code>maxComputeWorkGroupSize</code>[0]</span>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-height-03639",
|
|
"text": " <code>height</code> <strong class=\"purple\">must</strong> be less than or equal to <span class=\"eq\"><code>VkPhysicalDeviceLimits</code>::<code>maxComputeWorkGroupCount</code>[1] {times} <code>VkPhysicalDeviceLimits</code>::<code>maxComputeWorkGroupSize</code>[1]</span>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-depth-03640",
|
|
"text": " <code>depth</code> <strong class=\"purple\">must</strong> be less than or equal to <span class=\"eq\"><code>VkPhysicalDeviceLimits</code>::<code>maxComputeWorkGroupCount</code>[2] {times} <code>VkPhysicalDeviceLimits</code>::<code>maxComputeWorkGroupSize</code>[2]</span>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-width-03641",
|
|
"text": " <span class=\"eq\"><code>width</code> {times} <code>height</code> {times} <code>depth</code></span> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceRayTracingPipelinePropertiesKHR</code>::<code>maxRayDispatchInvocationCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-pRaygenShaderBindingTable-parameter",
|
|
"text": " <code>pRaygenShaderBindingTable</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkStridedDeviceAddressRegionKHR\">VkStridedDeviceAddressRegionKHR</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-pMissShaderBindingTable-parameter",
|
|
"text": " <code>pMissShaderBindingTable</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkStridedDeviceAddressRegionKHR\">VkStridedDeviceAddressRegionKHR</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-pHitShaderBindingTable-parameter",
|
|
"text": " <code>pHitShaderBindingTable</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkStridedDeviceAddressRegionKHR\">VkStridedDeviceAddressRegionKHR</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-pCallableShaderBindingTable-parameter",
|
|
"text": " <code>pCallableShaderBindingTable</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkStridedDeviceAddressRegionKHR\">VkStridedDeviceAddressRegionKHR</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support compute operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)+!(VK_VERSION_1_3,VK_KHR_format_feature_flags2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-aspectMask-06478",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> is sampled with <a href=\"#textures-depth-compare-operation\">depth comparison</a>, the image view <strong class=\"purple\">must</strong> have been created with an <code>aspectMask</code> that contains <code>VK_IMAGE_ASPECT_DEPTH_BIT</code>."
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)+(VK_VERSION_1_3,VK_KHR_format_feature_flags2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-None-06479",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> is sampled with <a href=\"#textures-depth-compare-operation\">depth comparison</a>, the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_SAMPLED_IMAGE_DEPTH_COMPARISON_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-OpTypeImage-06423",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> or <a href=\"#VkBufferView\">VkBufferView</a> being written as a storage image or storage texel buffer where the image format field of the <code>OpTypeImage</code> is <code>Unknown</code> then the view’s format feature <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_STORAGE_WRITE_WITHOUT_FORMAT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-OpTypeImage-06424",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> or <a href=\"#VkBufferView\">VkBufferView</a> being read as a storage image or storage texel buffer where the image format field of the <code>OpTypeImage</code> is <code>Unknown</code> then the view’s format feature <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_STORAGE_READ_WITHOUT_FORMAT_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)+(VK_IMG_filter_cubic,VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-None-02692",
|
|
"text": " If a <code>VkImageView</code> is sampled with <code>VK_FILTER_CUBIC_EXT</code> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_CUBIC_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)+(VK_IMG_filter_cubic,VK_EXT_filter_cubic)+!(VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-None-02693",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> being sampled with <code>VK_FILTER_CUBIC_EXT</code> as a result of this command <strong class=\"purple\">must</strong> not have a <a href=\"#VkImageViewType\">VkImageViewType</a> of <code>VK_IMAGE_VIEW_TYPE_3D</code>, <code>VK_IMAGE_VIEW_TYPE_CUBE</code>, or <code>VK_IMAGE_VIEW_TYPE_CUBE_ARRAY</code>"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)+(VK_IMG_filter_cubic,VK_EXT_filter_cubic)+(VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-filterCubic-02694",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> being sampled with <code>VK_FILTER_CUBIC_EXT</code> as a result of this command <strong class=\"purple\">must</strong> have a <a href=\"#VkImageViewType\">VkImageViewType</a> and format that supports cubic filtering, as specified by <code>VkFilterCubicImageViewImageFormatPropertiesEXT</code>::<code>filterCubic</code> returned by <code>vkGetPhysicalDeviceImageFormatProperties2</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-filterCubicMinmax-02695",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> being sampled with <code>VK_FILTER_CUBIC_EXT</code> with a reduction mode of either <code>VK_SAMPLER_REDUCTION_MODE_MIN</code> or <code>VK_SAMPLER_REDUCTION_MODE_MAX</code> as a result of this command <strong class=\"purple\">must</strong> have a <a href=\"#VkImageViewType\">VkImageViewType</a> and format that supports cubic filtering together with minmax filtering, as specified by <code>VkFilterCubicImageViewImageFormatPropertiesEXT</code>::<code>filterCubicMinmax</code> returned by <code>vkGetPhysicalDeviceImageFormatProperties2</code>"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)+(VK_NV_corner_sampled_image)": [
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-flags-02696",
|
|
"text": " Any <a href=\"#VkImage\">VkImage</a> created with a <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a>::<code>flags</code> containing <code>VK_IMAGE_CREATE_CORNER_SAMPLED_BIT_NV</code> sampled as a result of this command <strong class=\"purple\">must</strong> only be sampled using a <a href=\"#VkSamplerAddressMode\">VkSamplerAddressMode</a> of <code>VK_SAMPLER_ADDRESS_MODE_CLAMP_TO_EDGE</code>"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)+!(VK_VERSION_1_3,VK_KHR_maintenance4)": [
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-None-02698",
|
|
"text": " For each push constant that is statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command, a push constant value <strong class=\"purple\">must</strong> have been set for the same pipeline bind point, with a <code>VkPipelineLayout</code> that is compatible for push constants, with the <code>VkPipelineLayout</code> used to create the current <code>VkPipeline</code>, as described in <a href=\"#descriptorsets-compatibility\">Pipeline Layout Compatibility</a>"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)+(VK_VERSION_1_3,VK_KHR_maintenance4)": [
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-maintenance4-06425",
|
|
"text": " If the <a href=\"#features-maintenance4\"><code>maintenance4</code></a> feature is not enabled, then for each push constant that is statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command, a push constant value <strong class=\"purple\">must</strong> have been set for the same pipeline bind point, with a <code>VkPipelineLayout</code> that is compatible for push constants, with the <code>VkPipelineLayout</code> used to create the current <code>VkPipeline</code>, as described in <a href=\"#descriptorsets-compatibility\">Pipeline Layout Compatibility</a>"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)+!(VK_EXT_pipeline_robustness)": [
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-None-02705",
|
|
"text": " If the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, and if the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a uniform buffer, it <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-None-02706",
|
|
"text": " If the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, and if the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a storage buffer, it <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)+(VK_EXT_pipeline_robustness)": [
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-uniformBuffers-06935",
|
|
"text": " If any stage of the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a uniform buffer, and that stage was created without enabling either <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_EXT</code> or <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXT</code> for <code>uniformBuffers</code>, and the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, that stage <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-storageBuffers-06936",
|
|
"text": " If any stage of the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a storage buffer, and that stage was created without enabling either <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_EXT</code> or <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXT</code> for <code>storageBuffers</code>, and the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, that stage <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)+(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-commandBuffer-02707",
|
|
"text": " If <code>commandBuffer</code> is an unprotected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, any resource accessed by the <a href=\"#VkPipeline\">VkPipeline</a> object bound to the pipeline bind point used by this command <strong class=\"purple\">must</strong> not be a protected resource"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)+(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-None-06550",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> or <code>VkImageView</code> object that enables <a href=\"#samplers-YCbCr-conversion\">sampler {YCbCr} conversion</a>, that object <strong class=\"purple\">must</strong> only be used with <code>OpImageSample*</code> or <code>OpImageSparseSample*</code> instructions"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-ConstOffset-06551",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> or <code>VkImageView</code> object that enables <a href=\"#samplers-YCbCr-conversion\">sampler {YCbCr} conversion</a>, that object <strong class=\"purple\">must</strong> not use the <code>ConstOffset</code> and <code>Offset</code> operands"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)+(VK_EXT_shader_image_atomic_int64)": [
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-SampledType-04470",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a 64-bit component width is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 64"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-SampledType-04471",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a component width less than 64-bit is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 32"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-SampledType-04472",
|
|
"text": " If a <a href=\"#VkBufferView\">VkBufferView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a 64-bit component width is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 64"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-SampledType-04473",
|
|
"text": " If a <a href=\"#VkBufferView\">VkBufferView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a component width less than 64-bit is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 32"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-sparseImageInt64Atomics-04474",
|
|
"text": " If the <a href=\"#features-sparseImageInt64Atomics\"><code>sparseImageInt64Atomics</code></a> feature is not enabled, <a href=\"#VkImage\">VkImage</a> objects created with the <code>VK_IMAGE_CREATE_SPARSE_RESIDENCY_BIT</code> flag <strong class=\"purple\">must</strong> not be accessed by atomic instructions through an <code>OpTypeImage</code> with a <code>SampledType</code> with a <code>Width</code> of 64 by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-sparseImageInt64Atomics-04475",
|
|
"text": " If the <a href=\"#features-sparseImageInt64Atomics\"><code>sparseImageInt64Atomics</code></a> feature is not enabled, <a href=\"#VkBuffer\">VkBuffer</a> objects created with the <code>VK_BUFFER_CREATE_SPARSE_RESIDENCY_BIT</code> flag <strong class=\"purple\">must</strong> not be accessed by atomic instructions through an <code>OpTypeImage</code> with a <code>SampledType</code> with a <code>Width</code> of 64 by this command"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)+(VK_QCOM_image_processing)": [
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-OpImageWeightedSampleQCOM-06971",
|
|
"text": " If <code>OpImageWeightedSampleQCOM</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_WEIGHT_SAMPLED_IMAGE_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-OpImageWeightedSampleQCOM-06972",
|
|
"text": " If <code>OpImageWeightedSampleQCOM</code> uses a <a href=\"#VkImageView\">VkImageView</a> as a sample weight image as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_WEIGHT_IMAGE_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-OpImageBoxFilterQCOM-06973",
|
|
"text": " If <code>OpImageBoxFilterQCOM</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_BOX_FILTER_SAMPLED_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-OpImageBlockMatchSSDQCOM-06974",
|
|
"text": " If <code>OpImageBlockMatchSSDQCOM</code> is used to read from an <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-OpImageBlockMatchSADQCOM-06975",
|
|
"text": " If <code>OpImageBlockMatchSADQCOM</code> is used to read from an <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-OpImageBlockMatchSADQCOM-06976",
|
|
"text": " If <code>OpImageBlockMatchSADQCOM</code> or OpImageBlockMatchSSDQCOM is used to read from a reference image as result of this command, then the specified reference coordinates <strong class=\"purple\">must</strong> not fail <a href=\"#textures-integer-coordinate-validation\">integer texel coordinate validation</a>."
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-OpImageWeightedSampleQCOM-06977",
|
|
"text": " If <code>OpImageWeightedSampleQCOM</code>, <code>OpImageBoxFilterQCOM</code>, <code>OpImageBlockMatchSSDQCOM</code>, or <code>OpImageBlockMatchSADQCOM</code> uses a <a href=\"#VkSampler\">VkSampler</a> as a result of this command, then the sampler <strong class=\"purple\">must</strong> have been created with <code>VK_SAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysKHR-OpImageWeightedSampleQCOM-06978",
|
|
"text": " If any command other than <code>OpImageWeightedSampleQCOM</code>, <code>OpImageBoxFilterQCOM</code>, <code>OpImageBlockMatchSSDQCOM</code>, or <code>OpImageBlockMatchSADQCOM</code> uses a <a href=\"#VkSampler\">VkSampler</a> as a result of this command, then the sampler <strong class=\"purple\">must</strong> not have been created with <code>VK_SAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM</code>."
|
|
}
|
|
]
|
|
},
|
|
"VkStridedDeviceAddressRegionKHR": {
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)": [
|
|
{
|
|
"vuid": "VUID-VkStridedDeviceAddressRegionKHR-size-04631",
|
|
"text": " If <code>size</code> is not zero, all addresses between <code>deviceAddress</code> and <span class=\"eq\"><code>deviceAddress</code> + <code>size</code> - 1</span> <strong class=\"purple\">must</strong> be in the buffer device address range of the same buffer"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkStridedDeviceAddressRegionKHR-size-04632",
|
|
"text": " If <code>size</code> is not zero, <code>stride</code> <strong class=\"purple\">must</strong> be less than or equal to the size of the buffer from which <code>deviceAddress</code> was queried"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdBindInvocationMaskHUAWEI": {
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)+(VK_HUAWEI_invocation_mask)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBindInvocationMaskHUAWEI-None-04976",
|
|
"text": " The <a href=\"#features-invocationMask\"><code>invocationMask</code></a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindInvocationMaskHUAWEI-imageView-04977",
|
|
"text": " If <code>imageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, it <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageView\">VkImageView</a> handle of type <code>VK_IMAGE_VIEW_TYPE_2D</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindInvocationMaskHUAWEI-imageView-04978",
|
|
"text": " If <code>imageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, it <strong class=\"purple\">must</strong> have a format of <code>VK_FORMAT_R8_UINT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindInvocationMaskHUAWEI-imageView-04979",
|
|
"text": " If <code>imageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, it <strong class=\"purple\">must</strong> have been created with <code>VK_IMAGE_USAGE_INVOCATION_MASK_BIT_HUAWEI</code> set"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindInvocationMaskHUAWEI-imageView-04980",
|
|
"text": " If <code>imageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>imageLayout</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_LAYOUT_GENERAL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindInvocationMaskHUAWEI-width-04981",
|
|
"text": " Thread mask image resolution must match the <code>width</code> and <code>height</code> in <a href=\"#vkCmdTraceRaysKHR\">vkCmdTraceRaysKHR</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindInvocationMaskHUAWEI-None-04982",
|
|
"text": " Each element in the invocation mask image <strong class=\"purple\">must</strong> have the value <code>0</code> or <code>1</code>. The value 1 means the invocation is active"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindInvocationMaskHUAWEI-width-04983",
|
|
"text": " <code>width</code> in <a href=\"#vkCmdTraceRaysKHR\">vkCmdTraceRaysKHR</a> should be 1"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindInvocationMaskHUAWEI-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindInvocationMaskHUAWEI-imageView-parameter",
|
|
"text": " If <code>imageView</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>imageView</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageView\">VkImageView</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindInvocationMaskHUAWEI-imageLayout-parameter",
|
|
"text": " <code>imageLayout</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageLayout\">VkImageLayout</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindInvocationMaskHUAWEI-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindInvocationMaskHUAWEI-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support compute operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindInvocationMaskHUAWEI-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindInvocationMaskHUAWEI-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBindInvocationMaskHUAWEI-commonparent",
|
|
"text": " Both of <code>commandBuffer</code>, and <code>imageView</code> that are valid handles of non-ignored parameters <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdTraceRaysIndirectKHR": {
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)": [
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-magFilter-04553",
|
|
"text": " If a <a href=\"#VkSampler\">VkSampler</a> created with <code>magFilter</code> or <code>minFilter</code> equal to <code>VK_FILTER_LINEAR</code> and <code>compareEnable</code> equal to <code>VK_FALSE</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-mipmapMode-04770",
|
|
"text": " If a <a href=\"#VkSampler\">VkSampler</a> created with <code>mipmapMode</code> equal to <code>VK_SAMPLER_MIPMAP_MODE_LINEAR</code> and <code>compareEnable</code> equal to <code>VK_FALSE</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-None-02691",
|
|
"text": " If a <code>VkImageView</code> is accessed using atomic operations as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_STORAGE_IMAGE_ATOMIC_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-None-02697",
|
|
"text": " For each set <em>n</em> that is statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command, a descriptor set <strong class=\"purple\">must</strong> have been bound to <em>n</em> at the same pipeline bind point, with a <code>VkPipelineLayout</code> that is compatible for set <em>n</em>, with the <code>VkPipelineLayout</code> used to create the current <code>VkPipeline</code>, as described in <a href=\"#descriptorsets-compatibility\">Pipeline Layout Compatibility</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-None-02699",
|
|
"text": " Descriptors in each bound descriptor set, specified via <code>vkCmdBindDescriptorSets</code>, <strong class=\"purple\">must</strong> be valid if they are statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-None-02700",
|
|
"text": " A valid pipeline <strong class=\"purple\">must</strong> be bound to the pipeline bind point used by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-commandBuffer-02701",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command requires any dynamic state, that state <strong class=\"purple\">must</strong> have been set or inherited (if the <code><a href=\"#VK_NV_inherited_viewport_scissor\">VK_NV_inherited_viewport_scissor</a></code> extension is enabled) for <code>commandBuffer</code>, and done so after any previously bound pipeline with the corresponding state not specified as dynamic"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-None-02859",
|
|
"text": " There <strong class=\"purple\">must</strong> not have been any calls to dynamic state setting commands for any state not specified as dynamic in the <code>VkPipeline</code> object bound to the pipeline bind point used by this command, since that pipeline was bound"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-None-02702",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> object that uses unnormalized coordinates, that sampler <strong class=\"purple\">must</strong> not be used to sample from any <code>VkImage</code> with a <code>VkImageView</code> of the type <code>VK_IMAGE_VIEW_TYPE_3D</code>, <code>VK_IMAGE_VIEW_TYPE_CUBE</code>, <code>VK_IMAGE_VIEW_TYPE_1D_ARRAY</code>, <code>VK_IMAGE_VIEW_TYPE_2D_ARRAY</code> or <code>VK_IMAGE_VIEW_TYPE_CUBE_ARRAY</code>, in any shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-None-02703",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> object that uses unnormalized coordinates, that sampler <strong class=\"purple\">must</strong> not be used with any of the SPIR-V <code>OpImageSample*</code> or <code>OpImageSparseSample*</code> instructions with <code>ImplicitLod</code>, <code>Dref</code> or <code>Proj</code> in their name, in any shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-None-02704",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> object that uses unnormalized coordinates, that sampler <strong class=\"purple\">must</strong> not be used with any of the SPIR-V <code>OpImageSample*</code> or <code>OpImageSparseSample*</code> instructions that includes a LOD bias or any offset values, in any shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-None-04115",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> is accessed using <code>OpImageWrite</code> as a result of this command, then the <code>Type</code> of the <code>Texel</code> operand of that instruction <strong class=\"purple\">must</strong> have at least as many components as the image view’s format"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-OpImageWrite-04469",
|
|
"text": " If a <a href=\"#VkBufferView\">VkBufferView</a> is accessed using <code>OpImageWrite</code> as a result of this command, then the <code>Type</code> of the <code>Texel</code> operand of that instruction <strong class=\"purple\">must</strong> have at least as many components as the buffer view’s format"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-None-03429",
|
|
"text": " Any shader group handle referenced by this call <strong class=\"purple\">must</strong> have been queried from the currently bound ray tracing pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-maxPipelineRayRecursionDepth-03679",
|
|
"text": " This command <strong class=\"purple\">must</strong> not cause a shader call instruction to be executed from a shader invocation with a <a href=\"#ray-tracing-recursion-depth\">recursion depth</a> greater than the value of <code>maxPipelineRayRecursionDepth</code> used to create the bound ray tracing pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-commandBuffer-03635",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> not be a protected command buffer"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-size-04023",
|
|
"text": " The <code>size</code> member of <code>pRayGenShaderBindingTable</code> <strong class=\"purple\">must</strong> be equal to its <code>stride</code> member"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-pRayGenShaderBindingTable-03680",
|
|
"text": " If the buffer from which pname:pRayGenShaderBindingTable->deviceAddress was queried is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-pRayGenShaderBindingTable-03681",
|
|
"text": " The buffer from which the pname:pRayGenShaderBindingTable->deviceAddress is queried <strong class=\"purple\">must</strong> have been created with the <code>VK_BUFFER_USAGE_SHADER_BINDING_TABLE_BIT_KHR</code> usage flag"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-pRayGenShaderBindingTable-03682",
|
|
"text": " pname:pRayGenShaderBindingTable->deviceAddress <strong class=\"purple\">must</strong> be a multiple of <code>VkPhysicalDeviceRayTracingPipelinePropertiesKHR</code>::<code>shaderGroupBaseAlignment</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-pMissShaderBindingTable-03683",
|
|
"text": " If the buffer from which pname:pMissShaderBindingTable->deviceAddress was queried is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-pMissShaderBindingTable-03684",
|
|
"text": " The buffer from which the pname:pMissShaderBindingTable->deviceAddress is queried <strong class=\"purple\">must</strong> have been created with the <code>VK_BUFFER_USAGE_SHADER_BINDING_TABLE_BIT_KHR</code> usage flag"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-pMissShaderBindingTable-03685",
|
|
"text": " pname:pMissShaderBindingTable->deviceAddress <strong class=\"purple\">must</strong> be a multiple of <code>VkPhysicalDeviceRayTracingPipelinePropertiesKHR</code>::<code>shaderGroupBaseAlignment</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-stride-03686",
|
|
"text": " pname:pMissShaderBindingTable->stride <strong class=\"purple\">must</strong> be a multiple of <code>VkPhysicalDeviceRayTracingPipelinePropertiesKHR</code>::<code>shaderGroupHandleAlignment</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-stride-04029",
|
|
"text": " pname:pMissShaderBindingTable->stride <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceRayTracingPipelinePropertiesKHR</code>::<code>maxShaderGroupStride</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-pHitShaderBindingTable-03687",
|
|
"text": " If the buffer from which pname:pHitShaderBindingTable->deviceAddress was queried is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-pHitShaderBindingTable-03688",
|
|
"text": " The buffer from which the pname:pHitShaderBindingTable->deviceAddress is queried <strong class=\"purple\">must</strong> have been created with the <code>VK_BUFFER_USAGE_SHADER_BINDING_TABLE_BIT_KHR</code> usage flag"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-pHitShaderBindingTable-03689",
|
|
"text": " pname:pHitShaderBindingTable->deviceAddress <strong class=\"purple\">must</strong> be a multiple of <code>VkPhysicalDeviceRayTracingPipelinePropertiesKHR</code>::<code>shaderGroupBaseAlignment</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-stride-03690",
|
|
"text": " pname:pHitShaderBindingTable->stride <strong class=\"purple\">must</strong> be a multiple of <code>VkPhysicalDeviceRayTracingPipelinePropertiesKHR</code>::<code>shaderGroupHandleAlignment</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-stride-04035",
|
|
"text": " pname:pHitShaderBindingTable->stride <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceRayTracingPipelinePropertiesKHR</code>::<code>maxShaderGroupStride</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-pCallableShaderBindingTable-03691",
|
|
"text": " If the buffer from which pname:pCallableShaderBindingTable->deviceAddress was queried is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-pCallableShaderBindingTable-03692",
|
|
"text": " The buffer from which the pname:pCallableShaderBindingTable->deviceAddress is queried <strong class=\"purple\">must</strong> have been created with the <code>VK_BUFFER_USAGE_SHADER_BINDING_TABLE_BIT_KHR</code> usage flag"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-pCallableShaderBindingTable-03693",
|
|
"text": " pname:pCallableShaderBindingTable->deviceAddress <strong class=\"purple\">must</strong> be a multiple of <code>VkPhysicalDeviceRayTracingPipelinePropertiesKHR</code>::<code>shaderGroupBaseAlignment</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-stride-03694",
|
|
"text": " pname:pCallableShaderBindingTable->stride <strong class=\"purple\">must</strong> be a multiple of <code>VkPhysicalDeviceRayTracingPipelinePropertiesKHR</code>::<code>shaderGroupHandleAlignment</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-stride-04041",
|
|
"text": " pname:pCallableShaderBindingTable->stride <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceRayTracingPipelinePropertiesKHR</code>::<code>maxShaderGroupStride</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-flags-03696",
|
|
"text": " If the currently bound ray tracing pipeline was created with <code>flags</code> that included <code>VK_PIPELINE_CREATE_RAY_TRACING_NO_NULL_CLOSEST_HIT_SHADERS_BIT_KHR</code>, pname:pHitShaderBindingTable->deviceAddress <strong class=\"purple\">must</strong> not be zero"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-flags-03697",
|
|
"text": " If the currently bound ray tracing pipeline was created with <code>flags</code> that included <code>VK_PIPELINE_CREATE_RAY_TRACING_NO_NULL_INTERSECTION_SHADERS_BIT_KHR</code>, pname:pHitShaderBindingTable->deviceAddress <strong class=\"purple\">must</strong> not be zero"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-flags-03511",
|
|
"text": " If the currently bound ray tracing pipeline was created with <code>flags</code> that included <code>VK_PIPELINE_CREATE_RAY_TRACING_NO_NULL_MISS_SHADERS_BIT_KHR</code>, the shader group handle identified by pname:pMissShaderBindingTable->deviceAddress <strong class=\"purple\">must</strong> not be set to zero"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-flags-03512",
|
|
"text": " If the currently bound ray tracing pipeline was created with <code>flags</code> that included <code>VK_PIPELINE_CREATE_RAY_TRACING_NO_NULL_ANY_HIT_SHADERS_BIT_KHR</code>, entries in the table identified by pname:pHitShaderBindingTable->deviceAddress accessed as a result of this command in order to execute an any-hit shader <strong class=\"purple\">must</strong> not be set to zero"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-flags-03513",
|
|
"text": " If the currently bound ray tracing pipeline was created with <code>flags</code> that included <code>VK_PIPELINE_CREATE_RAY_TRACING_NO_NULL_CLOSEST_HIT_SHADERS_BIT_KHR</code>, entries in the table identified by pname:pHitShaderBindingTable->deviceAddress accessed as a result of this command in order to execute a closest hit shader <strong class=\"purple\">must</strong> not be set to zero"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-flags-03514",
|
|
"text": " If the currently bound ray tracing pipeline was created with <code>flags</code> that included <code>VK_PIPELINE_CREATE_RAY_TRACING_NO_NULL_INTERSECTION_SHADERS_BIT_KHR</code>, entries in the table identified by pname:pHitShaderBindingTable->deviceAddress accessed as a result of this command in order to execute an intersection shader <strong class=\"purple\">must</strong> not be set to zero"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-pHitShaderBindingTable-04735",
|
|
"text": " Any non-zero hit shader group entries in the table identified by pname:pHitShaderBindingTable->deviceAddress accessed by this call from a geometry with a <code>geometryType</code> of <code>VK_GEOMETRY_TYPE_TRIANGLES_KHR</code> <strong class=\"purple\">must</strong> have been created with <code>VK_RAY_TRACING_SHADER_GROUP_TYPE_TRIANGLES_HIT_GROUP_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-pHitShaderBindingTable-04736",
|
|
"text": " Any non-zero hit shader group entries in the table identified by pname:pHitShaderBindingTable->deviceAddress accessed by this call from a geometry with a <code>geometryType</code> of <code>VK_GEOMETRY_TYPE_AABBS_KHR</code> <strong class=\"purple\">must</strong> have been created with <code>VK_RAY_TRACING_SHADER_GROUP_TYPE_PROCEDURAL_HIT_GROUP_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-indirectDeviceAddress-03632",
|
|
"text": " If the buffer from which <code>indirectDeviceAddress</code> was queried is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-indirectDeviceAddress-03633",
|
|
"text": " The buffer from which <code>indirectDeviceAddress</code> was queried <strong class=\"purple\">must</strong> have been created with the <code>VK_BUFFER_USAGE_INDIRECT_BUFFER_BIT</code> bit set"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-indirectDeviceAddress-03634",
|
|
"text": " <code>indirectDeviceAddress</code> <strong class=\"purple\">must</strong> be a multiple of <code>4</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-indirectDeviceAddress-03636",
|
|
"text": " All device addresses between <code>indirectDeviceAddress</code> and <span class=\"eq\"><code>indirectDeviceAddress</code> + <code>sizeof</code>(sname:VkTraceRaysIndirectCommandKHR) - 1</span> <strong class=\"purple\">must</strong> be in the buffer device address range of the same buffer"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-rayTracingPipelineTraceRaysIndirect-03637",
|
|
"text": " The <a href=\"#features-rayTracingPipelineTraceRaysIndirect\">pname:rayTracingPipelineTraceRaysIndirect</a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-pRaygenShaderBindingTable-parameter",
|
|
"text": " <code>pRaygenShaderBindingTable</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkStridedDeviceAddressRegionKHR\">VkStridedDeviceAddressRegionKHR</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-pMissShaderBindingTable-parameter",
|
|
"text": " <code>pMissShaderBindingTable</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkStridedDeviceAddressRegionKHR\">VkStridedDeviceAddressRegionKHR</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-pHitShaderBindingTable-parameter",
|
|
"text": " <code>pHitShaderBindingTable</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkStridedDeviceAddressRegionKHR\">VkStridedDeviceAddressRegionKHR</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-pCallableShaderBindingTable-parameter",
|
|
"text": " <code>pCallableShaderBindingTable</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkStridedDeviceAddressRegionKHR\">VkStridedDeviceAddressRegionKHR</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support compute operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)+!(VK_VERSION_1_3,VK_KHR_format_feature_flags2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-aspectMask-06478",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> is sampled with <a href=\"#textures-depth-compare-operation\">depth comparison</a>, the image view <strong class=\"purple\">must</strong> have been created with an <code>aspectMask</code> that contains <code>VK_IMAGE_ASPECT_DEPTH_BIT</code>."
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)+(VK_VERSION_1_3,VK_KHR_format_feature_flags2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-None-06479",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> is sampled with <a href=\"#textures-depth-compare-operation\">depth comparison</a>, the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_SAMPLED_IMAGE_DEPTH_COMPARISON_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-OpTypeImage-06423",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> or <a href=\"#VkBufferView\">VkBufferView</a> being written as a storage image or storage texel buffer where the image format field of the <code>OpTypeImage</code> is <code>Unknown</code> then the view’s format feature <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_STORAGE_WRITE_WITHOUT_FORMAT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-OpTypeImage-06424",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> or <a href=\"#VkBufferView\">VkBufferView</a> being read as a storage image or storage texel buffer where the image format field of the <code>OpTypeImage</code> is <code>Unknown</code> then the view’s format feature <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_STORAGE_READ_WITHOUT_FORMAT_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)+(VK_IMG_filter_cubic,VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-None-02692",
|
|
"text": " If a <code>VkImageView</code> is sampled with <code>VK_FILTER_CUBIC_EXT</code> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_CUBIC_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)+(VK_IMG_filter_cubic,VK_EXT_filter_cubic)+!(VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-None-02693",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> being sampled with <code>VK_FILTER_CUBIC_EXT</code> as a result of this command <strong class=\"purple\">must</strong> not have a <a href=\"#VkImageViewType\">VkImageViewType</a> of <code>VK_IMAGE_VIEW_TYPE_3D</code>, <code>VK_IMAGE_VIEW_TYPE_CUBE</code>, or <code>VK_IMAGE_VIEW_TYPE_CUBE_ARRAY</code>"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)+(VK_IMG_filter_cubic,VK_EXT_filter_cubic)+(VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-filterCubic-02694",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> being sampled with <code>VK_FILTER_CUBIC_EXT</code> as a result of this command <strong class=\"purple\">must</strong> have a <a href=\"#VkImageViewType\">VkImageViewType</a> and format that supports cubic filtering, as specified by <code>VkFilterCubicImageViewImageFormatPropertiesEXT</code>::<code>filterCubic</code> returned by <code>vkGetPhysicalDeviceImageFormatProperties2</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-filterCubicMinmax-02695",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> being sampled with <code>VK_FILTER_CUBIC_EXT</code> with a reduction mode of either <code>VK_SAMPLER_REDUCTION_MODE_MIN</code> or <code>VK_SAMPLER_REDUCTION_MODE_MAX</code> as a result of this command <strong class=\"purple\">must</strong> have a <a href=\"#VkImageViewType\">VkImageViewType</a> and format that supports cubic filtering together with minmax filtering, as specified by <code>VkFilterCubicImageViewImageFormatPropertiesEXT</code>::<code>filterCubicMinmax</code> returned by <code>vkGetPhysicalDeviceImageFormatProperties2</code>"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)+(VK_NV_corner_sampled_image)": [
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-flags-02696",
|
|
"text": " Any <a href=\"#VkImage\">VkImage</a> created with a <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a>::<code>flags</code> containing <code>VK_IMAGE_CREATE_CORNER_SAMPLED_BIT_NV</code> sampled as a result of this command <strong class=\"purple\">must</strong> only be sampled using a <a href=\"#VkSamplerAddressMode\">VkSamplerAddressMode</a> of <code>VK_SAMPLER_ADDRESS_MODE_CLAMP_TO_EDGE</code>"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)+!(VK_VERSION_1_3,VK_KHR_maintenance4)": [
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-None-02698",
|
|
"text": " For each push constant that is statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command, a push constant value <strong class=\"purple\">must</strong> have been set for the same pipeline bind point, with a <code>VkPipelineLayout</code> that is compatible for push constants, with the <code>VkPipelineLayout</code> used to create the current <code>VkPipeline</code>, as described in <a href=\"#descriptorsets-compatibility\">Pipeline Layout Compatibility</a>"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)+(VK_VERSION_1_3,VK_KHR_maintenance4)": [
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-maintenance4-06425",
|
|
"text": " If the <a href=\"#features-maintenance4\"><code>maintenance4</code></a> feature is not enabled, then for each push constant that is statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command, a push constant value <strong class=\"purple\">must</strong> have been set for the same pipeline bind point, with a <code>VkPipelineLayout</code> that is compatible for push constants, with the <code>VkPipelineLayout</code> used to create the current <code>VkPipeline</code>, as described in <a href=\"#descriptorsets-compatibility\">Pipeline Layout Compatibility</a>"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)+!(VK_EXT_pipeline_robustness)": [
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-None-02705",
|
|
"text": " If the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, and if the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a uniform buffer, it <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-None-02706",
|
|
"text": " If the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, and if the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a storage buffer, it <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)+(VK_EXT_pipeline_robustness)": [
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-uniformBuffers-06935",
|
|
"text": " If any stage of the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a uniform buffer, and that stage was created without enabling either <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_EXT</code> or <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXT</code> for <code>uniformBuffers</code>, and the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, that stage <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-storageBuffers-06936",
|
|
"text": " If any stage of the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a storage buffer, and that stage was created without enabling either <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_EXT</code> or <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXT</code> for <code>storageBuffers</code>, and the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, that stage <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)+(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-commandBuffer-02707",
|
|
"text": " If <code>commandBuffer</code> is an unprotected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, any resource accessed by the <a href=\"#VkPipeline\">VkPipeline</a> object bound to the pipeline bind point used by this command <strong class=\"purple\">must</strong> not be a protected resource"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)+(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-None-06550",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> or <code>VkImageView</code> object that enables <a href=\"#samplers-YCbCr-conversion\">sampler {YCbCr} conversion</a>, that object <strong class=\"purple\">must</strong> only be used with <code>OpImageSample*</code> or <code>OpImageSparseSample*</code> instructions"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-ConstOffset-06551",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> or <code>VkImageView</code> object that enables <a href=\"#samplers-YCbCr-conversion\">sampler {YCbCr} conversion</a>, that object <strong class=\"purple\">must</strong> not use the <code>ConstOffset</code> and <code>Offset</code> operands"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)+(VK_EXT_shader_image_atomic_int64)": [
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-SampledType-04470",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a 64-bit component width is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 64"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-SampledType-04471",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a component width less than 64-bit is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 32"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-SampledType-04472",
|
|
"text": " If a <a href=\"#VkBufferView\">VkBufferView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a 64-bit component width is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 64"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-SampledType-04473",
|
|
"text": " If a <a href=\"#VkBufferView\">VkBufferView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a component width less than 64-bit is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 32"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-sparseImageInt64Atomics-04474",
|
|
"text": " If the <a href=\"#features-sparseImageInt64Atomics\"><code>sparseImageInt64Atomics</code></a> feature is not enabled, <a href=\"#VkImage\">VkImage</a> objects created with the <code>VK_IMAGE_CREATE_SPARSE_RESIDENCY_BIT</code> flag <strong class=\"purple\">must</strong> not be accessed by atomic instructions through an <code>OpTypeImage</code> with a <code>SampledType</code> with a <code>Width</code> of 64 by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-sparseImageInt64Atomics-04475",
|
|
"text": " If the <a href=\"#features-sparseImageInt64Atomics\"><code>sparseImageInt64Atomics</code></a> feature is not enabled, <a href=\"#VkBuffer\">VkBuffer</a> objects created with the <code>VK_BUFFER_CREATE_SPARSE_RESIDENCY_BIT</code> flag <strong class=\"purple\">must</strong> not be accessed by atomic instructions through an <code>OpTypeImage</code> with a <code>SampledType</code> with a <code>Width</code> of 64 by this command"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)+(VK_QCOM_image_processing)": [
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-OpImageWeightedSampleQCOM-06971",
|
|
"text": " If <code>OpImageWeightedSampleQCOM</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_WEIGHT_SAMPLED_IMAGE_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-OpImageWeightedSampleQCOM-06972",
|
|
"text": " If <code>OpImageWeightedSampleQCOM</code> uses a <a href=\"#VkImageView\">VkImageView</a> as a sample weight image as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_WEIGHT_IMAGE_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-OpImageBoxFilterQCOM-06973",
|
|
"text": " If <code>OpImageBoxFilterQCOM</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_BOX_FILTER_SAMPLED_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-OpImageBlockMatchSSDQCOM-06974",
|
|
"text": " If <code>OpImageBlockMatchSSDQCOM</code> is used to read from an <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-OpImageBlockMatchSADQCOM-06975",
|
|
"text": " If <code>OpImageBlockMatchSADQCOM</code> is used to read from an <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-OpImageBlockMatchSADQCOM-06976",
|
|
"text": " If <code>OpImageBlockMatchSADQCOM</code> or OpImageBlockMatchSSDQCOM is used to read from a reference image as result of this command, then the specified reference coordinates <strong class=\"purple\">must</strong> not fail <a href=\"#textures-integer-coordinate-validation\">integer texel coordinate validation</a>."
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-OpImageWeightedSampleQCOM-06977",
|
|
"text": " If <code>OpImageWeightedSampleQCOM</code>, <code>OpImageBoxFilterQCOM</code>, <code>OpImageBlockMatchSSDQCOM</code>, or <code>OpImageBlockMatchSADQCOM</code> uses a <a href=\"#VkSampler\">VkSampler</a> as a result of this command, then the sampler <strong class=\"purple\">must</strong> have been created with <code>VK_SAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-OpImageWeightedSampleQCOM-06978",
|
|
"text": " If any command other than <code>OpImageWeightedSampleQCOM</code>, <code>OpImageBoxFilterQCOM</code>, <code>OpImageBlockMatchSSDQCOM</code>, or <code>OpImageBlockMatchSADQCOM</code> uses a <a href=\"#VkSampler\">VkSampler</a> as a result of this command, then the sampler <strong class=\"purple\">must</strong> not have been created with <code>VK_SAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM</code>."
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)+(VK_NV_ray_tracing_motion_blur)": [
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirectKHR-rayTracingMotionBlurPipelineTraceRaysIndirect-04951",
|
|
"text": " If the bound ray tracing pipeline was created with <code>VK_PIPELINE_CREATE_RAY_TRACING_ALLOW_MOTION_BIT_NV</code> <code>VkPhysicalDeviceRayTracingMotionBlurFeaturesNV</code>::<code>rayTracingMotionBlurPipelineTraceRaysIndirect</code> feature <strong class=\"purple\">must</strong> be enabled"
|
|
}
|
|
]
|
|
},
|
|
"VkTraceRaysIndirectCommandKHR": {
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)": [
|
|
{
|
|
"vuid": "VUID-VkTraceRaysIndirectCommandKHR-width-03638",
|
|
"text": " <code>width</code> <strong class=\"purple\">must</strong> be less than or equal to <span class=\"eq\"><code>VkPhysicalDeviceLimits</code>::<code>maxComputeWorkGroupCount</code>[0] {times} <code>VkPhysicalDeviceLimits</code>::<code>maxComputeWorkGroupSize</code>[0]</span>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkTraceRaysIndirectCommandKHR-height-03639",
|
|
"text": " <code>height</code> <strong class=\"purple\">must</strong> be less than or equal to <span class=\"eq\"><code>VkPhysicalDeviceLimits</code>::<code>maxComputeWorkGroupCount</code>[1] {times} <code>VkPhysicalDeviceLimits</code>::<code>maxComputeWorkGroupSize</code>[1]</span>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkTraceRaysIndirectCommandKHR-depth-03640",
|
|
"text": " <code>depth</code> <strong class=\"purple\">must</strong> be less than or equal to <span class=\"eq\"><code>VkPhysicalDeviceLimits</code>::<code>maxComputeWorkGroupCount</code>[2] {times} <code>VkPhysicalDeviceLimits</code>::<code>maxComputeWorkGroupSize</code>[2]</span>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkTraceRaysIndirectCommandKHR-width-03641",
|
|
"text": " <span class=\"eq\"><code>width</code> {times} <code>height</code> {times} <code>depth</code></span> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceRayTracingPipelinePropertiesKHR</code>::<code>maxRayDispatchInvocationCount</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdTraceRaysIndirect2KHR": {
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_maintenance1)": [
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirect2KHR-magFilter-04553",
|
|
"text": " If a <a href=\"#VkSampler\">VkSampler</a> created with <code>magFilter</code> or <code>minFilter</code> equal to <code>VK_FILTER_LINEAR</code> and <code>compareEnable</code> equal to <code>VK_FALSE</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirect2KHR-mipmapMode-04770",
|
|
"text": " If a <a href=\"#VkSampler\">VkSampler</a> created with <code>mipmapMode</code> equal to <code>VK_SAMPLER_MIPMAP_MODE_LINEAR</code> and <code>compareEnable</code> equal to <code>VK_FALSE</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirect2KHR-None-02691",
|
|
"text": " If a <code>VkImageView</code> is accessed using atomic operations as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_STORAGE_IMAGE_ATOMIC_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirect2KHR-None-02697",
|
|
"text": " For each set <em>n</em> that is statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command, a descriptor set <strong class=\"purple\">must</strong> have been bound to <em>n</em> at the same pipeline bind point, with a <code>VkPipelineLayout</code> that is compatible for set <em>n</em>, with the <code>VkPipelineLayout</code> used to create the current <code>VkPipeline</code>, as described in <a href=\"#descriptorsets-compatibility\">Pipeline Layout Compatibility</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirect2KHR-None-02699",
|
|
"text": " Descriptors in each bound descriptor set, specified via <code>vkCmdBindDescriptorSets</code>, <strong class=\"purple\">must</strong> be valid if they are statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirect2KHR-None-02700",
|
|
"text": " A valid pipeline <strong class=\"purple\">must</strong> be bound to the pipeline bind point used by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirect2KHR-commandBuffer-02701",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command requires any dynamic state, that state <strong class=\"purple\">must</strong> have been set or inherited (if the <code><a href=\"#VK_NV_inherited_viewport_scissor\">VK_NV_inherited_viewport_scissor</a></code> extension is enabled) for <code>commandBuffer</code>, and done so after any previously bound pipeline with the corresponding state not specified as dynamic"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirect2KHR-None-02859",
|
|
"text": " There <strong class=\"purple\">must</strong> not have been any calls to dynamic state setting commands for any state not specified as dynamic in the <code>VkPipeline</code> object bound to the pipeline bind point used by this command, since that pipeline was bound"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirect2KHR-None-02702",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> object that uses unnormalized coordinates, that sampler <strong class=\"purple\">must</strong> not be used to sample from any <code>VkImage</code> with a <code>VkImageView</code> of the type <code>VK_IMAGE_VIEW_TYPE_3D</code>, <code>VK_IMAGE_VIEW_TYPE_CUBE</code>, <code>VK_IMAGE_VIEW_TYPE_1D_ARRAY</code>, <code>VK_IMAGE_VIEW_TYPE_2D_ARRAY</code> or <code>VK_IMAGE_VIEW_TYPE_CUBE_ARRAY</code>, in any shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirect2KHR-None-02703",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> object that uses unnormalized coordinates, that sampler <strong class=\"purple\">must</strong> not be used with any of the SPIR-V <code>OpImageSample*</code> or <code>OpImageSparseSample*</code> instructions with <code>ImplicitLod</code>, <code>Dref</code> or <code>Proj</code> in their name, in any shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirect2KHR-None-02704",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> object that uses unnormalized coordinates, that sampler <strong class=\"purple\">must</strong> not be used with any of the SPIR-V <code>OpImageSample*</code> or <code>OpImageSparseSample*</code> instructions that includes a LOD bias or any offset values, in any shader stage"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirect2KHR-None-04115",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> is accessed using <code>OpImageWrite</code> as a result of this command, then the <code>Type</code> of the <code>Texel</code> operand of that instruction <strong class=\"purple\">must</strong> have at least as many components as the image view’s format"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirect2KHR-OpImageWrite-04469",
|
|
"text": " If a <a href=\"#VkBufferView\">VkBufferView</a> is accessed using <code>OpImageWrite</code> as a result of this command, then the <code>Type</code> of the <code>Texel</code> operand of that instruction <strong class=\"purple\">must</strong> have at least as many components as the buffer view’s format"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirect2KHR-None-03429",
|
|
"text": " Any shader group handle referenced by this call <strong class=\"purple\">must</strong> have been queried from the currently bound ray tracing pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirect2KHR-maxPipelineRayRecursionDepth-03679",
|
|
"text": " This command <strong class=\"purple\">must</strong> not cause a shader call instruction to be executed from a shader invocation with a <a href=\"#ray-tracing-recursion-depth\">recursion depth</a> greater than the value of <code>maxPipelineRayRecursionDepth</code> used to create the bound ray tracing pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirect2KHR-commandBuffer-03635",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> not be a protected command buffer"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirect2KHR-indirectDeviceAddress-03632",
|
|
"text": " If the buffer from which <code>indirectDeviceAddress</code> was queried is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirect2KHR-indirectDeviceAddress-03633",
|
|
"text": " The buffer from which <code>indirectDeviceAddress</code> was queried <strong class=\"purple\">must</strong> have been created with the <code>VK_BUFFER_USAGE_INDIRECT_BUFFER_BIT</code> bit set"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirect2KHR-indirectDeviceAddress-03634",
|
|
"text": " <code>indirectDeviceAddress</code> <strong class=\"purple\">must</strong> be a multiple of <code>4</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirect2KHR-indirectDeviceAddress-03636",
|
|
"text": " All device addresses between <code>indirectDeviceAddress</code> and <span class=\"eq\"><code>indirectDeviceAddress</code> + <code>sizeof</code>(sname:VkTraceRaysIndirectCommand2KHR) - 1</span> <strong class=\"purple\">must</strong> be in the buffer device address range of the same buffer"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirect2KHR-rayTracingPipelineTraceRaysIndirect2-03637",
|
|
"text": " The <a href=\"#features-rayTracingPipelineTraceRaysIndirect2\">pname:rayTracingPipelineTraceRaysIndirect2</a> feature <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirect2KHR-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirect2KHR-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirect2KHR-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support compute operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirect2KHR-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirect2KHR-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_maintenance1)+!(VK_VERSION_1_3,VK_KHR_format_feature_flags2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirect2KHR-aspectMask-06478",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> is sampled with <a href=\"#textures-depth-compare-operation\">depth comparison</a>, the image view <strong class=\"purple\">must</strong> have been created with an <code>aspectMask</code> that contains <code>VK_IMAGE_ASPECT_DEPTH_BIT</code>."
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_maintenance1)+(VK_VERSION_1_3,VK_KHR_format_feature_flags2)": [
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirect2KHR-None-06479",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> is sampled with <a href=\"#textures-depth-compare-operation\">depth comparison</a>, the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_SAMPLED_IMAGE_DEPTH_COMPARISON_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirect2KHR-OpTypeImage-06423",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> or <a href=\"#VkBufferView\">VkBufferView</a> being written as a storage image or storage texel buffer where the image format field of the <code>OpTypeImage</code> is <code>Unknown</code> then the view’s format feature <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_STORAGE_WRITE_WITHOUT_FORMAT_BIT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirect2KHR-OpTypeImage-06424",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> or <a href=\"#VkBufferView\">VkBufferView</a> being read as a storage image or storage texel buffer where the image format field of the <code>OpTypeImage</code> is <code>Unknown</code> then the view’s format feature <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_STORAGE_READ_WITHOUT_FORMAT_BIT</code>"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_maintenance1)+(VK_IMG_filter_cubic,VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirect2KHR-None-02692",
|
|
"text": " If a <code>VkImageView</code> is sampled with <code>VK_FILTER_CUBIC_EXT</code> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_CUBIC_BIT_EXT</code>"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_maintenance1)+(VK_IMG_filter_cubic,VK_EXT_filter_cubic)+!(VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirect2KHR-None-02693",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> being sampled with <code>VK_FILTER_CUBIC_EXT</code> as a result of this command <strong class=\"purple\">must</strong> not have a <a href=\"#VkImageViewType\">VkImageViewType</a> of <code>VK_IMAGE_VIEW_TYPE_3D</code>, <code>VK_IMAGE_VIEW_TYPE_CUBE</code>, or <code>VK_IMAGE_VIEW_TYPE_CUBE_ARRAY</code>"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_maintenance1)+(VK_IMG_filter_cubic,VK_EXT_filter_cubic)+(VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirect2KHR-filterCubic-02694",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> being sampled with <code>VK_FILTER_CUBIC_EXT</code> as a result of this command <strong class=\"purple\">must</strong> have a <a href=\"#VkImageViewType\">VkImageViewType</a> and format that supports cubic filtering, as specified by <code>VkFilterCubicImageViewImageFormatPropertiesEXT</code>::<code>filterCubic</code> returned by <code>vkGetPhysicalDeviceImageFormatProperties2</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirect2KHR-filterCubicMinmax-02695",
|
|
"text": " Any <a href=\"#VkImageView\">VkImageView</a> being sampled with <code>VK_FILTER_CUBIC_EXT</code> with a reduction mode of either <code>VK_SAMPLER_REDUCTION_MODE_MIN</code> or <code>VK_SAMPLER_REDUCTION_MODE_MAX</code> as a result of this command <strong class=\"purple\">must</strong> have a <a href=\"#VkImageViewType\">VkImageViewType</a> and format that supports cubic filtering together with minmax filtering, as specified by <code>VkFilterCubicImageViewImageFormatPropertiesEXT</code>::<code>filterCubicMinmax</code> returned by <code>vkGetPhysicalDeviceImageFormatProperties2</code>"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_maintenance1)+(VK_NV_corner_sampled_image)": [
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirect2KHR-flags-02696",
|
|
"text": " Any <a href=\"#VkImage\">VkImage</a> created with a <a href=\"#VkImageCreateInfo\">VkImageCreateInfo</a>::<code>flags</code> containing <code>VK_IMAGE_CREATE_CORNER_SAMPLED_BIT_NV</code> sampled as a result of this command <strong class=\"purple\">must</strong> only be sampled using a <a href=\"#VkSamplerAddressMode\">VkSamplerAddressMode</a> of <code>VK_SAMPLER_ADDRESS_MODE_CLAMP_TO_EDGE</code>"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_maintenance1)+!(VK_VERSION_1_3,VK_KHR_maintenance4)": [
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirect2KHR-None-02698",
|
|
"text": " For each push constant that is statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command, a push constant value <strong class=\"purple\">must</strong> have been set for the same pipeline bind point, with a <code>VkPipelineLayout</code> that is compatible for push constants, with the <code>VkPipelineLayout</code> used to create the current <code>VkPipeline</code>, as described in <a href=\"#descriptorsets-compatibility\">Pipeline Layout Compatibility</a>"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_maintenance1)+(VK_VERSION_1_3,VK_KHR_maintenance4)": [
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirect2KHR-maintenance4-06425",
|
|
"text": " If the <a href=\"#features-maintenance4\"><code>maintenance4</code></a> feature is not enabled, then for each push constant that is statically used by the <code>VkPipeline</code> bound to the pipeline bind point used by this command, a push constant value <strong class=\"purple\">must</strong> have been set for the same pipeline bind point, with a <code>VkPipelineLayout</code> that is compatible for push constants, with the <code>VkPipelineLayout</code> used to create the current <code>VkPipeline</code>, as described in <a href=\"#descriptorsets-compatibility\">Pipeline Layout Compatibility</a>"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_maintenance1)+!(VK_EXT_pipeline_robustness)": [
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirect2KHR-None-02705",
|
|
"text": " If the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, and if the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a uniform buffer, it <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirect2KHR-None-02706",
|
|
"text": " If the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, and if the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a storage buffer, it <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_maintenance1)+(VK_EXT_pipeline_robustness)": [
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirect2KHR-uniformBuffers-06935",
|
|
"text": " If any stage of the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a uniform buffer, and that stage was created without enabling either <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_EXT</code> or <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXT</code> for <code>uniformBuffers</code>, and the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, that stage <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirect2KHR-storageBuffers-06936",
|
|
"text": " If any stage of the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a storage buffer, and that stage was created without enabling either <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_EXT</code> or <code>VK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXT</code> for <code>storageBuffers</code>, and the <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> feature is not enabled, that stage <strong class=\"purple\">must</strong> not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_maintenance1)+(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirect2KHR-commandBuffer-02707",
|
|
"text": " If <code>commandBuffer</code> is an unprotected command buffer and <a href=\"#limits-protectedNoFault\"><code>protectedNoFault</code></a> is not supported, any resource accessed by the <a href=\"#VkPipeline\">VkPipeline</a> object bound to the pipeline bind point used by this command <strong class=\"purple\">must</strong> not be a protected resource"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_maintenance1)+(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirect2KHR-None-06550",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> or <code>VkImageView</code> object that enables <a href=\"#samplers-YCbCr-conversion\">sampler {YCbCr} conversion</a>, that object <strong class=\"purple\">must</strong> only be used with <code>OpImageSample*</code> or <code>OpImageSparseSample*</code> instructions"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirect2KHR-ConstOffset-06551",
|
|
"text": " If the <code>VkPipeline</code> object bound to the pipeline bind point used by this command accesses a <code>VkSampler</code> or <code>VkImageView</code> object that enables <a href=\"#samplers-YCbCr-conversion\">sampler {YCbCr} conversion</a>, that object <strong class=\"purple\">must</strong> not use the <code>ConstOffset</code> and <code>Offset</code> operands"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_maintenance1)+(VK_EXT_shader_image_atomic_int64)": [
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirect2KHR-SampledType-04470",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a 64-bit component width is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 64"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirect2KHR-SampledType-04471",
|
|
"text": " If a <a href=\"#VkImageView\">VkImageView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a component width less than 64-bit is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 32"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirect2KHR-SampledType-04472",
|
|
"text": " If a <a href=\"#VkBufferView\">VkBufferView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a 64-bit component width is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 64"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirect2KHR-SampledType-04473",
|
|
"text": " If a <a href=\"#VkBufferView\">VkBufferView</a> with a <a href=\"#VkFormat\">VkFormat</a> that has a component width less than 64-bit is accessed as a result of this command, the <code>SampledType</code> of the <code>OpTypeImage</code> operand of that instruction <strong class=\"purple\">must</strong> have a <code>Width</code> of 32"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirect2KHR-sparseImageInt64Atomics-04474",
|
|
"text": " If the <a href=\"#features-sparseImageInt64Atomics\"><code>sparseImageInt64Atomics</code></a> feature is not enabled, <a href=\"#VkImage\">VkImage</a> objects created with the <code>VK_IMAGE_CREATE_SPARSE_RESIDENCY_BIT</code> flag <strong class=\"purple\">must</strong> not be accessed by atomic instructions through an <code>OpTypeImage</code> with a <code>SampledType</code> with a <code>Width</code> of 64 by this command"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirect2KHR-sparseImageInt64Atomics-04475",
|
|
"text": " If the <a href=\"#features-sparseImageInt64Atomics\"><code>sparseImageInt64Atomics</code></a> feature is not enabled, <a href=\"#VkBuffer\">VkBuffer</a> objects created with the <code>VK_BUFFER_CREATE_SPARSE_RESIDENCY_BIT</code> flag <strong class=\"purple\">must</strong> not be accessed by atomic instructions through an <code>OpTypeImage</code> with a <code>SampledType</code> with a <code>Width</code> of 64 by this command"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_maintenance1)+(VK_QCOM_image_processing)": [
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirect2KHR-OpImageWeightedSampleQCOM-06971",
|
|
"text": " If <code>OpImageWeightedSampleQCOM</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_WEIGHT_SAMPLED_IMAGE_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirect2KHR-OpImageWeightedSampleQCOM-06972",
|
|
"text": " If <code>OpImageWeightedSampleQCOM</code> uses a <a href=\"#VkImageView\">VkImageView</a> as a sample weight image as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_WEIGHT_IMAGE_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirect2KHR-OpImageBoxFilterQCOM-06973",
|
|
"text": " If <code>OpImageBoxFilterQCOM</code> is used to sample a <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_BOX_FILTER_SAMPLED_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirect2KHR-OpImageBlockMatchSSDQCOM-06974",
|
|
"text": " If <code>OpImageBlockMatchSSDQCOM</code> is used to read from an <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirect2KHR-OpImageBlockMatchSADQCOM-06975",
|
|
"text": " If <code>OpImageBlockMatchSADQCOM</code> is used to read from an <a href=\"#VkImageView\">VkImageView</a> as a result of this command, then the image view’s <a href=\"#resources-image-view-format-features\">format features</a> <strong class=\"purple\">must</strong> contain <code>VK_FORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirect2KHR-OpImageBlockMatchSADQCOM-06976",
|
|
"text": " If <code>OpImageBlockMatchSADQCOM</code> or OpImageBlockMatchSSDQCOM is used to read from a reference image as result of this command, then the specified reference coordinates <strong class=\"purple\">must</strong> not fail <a href=\"#textures-integer-coordinate-validation\">integer texel coordinate validation</a>."
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirect2KHR-OpImageWeightedSampleQCOM-06977",
|
|
"text": " If <code>OpImageWeightedSampleQCOM</code>, <code>OpImageBoxFilterQCOM</code>, <code>OpImageBlockMatchSSDQCOM</code>, or <code>OpImageBlockMatchSADQCOM</code> uses a <a href=\"#VkSampler\">VkSampler</a> as a result of this command, then the sampler <strong class=\"purple\">must</strong> have been created with <code>VK_SAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirect2KHR-OpImageWeightedSampleQCOM-06978",
|
|
"text": " If any command other than <code>OpImageWeightedSampleQCOM</code>, <code>OpImageBoxFilterQCOM</code>, <code>OpImageBlockMatchSSDQCOM</code>, or <code>OpImageBlockMatchSADQCOM</code> uses a <a href=\"#VkSampler\">VkSampler</a> as a result of this command, then the sampler <strong class=\"purple\">must</strong> not have been created with <code>VK_SAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM</code>."
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_maintenance1)+(VK_NV_ray_tracing_motion_blur)": [
|
|
{
|
|
"vuid": "VUID-vkCmdTraceRaysIndirect2KHR-rayTracingMotionBlurPipelineTraceRaysIndirect-04951",
|
|
"text": " If the bound ray tracing pipeline was created with <code>VK_PIPELINE_CREATE_RAY_TRACING_ALLOW_MOTION_BIT_NV</code> <code>VkPhysicalDeviceRayTracingMotionBlurFeaturesNV</code>::<code>rayTracingMotionBlurPipelineTraceRaysIndirect</code> feature <strong class=\"purple\">must</strong> be enabled"
|
|
}
|
|
]
|
|
},
|
|
"VkTraceRaysIndirectCommand2KHR": {
|
|
"(VK_NV_ray_tracing,VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_pipeline)+(VK_KHR_ray_tracing_maintenance1)": [
|
|
{
|
|
"vuid": "VUID-VkTraceRaysIndirectCommand2KHR-pRayGenShaderBindingTable-03680",
|
|
"text": " If the buffer from which pname:raygenShaderRecordAddress was queried is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkTraceRaysIndirectCommand2KHR-pRayGenShaderBindingTable-03681",
|
|
"text": " The buffer from which the pname:raygenShaderRecordAddress is queried <strong class=\"purple\">must</strong> have been created with the <code>VK_BUFFER_USAGE_SHADER_BINDING_TABLE_BIT_KHR</code> usage flag"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkTraceRaysIndirectCommand2KHR-pRayGenShaderBindingTable-03682",
|
|
"text": " pname:raygenShaderRecordAddress <strong class=\"purple\">must</strong> be a multiple of <code>VkPhysicalDeviceRayTracingPipelinePropertiesKHR</code>::<code>shaderGroupBaseAlignment</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkTraceRaysIndirectCommand2KHR-pMissShaderBindingTable-03683",
|
|
"text": " If the buffer from which pname:missShaderBindingTableAddress was queried is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkTraceRaysIndirectCommand2KHR-pMissShaderBindingTable-03684",
|
|
"text": " The buffer from which the pname:missShaderBindingTableAddress is queried <strong class=\"purple\">must</strong> have been created with the <code>VK_BUFFER_USAGE_SHADER_BINDING_TABLE_BIT_KHR</code> usage flag"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkTraceRaysIndirectCommand2KHR-pMissShaderBindingTable-03685",
|
|
"text": " pname:missShaderBindingTableAddress <strong class=\"purple\">must</strong> be a multiple of <code>VkPhysicalDeviceRayTracingPipelinePropertiesKHR</code>::<code>shaderGroupBaseAlignment</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkTraceRaysIndirectCommand2KHR-stride-03686",
|
|
"text": " pname:missShaderBindingTableStride <strong class=\"purple\">must</strong> be a multiple of <code>VkPhysicalDeviceRayTracingPipelinePropertiesKHR</code>::<code>shaderGroupHandleAlignment</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkTraceRaysIndirectCommand2KHR-stride-04029",
|
|
"text": " pname:missShaderBindingTableStride <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceRayTracingPipelinePropertiesKHR</code>::<code>maxShaderGroupStride</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkTraceRaysIndirectCommand2KHR-pHitShaderBindingTable-03687",
|
|
"text": " If the buffer from which pname:hitShaderBindingTableAddress was queried is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkTraceRaysIndirectCommand2KHR-pHitShaderBindingTable-03688",
|
|
"text": " The buffer from which the pname:hitShaderBindingTableAddress is queried <strong class=\"purple\">must</strong> have been created with the <code>VK_BUFFER_USAGE_SHADER_BINDING_TABLE_BIT_KHR</code> usage flag"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkTraceRaysIndirectCommand2KHR-pHitShaderBindingTable-03689",
|
|
"text": " pname:hitShaderBindingTableAddress <strong class=\"purple\">must</strong> be a multiple of <code>VkPhysicalDeviceRayTracingPipelinePropertiesKHR</code>::<code>shaderGroupBaseAlignment</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkTraceRaysIndirectCommand2KHR-stride-03690",
|
|
"text": " pname:hitShaderBindingTableStride <strong class=\"purple\">must</strong> be a multiple of <code>VkPhysicalDeviceRayTracingPipelinePropertiesKHR</code>::<code>shaderGroupHandleAlignment</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkTraceRaysIndirectCommand2KHR-stride-04035",
|
|
"text": " pname:hitShaderBindingTableStride <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceRayTracingPipelinePropertiesKHR</code>::<code>maxShaderGroupStride</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkTraceRaysIndirectCommand2KHR-pCallableShaderBindingTable-03691",
|
|
"text": " If the buffer from which pname:callableShaderBindingTableAddress was queried is non-sparse then it <strong class=\"purple\">must</strong> be bound completely and contiguously to a single <code>VkDeviceMemory</code> object"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkTraceRaysIndirectCommand2KHR-pCallableShaderBindingTable-03692",
|
|
"text": " The buffer from which the pname:callableShaderBindingTableAddress is queried <strong class=\"purple\">must</strong> have been created with the <code>VK_BUFFER_USAGE_SHADER_BINDING_TABLE_BIT_KHR</code> usage flag"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkTraceRaysIndirectCommand2KHR-pCallableShaderBindingTable-03693",
|
|
"text": " pname:callableShaderBindingTableAddress <strong class=\"purple\">must</strong> be a multiple of <code>VkPhysicalDeviceRayTracingPipelinePropertiesKHR</code>::<code>shaderGroupBaseAlignment</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkTraceRaysIndirectCommand2KHR-stride-03694",
|
|
"text": " pname:callableShaderBindingTableStride <strong class=\"purple\">must</strong> be a multiple of <code>VkPhysicalDeviceRayTracingPipelinePropertiesKHR</code>::<code>shaderGroupHandleAlignment</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkTraceRaysIndirectCommand2KHR-stride-04041",
|
|
"text": " pname:callableShaderBindingTableStride <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceRayTracingPipelinePropertiesKHR</code>::<code>maxShaderGroupStride</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkTraceRaysIndirectCommand2KHR-flags-03696",
|
|
"text": " If the currently bound ray tracing pipeline was created with <code>flags</code> that included <code>VK_PIPELINE_CREATE_RAY_TRACING_NO_NULL_CLOSEST_HIT_SHADERS_BIT_KHR</code>, pname:hitShaderBindingTableAddress <strong class=\"purple\">must</strong> not be zero"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkTraceRaysIndirectCommand2KHR-flags-03697",
|
|
"text": " If the currently bound ray tracing pipeline was created with <code>flags</code> that included <code>VK_PIPELINE_CREATE_RAY_TRACING_NO_NULL_INTERSECTION_SHADERS_BIT_KHR</code>, pname:hitShaderBindingTableAddress <strong class=\"purple\">must</strong> not be zero"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkTraceRaysIndirectCommand2KHR-flags-03511",
|
|
"text": " If the currently bound ray tracing pipeline was created with <code>flags</code> that included <code>VK_PIPELINE_CREATE_RAY_TRACING_NO_NULL_MISS_SHADERS_BIT_KHR</code>, the shader group handle identified by pname:missShaderBindingTableAddress <strong class=\"purple\">must</strong> not be set to zero"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkTraceRaysIndirectCommand2KHR-flags-03512",
|
|
"text": " If the currently bound ray tracing pipeline was created with <code>flags</code> that included <code>VK_PIPELINE_CREATE_RAY_TRACING_NO_NULL_ANY_HIT_SHADERS_BIT_KHR</code>, entries in the table identified by pname:hitShaderBindingTableAddress accessed as a result of this command in order to execute an any-hit shader <strong class=\"purple\">must</strong> not be set to zero"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkTraceRaysIndirectCommand2KHR-flags-03513",
|
|
"text": " If the currently bound ray tracing pipeline was created with <code>flags</code> that included <code>VK_PIPELINE_CREATE_RAY_TRACING_NO_NULL_CLOSEST_HIT_SHADERS_BIT_KHR</code>, entries in the table identified by pname:hitShaderBindingTableAddress accessed as a result of this command in order to execute a closest hit shader <strong class=\"purple\">must</strong> not be set to zero"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkTraceRaysIndirectCommand2KHR-flags-03514",
|
|
"text": " If the currently bound ray tracing pipeline was created with <code>flags</code> that included <code>VK_PIPELINE_CREATE_RAY_TRACING_NO_NULL_INTERSECTION_SHADERS_BIT_KHR</code>, entries in the table identified by pname:hitShaderBindingTableAddress accessed as a result of this command in order to execute an intersection shader <strong class=\"purple\">must</strong> not be set to zero"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkTraceRaysIndirectCommand2KHR-pHitShaderBindingTable-04735",
|
|
"text": " Any non-zero hit shader group entries in the table identified by pname:hitShaderBindingTableAddress accessed by this call from a geometry with a <code>geometryType</code> of <code>VK_GEOMETRY_TYPE_TRIANGLES_KHR</code> <strong class=\"purple\">must</strong> have been created with <code>VK_RAY_TRACING_SHADER_GROUP_TYPE_TRIANGLES_HIT_GROUP_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkTraceRaysIndirectCommand2KHR-pHitShaderBindingTable-04736",
|
|
"text": " Any non-zero hit shader group entries in the table identified by pname:hitShaderBindingTableAddress accessed by this call from a geometry with a <code>geometryType</code> of <code>VK_GEOMETRY_TYPE_AABBS_KHR</code> <strong class=\"purple\">must</strong> have been created with <code>VK_RAY_TRACING_SHADER_GROUP_TYPE_PROCEDURAL_HIT_GROUP_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkTraceRaysIndirectCommand2KHR-width-03638",
|
|
"text": " <code>width</code> <strong class=\"purple\">must</strong> be less than or equal to <span class=\"eq\"><code>VkPhysicalDeviceLimits</code>::<code>maxComputeWorkGroupCount</code>[0] {times} <code>VkPhysicalDeviceLimits</code>::<code>maxComputeWorkGroupSize</code>[0]</span>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkTraceRaysIndirectCommand2KHR-height-03639",
|
|
"text": " <code>height</code> <strong class=\"purple\">must</strong> be less than or equal to <span class=\"eq\"><code>VkPhysicalDeviceLimits</code>::<code>maxComputeWorkGroupCount</code>[1] {times} <code>VkPhysicalDeviceLimits</code>::<code>maxComputeWorkGroupSize</code>[1]</span>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkTraceRaysIndirectCommand2KHR-depth-03640",
|
|
"text": " <code>depth</code> <strong class=\"purple\">must</strong> be less than or equal to <span class=\"eq\"><code>VkPhysicalDeviceLimits</code>::<code>maxComputeWorkGroupCount</code>[2] {times} <code>VkPhysicalDeviceLimits</code>::<code>maxComputeWorkGroupSize</code>[2]</span>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkTraceRaysIndirectCommand2KHR-width-03641",
|
|
"text": " <span class=\"eq\"><code>width</code> {times} <code>height</code> {times} <code>depth</code></span> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceRayTracingPipelinePropertiesKHR</code>::<code>maxRayDispatchInvocationCount</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkVideoQueueFamilyProperties2KHR": {
|
|
"(VK_KHR_video_queue)": [
|
|
{
|
|
"vuid": "VUID-VkVideoQueueFamilyProperties2KHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_VIDEO_QUEUE_FAMILY_PROPERTIES_2_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoQueueFamilyProperties2KHR-videoCodecOperations-parameter",
|
|
"text": " <code>videoCodecOperations</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkVideoCodecOperationFlagBitsKHR\">VkVideoCodecOperationFlagBitsKHR</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoQueueFamilyProperties2KHR-videoCodecOperations-requiredbitmask",
|
|
"text": " <code>videoCodecOperations</code> <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkVideoProfileKHR": {
|
|
"(VK_KHR_video_queue)": [
|
|
{
|
|
"vuid": "VUID-VkVideoProfileKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_VIDEO_PROFILE_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoProfileKHR-videoCodecOperation-parameter",
|
|
"text": " <code>videoCodecOperation</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkVideoCodecOperationFlagBitsKHR\">VkVideoCodecOperationFlagBitsKHR</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoProfileKHR-chromaSubsampling-parameter",
|
|
"text": " <code>chromaSubsampling</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkVideoChromaSubsamplingFlagBitsKHR\">VkVideoChromaSubsamplingFlagBitsKHR</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoProfileKHR-chromaSubsampling-requiredbitmask",
|
|
"text": " <code>chromaSubsampling</code> <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoProfileKHR-lumaBitDepth-parameter",
|
|
"text": " <code>lumaBitDepth</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkVideoComponentBitDepthFlagBitsKHR\">VkVideoComponentBitDepthFlagBitsKHR</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoProfileKHR-lumaBitDepth-requiredbitmask",
|
|
"text": " <code>lumaBitDepth</code> <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoProfileKHR-chromaBitDepth-parameter",
|
|
"text": " <code>chromaBitDepth</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkVideoComponentBitDepthFlagBitsKHR\">VkVideoComponentBitDepthFlagBitsKHR</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoProfileKHR-chromaBitDepth-requiredbitmask",
|
|
"text": " <code>chromaBitDepth</code> <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetPhysicalDeviceVideoCapabilitiesKHR": {
|
|
"(VK_KHR_video_queue)": [
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceVideoCapabilitiesKHR-physicalDevice-parameter",
|
|
"text": " <code>physicalDevice</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceVideoCapabilitiesKHR-pVideoProfile-parameter",
|
|
"text": " <code>pVideoProfile</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkVideoProfileKHR\">VkVideoProfileKHR</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceVideoCapabilitiesKHR-pCapabilities-parameter",
|
|
"text": " <code>pCapabilities</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkVideoCapabilitiesKHR\">VkVideoCapabilitiesKHR</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkVideoCapabilitiesKHR": {
|
|
"(VK_KHR_video_queue)": [
|
|
{
|
|
"vuid": "VUID-VkVideoCapabilitiesKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_VIDEO_CAPABILITIES_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoCapabilitiesKHR-pNext-pNext",
|
|
"text": " Each <code>pNext</code> member of any structure (including this one) in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be either <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkVideoDecodeCapabilitiesKHR\">VkVideoDecodeCapabilitiesKHR</a>, <a href=\"#VkVideoDecodeH264CapabilitiesEXT\">VkVideoDecodeH264CapabilitiesEXT</a>, <a href=\"#VkVideoDecodeH265CapabilitiesEXT\">VkVideoDecodeH265CapabilitiesEXT</a>, <a href=\"#VkVideoEncodeCapabilitiesKHR\">VkVideoEncodeCapabilitiesKHR</a>, <a href=\"#VkVideoEncodeH264CapabilitiesEXT\">VkVideoEncodeH264CapabilitiesEXT</a>, or <a href=\"#VkVideoEncodeH265CapabilitiesEXT\">VkVideoEncodeH265CapabilitiesEXT</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoCapabilitiesKHR-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
}
|
|
]
|
|
},
|
|
"vkGetPhysicalDeviceVideoFormatPropertiesKHR": {
|
|
"(VK_KHR_video_queue)": [
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceVideoFormatPropertiesKHR-pNext-06812",
|
|
"text": " The <code>pNext</code> chain of <code>pVideoFormatInfo</code> <strong class=\"purple\">must</strong> include a valid <a href=\"#VkVideoProfilesKHR\">VkVideoProfilesKHR</a> structure with <code>profileCount</code> greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceVideoFormatPropertiesKHR-physicalDevice-parameter",
|
|
"text": " <code>physicalDevice</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceVideoFormatPropertiesKHR-pVideoFormatInfo-parameter",
|
|
"text": " <code>pVideoFormatInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkPhysicalDeviceVideoFormatInfoKHR\">VkPhysicalDeviceVideoFormatInfoKHR</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceVideoFormatPropertiesKHR-pVideoFormatPropertyCount-parameter",
|
|
"text": " <code>pVideoFormatPropertyCount</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>uint32_t</code> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceVideoFormatPropertiesKHR-pVideoFormatProperties-parameter",
|
|
"text": " If the value referenced by <code>pVideoFormatPropertyCount</code> is not <code>0</code>, and <code>pVideoFormatProperties</code> is not <code>NULL</code>, <code>pVideoFormatProperties</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>pVideoFormatPropertyCount</code> <a href=\"#VkVideoFormatPropertiesKHR\">VkVideoFormatPropertiesKHR</a> structures"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceVideoFormatInfoKHR": {
|
|
"(VK_KHR_video_queue)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceVideoFormatInfoKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_VIDEO_FORMAT_INFO_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceVideoFormatInfoKHR-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkVideoProfilesKHR\">VkVideoProfilesKHR</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceVideoFormatInfoKHR-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceVideoFormatInfoKHR-imageUsage-parameter",
|
|
"text": " <code>imageUsage</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkImageUsageFlagBits\">VkImageUsageFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceVideoFormatInfoKHR-imageUsage-requiredbitmask",
|
|
"text": " <code>imageUsage</code> <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkVideoProfilesKHR": {
|
|
"(VK_KHR_video_queue)": [
|
|
{
|
|
"vuid": "VUID-VkVideoProfilesKHR-pProfiles-06813",
|
|
"text": " If the <code>pProfiles</code> list contains more than one <a href=\"#VkVideoProfileKHR\">VkVideoProfileKHR</a> entry, then it <strong class=\"purple\">must</strong> not contain more than one entry whose <code>videoCodecOperation</code> member specifies a decode operation"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoProfilesKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_VIDEO_PROFILES_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoProfilesKHR-pProfiles-parameter",
|
|
"text": " If <code>profileCount</code> is not <code>0</code>, <code>pProfiles</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>profileCount</code> valid <a href=\"#VkVideoProfileKHR\">VkVideoProfileKHR</a> structures"
|
|
}
|
|
]
|
|
},
|
|
"VkVideoFormatPropertiesKHR": {
|
|
"(VK_KHR_video_queue)": [
|
|
{
|
|
"vuid": "VUID-VkVideoFormatPropertiesKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_VIDEO_FORMAT_PROPERTIES_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoFormatPropertiesKHR-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCreateVideoSessionKHR": {
|
|
"(VK_KHR_video_queue)": [
|
|
{
|
|
"vuid": "VUID-vkCreateVideoSessionKHR-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateVideoSessionKHR-pCreateInfo-parameter",
|
|
"text": " <code>pCreateInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkVideoSessionCreateInfoKHR\">VkVideoSessionCreateInfoKHR</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateVideoSessionKHR-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateVideoSessionKHR-pVideoSession-parameter",
|
|
"text": " <code>pVideoSession</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkVideoSessionKHR\">VkVideoSessionKHR</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkVideoSessionCreateInfoKHR": {
|
|
"(VK_KHR_video_queue)": [
|
|
{
|
|
"vuid": "VUID-VkVideoSessionCreateInfoKHR-pVideoProfile-04845",
|
|
"text": " <code>pVideoProfile</code> <strong class=\"purple\">must</strong> be a pointer to a valid <a href=\"#VkVideoProfileKHR\">VkVideoProfileKHR</a> structure whose <code>pNext</code> chain <strong class=\"purple\">must</strong> include a valid codec-specific profile structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoSessionCreateInfoKHR-maxReferencePicturesSlotsCount-04846",
|
|
"text": " If <a href=\"#reference-picture\">Reference Pictures</a> are required for use with the created video session, the <code>maxReferencePicturesSlotsCount</code> <strong class=\"purple\">must</strong> be set to a value bigger than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoSessionCreateInfoKHR-maxReferencePicturesSlotsCount-04847",
|
|
"text": " <code>maxReferencePicturesSlotsCount</code> <strong class=\"purple\">cannot</strong> exceed the implementation reported <a href=\"#VkVideoCapabilitiesKHR\">VkVideoCapabilitiesKHR</a>::<code>maxReferencePicturesSlotsCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoSessionCreateInfoKHR-maxReferencePicturesActiveCount-04848",
|
|
"text": " If <a href=\"#reference-picture\">Reference Pictures</a> are required for use with the created video session, the <code>maxReferencePicturesActiveCount</code> <strong class=\"purple\">must</strong> be set to a value bigger than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoSessionCreateInfoKHR-maxReferencePicturesActiveCount-04849",
|
|
"text": " <code>maxReferencePicturesActiveCount</code> <strong class=\"purple\">cannot</strong> exceed the implementation reported <a href=\"#VkVideoCapabilitiesKHR\">VkVideoCapabilitiesKHR</a>::<code>maxReferencePicturesActiveCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoSessionCreateInfoKHR-maxReferencePicturesActiveCount-04850",
|
|
"text": " <code>maxReferencePicturesActiveCount</code> <strong class=\"purple\">cannot</strong> exceed the <code>maxReferencePicturesSlotsCount</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoSessionCreateInfoKHR-maxCodedExtent-04851",
|
|
"text": " <code>maxCodedExtent</code> <strong class=\"purple\">cannot</strong> be smaller than <a href=\"#VkVideoCapabilitiesKHR\">VkVideoCapabilitiesKHR</a>::<code>minExtent</code> and bigger than <a href=\"#VkVideoCapabilitiesKHR\">VkVideoCapabilitiesKHR</a>::<code>maxExtent</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoSessionCreateInfoKHR-referencePicturesFormat-04852",
|
|
"text": " If the <code>videoCodecOperation</code> member of <code>pVideoProfile</code> specifies a decode operation then <code>referencePicturesFormat</code> <strong class=\"purple\">must</strong> be one of the supported decode DPB formats as reported by <a href=\"#vkGetPhysicalDeviceVideoFormatPropertiesKHR\">vkGetPhysicalDeviceVideoFormatPropertiesKHR</a> in the <code>format</code> member of <a href=\"#VkVideoFormatPropertiesKHR\">VkVideoFormatPropertiesKHR</a> when called with the <code>imageUsage</code> member of its <code>pVideoFormatInfo</code> parameter containing <code>VK_IMAGE_USAGE_VIDEO_DECODE_DPB_BIT_KHR</code>, and with a <a href=\"#VkVideoProfilesKHR\">VkVideoProfilesKHR</a> structure chained to its <code>pVideoFormatInfo</code> parameter whose <code>pProfiles</code> member contains an entry matching <code>pVideoProfile</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoSessionCreateInfoKHR-videoCodecOperation-06814",
|
|
"text": " If the <code>videoCodecOperation</code> member of <code>pVideoProfile</code> specifies an encode operation then <code>referencePicturesFormat</code> <strong class=\"purple\">must</strong> be one of the supported encode DPB formats as reported by <a href=\"#vkGetPhysicalDeviceVideoFormatPropertiesKHR\">vkGetPhysicalDeviceVideoFormatPropertiesKHR</a> in the <code>format</code> member of <a href=\"#VkVideoFormatPropertiesKHR\">VkVideoFormatPropertiesKHR</a> when called with the <code>imageUsage</code> member of its <code>pVideoFormatInfo</code> parameter containing <code>VK_IMAGE_USAGE_VIDEO_ENCODE_DPB_BIT_KHR</code>, and with a <a href=\"#VkVideoProfilesKHR\">VkVideoProfilesKHR</a> structure chained to its <code>pVideoFormatInfo</code> parameter whose <code>pProfiles</code> member contains an entry matching <code>pVideoProfile</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoSessionCreateInfoKHR-pictureFormat-04853",
|
|
"text": " If the <code>videoCodecOperation</code> member of <code>pVideoProfile</code> specifies a decode operation then <code>pictureFormat</code> <strong class=\"purple\">must</strong> be one of the supported decode output formats as reported by <a href=\"#vkGetPhysicalDeviceVideoFormatPropertiesKHR\">vkGetPhysicalDeviceVideoFormatPropertiesKHR</a> in the <code>format</code> member of <a href=\"#VkVideoFormatPropertiesKHR\">VkVideoFormatPropertiesKHR</a> when called with the <code>imageUsage</code> member of its <code>pVideoFormatInfo</code> parameter containing <code>VK_IMAGE_USAGE_VIDEO_DECODE_DST_BIT_KHR</code>, and with a <a href=\"#VkVideoProfilesKHR\">VkVideoProfilesKHR</a> structure chained to its <code>pVideoFormatInfo</code> parameter whose <code>pProfiles</code> member contains an entry matching <code>pVideoProfile</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoSessionCreateInfoKHR-pictureFormat-04854",
|
|
"text": " If the <code>videoCodecOperation</code> member of <code>pVideoProfile</code> specifies an encode operation then <code>pictureFormat</code> <strong class=\"purple\">must</strong> be one of the supported encode input formats as reported by <a href=\"#vkGetPhysicalDeviceVideoFormatPropertiesKHR\">vkGetPhysicalDeviceVideoFormatPropertiesKHR</a> in the <code>format</code> member of <a href=\"#VkVideoFormatPropertiesKHR\">VkVideoFormatPropertiesKHR</a> when called with the <code>imageUsage</code> member of its <code>pVideoFormatInfo</code> parameter containing <code>VK_IMAGE_USAGE_VIDEO_ENCODE_SRC_BIT_KHR</code>, and with a <a href=\"#VkVideoProfilesKHR\">VkVideoProfilesKHR</a> structure chained to its <code>pVideoFormatInfo</code> parameter whose <code>pProfiles</code> member contains an entry matching <code>pVideoProfile</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoSessionCreateInfoKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_VIDEO_SESSION_CREATE_INFO_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoSessionCreateInfoKHR-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoSessionCreateInfoKHR-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkVideoSessionCreateFlagBitsKHR\">VkVideoSessionCreateFlagBitsKHR</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoSessionCreateInfoKHR-pVideoProfile-parameter",
|
|
"text": " <code>pVideoProfile</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkVideoProfileKHR\">VkVideoProfileKHR</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoSessionCreateInfoKHR-pictureFormat-parameter",
|
|
"text": " <code>pictureFormat</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkFormat\">VkFormat</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoSessionCreateInfoKHR-referencePicturesFormat-parameter",
|
|
"text": " <code>referencePicturesFormat</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkFormat\">VkFormat</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoSessionCreateInfoKHR-pStdHeaderVersion-parameter",
|
|
"text": " <code>pStdHeaderVersion</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkExtensionProperties\">VkExtensionProperties</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"vkDestroyVideoSessionKHR": {
|
|
"(VK_KHR_video_queue)": [
|
|
{
|
|
"vuid": "VUID-vkDestroyVideoSessionKHR-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyVideoSessionKHR-videoSession-parameter",
|
|
"text": " <code>videoSession</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkVideoSessionKHR\">VkVideoSessionKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyVideoSessionKHR-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyVideoSessionKHR-videoSession-parent",
|
|
"text": " <code>videoSession</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetVideoSessionMemoryRequirementsKHR": {
|
|
"(VK_KHR_video_queue)": [
|
|
{
|
|
"vuid": "VUID-vkGetVideoSessionMemoryRequirementsKHR-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetVideoSessionMemoryRequirementsKHR-videoSession-parameter",
|
|
"text": " <code>videoSession</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkVideoSessionKHR\">VkVideoSessionKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetVideoSessionMemoryRequirementsKHR-pVideoSessionMemoryRequirementsCount-parameter",
|
|
"text": " <code>pVideoSessionMemoryRequirementsCount</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>uint32_t</code> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetVideoSessionMemoryRequirementsKHR-pVideoSessionMemoryRequirements-parameter",
|
|
"text": " If the value referenced by <code>pVideoSessionMemoryRequirementsCount</code> is not <code>0</code>, and <code>pVideoSessionMemoryRequirements</code> is not <code>NULL</code>, <code>pVideoSessionMemoryRequirements</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>pVideoSessionMemoryRequirementsCount</code> <a href=\"#VkVideoGetMemoryPropertiesKHR\">VkVideoGetMemoryPropertiesKHR</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetVideoSessionMemoryRequirementsKHR-videoSession-parent",
|
|
"text": " <code>videoSession</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkVideoGetMemoryPropertiesKHR": {
|
|
"(VK_KHR_video_queue)": [
|
|
{
|
|
"vuid": "VUID-VkVideoGetMemoryPropertiesKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_VIDEO_GET_MEMORY_PROPERTIES_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoGetMemoryPropertiesKHR-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoGetMemoryPropertiesKHR-pMemoryRequirements-parameter",
|
|
"text": " <code>pMemoryRequirements</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkMemoryRequirements2\">VkMemoryRequirements2</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"vkBindVideoSessionMemoryKHR": {
|
|
"(VK_KHR_video_queue)": [
|
|
{
|
|
"vuid": "VUID-vkBindVideoSessionMemoryKHR-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBindVideoSessionMemoryKHR-videoSession-parameter",
|
|
"text": " <code>videoSession</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkVideoSessionKHR\">VkVideoSessionKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBindVideoSessionMemoryKHR-pVideoSessionBindMemories-parameter",
|
|
"text": " <code>pVideoSessionBindMemories</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>videoSessionBindMemoryCount</code> valid <a href=\"#VkVideoBindMemoryKHR\">VkVideoBindMemoryKHR</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBindVideoSessionMemoryKHR-videoSessionBindMemoryCount-arraylength",
|
|
"text": " <code>videoSessionBindMemoryCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkBindVideoSessionMemoryKHR-videoSession-parent",
|
|
"text": " <code>videoSession</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkVideoBindMemoryKHR": {
|
|
"(VK_KHR_video_queue)": [
|
|
{
|
|
"vuid": "VUID-VkVideoBindMemoryKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_VIDEO_BIND_MEMORY_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoBindMemoryKHR-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoBindMemoryKHR-memory-parameter",
|
|
"text": " <code>memory</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDeviceMemory\">VkDeviceMemory</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"vkCreateVideoSessionParametersKHR": {
|
|
"(VK_KHR_video_queue)": [
|
|
{
|
|
"vuid": "VUID-vkCreateVideoSessionParametersKHR-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateVideoSessionParametersKHR-pCreateInfo-parameter",
|
|
"text": " <code>pCreateInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkVideoSessionParametersCreateInfoKHR\">VkVideoSessionParametersCreateInfoKHR</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateVideoSessionParametersKHR-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateVideoSessionParametersKHR-pVideoSessionParameters-parameter",
|
|
"text": " <code>pVideoSessionParameters</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkVideoSessionParametersKHR\">VkVideoSessionParametersKHR</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkVideoSessionParametersCreateInfoKHR": {
|
|
"(VK_KHR_video_queue)": [
|
|
{
|
|
"vuid": "VUID-VkVideoSessionParametersCreateInfoKHR-videoSessionParametersTemplate-04855",
|
|
"text": " If <code>videoSessionParametersTemplate</code> represents a valid handle, it <strong class=\"purple\">must</strong> have been created against <code>videoSession</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoSessionParametersCreateInfoKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_VIDEO_SESSION_PARAMETERS_CREATE_INFO_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoSessionParametersCreateInfoKHR-pNext-pNext",
|
|
"text": " Each <code>pNext</code> member of any structure (including this one) in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be either <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkVideoDecodeH264SessionParametersCreateInfoEXT\">VkVideoDecodeH264SessionParametersCreateInfoEXT</a>, <a href=\"#VkVideoDecodeH265SessionParametersCreateInfoEXT\">VkVideoDecodeH265SessionParametersCreateInfoEXT</a>, <a href=\"#VkVideoEncodeH264SessionParametersCreateInfoEXT\">VkVideoEncodeH264SessionParametersCreateInfoEXT</a>, or <a href=\"#VkVideoEncodeH265SessionParametersCreateInfoEXT\">VkVideoEncodeH265SessionParametersCreateInfoEXT</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoSessionParametersCreateInfoKHR-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoSessionParametersCreateInfoKHR-videoSessionParametersTemplate-parameter",
|
|
"text": " If <code>videoSessionParametersTemplate</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>videoSessionParametersTemplate</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkVideoSessionParametersKHR\">VkVideoSessionParametersKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoSessionParametersCreateInfoKHR-videoSession-parameter",
|
|
"text": " <code>videoSession</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkVideoSessionKHR\">VkVideoSessionKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoSessionParametersCreateInfoKHR-videoSessionParametersTemplate-parent",
|
|
"text": " If <code>videoSessionParametersTemplate</code> is a valid handle, it <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>videoSession</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoSessionParametersCreateInfoKHR-commonparent",
|
|
"text": " Both of <code>videoSession</code>, and <code>videoSessionParametersTemplate</code> that are valid handles of non-ignored parameters <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
]
|
|
},
|
|
"vkUpdateVideoSessionParametersKHR": {
|
|
"(VK_KHR_video_queue)": [
|
|
{
|
|
"vuid": "VUID-vkUpdateVideoSessionParametersKHR-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkUpdateVideoSessionParametersKHR-videoSessionParameters-parameter",
|
|
"text": " <code>videoSessionParameters</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkVideoSessionParametersKHR\">VkVideoSessionParametersKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkUpdateVideoSessionParametersKHR-pUpdateInfo-parameter",
|
|
"text": " <code>pUpdateInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkVideoSessionParametersUpdateInfoKHR\">VkVideoSessionParametersUpdateInfoKHR</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkVideoSessionParametersUpdateInfoKHR": {
|
|
"(VK_KHR_video_queue)": [
|
|
{
|
|
"vuid": "VUID-VkVideoSessionParametersUpdateInfoKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_VIDEO_SESSION_PARAMETERS_UPDATE_INFO_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoSessionParametersUpdateInfoKHR-pNext-pNext",
|
|
"text": " Each <code>pNext</code> member of any structure (including this one) in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be either <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkVideoDecodeH264SessionParametersAddInfoEXT\">VkVideoDecodeH264SessionParametersAddInfoEXT</a>, <a href=\"#VkVideoDecodeH265SessionParametersAddInfoEXT\">VkVideoDecodeH265SessionParametersAddInfoEXT</a>, <a href=\"#VkVideoEncodeH264SessionParametersAddInfoEXT\">VkVideoEncodeH264SessionParametersAddInfoEXT</a>, or <a href=\"#VkVideoEncodeH265SessionParametersAddInfoEXT\">VkVideoEncodeH265SessionParametersAddInfoEXT</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoSessionParametersUpdateInfoKHR-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
}
|
|
]
|
|
},
|
|
"vkDestroyVideoSessionParametersKHR": {
|
|
"(VK_KHR_video_queue)": [
|
|
{
|
|
"vuid": "VUID-vkDestroyVideoSessionParametersKHR-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyVideoSessionParametersKHR-videoSessionParameters-parameter",
|
|
"text": " <code>videoSessionParameters</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkVideoSessionParametersKHR\">VkVideoSessionParametersKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyVideoSessionParametersKHR-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdBeginVideoCodingKHR": {
|
|
"(VK_KHR_video_queue)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBeginVideoCodingKHR-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginVideoCodingKHR-pBeginInfo-parameter",
|
|
"text": " <code>pBeginInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkVideoBeginCodingInfoKHR\">VkVideoBeginCodingInfoKHR</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginVideoCodingKHR-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginVideoCodingKHR-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support decode, or encode operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginVideoCodingKHR-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginVideoCodingKHR-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginVideoCodingKHR-bufferlevel",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a primary <code>VkCommandBuffer</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkVideoBeginCodingInfoKHR": {
|
|
"(VK_KHR_video_queue)": [
|
|
{
|
|
"vuid": "VUID-VkVideoBeginCodingInfoKHR-referenceSlotCount-04856",
|
|
"text": " <a href=\"#VkVideoBeginCodingInfoKHR\">VkVideoBeginCodingInfoKHR</a>::<code>referenceSlotCount</code> <strong class=\"purple\">must</strong> not exceed the value specified in <a href=\"#VkVideoSessionCreateInfoKHR\">VkVideoSessionCreateInfoKHR</a>::<code>maxReferencePicturesSlotsCount</code> when creating the video session object that is being provided in <code>videoSession</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoBeginCodingInfoKHR-videoSessionParameters-04857",
|
|
"text": " If <code>videoSessionParameters</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, it <strong class=\"purple\">must</strong> have been created using <code>videoSession</code> as a parent object"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoBeginCodingInfoKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_VIDEO_BEGIN_CODING_INFO_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoBeginCodingInfoKHR-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoBeginCodingInfoKHR-flags-zerobitmask",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoBeginCodingInfoKHR-codecQualityPreset-parameter",
|
|
"text": " <code>codecQualityPreset</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkVideoCodingQualityPresetFlagBitsKHR\">VkVideoCodingQualityPresetFlagBitsKHR</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoBeginCodingInfoKHR-codecQualityPreset-requiredbitmask",
|
|
"text": " <code>codecQualityPreset</code> <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoBeginCodingInfoKHR-videoSession-parameter",
|
|
"text": " <code>videoSession</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkVideoSessionKHR\">VkVideoSessionKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoBeginCodingInfoKHR-videoSessionParameters-parameter",
|
|
"text": " If <code>videoSessionParameters</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>videoSessionParameters</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkVideoSessionParametersKHR\">VkVideoSessionParametersKHR</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoBeginCodingInfoKHR-pReferenceSlots-parameter",
|
|
"text": " If <code>referenceSlotCount</code> is not <code>0</code>, <code>pReferenceSlots</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>referenceSlotCount</code> valid <a href=\"#VkVideoReferenceSlotKHR\">VkVideoReferenceSlotKHR</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoBeginCodingInfoKHR-videoSessionParameters-parent",
|
|
"text": " If <code>videoSessionParameters</code> is a valid handle, it <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>videoSession</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoBeginCodingInfoKHR-commonparent",
|
|
"text": " Both of <code>videoSession</code>, and <code>videoSessionParameters</code> that are valid handles of non-ignored parameters <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from the same <a href=\"#VkDevice\">VkDevice</a>"
|
|
}
|
|
]
|
|
},
|
|
"VkVideoReferenceSlotKHR": {
|
|
"(VK_KHR_video_queue)": [
|
|
{
|
|
"vuid": "VUID-VkVideoReferenceSlotKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_VIDEO_REFERENCE_SLOT_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoReferenceSlotKHR-pNext-pNext",
|
|
"text": " Each <code>pNext</code> member of any structure (including this one) in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be either <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkVideoDecodeH264DpbSlotInfoEXT\">VkVideoDecodeH264DpbSlotInfoEXT</a> or <a href=\"#VkVideoDecodeH265DpbSlotInfoEXT\">VkVideoDecodeH265DpbSlotInfoEXT</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoReferenceSlotKHR-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoReferenceSlotKHR-pPictureResource-parameter",
|
|
"text": " <code>pPictureResource</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkVideoPictureResourceKHR\">VkVideoPictureResourceKHR</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkVideoPictureResourceKHR": {
|
|
"(VK_KHR_video_queue)": [
|
|
{
|
|
"vuid": "VUID-VkVideoPictureResourceKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_VIDEO_PICTURE_RESOURCE_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoPictureResourceKHR-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoPictureResourceKHR-imageViewBinding-parameter",
|
|
"text": " <code>imageViewBinding</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageView\">VkImageView</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdEndVideoCodingKHR": {
|
|
"(VK_KHR_video_queue)": [
|
|
{
|
|
"vuid": "VUID-vkCmdEndVideoCodingKHR-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndVideoCodingKHR-pEndCodingInfo-parameter",
|
|
"text": " <code>pEndCodingInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkVideoEndCodingInfoKHR\">VkVideoEndCodingInfoKHR</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndVideoCodingKHR-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndVideoCodingKHR-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support decode, or encode operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndVideoCodingKHR-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndVideoCodingKHR-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called inside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndVideoCodingKHR-bufferlevel",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a primary <code>VkCommandBuffer</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkVideoEndCodingInfoKHR": {
|
|
"(VK_KHR_video_queue)": [
|
|
{
|
|
"vuid": "VUID-VkVideoEndCodingInfoKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_VIDEO_END_CODING_INFO_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEndCodingInfoKHR-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEndCodingInfoKHR-flags-zerobitmask",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdControlVideoCodingKHR": {
|
|
"(VK_KHR_video_queue)": [
|
|
{
|
|
"vuid": "VUID-vkCmdControlVideoCodingKHR-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdControlVideoCodingKHR-pCodingControlInfo-parameter",
|
|
"text": " <code>pCodingControlInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkVideoCodingControlInfoKHR\">VkVideoCodingControlInfoKHR</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdControlVideoCodingKHR-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdControlVideoCodingKHR-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support decode, or encode operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdControlVideoCodingKHR-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdControlVideoCodingKHR-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called inside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdControlVideoCodingKHR-bufferlevel",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a primary <code>VkCommandBuffer</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkVideoCodingControlInfoKHR": {
|
|
"(VK_KHR_video_queue)": [
|
|
{
|
|
"vuid": "VUID-VkVideoCodingControlInfoKHR-flags-06518",
|
|
"text": " The first command buffer submitted for a newly created video session <strong class=\"purple\">must</strong> set the <code>VK_VIDEO_CODING_CONTROL_RESET_BIT_KHR</code> bit in <a href=\"#VkVideoCodingControlInfoKHR\">VkVideoCodingControlInfoKHR</a>::<code>flags</code> to reset the session device context before any video decode or encode operations are performed on the session."
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoCodingControlInfoKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_VIDEO_CODING_CONTROL_INFO_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoCodingControlInfoKHR-pNext-pNext",
|
|
"text": " Each <code>pNext</code> member of any structure (including this one) in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be either <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkVideoEncodeRateControlInfoKHR\">VkVideoEncodeRateControlInfoKHR</a> or <a href=\"#VkVideoEncodeRateControlLayerInfoKHR\">VkVideoEncodeRateControlLayerInfoKHR</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoCodingControlInfoKHR-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoCodingControlInfoKHR-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkVideoCodingControlFlagBitsKHR\">VkVideoCodingControlFlagBitsKHR</a> values"
|
|
}
|
|
]
|
|
},
|
|
"VkVideoDecodeCapabilitiesKHR": {
|
|
"(VK_KHR_video_decode_queue)": [
|
|
{
|
|
"vuid": "VUID-VkVideoDecodeCapabilitiesKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_VIDEO_DECODE_CAPABILITIES_KHR</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdDecodeVideoKHR": {
|
|
"(VK_KHR_video_decode_queue)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDecodeVideoKHR-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDecodeVideoKHR-pFrameInfo-parameter",
|
|
"text": " <code>pFrameInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkVideoDecodeInfoKHR\">VkVideoDecodeInfoKHR</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDecodeVideoKHR-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDecodeVideoKHR-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support decode operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDecodeVideoKHR-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDecodeVideoKHR-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called inside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDecodeVideoKHR-bufferlevel",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a primary <code>VkCommandBuffer</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkVideoDecodeInfoKHR": {
|
|
"(VK_KHR_video_decode_queue)": [
|
|
{
|
|
"vuid": "VUID-VkVideoDecodeInfoKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_VIDEO_DECODE_INFO_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoDecodeInfoKHR-pNext-pNext",
|
|
"text": " Each <code>pNext</code> member of any structure (including this one) in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be either <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkVideoDecodeH264PictureInfoEXT\">VkVideoDecodeH264PictureInfoEXT</a> or <a href=\"#VkVideoDecodeH265PictureInfoEXT\">VkVideoDecodeH265PictureInfoEXT</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoDecodeInfoKHR-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoDecodeInfoKHR-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkVideoDecodeFlagBitsKHR\">VkVideoDecodeFlagBitsKHR</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoDecodeInfoKHR-srcBuffer-parameter",
|
|
"text": " <code>srcBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBuffer\">VkBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoDecodeInfoKHR-dstPictureResource-parameter",
|
|
"text": " <code>dstPictureResource</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkVideoPictureResourceKHR\">VkVideoPictureResourceKHR</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoDecodeInfoKHR-pSetupReferenceSlot-parameter",
|
|
"text": " <code>pSetupReferenceSlot</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkVideoReferenceSlotKHR\">VkVideoReferenceSlotKHR</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoDecodeInfoKHR-pReferenceSlots-parameter",
|
|
"text": " If <code>referenceSlotCount</code> is not <code>0</code>, <code>pReferenceSlots</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>referenceSlotCount</code> valid <a href=\"#VkVideoReferenceSlotKHR\">VkVideoReferenceSlotKHR</a> structures"
|
|
}
|
|
]
|
|
},
|
|
"VkVideoDecodeH264ProfileEXT": {
|
|
"(VK_EXT_video_decode_h264)": [
|
|
{
|
|
"vuid": "VUID-VkVideoDecodeH264ProfileEXT-pNext-06259",
|
|
"text": " If the <a href=\"#VkVideoDecodeH264ProfileEXT\">VkVideoDecodeH264ProfileEXT</a> structure is included in the <code>pNext</code> chain of the <a href=\"#VkVideoCapabilitiesKHR\">VkVideoCapabilitiesKHR</a> structure passed to <a href=\"#vkGetPhysicalDeviceVideoCapabilitiesKHR\">vkGetPhysicalDeviceVideoCapabilitiesKHR</a>, the value in <code>pictureLayout</code> is treated as a bitmask of requested picture layouts. It is always valid to use the value <code>VK_VIDEO_DECODE_H264_PICTURE_LAYOUT_PROGRESSIVE_EXT</code> as the implementation is guaranteed to support decoding of progressive content."
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoDecodeH264ProfileEXT-pNext-06260",
|
|
"text": " If the <a href=\"#VkVideoDecodeH264ProfileEXT\">VkVideoDecodeH264ProfileEXT</a> structure is included in the <code>pNext</code> chain of the <a href=\"#VkVideoSessionCreateInfoKHR\">VkVideoSessionCreateInfoKHR</a> structure passed to <a href=\"#vkCreateVideoSessionKHR\">vkCreateVideoSessionKHR</a>, the value in <code>pictureLayout</code> <strong class=\"purple\">must</strong> be exactly one of <code>VK_VIDEO_DECODE_H264_PICTURE_LAYOUT_PROGRESSIVE_EXT</code>, <code>VK_VIDEO_DECODE_H264_PICTURE_LAYOUT_INTERLACED_INTERLEAVED_LINES_BIT_EXT</code> or <code>VK_VIDEO_DECODE_H264_PICTURE_LAYOUT_INTERLACED_SEPARATE_PLANES_BIT_EXT</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoDecodeH264ProfileEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_VIDEO_DECODE_H264_PROFILE_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkVideoDecodeH264CapabilitiesEXT": {
|
|
"(VK_EXT_video_decode_h264)": [
|
|
{
|
|
"vuid": "VUID-VkVideoDecodeH264CapabilitiesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_VIDEO_DECODE_H264_CAPABILITIES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkVideoDecodeH264SessionParametersCreateInfoEXT": {
|
|
"(VK_EXT_video_decode_h264)": [
|
|
{
|
|
"vuid": "VUID-VkVideoDecodeH264SessionParametersCreateInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_VIDEO_DECODE_H264_SESSION_PARAMETERS_CREATE_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoDecodeH264SessionParametersCreateInfoEXT-pParametersAddInfo-parameter",
|
|
"text": " If <code>pParametersAddInfo</code> is not <code>NULL</code>, <code>pParametersAddInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkVideoDecodeH264SessionParametersAddInfoEXT\">VkVideoDecodeH264SessionParametersAddInfoEXT</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkVideoDecodeH264SessionParametersAddInfoEXT": {
|
|
"(VK_EXT_video_decode_h264)": [
|
|
{
|
|
"vuid": "VUID-VkVideoDecodeH264SessionParametersAddInfoEXT-spsStdCount-04822",
|
|
"text": " The values of <code>spsStdCount</code> and <code>ppsStdCount</code> <strong class=\"purple\">must</strong> be less than or equal to the values of <code>maxSpsStdCount</code> and <code>maxPpsStdCount</code>, respectively"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoDecodeH264SessionParametersAddInfoEXT-maxSpsStdCount-04823",
|
|
"text": " When the <code>maxSpsStdCount</code> number of parameters of type StdVideoH264SequenceParameterSet in the Video Session Parameters object is reached, no additional parameters of that type can be added to this object. <code>VK_ERROR_TOO_MANY_OBJECTS</code> will be returned if an attempt is made to add additional data to this object at this point"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoDecodeH264SessionParametersAddInfoEXT-maxPpsStdCount-04824",
|
|
"text": " When the <code>maxPpsStdCount</code> number of parameters of type StdVideoH264PictureParameterSet in the Video Session Parameters object is reached, no additional parameters of that type can be added to this object. <code>VK_ERROR_TOO_MANY_OBJECTS</code> will be returned if an attempt is made to add additional data to this object at this point"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoDecodeH264SessionParametersAddInfoEXT-None-04825",
|
|
"text": " Each entry to be added <strong class=\"purple\">must</strong> have a unique, to the rest of the parameter array entries and the existing parameters in the Video Session Parameters Object that is being updated, SPS-PPS IDs"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoDecodeH264SessionParametersAddInfoEXT-None-04826",
|
|
"text": " Parameter entries that already exist in Video Session Parameters object with a particular SPS-PPS IDs <strong class=\"purple\">cannot</strong> be replaced nor updated"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoDecodeH264SessionParametersAddInfoEXT-None-04827",
|
|
"text": " When creating a new object using a Video Session Parameters as a template, the array’s parameters with the same SPS-PPS IDs as the ones from the template take precedence"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoDecodeH264SessionParametersAddInfoEXT-None-04828",
|
|
"text": " SPS/PPS parameters <strong class=\"purple\">must</strong> comply with the limits specified in <a href=\"#VkVideoSessionCreateInfoKHR\">VkVideoSessionCreateInfoKHR</a> during Video Session creation"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoDecodeH264SessionParametersAddInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_VIDEO_DECODE_H264_SESSION_PARAMETERS_ADD_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoDecodeH264SessionParametersAddInfoEXT-pSpsStd-parameter",
|
|
"text": " If <code>pSpsStd</code> is not <code>NULL</code>, <code>pSpsStd</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>spsStdCount</code> <code>StdVideoH264SequenceParameterSet</code> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoDecodeH264SessionParametersAddInfoEXT-pPpsStd-parameter",
|
|
"text": " If <code>pPpsStd</code> is not <code>NULL</code>, <code>pPpsStd</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>ppsStdCount</code> <code>StdVideoH264PictureParameterSet</code> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoDecodeH264SessionParametersAddInfoEXT-spsStdCount-arraylength",
|
|
"text": " <code>spsStdCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoDecodeH264SessionParametersAddInfoEXT-ppsStdCount-arraylength",
|
|
"text": " <code>ppsStdCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkVideoDecodeH264PictureInfoEXT": {
|
|
"(VK_EXT_video_decode_h264)": [
|
|
{
|
|
"vuid": "VUID-VkVideoDecodeH264PictureInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_VIDEO_DECODE_H264_PICTURE_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoDecodeH264PictureInfoEXT-pStdPictureInfo-parameter",
|
|
"text": " <code>pStdPictureInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <code>StdVideoDecodeH264PictureInfo</code> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoDecodeH264PictureInfoEXT-pSlicesDataOffsets-parameter",
|
|
"text": " <code>pSlicesDataOffsets</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>slicesCount</code> <code>uint32_t</code> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoDecodeH264PictureInfoEXT-slicesCount-arraylength",
|
|
"text": " <code>slicesCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkVideoDecodeH264DpbSlotInfoEXT": {
|
|
"(VK_EXT_video_decode_h264)": [
|
|
{
|
|
"vuid": "VUID-VkVideoDecodeH264DpbSlotInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_VIDEO_DECODE_H264_DPB_SLOT_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoDecodeH264DpbSlotInfoEXT-pStdReferenceInfo-parameter",
|
|
"text": " <code>pStdReferenceInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <code>StdVideoDecodeH264ReferenceInfo</code> value"
|
|
}
|
|
]
|
|
},
|
|
"VkVideoDecodeH264MvcEXT": {
|
|
"(VK_EXT_video_decode_h264)": [
|
|
{
|
|
"vuid": "VUID-VkVideoDecodeH264MvcEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_VIDEO_DECODE_H264_MVC_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoDecodeH264MvcEXT-pStdMvc-parameter",
|
|
"text": " <code>pStdMvc</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <code>StdVideoDecodeH264Mvc</code> value"
|
|
}
|
|
]
|
|
},
|
|
"VkVideoDecodeH265ProfileEXT": {
|
|
"(VK_EXT_video_decode_h265)": [
|
|
{
|
|
"vuid": "VUID-VkVideoDecodeH265ProfileEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_VIDEO_DECODE_H265_PROFILE_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkVideoDecodeH265CapabilitiesEXT": {
|
|
"(VK_EXT_video_decode_h265)": [
|
|
{
|
|
"vuid": "VUID-VkVideoDecodeH265CapabilitiesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_VIDEO_DECODE_H265_CAPABILITIES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkVideoDecodeH265SessionParametersCreateInfoEXT": {
|
|
"(VK_EXT_video_decode_h265)": [
|
|
{
|
|
"vuid": "VUID-VkVideoDecodeH265SessionParametersCreateInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_VIDEO_DECODE_H265_SESSION_PARAMETERS_CREATE_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoDecodeH265SessionParametersCreateInfoEXT-pParametersAddInfo-parameter",
|
|
"text": " If <code>pParametersAddInfo</code> is not <code>NULL</code>, <code>pParametersAddInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkVideoDecodeH265SessionParametersAddInfoEXT\">VkVideoDecodeH265SessionParametersAddInfoEXT</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkVideoDecodeH265SessionParametersAddInfoEXT": {
|
|
"(VK_EXT_video_decode_h265)": [
|
|
{
|
|
"vuid": "VUID-VkVideoDecodeH265SessionParametersAddInfoEXT-vpsStdCount-04829",
|
|
"text": " The values of <code>vpsStdCount</code>, <code>spsStdCount</code> and <code>ppsStdCount</code> <strong class=\"purple\">must</strong> be less than or equal to the values of <code>maxVpsStdCount</code>, <code>maxSpsStdCount</code> and <code>maxPpsStdCount</code>, respectively"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoDecodeH265SessionParametersAddInfoEXT-maxVpsStdCount-04830",
|
|
"text": " When the <code>maxVpsStdCount</code> number of parameters of type StdVideoH265VideoParameterSet in the Video Session Parameters object is reached, no additional parameters of that type can be added to the object. <code>VK_ERROR_TOO_MANY_OBJECTS</code> will be returned if an attempt is made to add additional data to this object at this point"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoDecodeH265SessionParametersAddInfoEXT-maxSpsStdCount-04831",
|
|
"text": " When the <code>maxSpsStdCount</code> number of parameters of type StdVideoH265SequenceParameterSet in the Video Session Parameters object is reached, no additional parameters of that type can be added to the object. <code>VK_ERROR_TOO_MANY_OBJECTS</code> will be returned if an attempt is made to add additional data to this object at this point"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoDecodeH265SessionParametersAddInfoEXT-maxPpsStdCount-04832",
|
|
"text": " When the <code>maxPpsStdCount</code> number of parameters of type StdVideoH265PictureParameterSet in the Video Session Parameters object is reached, no additional parameters of that type can be added to the object. <code>VK_ERROR_TOO_MANY_OBJECTS</code> will be returned if an attempt is made to add additional data to this object at this point"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoDecodeH265SessionParametersAddInfoEXT-None-04833",
|
|
"text": " Each entry to be added <strong class=\"purple\">must</strong> have a unique, to the rest of the parameter array entries and the existing parameters in the Video Session Parameters Object that is being updated, VPS-SPS-PPS IDs"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoDecodeH265SessionParametersAddInfoEXT-None-04834",
|
|
"text": " Parameter entries that already exist in Video Session Parameters object with a particular VPS-SPS-PPS IDs <strong class=\"purple\">cannot</strong> be replaced nor updated"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoDecodeH265SessionParametersAddInfoEXT-None-04835",
|
|
"text": " When creating a new object using a Video Session Parameters as a template, the array’s parameters with the same VPS-SPS-PPS IDs as the ones from the template take precedence"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoDecodeH265SessionParametersAddInfoEXT-None-04836",
|
|
"text": " VPS/SPS/PPS parameters <strong class=\"purple\">must</strong> comply with the limits specified in <a href=\"#VkVideoSessionCreateInfoKHR\">VkVideoSessionCreateInfoKHR</a> during Video Session creation"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoDecodeH265SessionParametersAddInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_VIDEO_DECODE_H265_SESSION_PARAMETERS_ADD_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoDecodeH265SessionParametersAddInfoEXT-pVpsStd-parameter",
|
|
"text": " If <code>pVpsStd</code> is not <code>NULL</code>, <code>pVpsStd</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>vpsStdCount</code> <code>StdVideoH265VideoParameterSet</code> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoDecodeH265SessionParametersAddInfoEXT-pSpsStd-parameter",
|
|
"text": " If <code>pSpsStd</code> is not <code>NULL</code>, <code>pSpsStd</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>spsStdCount</code> <code>StdVideoH265SequenceParameterSet</code> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoDecodeH265SessionParametersAddInfoEXT-pPpsStd-parameter",
|
|
"text": " If <code>pPpsStd</code> is not <code>NULL</code>, <code>pPpsStd</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>ppsStdCount</code> <code>StdVideoH265PictureParameterSet</code> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoDecodeH265SessionParametersAddInfoEXT-vpsStdCount-arraylength",
|
|
"text": " <code>vpsStdCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoDecodeH265SessionParametersAddInfoEXT-spsStdCount-arraylength",
|
|
"text": " <code>spsStdCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoDecodeH265SessionParametersAddInfoEXT-ppsStdCount-arraylength",
|
|
"text": " <code>ppsStdCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkVideoDecodeH265PictureInfoEXT": {
|
|
"(VK_EXT_video_decode_h265)": [
|
|
{
|
|
"vuid": "VUID-VkVideoDecodeH265PictureInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_VIDEO_DECODE_H265_PICTURE_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoDecodeH265PictureInfoEXT-pStdPictureInfo-parameter",
|
|
"text": " <code>pStdPictureInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>StdVideoDecodeH265PictureInfo</code> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoDecodeH265PictureInfoEXT-pSlicesDataOffsets-parameter",
|
|
"text": " <code>pSlicesDataOffsets</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>slicesCount</code> <code>uint32_t</code> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoDecodeH265PictureInfoEXT-slicesCount-arraylength",
|
|
"text": " <code>slicesCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkVideoDecodeH265DpbSlotInfoEXT": {
|
|
"(VK_EXT_video_decode_h265)": [
|
|
{
|
|
"vuid": "VUID-VkVideoDecodeH265DpbSlotInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_VIDEO_DECODE_H265_DPB_SLOT_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoDecodeH265DpbSlotInfoEXT-pStdReferenceInfo-parameter",
|
|
"text": " <code>pStdReferenceInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <code>StdVideoDecodeH265ReferenceInfo</code> value"
|
|
}
|
|
]
|
|
},
|
|
"VkVideoEncodeCapabilitiesKHR": {
|
|
"(VK_KHR_video_encode_queue)": [
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeCapabilitiesKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_VIDEO_ENCODE_CAPABILITIES_KHR</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdEncodeVideoKHR": {
|
|
"(VK_KHR_video_encode_queue)": [
|
|
{
|
|
"vuid": "VUID-vkCmdEncodeVideoKHR-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEncodeVideoKHR-pEncodeInfo-parameter",
|
|
"text": " <code>pEncodeInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkVideoEncodeInfoKHR\">VkVideoEncodeInfoKHR</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEncodeVideoKHR-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEncodeVideoKHR-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support encode operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEncodeVideoKHR-renderpass",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a render pass instance"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEncodeVideoKHR-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called inside of a video coding scope"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEncodeVideoKHR-bufferlevel",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a primary <code>VkCommandBuffer</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkVideoEncodeInfoKHR": {
|
|
"(VK_KHR_video_encode_queue)": [
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeInfoKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_VIDEO_ENCODE_INFO_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeInfoKHR-pNext-pNext",
|
|
"text": " Each <code>pNext</code> member of any structure (including this one) in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be either <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkVideoEncodeH264EmitPictureParametersEXT\">VkVideoEncodeH264EmitPictureParametersEXT</a>, <a href=\"#VkVideoEncodeH264VclFrameInfoEXT\">VkVideoEncodeH264VclFrameInfoEXT</a>, <a href=\"#VkVideoEncodeH265EmitPictureParametersEXT\">VkVideoEncodeH265EmitPictureParametersEXT</a>, or <a href=\"#VkVideoEncodeH265VclFrameInfoEXT\">VkVideoEncodeH265VclFrameInfoEXT</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeInfoKHR-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeInfoKHR-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkVideoEncodeFlagBitsKHR\">VkVideoEncodeFlagBitsKHR</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeInfoKHR-dstBitstreamBuffer-parameter",
|
|
"text": " <code>dstBitstreamBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkBuffer\">VkBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeInfoKHR-srcPictureResource-parameter",
|
|
"text": " <code>srcPictureResource</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkVideoPictureResourceKHR\">VkVideoPictureResourceKHR</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeInfoKHR-pSetupReferenceSlot-parameter",
|
|
"text": " <code>pSetupReferenceSlot</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkVideoReferenceSlotKHR\">VkVideoReferenceSlotKHR</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeInfoKHR-pReferenceSlots-parameter",
|
|
"text": " If <code>referenceSlotCount</code> is not <code>0</code>, <code>pReferenceSlots</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>referenceSlotCount</code> valid <a href=\"#VkVideoReferenceSlotKHR\">VkVideoReferenceSlotKHR</a> structures"
|
|
}
|
|
]
|
|
},
|
|
"VkVideoEncodeRateControlInfoKHR": {
|
|
"(VK_KHR_video_encode_queue)+(VK_EXT_video_encode_h264)": [
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH264RateControlInfoEXT-chainrequirement",
|
|
"text": " <a href=\"#VkVideoEncodeH264RateControlInfoEXT\">VkVideoEncodeH264RateControlInfoEXT</a> <strong class=\"purple\">must</strong> be included in the <code>pNext</code> chain of <a href=\"#VkVideoEncodeRateControlInfoKHR\">VkVideoEncodeRateControlInfoKHR</a> if and only if <a href=\"#VkVideoEncodeRateControlInfoKHR\">VkVideoEncodeRateControlInfoKHR</a>::<code>rateControlMode</code> is not <code>VK_VIDEO_ENCODE_RATE_CONTROL_MODE_NONE_BIT_KHR</code> and the bound video session was created with <a href=\"#VkVideoProfileKHR\">VkVideoProfileKHR</a>::<code>videoCodecOperation</code> set to <code>VK_VIDEO_CODEC_OPERATION_ENCODE_H264_BIT_EXT</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH264RateControlInfoEXT-temporalLayerCount",
|
|
"text": " If <a href=\"#VkVideoEncodeRateControlInfoKHR\">VkVideoEncodeRateControlInfoKHR</a>::<code>layerCount</code> is greater than <code>1</code>, then <a href=\"#VkVideoEncodeH264RateControlInfoEXT\">VkVideoEncodeH264RateControlInfoEXT</a>::<code>temporalLayerCount</code> <strong class=\"purple\">must</strong> be equal to <code>layerCount</code>."
|
|
}
|
|
],
|
|
"(VK_KHR_video_encode_queue)+(VK_EXT_video_encode_h265)": [
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH265RateControlInfoEXT-chainrequirement",
|
|
"text": " <a href=\"#VkVideoEncodeH265RateControlInfoEXT\">VkVideoEncodeH265RateControlInfoEXT</a> <strong class=\"purple\">must</strong> be included in the <code>pNext</code> chain of <a href=\"#VkVideoEncodeRateControlInfoKHR\">VkVideoEncodeRateControlInfoKHR</a> if and only if <a href=\"#VkVideoEncodeRateControlInfoKHR\">VkVideoEncodeRateControlInfoKHR</a>::<code>rateControlMode</code> is not <code>VK_VIDEO_ENCODE_RATE_CONTROL_MODE_NONE_BIT_KHR</code> and the bound video session was created with <a href=\"#VkVideoProfileKHR\">VkVideoProfileKHR</a>::<code>videoCodecOperation</code> set to <code>VK_VIDEO_CODEC_OPERATION_ENCODE_H265_BIT_EXT</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH265RateControlInfoEXT-subLayerCount",
|
|
"text": " If <a href=\"#VkVideoEncodeRateControlInfoKHR\">VkVideoEncodeRateControlInfoKHR</a>::<code>layerCount</code> is greater than <code>1</code>, then <a href=\"#VkVideoEncodeH265RateControlInfoEXT\">VkVideoEncodeH265RateControlInfoEXT</a>::<code>subLayerCount</code> <strong class=\"purple\">must</strong> be equal to <code>layerCount</code>."
|
|
}
|
|
],
|
|
"(VK_KHR_video_encode_queue)": [
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeRateControlInfoKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_VIDEO_ENCODE_RATE_CONTROL_INFO_KHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeRateControlInfoKHR-rateControlMode-parameter",
|
|
"text": " <code>rateControlMode</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkVideoEncodeRateControlModeFlagBitsKHR\">VkVideoEncodeRateControlModeFlagBitsKHR</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeRateControlInfoKHR-pLayerConfigs-parameter",
|
|
"text": " <code>pLayerConfigs</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>layerCount</code> valid <a href=\"#VkVideoEncodeRateControlLayerInfoKHR\">VkVideoEncodeRateControlLayerInfoKHR</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeRateControlInfoKHR-layerCount-arraylength",
|
|
"text": " <code>layerCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkVideoEncodeRateControlLayerInfoKHR": {
|
|
"(VK_KHR_video_encode_queue)": [
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeRateControlLayerInfoKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_VIDEO_ENCODE_RATE_CONTROL_LAYER_INFO_KHR</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkVideoEncodeH264ProfileEXT": {
|
|
"(VK_EXT_video_encode_h264)": [
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH264ProfileEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_VIDEO_ENCODE_H264_PROFILE_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkVideoEncodeH264CapabilitiesEXT": {
|
|
"(VK_EXT_video_encode_h264)": [
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH264CapabilitiesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_VIDEO_ENCODE_H264_CAPABILITIES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkVideoEncodeH264SessionParametersCreateInfoEXT": {
|
|
"(VK_EXT_video_encode_h264)": [
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH264SessionParametersCreateInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_VIDEO_ENCODE_H264_SESSION_PARAMETERS_CREATE_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH264SessionParametersCreateInfoEXT-pParametersAddInfo-parameter",
|
|
"text": " If <code>pParametersAddInfo</code> is not <code>NULL</code>, <code>pParametersAddInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkVideoEncodeH264SessionParametersAddInfoEXT\">VkVideoEncodeH264SessionParametersAddInfoEXT</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkVideoEncodeH264SessionParametersAddInfoEXT": {
|
|
"(VK_EXT_video_encode_h264)": [
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH264SessionParametersAddInfoEXT-spsStdCount-04837",
|
|
"text": " The values of <code>spsStdCount</code> and <code>ppsStdCount</code> <strong class=\"purple\">must</strong> be less than or equal to the values of <code>maxSpsStdCount</code> and <code>maxPpsStdCount</code>, respectively"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH264SessionParametersAddInfoEXT-maxSpsStdCount-04838",
|
|
"text": " When the <code>maxSpsStdCount</code> number of parameters of type StdVideoH264SequenceParameterSet in the Video Session Parameters object is reached, no additional parameters of that type can be added to the object. <code>VK_ERROR_TOO_MANY_OBJECTS</code> will be returned if an attempt is made to add additional data to this object at this point"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH264SessionParametersAddInfoEXT-maxPpsStdCount-04839",
|
|
"text": " When the <code>maxPpsStdCount</code> number of parameters of type StdVideoH264PictureParameterSet in the Video Session Parameters object is reached, no additional parameters of that type can be added to the object. <code>VK_ERROR_TOO_MANY_OBJECTS</code> will be returned if an attempt is made to add additional data to this object at this point"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH264SessionParametersAddInfoEXT-None-04840",
|
|
"text": " Each entry to be added <strong class=\"purple\">must</strong> have a unique, to the rest of the parameter array entries and the existing parameters in the Video Session Parameters Object that is being updated, SPS-PPS IDs"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH264SessionParametersAddInfoEXT-None-04841",
|
|
"text": " Parameter entries that already exist in Video Session Parameters object with a particular SPS-PPS IDs <strong class=\"purple\">cannot</strong> be replaced nor updated"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH264SessionParametersAddInfoEXT-None-04842",
|
|
"text": " When creating a new object using a Video Session Parameters as a template, the array’s parameters with the same SPS-PPS IDs as the ones from the template take precedence"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH264SessionParametersAddInfoEXT-None-04843",
|
|
"text": " SPS/PPS parameters <strong class=\"purple\">must</strong> comply with the limits specified in <a href=\"#VkVideoSessionCreateInfoKHR\">VkVideoSessionCreateInfoKHR</a> during Video Session creation"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH264SessionParametersAddInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_VIDEO_ENCODE_H264_SESSION_PARAMETERS_ADD_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH264SessionParametersAddInfoEXT-pSpsStd-parameter",
|
|
"text": " If <code>pSpsStd</code> is not <code>NULL</code>, <code>pSpsStd</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>spsStdCount</code> <code>StdVideoH264SequenceParameterSet</code> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH264SessionParametersAddInfoEXT-pPpsStd-parameter",
|
|
"text": " If <code>pPpsStd</code> is not <code>NULL</code>, <code>pPpsStd</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>ppsStdCount</code> <code>StdVideoH264PictureParameterSet</code> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH264SessionParametersAddInfoEXT-spsStdCount-arraylength",
|
|
"text": " <code>spsStdCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH264SessionParametersAddInfoEXT-ppsStdCount-arraylength",
|
|
"text": " <code>ppsStdCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkVideoEncodeH264VclFrameInfoEXT": {
|
|
"(VK_EXT_video_encode_h264)": [
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH264VclFrameInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_VIDEO_ENCODE_H264_VCL_FRAME_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH264VclFrameInfoEXT-pReferenceFinalLists-parameter",
|
|
"text": " If <code>pReferenceFinalLists</code> is not <code>NULL</code>, <code>pReferenceFinalLists</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkVideoEncodeH264ReferenceListsEXT\">VkVideoEncodeH264ReferenceListsEXT</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH264VclFrameInfoEXT-pNaluSliceEntries-parameter",
|
|
"text": " <code>pNaluSliceEntries</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>naluSliceEntryCount</code> valid <a href=\"#VkVideoEncodeH264NaluSliceEXT\">VkVideoEncodeH264NaluSliceEXT</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH264VclFrameInfoEXT-pCurrentPictureInfo-parameter",
|
|
"text": " <code>pCurrentPictureInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <code>StdVideoEncodeH264PictureInfo</code> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH264VclFrameInfoEXT-naluSliceEntryCount-arraylength",
|
|
"text": " <code>naluSliceEntryCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkVideoEncodeH264NaluSliceEXT": {
|
|
"(VK_EXT_video_encode_h264)": [
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH264NaluSliceEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_VIDEO_ENCODE_H264_NALU_SLICE_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH264NaluSliceEXT-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH264NaluSliceEXT-pReferenceFinalLists-parameter",
|
|
"text": " If <code>pReferenceFinalLists</code> is not <code>NULL</code>, <code>pReferenceFinalLists</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkVideoEncodeH264ReferenceListsEXT\">VkVideoEncodeH264ReferenceListsEXT</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH264NaluSliceEXT-pSliceHeaderStd-parameter",
|
|
"text": " <code>pSliceHeaderStd</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <code>StdVideoEncodeH264SliceHeader</code> value"
|
|
}
|
|
]
|
|
},
|
|
"VkVideoEncodeH264DpbSlotInfoEXT": {
|
|
"(VK_EXT_video_encode_h264)": [
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH264DpbSlotInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_VIDEO_ENCODE_H264_DPB_SLOT_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH264DpbSlotInfoEXT-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH264DpbSlotInfoEXT-pStdReferenceInfo-parameter",
|
|
"text": " <code>pStdReferenceInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <code>StdVideoEncodeH264ReferenceInfo</code> value"
|
|
}
|
|
]
|
|
},
|
|
"VkVideoEncodeH264ReferenceListsEXT": {
|
|
"(VK_EXT_video_encode_h264)": [
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH264ReferenceListsEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_VIDEO_ENCODE_H264_REFERENCE_LISTS_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH264ReferenceListsEXT-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH264ReferenceListsEXT-pReferenceList0Entries-parameter",
|
|
"text": " If <code>referenceList0EntryCount</code> is not <code>0</code>, <code>pReferenceList0Entries</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>referenceList0EntryCount</code> valid <a href=\"#VkVideoEncodeH264DpbSlotInfoEXT\">VkVideoEncodeH264DpbSlotInfoEXT</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH264ReferenceListsEXT-pReferenceList1Entries-parameter",
|
|
"text": " If <code>referenceList1EntryCount</code> is not <code>0</code>, <code>pReferenceList1Entries</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>referenceList1EntryCount</code> valid <a href=\"#VkVideoEncodeH264DpbSlotInfoEXT\">VkVideoEncodeH264DpbSlotInfoEXT</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH264ReferenceListsEXT-pMemMgmtCtrlOperations-parameter",
|
|
"text": " <code>pMemMgmtCtrlOperations</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <code>StdVideoEncodeH264RefMemMgmtCtrlOperations</code> value"
|
|
}
|
|
]
|
|
},
|
|
"VkVideoEncodeH264EmitPictureParametersEXT": {
|
|
"(VK_EXT_video_encode_h264)": [
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH264EmitPictureParametersEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_VIDEO_ENCODE_H264_EMIT_PICTURE_PARAMETERS_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH264EmitPictureParametersEXT-ppsIdEntries-parameter",
|
|
"text": " <code>ppsIdEntries</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>ppsIdEntryCount</code> <code>uint8_t</code> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH264EmitPictureParametersEXT-ppsIdEntryCount-arraylength",
|
|
"text": " <code>ppsIdEntryCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkVideoEncodeH264RateControlInfoEXT": {
|
|
"(VK_EXT_video_encode_h264)": [
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH264RateControlInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_VIDEO_ENCODE_H264_RATE_CONTROL_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH264RateControlInfoEXT-rateControlStructure-parameter",
|
|
"text": " <code>rateControlStructure</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkVideoEncodeH264RateControlStructureFlagBitsEXT\">VkVideoEncodeH264RateControlStructureFlagBitsEXT</a> value"
|
|
}
|
|
]
|
|
},
|
|
"VkVideoEncodeH264RateControlLayerInfoEXT": {
|
|
"(VK_EXT_video_encode_h264)": [
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH264RateControlLayerInfoEXT-rateControlMode-06474",
|
|
"text": " When <a href=\"#VkVideoEncodeRateControlInfoKHR\">VkVideoEncodeRateControlInfoKHR</a>::<code>rateControlMode</code> is <code>VK_VIDEO_ENCODE_RATE_CONTROL_MODE_NONE_BIT_KHR</code>, both <code>useMinQp</code> and <code>useMaxQp</code> must be set to <code>VK_TRUE</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH264RateControlLayerInfoEXT-rateControlMode-06475",
|
|
"text": " When <a href=\"#VkVideoEncodeRateControlInfoKHR\">VkVideoEncodeRateControlInfoKHR</a>::<code>rateControlMode</code> is <code>VK_VIDEO_ENCODE_RATE_CONTROL_MODE_NONE_BIT_KHR</code>, the values provided in <code>minQP</code> must be identical to those provided in <code>maxQp</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH264RateControlLayerInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_VIDEO_ENCODE_H264_RATE_CONTROL_LAYER_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH264RateControlLayerInfoEXT-initialRcQp-parameter",
|
|
"text": " <code>initialRcQp</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkVideoEncodeH264QpEXT\">VkVideoEncodeH264QpEXT</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH264RateControlLayerInfoEXT-minQp-parameter",
|
|
"text": " <code>minQp</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkVideoEncodeH264QpEXT\">VkVideoEncodeH264QpEXT</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH264RateControlLayerInfoEXT-maxQp-parameter",
|
|
"text": " <code>maxQp</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkVideoEncodeH264QpEXT\">VkVideoEncodeH264QpEXT</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH264RateControlLayerInfoEXT-maxFrameSize-parameter",
|
|
"text": " <code>maxFrameSize</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkVideoEncodeH264FrameSizeEXT\">VkVideoEncodeH264FrameSizeEXT</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkVideoEncodeH265ProfileEXT": {
|
|
"(VK_EXT_video_encode_h265)": [
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH265ProfileEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_VIDEO_ENCODE_H265_PROFILE_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkVideoEncodeH265CapabilitiesEXT": {
|
|
"(VK_EXT_video_encode_h265)": [
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH265CapabilitiesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_VIDEO_ENCODE_H265_CAPABILITIES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkVideoEncodeH265SessionParametersCreateInfoEXT": {
|
|
"(VK_EXT_video_encode_h265)": [
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH265SessionParametersCreateInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_VIDEO_ENCODE_H265_SESSION_PARAMETERS_CREATE_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH265SessionParametersCreateInfoEXT-pParametersAddInfo-parameter",
|
|
"text": " If <code>pParametersAddInfo</code> is not <code>NULL</code>, <code>pParametersAddInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkVideoEncodeH265SessionParametersAddInfoEXT\">VkVideoEncodeH265SessionParametersAddInfoEXT</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkVideoEncodeH265SessionParametersAddInfoEXT": {
|
|
"(VK_EXT_video_encode_h265)": [
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH265SessionParametersAddInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_VIDEO_ENCODE_H265_SESSION_PARAMETERS_ADD_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH265SessionParametersAddInfoEXT-pVpsStd-parameter",
|
|
"text": " If <code>pVpsStd</code> is not <code>NULL</code>, <code>pVpsStd</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>vpsStdCount</code> <code>StdVideoH265VideoParameterSet</code> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH265SessionParametersAddInfoEXT-pSpsStd-parameter",
|
|
"text": " If <code>pSpsStd</code> is not <code>NULL</code>, <code>pSpsStd</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>spsStdCount</code> <code>StdVideoH265SequenceParameterSet</code> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH265SessionParametersAddInfoEXT-pPpsStd-parameter",
|
|
"text": " If <code>pPpsStd</code> is not <code>NULL</code>, <code>pPpsStd</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>ppsStdCount</code> <code>StdVideoH265PictureParameterSet</code> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH265SessionParametersAddInfoEXT-vpsStdCount-arraylength",
|
|
"text": " <code>vpsStdCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH265SessionParametersAddInfoEXT-spsStdCount-arraylength",
|
|
"text": " <code>spsStdCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH265SessionParametersAddInfoEXT-ppsStdCount-arraylength",
|
|
"text": " <code>ppsStdCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH265SessionParametersAddInfoEXT-vpsStdCount-06438",
|
|
"text": " The values of <code>vpsStdCount</code>, <code>spsStdCount</code> and <code>ppsStdCount</code> <strong class=\"purple\">must</strong> be less than or equal to the values of <a href=\"#VkVideoEncodeH265SessionParametersCreateInfoEXT\">VkVideoEncodeH265SessionParametersCreateInfoEXT</a>::<code>maxVpsStdCount</code>, <a href=\"#VkVideoEncodeH265SessionParametersCreateInfoEXT\">VkVideoEncodeH265SessionParametersCreateInfoEXT</a>:<code>maxSpsStdCount</code>, and <a href=\"#VkVideoEncodeH265SessionParametersCreateInfoEXT\">VkVideoEncodeH265SessionParametersCreateInfoEXT</a>:<code>maxPpsStdCount</code>, respectively"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH265SessionParametersAddInfoEXT-pVpsStd-06439",
|
|
"text": " Each <code>StdVideoH265VideoParameterSet</code> entry in <code>pVpsStd</code> <strong class=\"purple\">must</strong> have a unique H.265 VPS ID"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH265SessionParametersAddInfoEXT-pSpsStd-06440",
|
|
"text": " Each <code>StdVideoH265SequenceParameterSet</code> entry in <code>pSpsStd</code> <strong class=\"purple\">must</strong> have a unique H.265 VPS-SPS ID pair"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH265SessionParametersAddInfoEXT-pPpsStd-06441",
|
|
"text": " Each <code>StdVideoH265PictureParameterSet</code> entry in <code>pPpsStd</code> <strong class=\"purple\">must</strong> have a unique H.265 VPS-SPS-PPS ID tuple"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH265SessionParametersAddInfoEXT-None-06442",
|
|
"text": " Each entry to be added <strong class=\"purple\">must</strong> have a unique, to the rest of the parameter array entries and the existing parameters in the Video Session Parameters Object that is being updated, VPS-SPS-PPS IDs"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH265SessionParametersAddInfoEXT-None-06443",
|
|
"text": " Parameter entries that already exist in Video Session Parameters object with a particular VPS-SPS-PPS IDs <strong class=\"purple\">must</strong> not be replaced nor updated"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH265SessionParametersAddInfoEXT-None-06444",
|
|
"text": " When creating a new object using a Video Session Parameters as a template, the array’s parameters with the same VPS-SPS-PPS IDs as the ones from the template take precedence"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH265SessionParametersAddInfoEXT-None-06445",
|
|
"text": " VPS/SPS/PPS parameters <strong class=\"purple\">must</strong> comply with the limits specified in <a href=\"#VkVideoSessionCreateInfoKHR\">VkVideoSessionCreateInfoKHR</a> during Video Session creation"
|
|
}
|
|
]
|
|
},
|
|
"VkVideoEncodeH265VclFrameInfoEXT": {
|
|
"(VK_EXT_video_encode_h265)": [
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH265VclFrameInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_VIDEO_ENCODE_H265_VCL_FRAME_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH265VclFrameInfoEXT-pReferenceFinalLists-parameter",
|
|
"text": " If <code>pReferenceFinalLists</code> is not <code>NULL</code>, <code>pReferenceFinalLists</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkVideoEncodeH265ReferenceListsEXT\">VkVideoEncodeH265ReferenceListsEXT</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH265VclFrameInfoEXT-pNaluSliceSegmentEntries-parameter",
|
|
"text": " <code>pNaluSliceSegmentEntries</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>naluSliceSegmentEntryCount</code> valid <a href=\"#VkVideoEncodeH265NaluSliceSegmentEXT\">VkVideoEncodeH265NaluSliceSegmentEXT</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH265VclFrameInfoEXT-pCurrentPictureInfo-parameter",
|
|
"text": " <code>pCurrentPictureInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <code>StdVideoEncodeH265PictureInfo</code> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH265VclFrameInfoEXT-naluSliceSegmentEntryCount-arraylength",
|
|
"text": " <code>naluSliceSegmentEntryCount</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkVideoEncodeH265NaluSliceSegmentEXT": {
|
|
"(VK_EXT_video_encode_h265)": [
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH265NaluSliceSegmentEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_VIDEO_ENCODE_H265_NALU_SLICE_SEGMENT_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH265NaluSliceSegmentEXT-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH265NaluSliceSegmentEXT-pReferenceFinalLists-parameter",
|
|
"text": " If <code>pReferenceFinalLists</code> is not <code>NULL</code>, <code>pReferenceFinalLists</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkVideoEncodeH265ReferenceListsEXT\">VkVideoEncodeH265ReferenceListsEXT</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH265NaluSliceSegmentEXT-pSliceSegmentHeaderStd-parameter",
|
|
"text": " <code>pSliceSegmentHeaderStd</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <code>StdVideoEncodeH265SliceSegmentHeader</code> value"
|
|
}
|
|
]
|
|
},
|
|
"VkVideoEncodeH265DpbSlotInfoEXT": {
|
|
"(VK_EXT_video_encode_h265)": [
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH265DpbSlotInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_VIDEO_ENCODE_H265_DPB_SLOT_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH265DpbSlotInfoEXT-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH265DpbSlotInfoEXT-pStdReferenceInfo-parameter",
|
|
"text": " <code>pStdReferenceInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <code>StdVideoEncodeH265ReferenceInfo</code> value"
|
|
}
|
|
]
|
|
},
|
|
"VkVideoEncodeH265ReferenceListsEXT": {
|
|
"(VK_EXT_video_encode_h265)": [
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH265ReferenceListsEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_VIDEO_ENCODE_H265_REFERENCE_LISTS_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH265ReferenceListsEXT-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH265ReferenceListsEXT-pReferenceList0Entries-parameter",
|
|
"text": " If <code>referenceList0EntryCount</code> is not <code>0</code>, <code>pReferenceList0Entries</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>referenceList0EntryCount</code> valid <a href=\"#VkVideoEncodeH265DpbSlotInfoEXT\">VkVideoEncodeH265DpbSlotInfoEXT</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH265ReferenceListsEXT-pReferenceList1Entries-parameter",
|
|
"text": " If <code>referenceList1EntryCount</code> is not <code>0</code>, <code>pReferenceList1Entries</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>referenceList1EntryCount</code> valid <a href=\"#VkVideoEncodeH265DpbSlotInfoEXT\">VkVideoEncodeH265DpbSlotInfoEXT</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH265ReferenceListsEXT-pReferenceModifications-parameter",
|
|
"text": " <code>pReferenceModifications</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <code>StdVideoEncodeH265ReferenceModifications</code> value"
|
|
}
|
|
]
|
|
},
|
|
"VkVideoEncodeH265EmitPictureParametersEXT": {
|
|
"(VK_EXT_video_encode_h265)": [
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH265EmitPictureParametersEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_VIDEO_ENCODE_H265_EMIT_PICTURE_PARAMETERS_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH265EmitPictureParametersEXT-ppsIdEntries-parameter",
|
|
"text": " If <code>ppsIdEntryCount</code> is not <code>0</code>, <code>ppsIdEntries</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>ppsIdEntryCount</code> <code>uint8_t</code> values"
|
|
}
|
|
]
|
|
},
|
|
"VkVideoEncodeH265RateControlInfoEXT": {
|
|
"(VK_EXT_video_encode_h265)": [
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH265RateControlInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_VIDEO_ENCODE_H265_RATE_CONTROL_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH265RateControlInfoEXT-rateControlStructure-parameter",
|
|
"text": " <code>rateControlStructure</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkVideoEncodeH265RateControlStructureFlagBitsEXT\">VkVideoEncodeH265RateControlStructureFlagBitsEXT</a> value"
|
|
}
|
|
]
|
|
},
|
|
"VkVideoEncodeH265RateControlLayerInfoEXT": {
|
|
"(VK_EXT_video_encode_h265)": [
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH265RateControlLayerInfoEXT-rateControlMode-06476",
|
|
"text": " When <a href=\"#VkVideoEncodeRateControlInfoKHR\">VkVideoEncodeRateControlInfoKHR</a>::<code>rateControlMode</code> is <code>VK_VIDEO_ENCODE_RATE_CONTROL_MODE_NONE_BIT_KHR</code>, both <code>useMinQp</code> and <code>useMaxQp</code> must be set to <code>VK_TRUE</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH265RateControlLayerInfoEXT-rateControlMode-06477",
|
|
"text": " When <a href=\"#VkVideoEncodeRateControlInfoKHR\">VkVideoEncodeRateControlInfoKHR</a>::<code>rateControlMode</code> is <code>VK_VIDEO_ENCODE_RATE_CONTROL_MODE_NONE_BIT_KHR</code>, the values provided in <code>minQP</code> must be identical to those provided in <code>maxQp</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH265RateControlLayerInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_VIDEO_ENCODE_H265_RATE_CONTROL_LAYER_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH265RateControlLayerInfoEXT-initialRcQp-parameter",
|
|
"text": " <code>initialRcQp</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkVideoEncodeH265QpEXT\">VkVideoEncodeH265QpEXT</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH265RateControlLayerInfoEXT-minQp-parameter",
|
|
"text": " <code>minQp</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkVideoEncodeH265QpEXT\">VkVideoEncodeH265QpEXT</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH265RateControlLayerInfoEXT-maxQp-parameter",
|
|
"text": " <code>maxQp</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkVideoEncodeH265QpEXT\">VkVideoEncodeH265QpEXT</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkVideoEncodeH265RateControlLayerInfoEXT-maxFrameSize-parameter",
|
|
"text": " <code>maxFrameSize</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkVideoEncodeH265FrameSizeEXT\">VkVideoEncodeH265FrameSizeEXT</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"vkEnumerateInstanceLayerProperties": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkEnumerateInstanceLayerProperties-pPropertyCount-parameter",
|
|
"text": " <code>pPropertyCount</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>uint32_t</code> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkEnumerateInstanceLayerProperties-pProperties-parameter",
|
|
"text": " If the value referenced by <code>pPropertyCount</code> is not <code>0</code>, and <code>pProperties</code> is not <code>NULL</code>, <code>pProperties</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>pPropertyCount</code> <a href=\"#VkLayerProperties\">VkLayerProperties</a> structures"
|
|
}
|
|
]
|
|
},
|
|
"vkEnumerateDeviceLayerProperties": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkEnumerateDeviceLayerProperties-physicalDevice-parameter",
|
|
"text": " <code>physicalDevice</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkEnumerateDeviceLayerProperties-pPropertyCount-parameter",
|
|
"text": " <code>pPropertyCount</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>uint32_t</code> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkEnumerateDeviceLayerProperties-pProperties-parameter",
|
|
"text": " If the value referenced by <code>pPropertyCount</code> is not <code>0</code>, and <code>pProperties</code> is not <code>NULL</code>, <code>pProperties</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>pPropertyCount</code> <a href=\"#VkLayerProperties\">VkLayerProperties</a> structures"
|
|
}
|
|
]
|
|
},
|
|
"vkEnumerateInstanceExtensionProperties": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkEnumerateInstanceExtensionProperties-pLayerName-parameter",
|
|
"text": " If <code>pLayerName</code> is not <code>NULL</code>, <code>pLayerName</code> <strong class=\"purple\">must</strong> be a null-terminated UTF-8 string"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkEnumerateInstanceExtensionProperties-pPropertyCount-parameter",
|
|
"text": " <code>pPropertyCount</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>uint32_t</code> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkEnumerateInstanceExtensionProperties-pProperties-parameter",
|
|
"text": " If the value referenced by <code>pPropertyCount</code> is not <code>0</code>, and <code>pProperties</code> is not <code>NULL</code>, <code>pProperties</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>pPropertyCount</code> <a href=\"#VkExtensionProperties\">VkExtensionProperties</a> structures"
|
|
}
|
|
]
|
|
},
|
|
"vkEnumerateDeviceExtensionProperties": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkEnumerateDeviceExtensionProperties-physicalDevice-parameter",
|
|
"text": " <code>physicalDevice</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkEnumerateDeviceExtensionProperties-pLayerName-parameter",
|
|
"text": " If <code>pLayerName</code> is not <code>NULL</code>, <code>pLayerName</code> <strong class=\"purple\">must</strong> be a null-terminated UTF-8 string"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkEnumerateDeviceExtensionProperties-pPropertyCount-parameter",
|
|
"text": " <code>pPropertyCount</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>uint32_t</code> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkEnumerateDeviceExtensionProperties-pProperties-parameter",
|
|
"text": " If the value referenced by <code>pPropertyCount</code> is not <code>0</code>, and <code>pProperties</code> is not <code>NULL</code>, <code>pProperties</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>pPropertyCount</code> <a href=\"#VkExtensionProperties\">VkExtensionProperties</a> structures"
|
|
}
|
|
]
|
|
},
|
|
"vkGetPhysicalDeviceFeatures": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceFeatures-physicalDevice-parameter",
|
|
"text": " <code>physicalDevice</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceFeatures-pFeatures-parameter",
|
|
"text": " <code>pFeatures</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkPhysicalDeviceFeatures\">VkPhysicalDeviceFeatures</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"vkGetPhysicalDeviceFeatures2": {
|
|
"(VK_VERSION_1_1,VK_KHR_get_physical_device_properties2)": [
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceFeatures2-physicalDevice-parameter",
|
|
"text": " <code>physicalDevice</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceFeatures2-pFeatures-parameter",
|
|
"text": " <code>pFeatures</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkPhysicalDeviceFeatures2\">VkPhysicalDeviceFeatures2</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceFeatures2": {
|
|
"(VK_VERSION_1_1,VK_KHR_get_physical_device_properties2)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceFeatures2-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_FEATURES_2</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceVulkan11Features": {
|
|
"(VK_VERSION_1_2)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceVulkan11Features-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_VULKAN_1_1_FEATURES</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceVulkan12Features": {
|
|
"(VK_VERSION_1_2)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceVulkan12Features-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_VULKAN_1_2_FEATURES</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceVulkan13Features": {
|
|
"(VK_VERSION_1_3)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceVulkan13Features-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_VULKAN_1_3_FEATURES</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceVariablePointersFeatures": {
|
|
"(VK_VERSION_1_1,VK_KHR_variable_pointers)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceVariablePointersFeatures-variablePointers-01431",
|
|
"text": " If <code>variablePointers</code> is enabled then <code>variablePointersStorageBuffer</code> <strong class=\"purple\">must</strong> also be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceVariablePointersFeatures-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_VARIABLE_POINTERS_FEATURES</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceMultiviewFeatures": {
|
|
"(VK_VERSION_1_1,VK_KHR_multiview)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceMultiviewFeatures-multiviewGeometryShader-00580",
|
|
"text": " If <code>multiviewGeometryShader</code> is enabled then <code>multiview</code> <strong class=\"purple\">must</strong> also be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceMultiviewFeatures-multiviewTessellationShader-00581",
|
|
"text": " If <code>multiviewTessellationShader</code> is enabled then <code>multiview</code> <strong class=\"purple\">must</strong> also be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceMultiviewFeatures-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_MULTIVIEW_FEATURES</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceShaderAtomicFloatFeaturesEXT": {
|
|
"(VK_EXT_shader_atomic_float)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceShaderAtomicFloatFeaturesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_SHADER_ATOMIC_FLOAT_FEATURES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceShaderAtomicFloat2FeaturesEXT": {
|
|
"(VK_EXT_shader_atomic_float2)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceShaderAtomicFloat2FeaturesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_SHADER_ATOMIC_FLOAT_2_FEATURES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceShaderAtomicInt64Features": {
|
|
"(VK_VERSION_1_2,VK_KHR_shader_atomic_int64)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceShaderAtomicInt64Features-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_SHADER_ATOMIC_INT64_FEATURES</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceShaderImageAtomicInt64FeaturesEXT": {
|
|
"(VK_EXT_shader_image_atomic_int64)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceShaderImageAtomicInt64FeaturesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_SHADER_IMAGE_ATOMIC_INT64_FEATURES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDevice8BitStorageFeatures": {
|
|
"(VK_VERSION_1_2,VK_KHR_8bit_storage)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDevice8BitStorageFeatures-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_8BIT_STORAGE_FEATURES</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDevice16BitStorageFeatures": {
|
|
"(VK_VERSION_1_1,VK_KHR_16bit_storage)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDevice16BitStorageFeatures-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_16BIT_STORAGE_FEATURES</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceShaderFloat16Int8Features": {
|
|
"(VK_VERSION_1_2,VK_KHR_shader_float16_int8)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceShaderFloat16Int8Features-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_SHADER_FLOAT16_INT8_FEATURES</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceShaderClockFeaturesKHR": {
|
|
"(VK_KHR_shader_clock)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceShaderClockFeaturesKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_SHADER_CLOCK_FEATURES_KHR</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceSamplerYcbcrConversionFeatures": {
|
|
"(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceSamplerYcbcrConversionFeatures-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_SAMPLER_YCBCR_CONVERSION_FEATURES</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceProtectedMemoryFeatures": {
|
|
"(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceProtectedMemoryFeatures-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_PROTECTED_MEMORY_FEATURES</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceBlendOperationAdvancedFeaturesEXT": {
|
|
"(VK_EXT_blend_operation_advanced)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceBlendOperationAdvancedFeaturesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_BLEND_OPERATION_ADVANCED_FEATURES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceConditionalRenderingFeaturesEXT": {
|
|
"(VK_EXT_conditional_rendering)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceConditionalRenderingFeaturesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_CONDITIONAL_RENDERING_FEATURES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceShaderDrawParametersFeatures": {
|
|
"(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceShaderDrawParametersFeatures-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_SHADER_DRAW_PARAMETERS_FEATURES</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceMeshShaderFeaturesNV": {
|
|
"(VK_NV_mesh_shader)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceMeshShaderFeaturesNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_MESH_SHADER_FEATURES_NV</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceDescriptorIndexingFeatures": {
|
|
"(VK_VERSION_1_2,VK_EXT_descriptor_indexing)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceDescriptorIndexingFeatures-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_DESCRIPTOR_INDEXING_FEATURES</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceVertexAttributeDivisorFeaturesEXT": {
|
|
"(VK_EXT_vertex_attribute_divisor)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceVertexAttributeDivisorFeaturesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_VERTEX_ATTRIBUTE_DIVISOR_FEATURES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceASTCDecodeFeaturesEXT": {
|
|
"(VK_EXT_astc_decode_mode)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceASTCDecodeFeaturesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_ASTC_DECODE_FEATURES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceTransformFeedbackFeaturesEXT": {
|
|
"(VK_EXT_transform_feedback)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceTransformFeedbackFeaturesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_TRANSFORM_FEEDBACK_FEATURES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceVulkanMemoryModelFeatures": {
|
|
"(VK_VERSION_1_2,VK_KHR_vulkan_memory_model)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceVulkanMemoryModelFeatures-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_VULKAN_MEMORY_MODEL_FEATURES</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceInlineUniformBlockFeatures": {
|
|
"(VK_VERSION_1_3,VK_EXT_inline_uniform_block)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceInlineUniformBlockFeatures-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_INLINE_UNIFORM_BLOCK_FEATURES</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceRepresentativeFragmentTestFeaturesNV": {
|
|
"(VK_NV_representative_fragment_test)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceRepresentativeFragmentTestFeaturesNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_REPRESENTATIVE_FRAGMENT_TEST_FEATURES_NV</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceExclusiveScissorFeaturesNV": {
|
|
"(VK_NV_scissor_exclusive)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceExclusiveScissorFeaturesNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_EXCLUSIVE_SCISSOR_FEATURES_NV</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceCornerSampledImageFeaturesNV": {
|
|
"(VK_NV_corner_sampled_image)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceCornerSampledImageFeaturesNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_CORNER_SAMPLED_IMAGE_FEATURES_NV</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceComputeShaderDerivativesFeaturesNV": {
|
|
"(VK_NV_compute_shader_derivatives)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceComputeShaderDerivativesFeaturesNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_COMPUTE_SHADER_DERIVATIVES_FEATURES_NV</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceFragmentShaderBarycentricFeaturesKHR": {
|
|
"(VK_KHR_fragment_shader_barycentric)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceFragmentShaderBarycentricFeaturesKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_FRAGMENT_SHADER_BARYCENTRIC_FEATURES_KHR</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceShaderImageFootprintFeaturesNV": {
|
|
"(VK_NV_shader_image_footprint)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceShaderImageFootprintFeaturesNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_SHADER_IMAGE_FOOTPRINT_FEATURES_NV</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceShadingRateImageFeaturesNV": {
|
|
"(VK_NV_shading_rate_image)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceShadingRateImageFeaturesNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_SHADING_RATE_IMAGE_FEATURES_NV</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceFragmentDensityMapFeaturesEXT": {
|
|
"(VK_EXT_fragment_density_map)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceFragmentDensityMapFeaturesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_FRAGMENT_DENSITY_MAP_FEATURES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceFragmentDensityMap2FeaturesEXT": {
|
|
"(VK_EXT_fragment_density_map)+(VK_EXT_fragment_density_map2)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceFragmentDensityMap2FeaturesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_FRAGMENT_DENSITY_MAP_2_FEATURES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceFragmentDensityMapOffsetFeaturesQCOM": {
|
|
"(VK_EXT_fragment_density_map)+(VK_QCOM_fragment_density_map_offset)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceFragmentDensityMapOffsetFeaturesQCOM-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_FRAGMENT_DENSITY_MAP_OFFSET_FEATURES_QCOM</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceInvocationMaskFeaturesHUAWEI": {
|
|
"(VK_HUAWEI_invocation_mask)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceInvocationMaskFeaturesHUAWEI-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_INVOCATION_MASK_FEATURES_HUAWEI</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceScalarBlockLayoutFeatures": {
|
|
"(VK_VERSION_1_2,VK_EXT_scalar_block_layout)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceScalarBlockLayoutFeatures-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_SCALAR_BLOCK_LAYOUT_FEATURES</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceUniformBufferStandardLayoutFeatures": {
|
|
"(VK_VERSION_1_2,VK_KHR_uniform_buffer_standard_layout)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceUniformBufferStandardLayoutFeatures-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_UNIFORM_BUFFER_STANDARD_LAYOUT_FEATURES</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceDepthClipEnableFeaturesEXT": {
|
|
"(VK_EXT_depth_clip_enable)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceDepthClipEnableFeaturesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_DEPTH_CLIP_ENABLE_FEATURES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceMemoryPriorityFeaturesEXT": {
|
|
"(VK_EXT_memory_priority)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceMemoryPriorityFeaturesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_MEMORY_PRIORITY_FEATURES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceBufferDeviceAddressFeatures": {
|
|
"(VK_VERSION_1_2,VK_KHR_buffer_device_address)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceBufferDeviceAddressFeatures-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_BUFFER_DEVICE_ADDRESS_FEATURES</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceBufferDeviceAddressFeaturesEXT": {
|
|
"(VK_EXT_buffer_device_address)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceBufferDeviceAddressFeaturesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_BUFFER_DEVICE_ADDRESS_FEATURES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceDedicatedAllocationImageAliasingFeaturesNV": {
|
|
"(VK_NV_dedicated_allocation_image_aliasing)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceDedicatedAllocationImageAliasingFeaturesNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_DEDICATED_ALLOCATION_IMAGE_ALIASING_FEATURES_NV</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceImagelessFramebufferFeatures": {
|
|
"(VK_VERSION_1_2,VK_KHR_imageless_framebuffer)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceImagelessFramebufferFeatures-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_IMAGELESS_FRAMEBUFFER_FEATURES</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceFragmentShaderInterlockFeaturesEXT": {
|
|
"(VK_EXT_fragment_shader_interlock)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceFragmentShaderInterlockFeaturesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_FRAGMENT_SHADER_INTERLOCK_FEATURES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceCooperativeMatrixFeaturesNV": {
|
|
"(VK_NV_cooperative_matrix)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceCooperativeMatrixFeaturesNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_COOPERATIVE_MATRIX_FEATURES_NV</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceYcbcrImageArraysFeaturesEXT": {
|
|
"(VK_EXT_ycbcr_image_arrays)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceYcbcrImageArraysFeaturesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_YCBCR_IMAGE_ARRAYS_FEATURES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceShaderSubgroupExtendedTypesFeatures": {
|
|
"(VK_VERSION_1_1)+(VK_VERSION_1_2,VK_KHR_shader_subgroup_extended_types)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceShaderSubgroupExtendedTypesFeatures-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_SHADER_SUBGROUP_EXTENDED_TYPES_FEATURES</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceHostQueryResetFeatures": {
|
|
"(VK_VERSION_1_2,VK_EXT_host_query_reset)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceHostQueryResetFeatures-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_HOST_QUERY_RESET_FEATURES</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceShaderIntegerFunctions2FeaturesINTEL": {
|
|
"(VK_INTEL_shader_integer_functions2)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceShaderIntegerFunctions2FeaturesINTEL-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_SHADER_INTEGER_FUNCTIONS_2_FEATURES_INTEL</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceCoverageReductionModeFeaturesNV": {
|
|
"(VK_NV_coverage_reduction_mode)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceCoverageReductionModeFeaturesNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_COVERAGE_REDUCTION_MODE_FEATURES_NV</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceTimelineSemaphoreFeatures": {
|
|
"(VK_VERSION_1_2,VK_KHR_timeline_semaphore)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceTimelineSemaphoreFeatures-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_TIMELINE_SEMAPHORE_FEATURES</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceIndexTypeUint8FeaturesEXT": {
|
|
"(VK_EXT_index_type_uint8)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceIndexTypeUint8FeaturesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_INDEX_TYPE_UINT8_FEATURES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDevicePrimitiveTopologyListRestartFeaturesEXT": {
|
|
"(VK_EXT_primitive_topology_list_restart)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDevicePrimitiveTopologyListRestartFeaturesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_PRIMITIVE_TOPOLOGY_LIST_RESTART_FEATURES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceShaderSMBuiltinsFeaturesNV": {
|
|
"(VK_NV_shader_sm_builtins)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceShaderSMBuiltinsFeaturesNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_SHADER_SM_BUILTINS_FEATURES_NV</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceSeparateDepthStencilLayoutsFeatures": {
|
|
"(VK_VERSION_1_2,VK_KHR_separate_depth_stencil_layouts)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceSeparateDepthStencilLayoutsFeatures-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_SEPARATE_DEPTH_STENCIL_LAYOUTS_FEATURES</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDevicePipelineExecutablePropertiesFeaturesKHR": {
|
|
"(VK_KHR_pipeline_executable_properties)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDevicePipelineExecutablePropertiesFeaturesKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_PIPELINE_EXECUTABLE_PROPERTIES_FEATURES_KHR</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceShaderDemoteToHelperInvocationFeatures": {
|
|
"(VK_VERSION_1_3,VK_EXT_shader_demote_to_helper_invocation)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceShaderDemoteToHelperInvocationFeatures-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_SHADER_DEMOTE_TO_HELPER_INVOCATION_FEATURES</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceTexelBufferAlignmentFeaturesEXT": {
|
|
"(VK_EXT_texel_buffer_alignment)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceTexelBufferAlignmentFeaturesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_TEXEL_BUFFER_ALIGNMENT_FEATURES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceTextureCompressionASTCHDRFeatures": {
|
|
"(VK_VERSION_1_3,VK_EXT_texture_compression_astc_hdr)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceTextureCompressionASTCHDRFeatures-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_TEXTURE_COMPRESSION_ASTC_HDR_FEATURES</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceLineRasterizationFeaturesEXT": {
|
|
"(VK_EXT_line_rasterization)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceLineRasterizationFeaturesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_LINE_RASTERIZATION_FEATURES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceSubgroupSizeControlFeatures": {
|
|
"(VK_VERSION_1_3,VK_EXT_subgroup_size_control)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceSubgroupSizeControlFeatures-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_SUBGROUP_SIZE_CONTROL_FEATURES</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceCoherentMemoryFeaturesAMD": {
|
|
"(VK_AMD_device_coherent_memory)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceCoherentMemoryFeaturesAMD-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_COHERENT_MEMORY_FEATURES_AMD</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceAccelerationStructureFeaturesKHR": {
|
|
"(VK_KHR_acceleration_structure)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceAccelerationStructureFeaturesKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_ACCELERATION_STRUCTURE_FEATURES_KHR</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceRayTracingPipelineFeaturesKHR": {
|
|
"(VK_KHR_ray_tracing_pipeline)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceRayTracingPipelineFeaturesKHR-rayTracingPipelineShaderGroupHandleCaptureReplayMixed-03575",
|
|
"text": " If <code>rayTracingPipelineShaderGroupHandleCaptureReplayMixed</code> is <code>VK_TRUE</code>, <code>rayTracingPipelineShaderGroupHandleCaptureReplay</code> <strong class=\"purple\">must</strong> also be <code>VK_TRUE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceRayTracingPipelineFeaturesKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_RAY_TRACING_PIPELINE_FEATURES_KHR</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceRayQueryFeaturesKHR": {
|
|
"(VK_KHR_ray_query)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceRayQueryFeaturesKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_RAY_QUERY_FEATURES_KHR</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceRayTracingMaintenance1FeaturesKHR": {
|
|
"(VK_KHR_ray_tracing_maintenance1)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceRayTracingMaintenance1FeaturesKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_RAY_TRACING_MAINTENANCE_1_FEATURES_KHR</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceExtendedDynamicStateFeaturesEXT": {
|
|
"(VK_EXT_extended_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceExtendedDynamicStateFeaturesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_EXTENDED_DYNAMIC_STATE_FEATURES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceExtendedDynamicState2FeaturesEXT": {
|
|
"(VK_EXT_extended_dynamic_state2)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceExtendedDynamicState2FeaturesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_EXTENDED_DYNAMIC_STATE_2_FEATURES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceDeviceGeneratedCommandsFeaturesNV": {
|
|
"(VK_NV_device_generated_commands)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceDeviceGeneratedCommandsFeaturesNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_DEVICE_GENERATED_COMMANDS_FEATURES_NV</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceDiagnosticsConfigFeaturesNV": {
|
|
"(VK_NV_device_diagnostics_config)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceDiagnosticsConfigFeaturesNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_DIAGNOSTICS_CONFIG_FEATURES_NV</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceDeviceMemoryReportFeaturesEXT": {
|
|
"(VK_EXT_device_memory_report)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceDeviceMemoryReportFeaturesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_DEVICE_MEMORY_REPORT_FEATURES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceGlobalPriorityQueryFeaturesKHR": {
|
|
"(VK_EXT_global_priority_query,VK_KHR_global_priority)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceGlobalPriorityQueryFeaturesKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_GLOBAL_PRIORITY_QUERY_FEATURES_KHR</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDevicePipelineCreationCacheControlFeatures": {
|
|
"(VK_VERSION_1_3,VK_EXT_pipeline_creation_cache_control)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDevicePipelineCreationCacheControlFeatures-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_PIPELINE_CREATION_CACHE_CONTROL_FEATURES</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceZeroInitializeWorkgroupMemoryFeatures": {
|
|
"(VK_VERSION_1_3,VK_KHR_zero_initialize_workgroup_memory)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceZeroInitializeWorkgroupMemoryFeatures-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_ZERO_INITIALIZE_WORKGROUP_MEMORY_FEATURES</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDevicePrivateDataFeatures": {
|
|
"(VK_VERSION_1_3,VK_EXT_private_data)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDevicePrivateDataFeatures-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_PRIVATE_DATA_FEATURES</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceShaderSubgroupUniformControlFlowFeaturesKHR": {
|
|
"(VK_KHR_shader_subgroup_uniform_control_flow)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceShaderSubgroupUniformControlFlowFeaturesKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_SHADER_SUBGROUP_UNIFORM_CONTROL_FLOW_FEATURES_KHR</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceRobustness2FeaturesEXT": {
|
|
"(VK_EXT_robustness2)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceRobustness2FeaturesEXT-robustBufferAccess2-04000",
|
|
"text": " If <code>robustBufferAccess2</code> is enabled then <a href=\"#features-robustBufferAccess\"><code>robustBufferAccess</code></a> <strong class=\"purple\">must</strong> also be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceRobustness2FeaturesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_ROBUSTNESS_2_FEATURES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceImageRobustnessFeatures": {
|
|
"(VK_VERSION_1_3,VK_EXT_image_robustness)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceImageRobustnessFeatures-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_IMAGE_ROBUSTNESS_FEATURES</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceShaderTerminateInvocationFeatures": {
|
|
"(VK_VERSION_1_3,VK_KHR_shader_terminate_invocation)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceShaderTerminateInvocationFeatures-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_SHADER_TERMINATE_INVOCATION_FEATURES</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceCustomBorderColorFeaturesEXT": {
|
|
"(VK_EXT_custom_border_color)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceCustomBorderColorFeaturesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_CUSTOM_BORDER_COLOR_FEATURES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceBorderColorSwizzleFeaturesEXT": {
|
|
"(VK_EXT_border_color_swizzle)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceBorderColorSwizzleFeaturesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_BORDER_COLOR_SWIZZLE_FEATURES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDevicePortabilitySubsetFeaturesKHR": {
|
|
"(VK_KHR_portability_subset)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDevicePortabilitySubsetFeaturesKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_PORTABILITY_SUBSET_FEATURES_KHR</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDevicePerformanceQueryFeaturesKHR": {
|
|
"(VK_KHR_performance_query)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDevicePerformanceQueryFeaturesKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_PERFORMANCE_QUERY_FEATURES_KHR</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDevice4444FormatsFeaturesEXT": {
|
|
"(VK_EXT_4444_formats)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDevice4444FormatsFeaturesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_4444_FORMATS_FEATURES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceMutableDescriptorTypeFeaturesVALVE": {
|
|
"(VK_VALVE_mutable_descriptor_type)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceMutableDescriptorTypeFeaturesVALVE-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_MUTABLE_DESCRIPTOR_TYPE_FEATURES_VALVE</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceDepthClipControlFeaturesEXT": {
|
|
"(VK_EXT_depth_clip_control)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceDepthClipControlFeaturesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_DEPTH_CLIP_CONTROL_FEATURES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceWorkgroupMemoryExplicitLayoutFeaturesKHR": {
|
|
"(VK_KHR_workgroup_memory_explicit_layout)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceWorkgroupMemoryExplicitLayoutFeaturesKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_WORKGROUP_MEMORY_EXPLICIT_LAYOUT_FEATURES_KHR</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceSynchronization2Features": {
|
|
"(VK_VERSION_1_3,VK_KHR_synchronization2)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceSynchronization2Features-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_SYNCHRONIZATION_2_FEATURES</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceVertexInputDynamicStateFeaturesEXT": {
|
|
"(VK_EXT_vertex_input_dynamic_state)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceVertexInputDynamicStateFeaturesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_VERTEX_INPUT_DYNAMIC_STATE_FEATURES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDevicePrimitivesGeneratedQueryFeaturesEXT": {
|
|
"(VK_EXT_primitives_generated_query)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDevicePrimitivesGeneratedQueryFeaturesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_PRIMITIVES_GENERATED_QUERY_FEATURES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceFragmentShadingRateFeaturesKHR": {
|
|
"(VK_KHR_fragment_shading_rate)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceFragmentShadingRateFeaturesKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_FRAGMENT_SHADING_RATE_FEATURES_KHR</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceFragmentShadingRateEnumsFeaturesNV": {
|
|
"(VK_NV_fragment_shading_rate_enums)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceFragmentShadingRateEnumsFeaturesNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_FRAGMENT_SHADING_RATE_ENUMS_FEATURES_NV</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceInheritedViewportScissorFeaturesNV": {
|
|
"(VK_NV_inherited_viewport_scissor)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceInheritedViewportScissorFeaturesNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_INHERITED_VIEWPORT_SCISSOR_FEATURES_NV</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceYcbcr2Plane444FormatsFeaturesEXT": {
|
|
"(VK_EXT_ycbcr_2plane_444_formats)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceYcbcr2Plane444FormatsFeaturesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_YCBCR_2_PLANE_444_FORMATS_FEATURES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceColorWriteEnableFeaturesEXT": {
|
|
"(VK_EXT_color_write_enable)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceColorWriteEnableFeaturesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_COLOR_WRITE_ENABLE_FEATURES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDevicePipelinePropertiesFeaturesEXT": {
|
|
"(VK_EXT_pipeline_properties)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDevicePipelinePropertiesFeaturesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_PIPELINE_PROPERTIES_FEATURES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceProvokingVertexFeaturesEXT": {
|
|
"(VK_EXT_provoking_vertex)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceProvokingVertexFeaturesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_PROVOKING_VERTEX_FEATURES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDevicePageableDeviceLocalMemoryFeaturesEXT": {
|
|
"(VK_EXT_pageable_device_local_memory)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDevicePageableDeviceLocalMemoryFeaturesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_PAGEABLE_DEVICE_LOCAL_MEMORY_FEATURES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceMultiDrawFeaturesEXT": {
|
|
"(VK_EXT_multi_draw)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceMultiDrawFeaturesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_MULTI_DRAW_FEATURES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceRayTracingMotionBlurFeaturesNV": {
|
|
"(VK_NV_ray_tracing_motion_blur)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceRayTracingMotionBlurFeaturesNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_RAY_TRACING_MOTION_BLUR_FEATURES_NV</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceSubpassShadingFeaturesHUAWEI": {
|
|
"(VK_HUAWEI_subpass_shading)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceSubpassShadingFeaturesHUAWEI-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_SUBPASS_SHADING_FEATURES_HUAWEI</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceExternalMemoryRDMAFeaturesNV": {
|
|
"(VK_NV_external_memory_rdma)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceExternalMemoryRDMAFeaturesNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_EXTERNAL_MEMORY_RDMA_FEATURES_NV</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDevicePresentIdFeaturesKHR": {
|
|
"(VK_KHR_present_id)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDevicePresentIdFeaturesKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_PRESENT_ID_FEATURES_KHR</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDevicePresentWaitFeaturesKHR": {
|
|
"(VK_KHR_present_wait)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDevicePresentWaitFeaturesKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_PRESENT_WAIT_FEATURES_KHR</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceShaderIntegerDotProductFeatures": {
|
|
"(VK_VERSION_1_3,VK_KHR_shader_integer_dot_product)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceShaderIntegerDotProductFeatures-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_SHADER_INTEGER_DOT_PRODUCT_FEATURES</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceMaintenance4Features": {
|
|
"(VK_VERSION_1_3,VK_KHR_maintenance4)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceMaintenance4Features-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_MAINTENANCE_4_FEATURES</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceDynamicRenderingFeatures": {
|
|
"(VK_VERSION_1_3,VK_KHR_dynamic_rendering)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceDynamicRenderingFeatures-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_DYNAMIC_RENDERING_FEATURES</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceRGBA10X6FormatsFeaturesEXT": {
|
|
"(VK_EXT_rgba10x6_formats)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceRGBA10X6FormatsFeaturesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_RGBA10X6_FORMATS_FEATURES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDevicePipelineRobustnessFeaturesEXT": {
|
|
"(VK_EXT_pipeline_robustness)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDevicePipelineRobustnessFeaturesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_PIPELINE_ROBUSTNESS_FEATURES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceImageViewMinLodFeaturesEXT": {
|
|
"(VK_EXT_image_view_min_lod)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceImageViewMinLodFeaturesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_IMAGE_VIEW_MIN_LOD_FEATURES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceRasterizationOrderAttachmentAccessFeaturesARM": {
|
|
"(VK_ARM_rasterization_order_attachment_access)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceRasterizationOrderAttachmentAccessFeaturesARM-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_RASTERIZATION_ORDER_ATTACHMENT_ACCESS_FEATURES_ARM</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceSubpassMergeFeedbackFeaturesEXT": {
|
|
"(VK_EXT_subpass_merge_feedback)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceSubpassMergeFeedbackFeaturesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_SUBPASS_MERGE_FEEDBACK_FEATURES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceLinearColorAttachmentFeaturesNV": {
|
|
"(VK_NV_linear_color_attachment)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceLinearColorAttachmentFeaturesNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_LINEAR_COLOR_ATTACHMENT_FEATURES_NV</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceAttachmentFeedbackLoopLayoutFeaturesEXT": {
|
|
"(VK_EXT_attachment_feedback_loop_layout)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceAttachmentFeedbackLoopLayoutFeaturesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_ATTACHMENT_FEEDBACK_LOOP_LAYOUT_FEATURES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceGraphicsPipelineLibraryFeaturesEXT": {
|
|
"(VK_EXT_graphics_pipeline_library)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceGraphicsPipelineLibraryFeaturesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_GRAPHICS_PIPELINE_LIBRARY_FEATURES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceMultisampledRenderToSingleSampledFeaturesEXT": {
|
|
"(VK_EXT_multisampled_render_to_single_sampled)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceMultisampledRenderToSingleSampledFeaturesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_MULTISAMPLED_RENDER_TO_SINGLE_SAMPLED_FEATURES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceImage2DViewOf3DFeaturesEXT": {
|
|
"(VK_EXT_image_2d_view_of_3d)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceImage2DViewOf3DFeaturesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_IMAGE_2D_VIEW_OF_3D_FEATURES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceImageCompressionControlFeaturesEXT": {
|
|
"(VK_EXT_image_compression_control)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceImageCompressionControlFeaturesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_IMAGE_COMPRESSION_CONTROL_FEATURES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceImageCompressionControlSwapchainFeaturesEXT": {
|
|
"(VK_EXT_image_compression_control)+(VK_EXT_image_compression_control_swapchain)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceImageCompressionControlSwapchainFeaturesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_IMAGE_COMPRESSION_CONTROL_SWAPCHAIN_FEATURES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceShaderEarlyAndLateFragmentTestsFeaturesAMD": {
|
|
"(VK_AMD_shader_early_and_late_fragment_tests)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceShaderEarlyAndLateFragmentTestsFeaturesAMD-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_SHADER_EARLY_AND_LATE_FRAGMENT_TESTS_FEATURES_AMD</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceNonSeamlessCubeMapFeaturesEXT": {
|
|
"(VK_EXT_non_seamless_cube_map)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceNonSeamlessCubeMapFeaturesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_NON_SEAMLESS_CUBE_MAP_FEATURES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceShaderModuleIdentifierFeaturesEXT": {
|
|
"(VK_EXT_shader_module_identifier)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceShaderModuleIdentifierFeaturesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_SHADER_MODULE_IDENTIFIER_FEATURES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceTilePropertiesFeaturesQCOM": {
|
|
"(VK_QCOM_tile_properties)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceTilePropertiesFeaturesQCOM-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_TILE_PROPERTIES_FEATURES_QCOM</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceImageProcessingFeaturesQCOM": {
|
|
"(VK_QCOM_image_processing)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceImageProcessingFeaturesQCOM-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_IMAGE_PROCESSING_FEATURES_QCOM</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDevicePushDescriptorPropertiesKHR": {
|
|
"(VK_KHR_push_descriptor)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDevicePushDescriptorPropertiesKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_PUSH_DESCRIPTOR_PROPERTIES_KHR</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceMultiviewProperties": {
|
|
"(VK_VERSION_1_1,VK_KHR_multiview)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceMultiviewProperties-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_MULTIVIEW_PROPERTIES</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceFloatControlsProperties": {
|
|
"(VK_VERSION_1_2,VK_KHR_shader_float_controls)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceFloatControlsProperties-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_FLOAT_CONTROLS_PROPERTIES</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceDiscardRectanglePropertiesEXT": {
|
|
"(VK_EXT_discard_rectangles)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceDiscardRectanglePropertiesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_DISCARD_RECTANGLE_PROPERTIES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceSampleLocationsPropertiesEXT": {
|
|
"(VK_EXT_sample_locations)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceSampleLocationsPropertiesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_SAMPLE_LOCATIONS_PROPERTIES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceExternalMemoryHostPropertiesEXT": {
|
|
"(VK_EXT_external_memory_host)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceExternalMemoryHostPropertiesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_EXTERNAL_MEMORY_HOST_PROPERTIES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceMultiviewPerViewAttributesPropertiesNVX": {
|
|
"(VK_NVX_multiview_per_view_attributes)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceMultiviewPerViewAttributesPropertiesNVX-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_MULTIVIEW_PER_VIEW_ATTRIBUTES_PROPERTIES_NVX</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDevicePointClippingProperties": {
|
|
"(VK_VERSION_1_1,VK_KHR_maintenance2)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDevicePointClippingProperties-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_POINT_CLIPPING_PROPERTIES</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceSubgroupProperties": {
|
|
"(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceSubgroupProperties-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_SUBGROUP_PROPERTIES</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceSubgroupSizeControlProperties": {
|
|
"(VK_VERSION_1_1)+(VK_VERSION_1_3,VK_EXT_subgroup_size_control)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceSubgroupSizeControlProperties-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_SUBGROUP_SIZE_CONTROL_PROPERTIES</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceBlendOperationAdvancedPropertiesEXT": {
|
|
"(VK_EXT_blend_operation_advanced)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceBlendOperationAdvancedPropertiesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_BLEND_OPERATION_ADVANCED_PROPERTIES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceVertexAttributeDivisorPropertiesEXT": {
|
|
"(VK_EXT_vertex_attribute_divisor)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceVertexAttributeDivisorPropertiesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_VERTEX_ATTRIBUTE_DIVISOR_PROPERTIES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceSamplerFilterMinmaxProperties": {
|
|
"(VK_VERSION_1_2,VK_EXT_sampler_filter_minmax)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceSamplerFilterMinmaxProperties-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_SAMPLER_FILTER_MINMAX_PROPERTIES</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceProtectedMemoryProperties": {
|
|
"(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceProtectedMemoryProperties-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_PROTECTED_MEMORY_PROPERTIES</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceMaintenance3Properties": {
|
|
"(VK_VERSION_1_1,VK_KHR_maintenance3)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceMaintenance3Properties-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_MAINTENANCE_3_PROPERTIES</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceMaintenance4Properties": {
|
|
"(VK_VERSION_1_3,VK_KHR_maintenance4)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceMaintenance4Properties-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_MAINTENANCE_4_PROPERTIES</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceMeshShaderPropertiesNV": {
|
|
"(VK_NV_mesh_shader)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceMeshShaderPropertiesNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_MESH_SHADER_PROPERTIES_NV</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceDescriptorIndexingProperties": {
|
|
"(VK_VERSION_1_2,VK_EXT_descriptor_indexing)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceDescriptorIndexingProperties-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_DESCRIPTOR_INDEXING_PROPERTIES</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceInlineUniformBlockProperties": {
|
|
"(VK_VERSION_1_3,VK_EXT_inline_uniform_block)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceInlineUniformBlockProperties-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_INLINE_UNIFORM_BLOCK_PROPERTIES</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceConservativeRasterizationPropertiesEXT": {
|
|
"(VK_EXT_conservative_rasterization)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceConservativeRasterizationPropertiesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_CONSERVATIVE_RASTERIZATION_PROPERTIES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceFragmentDensityMapPropertiesEXT": {
|
|
"(VK_EXT_fragment_density_map)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceFragmentDensityMapPropertiesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_FRAGMENT_DENSITY_MAP_PROPERTIES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceFragmentDensityMap2PropertiesEXT": {
|
|
"(VK_EXT_fragment_density_map)+(VK_EXT_fragment_density_map2)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceFragmentDensityMap2PropertiesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_FRAGMENT_DENSITY_MAP_2_PROPERTIES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceFragmentDensityMapOffsetPropertiesQCOM": {
|
|
"(VK_EXT_fragment_density_map)+(VK_QCOM_fragment_density_map_offset)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceFragmentDensityMapOffsetPropertiesQCOM-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_FRAGMENT_DENSITY_MAP_OFFSET_PROPERTIES_QCOM</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceShaderCorePropertiesAMD": {
|
|
"(VK_AMD_shader_core_properties)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceShaderCorePropertiesAMD-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_SHADER_CORE_PROPERTIES_AMD</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceShaderCoreProperties2AMD": {
|
|
"(VK_AMD_shader_core_properties2)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceShaderCoreProperties2AMD-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_SHADER_CORE_PROPERTIES_2_AMD</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceDepthStencilResolveProperties": {
|
|
"(VK_VERSION_1_2,VK_KHR_depth_stencil_resolve)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceDepthStencilResolveProperties-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_DEPTH_STENCIL_RESOLVE_PROPERTIES</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDevicePerformanceQueryPropertiesKHR": {
|
|
"(VK_KHR_performance_query)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDevicePerformanceQueryPropertiesKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_PERFORMANCE_QUERY_PROPERTIES_KHR</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceShadingRateImagePropertiesNV": {
|
|
"(VK_NV_shading_rate_image)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceShadingRateImagePropertiesNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_SHADING_RATE_IMAGE_PROPERTIES_NV</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceTransformFeedbackPropertiesEXT": {
|
|
"(VK_EXT_transform_feedback)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceTransformFeedbackPropertiesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_TRANSFORM_FEEDBACK_PROPERTIES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceRayTracingPropertiesNV": {
|
|
"(VK_NV_ray_tracing)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceRayTracingPropertiesNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_RAY_TRACING_PROPERTIES_NV</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceAccelerationStructurePropertiesKHR": {
|
|
"(VK_KHR_acceleration_structure)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceAccelerationStructurePropertiesKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_ACCELERATION_STRUCTURE_PROPERTIES_KHR</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceRayTracingPipelinePropertiesKHR": {
|
|
"(VK_KHR_ray_tracing_pipeline)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceRayTracingPipelinePropertiesKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_RAY_TRACING_PIPELINE_PROPERTIES_KHR</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceCooperativeMatrixPropertiesNV": {
|
|
"(VK_NV_cooperative_matrix)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceCooperativeMatrixPropertiesNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_COOPERATIVE_MATRIX_PROPERTIES_NV</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceShaderSMBuiltinsPropertiesNV": {
|
|
"(VK_NV_shader_sm_builtins)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceShaderSMBuiltinsPropertiesNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_SHADER_SM_BUILTINS_PROPERTIES_NV</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceTexelBufferAlignmentProperties": {
|
|
"(VK_VERSION_1_3,VK_EXT_texel_buffer_alignment)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceTexelBufferAlignmentProperties-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_TEXEL_BUFFER_ALIGNMENT_PROPERTIES</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceTimelineSemaphoreProperties": {
|
|
"(VK_VERSION_1_2,VK_KHR_timeline_semaphore)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceTimelineSemaphoreProperties-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_TIMELINE_SEMAPHORE_PROPERTIES</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceLineRasterizationPropertiesEXT": {
|
|
"(VK_EXT_line_rasterization)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceLineRasterizationPropertiesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_LINE_RASTERIZATION_PROPERTIES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceRobustness2PropertiesEXT": {
|
|
"(VK_EXT_robustness2)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceRobustness2PropertiesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_ROBUSTNESS_2_PROPERTIES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceDeviceGeneratedCommandsPropertiesNV": {
|
|
"(VK_NV_device_generated_commands)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceDeviceGeneratedCommandsPropertiesNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_DEVICE_GENERATED_COMMANDS_PROPERTIES_NV</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDevicePortabilitySubsetPropertiesKHR": {
|
|
"(VK_KHR_portability_subset)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDevicePortabilitySubsetPropertiesKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_PORTABILITY_SUBSET_PROPERTIES_KHR</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceFragmentShadingRatePropertiesKHR": {
|
|
"(VK_KHR_fragment_shading_rate)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceFragmentShadingRatePropertiesKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_FRAGMENT_SHADING_RATE_PROPERTIES_KHR</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceFragmentShadingRateEnumsPropertiesNV": {
|
|
"(VK_NV_fragment_shading_rate_enums)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceFragmentShadingRateEnumsPropertiesNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_FRAGMENT_SHADING_RATE_ENUMS_PROPERTIES_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceFragmentShadingRateEnumsPropertiesNV-maxFragmentShadingRateInvocationCount-parameter",
|
|
"text": " <code>maxFragmentShadingRateInvocationCount</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSampleCountFlagBits\">VkSampleCountFlagBits</a> value"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceCustomBorderColorPropertiesEXT": {
|
|
"(VK_EXT_custom_border_color)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceCustomBorderColorPropertiesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_CUSTOM_BORDER_COLOR_PROPERTIES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceProvokingVertexPropertiesEXT": {
|
|
"(VK_EXT_provoking_vertex)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceProvokingVertexPropertiesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_PROVOKING_VERTEX_PROPERTIES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceSubpassShadingPropertiesHUAWEI": {
|
|
"(VK_HUAWEI_subpass_shading)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceSubpassShadingPropertiesHUAWEI-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_SUBPASS_SHADING_PROPERTIES_HUAWEI</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceMultiDrawPropertiesEXT": {
|
|
"(VK_EXT_multi_draw)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceMultiDrawPropertiesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_MULTI_DRAW_PROPERTIES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceGraphicsPipelineLibraryPropertiesEXT": {
|
|
"(VK_EXT_graphics_pipeline_library)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceGraphicsPipelineLibraryPropertiesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_GRAPHICS_PIPELINE_LIBRARY_PROPERTIES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceFragmentShaderBarycentricPropertiesKHR": {
|
|
"(VK_KHR_fragment_shader_barycentric)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceFragmentShaderBarycentricPropertiesKHR-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_FRAGMENT_SHADER_BARYCENTRIC_PROPERTIES_KHR</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceShaderModuleIdentifierPropertiesEXT": {
|
|
"(VK_EXT_shader_module_identifier)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceShaderModuleIdentifierPropertiesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_SHADER_MODULE_IDENTIFIER_PROPERTIES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDevicePipelineRobustnessPropertiesEXT": {
|
|
"(VK_EXT_pipeline_robustness)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDevicePipelineRobustnessPropertiesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_PIPELINE_ROBUSTNESS_PROPERTIES_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetPhysicalDeviceMultisamplePropertiesEXT": {
|
|
"(VK_EXT_sample_locations)": [
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceMultisamplePropertiesEXT-physicalDevice-parameter",
|
|
"text": " <code>physicalDevice</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceMultisamplePropertiesEXT-samples-parameter",
|
|
"text": " <code>samples</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSampleCountFlagBits\">VkSampleCountFlagBits</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceMultisamplePropertiesEXT-pMultisampleProperties-parameter",
|
|
"text": " <code>pMultisampleProperties</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkMultisamplePropertiesEXT\">VkMultisamplePropertiesEXT</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkMultisamplePropertiesEXT": {
|
|
"(VK_EXT_sample_locations)": [
|
|
{
|
|
"vuid": "VUID-VkMultisamplePropertiesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_MULTISAMPLE_PROPERTIES_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkMultisamplePropertiesEXT-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetPhysicalDeviceFormatProperties": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceFormatProperties-physicalDevice-parameter",
|
|
"text": " <code>physicalDevice</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceFormatProperties-format-parameter",
|
|
"text": " <code>format</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkFormat\">VkFormat</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceFormatProperties-pFormatProperties-parameter",
|
|
"text": " <code>pFormatProperties</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkFormatProperties\">VkFormatProperties</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"vkGetPhysicalDeviceFormatProperties2": {
|
|
"(VK_VERSION_1_1,VK_KHR_get_physical_device_properties2)": [
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceFormatProperties2-physicalDevice-parameter",
|
|
"text": " <code>physicalDevice</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceFormatProperties2-format-parameter",
|
|
"text": " <code>format</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkFormat\">VkFormat</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceFormatProperties2-pFormatProperties-parameter",
|
|
"text": " <code>pFormatProperties</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkFormatProperties2\">VkFormatProperties2</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkFormatProperties2": {
|
|
"(VK_VERSION_1_1,VK_KHR_get_physical_device_properties2)": [
|
|
{
|
|
"vuid": "VUID-VkFormatProperties2-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_FORMAT_PROPERTIES_2</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFormatProperties2-pNext-pNext",
|
|
"text": " Each <code>pNext</code> member of any structure (including this one) in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be either <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkDrmFormatModifierPropertiesList2EXT\">VkDrmFormatModifierPropertiesList2EXT</a>, <a href=\"#VkDrmFormatModifierPropertiesListEXT\">VkDrmFormatModifierPropertiesListEXT</a>, <a href=\"#VkFormatProperties3\">VkFormatProperties3</a>, or <a href=\"#VkSubpassResolvePerformanceQueryEXT\">VkSubpassResolvePerformanceQueryEXT</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFormatProperties2-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
}
|
|
]
|
|
},
|
|
"VkDrmFormatModifierPropertiesListEXT": {
|
|
"(VK_VERSION_1_1,VK_KHR_get_physical_device_properties2)+(VK_EXT_image_drm_format_modifier)": [
|
|
{
|
|
"vuid": "VUID-VkDrmFormatModifierPropertiesListEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_DRM_FORMAT_MODIFIER_PROPERTIES_LIST_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkDrmFormatModifierPropertiesList2EXT": {
|
|
"(VK_VERSION_1_1,VK_KHR_get_physical_device_properties2)+(VK_EXT_image_drm_format_modifier)+(VK_VERSION_1_3,VK_KHR_format_feature_flags2)": [
|
|
{
|
|
"vuid": "VUID-VkDrmFormatModifierPropertiesList2EXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_DRM_FORMAT_MODIFIER_PROPERTIES_LIST_2_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkFormatProperties3": {
|
|
"(VK_VERSION_1_1,VK_KHR_get_physical_device_properties2)+(VK_VERSION_1_3,VK_KHR_format_feature_flags2)": [
|
|
{
|
|
"vuid": "VUID-VkFormatProperties3-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_FORMAT_PROPERTIES_3</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkSubpassResolvePerformanceQueryEXT": {
|
|
"(VK_EXT_multisampled_render_to_single_sampled)": [
|
|
{
|
|
"vuid": "VUID-VkSubpassResolvePerformanceQueryEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_SUBPASS_RESOLVE_PERFORMANCE_QUERY_EXT</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetPhysicalDeviceImageFormatProperties": {
|
|
"(VK_EXT_image_drm_format_modifier)": [
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceImageFormatProperties-tiling-02248",
|
|
"text": " <code>tiling</code> <strong class=\"purple\">must</strong> not be <code>VK_IMAGE_TILING_DRM_FORMAT_MODIFIER_EXT</code>. (Use <a href=\"#vkGetPhysicalDeviceImageFormatProperties2\">vkGetPhysicalDeviceImageFormatProperties2</a> instead)"
|
|
}
|
|
],
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceImageFormatProperties-physicalDevice-parameter",
|
|
"text": " <code>physicalDevice</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceImageFormatProperties-format-parameter",
|
|
"text": " <code>format</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkFormat\">VkFormat</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceImageFormatProperties-type-parameter",
|
|
"text": " <code>type</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageType\">VkImageType</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceImageFormatProperties-tiling-parameter",
|
|
"text": " <code>tiling</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageTiling\">VkImageTiling</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceImageFormatProperties-usage-parameter",
|
|
"text": " <code>usage</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkImageUsageFlagBits\">VkImageUsageFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceImageFormatProperties-usage-requiredbitmask",
|
|
"text": " <code>usage</code> <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceImageFormatProperties-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkImageCreateFlagBits\">VkImageCreateFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceImageFormatProperties-pImageFormatProperties-parameter",
|
|
"text": " <code>pImageFormatProperties</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkImageFormatProperties\">VkImageFormatProperties</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"vkGetPhysicalDeviceExternalImageFormatPropertiesNV": {
|
|
"(VK_NV_external_memory_capabilities)": [
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceExternalImageFormatPropertiesNV-physicalDevice-parameter",
|
|
"text": " <code>physicalDevice</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceExternalImageFormatPropertiesNV-format-parameter",
|
|
"text": " <code>format</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkFormat\">VkFormat</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceExternalImageFormatPropertiesNV-type-parameter",
|
|
"text": " <code>type</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageType\">VkImageType</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceExternalImageFormatPropertiesNV-tiling-parameter",
|
|
"text": " <code>tiling</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageTiling\">VkImageTiling</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceExternalImageFormatPropertiesNV-usage-parameter",
|
|
"text": " <code>usage</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkImageUsageFlagBits\">VkImageUsageFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceExternalImageFormatPropertiesNV-usage-requiredbitmask",
|
|
"text": " <code>usage</code> <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceExternalImageFormatPropertiesNV-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkImageCreateFlagBits\">VkImageCreateFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceExternalImageFormatPropertiesNV-externalHandleType-parameter",
|
|
"text": " <code>externalHandleType</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkExternalMemoryHandleTypeFlagBitsNV\">VkExternalMemoryHandleTypeFlagBitsNV</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceExternalImageFormatPropertiesNV-pExternalImageFormatProperties-parameter",
|
|
"text": " <code>pExternalImageFormatProperties</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkExternalImageFormatPropertiesNV\">VkExternalImageFormatPropertiesNV</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"vkGetPhysicalDeviceImageFormatProperties2": {
|
|
"(VK_VERSION_1_1,VK_KHR_get_physical_device_properties2)+(VK_ANDROID_external_memory_android_hardware_buffer)": [
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceImageFormatProperties2-pNext-01868",
|
|
"text": " If the <code>pNext</code> chain of <code>pImageFormatProperties</code> includes a <a href=\"#VkAndroidHardwareBufferUsageANDROID\">VkAndroidHardwareBufferUsageANDROID</a> structure, the <code>pNext</code> chain of <code>pImageFormatInfo</code> <strong class=\"purple\">must</strong> include a <a href=\"#VkPhysicalDeviceExternalImageFormatInfo\">VkPhysicalDeviceExternalImageFormatInfo</a> structure with <code>handleType</code> set to <code>VK_EXTERNAL_MEMORY_HANDLE_TYPE_ANDROID_HARDWARE_BUFFER_BIT_ANDROID</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_get_physical_device_properties2)": [
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceImageFormatProperties2-physicalDevice-parameter",
|
|
"text": " <code>physicalDevice</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceImageFormatProperties2-pImageFormatInfo-parameter",
|
|
"text": " <code>pImageFormatInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkPhysicalDeviceImageFormatInfo2\">VkPhysicalDeviceImageFormatInfo2</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceImageFormatProperties2-pImageFormatProperties-parameter",
|
|
"text": " <code>pImageFormatProperties</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkImageFormatProperties2\">VkImageFormatProperties2</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceImageFormatInfo2": {
|
|
"(VK_VERSION_1_1,VK_KHR_get_physical_device_properties2)+(VK_EXT_image_drm_format_modifier)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceImageFormatInfo2-tiling-02249",
|
|
"text": " <code>tiling</code> <strong class=\"purple\">must</strong> be <code>VK_IMAGE_TILING_DRM_FORMAT_MODIFIER_EXT</code> if and only if the <code>pNext</code> chain includes <a href=\"#VkPhysicalDeviceImageDrmFormatModifierInfoEXT\">VkPhysicalDeviceImageDrmFormatModifierInfoEXT</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceImageFormatInfo2-tiling-02313",
|
|
"text": " If <code>tiling</code> is <code>VK_IMAGE_TILING_DRM_FORMAT_MODIFIER_EXT</code> and <code>flags</code> contains <code>VK_IMAGE_CREATE_MUTABLE_FORMAT_BIT</code>, then the <code>pNext</code> chain <strong class=\"purple\">must</strong> include a <a href=\"#VkImageFormatListCreateInfo\">VkImageFormatListCreateInfo</a> structure with non-zero <code>viewFormatCount</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1,VK_KHR_get_physical_device_properties2)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceImageFormatInfo2-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_IMAGE_FORMAT_INFO_2</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceImageFormatInfo2-pNext-pNext",
|
|
"text": " Each <code>pNext</code> member of any structure (including this one) in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be either <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkImageCompressionControlEXT\">VkImageCompressionControlEXT</a>, <a href=\"#VkImageFormatListCreateInfo\">VkImageFormatListCreateInfo</a>, <a href=\"#VkImageStencilUsageCreateInfo\">VkImageStencilUsageCreateInfo</a>, <a href=\"#VkPhysicalDeviceExternalImageFormatInfo\">VkPhysicalDeviceExternalImageFormatInfo</a>, <a href=\"#VkPhysicalDeviceImageDrmFormatModifierInfoEXT\">VkPhysicalDeviceImageDrmFormatModifierInfoEXT</a>, <a href=\"#VkPhysicalDeviceImageViewImageFormatInfoEXT\">VkPhysicalDeviceImageViewImageFormatInfoEXT</a>, or <a href=\"#VkVideoProfilesKHR\">VkVideoProfilesKHR</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceImageFormatInfo2-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceImageFormatInfo2-format-parameter",
|
|
"text": " <code>format</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkFormat\">VkFormat</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceImageFormatInfo2-type-parameter",
|
|
"text": " <code>type</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageType\">VkImageType</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceImageFormatInfo2-tiling-parameter",
|
|
"text": " <code>tiling</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageTiling\">VkImageTiling</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceImageFormatInfo2-usage-parameter",
|
|
"text": " <code>usage</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkImageUsageFlagBits\">VkImageUsageFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceImageFormatInfo2-usage-requiredbitmask",
|
|
"text": " <code>usage</code> <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceImageFormatInfo2-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkImageCreateFlagBits\">VkImageCreateFlagBits</a> values"
|
|
}
|
|
]
|
|
},
|
|
"VkImageFormatProperties2": {
|
|
"(VK_VERSION_1_1,VK_KHR_get_physical_device_properties2)": [
|
|
{
|
|
"vuid": "VUID-VkImageFormatProperties2-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_IMAGE_FORMAT_PROPERTIES_2</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageFormatProperties2-pNext-pNext",
|
|
"text": " Each <code>pNext</code> member of any structure (including this one) in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be either <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkAndroidHardwareBufferUsageANDROID\">VkAndroidHardwareBufferUsageANDROID</a>, <a href=\"#VkExternalImageFormatProperties\">VkExternalImageFormatProperties</a>, <a href=\"#VkFilterCubicImageViewImageFormatPropertiesEXT\">VkFilterCubicImageViewImageFormatPropertiesEXT</a>, <a href=\"#VkImageCompressionPropertiesEXT\">VkImageCompressionPropertiesEXT</a>, <a href=\"#VkSamplerYcbcrConversionImageFormatProperties\">VkSamplerYcbcrConversionImageFormatProperties</a>, or <a href=\"#VkTextureLODGatherFormatPropertiesAMD\">VkTextureLODGatherFormatPropertiesAMD</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkImageFormatProperties2-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
}
|
|
]
|
|
},
|
|
"VkTextureLODGatherFormatPropertiesAMD": {
|
|
"(VK_VERSION_1_1,VK_KHR_get_physical_device_properties2)+(VK_AMD_texture_gather_bias_lod)": [
|
|
{
|
|
"vuid": "VUID-VkTextureLODGatherFormatPropertiesAMD-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_TEXTURE_LOD_GATHER_FORMAT_PROPERTIES_AMD</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceExternalImageFormatInfo": {
|
|
"(VK_VERSION_1_1,VK_KHR_get_physical_device_properties2)+(VK_VERSION_1_1,VK_KHR_external_memory_capabilities)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceExternalImageFormatInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_EXTERNAL_IMAGE_FORMAT_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceExternalImageFormatInfo-handleType-parameter",
|
|
"text": " If <code>handleType</code> is not <code>0</code>, <code>handleType</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkExternalMemoryHandleTypeFlagBits\">VkExternalMemoryHandleTypeFlagBits</a> value"
|
|
}
|
|
]
|
|
},
|
|
"VkExternalImageFormatProperties": {
|
|
"(VK_VERSION_1_1,VK_KHR_get_physical_device_properties2)+(VK_VERSION_1_1,VK_KHR_external_memory_capabilities)": [
|
|
{
|
|
"vuid": "VUID-VkExternalImageFormatProperties-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_EXTERNAL_IMAGE_FORMAT_PROPERTIES</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceImageDrmFormatModifierInfoEXT": {
|
|
"(VK_VERSION_1_1,VK_KHR_get_physical_device_properties2)+(VK_EXT_image_drm_format_modifier)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceImageDrmFormatModifierInfoEXT-sharingMode-02314",
|
|
"text": " If <code>sharingMode</code> is <code>VK_SHARING_MODE_CONCURRENT</code>, then <code>pQueueFamilyIndices</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>queueFamilyIndexCount</code> <code>uint32_t</code> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceImageDrmFormatModifierInfoEXT-sharingMode-02315",
|
|
"text": " If <code>sharingMode</code> is <code>VK_SHARING_MODE_CONCURRENT</code>, then <code>queueFamilyIndexCount</code> <strong class=\"purple\">must</strong> be greater than <code>1</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceImageDrmFormatModifierInfoEXT-sharingMode-02316",
|
|
"text": " If <code>sharingMode</code> is <code>VK_SHARING_MODE_CONCURRENT</code>, each element of <code>pQueueFamilyIndices</code> <strong class=\"purple\">must</strong> be unique and <strong class=\"purple\">must</strong> be less than the <code>pQueueFamilyPropertyCount</code> returned by <a href=\"#vkGetPhysicalDeviceQueueFamilyProperties2\">vkGetPhysicalDeviceQueueFamilyProperties2</a> for the <code>physicalDevice</code> that was used to create <code>device</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceImageDrmFormatModifierInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_IMAGE_DRM_FORMAT_MODIFIER_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceImageDrmFormatModifierInfoEXT-sharingMode-parameter",
|
|
"text": " <code>sharingMode</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkSharingMode\">VkSharingMode</a> value"
|
|
}
|
|
]
|
|
},
|
|
"VkSamplerYcbcrConversionImageFormatProperties": {
|
|
"(VK_VERSION_1_1,VK_KHR_get_physical_device_properties2)+(VK_VERSION_1_1,VK_KHR_sampler_ycbcr_conversion)": [
|
|
{
|
|
"vuid": "VUID-VkSamplerYcbcrConversionImageFormatProperties-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_SAMPLER_YCBCR_CONVERSION_IMAGE_FORMAT_PROPERTIES</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkAndroidHardwareBufferUsageANDROID": {
|
|
"(VK_VERSION_1_1,VK_KHR_get_physical_device_properties2)+(VK_ANDROID_external_memory_android_hardware_buffer)": [
|
|
{
|
|
"vuid": "VUID-VkAndroidHardwareBufferUsageANDROID-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_ANDROID_HARDWARE_BUFFER_USAGE_ANDROID</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceImageViewImageFormatInfoEXT": {
|
|
"(VK_VERSION_1_1,VK_KHR_get_physical_device_properties2)+(VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceImageViewImageFormatInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_IMAGE_VIEW_IMAGE_FORMAT_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceImageViewImageFormatInfoEXT-imageViewType-parameter",
|
|
"text": " <code>imageViewType</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkImageViewType\">VkImageViewType</a> value"
|
|
}
|
|
]
|
|
},
|
|
"VkFilterCubicImageViewImageFormatPropertiesEXT": {
|
|
"(VK_VERSION_1_1,VK_KHR_get_physical_device_properties2)+(VK_EXT_filter_cubic)": [
|
|
{
|
|
"vuid": "VUID-VkFilterCubicImageViewImageFormatPropertiesEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_FILTER_CUBIC_IMAGE_VIEW_IMAGE_FORMAT_PROPERTIES_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkFilterCubicImageViewImageFormatPropertiesEXT-pNext-02627",
|
|
"text": " If the <code>pNext</code> chain of the <a href=\"#VkImageFormatProperties2\">VkImageFormatProperties2</a> structure includes a <a href=\"#VkFilterCubicImageViewImageFormatPropertiesEXT\">VkFilterCubicImageViewImageFormatPropertiesEXT</a> structure, the <code>pNext</code> chain of the <a href=\"#VkPhysicalDeviceImageFormatInfo2\">VkPhysicalDeviceImageFormatInfo2</a> structure <strong class=\"purple\">must</strong> include a <a href=\"#VkPhysicalDeviceImageViewImageFormatInfoEXT\">VkPhysicalDeviceImageViewImageFormatInfoEXT</a> structure with an <code>imageViewType</code> that is compatible with <code>imageType</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetPhysicalDeviceExternalBufferProperties": {
|
|
"(VK_VERSION_1_1,VK_KHR_external_memory_capabilities)": [
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceExternalBufferProperties-physicalDevice-parameter",
|
|
"text": " <code>physicalDevice</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceExternalBufferProperties-pExternalBufferInfo-parameter",
|
|
"text": " <code>pExternalBufferInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkPhysicalDeviceExternalBufferInfo\">VkPhysicalDeviceExternalBufferInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceExternalBufferProperties-pExternalBufferProperties-parameter",
|
|
"text": " <code>pExternalBufferProperties</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkExternalBufferProperties\">VkExternalBufferProperties</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceExternalBufferInfo": {
|
|
"(VK_VERSION_1_1,VK_KHR_external_memory_capabilities)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceExternalBufferInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_EXTERNAL_BUFFER_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceExternalBufferInfo-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceExternalBufferInfo-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkBufferCreateFlagBits\">VkBufferCreateFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceExternalBufferInfo-usage-parameter",
|
|
"text": " <code>usage</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkBufferUsageFlagBits\">VkBufferUsageFlagBits</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceExternalBufferInfo-usage-requiredbitmask",
|
|
"text": " <code>usage</code> <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceExternalBufferInfo-handleType-parameter",
|
|
"text": " <code>handleType</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkExternalMemoryHandleTypeFlagBits\">VkExternalMemoryHandleTypeFlagBits</a> value"
|
|
}
|
|
]
|
|
},
|
|
"VkExternalBufferProperties": {
|
|
"(VK_VERSION_1_1,VK_KHR_external_memory_capabilities)": [
|
|
{
|
|
"vuid": "VUID-VkExternalBufferProperties-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_EXTERNAL_BUFFER_PROPERTIES</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkExternalBufferProperties-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetPhysicalDeviceExternalSemaphoreProperties": {
|
|
"(VK_VERSION_1_1,VK_KHR_external_semaphore_capabilities)": [
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceExternalSemaphoreProperties-physicalDevice-parameter",
|
|
"text": " <code>physicalDevice</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceExternalSemaphoreProperties-pExternalSemaphoreInfo-parameter",
|
|
"text": " <code>pExternalSemaphoreInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkPhysicalDeviceExternalSemaphoreInfo\">VkPhysicalDeviceExternalSemaphoreInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceExternalSemaphoreProperties-pExternalSemaphoreProperties-parameter",
|
|
"text": " <code>pExternalSemaphoreProperties</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkExternalSemaphoreProperties\">VkExternalSemaphoreProperties</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceExternalSemaphoreInfo": {
|
|
"(VK_VERSION_1_1,VK_KHR_external_semaphore_capabilities)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceExternalSemaphoreInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_EXTERNAL_SEMAPHORE_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceExternalSemaphoreInfo-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code> or a pointer to a valid instance of <a href=\"#VkSemaphoreTypeCreateInfo\">VkSemaphoreTypeCreateInfo</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceExternalSemaphoreInfo-sType-unique",
|
|
"text": " The <code>sType</code> value of each struct in the <code>pNext</code> chain <strong class=\"purple\">must</strong> be unique"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceExternalSemaphoreInfo-handleType-parameter",
|
|
"text": " <code>handleType</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkExternalSemaphoreHandleTypeFlagBits\">VkExternalSemaphoreHandleTypeFlagBits</a> value"
|
|
}
|
|
]
|
|
},
|
|
"VkExternalSemaphoreProperties": {
|
|
"(VK_VERSION_1_1,VK_KHR_external_semaphore_capabilities)": [
|
|
{
|
|
"vuid": "VUID-VkExternalSemaphoreProperties-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_EXTERNAL_SEMAPHORE_PROPERTIES</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkExternalSemaphoreProperties-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetPhysicalDeviceExternalFenceProperties": {
|
|
"(VK_VERSION_1_1,VK_KHR_external_fence_capabilities)": [
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceExternalFenceProperties-physicalDevice-parameter",
|
|
"text": " <code>physicalDevice</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceExternalFenceProperties-pExternalFenceInfo-parameter",
|
|
"text": " <code>pExternalFenceInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkPhysicalDeviceExternalFenceInfo\">VkPhysicalDeviceExternalFenceInfo</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceExternalFenceProperties-pExternalFenceProperties-parameter",
|
|
"text": " <code>pExternalFenceProperties</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkExternalFenceProperties\">VkExternalFenceProperties</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceExternalFenceInfo": {
|
|
"(VK_VERSION_1_1,VK_KHR_external_fence_capabilities)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceExternalFenceInfo-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_EXTERNAL_FENCE_INFO</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceExternalFenceInfo-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceExternalFenceInfo-handleType-parameter",
|
|
"text": " <code>handleType</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkExternalFenceHandleTypeFlagBits\">VkExternalFenceHandleTypeFlagBits</a> value"
|
|
}
|
|
]
|
|
},
|
|
"VkExternalFenceProperties": {
|
|
"(VK_VERSION_1_1,VK_KHR_external_fence_capabilities)": [
|
|
{
|
|
"vuid": "VUID-VkExternalFenceProperties-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_EXTERNAL_FENCE_PROPERTIES</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkExternalFenceProperties-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetPhysicalDeviceCalibrateableTimeDomainsEXT": {
|
|
"(VK_EXT_calibrated_timestamps)": [
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceCalibrateableTimeDomainsEXT-physicalDevice-parameter",
|
|
"text": " <code>physicalDevice</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceCalibrateableTimeDomainsEXT-pTimeDomainCount-parameter",
|
|
"text": " <code>pTimeDomainCount</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>uint32_t</code> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceCalibrateableTimeDomainsEXT-pTimeDomains-parameter",
|
|
"text": " If the value referenced by <code>pTimeDomainCount</code> is not <code>0</code>, and <code>pTimeDomains</code> is not <code>NULL</code>, <code>pTimeDomains</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>pTimeDomainCount</code> <a href=\"#VkTimeDomainEXT\">VkTimeDomainEXT</a> values"
|
|
}
|
|
]
|
|
},
|
|
"vkSetDebugUtilsObjectNameEXT": {
|
|
"(VK_EXT_debug_utils)": [
|
|
{
|
|
"vuid": "VUID-vkSetDebugUtilsObjectNameEXT-pNameInfo-02587",
|
|
"text": " <code>pNameInfo->objectType</code> <strong class=\"purple\">must</strong> not be <code>VK_OBJECT_TYPE_UNKNOWN</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkSetDebugUtilsObjectNameEXT-pNameInfo-02588",
|
|
"text": " <code>pNameInfo->objectHandle</code> <strong class=\"purple\">must</strong> not be <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkSetDebugUtilsObjectNameEXT-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkSetDebugUtilsObjectNameEXT-pNameInfo-parameter",
|
|
"text": " <code>pNameInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkDebugUtilsObjectNameInfoEXT\">VkDebugUtilsObjectNameInfoEXT</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkDebugUtilsObjectNameInfoEXT": {
|
|
"(VK_EXT_debug_utils)": [
|
|
{
|
|
"vuid": "VUID-VkDebugUtilsObjectNameInfoEXT-objectType-02589",
|
|
"text": " If <code>objectType</code> is <code>VK_OBJECT_TYPE_UNKNOWN</code>, <code>objectHandle</code> <strong class=\"purple\">must</strong> not be <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDebugUtilsObjectNameInfoEXT-objectType-02590",
|
|
"text": " If <code>objectType</code> is not <code>VK_OBJECT_TYPE_UNKNOWN</code>, <code>objectHandle</code> <strong class=\"purple\">must</strong> be <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a> or a valid Vulkan handle of the type associated with <code>objectType</code> as defined in the <a href=\"#debugging-object-types\"><code>VkObjectType</code> and Vulkan Handle Relationship</a> table"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDebugUtilsObjectNameInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_DEBUG_UTILS_OBJECT_NAME_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDebugUtilsObjectNameInfoEXT-objectType-parameter",
|
|
"text": " <code>objectType</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkObjectType\">VkObjectType</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDebugUtilsObjectNameInfoEXT-pObjectName-parameter",
|
|
"text": " If <code>pObjectName</code> is not <code>NULL</code>, <code>pObjectName</code> <strong class=\"purple\">must</strong> be a null-terminated UTF-8 string"
|
|
}
|
|
]
|
|
},
|
|
"vkSetDebugUtilsObjectTagEXT": {
|
|
"(VK_EXT_debug_utils)": [
|
|
{
|
|
"vuid": "VUID-vkSetDebugUtilsObjectTagEXT-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkSetDebugUtilsObjectTagEXT-pTagInfo-parameter",
|
|
"text": " <code>pTagInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkDebugUtilsObjectTagInfoEXT\">VkDebugUtilsObjectTagInfoEXT</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkDebugUtilsObjectTagInfoEXT": {
|
|
"(VK_EXT_debug_utils)": [
|
|
{
|
|
"vuid": "VUID-VkDebugUtilsObjectTagInfoEXT-objectType-01908",
|
|
"text": " <code>objectType</code> <strong class=\"purple\">must</strong> not be <code>VK_OBJECT_TYPE_UNKNOWN</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDebugUtilsObjectTagInfoEXT-objectHandle-01910",
|
|
"text": " <code>objectHandle</code> <strong class=\"purple\">must</strong> be a valid Vulkan handle of the type associated with <code>objectType</code> as defined in the <a href=\"#debugging-object-types\"><code>VkObjectType</code> and Vulkan Handle Relationship</a> table"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDebugUtilsObjectTagInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_DEBUG_UTILS_OBJECT_TAG_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDebugUtilsObjectTagInfoEXT-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDebugUtilsObjectTagInfoEXT-objectType-parameter",
|
|
"text": " <code>objectType</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkObjectType\">VkObjectType</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDebugUtilsObjectTagInfoEXT-pTag-parameter",
|
|
"text": " <code>pTag</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>tagSize</code> bytes"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDebugUtilsObjectTagInfoEXT-tagSize-arraylength",
|
|
"text": " <code>tagSize</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkQueueBeginDebugUtilsLabelEXT": {
|
|
"(VK_EXT_debug_utils)": [
|
|
{
|
|
"vuid": "VUID-vkQueueBeginDebugUtilsLabelEXT-queue-parameter",
|
|
"text": " <code>queue</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkQueue\">VkQueue</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkQueueBeginDebugUtilsLabelEXT-pLabelInfo-parameter",
|
|
"text": " <code>pLabelInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkDebugUtilsLabelEXT\">VkDebugUtilsLabelEXT</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkDebugUtilsLabelEXT": {
|
|
"(VK_EXT_debug_utils)": [
|
|
{
|
|
"vuid": "VUID-VkDebugUtilsLabelEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_DEBUG_UTILS_LABEL_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDebugUtilsLabelEXT-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDebugUtilsLabelEXT-pLabelName-parameter",
|
|
"text": " <code>pLabelName</code> <strong class=\"purple\">must</strong> be a null-terminated UTF-8 string"
|
|
}
|
|
]
|
|
},
|
|
"vkQueueEndDebugUtilsLabelEXT": {
|
|
"(VK_EXT_debug_utils)": [
|
|
{
|
|
"vuid": "VUID-vkQueueEndDebugUtilsLabelEXT-None-01911",
|
|
"text": " There <strong class=\"purple\">must</strong> be an outstanding <code>vkQueueBeginDebugUtilsLabelEXT</code> command prior to the <code>vkQueueEndDebugUtilsLabelEXT</code> on the queue"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkQueueEndDebugUtilsLabelEXT-queue-parameter",
|
|
"text": " <code>queue</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkQueue\">VkQueue</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"vkQueueInsertDebugUtilsLabelEXT": {
|
|
"(VK_EXT_debug_utils)": [
|
|
{
|
|
"vuid": "VUID-vkQueueInsertDebugUtilsLabelEXT-queue-parameter",
|
|
"text": " <code>queue</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkQueue\">VkQueue</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkQueueInsertDebugUtilsLabelEXT-pLabelInfo-parameter",
|
|
"text": " <code>pLabelInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkDebugUtilsLabelEXT\">VkDebugUtilsLabelEXT</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdBeginDebugUtilsLabelEXT": {
|
|
"(VK_EXT_debug_utils)": [
|
|
{
|
|
"vuid": "VUID-vkCmdBeginDebugUtilsLabelEXT-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginDebugUtilsLabelEXT-pLabelInfo-parameter",
|
|
"text": " <code>pLabelInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkDebugUtilsLabelEXT\">VkDebugUtilsLabelEXT</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginDebugUtilsLabelEXT-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginDebugUtilsLabelEXT-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics, or compute operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdBeginDebugUtilsLabelEXT-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdEndDebugUtilsLabelEXT": {
|
|
"(VK_EXT_debug_utils)": [
|
|
{
|
|
"vuid": "VUID-vkCmdEndDebugUtilsLabelEXT-commandBuffer-01912",
|
|
"text": " There <strong class=\"purple\">must</strong> be an outstanding <code>vkCmdBeginDebugUtilsLabelEXT</code> command prior to the <code>vkCmdEndDebugUtilsLabelEXT</code> on the queue that <code>commandBuffer</code> is submitted to"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndDebugUtilsLabelEXT-commandBuffer-01913",
|
|
"text": " If <code>commandBuffer</code> is a secondary command buffer, there <strong class=\"purple\">must</strong> be an outstanding <code>vkCmdBeginDebugUtilsLabelEXT</code> command recorded to <code>commandBuffer</code> that has not previously been ended by a call to <code>vkCmdEndDebugUtilsLabelEXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndDebugUtilsLabelEXT-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndDebugUtilsLabelEXT-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndDebugUtilsLabelEXT-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics, or compute operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdEndDebugUtilsLabelEXT-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdInsertDebugUtilsLabelEXT": {
|
|
"(VK_EXT_debug_utils)": [
|
|
{
|
|
"vuid": "VUID-vkCmdInsertDebugUtilsLabelEXT-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdInsertDebugUtilsLabelEXT-pLabelInfo-parameter",
|
|
"text": " <code>pLabelInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkDebugUtilsLabelEXT\">VkDebugUtilsLabelEXT</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdInsertDebugUtilsLabelEXT-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdInsertDebugUtilsLabelEXT-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics, or compute operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdInsertDebugUtilsLabelEXT-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
]
|
|
},
|
|
"vkCreateDebugUtilsMessengerEXT": {
|
|
"(VK_EXT_debug_utils)": [
|
|
{
|
|
"vuid": "VUID-vkCreateDebugUtilsMessengerEXT-instance-parameter",
|
|
"text": " <code>instance</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkInstance\">VkInstance</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateDebugUtilsMessengerEXT-pCreateInfo-parameter",
|
|
"text": " <code>pCreateInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkDebugUtilsMessengerCreateInfoEXT\">VkDebugUtilsMessengerCreateInfoEXT</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateDebugUtilsMessengerEXT-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateDebugUtilsMessengerEXT-pMessenger-parameter",
|
|
"text": " <code>pMessenger</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkDebugUtilsMessengerEXT\">VkDebugUtilsMessengerEXT</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkDebugUtilsMessengerCreateInfoEXT": {
|
|
"(VK_EXT_debug_utils)": [
|
|
{
|
|
"vuid": "VUID-VkDebugUtilsMessengerCreateInfoEXT-pfnUserCallback-01914",
|
|
"text": " <code>pfnUserCallback</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#PFN_vkDebugUtilsMessengerCallbackEXT\">PFN_vkDebugUtilsMessengerCallbackEXT</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDebugUtilsMessengerCreateInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_DEBUG_UTILS_MESSENGER_CREATE_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDebugUtilsMessengerCreateInfoEXT-flags-zerobitmask",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDebugUtilsMessengerCreateInfoEXT-messageSeverity-parameter",
|
|
"text": " <code>messageSeverity</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkDebugUtilsMessageSeverityFlagBitsEXT\">VkDebugUtilsMessageSeverityFlagBitsEXT</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDebugUtilsMessengerCreateInfoEXT-messageSeverity-requiredbitmask",
|
|
"text": " <code>messageSeverity</code> <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDebugUtilsMessengerCreateInfoEXT-messageType-parameter",
|
|
"text": " <code>messageType</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkDebugUtilsMessageTypeFlagBitsEXT\">VkDebugUtilsMessageTypeFlagBitsEXT</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDebugUtilsMessengerCreateInfoEXT-messageType-requiredbitmask",
|
|
"text": " <code>messageType</code> <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDebugUtilsMessengerCreateInfoEXT-pfnUserCallback-parameter",
|
|
"text": " <code>pfnUserCallback</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#PFN_vkDebugUtilsMessengerCallbackEXT\">PFN_vkDebugUtilsMessengerCallbackEXT</a> value"
|
|
}
|
|
]
|
|
},
|
|
"PFN_vkDebugUtilsMessengerCallbackEXT": {
|
|
"(VK_EXT_debug_utils)": [
|
|
{
|
|
"vuid": "VUID-PFN_vkDebugUtilsMessengerCallbackEXT-None-04769",
|
|
"text": " The callback <strong class=\"purple\">must</strong> not make calls to any Vulkan commands"
|
|
}
|
|
]
|
|
},
|
|
"VkDebugUtilsMessengerCallbackDataEXT": {
|
|
"(VK_EXT_debug_utils)": [
|
|
{
|
|
"vuid": "VUID-VkDebugUtilsMessengerCallbackDataEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_DEBUG_UTILS_MESSENGER_CALLBACK_DATA_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDebugUtilsMessengerCallbackDataEXT-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDebugUtilsMessengerCallbackDataEXT-flags-zerobitmask",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDebugUtilsMessengerCallbackDataEXT-pMessageIdName-parameter",
|
|
"text": " If <code>pMessageIdName</code> is not <code>NULL</code>, <code>pMessageIdName</code> <strong class=\"purple\">must</strong> be a null-terminated UTF-8 string"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDebugUtilsMessengerCallbackDataEXT-pMessage-parameter",
|
|
"text": " <code>pMessage</code> <strong class=\"purple\">must</strong> be a null-terminated UTF-8 string"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDebugUtilsMessengerCallbackDataEXT-pQueueLabels-parameter",
|
|
"text": " If <code>queueLabelCount</code> is not <code>0</code>, <code>pQueueLabels</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>queueLabelCount</code> valid <a href=\"#VkDebugUtilsLabelEXT\">VkDebugUtilsLabelEXT</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDebugUtilsMessengerCallbackDataEXT-pCmdBufLabels-parameter",
|
|
"text": " If <code>cmdBufLabelCount</code> is not <code>0</code>, <code>pCmdBufLabels</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>cmdBufLabelCount</code> valid <a href=\"#VkDebugUtilsLabelEXT\">VkDebugUtilsLabelEXT</a> structures"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDebugUtilsMessengerCallbackDataEXT-pObjects-parameter",
|
|
"text": " If <code>objectCount</code> is not <code>0</code>, <code>pObjects</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>objectCount</code> valid <a href=\"#VkDebugUtilsObjectNameInfoEXT\">VkDebugUtilsObjectNameInfoEXT</a> structures"
|
|
}
|
|
]
|
|
},
|
|
"vkSubmitDebugUtilsMessageEXT": {
|
|
"(VK_EXT_debug_utils)": [
|
|
{
|
|
"vuid": "VUID-vkSubmitDebugUtilsMessageEXT-objectType-02591",
|
|
"text": " The <code>objectType</code> member of each element of <code>pCallbackData->pObjects</code> <strong class=\"purple\">must</strong> not be <code>VK_OBJECT_TYPE_UNKNOWN</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkSubmitDebugUtilsMessageEXT-instance-parameter",
|
|
"text": " <code>instance</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkInstance\">VkInstance</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkSubmitDebugUtilsMessageEXT-messageSeverity-parameter",
|
|
"text": " <code>messageSeverity</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDebugUtilsMessageSeverityFlagBitsEXT\">VkDebugUtilsMessageSeverityFlagBitsEXT</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkSubmitDebugUtilsMessageEXT-messageTypes-parameter",
|
|
"text": " <code>messageTypes</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkDebugUtilsMessageTypeFlagBitsEXT\">VkDebugUtilsMessageTypeFlagBitsEXT</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkSubmitDebugUtilsMessageEXT-messageTypes-requiredbitmask",
|
|
"text": " <code>messageTypes</code> <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkSubmitDebugUtilsMessageEXT-pCallbackData-parameter",
|
|
"text": " <code>pCallbackData</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkDebugUtilsMessengerCallbackDataEXT\">VkDebugUtilsMessengerCallbackDataEXT</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"vkDestroyDebugUtilsMessengerEXT": {
|
|
"(VK_EXT_debug_utils)": [
|
|
{
|
|
"vuid": "VUID-vkDestroyDebugUtilsMessengerEXT-messenger-01915",
|
|
"text": " If <code>VkAllocationCallbacks</code> were provided when <code>messenger</code> was created, a compatible set of callbacks <strong class=\"purple\">must</strong> be provided here"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyDebugUtilsMessengerEXT-messenger-01916",
|
|
"text": " If no <code>VkAllocationCallbacks</code> were provided when <code>messenger</code> was created, <code>pAllocator</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyDebugUtilsMessengerEXT-instance-parameter",
|
|
"text": " <code>instance</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkInstance\">VkInstance</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyDebugUtilsMessengerEXT-messenger-parameter",
|
|
"text": " If <code>messenger</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>messenger</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDebugUtilsMessengerEXT\">VkDebugUtilsMessengerEXT</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyDebugUtilsMessengerEXT-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyDebugUtilsMessengerEXT-messenger-parent",
|
|
"text": " If <code>messenger</code> is a valid handle, it <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>instance</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkDebugMarkerSetObjectNameEXT": {
|
|
"(VK_EXT_debug_marker)": [
|
|
{
|
|
"vuid": "VUID-vkDebugMarkerSetObjectNameEXT-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDebugMarkerSetObjectNameEXT-pNameInfo-parameter",
|
|
"text": " <code>pNameInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkDebugMarkerObjectNameInfoEXT\">VkDebugMarkerObjectNameInfoEXT</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkDebugMarkerObjectNameInfoEXT": {
|
|
"(VK_EXT_debug_marker)": [
|
|
{
|
|
"vuid": "VUID-VkDebugMarkerObjectNameInfoEXT-objectType-01490",
|
|
"text": " <code>objectType</code> <strong class=\"purple\">must</strong> not be <code>VK_DEBUG_REPORT_OBJECT_TYPE_UNKNOWN_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDebugMarkerObjectNameInfoEXT-object-01491",
|
|
"text": " <code>object</code> <strong class=\"purple\">must</strong> not be <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDebugMarkerObjectNameInfoEXT-object-01492",
|
|
"text": " <code>object</code> <strong class=\"purple\">must</strong> be a Vulkan object of the type associated with <code>objectType</code> as defined in <a href=\"#debug-report-object-types\"><code>VkDebugReportObjectTypeEXT</code> and Vulkan Handle Relationship</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDebugMarkerObjectNameInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_DEBUG_MARKER_OBJECT_NAME_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDebugMarkerObjectNameInfoEXT-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDebugMarkerObjectNameInfoEXT-objectType-parameter",
|
|
"text": " <code>objectType</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDebugReportObjectTypeEXT\">VkDebugReportObjectTypeEXT</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDebugMarkerObjectNameInfoEXT-pObjectName-parameter",
|
|
"text": " <code>pObjectName</code> <strong class=\"purple\">must</strong> be a null-terminated UTF-8 string"
|
|
}
|
|
]
|
|
},
|
|
"vkDebugMarkerSetObjectTagEXT": {
|
|
"(VK_EXT_debug_marker)": [
|
|
{
|
|
"vuid": "VUID-vkDebugMarkerSetObjectTagEXT-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDebugMarkerSetObjectTagEXT-pTagInfo-parameter",
|
|
"text": " <code>pTagInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkDebugMarkerObjectTagInfoEXT\">VkDebugMarkerObjectTagInfoEXT</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"VkDebugMarkerObjectTagInfoEXT": {
|
|
"(VK_EXT_debug_marker)": [
|
|
{
|
|
"vuid": "VUID-VkDebugMarkerObjectTagInfoEXT-objectType-01493",
|
|
"text": " <code>objectType</code> <strong class=\"purple\">must</strong> not be <code>VK_DEBUG_REPORT_OBJECT_TYPE_UNKNOWN_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDebugMarkerObjectTagInfoEXT-object-01494",
|
|
"text": " <code>object</code> <strong class=\"purple\">must</strong> not be <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDebugMarkerObjectTagInfoEXT-object-01495",
|
|
"text": " <code>object</code> <strong class=\"purple\">must</strong> be a Vulkan object of the type associated with <code>objectType</code> as defined in <a href=\"#debug-report-object-types\"><code>VkDebugReportObjectTypeEXT</code> and Vulkan Handle Relationship</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDebugMarkerObjectTagInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_DEBUG_MARKER_OBJECT_TAG_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDebugMarkerObjectTagInfoEXT-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDebugMarkerObjectTagInfoEXT-objectType-parameter",
|
|
"text": " <code>objectType</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDebugReportObjectTypeEXT\">VkDebugReportObjectTypeEXT</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDebugMarkerObjectTagInfoEXT-pTag-parameter",
|
|
"text": " <code>pTag</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>tagSize</code> bytes"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDebugMarkerObjectTagInfoEXT-tagSize-arraylength",
|
|
"text": " <code>tagSize</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdDebugMarkerBeginEXT": {
|
|
"(VK_EXT_debug_marker)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDebugMarkerBeginEXT-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDebugMarkerBeginEXT-pMarkerInfo-parameter",
|
|
"text": " <code>pMarkerInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkDebugMarkerMarkerInfoEXT\">VkDebugMarkerMarkerInfoEXT</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDebugMarkerBeginEXT-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDebugMarkerBeginEXT-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics, or compute operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDebugMarkerBeginEXT-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
]
|
|
},
|
|
"VkDebugMarkerMarkerInfoEXT": {
|
|
"(VK_EXT_debug_marker)": [
|
|
{
|
|
"vuid": "VUID-VkDebugMarkerMarkerInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_DEBUG_MARKER_MARKER_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDebugMarkerMarkerInfoEXT-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDebugMarkerMarkerInfoEXT-pMarkerName-parameter",
|
|
"text": " <code>pMarkerName</code> <strong class=\"purple\">must</strong> be a null-terminated UTF-8 string"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdDebugMarkerEndEXT": {
|
|
"(VK_EXT_debug_marker)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDebugMarkerEndEXT-commandBuffer-01239",
|
|
"text": " There <strong class=\"purple\">must</strong> be an outstanding <a href=\"#vkCmdDebugMarkerBeginEXT\">vkCmdDebugMarkerBeginEXT</a> command prior to the <code>vkCmdDebugMarkerEndEXT</code> on the queue that <code>commandBuffer</code> is submitted to"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDebugMarkerEndEXT-commandBuffer-01240",
|
|
"text": " If <code>commandBuffer</code> is a secondary command buffer, there <strong class=\"purple\">must</strong> be an outstanding <a href=\"#vkCmdDebugMarkerBeginEXT\">vkCmdDebugMarkerBeginEXT</a> command recorded to <code>commandBuffer</code> that has not previously been ended by a call to <a href=\"#vkCmdDebugMarkerEndEXT\">vkCmdDebugMarkerEndEXT</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDebugMarkerEndEXT-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDebugMarkerEndEXT-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDebugMarkerEndEXT-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics, or compute operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDebugMarkerEndEXT-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdDebugMarkerInsertEXT": {
|
|
"(VK_EXT_debug_marker)": [
|
|
{
|
|
"vuid": "VUID-vkCmdDebugMarkerInsertEXT-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDebugMarkerInsertEXT-pMarkerInfo-parameter",
|
|
"text": " <code>pMarkerInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkDebugMarkerMarkerInfoEXT\">VkDebugMarkerMarkerInfoEXT</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDebugMarkerInsertEXT-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDebugMarkerInsertEXT-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics, or compute operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdDebugMarkerInsertEXT-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
]
|
|
},
|
|
"vkCreateDebugReportCallbackEXT": {
|
|
"(VK_EXT_debug_report)": [
|
|
{
|
|
"vuid": "VUID-vkCreateDebugReportCallbackEXT-instance-parameter",
|
|
"text": " <code>instance</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkInstance\">VkInstance</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateDebugReportCallbackEXT-pCreateInfo-parameter",
|
|
"text": " <code>pCreateInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkDebugReportCallbackCreateInfoEXT\">VkDebugReportCallbackCreateInfoEXT</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateDebugReportCallbackEXT-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateDebugReportCallbackEXT-pCallback-parameter",
|
|
"text": " <code>pCallback</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkDebugReportCallbackEXT\">VkDebugReportCallbackEXT</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkDebugReportCallbackCreateInfoEXT": {
|
|
"(VK_EXT_debug_report)": [
|
|
{
|
|
"vuid": "VUID-VkDebugReportCallbackCreateInfoEXT-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_DEBUG_REPORT_CALLBACK_CREATE_INFO_EXT</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDebugReportCallbackCreateInfoEXT-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkDebugReportFlagBitsEXT\">VkDebugReportFlagBitsEXT</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDebugReportCallbackCreateInfoEXT-pfnCallback-parameter",
|
|
"text": " <code>pfnCallback</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#PFN_vkDebugReportCallbackEXT\">PFN_vkDebugReportCallbackEXT</a> value"
|
|
}
|
|
]
|
|
},
|
|
"vkDebugReportMessageEXT": {
|
|
"(VK_EXT_debug_report)": [
|
|
{
|
|
"vuid": "VUID-vkDebugReportMessageEXT-object-01241",
|
|
"text": " <code>object</code> <strong class=\"purple\">must</strong> be a Vulkan object or <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDebugReportMessageEXT-objectType-01498",
|
|
"text": " If <code>objectType</code> is not <code>VK_DEBUG_REPORT_OBJECT_TYPE_UNKNOWN_EXT</code> and <code>object</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>object</code> <strong class=\"purple\">must</strong> be a Vulkan object of the corresponding type associated with <code>objectType</code> as defined in <a href=\"#debug-report-object-types\"><code>VkDebugReportObjectTypeEXT</code> and Vulkan Handle Relationship</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDebugReportMessageEXT-instance-parameter",
|
|
"text": " <code>instance</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkInstance\">VkInstance</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDebugReportMessageEXT-flags-parameter",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> be a valid combination of <a href=\"#VkDebugReportFlagBitsEXT\">VkDebugReportFlagBitsEXT</a> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDebugReportMessageEXT-flags-requiredbitmask",
|
|
"text": " <code>flags</code> <strong class=\"purple\">must</strong> not be <code>0</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDebugReportMessageEXT-objectType-parameter",
|
|
"text": " <code>objectType</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDebugReportObjectTypeEXT\">VkDebugReportObjectTypeEXT</a> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDebugReportMessageEXT-pLayerPrefix-parameter",
|
|
"text": " <code>pLayerPrefix</code> <strong class=\"purple\">must</strong> be a null-terminated UTF-8 string"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDebugReportMessageEXT-pMessage-parameter",
|
|
"text": " <code>pMessage</code> <strong class=\"purple\">must</strong> be a null-terminated UTF-8 string"
|
|
}
|
|
]
|
|
},
|
|
"vkDestroyDebugReportCallbackEXT": {
|
|
"(VK_EXT_debug_report)": [
|
|
{
|
|
"vuid": "VUID-vkDestroyDebugReportCallbackEXT-instance-01242",
|
|
"text": " If <code>VkAllocationCallbacks</code> were provided when <code>callback</code> was created, a compatible set of callbacks <strong class=\"purple\">must</strong> be provided here"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyDebugReportCallbackEXT-instance-01243",
|
|
"text": " If no <code>VkAllocationCallbacks</code> were provided when <code>callback</code> was created, <code>pAllocator</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyDebugReportCallbackEXT-instance-parameter",
|
|
"text": " <code>instance</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkInstance\">VkInstance</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyDebugReportCallbackEXT-callback-parameter",
|
|
"text": " If <code>callback</code> is not <a href=\"#VK_NULL_HANDLE\">VK_NULL_HANDLE</a>, <code>callback</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDebugReportCallbackEXT\">VkDebugReportCallbackEXT</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyDebugReportCallbackEXT-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyDebugReportCallbackEXT-callback-parent",
|
|
"text": " If <code>callback</code> is a valid handle, it <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>instance</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdSetCheckpointNV": {
|
|
"(VK_NV_device_diagnostic_checkpoints)": [
|
|
{
|
|
"vuid": "VUID-vkCmdSetCheckpointNV-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetCheckpointNV-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetCheckpointNV-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics, compute, or transfer operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdSetCheckpointNV-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
]
|
|
},
|
|
"vkGetQueueCheckpointData2NV": {
|
|
"(VK_NV_device_diagnostic_checkpoints)+(VK_VERSION_1_3,VK_KHR_synchronization2)": [
|
|
{
|
|
"vuid": "VUID-vkGetQueueCheckpointData2NV-queue-03892",
|
|
"text": " The device that <code>queue</code> belongs to <strong class=\"purple\">must</strong> be in the lost state"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetQueueCheckpointData2NV-queue-parameter",
|
|
"text": " <code>queue</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkQueue\">VkQueue</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetQueueCheckpointData2NV-pCheckpointDataCount-parameter",
|
|
"text": " <code>pCheckpointDataCount</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>uint32_t</code> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetQueueCheckpointData2NV-pCheckpointData-parameter",
|
|
"text": " If the value referenced by <code>pCheckpointDataCount</code> is not <code>0</code>, and <code>pCheckpointData</code> is not <code>NULL</code>, <code>pCheckpointData</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>pCheckpointDataCount</code> <a href=\"#VkCheckpointData2NV\">VkCheckpointData2NV</a> structures"
|
|
}
|
|
]
|
|
},
|
|
"VkCheckpointData2NV": {
|
|
"(VK_NV_device_diagnostic_checkpoints)+(VK_VERSION_1_3,VK_KHR_synchronization2)": [
|
|
{
|
|
"vuid": "VUID-VkCheckpointData2NV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_CHECKPOINT_DATA_2_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCheckpointData2NV-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetQueueCheckpointDataNV": {
|
|
"(VK_NV_device_diagnostic_checkpoints)": [
|
|
{
|
|
"vuid": "VUID-vkGetQueueCheckpointDataNV-queue-02025",
|
|
"text": " The device that <code>queue</code> belongs to <strong class=\"purple\">must</strong> be in the lost state"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetQueueCheckpointDataNV-queue-parameter",
|
|
"text": " <code>queue</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkQueue\">VkQueue</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetQueueCheckpointDataNV-pCheckpointDataCount-parameter",
|
|
"text": " <code>pCheckpointDataCount</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>uint32_t</code> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetQueueCheckpointDataNV-pCheckpointData-parameter",
|
|
"text": " If the value referenced by <code>pCheckpointDataCount</code> is not <code>0</code>, and <code>pCheckpointData</code> is not <code>NULL</code>, <code>pCheckpointData</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>pCheckpointDataCount</code> <a href=\"#VkCheckpointDataNV\">VkCheckpointDataNV</a> structures"
|
|
}
|
|
]
|
|
},
|
|
"VkCheckpointDataNV": {
|
|
"(VK_NV_device_diagnostic_checkpoints)": [
|
|
{
|
|
"vuid": "VUID-VkCheckpointDataNV-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_CHECKPOINT_DATA_NV</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCheckpointDataNV-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetPhysicalDeviceToolProperties": {
|
|
"(VK_VERSION_1_3,VK_EXT_tooling_info)": [
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceToolProperties-physicalDevice-parameter",
|
|
"text": " <code>physicalDevice</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkPhysicalDevice\">VkPhysicalDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceToolProperties-pToolCount-parameter",
|
|
"text": " <code>pToolCount</code> <strong class=\"purple\">must</strong> be a valid pointer to a <code>uint32_t</code> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetPhysicalDeviceToolProperties-pToolProperties-parameter",
|
|
"text": " If the value referenced by <code>pToolCount</code> is not <code>0</code>, and <code>pToolProperties</code> is not <code>NULL</code>, <code>pToolProperties</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>pToolCount</code> <a href=\"#VkPhysicalDeviceToolProperties\">VkPhysicalDeviceToolProperties</a> structures"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceToolProperties": {
|
|
"(VK_VERSION_1_3,VK_EXT_tooling_info)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceToolProperties-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_TOOL_PROPERTIES</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceToolProperties-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
}
|
|
]
|
|
},
|
|
"StandaloneSpirv": {
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-None-04633",
|
|
"text": " Every entry point <strong class=\"purple\">must</strong> have no return value and accept no arguments"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-None-04634",
|
|
"text": " The static function-call graph for an entry point <strong class=\"purple\">must</strong> not contain cycles; that is, static recursion is not allowed"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-None-04635",
|
|
"text": " The <strong>Logical</strong> or <strong>PhysicalStorageBuffer64</strong> addressing model <strong class=\"purple\">must</strong> be selected"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-None-04636",
|
|
"text": " <strong>Scope</strong> for execution <strong class=\"purple\">must</strong> be limited to <strong>Workgroup</strong> or <strong>Subgroup</strong>"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-None-04637",
|
|
"text": " If the <strong>Scope</strong> for execution is <strong>Workgroup</strong>, then it <strong class=\"purple\">must</strong> only be used in the task, mesh, tessellation control, or compute execution models"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-None-04638",
|
|
"text": " <strong>Scope</strong> for memory <strong class=\"purple\">must</strong> be limited to <strong>Device</strong>, <strong>QueueFamily</strong>, <strong>Workgroup</strong>, <strong>ShaderCallKHR</strong>, <strong>Subgroup</strong>, or <strong>Invocation</strong>"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-None-04639",
|
|
"text": " If the <strong>Scope</strong> for memory is <strong>Workgroup</strong>, then it <strong class=\"purple\">must</strong> only be used in the task, mesh, or compute execution models"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-None-04640",
|
|
"text": " If the <strong>Scope</strong> for memory is <strong>ShaderCallKHR</strong>, then it <strong class=\"purple\">must</strong> only be used in ray generation, intersection, closest hit, any-hit, miss, and callable execution models"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-None-04641",
|
|
"text": " If the <strong>Scope</strong> for memory is <strong>Invocation</strong>, then memory semantics <strong class=\"purple\">must</strong> be <strong>None</strong>"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-None-04643",
|
|
"text": " <strong>Storage Class</strong> <strong class=\"purple\">must</strong> be limited to <strong>UniformConstant</strong>, <strong>Input</strong>, <strong>Uniform</strong>, <strong>Output</strong>, <strong>Workgroup</strong>, <strong>Private</strong>, <strong>Function</strong>, <strong>PushConstant</strong>, <strong>Image</strong>, <strong>StorageBuffer</strong>, <strong>RayPayloadKHR</strong>, <strong>IncomingRayPayloadKHR</strong>, <strong>HitAttributeKHR</strong>, <strong>CallableDataKHR</strong>, <strong>IncomingCallableDataKHR</strong>, <strong>ShaderRecordBufferKHR</strong>, or <strong>PhysicalStorageBuffer</strong>"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-None-04644",
|
|
"text": " If the <strong>Storage Class</strong> is <strong>Output</strong>, then it <strong class=\"purple\">must</strong> not be used in the <strong>GlCompute</strong>, <strong>RayGenerationKHR</strong>, <strong>IntersectionKHR</strong>, <strong>AnyHitKHR</strong>, <strong>ClosestHitKHR</strong>, <strong>MissKHR</strong>, or <strong>CallableKHR</strong> execution models"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-None-04645",
|
|
"text": " If the <strong>Storage Class</strong> is <strong>Workgroup</strong>, then it <strong class=\"purple\">must</strong> only be used in the task, mesh, or compute execution models"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-OpAtomicStore-04730",
|
|
"text": " <code>OpAtomicStore</code> <strong class=\"purple\">must</strong> not use <strong>Acquire</strong>, <strong>AcquireRelease</strong>, or <strong>SequentiallyConsistent</strong> memory semantics"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-OpAtomicLoad-04731",
|
|
"text": " <code>OpAtomicLoad</code> <strong class=\"purple\">must</strong> not use <strong>Release</strong>, <strong>AcquireRelease</strong>, or <strong>SequentiallyConsistent</strong> memory semantics"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-OpMemoryBarrier-04732",
|
|
"text": " <code>OpMemoryBarrier</code> <strong class=\"purple\">must</strong> use one of <strong>Acquire</strong>, <strong>Release</strong>, <strong>AcquireRelease</strong>, or <strong>SequentiallyConsistent</strong> memory semantics"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-OpMemoryBarrier-04733",
|
|
"text": " <code>OpMemoryBarrier</code> <strong class=\"purple\">must</strong> include at least one storage class"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-OpControlBarrier-04650",
|
|
"text": " If the semantics for <code>OpControlBarrier</code> includes one of <strong>Acquire</strong>, <strong>Release</strong>, <strong>AcquireRelease</strong>, or <strong>SequentiallyConsistent</strong> memory semantics, then it <strong class=\"purple\">must</strong> include at least one storage class"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-OpVariable-04651",
|
|
"text": " Any <code>OpVariable</code> with an <code>Initializer</code> operand <strong class=\"purple\">must</strong> have <strong>Output</strong>, <strong>Private</strong>, <strong>Function</strong>, or <strong>Workgroup</strong> as its <strong>Storage Class</strong> operand"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-OpVariable-04734",
|
|
"text": " Any <code>OpVariable</code> with an <code>Initializer</code> operand and <strong>Workgroup</strong> as its <strong>Storage Class</strong> operand <strong class=\"purple\">must</strong> use <code>OpConstantNull</code> as the initializer"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-OpReadClockKHR-04652",
|
|
"text": " <strong>Scope</strong> for <code>OpReadClockKHR</code> <strong class=\"purple\">must</strong> be limited to <strong>Subgroup</strong> or <strong>Device</strong>"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-OriginLowerLeft-04653",
|
|
"text": " The <code>OriginLowerLeft</code> execution mode <strong class=\"purple\">must</strong> not be used; fragment entry points <strong class=\"purple\">must</strong> declare <code>OriginUpperLeft</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-PixelCenterInteger-04654",
|
|
"text": " The <code>PixelCenterInteger</code> execution mode <strong class=\"purple\">must</strong> not be used (pixels are always centered at half-integer coordinates)"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-UniformConstant-04655",
|
|
"text": " Any variable in the <code>UniformConstant</code> storage class <strong class=\"purple\">must</strong> be typed as either <code>OpTypeImage</code>, <code>OpTypeSampler</code>, <code>OpTypeSampledImage</code>, <code>OpTypeAccelerationStructureKHR</code>, or an array of one of these types"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-Uniform-06807",
|
|
"text": " Any variable in the <code>Uniform</code> or <code>StorageBuffer</code> storage class <strong class=\"purple\">must</strong> be typed as <code>OpTypeStruct</code> or an array of this type"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-PushConstant-06808",
|
|
"text": " Any variable in the <code>PushConstant</code> storage class <strong class=\"purple\">must</strong> be typed as <code>OpTypeStruct</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-OpTypeImage-04656",
|
|
"text": " <code>OpTypeImage</code> <strong class=\"purple\">must</strong> declare a scalar 32-bit float, 64-bit integer, or 32-bit integer type for the “Sampled Type” (<code>RelaxedPrecision</code> <strong class=\"purple\">can</strong> be applied to a sampling instruction and to the variable holding the result of a sampling instruction)"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-OpTypeImage-04657",
|
|
"text": " <code>OpTypeImage</code> <strong class=\"purple\">must</strong> have a “Sampled” operand of 1 (sampled image) or 2 (storage image)"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-OpTypeSampledImage-06671",
|
|
"text": " <code>OpTypeSampledImage</code> <strong class=\"purple\">must</strong> have a <code>OpTypeImage</code> with a “Sampled” operand of 1 (sampled image)"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-Image-04965",
|
|
"text": " The converted bit width, signedness, and numeric type of the <code>Image</code> <code>Format</code> operand of an <code>OpTypeImage</code> <strong class=\"purple\">must</strong> match the <code>Sampled</code> <code>Type</code>, as defined in <a href=\"#spirvenv-format-type-matching\">Image Format and Type Matching</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-OpImageTexelPointer-04658",
|
|
"text": " If an <code>OpImageTexelPointer</code> is used in an atomic operation, the image type of the <code>image</code> parameter to <code>OpImageTexelPointer</code> <strong class=\"purple\">must</strong> have an image format of <code>R64i</code>, <code>R64ui</code>, <code>R32f</code>, <code>R32i</code>, or <code>R32ui</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-OpImageQuerySizeLod-04659",
|
|
"text": " <code>OpImageQuerySizeLod</code>, <code>OpImageQueryLod</code>, and <code>OpImageQueryLevels</code> <strong class=\"purple\">must</strong> only consume an “Image” operand whose type has its “Sampled” operand set to 1"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-OpTypeImage-06214",
|
|
"text": " An <code>OpTypeImage</code> with a “Dim” operand of <code>SubpassData</code> <strong class=\"purple\">must</strong> have an “Arrayed” operand of 0 (non-arrayed) and a “Sampled” operand of 2 (storage image)"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-SubpassData-04660",
|
|
"text": " The <span class=\"eq\">(u,v)</span> coordinates used for a <code>SubpassData</code> <strong class=\"purple\">must</strong> be the <id> of a constant vector <span class=\"eq\">(0,0)</span>, or if a layer coordinate is used, <strong class=\"purple\">must</strong> be a vector that was formed with constant 0 for the <span class=\"eq\">u</span> and <span class=\"eq\">v</span> components"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-OpTypeImage-06924",
|
|
"text": " Objects of types <code>OpTypeImage</code>, <code>OpTypeSampler</code>, <code>OpTypeSampledImage</code>, <code>OpTypeAccelerationStructureKHR</code>, and arrays of these types <strong class=\"purple\">must</strong> not be stored to or modified"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-Uniform-06925",
|
|
"text": " Any variable in the <code>Uniform</code> storage class decorated as <code>Block</code> <strong class=\"purple\">must</strong> not be stored to or modified"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-Offset-04662",
|
|
"text": " Any image operation <strong class=\"purple\">must</strong> use at most one of the <code>Offset</code>, <code>ConstOffset</code>, and <code>ConstOffsets</code> image operands"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-Offset-04663",
|
|
"text": " Image operand <code>Offset</code> <strong class=\"purple\">must</strong> only be used with <code>OpImage*Gather</code> instructions"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-Offset-04865",
|
|
"text": " Any image instruction which uses an <code>Offset</code>, <code>ConstOffset</code>, or <code>ConstOffsets</code> image operand, must only consume a “Sampled Image” operand whose type has its “Sampled” operand set to 1"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-OpImageGather-04664",
|
|
"text": " The “Component” operand of <code>OpImageGather</code>, and <code>OpImageSparseGather</code> <strong class=\"purple\">must</strong> be the <id> of a constant instruction"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-OpImage-04777",
|
|
"text": " <code>OpImage*Dref*</code> instructions <strong class=\"purple\">must</strong> not consume an image whose <code>Dim</code> is 3D"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-None-04667",
|
|
"text": " Structure types <strong class=\"purple\">must</strong> not contain opaque types"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-BuiltIn-04668",
|
|
"text": " Any <code>BuiltIn</code> decoration not listed in <a href=\"#interfaces-builtin-variables\">Built-In Variables</a> <strong class=\"purple\">must</strong> not be used"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-Location-06672",
|
|
"text": " The <code>Location</code> or <code>Component</code> decorations <strong class=\"purple\">must</strong> only be used with the <code>Input</code>, <code>Output</code>, <code>RayPayloadKHR</code>, <code>IncomingRayPayloadKHR</code>, <code>HitAttributeKHR</code>, <code>CallableDataKHR</code>, <code>IncomingCallableDataKHR</code>, or <code>ShaderRecordBufferKHR</code> storage classes"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-Location-04915",
|
|
"text": " The <code>Location</code> or <code>Component</code> decorations <strong class=\"purple\">must</strong> not be used with <code>BuiltIn</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-Location-04916",
|
|
"text": " The <code>Location</code> decorations <strong class=\"purple\">must</strong> be used on <a href=\"#interfaces-iointerfaces-user\">user-defined variables</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-Location-04917",
|
|
"text": " The <code>Location</code> decorations <strong class=\"purple\">must</strong> be used on an <code>OpVariable</code> with a structure type that is not a block"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-Location-04918",
|
|
"text": " The <code>Location</code> decorations <strong class=\"purple\">must</strong> not be used on the members of <code>OpVariable</code> with a structure type that is decorated with <code>Location</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-Location-04919",
|
|
"text": " The <code>Location</code> decorations <strong class=\"purple\">must</strong> be used on each member of <code>OpVariable</code> with a structure type that is a block not decorated with <code>Location</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-Component-04920",
|
|
"text": " The <code>Component</code> decoration value <strong class=\"purple\">must</strong> not be greater than 3"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-Component-04921",
|
|
"text": " If the <code>Component</code> decoration is used on an <code>OpVariable</code> that has a <code>OpTypeVector</code> type with a <code>Component</code> <code>Type</code> with a <code>Width</code> that is less than or equal to 32, the sum of its <code>Component</code> <code>Count</code> and the <code>Component</code> decoration value <strong class=\"purple\">must</strong> be less than 4"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-Component-04922",
|
|
"text": " If the <code>Component</code> decoration is used on an <code>OpVariable</code> that has a <code>OpTypeVector</code> type with a <code>Component</code> <code>Type</code> with a <code>Width</code> that is equal to 64, the sum of two times its <code>Component</code> <code>Count</code> and the <code>Component</code> decoration value <strong class=\"purple\">must</strong> be less than 4"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-Component-04923",
|
|
"text": " The <code>Component</code> decorations value <strong class=\"purple\">must</strong> not be 1 or 3 for scalar or two-component 64-bit data types"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-Component-04924",
|
|
"text": " The <code>Component</code> decorations <strong class=\"purple\">must</strong> not used with any type that is not a scalar or vector"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-GLSLShared-04669",
|
|
"text": " The <code>GLSLShared</code> and <code>GLSLPacked</code> decorations <strong class=\"purple\">must</strong> not be used"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-Flat-04670",
|
|
"text": " The <code>Flat</code>, <code>NoPerspective</code>, <code>Sample</code>, and <code>Centroid</code> decorations <strong class=\"purple\">must</strong> only be used on variables with the <code>Output</code> or <code>Input</code> storage class"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-Flat-06201",
|
|
"text": " The <code>Flat</code>, <code>NoPerspective</code>, <code>Sample</code>, and <code>Centroid</code> decorations <strong class=\"purple\">must</strong> not be used on variables with the <code>Output</code> storage class in a fragment shader"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-Flat-06202",
|
|
"text": " The <code>Flat</code>, <code>NoPerspective</code>, <code>Sample</code>, and <code>Centroid</code> decorations <strong class=\"purple\">must</strong> not be used on variables with the <code>Input</code> storage class in a vertex shader"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-PerVertexKHR-06777",
|
|
"text": " The <code>PerVertexKHR</code> decoration <strong class=\"purple\">must</strong> only be used on variables with the <code>Input</code> storage class in a fragment shader"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-Flat-04744",
|
|
"text": " Any variable with integer or double-precision floating-point type and with <code>Input</code> storage class in a fragment shader, <strong class=\"purple\">must</strong> be decorated <code>Flat</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-ViewportRelativeNV-04672",
|
|
"text": " The <code>ViewportRelativeNV</code> decoration <strong class=\"purple\">must</strong> only be used on a variable decorated with <code>Layer</code> in the vertex, tessellation evaluation, or geometry shader stages"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-ViewportRelativeNV-04673",
|
|
"text": " The <code>ViewportRelativeNV</code> decoration <strong class=\"purple\">must</strong> not be used unless a variable decorated with one of <code>ViewportIndex</code> or <code>ViewportMaskNV</code> is also statically used by the same <code>OpEntryPoint</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-ViewportMaskNV-04674",
|
|
"text": " The <code>ViewportMaskNV</code> and <code>ViewportIndex</code> decorations <strong class=\"purple\">must</strong> not both be statically used by one or more <code>OpEntryPoint</code>’s that form the <a href=\"#pipeline-graphics-subsets-pre-rasterization\">pre-rasterization shader stages</a> of a graphics pipeline"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-FPRoundingMode-04675",
|
|
"text": " Rounding modes other than round-to-nearest-even and round-towards-zero <strong class=\"purple\">must</strong> not be used for the <code>FPRoundingMode</code> decoration"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-Invariant-04677",
|
|
"text": " Variables decorated with <code>Invariant</code> and variables with structure types that have any members decorated with <code>Invariant</code> <strong class=\"purple\">must</strong> be in the <code>Output</code> or <code>Input</code> storage class, <code>Invariant</code> used on an <code>Input</code> storage class variable or structure member has no effect"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-VulkanMemoryModel-04678",
|
|
"text": " <a id=\"builtin-volatile-semantics\"></a> If the <code>VulkanMemoryModel</code> capability is not declared, the <code>Volatile</code> decoration <strong class=\"purple\">must</strong> be used on any variable declaration that includes one of the <code>SMIDNV</code>, <code>WarpIDNV</code>, <code>SubgroupSize</code>, <code>SubgroupLocalInvocationId</code>, <code>SubgroupEqMask</code>, <code>SubgroupGeMask</code>, <code>SubgroupGtMask</code>, <code>SubgroupLeMask</code>, or <code>SubgroupLtMask</code> <code>BuiltIn</code> decorations when used in the ray generation, closest hit, miss, intersection, or callable shaders, or with the <code>RayTmaxKHR</code> <code>Builtin</code> decoration when used in an intersection shader"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-VulkanMemoryModel-04679",
|
|
"text": " If the <code>VulkanMemoryModel</code> capability is declared, the <code>OpLoad</code> instruction <strong class=\"purple\">must</strong> use the <code>Volatile</code> memory semantics when it accesses into any variable that includes one of the <code>SMIDNV</code>, <code>WarpIDNV</code>, <code>SubgroupSize</code>, <code>SubgroupLocalInvocationId</code>, <code>SubgroupEqMask</code>, <code>SubgroupGeMask</code>, <code>SubgroupGtMask</code>, <code>SubgroupLeMask</code>, or <code>SubgroupLtMask</code> <code>BuiltIn</code> decorations when used in the ray generation, closest hit, miss, intersection, or callable shaders, or with the <code>RayTmaxKHR</code> <code>Builtin</code> decoration when used in an intersection shader"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-OpTypeRuntimeArray-04680",
|
|
"text": " <code>OpTypeRuntimeArray</code> <strong class=\"purple\">must</strong> only be used for the last member of a <code>Block</code>-decorated <code>OpTypeStruct</code> in <code>StorageBuffer</code> or <code>PhysicalStorageBuffer</code> storage classes; <code>BufferBlock</code>-decorated <code>OpTypeStruct</code> in <code>Uniform</code> storage class; the outermost dimension of an arrayed variable in the <code>StorageBuffer</code>, <code>Uniform</code>, or <code>UniformConstant</code> storage classes."
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-Function-04681",
|
|
"text": " A type <em>T</em> that is an array sized with a specialization constant <strong class=\"purple\">must</strong> neither be, nor be contained in, the type <em>T2</em> of a variable <em>V</em>, unless either: a) <em>T</em> is equal to <em>T2</em>, b) <em>V</em> is declared in the <code>Function</code>, or <code>Private</code> storage classes, c) <em>V</em> is a non-Block variable in the <code>Workgroup</code> storage class, or d) <em>V</em> is an interface variable with an additional level of arrayness, <a href=\"#interfaces-iointerfaces-matching\">as described in interface matching</a>, and <em>T</em> is the member type of the array type <em>T2</em>"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-OpControlBarrier-04682",
|
|
"text": " If <code>OpControlBarrier</code> is used in ray generation, intersection, any-hit, closest hit, miss, fragment, vertex, tessellation evaluation, or geometry shaders, the execution Scope <strong class=\"purple\">must</strong> be <code>Subgroup</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-LocalSize-06426",
|
|
"text": " For each compute shader entry point, either a <code>LocalSize</code> or <code>LocalSizeId</code> execution mode, or an object decorated with the <code>WorkgroupSize</code> decoration <strong class=\"purple\">must</strong> be specified"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-DerivativeGroupQuadsNV-04684",
|
|
"text": " For compute shaders using the <code>DerivativeGroupQuadsNV</code> execution mode, the first two dimensions of the local workgroup size <strong class=\"purple\">must</strong> be a multiple of two"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-DerivativeGroupLinearNV-04778",
|
|
"text": " For compute shaders using the <code>DerivativeGroupLinearNV</code> execution mode, the product of the dimensions of the local workgroup size <strong class=\"purple\">must</strong> be a multiple of four"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-OpGroupNonUniformBallotBitCount-04685",
|
|
"text": " If <code>OpGroupNonUniformBallotBitCount</code> is used, the group operation <strong class=\"purple\">must</strong> be limited to <strong>Reduce</strong>, <strong>InclusiveScan</strong>, or <strong>ExclusiveScan</strong>"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-None-04686",
|
|
"text": " The <em>Pointer</em> operand of all atomic instructions <strong class=\"purple\">must</strong> have a <strong>Storage Class</strong> limited to <strong>Uniform</strong>, <strong>Workgroup</strong>, <strong>Image</strong>, <strong>StorageBuffer</strong>, or <strong>PhysicalStorageBuffer</strong>"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-Offset-04687",
|
|
"text": " Output variables or block members decorated with <code>Offset</code> that have a 64-bit type, or a composite type containing a 64-bit type, <strong class=\"purple\">must</strong> specify an <code>Offset</code> value aligned to a 8 byte boundary"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-Offset-04689",
|
|
"text": " The size of any output block containing any member decorated with <code>Offset</code> that is a 64-bit type <strong class=\"purple\">must</strong> be a multiple of 8"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-Offset-04690",
|
|
"text": " The first member of an output block specifying a <code>Offset</code> decoration <strong class=\"purple\">must</strong> specify a <code>Offset</code> value that is aligned to an 8 byte boundary if that block contains any member decorated with <code>Offset</code> and is a 64-bit type"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-Offset-04691",
|
|
"text": " Output variables or block members decorated with <code>Offset</code> that have a 32-bit type, or a composite type contains a 32-bit type, <strong class=\"purple\">must</strong> specify an <code>Offset</code> value aligned to a 4 byte boundary"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-Offset-04692",
|
|
"text": " Output variables, blocks or block members decorated with <code>Offset</code> <strong class=\"purple\">must</strong> only contain base types that have components that are either 32-bit or 64-bit in size"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-Offset-04716",
|
|
"text": " Only variables or block members in the output interface decorated with <code>Offset</code> <strong class=\"purple\">can</strong> be captured for transform feedback, and those variables or block members <strong class=\"purple\">must</strong> also be decorated with <code>XfbBuffer</code> and <code>XfbStride</code>, or inherit <code>XfbBuffer</code> and <code>XfbStride</code> decorations from a block containing them"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-XfbBuffer-04693",
|
|
"text": " All variables or block members in the output interface of the entry point being compiled decorated with a specific <code>XfbBuffer</code> value <strong class=\"purple\">must</strong> all be decorated with identical <code>XfbStride</code> values"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-Stream-04694",
|
|
"text": " If any variables or block members in the output interface of the entry point being compiled are decorated with <code>Stream</code>, then all variables belonging to the same <code>XfbBuffer</code> <strong class=\"purple\">must</strong> specify the same <code>Stream</code> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-XfbBuffer-04696",
|
|
"text": " For any two variables or block members in the output interface of the entry point being compiled with the same <code>XfbBuffer</code> value, the ranges determined by the <code>Offset</code> decoration and the size of the type <strong class=\"purple\">must</strong> not overlap"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-XfbBuffer-04697",
|
|
"text": " All block members in the output interface of the entry point being compiled that are in the same block and have a declared or inherited <code>XfbBuffer</code> decoration <strong class=\"purple\">must</strong> specify the same <code>XfbBuffer</code> value"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-RayPayloadKHR-04698",
|
|
"text": " <code>RayPayloadKHR</code> storage class <strong class=\"purple\">must</strong> only be used in ray generation, closest hit or miss shaders"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-IncomingRayPayloadKHR-04699",
|
|
"text": " <code>IncomingRayPayloadKHR</code> storage class <strong class=\"purple\">must</strong> only be used in closest hit, any-hit, or miss shaders"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-IncomingRayPayloadKHR-04700",
|
|
"text": " There <strong class=\"purple\">must</strong> be at most one variable with the <code>IncomingRayPayloadKHR</code> storage class in the input interface of an entry point"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-HitAttributeKHR-04701",
|
|
"text": " <code>HitAttributeKHR</code> storage class <strong class=\"purple\">must</strong> only be used in intersection, any-hit, or closest hit shaders"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-HitAttributeKHR-04702",
|
|
"text": " There <strong class=\"purple\">must</strong> be at most one variable with the <code>HitAttributeKHR</code> storage class in the input interface of an entry point"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-HitAttributeKHR-04703",
|
|
"text": " A variable with <code>HitAttributeKHR</code> storage class <strong class=\"purple\">must</strong> only be written to in an intersection shader"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-CallableDataKHR-04704",
|
|
"text": " <code>CallableDataKHR</code> storage class <strong class=\"purple\">must</strong> only be used in ray generation, closest hit, miss, and callable shaders"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-IncomingCallableDataKHR-04705",
|
|
"text": " <code>IncomingCallableDataKHR</code> storage class <strong class=\"purple\">must</strong> only be used in callable shaders"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-IncomingCallableDataKHR-04706",
|
|
"text": " There <strong class=\"purple\">must</strong> be at most one variable with the <code>IncomingCallableDataKHR</code> storage class in the input interface of an entry point"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-Base-04707",
|
|
"text": " The <code>Base</code> operand of <code>OpPtrAccessChain</code> <strong class=\"purple\">must</strong> point to one of the following: <strong>Workgroup</strong>, if <code>VariablePointers</code> is enabled; <strong>StorageBuffer</strong>, if <code>VariablePointers</code> or <code>VariablePointersStorageBuffer</code> is enabled; <strong>PhysicalStorageBuffer</strong>, if the <code>PhysicalStorageBuffer64</code> addressing model is enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-PhysicalStorageBuffer64-04708",
|
|
"text": " If the <code>PhysicalStorageBuffer64</code> addressing model is enabled, all instructions that support memory access operands and that use a physical pointer <strong class=\"purple\">must</strong> include the <code>Aligned</code> operand"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-PhysicalStorageBuffer64-04709",
|
|
"text": " If the <code>PhysicalStorageBuffer64</code> addressing model is enabled, any access chain instruction that accesses into a <code>RowMajor</code> matrix <strong class=\"purple\">must</strong> only be used as the <code>Pointer</code> operand to <code>OpLoad</code> or <code>OpStore</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-PhysicalStorageBuffer64-04710",
|
|
"text": " If the <code>PhysicalStorageBuffer64</code> addressing model is enabled, <code>OpConvertUToPtr</code> and <code>OpConvertPtrToU</code> <strong class=\"purple\">must</strong> use an integer type whose <code>Width</code> is 64"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-OpTypeForwardPointer-04711",
|
|
"text": " <code>OpTypeForwardPointer</code> <strong class=\"purple\">must</strong> have a storage class of <code>PhysicalStorageBuffer</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-None-04745",
|
|
"text": " All block members in a variable with a storage class of <strong>PushConstant</strong> declared as an array <strong class=\"purple\">must</strong> only be accessed by dynamically uniform indices"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-OpVariable-06673",
|
|
"text": " There <strong class=\"purple\">must</strong> not be more than one <code>OpVariable</code> in the <code>PushConstant</code> storage class listed in the <code>Interface</code> for each <code>OpEntryPoint</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-OpEntryPoint-06674",
|
|
"text": " Each <code>OpEntryPoint</code> <strong class=\"purple\">must</strong> not statically use more than one <code>OpVariable</code> in the <code>PushConstant</code> storage class"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-Result-04780",
|
|
"text": " The <code>Result</code> <code>Type</code> operand of any <code>OpImageRead</code> or <code>OpImageSparseRead</code> instruction <strong class=\"purple\">must</strong> be a vector of four components"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-Base-04781",
|
|
"text": " The <code>Base</code> operand of any <code>OpBitCount</code>, <code>OpBitReverse</code>, <code>OpBitFieldInsert</code>, <code>OpBitFieldSExtract</code>, or <code>OpBitFieldUExtract</code> instruction <strong class=\"purple\">must</strong> be a 32-bit integer scalar or a vector of 32-bit integers"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-PushConstant-06675",
|
|
"text": " Any variable in the <code>PushConstant</code> or <code>StorageBuffer</code> storage class <strong class=\"purple\">must</strong> be decorated as <code>Block</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-Uniform-06676",
|
|
"text": " Any variable in the <code>Uniform</code> storage class <strong class=\"purple\">must</strong> be decorated as <code>Block</code> or <code>BufferBlock</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-UniformConstant-06677",
|
|
"text": " Any variable in the <code>UniformConstant</code>, <code>StorageBuffer</code>, or <code>Uniform</code> storage class <strong class=\"purple\">must</strong> be decorated with <code>DescriptorSet</code> and <code>Binding</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-InputAttachmentIndex-06678",
|
|
"text": " Variables decorated with <code>InputAttachmentIndex</code> <strong class=\"purple\">must</strong> be in the <code>UniformConstant</code> storage class"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-DescriptorSet-06491",
|
|
"text": " If a variable is decorated by <code>DescriptorSet</code> or <code>Binding</code>, the storage class <strong class=\"purple\">must</strong> correspond to an entry in <a href=\"#interfaces-resources-storage-class-correspondence\">Shader Resource and Storage Class Correspondence</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-Input-06778",
|
|
"text": " Variables with a storage class of <code>Input</code> in a fragment shader stage that are decorated with <code>PerVertexKHR</code> <strong class=\"purple\">must</strong> be declared as arrays"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-None-04642",
|
|
"text": " <strong>Scope</strong> for <a href=\"#shaders-group-operations\">group operations</a> <strong class=\"purple\">must</strong> be limited to <strong>Subgroup</strong>"
|
|
}
|
|
],
|
|
"!(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-StandaloneSpirv-SubgroupVoteKHR-06997",
|
|
"text": " If the <code>SubgroupVoteKHR</code> or <code>SubgroupBallotKHR</code> capability is not declared, <strong>Scope</strong> for memory <strong class=\"purple\">must</strong> not be <strong>Subgroup</strong>"
|
|
}
|
|
]
|
|
},
|
|
"RuntimeSpirv": {
|
|
"(VK_VERSION_1_2,VK_KHR_vulkan_memory_model)": [
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-vulkanMemoryModel-06265",
|
|
"text": " If <a href=\"#features-vulkanMemoryModel\"><code>vulkanMemoryModel</code></a> is enabled and <a href=\"#features-vulkanMemoryModelDeviceScope\"><code>vulkanMemoryModelDeviceScope</code></a> is not enabled, <strong>Device</strong> memory scope <strong class=\"purple\">must</strong> not be used."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-vulkanMemoryModel-06266",
|
|
"text": " If <a href=\"#features-vulkanMemoryModel\"><code>vulkanMemoryModel</code></a> is not enabled, <strong>QueueFamily</strong> memory scope <strong class=\"purple\">must</strong> not be used."
|
|
}
|
|
],
|
|
"(VK_KHR_shader_clock)": [
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-shaderSubgroupClock-06267",
|
|
"text": " If <a href=\"#features-shaderSubgroupClock\"><code>shaderSubgroupClock</code></a> is not enabled, the <code>Subgroup</code> scope <strong class=\"purple\">must</strong> not be used for <code>OpReadClockKHR</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-shaderDeviceClock-06268",
|
|
"text": " If <a href=\"#features-shaderDeviceClock\"><code>shaderDeviceClock</code></a> is not enabled, the <code>Device</code> scope <strong class=\"purple\">must</strong> not be used for <code>OpReadClockKHR</code>."
|
|
}
|
|
],
|
|
"!(VK_VERSION_1_3,VK_KHR_format_feature_flags2)": [
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-OpTypeImage-06269",
|
|
"text": " If <a href=\"#features-shaderStorageImageWriteWithoutFormat\"><code>shaderStorageImageWriteWithoutFormat</code></a> is not enabled, any variable created with a “Type” of <code>OpTypeImage</code> that has a “Sampled” operand of 2 and an “Image Format” operand of <code>Unknown</code> <strong class=\"purple\">must</strong> be decorated with <code>NonWritable</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-OpTypeImage-06270",
|
|
"text": " If <a href=\"#features-shaderStorageImageReadWithoutFormat\"><code>shaderStorageImageReadWithoutFormat</code></a> is not enabled, any variable created with a “Type” of <code>OpTypeImage</code> that has a “Sampled” operand of 2 and an “Image Format” operand of <code>Unknown</code> <strong class=\"purple\">must</strong> be decorated with <code>NonReadable</code>."
|
|
}
|
|
],
|
|
"core": [
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-Location-06272",
|
|
"text": " The sum of <code>Location</code> and the number of locations the variable it decorates consumes <strong class=\"purple\">must</strong> be less than or equal to the value for the matching {ExecutionModel} defined in <a href=\"#interfaces-iointerfaces-limits\">Shader Input and Output Locations</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-Fragment-06427",
|
|
"text": " When blending is enabled and one of the dual source blend modes is in use, the maximum number of output attachments written to in the <code>Fragment</code> {ExecutionModel} <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#limits-maxFragmentDualSrcAttachments\"><code>maxFragmentDualSrcAttachments</code></a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-Location-06428",
|
|
"text": " The maximum number of storage buffers, storage images, and output <code>Location</code> decorated color attachments written to in the <code>Fragment</code> {ExecutionModel} <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#limits-maxFragmentCombinedOutputResources\"><code>maxFragmentCombinedOutputResources</code></a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-DescriptorSet-06323",
|
|
"text": " <code>DescriptorSet</code> and <code>Binding</code> decorations <strong class=\"purple\">must</strong> obey the constraints on storage class, type, and descriptor type described in <a href=\"#interfaces-resources-setandbinding\">DescriptorSet and Binding Assignment</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-NonWritable-06340",
|
|
"text": " If <a href=\"#features-fragmentStoresAndAtomics\"><code>fragmentStoresAndAtomics</code></a> is not enabled, then all storage image, storage texel buffer, and storage buffer variables in the fragment stage <strong class=\"purple\">must</strong> be decorated with the <code>NonWritable</code> decoration."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-NonWritable-06341",
|
|
"text": " If <a href=\"#features-vertexPipelineStoresAndAtomics\"><code>vertexPipelineStoresAndAtomics</code></a> is not enabled, then all storage image, storage texel buffer, and storage buffer variables in the vertex, tessellation, and geometry stages <strong class=\"purple\">must</strong> be decorated with the <code>NonWritable</code> decoration."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-None-06342",
|
|
"text": " If <a href=\"#limits-subgroupQuadOperationsInAllStages\"><code>subgroupQuadOperationsInAllStages</code></a> is <code>VK_FALSE</code>, then <a href=\"#features-subgroup-quad\">quad subgroup operations</a> <strong class=\"purple\">must</strong> not be used except for in fragment and compute stages."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-Offset-06344",
|
|
"text": " The first element of the <code>Offset</code> operand of <code>InterpolateAtOffset</code> <strong class=\"purple\">must</strong> be greater than or equal to:"
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-Offset-06345",
|
|
"text": " The first element of the <code>Offset</code> operand of <code>InterpolateAtOffset</code> <strong class=\"purple\">must</strong> be less than or equal to:"
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-Offset-06346",
|
|
"text": " The second element of the <code>Offset</code> operand of <code>InterpolateAtOffset</code> <strong class=\"purple\">must</strong> be greater than or equal to:"
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-Offset-06347",
|
|
"text": " The second element of the <code>Offset</code> operand of <code>InterpolateAtOffset</code> <strong class=\"purple\">must</strong> be less than or equal to:"
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-x-06429",
|
|
"text": " The <code>x</code> size in <code>LocalSize</code> or <code>LocalSizeId</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxComputeWorkGroupSize</code>[0]"
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-y-06430",
|
|
"text": " The <code>y</code> size in <code>LocalSize</code> or <code>LocalSizeId</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxComputeWorkGroupSize</code>[1]"
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-z-06431",
|
|
"text": " The <code>z</code> size in <code>LocalSize</code> or <code>LocalSizeId</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxComputeWorkGroupSize</code>[2]"
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-x-06432",
|
|
"text": " The product of <code>x</code> size, <code>y</code> size, and <code>z</code> size in <code>LocalSize</code> or <code>LocalSizeId</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceLimits</code>::<code>maxComputeWorkGroupInvocations</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-Workgroup-06530",
|
|
"text": " The sum of size in bytes for variables and <a href=\"#limits-maxComputeSharedMemorySize\">padding</a> in the <code>Workgroup</code> storage class in the <code>GLCompute</code> {ExecutionModel} <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#limits-maxComputeSharedMemorySize\"><code>maxComputeSharedMemorySize</code></a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-OpImage-06376",
|
|
"text": " If an <code>OpImage*Gather</code> operation has an image operand of <code>Offset</code>, <code>ConstOffset</code>, or <code>ConstOffsets</code> the offset value <strong class=\"purple\">must</strong> be greater than or equal to <a href=\"#limits-minTexelGatherOffset\">minTexelGatherOffset</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-OpImage-06377",
|
|
"text": " If an <code>OpImage*Gather</code> operation has an image operand of <code>Offset</code>, <code>ConstOffset</code>, or <code>ConstOffsets</code> the offset value <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#limits-maxTexelGatherOffset\">maxTexelGatherOffset</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-OpImageSample-06435",
|
|
"text": " If an <code>OpImageSample*</code> or <code>OpImageFetch*</code> operation has an image operand of <code>ConstOffset</code> then the offset value <strong class=\"purple\">must</strong> be greater than or equal to <a href=\"#limits-minTexelOffset\">minTexelOffset</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-OpImageSample-06436",
|
|
"text": " If an <code>OpImageSample*</code> or <code>OpImageFetch*</code> operation has an image operand of <code>ConstOffset</code> then the offset value <strong class=\"purple\">must</strong> be less than or equal to <a href=\"#limits-maxTexelOffset\">maxTexelOffset</a>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_EXT_descriptor_indexing)": [
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-NonUniform-06274",
|
|
"text": " If an instruction loads from or stores to a resource (including atomics and image instructions) and the resource descriptor being accessed is not dynamically uniform, then the operand corresponding to that resource (e.g. the pointer or sampled image operand) <strong class=\"purple\">must</strong> be decorated with <code>NonUniform</code>."
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1)+(VK_VERSION_1_2,VK_KHR_shader_subgroup_extended_types)": [
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-None-06275",
|
|
"text": " <a href=\"#features-subgroup-extended-types\"><code>shaderSubgroupExtendedTypes</code></a> <strong class=\"purple\">must</strong> be enabled for <a href=\"#shaders-group-operations\">group operations</a> to use 8-bit integer, 16-bit integer, 64-bit integer, 16-bit floating-point, and vectors of these types"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2)": [
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-subgroupBroadcastDynamicId-06276",
|
|
"text": " If <a href=\"#features-subgroupBroadcastDynamicId\"><code>subgroupBroadcastDynamicId</code></a> is <code>VK_TRUE</code>, and the shader module version is 1.5 or higher, the “Index” for <code>OpGroupNonUniformQuadBroadcast</code> <strong class=\"purple\">must</strong> be dynamically uniform within the derivative group. Otherwise, “Index” <strong class=\"purple\">must</strong> be a constant."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-subgroupBroadcastDynamicId-06277",
|
|
"text": " If <a href=\"#features-subgroupBroadcastDynamicId\"><code>subgroupBroadcastDynamicId</code></a> is <code>VK_TRUE</code>, and the shader module version is 1.5 or higher, the “Id” for <code>OpGroupNonUniformBroadcast</code> <strong class=\"purple\">must</strong> be dynamically uniform within the subgroup. Otherwise, “Id” <strong class=\"purple\">must</strong> be a constant."
|
|
}
|
|
],
|
|
"(VK_KHR_shader_atomic_int64)": [
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-None-06278",
|
|
"text": " <a href=\"#features-shaderBufferInt64Atomics\"><code>shaderBufferInt64Atomics</code></a> <strong class=\"purple\">must</strong> be enabled for 64-bit integer atomic operations to be supported on a <em>Pointer</em> with a <strong>Storage Class</strong> of <strong>StorageBuffer</strong> or <strong>Uniform</strong>."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-None-06279",
|
|
"text": " <a href=\"#features-shaderSharedInt64Atomics\"><code>shaderSharedInt64Atomics</code></a> <strong class=\"purple\">must</strong> be enabled for 64-bit integer atomic operations to be supported on a <em>Pointer</em> with a <strong>Storage Class</strong> of <strong>Workgroup</strong>."
|
|
}
|
|
],
|
|
"(VK_EXT_shader_atomic_float)+!(VK_EXT_shader_atomic_float2)": [
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-None-06280",
|
|
"text": " <a href=\"#features-shaderBufferFloat32Atomics\"><code>shaderBufferFloat32Atomics</code></a>, or <a href=\"#features-shaderBufferFloat32AtomicAdd\"><code>shaderBufferFloat32AtomicAdd</code></a>, or <a href=\"#features-shaderBufferFloat64Atomics\"><code>shaderBufferFloat64Atomics</code></a>, or <a href=\"#features-shaderBufferFloat64AtomicAdd\"><code>shaderBufferFloat64AtomicAdd</code></a> <strong class=\"purple\">must</strong> be enabled for floating-point atomic operations to be supported on a <em>Pointer</em> with a <strong>Storage Class</strong> of <strong>StorageBuffer</strong>."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-None-06281",
|
|
"text": " <a href=\"#features-shaderSharedFloat32Atomics\"><code>shaderSharedFloat32Atomics</code></a>, or <a href=\"#features-shaderSharedFloat32AtomicAdd\"><code>shaderSharedFloat32AtomicAdd</code></a>, or <a href=\"#features-shaderSharedFloat64Atomics\"><code>shaderSharedFloat64Atomics</code></a>, or <a href=\"#features-shaderSharedFloat64AtomicAdd\"><code>shaderSharedFloat64AtomicAdd</code></a> <strong class=\"purple\">must</strong> be enabled for floating-point atomic operations to be supported on a <em>Pointer</em> with a <strong>Storage Class</strong> of <strong>Workgroup</strong>."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-None-06282",
|
|
"text": " <a href=\"#features-shaderImageFloat32Atomics\"><code>shaderImageFloat32Atomics</code></a> or <a href=\"#features-shaderImageFloat32AtomicAdd\"><code>shaderImageFloat32AtomicAdd</code></a> <strong class=\"purple\">must</strong> be enabled for 32-bit floating-point atomic operations to be supported on a <em>Pointer</em> with a <strong>Storage Class</strong> of <strong>Image</strong>."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-None-06283",
|
|
"text": " <a href=\"#features-sparseImageFloat32Atomics\"><code>sparseImageFloat32Atomics</code></a> or <a href=\"#features-sparseImageFloat32AtomicAdd\"><code>sparseImageFloat32AtomicAdd</code></a> <strong class=\"purple\">must</strong> be enabled for 32-bit floating-point atomics to be supported on sparse images."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-None-06335",
|
|
"text": " <a href=\"#features-shaderBufferFloat32Atomics\"><code>shaderBufferFloat32Atomics</code></a>, or <a href=\"#features-shaderBufferFloat32AtomicAdd\"><code>shaderBufferFloat32AtomicAdd</code></a>, or <a href=\"#features-shaderSharedFloat32Atomics\"><code>shaderSharedFloat32Atomics</code></a>, or <a href=\"#features-shaderSharedFloat32AtomicAdd\"><code>shaderSharedFloat32AtomicAdd</code></a>, or <a href=\"#features-shaderImageFloat32Atomics\"><code>shaderImageFloat32Atomics</code></a>, or <a href=\"#features-shaderImageFloat32AtomicAdd\"><code>shaderImageFloat32AtomicAdd</code></a> <strong class=\"purple\">must</strong> be enabled for 32-bit floating point atomic operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-None-06336",
|
|
"text": " <a href=\"#features-shaderBufferFloat64Atomics\"><code>shaderBufferFloat64Atomics</code></a>, or <a href=\"#features-shaderBufferFloat64AtomicAdd\"><code>shaderBufferFloat64AtomicAdd</code></a>, or <a href=\"#features-shaderSharedFloat64Atomics\"><code>shaderSharedFloat64Atomics</code></a>, or <a href=\"#features-shaderSharedFloat64AtomicAdd\"><code>shaderSharedFloat64AtomicAdd</code></a> <strong class=\"purple\">must</strong> be enabled for 64-bit floating point atomic operations"
|
|
}
|
|
],
|
|
"(VK_EXT_shader_atomic_float2)": [
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-None-06284",
|
|
"text": " <a href=\"#features-shaderBufferFloat32Atomics\"><code>shaderBufferFloat32Atomics</code></a>, or <a href=\"#features-shaderBufferFloat32AtomicAdd\"><code>shaderBufferFloat32AtomicAdd</code></a>, or <a href=\"#features-shaderBufferFloat64Atomics\"><code>shaderBufferFloat64Atomics</code></a>, or <a href=\"#features-shaderBufferFloat64AtomicAdd\"><code>shaderBufferFloat64AtomicAdd</code></a>, or <a href=\"#features-shaderBufferFloat16AtomicMinMax\"><code>shaderBufferFloat16Atomics</code></a>, or <a href=\"#features-shaderBufferFloat16AtomicMinMax\"><code>shaderBufferFloat16AtomicAdd</code></a>, or <a href=\"#features-shaderBufferFloat16AtomicMinMax\"><code>shaderBufferFloat16AtomicMinMax</code></a>, or <a href=\"#features-shaderBufferFloat32AtomicMinMax\"><code>shaderBufferFloat32AtomicMinMax</code></a>, or <a href=\"#features-shaderBufferFloat64AtomicMinMax\"><code>shaderBufferFloat64AtomicMinMax</code></a> <strong class=\"purple\">must</strong> be enabled for floating-point atomic operations to be supported on a <em>Pointer</em> with a <strong>Storage Class</strong> of <strong>StorageBuffer</strong>."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-None-06285",
|
|
"text": " <a href=\"#features-shaderSharedFloat32Atomics\"><code>shaderSharedFloat32Atomics</code></a>, or <a href=\"#features-shaderSharedFloat32AtomicAdd\"><code>shaderSharedFloat32AtomicAdd</code></a>, or <a href=\"#features-shaderSharedFloat64Atomics\"><code>shaderSharedFloat64Atomics</code></a>, or <a href=\"#features-shaderSharedFloat64AtomicAdd\"><code>shaderSharedFloat64AtomicAdd</code></a>, or <a href=\"#features-shaderBufferFloat16AtomicMinMax\"><code>shaderSharedFloat16Atomics</code></a>, or <a href=\"#features-shaderBufferFloat16AtomicMinMax\"><code>shaderSharedFloat16AtomicAdd</code></a>, or <a href=\"#features-shaderBufferFloat16AtomicMinMax\"><code>shaderSharedFloat16AtomicMinMax</code></a>, or <a href=\"#features-shaderSharedFloat32AtomicMinMax\"><code>shaderSharedFloat32AtomicMinMax</code></a>, or <a href=\"#features-shaderSharedFloat64AtomicMinMax\"><code>shaderSharedFloat64AtomicMinMax</code></a> <strong class=\"purple\">must</strong> be enabled for floating-point atomic operations to be supported on a <em>Pointer</em> with a <strong>Storage Class</strong> of <strong>Workgroup</strong>."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-None-06286",
|
|
"text": " <a href=\"#features-shaderImageFloat32Atomics\"><code>shaderImageFloat32Atomics</code></a>, or <a href=\"#features-shaderImageFloat32AtomicAdd\"><code>shaderImageFloat32AtomicAdd</code></a>, or <a href=\"#features-shaderImageFloat32AtomicMinMax\"><code>shaderImageFloat32AtomicMinMax</code></a> <strong class=\"purple\">must</strong> be enabled for 32-bit floating-point atomic operations to be supported on a <em>Pointer</em> with a <strong>Storage Class</strong> of <strong>Image</strong>."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-None-06287",
|
|
"text": " <a href=\"#features-sparseImageFloat32Atomics\"><code>sparseImageFloat32Atomics</code></a>, or <a href=\"#features-sparseImageFloat32AtomicAdd\"><code>sparseImageFloat32AtomicAdd</code></a>, or <a href=\"#features-sparseImageFloat32AtomicMinMax\"><code>sparseImageFloat32AtomicMinMax</code></a> <strong class=\"purple\">must</strong> be enabled for 32-bit floating-point atomics to be supported on sparse images."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-None-06337",
|
|
"text": " <a href=\"#features-shaderBufferFloat16Atomics\"><code>shaderBufferFloat16Atomics</code></a>, or <a href=\"#features-shaderBufferFloat16AtomicAdd\"><code>shaderBufferFloat16AtomicAdd</code></a>, or <a href=\"#features-shaderBufferFloat16AtomicMinMax\"><code>shaderBufferFloat16AtomicMinMax</code></a>, or <a href=\"#features-shaderSharedFloat16Atomics\"><code>shaderSharedFloat16Atomics</code></a>, or <a href=\"#features-shaderSharedFloat16AtomicAdd\"><code>shaderSharedFloat16AtomicAdd</code></a>, or <a href=\"#features-shaderSharedFloat16AtomicMinMax\"><code>shaderSharedFloat16AtomicMinMax</code></a> <strong class=\"purple\">must</strong> be enabled for 16-bit floating point atomic operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-None-06338",
|
|
"text": " <a href=\"#features-shaderBufferFloat32Atomics\"><code>shaderBufferFloat32Atomics</code></a>, or <a href=\"#features-shaderBufferFloat32AtomicAdd\"><code>shaderBufferFloat32AtomicAdd</code></a>, or <a href=\"#features-shaderSharedFloat32Atomics\"><code>shaderSharedFloat32Atomics</code></a>, or <a href=\"#features-shaderSharedFloat32AtomicAdd\"><code>shaderSharedFloat32AtomicAdd</code></a>, or <a href=\"#features-shaderImageFloat32Atomics\"><code>shaderImageFloat32Atomics</code></a>, or <a href=\"#features-shaderImageFloat32AtomicAdd\"><code>shaderImageFloat32AtomicAdd</code></a> or <a href=\"#features-shaderBufferFloat32AtomicMinMax\"><code>shaderBufferFloat32AtomicMinMax</code></a>, or <a href=\"#features-shaderSharedFloat32AtomicMinMax\"><code>shaderSharedFloat32AtomicMinMax</code></a>, or <a href=\"#features-shaderImageFloat32AtomicMinMax\"><code>shaderImageFloat32AtomicMinMax</code></a> <strong class=\"purple\">must</strong> be enabled for 32-bit floating point atomic operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-None-06339",
|
|
"text": " <a href=\"#features-shaderBufferFloat64Atomics\"><code>shaderBufferFloat64Atomics</code></a>, or <a href=\"#features-shaderBufferFloat64AtomicAdd\"><code>shaderBufferFloat64AtomicAdd</code></a>, or <a href=\"#features-shaderSharedFloat64Atomics\"><code>shaderSharedFloat64Atomics</code></a>, or <a href=\"#features-shaderSharedFloat64AtomicAdd\"><code>shaderSharedFloat64AtomicAdd</code></a>, or <a href=\"#features-shaderBufferFloat64AtomicMinMax\"><code>shaderBufferFloat64AtomicMinMax</code></a>, or <a href=\"#features-shaderSharedFloat64AtomicMinMax\"><code>shaderSharedFloat64AtomicMinMax</code></a>, <strong class=\"purple\">must</strong> be enabled for 64-bit floating point atomic operations"
|
|
}
|
|
],
|
|
"(VK_EXT_shader_image_atomic_int64)": [
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-None-06288",
|
|
"text": " <a href=\"#features-shaderImageInt64Atomics\"><code>shaderImageInt64Atomics</code></a> <strong class=\"purple\">must</strong> be enabled for 64-bit integer atomic operations to be supported on a <em>Pointer</em> with a <strong>Storage Class</strong> of <strong>Image</strong>."
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_KHR_shader_float_controls)": [
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-denormBehaviorIndependence-06289",
|
|
"text": " If <a href=\"#features-denormBehaviorIndependence\"><code>denormBehaviorIndependence</code></a> is <code>VK_SHADER_FLOAT_CONTROLS_INDEPENDENCE_32_BIT_ONLY</code>, then the entry point <strong class=\"purple\">must</strong> use the same denormals execution mode for both 16-bit and 64-bit floating-point types."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-denormBehaviorIndependence-06290",
|
|
"text": " If <a href=\"#features-denormBehaviorIndependence\"><code>denormBehaviorIndependence</code></a> is <code>VK_SHADER_FLOAT_CONTROLS_INDEPENDENCE_NONE</code>, then the entry point <strong class=\"purple\">must</strong> use the same denormals execution mode for all floating-point types."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-roundingModeIndependence-06291",
|
|
"text": " If <a href=\"#features-roundingModeIndependence\"><code>roundingModeIndependence</code></a> is <code>VK_SHADER_FLOAT_CONTROLS_INDEPENDENCE_32_BIT_ONLY</code>, then the entry point <strong class=\"purple\">must</strong> use the same rounding execution mode for both 16-bit and 64-bit floating-point types."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-roundingModeIndependence-06292",
|
|
"text": " If <a href=\"#features-roundingModeIndependence\"><code>roundingModeIndependence</code></a> is <code>VK_SHADER_FLOAT_CONTROLS_INDEPENDENCE_NONE</code>, then the entry point <strong class=\"purple\">must</strong> use the same rounding execution mode for all floating-point types."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-shaderSignedZeroInfNanPreserveFloat16-06293",
|
|
"text": " If <a href=\"#limits-shaderSignedZeroInfNanPreserveFloat16\"><code>shaderSignedZeroInfNanPreserveFloat16</code></a> is <code>VK_FALSE</code>, then <code>SignedZeroInfNanPreserve</code> for 16-bit floating-point type <strong class=\"purple\">must</strong> not be used."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-shaderSignedZeroInfNanPreserveFloat32-06294",
|
|
"text": " If <a href=\"#limits-shaderSignedZeroInfNanPreserveFloat32\"><code>shaderSignedZeroInfNanPreserveFloat32</code></a> is <code>VK_FALSE</code>, then <code>SignedZeroInfNanPreserve</code> for 32-bit floating-point type <strong class=\"purple\">must</strong> not be used."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-shaderSignedZeroInfNanPreserveFloat64-06295",
|
|
"text": " If <a href=\"#limits-shaderSignedZeroInfNanPreserveFloat64\"><code>shaderSignedZeroInfNanPreserveFloat64</code></a> is <code>VK_FALSE</code>, then <code>SignedZeroInfNanPreserve</code> for 64-bit floating-point type <strong class=\"purple\">must</strong> not be used."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-shaderDenormPreserveFloat16-06296",
|
|
"text": " If <a href=\"#limits-shaderDenormPreserveFloat16\"><code>shaderDenormPreserveFloat16</code></a> is <code>VK_FALSE</code>, then <code>DenormPreserve</code> for 16-bit floating-point type <strong class=\"purple\">must</strong> not be used."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-shaderDenormPreserveFloat32-06297",
|
|
"text": " If <a href=\"#limits-shaderDenormPreserveFloat32\"><code>shaderDenormPreserveFloat32</code></a> is <code>VK_FALSE</code>, then <code>DenormPreserve</code> for 32-bit floating-point type <strong class=\"purple\">must</strong> not be used."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-shaderDenormPreserveFloat64-06298",
|
|
"text": " If <a href=\"#limits-shaderDenormPreserveFloat64\"><code>shaderDenormPreserveFloat64</code></a> is <code>VK_FALSE</code>, then <code>DenormPreserve</code> for 64-bit floating-point type <strong class=\"purple\">must</strong> not be used."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-shaderDenormFlushToZeroFloat16-06299",
|
|
"text": " If <a href=\"#limits-shaderDenormFlushToZeroFloat16\"><code>shaderDenormFlushToZeroFloat16</code></a> is <code>VK_FALSE</code>, then <code>DenormFlushToZero</code> for 16-bit floating-point type <strong class=\"purple\">must</strong> not be used."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-shaderDenormFlushToZeroFloat32-06300",
|
|
"text": " If <a href=\"#limits-shaderDenormFlushToZeroFloat32\"><code>shaderDenormFlushToZeroFloat32</code></a> is <code>VK_FALSE</code>, then <code>DenormFlushToZero</code> for 32-bit floating-point type <strong class=\"purple\">must</strong> not be used."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-shaderDenormFlushToZeroFloat64-06301",
|
|
"text": " If <a href=\"#limits-shaderDenormFlushToZeroFloat64\"><code>shaderDenormFlushToZeroFloat64</code></a> is <code>VK_FALSE</code>, then <code>DenormFlushToZero</code> for 64-bit floating-point type <strong class=\"purple\">must</strong> not be used."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-shaderRoundingModeRTEFloat16-06302",
|
|
"text": " If <a href=\"#limits-shaderRoundingModeRTEFloat16\"><code>shaderRoundingModeRTEFloat16</code></a> is <code>VK_FALSE</code>, then <code>RoundingModeRTE</code> for 16-bit floating-point type <strong class=\"purple\">must</strong> not be used."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-shaderRoundingModeRTEFloat32-06303",
|
|
"text": " If <a href=\"#limits-shaderRoundingModeRTEFloat32\"><code>shaderRoundingModeRTEFloat32</code></a> is <code>VK_FALSE</code>, then <code>RoundingModeRTE</code> for 32-bit floating-point type <strong class=\"purple\">must</strong> not be used."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-shaderRoundingModeRTEFloat64-06304",
|
|
"text": " If <a href=\"#limits-shaderRoundingModeRTEFloat64\"><code>shaderRoundingModeRTEFloat64</code></a> is <code>VK_FALSE</code>, then <code>RoundingModeRTE</code> for 64-bit floating-point type <strong class=\"purple\">must</strong> not be used."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-shaderRoundingModeRTZFloat16-06305",
|
|
"text": " If <a href=\"#limits-shaderRoundingModeRTZFloat16\"><code>shaderRoundingModeRTZFloat16</code></a> is <code>VK_FALSE</code>, then <code>RoundingModeRTZ</code> for 16-bit floating-point type <strong class=\"purple\">must</strong> not be used."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-shaderRoundingModeRTZFloat32-06306",
|
|
"text": " If <a href=\"#limits-shaderRoundingModeRTZFloat32\"><code>shaderRoundingModeRTZFloat32</code></a> is <code>VK_FALSE</code>, then <code>RoundingModeRTZ</code> for 32-bit floating-point type <strong class=\"purple\">must</strong> not be used."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-shaderRoundingModeRTZFloat64-06307",
|
|
"text": " If <a href=\"#limits-shaderRoundingModeRTZFloat64\"><code>shaderRoundingModeRTZFloat64</code></a> is <code>VK_FALSE</code>, then <code>RoundingModeRTZ</code> for 64-bit floating-point type <strong class=\"purple\">must</strong> not be used."
|
|
}
|
|
],
|
|
"(VK_EXT_transform_feedback)": [
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-Offset-06308",
|
|
"text": " The <code>Offset</code> plus size of the type of each variable, in the output interface of the entry point being compiled, decorated with <code>XfbBuffer</code> <strong class=\"purple\">must</strong> not be greater than <code>VkPhysicalDeviceTransformFeedbackPropertiesEXT</code>::<code>maxTransformFeedbackBufferDataSize</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-XfbBuffer-06309",
|
|
"text": " For any given <code>XfbBuffer</code> value, define the buffer data size to be smallest number of bytes such that, for all outputs decorated with the same <code>XfbBuffer</code> value, the size of the output interface variable plus the <code>Offset</code> is less than or equal to the buffer data size. For a given <code>Stream</code>, the sum of all the buffer data sizes for all buffers writing to that stream the <strong class=\"purple\">must</strong> not exceed <code>VkPhysicalDeviceTransformFeedbackPropertiesEXT</code>::<code>maxTransformFeedbackStreamDataSize</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-OpEmitStreamVertex-06310",
|
|
"text": " The Stream value to <code>OpEmitStreamVertex</code> and <code>OpEndStreamPrimitive</code> <strong class=\"purple\">must</strong> be less than <code>VkPhysicalDeviceTransformFeedbackPropertiesEXT</code>::<code>maxTransformFeedbackStreams</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-transformFeedbackStreamsLinesTriangles-06311",
|
|
"text": " If the geometry shader emits to more than one vertex stream and <code>VkPhysicalDeviceTransformFeedbackPropertiesEXT</code>::<code>transformFeedbackStreamsLinesTriangles</code> is <code>VK_FALSE</code>, then execution mode <strong class=\"purple\">must</strong> be <code>OutputPoints</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-Stream-06312",
|
|
"text": " The stream number value to <code>Stream</code> <strong class=\"purple\">must</strong> be less than <code>VkPhysicalDeviceTransformFeedbackPropertiesEXT</code>::<code>maxTransformFeedbackStreams</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-XfbStride-06313",
|
|
"text": " The XFB Stride value to <code>XfbStride</code> <strong class=\"purple\">must</strong> be less than or equal to <code>VkPhysicalDeviceTransformFeedbackPropertiesEXT</code>::<code>maxTransformFeedbackBufferDataStride</code>"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_2,VK_EXT_buffer_device_address,VK_KHR_buffer_device_address)": [
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-PhysicalStorageBuffer64-06314",
|
|
"text": " If the <code>PhysicalStorageBuffer64</code> addressing model is enabled any load or store through a physical pointer type <strong class=\"purple\">must</strong> be aligned to a multiple of the size of the largest scalar type in the pointed-to type."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-PhysicalStorageBuffer64-06315",
|
|
"text": " If the <code>PhysicalStorageBuffer64</code> addressing model is enabled the pointer value of a memory access instruction <strong class=\"purple\">must</strong> be at least as aligned as specified by the <code>Aligned</code> memory access operand."
|
|
}
|
|
],
|
|
"(VK_NV_cooperative_matrix)": [
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-OpTypeCooperativeMatrixNV-06316",
|
|
"text": " For <code>OpTypeCooperativeMatrixNV</code>, the component type, scope, number of rows, and number of columns <strong class=\"purple\">must</strong> match one of the matrices in any of the supported <a href=\"#VkCooperativeMatrixPropertiesNV\">VkCooperativeMatrixPropertiesNV</a>."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-OpCooperativeMatrixMulAddNV-06317",
|
|
"text": " For <code>OpCooperativeMatrixMulAddNV</code>, the type of <code>A</code> <strong class=\"purple\">must</strong> have <a href=\"#VkCooperativeMatrixPropertiesNV\">VkCooperativeMatrixPropertiesNV</a>::<code>MSize</code> rows and <a href=\"#VkCooperativeMatrixPropertiesNV\">VkCooperativeMatrixPropertiesNV</a>::<code>KSize</code> columns and have a component type that matches <a href=\"#VkCooperativeMatrixPropertiesNV\">VkCooperativeMatrixPropertiesNV</a>::<code>AType</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-OpCooperativeMatrixMulAddNV-06318",
|
|
"text": " For <code>OpCooperativeMatrixMulAddNV</code>, the type of <code>B</code> <strong class=\"purple\">must</strong> have <a href=\"#VkCooperativeMatrixPropertiesNV\">VkCooperativeMatrixPropertiesNV</a>::<code>KSize</code> rows and <a href=\"#VkCooperativeMatrixPropertiesNV\">VkCooperativeMatrixPropertiesNV</a>::<code>NSize</code> columns and have a component type that matches <a href=\"#VkCooperativeMatrixPropertiesNV\">VkCooperativeMatrixPropertiesNV</a>::<code>BType</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-OpCooperativeMatrixMulAddNV-06319",
|
|
"text": " For <code>OpCooperativeMatrixMulAddNV</code>, the type of <code>C</code> <strong class=\"purple\">must</strong> have <a href=\"#VkCooperativeMatrixPropertiesNV\">VkCooperativeMatrixPropertiesNV</a>::<code>MSize</code> rows and <a href=\"#VkCooperativeMatrixPropertiesNV\">VkCooperativeMatrixPropertiesNV</a>::<code>NSize</code> columns and have a component type that matches <a href=\"#VkCooperativeMatrixPropertiesNV\">VkCooperativeMatrixPropertiesNV</a>::<code>CType</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-OpCooperativeMatrixMulAddNV-06320",
|
|
"text": " For <code>OpCooperativeMatrixMulAddNV</code>, the type of <code>Result</code> <strong class=\"purple\">must</strong> have <a href=\"#VkCooperativeMatrixPropertiesNV\">VkCooperativeMatrixPropertiesNV</a>::<code>MSize</code> rows and <a href=\"#VkCooperativeMatrixPropertiesNV\">VkCooperativeMatrixPropertiesNV</a>::<code>NSize</code> columns and have a component type that matches <a href=\"#VkCooperativeMatrixPropertiesNV\">VkCooperativeMatrixPropertiesNV</a>::<code>DType</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-OpCooperativeMatrixMulAddNV-06321",
|
|
"text": " For <code>OpCooperativeMatrixMulAddNV</code>, the type of <code>A</code>, <code>B</code>, <code>C</code>, and <code>Result</code> <strong class=\"purple\">must</strong> all have a scope of <code>scope</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-OpTypeCooperativeMatrixNV-06322",
|
|
"text": " <code>OpTypeCooperativeMatrixNV</code> and <code>OpCooperativeMatrix*</code> instructions <strong class=\"purple\">must</strong> not be used in shader stages not included in <a href=\"#VkPhysicalDeviceCooperativeMatrixPropertiesNV\">VkPhysicalDeviceCooperativeMatrixPropertiesNV</a>::<code>cooperativeMatrixSupportedStages</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-OpCooperativeMatrixLoadNV-06324",
|
|
"text": " For <code>OpCooperativeMatrixLoadNV</code> and <code>OpCooperativeMatrixStoreNV</code> instructions, the <code>Pointer</code> and <code>Stride</code> operands <strong class=\"purple\">must</strong> be aligned to at least the lesser of 16 bytes or the natural alignment of a row or column (depending on <code>ColumnMajor</code>) of the matrix (where the natural alignment is the number of columns/rows multiplied by the component size)."
|
|
}
|
|
],
|
|
"(VK_KHR_portability_subset)": [
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-shaderSampleRateInterpolationFunctions-06325",
|
|
"text": " If the <code><a href=\"#VK_KHR_portability_subset\">VK_KHR_portability_subset</a></code> extension is enabled, and <a href=\"#VkPhysicalDevicePortabilitySubsetFeaturesKHR\">VkPhysicalDevicePortabilitySubsetFeaturesKHR</a>::<code>shaderSampleRateInterpolationFunctions</code> is <code>VK_FALSE</code>, then <code>GLSL.std.450</code> fragment interpolation functions are not supported by the implementation and <code>OpCapability</code> <strong class=\"purple\">must</strong> not be set to <code>InterpolationFunction</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-tessellationShader-06326",
|
|
"text": " If <a href=\"#features-tessellationShader\"><code>tessellationShader</code></a> is enabled, and the <code><a href=\"#VK_KHR_portability_subset\">VK_KHR_portability_subset</a></code> extension is enabled, and <a href=\"#VkPhysicalDevicePortabilitySubsetFeaturesKHR\">VkPhysicalDevicePortabilitySubsetFeaturesKHR</a>::<code>tessellationIsolines</code> is <code>VK_FALSE</code>, then <code>OpExecutionMode</code> <strong class=\"purple\">must</strong> not be set to <code>IsoLines</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-tessellationShader-06327",
|
|
"text": " If <a href=\"#features-tessellationShader\"><code>tessellationShader</code></a> is enabled, and the <code><a href=\"#VK_KHR_portability_subset\">VK_KHR_portability_subset</a></code> extension is enabled, and <a href=\"#VkPhysicalDevicePortabilitySubsetFeaturesKHR\">VkPhysicalDevicePortabilitySubsetFeaturesKHR</a>::<code>tessellationPointMode</code> is <code>VK_FALSE</code>, then <code>OpExecutionMode</code> <strong class=\"purple\">must</strong> not be set to <code>PointMode</code>."
|
|
}
|
|
],
|
|
"(VK_KHR_8bit_storage)": [
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-storageBuffer8BitAccess-06328",
|
|
"text": " If <a href=\"#features-storageBuffer8BitAccess\"><code>storageBuffer8BitAccess</code></a> is <code>VK_FALSE</code>, then objects containing an 8-bit integer element <strong class=\"purple\">must</strong> not have storage class of <strong>StorageBuffer</strong>, <strong>ShaderRecordBufferKHR</strong>, or <strong>PhysicalStorageBuffer</strong>."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-uniformAndStorageBuffer8BitAccess-06329",
|
|
"text": " If <a href=\"#features-uniformAndStorageBuffer8BitAccess\"><code>uniformAndStorageBuffer8BitAccess</code></a> is <code>VK_FALSE</code>, then objects in the <strong>Uniform</strong> storage class with the <strong>Block</strong> decoration <strong class=\"purple\">must</strong> not have an 8-bit integer member."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-storagePushConstant8-06330",
|
|
"text": " If <a href=\"#features-storagePushConstant8\"><code>storagePushConstant8</code></a> is <code>VK_FALSE</code>, then objects containing an 8-bit integer element <strong class=\"purple\">must</strong> not have storage class of <strong>PushConstant</strong>."
|
|
}
|
|
],
|
|
"(VK_KHR_16bit_storage)": [
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-storageBuffer16BitAccess-06331",
|
|
"text": " If <a href=\"#features-storageBuffer16BitAccess\"><code>storageBuffer16BitAccess</code></a> is <code>VK_FALSE</code>, then objects containing 16-bit integer or 16-bit floating-point elements <strong class=\"purple\">must</strong> not have storage class of <strong>StorageBuffer</strong>, <strong>ShaderRecordBufferKHR</strong>, or <strong>PhysicalStorageBuffer</strong>."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-uniformAndStorageBuffer16BitAccess-06332",
|
|
"text": " If <a href=\"#features-uniformAndStorageBuffer16BitAccess\"><code>uniformAndStorageBuffer16BitAccess</code></a> is <code>VK_FALSE</code>, then objects in the <strong>Uniform</strong> storage class with the <strong>Block</strong> decoration <strong class=\"purple\">must</strong> not have 16-bit integer or 16-bit floating-point members."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-storagePushConstant16-06333",
|
|
"text": " If <a href=\"#features-storagePushConstant16\"><code>storagePushConstant16</code></a> is <code>VK_FALSE</code>, then objects containing 16-bit integer or 16-bit floating-point elements <strong class=\"purple\">must</strong> not have storage class of <strong>PushConstant</strong>."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-storageInputOutput16-06334",
|
|
"text": " If <a href=\"#features-storageInputOutput16\"><code>storageInputOutput16</code></a> is <code>VK_FALSE</code>, then objects containing 16-bit integer or 16-bit floating-point elements <strong class=\"purple\">must</strong> not have storage class of <strong>Input</strong> or <strong>Output</strong>."
|
|
}
|
|
],
|
|
"(VK_VERSION_1_1)": [
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-None-06343",
|
|
"text": " <a href=\"#shaders-group-operations\">Group operations</a> with <a href=\"#shaders-scope-subgroup\">subgroup scope</a> <strong class=\"purple\">must</strong> not be used if the shader stage is not in <a href=\"#limits-subgroupSupportedStages\">subgroupSupportedStages</a>."
|
|
}
|
|
],
|
|
"(VK_KHR_ray_query)": [
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-OpRayQueryInitializeKHR-06348",
|
|
"text": " For <code>OpRayQueryInitializeKHR</code> instructions, all components of the <code>RayOrigin</code> and <code>RayDirection</code> operands <strong class=\"purple\">must</strong> be finite floating-point values."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-OpRayQueryInitializeKHR-06349",
|
|
"text": " For <code>OpRayQueryInitializeKHR</code> instructions, the <code>RayTmin</code> and <code>RayTmax</code> operands <strong class=\"purple\">must</strong> be non-negative floating-point values."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-OpRayQueryInitializeKHR-06350",
|
|
"text": " For <code>OpRayQueryInitializeKHR</code> instructions, the <code>RayTmin</code> operand <strong class=\"purple\">must</strong> be less than or equal to the <code>RayTmax</code> operand."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-OpRayQueryInitializeKHR-06351",
|
|
"text": " For <code>OpRayQueryInitializeKHR</code> instructions, <code>RayOrigin</code>, <code>RayDirection</code>, <code>RayTmin</code>, and <code>RayTmax</code> operands <strong class=\"purple\">must</strong> not contain NaNs."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-OpRayQueryInitializeKHR-06352",
|
|
"text": " For <code>OpRayQueryInitializeKHR</code> instructions, <code>Acceleration</code> <code>Structure</code> <strong class=\"purple\">must</strong> be an acceleration structure built as a <a href=\"#acceleration-structure-top-level\">top-level acceleration structure</a>."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-OpRayQueryInitializeKHR-06889",
|
|
"text": " For <code>OpRayQueryInitializeKHR</code> instructions, the <code>Rayflags</code> operand <strong class=\"purple\">must</strong> not contain both <code>SkipTrianglesKHR</code> and <code>SkipAABBsKHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-OpRayQueryInitializeKHR-06890",
|
|
"text": " For <code>OpRayQueryInitializeKHR</code> instructions, the <code>Rayflags</code> operand <strong class=\"purple\">must</strong> not contain more than one of <code>SkipTrianglesKHR</code>, <code>CullBackFacingTrianglesKHR</code>, and <code>CullFrontFacingTrianglesKHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-OpRayQueryInitializeKHR-06891",
|
|
"text": " For <code>OpRayQueryInitializeKHR</code> instructions, the <code>Rayflags</code> operand <strong class=\"purple\">must</strong> not contain more than one of <code>OpaqueKHR</code>, <code>NoOpaqueKHR</code>, <code>CullOpaqueKHR</code>, and <code>CullNoOpaqueKHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-OpRayQueryGenerateIntersectionKHR-06353",
|
|
"text": " For <code>OpRayQueryGenerateIntersectionKHR</code> instructions, <code>Hit</code> <code>T</code> <strong class=\"purple\">must</strong> satisfy the condition <span class=\"eq\"><code>RayTmin</code> {leq} <code>Hit</code> <code>T</code> {leq} <code>RayTmax</code></span>, where <code>RayTmin</code> is equal to the value returned by <code>OpRayQueryGetRayTMinKHR</code> with the same ray query object, and <code>RayTmax</code> is equal to the value of <code>OpRayQueryGetIntersectionTKHR</code> for the current committed intersection with the same ray query object."
|
|
}
|
|
],
|
|
"(VK_KHR_ray_query)+(VK_NV_ray_tracing_motion_blur)": [
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-OpRayQueryGenerateIntersectionKHR-06354",
|
|
"text": " For <code>OpRayQueryGenerateIntersectionKHR</code> instructions, <code>Acceleration</code> <code>Structure</code> <strong class=\"purple\">must</strong> not be built with <code>VK_BUILD_ACCELERATION_STRUCTURE_MOTION_BIT_NV</code> in <code>flags</code>."
|
|
}
|
|
],
|
|
"(VK_KHR_ray_tracing_pipeline)": [
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-OpTraceRayKHR-06355",
|
|
"text": " For <code>OpTraceRayKHR</code> instructions, all components of the <code>RayOrigin</code> and <code>RayDirection</code> operands <strong class=\"purple\">must</strong> be finite floating-point values."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-OpTraceRayKHR-06356",
|
|
"text": " For <code>OpTraceRayKHR</code> instructions, the <code>RayTmin</code> and <code>RayTmax</code> operands <strong class=\"purple\">must</strong> be non-negative floating-point values."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-OpTraceRayKHR-06552",
|
|
"text": " For <code>OpTraceRayKHR</code> instructions, the <code>Rayflags</code> operand <strong class=\"purple\">must</strong> not contain both <code>SkipTrianglesKHR</code> and <code>SkipAABBsKHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-OpTraceRayKHR-06892",
|
|
"text": " For <code>OpTraceRayKHR</code> instructions, the <code>Rayflags</code> operand <strong class=\"purple\">must</strong> not contain more than one of <code>SkipTrianglesKHR</code>, <code>CullBackFacingTrianglesKHR</code>, and <code>CullFrontFacingTrianglesKHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-OpTraceRayKHR-06893",
|
|
"text": " For <code>OpTraceRayKHR</code> instructions, the <code>Rayflags</code> operand <strong class=\"purple\">must</strong> not contain more than one of <code>OpaqueKHR</code>, <code>NoOpaqueKHR</code>, <code>CullOpaqueKHR</code>, and <code>CullNoOpaqueKHR</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-OpTraceRayKHR-06553",
|
|
"text": " For <code>OpTraceRayKHR</code> instructions, if the <code>Rayflags</code> operand contains <code>SkipTrianglesKHR</code>, the pipeline <strong class=\"purple\">must</strong> not have been created with <code>VK_PIPELINE_CREATE_RAY_TRACING_SKIP_AABBS_BIT_KHR</code> set"
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-OpTraceRayKHR-06554",
|
|
"text": " For <code>OpTraceRayKHR</code> instructions, if the <code>Rayflags</code> operand contains <code>SkipAABBsKHR</code>, the pipeline <strong class=\"purple\">must</strong> not have been created with <code>VK_PIPELINE_CREATE_RAY_TRACING_SKIP_TRIANGLES_BIT_KHR</code> set"
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-OpTraceRayKHR-06357",
|
|
"text": " For <code>OpTraceRayKHR</code> instructions, the <code>RayTmin</code> operand <strong class=\"purple\">must</strong> be less than or equal to the <code>RayTmax</code> operand."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-OpTraceRayKHR-06358",
|
|
"text": " For <code>OpTraceRayKHR</code> instructions, <code>RayOrigin</code>, <code>RayDirection</code>, <code>RayTmin</code>, and <code>RayTmax</code> operands <strong class=\"purple\">must</strong> not contain NaNs."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-OpTraceRayKHR-06359",
|
|
"text": " For <code>OpTraceRayKHR</code> instructions, <code>Acceleration</code> <code>Structure</code> <strong class=\"purple\">must</strong> be an acceleration structure built as a <a href=\"#acceleration-structure-top-level\">top-level acceleration structure</a>."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-OpReportIntersectionKHR-06998",
|
|
"text": " The value of the “Hit Kind” operand of <code>OpReportIntersectionKHR</code> <strong class=\"purple\">must</strong> be in the range <span class=\"eq\">[0,127]</span>"
|
|
}
|
|
],
|
|
"(VK_NV_ray_tracing_motion_blur)": [
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-OpTraceRayKHR-06360",
|
|
"text": " For <code>OpTraceRayKHR</code> instructions, if <code>Acceleration</code> <code>Structure</code> was built with <code>VK_BUILD_ACCELERATION_STRUCTURE_MOTION_BIT_NV</code> in <code>flags</code>, the pipeline <strong class=\"purple\">must</strong> have been created with <code>VK_PIPELINE_CREATE_RAY_TRACING_ALLOW_MOTION_BIT_NV</code> set"
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-OpTraceRayMotionNV-06361",
|
|
"text": " For <code>OpTraceRayMotionNV</code> instructions, all components of the <code>RayOrigin</code> and <code>RayDirection</code> operands <strong class=\"purple\">must</strong> be finite floating-point values."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-OpTraceRayMotionNV-06362",
|
|
"text": " For <code>OpTraceRayMotionNV</code> instructions, the <code>RayTmin</code> and <code>RayTmax</code> operands <strong class=\"purple\">must</strong> be non-negative floating-point values."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-OpTraceRayMotionNV-06363",
|
|
"text": " For <code>OpTraceRayMotionNV</code> instructions, the <code>RayTmin</code> operand <strong class=\"purple\">must</strong> be less than or equal to the <code>RayTmax</code> operand."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-OpTraceRayMotionNV-06364",
|
|
"text": " For <code>OpTraceRayMotionNV</code> instructions, <code>RayOrigin</code>, <code>RayDirection</code>, <code>RayTmin</code>, and <code>RayTmax</code> operands <strong class=\"purple\">must</strong> not contain NaNs."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-OpTraceRayMotionNV-06365",
|
|
"text": " For <code>OpTraceRayMotionNV</code> instructions, <code>Acceleration</code> <code>Structure</code> <strong class=\"purple\">must</strong> be an acceleration structure built as a <a href=\"#acceleration-structure-top-level\">top-level acceleration structure</a> with <code>VK_BUILD_ACCELERATION_STRUCTURE_MOTION_BIT_NV</code> in <code>flags</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-OpTraceRayMotionNV-06366",
|
|
"text": " For <code>OpTraceRayMotionNV</code> instructions the <code>time</code> operand <strong class=\"purple\">must</strong> be between 0.0 and 1.0"
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-OpTraceRayMotionNV-06367",
|
|
"text": " For <code>OpTraceRayMotionNV</code> instructions the pipeline <strong class=\"purple\">must</strong> have been created with <code>VK_PIPELINE_CREATE_RAY_TRACING_ALLOW_MOTION_BIT_NV</code> set"
|
|
}
|
|
],
|
|
"!(VK_VERSION_1_3,VK_KHR_maintenance4)": [
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-LocalSizeId-06433",
|
|
"text": " The execution mode <code>LocalSizeId</code> <strong class=\"purple\">must</strong> not be used"
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-OpTypeVector-06816",
|
|
"text": " Any <code>OpTypeVector</code> output interface variables <strong class=\"purple\">must</strong> not have a higher <code>Component</code> <code>Count</code> than a matching <code>OpTypeVector</code> input interface variable"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_maintenance4)": [
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-LocalSizeId-06434",
|
|
"text": " If execution mode <code>LocalSizeId</code> is used, <a href=\"#features-maintenance4\"><code>maintenance4</code></a> <strong class=\"purple\">must</strong> be enabled"
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-maintenance4-06817",
|
|
"text": " If <a href=\"#features-maintenance4\"><code>maintenance4</code></a> is not enabled, any <code>OpTypeVector</code> output interface variables <strong class=\"purple\">must</strong> not have a higher <code>Component</code> <code>Count</code> than a matching <code>OpTypeVector</code> input interface variable"
|
|
}
|
|
],
|
|
"(VK_VERSION_1_3,VK_KHR_zero_initialize_workgroup_memory)": [
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-shaderZeroInitializeWorkgroupMemory-06372",
|
|
"text": " If <a href=\"#features-shaderZeroInitializeWorkgroupMemory\"><code>shaderZeroInitializeWorkgroupMemory</code></a> is not enabled, any <code>OpVariable</code> with <strong>Workgroup</strong> as its <strong>Storage Class</strong> <strong class=\"purple\">must</strong> not have an <code>Initializer</code> operand"
|
|
}
|
|
],
|
|
"!(VK_VERSION_1_3,VK_KHR_zero_initialize_workgroup_memory)": [
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-OpVariable-06373",
|
|
"text": " Any <code>OpVariable</code> with <strong>Workgroup</strong> as its <strong>Storage Class</strong> <strong class=\"purple\">must</strong> not have an <code>Initializer</code> operand"
|
|
}
|
|
],
|
|
"(VK_QCOM_render_pass_shader_resolve)": [
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-SampleRateShading-06378",
|
|
"text": " If the subpass description contains <code>VK_SUBPASS_DESCRIPTION_FRAGMENT_REGION_BIT_QCOM</code>, then the SPIR-V fragment shader Capability <code>SampleRateShading</code> <strong class=\"purple\">must</strong> not be enabled."
|
|
}
|
|
],
|
|
"(VK_KHR_shader_subgroup_uniform_control_flow)": [
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-SubgroupUniformControlFlowKHR-06379",
|
|
"text": " The execution mode <code>SubgroupUniformControlFlowKHR</code> <strong class=\"purple\">must</strong> not be applied to an entry point unless <a href=\"#features-shaderSubgroupUniformControlFlow\"><code>shaderSubgroupUniformControlFlow</code></a> is enabled and the corresponding shader stage bit is set in subgroup <a href=\"#limits-subgroup-supportedStages\"><code>supportedStages</code></a> and the entry point does not execute any <a href=\"#ray-tracing-repack\"><em>invocation repack instructions</em></a>."
|
|
}
|
|
],
|
|
"(VK_AMD_shader_early_and_late_fragment_tests)": [
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-shaderEarlyAndLateFragmentTests-06767",
|
|
"text": " If <a href=\"#features-shaderEarlyAndLateFragmentTests\"><code>shaderEarlyAndLateFragmentTests</code></a> is not enabled, the <code>EarlyAndLateFragmentTestsEXT</code> <code>Execution</code> <code>Mode</code> <strong class=\"purple\">must</strong> not be used."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-shaderEarlyAndLateFragmentTests-06768",
|
|
"text": " If <a href=\"#features-shaderEarlyAndLateFragmentTests\"><code>shaderEarlyAndLateFragmentTests</code></a> feature is not enabled, the <code>StencilRefUnchangedFrontEXT</code> <code>Execution</code> <code>Mode</code> <strong class=\"purple\">must</strong> not be used."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-shaderEarlyAndLateFragmentTests-06769",
|
|
"text": " If <a href=\"#features-shaderEarlyAndLateFragmentTests\"><code>shaderEarlyAndLateFragmentTests</code></a> is not enabled, the <code>StencilRefUnchangedBackEXT</code> <code>Execution</code> <code>Mode</code> <strong class=\"purple\">must</strong> not be used."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-shaderEarlyAndLateFragmentTests-06770",
|
|
"text": " If <a href=\"#features-shaderEarlyAndLateFragmentTests\"><code>shaderEarlyAndLateFragmentTests</code></a> is not enabled, the <code>StencilRefGreaterFrontEXT</code> <code>Execution</code> <code>Mode</code> <strong class=\"purple\">must</strong> not be used."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-shaderEarlyAndLateFragmentTests-06771",
|
|
"text": " If <a href=\"#features-shaderEarlyAndLateFragmentTests\"><code>shaderEarlyAndLateFragmentTests</code></a> is not enabled, the <code>StencilRefGreaterBackEXT</code> <code>Execution</code> <code>Mode</code> <strong class=\"purple\">must</strong> not be used."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-shaderEarlyAndLateFragmentTests-06772",
|
|
"text": " If <a href=\"#features-shaderEarlyAndLateFragmentTests\"><code>shaderEarlyAndLateFragmentTests</code></a> is not enabled, the <code>StencilRefLessFrontEXT</code> <code>Execution</code> <code>Mode</code> <strong class=\"purple\">must</strong> not be used."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-shaderEarlyAndLateFragmentTests-06773",
|
|
"text": " If <a href=\"#features-shaderEarlyAndLateFragmentTests\"><code>shaderEarlyAndLateFragmentTests</code></a> is not enabled, the <code>StencilRefLessBackEXT</code> <code>Execution</code> <code>Mode</code> <strong class=\"purple\">must</strong> not be used."
|
|
}
|
|
],
|
|
"(VK_QCOM_image_processing)": [
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-OpImageWeightedSampleQCOM-06979",
|
|
"text": " If an <code>OpImageWeightedSampleQCOM</code> operation is used, then the <code>Texture</code> <code>Sampled</code> <code>Image</code> and <code>Weight</code> <code>Image</code> parameters <strong class=\"purple\">must</strong> both be <em>dynamically uniform</em> for the quad."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-OpImageWeightedSampleQCOM-06980",
|
|
"text": " If an <code>OpImageWeightedSampleQCOM</code> operation is used, then the <code>Weight</code> <code>Image</code> parameter <strong class=\"purple\">must</strong> be of storage class <code>UniformConstant</code> and type <code>OpTypeImage</code> with <code>Depth</code>=0, <code>Dim</code>=<code>2D</code>, <code>Arrayed</code>=1, <code>MS</code>=0, and <code>Sampled</code>=1."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-OpImageWeightedSampleQCOM-06981",
|
|
"text": " If an <code>OpImageWeightedSampleQCOM</code> operation is used, then the <code>Weight</code> <code>Image</code> parameter <strong class=\"purple\">must</strong> be decorated with <code>WeightTextureQCOM</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-OpImageBlockMatchSADQCOM-06982",
|
|
"text": " If an <code>OpImageBlockMatchSADQCOM</code> or <code>OpImageBlockMatchSSDQCOM</code> operation is used, then the <code>target</code> <code>sampled</code> <code>image</code>, <code>reference</code> <code>sampled</code> <code>image</code>, and <code>Block</code> <code>Size</code> parameters <strong class=\"purple\">must</strong> both be <em>dynamically uniform</em> for the quad."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-OpImageBlockMatchSSDQCOM-06983",
|
|
"text": " If an <code>OpImageBlockMatchSSDQCOM</code> or <code>OpImageBlockMatchSADQCOM</code> operation is used, then <code>target</code> <code>sampled</code> <code>image</code> and <code>reference</code> <code>sampled</code> <code>image</code> parameters <strong class=\"purple\">must</strong> be of storage class <code>UniformConstant</code> and type <code>OpTypeImage</code> with <code>Depth</code>=0, <code>Dim</code>=<code>2D</code>, <code>Arrayed</code>=0, <code>MS</code>=0, and <code>Sampled</code>=1."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-OpImageBlockMatchSSDQCOM-06984",
|
|
"text": " If an <code>OpImageBlockMatchSSDQCOM</code> or <code>OpImageBlockMatchSADQCOM</code> operation is used, then the <code>target</code> <code>sampled</code> <code>image</code> and <code>reference</code> <code>sampled</code> <code>image</code> parameters <strong class=\"purple\">must</strong> be decorated with <code>BlockMatchTextureQCOM</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-OpImageBlockMatchSSDQCOM-06985",
|
|
"text": " If an <code>OpImageBlockMatchSSDQCOM</code> or <code>OpImageBlockMatchSADQCOM</code> operation is used, then <code>target</code> <code>sampled</code> <code>image</code> and <code>reference</code> <code>sampled</code> <code>image</code> parameters <strong class=\"purple\">must</strong> have been created using an identical sampler object."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-OpImageBlockMatchSSDQCOM-06986",
|
|
"text": " If an <code>OpImageBlockMatchSSDQCOM</code> or <code>OpImageBlockMatchSADQCOM</code> operation is used, then <code>target</code> <code>sampled</code> <code>image</code> and <code>reference</code> <code>sampled</code> <code>image</code> parameters <strong class=\"purple\">must</strong> have been created with sampler object with <code>unnormalizeCordinates</code> equal to <code>VK_TRUE</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-OpImageBlockMatchSSDQCOM-06987",
|
|
"text": " If an <code>OpImageBlockMatchSSDQCOM</code> or <code>OpImageBlockMatchSADQCOM</code> operation is used, then <code>target</code> <code>sampled</code> <code>image</code> and <code>reference</code> <code>sampled</code> <code>image</code> parameters <strong class=\"purple\">must</strong> have been created with sampler object with <code>unnormalizeCordinates</code> equal to <code>VK_TRUE</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-OpImageBlockMatchSSDQCOM-06988",
|
|
"text": " If an <code>OpImageBlockMatchSSDQCOM</code> or <code>OpImageBlockMatchSADQCOM</code> operation is used, then <code>Block</code> <code>Size</code> less than or equal to <a href=\"#limits-blockmatch-maxblocksize\">maxBlockMatchRegion</a>."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-OpImageBoxFilterQCOM-06989",
|
|
"text": " If an <code>OpImageBoxFilterQCOM</code> operation is used, then <code>Box</code> <code>Size.y</code> <strong class=\"purple\">must</strong> be equal to or greater than 1.0 and less than or equal to <a href=\"#limits-boxfilter-maxblocksize\">maxBoxFilterBlockSize</a>.<code>height</code>."
|
|
},
|
|
{
|
|
"vuid": "VUID-RuntimeSpirv-OpImageBoxFilterQCOM-06990",
|
|
"text": " If an <code>OpImageBoxFilterQCOM</code> operation is used, then <code>Sampled</code> <code>Texture</code> <code>Image</code> and <code>Box</code> <code>Size</code> parameters <strong class=\"purple\">must</strong> be <em>dynamically uniform</em>."
|
|
}
|
|
]
|
|
},
|
|
"vkCreateCuFunctionNVX": {
|
|
"(VK_NVX_binary_import)": [
|
|
{
|
|
"vuid": "VUID-vkCreateCuFunctionNVX-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateCuFunctionNVX-pCreateInfo-parameter",
|
|
"text": " <code>pCreateInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkCuFunctionCreateInfoNVX\">VkCuFunctionCreateInfoNVX</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateCuFunctionNVX-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateCuFunctionNVX-pFunction-parameter",
|
|
"text": " <code>pFunction</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkCuFunctionNVX\">VkCuFunctionNVX</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkCuFunctionCreateInfoNVX": {
|
|
"(VK_NVX_binary_import)": [
|
|
{
|
|
"vuid": "VUID-VkCuFunctionCreateInfoNVX-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_CU_FUNCTION_CREATE_INFO_NVX</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCuFunctionCreateInfoNVX-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCuFunctionCreateInfoNVX-module-parameter",
|
|
"text": " <code>module</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCuModuleNVX\">VkCuModuleNVX</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCuFunctionCreateInfoNVX-pName-parameter",
|
|
"text": " <code>pName</code> <strong class=\"purple\">must</strong> be a null-terminated UTF-8 string"
|
|
}
|
|
]
|
|
},
|
|
"vkDestroyCuFunctionNVX": {
|
|
"(VK_NVX_binary_import)": [
|
|
{
|
|
"vuid": "VUID-vkDestroyCuFunctionNVX-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyCuFunctionNVX-function-parameter",
|
|
"text": " <code>function</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCuFunctionNVX\">VkCuFunctionNVX</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyCuFunctionNVX-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyCuFunctionNVX-function-parent",
|
|
"text": " <code>function</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCreateCuModuleNVX": {
|
|
"(VK_NVX_binary_import)": [
|
|
{
|
|
"vuid": "VUID-vkCreateCuModuleNVX-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateCuModuleNVX-pCreateInfo-parameter",
|
|
"text": " <code>pCreateInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkCuModuleCreateInfoNVX\">VkCuModuleCreateInfoNVX</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateCuModuleNVX-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCreateCuModuleNVX-pModule-parameter",
|
|
"text": " <code>pModule</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkCuModuleNVX\">VkCuModuleNVX</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkCuModuleCreateInfoNVX": {
|
|
"(VK_NVX_binary_import)": [
|
|
{
|
|
"vuid": "VUID-VkCuModuleCreateInfoNVX-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_CU_MODULE_CREATE_INFO_NVX</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCuModuleCreateInfoNVX-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCuModuleCreateInfoNVX-pData-parameter",
|
|
"text": " <code>pData</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>dataSize</code> bytes"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCuModuleCreateInfoNVX-dataSize-arraylength",
|
|
"text": " <code>dataSize</code> <strong class=\"purple\">must</strong> be greater than <code>0</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkDestroyCuModuleNVX": {
|
|
"(VK_NVX_binary_import)": [
|
|
{
|
|
"vuid": "VUID-vkDestroyCuModuleNVX-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyCuModuleNVX-module-parameter",
|
|
"text": " <code>module</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCuModuleNVX\">VkCuModuleNVX</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyCuModuleNVX-pAllocator-parameter",
|
|
"text": " If <code>pAllocator</code> is not <code>NULL</code>, <code>pAllocator</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkAllocationCallbacks\">VkAllocationCallbacks</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkDestroyCuModuleNVX-module-parent",
|
|
"text": " <code>module</code> <strong class=\"purple\">must</strong> have been created, allocated, or retrieved from <code>device</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkCmdCuLaunchKernelNVX": {
|
|
"(VK_NVX_binary_import)": [
|
|
{
|
|
"vuid": "VUID-vkCmdCuLaunchKernelNVX-commandBuffer-parameter",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCommandBuffer\">VkCommandBuffer</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCuLaunchKernelNVX-pLaunchInfo-parameter",
|
|
"text": " <code>pLaunchInfo</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkCuLaunchInfoNVX\">VkCuLaunchInfoNVX</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCuLaunchKernelNVX-commandBuffer-recording",
|
|
"text": " <code>commandBuffer</code> <strong class=\"purple\">must</strong> be in the <a href=\"#commandbuffers-lifecycle\">recording state</a>"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCuLaunchKernelNVX-commandBuffer-cmdpool",
|
|
"text": " The <code>VkCommandPool</code> that <code>commandBuffer</code> was allocated from <strong class=\"purple\">must</strong> support graphics, or compute operations"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkCmdCuLaunchKernelNVX-videocoding",
|
|
"text": " This command <strong class=\"purple\">must</strong> only be called outside of a video coding scope"
|
|
}
|
|
]
|
|
},
|
|
"VkCuLaunchInfoNVX": {
|
|
"(VK_NVX_binary_import)": [
|
|
{
|
|
"vuid": "VUID-VkCuLaunchInfoNVX-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_CU_LAUNCH_INFO_NVX</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCuLaunchInfoNVX-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCuLaunchInfoNVX-function-parameter",
|
|
"text": " <code>function</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkCuFunctionNVX\">VkCuFunctionNVX</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCuLaunchInfoNVX-pParams-parameter",
|
|
"text": " If <code>paramCount</code> is not <code>0</code>, <code>pParams</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>paramCount</code> bytes"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkCuLaunchInfoNVX-pExtras-parameter",
|
|
"text": " If <code>extraCount</code> is not <code>0</code>, <code>pExtras</code> <strong class=\"purple\">must</strong> be a valid pointer to an array of <code>extraCount</code> bytes"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceAmigoProfilingFeaturesSEC": {
|
|
"(VK_SEC_amigo_profiling)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceAmigoProfilingFeaturesSEC-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_AMIGO_PROFILING_FEATURES_SEC</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkAmigoProfilingSubmitInfoSEC": {
|
|
"(VK_SEC_amigo_profiling)": [
|
|
{
|
|
"vuid": "VUID-VkAmigoProfilingSubmitInfoSEC-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_AMIGO_PROFILING_SUBMIT_INFO_SEC</code>"
|
|
}
|
|
]
|
|
},
|
|
"vkGetDescriptorSetLayoutHostMappingInfoVALVE": {
|
|
"(VK_VALVE_descriptor_set_host_mapping)": [
|
|
{
|
|
"vuid": "VUID-vkGetDescriptorSetLayoutHostMappingInfoVALVE-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDescriptorSetLayoutHostMappingInfoVALVE-pBindingReference-parameter",
|
|
"text": " <code>pBindingReference</code> <strong class=\"purple\">must</strong> be a valid pointer to a valid <a href=\"#VkDescriptorSetBindingReferenceVALVE\">VkDescriptorSetBindingReferenceVALVE</a> structure"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDescriptorSetLayoutHostMappingInfoVALVE-pHostMapping-parameter",
|
|
"text": " <code>pHostMapping</code> <strong class=\"purple\">must</strong> be a valid pointer to a <a href=\"#VkDescriptorSetLayoutHostMappingInfoVALVE\">VkDescriptorSetLayoutHostMappingInfoVALVE</a> structure"
|
|
}
|
|
]
|
|
},
|
|
"vkGetDescriptorSetHostMappingVALVE": {
|
|
"(VK_VALVE_descriptor_set_host_mapping)": [
|
|
{
|
|
"vuid": "VUID-vkGetDescriptorSetHostMappingVALVE-device-parameter",
|
|
"text": " <code>device</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDevice\">VkDevice</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDescriptorSetHostMappingVALVE-descriptorSet-parameter",
|
|
"text": " <code>descriptorSet</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDescriptorSet\">VkDescriptorSet</a> handle"
|
|
},
|
|
{
|
|
"vuid": "VUID-vkGetDescriptorSetHostMappingVALVE-ppData-parameter",
|
|
"text": " <code>ppData</code> <strong class=\"purple\">must</strong> be a valid pointer to a pointer value"
|
|
}
|
|
]
|
|
},
|
|
"VkPhysicalDeviceDescriptorSetHostMappingFeaturesVALVE": {
|
|
"(VK_VALVE_descriptor_set_host_mapping)": [
|
|
{
|
|
"vuid": "VUID-VkPhysicalDeviceDescriptorSetHostMappingFeaturesVALVE-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_DESCRIPTOR_SET_HOST_MAPPING_FEATURES_VALVE</code>"
|
|
}
|
|
]
|
|
},
|
|
"VkDescriptorSetBindingReferenceVALVE": {
|
|
"(VK_VALVE_descriptor_set_host_mapping)": [
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetBindingReferenceVALVE-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_DESCRIPTOR_SET_BINDING_REFERENCE_VALVE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetBindingReferenceVALVE-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetBindingReferenceVALVE-descriptorSetLayout-parameter",
|
|
"text": " <code>descriptorSetLayout</code> <strong class=\"purple\">must</strong> be a valid <a href=\"#VkDescriptorSetLayout\">VkDescriptorSetLayout</a> handle"
|
|
}
|
|
]
|
|
},
|
|
"VkDescriptorSetLayoutHostMappingInfoVALVE": {
|
|
"(VK_VALVE_descriptor_set_host_mapping)": [
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetLayoutHostMappingInfoVALVE-sType-sType",
|
|
"text": " <code>sType</code> <strong class=\"purple\">must</strong> be <code>VK_STRUCTURE_TYPE_DESCRIPTOR_SET_LAYOUT_HOST_MAPPING_INFO_VALVE</code>"
|
|
},
|
|
{
|
|
"vuid": "VUID-VkDescriptorSetLayoutHostMappingInfoVALVE-pNext-pNext",
|
|
"text": " <code>pNext</code> <strong class=\"purple\">must</strong> be <code>NULL</code>"
|
|
}
|
|
]
|
|
}
|
|
}
|
|
} |