31. Dispatching Commands
Dispatching commands (commands with Dispatch in the name) provoke
work in a compute pipeline.
Dispatching commands are recorded into a command buffer and when executed by
a queue, will produce work which executes according to the bound compute
pipeline.
A compute pipeline must be bound to a command buffer before any dispatching
commands are recorded in that command buffer.
To record a dispatch, call:
// Provided by VK_VERSION_1_0
void vkCmdDispatch(
VkCommandBuffer commandBuffer,
uint32_t groupCountX,
uint32_t groupCountY,
uint32_t groupCountZ);
-
commandBufferis the command buffer into which the command will be recorded. -
groupCountXis the number of local workgroups to dispatch in the X dimension. -
groupCountYis the number of local workgroups to dispatch in the Y dimension. -
groupCountZis the number of local workgroups to dispatch in the Z dimension.
When the command is executed, a global workgroup consisting of
groupCountX × groupCountY × groupCountZ
local workgroups is assembled.
-
VUID-vkCmdDispatch-magFilter-04553
If a VkSampler created withmagFilterorminFilterequal toVK_FILTER_LINEARandcompareEnableequal toVK_FALSEis used to sample a VkImageView as a result of this command, then the image view’s format features must containVK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT -
VUID-vkCmdDispatch-mipmapMode-04770
If a VkSampler created withmipmapModeequal toVK_SAMPLER_MIPMAP_MODE_LINEARandcompareEnableequal toVK_FALSEis used to sample a VkImageView as a result of this command, then the image view’s format features must containVK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT -
VUID-vkCmdDispatch-None-06479
If a VkImageView is sampled with depth comparison, the image view’s format features must containVK_FORMAT_FEATURE_2_SAMPLED_IMAGE_DEPTH_COMPARISON_BIT -
VUID-vkCmdDispatch-None-02691
If a VkImageView is accessed using atomic operations as a result of this command, then the image view’s format features must containVK_FORMAT_FEATURE_STORAGE_IMAGE_ATOMIC_BIT -
VUID-vkCmdDispatch-None-07888
If aVK_DESCRIPTOR_TYPE_STORAGE_TEXEL_BUFFERdescriptor is accessed using atomic operations as a result of this command, then the storage texel buffer’s format features must containVK_FORMAT_FEATURE_STORAGE_TEXEL_BUFFER_ATOMIC_BIT -
VUID-vkCmdDispatch-None-02692
If a VkImageView is sampled withVK_FILTER_CUBIC_EXTas a result of this command, then the image view’s format features must containVK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_CUBIC_BIT_EXT -
VUID-vkCmdDispatch-None-02693
If the VK_EXT_filter_cubic extension is not enabled and any VkImageView is sampled withVK_FILTER_CUBIC_EXTas a result of this command, it must not have a VkImageViewType ofVK_IMAGE_VIEW_TYPE_3D,VK_IMAGE_VIEW_TYPE_CUBE, orVK_IMAGE_VIEW_TYPE_CUBE_ARRAY -
VUID-vkCmdDispatch-filterCubic-02694
Any VkImageView being sampled withVK_FILTER_CUBIC_EXTas a result of this command must have a VkImageViewType and format that supports cubic filtering, as specified by VkFilterCubicImageViewImageFormatPropertiesEXT::filterCubicreturned by vkGetPhysicalDeviceImageFormatProperties2 -
VUID-vkCmdDispatch-filterCubicMinmax-02695
Any VkImageView being sampled withVK_FILTER_CUBIC_EXTwith a reduction mode of eitherVK_SAMPLER_REDUCTION_MODE_MINorVK_SAMPLER_REDUCTION_MODE_MAXas a result of this command must have a VkImageViewType and format that supports cubic filtering together with minmax filtering, as specified by VkFilterCubicImageViewImageFormatPropertiesEXT::filterCubicMinmaxreturned by vkGetPhysicalDeviceImageFormatProperties2 -
VUID-vkCmdDispatch-cubicRangeClamp-09212
If thecubicRangeClampfeature is not enabled, then any VkImageView being sampled withVK_FILTER_CUBIC_EXTas a result of this command must not have a VkSamplerReductionModeCreateInfo::reductionModeequal toVK_SAMPLER_REDUCTION_MODE_WEIGHTED_AVERAGE_RANGECLAMP_QCOM -
VUID-vkCmdDispatch-reductionMode-09213
Any VkImageView being sampled with a VkSamplerReductionModeCreateInfo::reductionModeequal toVK_SAMPLER_REDUCTION_MODE_WEIGHTED_AVERAGE_RANGECLAMP_QCOMas a result of this command must sample withVK_FILTER_CUBIC_EXT -
VUID-vkCmdDispatch-selectableCubicWeights-09214
If theselectableCubicWeightsfeature is not enabled, then any VkImageView being sampled withVK_FILTER_CUBIC_EXTas a result of this command must have VkSamplerCubicWeightsCreateInfoQCOM::cubicWeightsequal toVK_CUBIC_FILTER_WEIGHTS_CATMULL_ROM_QCOM -
VUID-vkCmdDispatch-flags-02696
Any VkImage created with a VkImageCreateInfo::flagscontainingVK_IMAGE_CREATE_CORNER_SAMPLED_BIT_NVsampled as a result of this command must only be sampled using a VkSamplerAddressMode ofVK_SAMPLER_ADDRESS_MODE_CLAMP_TO_EDGE -
VUID-vkCmdDispatch-OpTypeImage-07027
For any VkImageView being written as a storage image where the image format field of theOpTypeImageisUnknown, the view’s format features must containVK_FORMAT_FEATURE_2_STORAGE_WRITE_WITHOUT_FORMAT_BIT -
VUID-vkCmdDispatch-OpTypeImage-07028
For any VkImageView being read as a storage image where the image format field of theOpTypeImageisUnknown, the view’s format features must containVK_FORMAT_FEATURE_2_STORAGE_READ_WITHOUT_FORMAT_BIT -
VUID-vkCmdDispatch-OpTypeImage-07029
For any VkBufferView being written as a storage texel buffer where the image format field of theOpTypeImageisUnknown, the view’s buffer features must containVK_FORMAT_FEATURE_2_STORAGE_WRITE_WITHOUT_FORMAT_BIT -
VUID-vkCmdDispatch-OpTypeImage-07030
Any VkBufferView being read as a storage texel buffer where the image format field of theOpTypeImageisUnknownthen the view’s buffer features must containVK_FORMAT_FEATURE_2_STORAGE_READ_WITHOUT_FORMAT_BIT -
VUID-vkCmdDispatch-None-08600
For each set n that is statically used by a bound shader, a descriptor set must have been bound to n at the same pipeline bind point, with a VkPipelineLayout that is compatible for set n, with the VkPipelineLayout used to create the current VkPipeline or the VkDescriptorSetLayout array used to create the current VkShaderEXT , as described in Pipeline Layout Compatibility -
VUID-vkCmdDispatch-None-08601
For each push constant that is statically used by a bound shader, a push constant value must have been set for the same pipeline bind point, with a VkPipelineLayout that is compatible for push constants, with the VkPipelineLayout used to create the current VkPipeline or the VkDescriptorSetLayout array used to create the current VkShaderEXT , as described in Pipeline Layout Compatibility -
VUID-vkCmdDispatch-maintenance4-08602
If themaintenance4feature is not enabled, then for each push constant that is statically used by a bound shader, a push constant value must have been set for the same pipeline bind point, with a VkPipelineLayout that is compatible for push constants, with the VkPipelineLayout used to create the current VkPipeline or the VkDescriptorSetLayout and VkPushConstantRange arrays used to create the current VkShaderEXT , as described in Pipeline Layout Compatibility -
VUID-vkCmdDispatch-None-08114
Descriptors in each bound descriptor set, specified via vkCmdBindDescriptorSets, must be valid as described by descriptor validity if they are statically used by the VkPipeline bound to the pipeline bind point used by this command and the bound VkPipeline was not created withVK_PIPELINE_CREATE_DESCRIPTOR_BUFFER_BIT_EXT -
VUID-vkCmdDispatch-None-08115
If the descriptors used by the VkPipeline bound to the pipeline bind point were specified via vkCmdBindDescriptorSets, the bound VkPipeline must have been created withoutVK_PIPELINE_CREATE_DESCRIPTOR_BUFFER_BIT_EXT -
VUID-vkCmdDispatch-None-08116
Descriptors in bound descriptor buffers, specified via vkCmdSetDescriptorBufferOffsetsEXT, must be valid if they are dynamically used by the VkPipeline bound to the pipeline bind point used by this command and the bound VkPipeline was created withVK_PIPELINE_CREATE_DESCRIPTOR_BUFFER_BIT_EXT -
VUID-vkCmdDispatch-None-08604
Descriptors in bound descriptor buffers, specified via vkCmdSetDescriptorBufferOffsetsEXT, must be valid if they are dynamically used by any VkShaderEXT bound to a stage corresponding to the pipeline bind point used by this command -
VUID-vkCmdDispatch-None-08117
If the descriptors used by the VkPipeline bound to the pipeline bind point were specified via vkCmdSetDescriptorBufferOffsetsEXT, the bound VkPipeline must have been created withVK_PIPELINE_CREATE_DESCRIPTOR_BUFFER_BIT_EXT -
VUID-vkCmdDispatch-None-08119
If a descriptor is dynamically used with a VkPipeline created withVK_PIPELINE_CREATE_DESCRIPTOR_BUFFER_BIT_EXT, the descriptor memory must be resident -
VUID-vkCmdDispatch-None-08605
If a descriptor is dynamically used with a VkShaderEXT created with aVkDescriptorSetLayoutthat was created withVK_DESCRIPTOR_SET_LAYOUT_CREATE_DESCRIPTOR_BUFFER_BIT_EXT, the descriptor memory must be resident -
VUID-vkCmdDispatch-None-08606
If theshaderObjectfeature is not enabled, a valid pipeline must be bound to the pipeline bind point used by this command -
VUID-vkCmdDispatch-None-08608
If a pipeline is bound to the pipeline bind point used by this command, there must not have been any calls to dynamic state setting commands for any state not specified as dynamic in the VkPipeline object bound to the pipeline bind point used by this command, since that pipeline was bound -
VUID-vkCmdDispatch-None-08609
If the VkPipeline object bound to the pipeline bind point used by this command or any VkShaderEXT bound to a stage corresponding to the pipeline bind point used by this command accesses a VkSampler object that uses unnormalized coordinates, that sampler must not be used to sample from any VkImage with a VkImageView of the typeVK_IMAGE_VIEW_TYPE_3D,VK_IMAGE_VIEW_TYPE_CUBE,VK_IMAGE_VIEW_TYPE_1D_ARRAY,VK_IMAGE_VIEW_TYPE_2D_ARRAYorVK_IMAGE_VIEW_TYPE_CUBE_ARRAY, in any shader stage -
VUID-vkCmdDispatch-None-08610
If the VkPipeline object bound to the pipeline bind point used by this command or any VkShaderEXT bound to a stage corresponding to the pipeline bind point used by this command accesses a VkSampler object that uses unnormalized coordinates, that sampler must not be used with any of the SPIR-VOpImageSample*orOpImageSparseSample*instructions withImplicitLod,DreforProjin their name, in any shader stage -
VUID-vkCmdDispatch-None-08611
If the VkPipeline object bound to the pipeline bind point used by this command or any VkShaderEXT bound to a stage corresponding to the pipeline bind point used by this command accesses a VkSampler object that uses unnormalized coordinates, that sampler must not be used with any of the SPIR-VOpImageSample*orOpImageSparseSample*instructions that includes a LOD bias or any offset values, in any shader stage -
VUID-vkCmdDispatch-None-08607
If theshaderObjectis enabled, either a valid pipeline must be bound to the pipeline bind point used by this command, or a valid combination of valid and VK_NULL_HANDLE shader objects must be bound to every supported shader stage corresponding to the pipeline bind point used by this command -
VUID-vkCmdDispatch-uniformBuffers-06935
If any stage of the VkPipeline object bound to the pipeline bind point used by this command accesses a uniform buffer, and that stage was created without enabling eitherVK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_EXTorVK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXTforuniformBuffers, and therobustBufferAccessfeature is not enabled, that stage must not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point -
VUID-vkCmdDispatch-None-08612
If therobustBufferAccessfeature is not enabled, and any VkShaderEXT bound to a stage corresponding to the pipeline bind point used by this command accesses a uniform buffer, it must not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point -
VUID-vkCmdDispatch-storageBuffers-06936
If any stage of the VkPipeline object bound to the pipeline bind point used by this command accesses a storage buffer, and that stage was created without enabling eitherVK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_EXTorVK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXTforstorageBuffers, and therobustBufferAccessfeature is not enabled, that stage must not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point -
VUID-vkCmdDispatch-None-08613
If therobustBufferAccessfeature is not enabled, and any VkShaderEXT bound to a stage corresponding to the pipeline bind point used by this command accesses a storage buffer, it must not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point -
VUID-vkCmdDispatch-commandBuffer-02707
IfcommandBufferis an unprotected command buffer andprotectedNoFaultis not supported, any resource accessed by bound shaders must not be a protected resource -
VUID-vkCmdDispatch-None-06550
If a bound shader accesses a VkSampler or VkImageView object that enables sampler Y′CBCR conversion, that object must only be used withOpImageSample*orOpImageSparseSample*instructions -
VUID-vkCmdDispatch-ConstOffset-06551
If a bound shader accesses a VkSampler or VkImageView object that enables sampler Y′CBCR conversion, that object must not use theConstOffsetandOffsetoperands -
VUID-vkCmdDispatch-viewType-07752
If a VkImageView is accessed as a result of this command, then the image view’sviewTypemust match theDimoperand of theOpTypeImageas described in Instruction/Sampler/Image View Validation -
VUID-vkCmdDispatch-format-07753
If a VkImageView is accessed as a result of this command, then the numeric type of the image view’sformatand theSampledTypeoperand of theOpTypeImagemust match -
VUID-vkCmdDispatch-OpImageWrite-08795
If a VkImageView created with a format other thanVK_FORMAT_A8_UNORM_KHRis accessed usingOpImageWriteas a result of this command, then theTypeof theTexeloperand of that instruction must have at least as many components as the image view’s format -
VUID-vkCmdDispatch-OpImageWrite-08796
If a VkImageView created with the formatVK_FORMAT_A8_UNORM_KHRis accessed usingOpImageWriteas a result of this command, then theTypeof theTexeloperand of that instruction must have four components -
VUID-vkCmdDispatch-OpImageWrite-04469
If a VkBufferView is accessed usingOpImageWriteas a result of this command, then theTypeof theTexeloperand of that instruction must have at least as many components as the buffer view’s format -
VUID-vkCmdDispatch-SampledType-04470
If a VkImageView with a VkFormat that has a 64-bit component width is accessed as a result of this command, theSampledTypeof theOpTypeImageoperand of that instruction must have aWidthof 64 -
VUID-vkCmdDispatch-SampledType-04471
If a VkImageView with a VkFormat that has a component width less than 64-bit is accessed as a result of this command, theSampledTypeof theOpTypeImageoperand of that instruction must have aWidthof 32 -
VUID-vkCmdDispatch-SampledType-04472
If a VkBufferView with a VkFormat that has a 64-bit component width is accessed as a result of this command, theSampledTypeof theOpTypeImageoperand of that instruction must have aWidthof 64 -
VUID-vkCmdDispatch-SampledType-04473
If a VkBufferView with a VkFormat that has a component width less than 64-bit is accessed as a result of this command, theSampledTypeof theOpTypeImageoperand of that instruction must have aWidthof 32 -
VUID-vkCmdDispatch-sparseImageInt64Atomics-04474
If thesparseImageInt64Atomicsfeature is not enabled, VkImage objects created with theVK_IMAGE_CREATE_SPARSE_RESIDENCY_BITflag must not be accessed by atomic instructions through anOpTypeImagewith aSampledTypewith aWidthof 64 by this command -
VUID-vkCmdDispatch-sparseImageInt64Atomics-04475
If thesparseImageInt64Atomicsfeature is not enabled, VkBuffer objects created with theVK_BUFFER_CREATE_SPARSE_RESIDENCY_BITflag must not be accessed by atomic instructions through anOpTypeImagewith aSampledTypewith aWidthof 64 by this command -
VUID-vkCmdDispatch-OpImageWeightedSampleQCOM-06971
IfOpImageWeightedSampleQCOMis used to sample a VkImageView as a result of this command, then the image view’s format features must containVK_FORMAT_FEATURE_2_WEIGHT_SAMPLED_IMAGE_BIT_QCOM -
VUID-vkCmdDispatch-OpImageWeightedSampleQCOM-06972
IfOpImageWeightedSampleQCOMuses a VkImageView as a sample weight image as a result of this command, then the image view’s format features must containVK_FORMAT_FEATURE_2_WEIGHT_IMAGE_BIT_QCOM -
VUID-vkCmdDispatch-OpImageBoxFilterQCOM-06973
IfOpImageBoxFilterQCOMis used to sample a VkImageView as a result of this command, then the image view’s format features must containVK_FORMAT_FEATURE_2_BOX_FILTER_SAMPLED_BIT_QCOM -
VUID-vkCmdDispatch-OpImageBlockMatchSSDQCOM-06974
IfOpImageBlockMatchSSDQCOMis used to read from an VkImageView as a result of this command, then the image view’s format features must containVK_FORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM -
VUID-vkCmdDispatch-OpImageBlockMatchSADQCOM-06975
IfOpImageBlockMatchSADQCOMis used to read from an VkImageView as a result of this command, then the image view’s format features must containVK_FORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM -
VUID-vkCmdDispatch-OpImageBlockMatchSADQCOM-06976
IfOpImageBlockMatchSADQCOMor OpImageBlockMatchSSDQCOM is used to read from a reference image as result of this command, then the specified reference coordinates must not fail integer texel coordinate validation -
VUID-vkCmdDispatch-OpImageWeightedSampleQCOM-06977
IfOpImageWeightedSampleQCOM,OpImageBoxFilterQCOM,OpImageBlockMatchWindowSSDQCOM,OpImageBlockMatchWindowSADQCOM,OpImageBlockMatchGatherSSDQCOM,OpImageBlockMatchGatherSADQCOM,OpImageBlockMatchSSDQCOM, orOpImageBlockMatchSADQCOMuses a VkSampler as a result of this command, then the sampler must have been created withVK_SAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM -
VUID-vkCmdDispatch-OpImageWeightedSampleQCOM-06978
If any command other thanOpImageWeightedSampleQCOM,OpImageBoxFilterQCOM,OpImageBlockMatchWindowSSDQCOM,OpImageBlockMatchWindowSADQCOM,OpImageBlockMatchGatherSSDQCOM,OpImageBlockMatchGatherSADQCOM,OpImageBlockMatchSSDQCOM, orOpImageBlockMatchSADQCOMuses a VkSampler as a result of this command, then the sampler must not have been created withVK_SAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM -
VUID-vkCmdDispatch-OpImageBlockMatchWindow-09215
If aOpImageBlockMatchWindow*QCOMorOpImageBlockMatchGather*QCOMinstruction is used to read from an VkImageView as a result of this command, then the image view’s format features must containVK_FORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM -
VUID-vkCmdDispatch-OpImageBlockMatchWindow-09216
If aOpImageBlockMatchWindow*QCOMorOpImageBlockMatchGather*QCOMinstruction is used to read from an VkImageView as a result of this command, then the image view’s format must be a single-component format. -
VUID-vkCmdDispatch-OpImageBlockMatchWindow-09217
If aOpImageBlockMatchWindow*QCOMorOpImageBlockMatchGather*QCOMread from a reference image as result of this command, then the specified reference coordinates must not fail integer texel coordinate validation -
VUID-vkCmdDispatch-None-07288
Any shader invocation executed by this command must terminate
-
VUID-vkCmdDispatch-commandBuffer-02712
IfcommandBufferis a protected command buffer andprotectedNoFaultis not supported, any resource written to by theVkPipelineobject bound to the pipeline bind point used by this command must not be an unprotected resource -
VUID-vkCmdDispatch-commandBuffer-02713
IfcommandBufferis a protected command buffer andprotectedNoFaultis not supported, pipeline stages other than the framebuffer-space and compute stages in theVkPipelineobject bound to the pipeline bind point used by this command must not write to any resource -
VUID-vkCmdDispatch-commandBuffer-04617
If any of the shader stages of theVkPipelinebound to the pipeline bind point used by this command uses theRayQueryKHRcapability, thencommandBuffermust not be a protected command buffer -
VUID-vkCmdDispatch-groupCountX-00386
groupCountXmust be less than or equal toVkPhysicalDeviceLimits::maxComputeWorkGroupCount[0] -
VUID-vkCmdDispatch-groupCountY-00387
groupCountYmust be less than or equal toVkPhysicalDeviceLimits::maxComputeWorkGroupCount[1] -
VUID-vkCmdDispatch-groupCountZ-00388
groupCountZmust be less than or equal toVkPhysicalDeviceLimits::maxComputeWorkGroupCount[2]
-
VUID-vkCmdDispatch-commandBuffer-parameter
commandBuffermust be a valid VkCommandBuffer handle -
VUID-vkCmdDispatch-commandBuffer-recording
commandBuffermust be in the recording state -
VUID-vkCmdDispatch-commandBuffer-cmdpool
TheVkCommandPoolthatcommandBufferwas allocated from must support compute operations -
VUID-vkCmdDispatch-renderpass
This command must only be called outside of a render pass instance -
VUID-vkCmdDispatch-videocoding
This command must only be called outside of a video coding scope
-
Host access to
commandBuffermust be externally synchronized -
Host access to the
VkCommandPoolthatcommandBufferwas allocated from must be externally synchronized
| Command Buffer Levels | Render Pass Scope | Video Coding Scope | Supported Queue Types | Command Type |
|---|---|---|---|---|
Primary |
Outside |
Outside |
Compute |
Action |
To record an indirect dispatching command, call:
// Provided by VK_VERSION_1_0
void vkCmdDispatchIndirect(
VkCommandBuffer commandBuffer,
VkBuffer buffer,
VkDeviceSize offset);
-
commandBufferis the command buffer into which the command will be recorded. -
bufferis the buffer containing dispatch parameters. -
offsetis the byte offset intobufferwhere parameters begin.
vkCmdDispatchIndirect behaves similarly to vkCmdDispatch except
that the parameters are read by the device from a buffer during execution.
The parameters of the dispatch are encoded in a
VkDispatchIndirectCommand structure taken from buffer starting
at offset.
-
VUID-vkCmdDispatchIndirect-magFilter-04553
If a VkSampler created withmagFilterorminFilterequal toVK_FILTER_LINEARandcompareEnableequal toVK_FALSEis used to sample a VkImageView as a result of this command, then the image view’s format features must containVK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT -
VUID-vkCmdDispatchIndirect-mipmapMode-04770
If a VkSampler created withmipmapModeequal toVK_SAMPLER_MIPMAP_MODE_LINEARandcompareEnableequal toVK_FALSEis used to sample a VkImageView as a result of this command, then the image view’s format features must containVK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT -
VUID-vkCmdDispatchIndirect-None-06479
If a VkImageView is sampled with depth comparison, the image view’s format features must containVK_FORMAT_FEATURE_2_SAMPLED_IMAGE_DEPTH_COMPARISON_BIT -
VUID-vkCmdDispatchIndirect-None-02691
If a VkImageView is accessed using atomic operations as a result of this command, then the image view’s format features must containVK_FORMAT_FEATURE_STORAGE_IMAGE_ATOMIC_BIT -
VUID-vkCmdDispatchIndirect-None-07888
If aVK_DESCRIPTOR_TYPE_STORAGE_TEXEL_BUFFERdescriptor is accessed using atomic operations as a result of this command, then the storage texel buffer’s format features must containVK_FORMAT_FEATURE_STORAGE_TEXEL_BUFFER_ATOMIC_BIT -
VUID-vkCmdDispatchIndirect-None-02692
If a VkImageView is sampled withVK_FILTER_CUBIC_EXTas a result of this command, then the image view’s format features must containVK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_CUBIC_BIT_EXT -
VUID-vkCmdDispatchIndirect-None-02693
If the VK_EXT_filter_cubic extension is not enabled and any VkImageView is sampled withVK_FILTER_CUBIC_EXTas a result of this command, it must not have a VkImageViewType ofVK_IMAGE_VIEW_TYPE_3D,VK_IMAGE_VIEW_TYPE_CUBE, orVK_IMAGE_VIEW_TYPE_CUBE_ARRAY -
VUID-vkCmdDispatchIndirect-filterCubic-02694
Any VkImageView being sampled withVK_FILTER_CUBIC_EXTas a result of this command must have a VkImageViewType and format that supports cubic filtering, as specified by VkFilterCubicImageViewImageFormatPropertiesEXT::filterCubicreturned by vkGetPhysicalDeviceImageFormatProperties2 -
VUID-vkCmdDispatchIndirect-filterCubicMinmax-02695
Any VkImageView being sampled withVK_FILTER_CUBIC_EXTwith a reduction mode of eitherVK_SAMPLER_REDUCTION_MODE_MINorVK_SAMPLER_REDUCTION_MODE_MAXas a result of this command must have a VkImageViewType and format that supports cubic filtering together with minmax filtering, as specified by VkFilterCubicImageViewImageFormatPropertiesEXT::filterCubicMinmaxreturned by vkGetPhysicalDeviceImageFormatProperties2 -
VUID-vkCmdDispatchIndirect-cubicRangeClamp-09212
If thecubicRangeClampfeature is not enabled, then any VkImageView being sampled withVK_FILTER_CUBIC_EXTas a result of this command must not have a VkSamplerReductionModeCreateInfo::reductionModeequal toVK_SAMPLER_REDUCTION_MODE_WEIGHTED_AVERAGE_RANGECLAMP_QCOM -
VUID-vkCmdDispatchIndirect-reductionMode-09213
Any VkImageView being sampled with a VkSamplerReductionModeCreateInfo::reductionModeequal toVK_SAMPLER_REDUCTION_MODE_WEIGHTED_AVERAGE_RANGECLAMP_QCOMas a result of this command must sample withVK_FILTER_CUBIC_EXT -
VUID-vkCmdDispatchIndirect-selectableCubicWeights-09214
If theselectableCubicWeightsfeature is not enabled, then any VkImageView being sampled withVK_FILTER_CUBIC_EXTas a result of this command must have VkSamplerCubicWeightsCreateInfoQCOM::cubicWeightsequal toVK_CUBIC_FILTER_WEIGHTS_CATMULL_ROM_QCOM -
VUID-vkCmdDispatchIndirect-flags-02696
Any VkImage created with a VkImageCreateInfo::flagscontainingVK_IMAGE_CREATE_CORNER_SAMPLED_BIT_NVsampled as a result of this command must only be sampled using a VkSamplerAddressMode ofVK_SAMPLER_ADDRESS_MODE_CLAMP_TO_EDGE -
VUID-vkCmdDispatchIndirect-OpTypeImage-07027
For any VkImageView being written as a storage image where the image format field of theOpTypeImageisUnknown, the view’s format features must containVK_FORMAT_FEATURE_2_STORAGE_WRITE_WITHOUT_FORMAT_BIT -
VUID-vkCmdDispatchIndirect-OpTypeImage-07028
For any VkImageView being read as a storage image where the image format field of theOpTypeImageisUnknown, the view’s format features must containVK_FORMAT_FEATURE_2_STORAGE_READ_WITHOUT_FORMAT_BIT -
VUID-vkCmdDispatchIndirect-OpTypeImage-07029
For any VkBufferView being written as a storage texel buffer where the image format field of theOpTypeImageisUnknown, the view’s buffer features must containVK_FORMAT_FEATURE_2_STORAGE_WRITE_WITHOUT_FORMAT_BIT -
VUID-vkCmdDispatchIndirect-OpTypeImage-07030
Any VkBufferView being read as a storage texel buffer where the image format field of theOpTypeImageisUnknownthen the view’s buffer features must containVK_FORMAT_FEATURE_2_STORAGE_READ_WITHOUT_FORMAT_BIT -
VUID-vkCmdDispatchIndirect-None-08600
For each set n that is statically used by a bound shader, a descriptor set must have been bound to n at the same pipeline bind point, with a VkPipelineLayout that is compatible for set n, with the VkPipelineLayout used to create the current VkPipeline or the VkDescriptorSetLayout array used to create the current VkShaderEXT , as described in Pipeline Layout Compatibility -
VUID-vkCmdDispatchIndirect-None-08601
For each push constant that is statically used by a bound shader, a push constant value must have been set for the same pipeline bind point, with a VkPipelineLayout that is compatible for push constants, with the VkPipelineLayout used to create the current VkPipeline or the VkDescriptorSetLayout array used to create the current VkShaderEXT , as described in Pipeline Layout Compatibility -
VUID-vkCmdDispatchIndirect-maintenance4-08602
If themaintenance4feature is not enabled, then for each push constant that is statically used by a bound shader, a push constant value must have been set for the same pipeline bind point, with a VkPipelineLayout that is compatible for push constants, with the VkPipelineLayout used to create the current VkPipeline or the VkDescriptorSetLayout and VkPushConstantRange arrays used to create the current VkShaderEXT , as described in Pipeline Layout Compatibility -
VUID-vkCmdDispatchIndirect-None-08114
Descriptors in each bound descriptor set, specified via vkCmdBindDescriptorSets, must be valid as described by descriptor validity if they are statically used by the VkPipeline bound to the pipeline bind point used by this command and the bound VkPipeline was not created withVK_PIPELINE_CREATE_DESCRIPTOR_BUFFER_BIT_EXT -
VUID-vkCmdDispatchIndirect-None-08115
If the descriptors used by the VkPipeline bound to the pipeline bind point were specified via vkCmdBindDescriptorSets, the bound VkPipeline must have been created withoutVK_PIPELINE_CREATE_DESCRIPTOR_BUFFER_BIT_EXT -
VUID-vkCmdDispatchIndirect-None-08116
Descriptors in bound descriptor buffers, specified via vkCmdSetDescriptorBufferOffsetsEXT, must be valid if they are dynamically used by the VkPipeline bound to the pipeline bind point used by this command and the bound VkPipeline was created withVK_PIPELINE_CREATE_DESCRIPTOR_BUFFER_BIT_EXT -
VUID-vkCmdDispatchIndirect-None-08604
Descriptors in bound descriptor buffers, specified via vkCmdSetDescriptorBufferOffsetsEXT, must be valid if they are dynamically used by any VkShaderEXT bound to a stage corresponding to the pipeline bind point used by this command -
VUID-vkCmdDispatchIndirect-None-08117
If the descriptors used by the VkPipeline bound to the pipeline bind point were specified via vkCmdSetDescriptorBufferOffsetsEXT, the bound VkPipeline must have been created withVK_PIPELINE_CREATE_DESCRIPTOR_BUFFER_BIT_EXT -
VUID-vkCmdDispatchIndirect-None-08119
If a descriptor is dynamically used with a VkPipeline created withVK_PIPELINE_CREATE_DESCRIPTOR_BUFFER_BIT_EXT, the descriptor memory must be resident -
VUID-vkCmdDispatchIndirect-None-08605
If a descriptor is dynamically used with a VkShaderEXT created with aVkDescriptorSetLayoutthat was created withVK_DESCRIPTOR_SET_LAYOUT_CREATE_DESCRIPTOR_BUFFER_BIT_EXT, the descriptor memory must be resident -
VUID-vkCmdDispatchIndirect-None-08606
If theshaderObjectfeature is not enabled, a valid pipeline must be bound to the pipeline bind point used by this command -
VUID-vkCmdDispatchIndirect-None-08608
If a pipeline is bound to the pipeline bind point used by this command, there must not have been any calls to dynamic state setting commands for any state not specified as dynamic in the VkPipeline object bound to the pipeline bind point used by this command, since that pipeline was bound -
VUID-vkCmdDispatchIndirect-None-08609
If the VkPipeline object bound to the pipeline bind point used by this command or any VkShaderEXT bound to a stage corresponding to the pipeline bind point used by this command accesses a VkSampler object that uses unnormalized coordinates, that sampler must not be used to sample from any VkImage with a VkImageView of the typeVK_IMAGE_VIEW_TYPE_3D,VK_IMAGE_VIEW_TYPE_CUBE,VK_IMAGE_VIEW_TYPE_1D_ARRAY,VK_IMAGE_VIEW_TYPE_2D_ARRAYorVK_IMAGE_VIEW_TYPE_CUBE_ARRAY, in any shader stage -
VUID-vkCmdDispatchIndirect-None-08610
If the VkPipeline object bound to the pipeline bind point used by this command or any VkShaderEXT bound to a stage corresponding to the pipeline bind point used by this command accesses a VkSampler object that uses unnormalized coordinates, that sampler must not be used with any of the SPIR-VOpImageSample*orOpImageSparseSample*instructions withImplicitLod,DreforProjin their name, in any shader stage -
VUID-vkCmdDispatchIndirect-None-08611
If the VkPipeline object bound to the pipeline bind point used by this command or any VkShaderEXT bound to a stage corresponding to the pipeline bind point used by this command accesses a VkSampler object that uses unnormalized coordinates, that sampler must not be used with any of the SPIR-VOpImageSample*orOpImageSparseSample*instructions that includes a LOD bias or any offset values, in any shader stage -
VUID-vkCmdDispatchIndirect-None-08607
If theshaderObjectis enabled, either a valid pipeline must be bound to the pipeline bind point used by this command, or a valid combination of valid and VK_NULL_HANDLE shader objects must be bound to every supported shader stage corresponding to the pipeline bind point used by this command -
VUID-vkCmdDispatchIndirect-uniformBuffers-06935
If any stage of the VkPipeline object bound to the pipeline bind point used by this command accesses a uniform buffer, and that stage was created without enabling eitherVK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_EXTorVK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXTforuniformBuffers, and therobustBufferAccessfeature is not enabled, that stage must not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point -
VUID-vkCmdDispatchIndirect-None-08612
If therobustBufferAccessfeature is not enabled, and any VkShaderEXT bound to a stage corresponding to the pipeline bind point used by this command accesses a uniform buffer, it must not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point -
VUID-vkCmdDispatchIndirect-storageBuffers-06936
If any stage of the VkPipeline object bound to the pipeline bind point used by this command accesses a storage buffer, and that stage was created without enabling eitherVK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_EXTorVK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXTforstorageBuffers, and therobustBufferAccessfeature is not enabled, that stage must not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point -
VUID-vkCmdDispatchIndirect-None-08613
If therobustBufferAccessfeature is not enabled, and any VkShaderEXT bound to a stage corresponding to the pipeline bind point used by this command accesses a storage buffer, it must not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point -
VUID-vkCmdDispatchIndirect-commandBuffer-02707
IfcommandBufferis an unprotected command buffer andprotectedNoFaultis not supported, any resource accessed by bound shaders must not be a protected resource -
VUID-vkCmdDispatchIndirect-None-06550
If a bound shader accesses a VkSampler or VkImageView object that enables sampler Y′CBCR conversion, that object must only be used withOpImageSample*orOpImageSparseSample*instructions -
VUID-vkCmdDispatchIndirect-ConstOffset-06551
If a bound shader accesses a VkSampler or VkImageView object that enables sampler Y′CBCR conversion, that object must not use theConstOffsetandOffsetoperands -
VUID-vkCmdDispatchIndirect-viewType-07752
If a VkImageView is accessed as a result of this command, then the image view’sviewTypemust match theDimoperand of theOpTypeImageas described in Instruction/Sampler/Image View Validation -
VUID-vkCmdDispatchIndirect-format-07753
If a VkImageView is accessed as a result of this command, then the numeric type of the image view’sformatand theSampledTypeoperand of theOpTypeImagemust match -
VUID-vkCmdDispatchIndirect-OpImageWrite-08795
If a VkImageView created with a format other thanVK_FORMAT_A8_UNORM_KHRis accessed usingOpImageWriteas a result of this command, then theTypeof theTexeloperand of that instruction must have at least as many components as the image view’s format -
VUID-vkCmdDispatchIndirect-OpImageWrite-08796
If a VkImageView created with the formatVK_FORMAT_A8_UNORM_KHRis accessed usingOpImageWriteas a result of this command, then theTypeof theTexeloperand of that instruction must have four components -
VUID-vkCmdDispatchIndirect-OpImageWrite-04469
If a VkBufferView is accessed usingOpImageWriteas a result of this command, then theTypeof theTexeloperand of that instruction must have at least as many components as the buffer view’s format -
VUID-vkCmdDispatchIndirect-SampledType-04470
If a VkImageView with a VkFormat that has a 64-bit component width is accessed as a result of this command, theSampledTypeof theOpTypeImageoperand of that instruction must have aWidthof 64 -
VUID-vkCmdDispatchIndirect-SampledType-04471
If a VkImageView with a VkFormat that has a component width less than 64-bit is accessed as a result of this command, theSampledTypeof theOpTypeImageoperand of that instruction must have aWidthof 32 -
VUID-vkCmdDispatchIndirect-SampledType-04472
If a VkBufferView with a VkFormat that has a 64-bit component width is accessed as a result of this command, theSampledTypeof theOpTypeImageoperand of that instruction must have aWidthof 64 -
VUID-vkCmdDispatchIndirect-SampledType-04473
If a VkBufferView with a VkFormat that has a component width less than 64-bit is accessed as a result of this command, theSampledTypeof theOpTypeImageoperand of that instruction must have aWidthof 32 -
VUID-vkCmdDispatchIndirect-sparseImageInt64Atomics-04474
If thesparseImageInt64Atomicsfeature is not enabled, VkImage objects created with theVK_IMAGE_CREATE_SPARSE_RESIDENCY_BITflag must not be accessed by atomic instructions through anOpTypeImagewith aSampledTypewith aWidthof 64 by this command -
VUID-vkCmdDispatchIndirect-sparseImageInt64Atomics-04475
If thesparseImageInt64Atomicsfeature is not enabled, VkBuffer objects created with theVK_BUFFER_CREATE_SPARSE_RESIDENCY_BITflag must not be accessed by atomic instructions through anOpTypeImagewith aSampledTypewith aWidthof 64 by this command -
VUID-vkCmdDispatchIndirect-OpImageWeightedSampleQCOM-06971
IfOpImageWeightedSampleQCOMis used to sample a VkImageView as a result of this command, then the image view’s format features must containVK_FORMAT_FEATURE_2_WEIGHT_SAMPLED_IMAGE_BIT_QCOM -
VUID-vkCmdDispatchIndirect-OpImageWeightedSampleQCOM-06972
IfOpImageWeightedSampleQCOMuses a VkImageView as a sample weight image as a result of this command, then the image view’s format features must containVK_FORMAT_FEATURE_2_WEIGHT_IMAGE_BIT_QCOM -
VUID-vkCmdDispatchIndirect-OpImageBoxFilterQCOM-06973
IfOpImageBoxFilterQCOMis used to sample a VkImageView as a result of this command, then the image view’s format features must containVK_FORMAT_FEATURE_2_BOX_FILTER_SAMPLED_BIT_QCOM -
VUID-vkCmdDispatchIndirect-OpImageBlockMatchSSDQCOM-06974
IfOpImageBlockMatchSSDQCOMis used to read from an VkImageView as a result of this command, then the image view’s format features must containVK_FORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM -
VUID-vkCmdDispatchIndirect-OpImageBlockMatchSADQCOM-06975
IfOpImageBlockMatchSADQCOMis used to read from an VkImageView as a result of this command, then the image view’s format features must containVK_FORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM -
VUID-vkCmdDispatchIndirect-OpImageBlockMatchSADQCOM-06976
IfOpImageBlockMatchSADQCOMor OpImageBlockMatchSSDQCOM is used to read from a reference image as result of this command, then the specified reference coordinates must not fail integer texel coordinate validation -
VUID-vkCmdDispatchIndirect-OpImageWeightedSampleQCOM-06977
IfOpImageWeightedSampleQCOM,OpImageBoxFilterQCOM,OpImageBlockMatchWindowSSDQCOM,OpImageBlockMatchWindowSADQCOM,OpImageBlockMatchGatherSSDQCOM,OpImageBlockMatchGatherSADQCOM,OpImageBlockMatchSSDQCOM, orOpImageBlockMatchSADQCOMuses a VkSampler as a result of this command, then the sampler must have been created withVK_SAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM -
VUID-vkCmdDispatchIndirect-OpImageWeightedSampleQCOM-06978
If any command other thanOpImageWeightedSampleQCOM,OpImageBoxFilterQCOM,OpImageBlockMatchWindowSSDQCOM,OpImageBlockMatchWindowSADQCOM,OpImageBlockMatchGatherSSDQCOM,OpImageBlockMatchGatherSADQCOM,OpImageBlockMatchSSDQCOM, orOpImageBlockMatchSADQCOMuses a VkSampler as a result of this command, then the sampler must not have been created withVK_SAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM -
VUID-vkCmdDispatchIndirect-OpImageBlockMatchWindow-09215
If aOpImageBlockMatchWindow*QCOMorOpImageBlockMatchGather*QCOMinstruction is used to read from an VkImageView as a result of this command, then the image view’s format features must containVK_FORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM -
VUID-vkCmdDispatchIndirect-OpImageBlockMatchWindow-09216
If aOpImageBlockMatchWindow*QCOMorOpImageBlockMatchGather*QCOMinstruction is used to read from an VkImageView as a result of this command, then the image view’s format must be a single-component format. -
VUID-vkCmdDispatchIndirect-OpImageBlockMatchWindow-09217
If aOpImageBlockMatchWindow*QCOMorOpImageBlockMatchGather*QCOMread from a reference image as result of this command, then the specified reference coordinates must not fail integer texel coordinate validation -
VUID-vkCmdDispatchIndirect-None-07288
Any shader invocation executed by this command must terminate
-
VUID-vkCmdDispatchIndirect-buffer-02708
Ifbufferis non-sparse then it must be bound completely and contiguously to a singleVkDeviceMemoryobject -
VUID-vkCmdDispatchIndirect-buffer-02709
buffermust have been created with theVK_BUFFER_USAGE_INDIRECT_BUFFER_BITbit set -
VUID-vkCmdDispatchIndirect-offset-02710
offsetmust be a multiple of4 -
VUID-vkCmdDispatchIndirect-commandBuffer-02711
commandBuffermust not be a protected command buffer -
VUID-vkCmdDispatchIndirect-offset-00407
The sum ofoffsetand the size ofVkDispatchIndirectCommandmust be less than or equal to the size ofbuffer
-
VUID-vkCmdDispatchIndirect-commandBuffer-parameter
commandBuffermust be a valid VkCommandBuffer handle -
VUID-vkCmdDispatchIndirect-buffer-parameter
buffermust be a valid VkBuffer handle -
VUID-vkCmdDispatchIndirect-commandBuffer-recording
commandBuffermust be in the recording state -
VUID-vkCmdDispatchIndirect-commandBuffer-cmdpool
TheVkCommandPoolthatcommandBufferwas allocated from must support compute operations -
VUID-vkCmdDispatchIndirect-renderpass
This command must only be called outside of a render pass instance -
VUID-vkCmdDispatchIndirect-videocoding
This command must only be called outside of a video coding scope -
VUID-vkCmdDispatchIndirect-commonparent
Both ofbuffer, andcommandBuffermust have been created, allocated, or retrieved from the same VkDevice
-
Host access to
commandBuffermust be externally synchronized -
Host access to the
VkCommandPoolthatcommandBufferwas allocated from must be externally synchronized
| Command Buffer Levels | Render Pass Scope | Video Coding Scope | Supported Queue Types | Command Type |
|---|---|---|---|---|
Primary |
Outside |
Outside |
Compute |
Action |
The VkDispatchIndirectCommand structure is defined as:
// Provided by VK_VERSION_1_0
typedef struct VkDispatchIndirectCommand {
uint32_t x;
uint32_t y;
uint32_t z;
} VkDispatchIndirectCommand;
-
xis the number of local workgroups to dispatch in the X dimension. -
yis the number of local workgroups to dispatch in the Y dimension. -
zis the number of local workgroups to dispatch in the Z dimension.
The members of VkDispatchIndirectCommand have the same meaning as the
corresponding parameters of vkCmdDispatch.
-
VUID-VkDispatchIndirectCommand-x-00417
xmust be less than or equal toVkPhysicalDeviceLimits::maxComputeWorkGroupCount[0] -
VUID-VkDispatchIndirectCommand-y-00418
ymust be less than or equal toVkPhysicalDeviceLimits::maxComputeWorkGroupCount[1] -
VUID-VkDispatchIndirectCommand-z-00419
zmust be less than or equal toVkPhysicalDeviceLimits::maxComputeWorkGroupCount[2]
To record a dispatch using non-zero base values for the components of
WorkgroupId, call:
// Provided by VK_VERSION_1_1
void vkCmdDispatchBase(
VkCommandBuffer commandBuffer,
uint32_t baseGroupX,
uint32_t baseGroupY,
uint32_t baseGroupZ,
uint32_t groupCountX,
uint32_t groupCountY,
uint32_t groupCountZ);
or the equivalent command
// Provided by VK_KHR_device_group
void vkCmdDispatchBaseKHR(
VkCommandBuffer commandBuffer,
uint32_t baseGroupX,
uint32_t baseGroupY,
uint32_t baseGroupZ,
uint32_t groupCountX,
uint32_t groupCountY,
uint32_t groupCountZ);
-
commandBufferis the command buffer into which the command will be recorded. -
baseGroupXis the start value for the X component ofWorkgroupId. -
baseGroupYis the start value for the Y component ofWorkgroupId. -
baseGroupZis the start value for the Z component ofWorkgroupId. -
groupCountXis the number of local workgroups to dispatch in the X dimension. -
groupCountYis the number of local workgroups to dispatch in the Y dimension. -
groupCountZis the number of local workgroups to dispatch in the Z dimension.
When the command is executed, a global workgroup consisting of
groupCountX × groupCountY × groupCountZ
local workgroups is assembled, with WorkgroupId values ranging from
[baseGroup*, baseGroup* + groupCount*) in each
component.
vkCmdDispatch is equivalent to
vkCmdDispatchBase(0,0,0,groupCountX,groupCountY,groupCountZ).
-
VUID-vkCmdDispatchBase-magFilter-04553
If a VkSampler created withmagFilterorminFilterequal toVK_FILTER_LINEARandcompareEnableequal toVK_FALSEis used to sample a VkImageView as a result of this command, then the image view’s format features must containVK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT -
VUID-vkCmdDispatchBase-mipmapMode-04770
If a VkSampler created withmipmapModeequal toVK_SAMPLER_MIPMAP_MODE_LINEARandcompareEnableequal toVK_FALSEis used to sample a VkImageView as a result of this command, then the image view’s format features must containVK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT -
VUID-vkCmdDispatchBase-None-06479
If a VkImageView is sampled with depth comparison, the image view’s format features must containVK_FORMAT_FEATURE_2_SAMPLED_IMAGE_DEPTH_COMPARISON_BIT -
VUID-vkCmdDispatchBase-None-02691
If a VkImageView is accessed using atomic operations as a result of this command, then the image view’s format features must containVK_FORMAT_FEATURE_STORAGE_IMAGE_ATOMIC_BIT -
VUID-vkCmdDispatchBase-None-07888
If aVK_DESCRIPTOR_TYPE_STORAGE_TEXEL_BUFFERdescriptor is accessed using atomic operations as a result of this command, then the storage texel buffer’s format features must containVK_FORMAT_FEATURE_STORAGE_TEXEL_BUFFER_ATOMIC_BIT -
VUID-vkCmdDispatchBase-None-02692
If a VkImageView is sampled withVK_FILTER_CUBIC_EXTas a result of this command, then the image view’s format features must containVK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_CUBIC_BIT_EXT -
VUID-vkCmdDispatchBase-None-02693
If the VK_EXT_filter_cubic extension is not enabled and any VkImageView is sampled withVK_FILTER_CUBIC_EXTas a result of this command, it must not have a VkImageViewType ofVK_IMAGE_VIEW_TYPE_3D,VK_IMAGE_VIEW_TYPE_CUBE, orVK_IMAGE_VIEW_TYPE_CUBE_ARRAY -
VUID-vkCmdDispatchBase-filterCubic-02694
Any VkImageView being sampled withVK_FILTER_CUBIC_EXTas a result of this command must have a VkImageViewType and format that supports cubic filtering, as specified by VkFilterCubicImageViewImageFormatPropertiesEXT::filterCubicreturned by vkGetPhysicalDeviceImageFormatProperties2 -
VUID-vkCmdDispatchBase-filterCubicMinmax-02695
Any VkImageView being sampled withVK_FILTER_CUBIC_EXTwith a reduction mode of eitherVK_SAMPLER_REDUCTION_MODE_MINorVK_SAMPLER_REDUCTION_MODE_MAXas a result of this command must have a VkImageViewType and format that supports cubic filtering together with minmax filtering, as specified by VkFilterCubicImageViewImageFormatPropertiesEXT::filterCubicMinmaxreturned by vkGetPhysicalDeviceImageFormatProperties2 -
VUID-vkCmdDispatchBase-cubicRangeClamp-09212
If thecubicRangeClampfeature is not enabled, then any VkImageView being sampled withVK_FILTER_CUBIC_EXTas a result of this command must not have a VkSamplerReductionModeCreateInfo::reductionModeequal toVK_SAMPLER_REDUCTION_MODE_WEIGHTED_AVERAGE_RANGECLAMP_QCOM -
VUID-vkCmdDispatchBase-reductionMode-09213
Any VkImageView being sampled with a VkSamplerReductionModeCreateInfo::reductionModeequal toVK_SAMPLER_REDUCTION_MODE_WEIGHTED_AVERAGE_RANGECLAMP_QCOMas a result of this command must sample withVK_FILTER_CUBIC_EXT -
VUID-vkCmdDispatchBase-selectableCubicWeights-09214
If theselectableCubicWeightsfeature is not enabled, then any VkImageView being sampled withVK_FILTER_CUBIC_EXTas a result of this command must have VkSamplerCubicWeightsCreateInfoQCOM::cubicWeightsequal toVK_CUBIC_FILTER_WEIGHTS_CATMULL_ROM_QCOM -
VUID-vkCmdDispatchBase-flags-02696
Any VkImage created with a VkImageCreateInfo::flagscontainingVK_IMAGE_CREATE_CORNER_SAMPLED_BIT_NVsampled as a result of this command must only be sampled using a VkSamplerAddressMode ofVK_SAMPLER_ADDRESS_MODE_CLAMP_TO_EDGE -
VUID-vkCmdDispatchBase-OpTypeImage-07027
For any VkImageView being written as a storage image where the image format field of theOpTypeImageisUnknown, the view’s format features must containVK_FORMAT_FEATURE_2_STORAGE_WRITE_WITHOUT_FORMAT_BIT -
VUID-vkCmdDispatchBase-OpTypeImage-07028
For any VkImageView being read as a storage image where the image format field of theOpTypeImageisUnknown, the view’s format features must containVK_FORMAT_FEATURE_2_STORAGE_READ_WITHOUT_FORMAT_BIT -
VUID-vkCmdDispatchBase-OpTypeImage-07029
For any VkBufferView being written as a storage texel buffer where the image format field of theOpTypeImageisUnknown, the view’s buffer features must containVK_FORMAT_FEATURE_2_STORAGE_WRITE_WITHOUT_FORMAT_BIT -
VUID-vkCmdDispatchBase-OpTypeImage-07030
Any VkBufferView being read as a storage texel buffer where the image format field of theOpTypeImageisUnknownthen the view’s buffer features must containVK_FORMAT_FEATURE_2_STORAGE_READ_WITHOUT_FORMAT_BIT -
VUID-vkCmdDispatchBase-None-08600
For each set n that is statically used by a bound shader, a descriptor set must have been bound to n at the same pipeline bind point, with a VkPipelineLayout that is compatible for set n, with the VkPipelineLayout used to create the current VkPipeline or the VkDescriptorSetLayout array used to create the current VkShaderEXT , as described in Pipeline Layout Compatibility -
VUID-vkCmdDispatchBase-None-08601
For each push constant that is statically used by a bound shader, a push constant value must have been set for the same pipeline bind point, with a VkPipelineLayout that is compatible for push constants, with the VkPipelineLayout used to create the current VkPipeline or the VkDescriptorSetLayout array used to create the current VkShaderEXT , as described in Pipeline Layout Compatibility -
VUID-vkCmdDispatchBase-maintenance4-08602
If themaintenance4feature is not enabled, then for each push constant that is statically used by a bound shader, a push constant value must have been set for the same pipeline bind point, with a VkPipelineLayout that is compatible for push constants, with the VkPipelineLayout used to create the current VkPipeline or the VkDescriptorSetLayout and VkPushConstantRange arrays used to create the current VkShaderEXT , as described in Pipeline Layout Compatibility -
VUID-vkCmdDispatchBase-None-08114
Descriptors in each bound descriptor set, specified via vkCmdBindDescriptorSets, must be valid as described by descriptor validity if they are statically used by the VkPipeline bound to the pipeline bind point used by this command and the bound VkPipeline was not created withVK_PIPELINE_CREATE_DESCRIPTOR_BUFFER_BIT_EXT -
VUID-vkCmdDispatchBase-None-08115
If the descriptors used by the VkPipeline bound to the pipeline bind point were specified via vkCmdBindDescriptorSets, the bound VkPipeline must have been created withoutVK_PIPELINE_CREATE_DESCRIPTOR_BUFFER_BIT_EXT -
VUID-vkCmdDispatchBase-None-08116
Descriptors in bound descriptor buffers, specified via vkCmdSetDescriptorBufferOffsetsEXT, must be valid if they are dynamically used by the VkPipeline bound to the pipeline bind point used by this command and the bound VkPipeline was created withVK_PIPELINE_CREATE_DESCRIPTOR_BUFFER_BIT_EXT -
VUID-vkCmdDispatchBase-None-08604
Descriptors in bound descriptor buffers, specified via vkCmdSetDescriptorBufferOffsetsEXT, must be valid if they are dynamically used by any VkShaderEXT bound to a stage corresponding to the pipeline bind point used by this command -
VUID-vkCmdDispatchBase-None-08117
If the descriptors used by the VkPipeline bound to the pipeline bind point were specified via vkCmdSetDescriptorBufferOffsetsEXT, the bound VkPipeline must have been created withVK_PIPELINE_CREATE_DESCRIPTOR_BUFFER_BIT_EXT -
VUID-vkCmdDispatchBase-None-08119
If a descriptor is dynamically used with a VkPipeline created withVK_PIPELINE_CREATE_DESCRIPTOR_BUFFER_BIT_EXT, the descriptor memory must be resident -
VUID-vkCmdDispatchBase-None-08605
If a descriptor is dynamically used with a VkShaderEXT created with aVkDescriptorSetLayoutthat was created withVK_DESCRIPTOR_SET_LAYOUT_CREATE_DESCRIPTOR_BUFFER_BIT_EXT, the descriptor memory must be resident -
VUID-vkCmdDispatchBase-None-08606
If theshaderObjectfeature is not enabled, a valid pipeline must be bound to the pipeline bind point used by this command -
VUID-vkCmdDispatchBase-None-08608
If a pipeline is bound to the pipeline bind point used by this command, there must not have been any calls to dynamic state setting commands for any state not specified as dynamic in the VkPipeline object bound to the pipeline bind point used by this command, since that pipeline was bound -
VUID-vkCmdDispatchBase-None-08609
If the VkPipeline object bound to the pipeline bind point used by this command or any VkShaderEXT bound to a stage corresponding to the pipeline bind point used by this command accesses a VkSampler object that uses unnormalized coordinates, that sampler must not be used to sample from any VkImage with a VkImageView of the typeVK_IMAGE_VIEW_TYPE_3D,VK_IMAGE_VIEW_TYPE_CUBE,VK_IMAGE_VIEW_TYPE_1D_ARRAY,VK_IMAGE_VIEW_TYPE_2D_ARRAYorVK_IMAGE_VIEW_TYPE_CUBE_ARRAY, in any shader stage -
VUID-vkCmdDispatchBase-None-08610
If the VkPipeline object bound to the pipeline bind point used by this command or any VkShaderEXT bound to a stage corresponding to the pipeline bind point used by this command accesses a VkSampler object that uses unnormalized coordinates, that sampler must not be used with any of the SPIR-VOpImageSample*orOpImageSparseSample*instructions withImplicitLod,DreforProjin their name, in any shader stage -
VUID-vkCmdDispatchBase-None-08611
If the VkPipeline object bound to the pipeline bind point used by this command or any VkShaderEXT bound to a stage corresponding to the pipeline bind point used by this command accesses a VkSampler object that uses unnormalized coordinates, that sampler must not be used with any of the SPIR-VOpImageSample*orOpImageSparseSample*instructions that includes a LOD bias or any offset values, in any shader stage -
VUID-vkCmdDispatchBase-None-08607
If theshaderObjectis enabled, either a valid pipeline must be bound to the pipeline bind point used by this command, or a valid combination of valid and VK_NULL_HANDLE shader objects must be bound to every supported shader stage corresponding to the pipeline bind point used by this command -
VUID-vkCmdDispatchBase-uniformBuffers-06935
If any stage of the VkPipeline object bound to the pipeline bind point used by this command accesses a uniform buffer, and that stage was created without enabling eitherVK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_EXTorVK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXTforuniformBuffers, and therobustBufferAccessfeature is not enabled, that stage must not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point -
VUID-vkCmdDispatchBase-None-08612
If therobustBufferAccessfeature is not enabled, and any VkShaderEXT bound to a stage corresponding to the pipeline bind point used by this command accesses a uniform buffer, it must not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point -
VUID-vkCmdDispatchBase-storageBuffers-06936
If any stage of the VkPipeline object bound to the pipeline bind point used by this command accesses a storage buffer, and that stage was created without enabling eitherVK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_EXTorVK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXTforstorageBuffers, and therobustBufferAccessfeature is not enabled, that stage must not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point -
VUID-vkCmdDispatchBase-None-08613
If therobustBufferAccessfeature is not enabled, and any VkShaderEXT bound to a stage corresponding to the pipeline bind point used by this command accesses a storage buffer, it must not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point -
VUID-vkCmdDispatchBase-commandBuffer-02707
IfcommandBufferis an unprotected command buffer andprotectedNoFaultis not supported, any resource accessed by bound shaders must not be a protected resource -
VUID-vkCmdDispatchBase-None-06550
If a bound shader accesses a VkSampler or VkImageView object that enables sampler Y′CBCR conversion, that object must only be used withOpImageSample*orOpImageSparseSample*instructions -
VUID-vkCmdDispatchBase-ConstOffset-06551
If a bound shader accesses a VkSampler or VkImageView object that enables sampler Y′CBCR conversion, that object must not use theConstOffsetandOffsetoperands -
VUID-vkCmdDispatchBase-viewType-07752
If a VkImageView is accessed as a result of this command, then the image view’sviewTypemust match theDimoperand of theOpTypeImageas described in Instruction/Sampler/Image View Validation -
VUID-vkCmdDispatchBase-format-07753
If a VkImageView is accessed as a result of this command, then the numeric type of the image view’sformatand theSampledTypeoperand of theOpTypeImagemust match -
VUID-vkCmdDispatchBase-OpImageWrite-08795
If a VkImageView created with a format other thanVK_FORMAT_A8_UNORM_KHRis accessed usingOpImageWriteas a result of this command, then theTypeof theTexeloperand of that instruction must have at least as many components as the image view’s format -
VUID-vkCmdDispatchBase-OpImageWrite-08796
If a VkImageView created with the formatVK_FORMAT_A8_UNORM_KHRis accessed usingOpImageWriteas a result of this command, then theTypeof theTexeloperand of that instruction must have four components -
VUID-vkCmdDispatchBase-OpImageWrite-04469
If a VkBufferView is accessed usingOpImageWriteas a result of this command, then theTypeof theTexeloperand of that instruction must have at least as many components as the buffer view’s format -
VUID-vkCmdDispatchBase-SampledType-04470
If a VkImageView with a VkFormat that has a 64-bit component width is accessed as a result of this command, theSampledTypeof theOpTypeImageoperand of that instruction must have aWidthof 64 -
VUID-vkCmdDispatchBase-SampledType-04471
If a VkImageView with a VkFormat that has a component width less than 64-bit is accessed as a result of this command, theSampledTypeof theOpTypeImageoperand of that instruction must have aWidthof 32 -
VUID-vkCmdDispatchBase-SampledType-04472
If a VkBufferView with a VkFormat that has a 64-bit component width is accessed as a result of this command, theSampledTypeof theOpTypeImageoperand of that instruction must have aWidthof 64 -
VUID-vkCmdDispatchBase-SampledType-04473
If a VkBufferView with a VkFormat that has a component width less than 64-bit is accessed as a result of this command, theSampledTypeof theOpTypeImageoperand of that instruction must have aWidthof 32 -
VUID-vkCmdDispatchBase-sparseImageInt64Atomics-04474
If thesparseImageInt64Atomicsfeature is not enabled, VkImage objects created with theVK_IMAGE_CREATE_SPARSE_RESIDENCY_BITflag must not be accessed by atomic instructions through anOpTypeImagewith aSampledTypewith aWidthof 64 by this command -
VUID-vkCmdDispatchBase-sparseImageInt64Atomics-04475
If thesparseImageInt64Atomicsfeature is not enabled, VkBuffer objects created with theVK_BUFFER_CREATE_SPARSE_RESIDENCY_BITflag must not be accessed by atomic instructions through anOpTypeImagewith aSampledTypewith aWidthof 64 by this command -
VUID-vkCmdDispatchBase-OpImageWeightedSampleQCOM-06971
IfOpImageWeightedSampleQCOMis used to sample a VkImageView as a result of this command, then the image view’s format features must containVK_FORMAT_FEATURE_2_WEIGHT_SAMPLED_IMAGE_BIT_QCOM -
VUID-vkCmdDispatchBase-OpImageWeightedSampleQCOM-06972
IfOpImageWeightedSampleQCOMuses a VkImageView as a sample weight image as a result of this command, then the image view’s format features must containVK_FORMAT_FEATURE_2_WEIGHT_IMAGE_BIT_QCOM -
VUID-vkCmdDispatchBase-OpImageBoxFilterQCOM-06973
IfOpImageBoxFilterQCOMis used to sample a VkImageView as a result of this command, then the image view’s format features must containVK_FORMAT_FEATURE_2_BOX_FILTER_SAMPLED_BIT_QCOM -
VUID-vkCmdDispatchBase-OpImageBlockMatchSSDQCOM-06974
IfOpImageBlockMatchSSDQCOMis used to read from an VkImageView as a result of this command, then the image view’s format features must containVK_FORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM -
VUID-vkCmdDispatchBase-OpImageBlockMatchSADQCOM-06975
IfOpImageBlockMatchSADQCOMis used to read from an VkImageView as a result of this command, then the image view’s format features must containVK_FORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM -
VUID-vkCmdDispatchBase-OpImageBlockMatchSADQCOM-06976
IfOpImageBlockMatchSADQCOMor OpImageBlockMatchSSDQCOM is used to read from a reference image as result of this command, then the specified reference coordinates must not fail integer texel coordinate validation -
VUID-vkCmdDispatchBase-OpImageWeightedSampleQCOM-06977
IfOpImageWeightedSampleQCOM,OpImageBoxFilterQCOM,OpImageBlockMatchWindowSSDQCOM,OpImageBlockMatchWindowSADQCOM,OpImageBlockMatchGatherSSDQCOM,OpImageBlockMatchGatherSADQCOM,OpImageBlockMatchSSDQCOM, orOpImageBlockMatchSADQCOMuses a VkSampler as a result of this command, then the sampler must have been created withVK_SAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM -
VUID-vkCmdDispatchBase-OpImageWeightedSampleQCOM-06978
If any command other thanOpImageWeightedSampleQCOM,OpImageBoxFilterQCOM,OpImageBlockMatchWindowSSDQCOM,OpImageBlockMatchWindowSADQCOM,OpImageBlockMatchGatherSSDQCOM,OpImageBlockMatchGatherSADQCOM,OpImageBlockMatchSSDQCOM, orOpImageBlockMatchSADQCOMuses a VkSampler as a result of this command, then the sampler must not have been created withVK_SAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM -
VUID-vkCmdDispatchBase-OpImageBlockMatchWindow-09215
If aOpImageBlockMatchWindow*QCOMorOpImageBlockMatchGather*QCOMinstruction is used to read from an VkImageView as a result of this command, then the image view’s format features must containVK_FORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM -
VUID-vkCmdDispatchBase-OpImageBlockMatchWindow-09216
If aOpImageBlockMatchWindow*QCOMorOpImageBlockMatchGather*QCOMinstruction is used to read from an VkImageView as a result of this command, then the image view’s format must be a single-component format. -
VUID-vkCmdDispatchBase-OpImageBlockMatchWindow-09217
If aOpImageBlockMatchWindow*QCOMorOpImageBlockMatchGather*QCOMread from a reference image as result of this command, then the specified reference coordinates must not fail integer texel coordinate validation -
VUID-vkCmdDispatchBase-None-07288
Any shader invocation executed by this command must terminate
-
VUID-vkCmdDispatchBase-commandBuffer-02712
IfcommandBufferis a protected command buffer andprotectedNoFaultis not supported, any resource written to by theVkPipelineobject bound to the pipeline bind point used by this command must not be an unprotected resource -
VUID-vkCmdDispatchBase-commandBuffer-02713
IfcommandBufferis a protected command buffer andprotectedNoFaultis not supported, pipeline stages other than the framebuffer-space and compute stages in theVkPipelineobject bound to the pipeline bind point used by this command must not write to any resource -
VUID-vkCmdDispatchBase-commandBuffer-04617
If any of the shader stages of theVkPipelinebound to the pipeline bind point used by this command uses theRayQueryKHRcapability, thencommandBuffermust not be a protected command buffer -
VUID-vkCmdDispatchBase-baseGroupX-00421
baseGroupXmust be less thanVkPhysicalDeviceLimits::maxComputeWorkGroupCount[0] -
VUID-vkCmdDispatchBase-baseGroupX-00422
baseGroupYmust be less thanVkPhysicalDeviceLimits::maxComputeWorkGroupCount[1] -
VUID-vkCmdDispatchBase-baseGroupZ-00423
baseGroupZmust be less thanVkPhysicalDeviceLimits::maxComputeWorkGroupCount[2] -
VUID-vkCmdDispatchBase-groupCountX-00424
groupCountXmust be less than or equal toVkPhysicalDeviceLimits::maxComputeWorkGroupCount[0] minusbaseGroupX -
VUID-vkCmdDispatchBase-groupCountY-00425
groupCountYmust be less than or equal toVkPhysicalDeviceLimits::maxComputeWorkGroupCount[1] minusbaseGroupY -
VUID-vkCmdDispatchBase-groupCountZ-00426
groupCountZmust be less than or equal toVkPhysicalDeviceLimits::maxComputeWorkGroupCount[2] minusbaseGroupZ -
VUID-vkCmdDispatchBase-baseGroupX-00427
If any ofbaseGroupX,baseGroupY, orbaseGroupZare not zero, then the bound compute pipeline must have been created with theVK_PIPELINE_CREATE_DISPATCH_BASEflag
-
VUID-vkCmdDispatchBase-commandBuffer-parameter
commandBuffermust be a valid VkCommandBuffer handle -
VUID-vkCmdDispatchBase-commandBuffer-recording
commandBuffermust be in the recording state -
VUID-vkCmdDispatchBase-commandBuffer-cmdpool
TheVkCommandPoolthatcommandBufferwas allocated from must support compute operations -
VUID-vkCmdDispatchBase-renderpass
This command must only be called outside of a render pass instance -
VUID-vkCmdDispatchBase-videocoding
This command must only be called outside of a video coding scope
-
Host access to
commandBuffermust be externally synchronized -
Host access to the
VkCommandPoolthatcommandBufferwas allocated from must be externally synchronized
| Command Buffer Levels | Render Pass Scope | Video Coding Scope | Supported Queue Types | Command Type |
|---|---|---|---|---|
Primary |
Outside |
Outside |
Compute |
Action |
A subpass shading dispatches a compute pipeline work with the work dimension of render area of the calling subpass and work groups are partitioned by specified work group size. Subpass operations like subpassLoad and subpassLoadMS are allowed to be used.
To record a subpass shading, call:
// Provided by VK_HUAWEI_subpass_shading
void vkCmdSubpassShadingHUAWEI(
VkCommandBuffer commandBuffer);
-
commandBufferis the command buffer into which the command will be recorded.
When the command is executed, a global workgroup consisting of ceil (render area size / local workgroup size) local workgroups is assembled.
-
VUID-vkCmdSubpassShadingHUAWEI-magFilter-04553
If a VkSampler created withmagFilterorminFilterequal toVK_FILTER_LINEARandcompareEnableequal toVK_FALSEis used to sample a VkImageView as a result of this command, then the image view’s format features must containVK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT -
VUID-vkCmdSubpassShadingHUAWEI-mipmapMode-04770
If a VkSampler created withmipmapModeequal toVK_SAMPLER_MIPMAP_MODE_LINEARandcompareEnableequal toVK_FALSEis used to sample a VkImageView as a result of this command, then the image view’s format features must containVK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT -
VUID-vkCmdSubpassShadingHUAWEI-None-06479
If a VkImageView is sampled with depth comparison, the image view’s format features must containVK_FORMAT_FEATURE_2_SAMPLED_IMAGE_DEPTH_COMPARISON_BIT -
VUID-vkCmdSubpassShadingHUAWEI-None-02691
If a VkImageView is accessed using atomic operations as a result of this command, then the image view’s format features must containVK_FORMAT_FEATURE_STORAGE_IMAGE_ATOMIC_BIT -
VUID-vkCmdSubpassShadingHUAWEI-None-07888
If aVK_DESCRIPTOR_TYPE_STORAGE_TEXEL_BUFFERdescriptor is accessed using atomic operations as a result of this command, then the storage texel buffer’s format features must containVK_FORMAT_FEATURE_STORAGE_TEXEL_BUFFER_ATOMIC_BIT -
VUID-vkCmdSubpassShadingHUAWEI-None-02692
If a VkImageView is sampled withVK_FILTER_CUBIC_EXTas a result of this command, then the image view’s format features must containVK_FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_CUBIC_BIT_EXT -
VUID-vkCmdSubpassShadingHUAWEI-None-02693
If the VK_EXT_filter_cubic extension is not enabled and any VkImageView is sampled withVK_FILTER_CUBIC_EXTas a result of this command, it must not have a VkImageViewType ofVK_IMAGE_VIEW_TYPE_3D,VK_IMAGE_VIEW_TYPE_CUBE, orVK_IMAGE_VIEW_TYPE_CUBE_ARRAY -
VUID-vkCmdSubpassShadingHUAWEI-filterCubic-02694
Any VkImageView being sampled withVK_FILTER_CUBIC_EXTas a result of this command must have a VkImageViewType and format that supports cubic filtering, as specified by VkFilterCubicImageViewImageFormatPropertiesEXT::filterCubicreturned by vkGetPhysicalDeviceImageFormatProperties2 -
VUID-vkCmdSubpassShadingHUAWEI-filterCubicMinmax-02695
Any VkImageView being sampled withVK_FILTER_CUBIC_EXTwith a reduction mode of eitherVK_SAMPLER_REDUCTION_MODE_MINorVK_SAMPLER_REDUCTION_MODE_MAXas a result of this command must have a VkImageViewType and format that supports cubic filtering together with minmax filtering, as specified by VkFilterCubicImageViewImageFormatPropertiesEXT::filterCubicMinmaxreturned by vkGetPhysicalDeviceImageFormatProperties2 -
VUID-vkCmdSubpassShadingHUAWEI-cubicRangeClamp-09212
If thecubicRangeClampfeature is not enabled, then any VkImageView being sampled withVK_FILTER_CUBIC_EXTas a result of this command must not have a VkSamplerReductionModeCreateInfo::reductionModeequal toVK_SAMPLER_REDUCTION_MODE_WEIGHTED_AVERAGE_RANGECLAMP_QCOM -
VUID-vkCmdSubpassShadingHUAWEI-reductionMode-09213
Any VkImageView being sampled with a VkSamplerReductionModeCreateInfo::reductionModeequal toVK_SAMPLER_REDUCTION_MODE_WEIGHTED_AVERAGE_RANGECLAMP_QCOMas a result of this command must sample withVK_FILTER_CUBIC_EXT -
VUID-vkCmdSubpassShadingHUAWEI-selectableCubicWeights-09214
If theselectableCubicWeightsfeature is not enabled, then any VkImageView being sampled withVK_FILTER_CUBIC_EXTas a result of this command must have VkSamplerCubicWeightsCreateInfoQCOM::cubicWeightsequal toVK_CUBIC_FILTER_WEIGHTS_CATMULL_ROM_QCOM -
VUID-vkCmdSubpassShadingHUAWEI-flags-02696
Any VkImage created with a VkImageCreateInfo::flagscontainingVK_IMAGE_CREATE_CORNER_SAMPLED_BIT_NVsampled as a result of this command must only be sampled using a VkSamplerAddressMode ofVK_SAMPLER_ADDRESS_MODE_CLAMP_TO_EDGE -
VUID-vkCmdSubpassShadingHUAWEI-OpTypeImage-07027
For any VkImageView being written as a storage image where the image format field of theOpTypeImageisUnknown, the view’s format features must containVK_FORMAT_FEATURE_2_STORAGE_WRITE_WITHOUT_FORMAT_BIT -
VUID-vkCmdSubpassShadingHUAWEI-OpTypeImage-07028
For any VkImageView being read as a storage image where the image format field of theOpTypeImageisUnknown, the view’s format features must containVK_FORMAT_FEATURE_2_STORAGE_READ_WITHOUT_FORMAT_BIT -
VUID-vkCmdSubpassShadingHUAWEI-OpTypeImage-07029
For any VkBufferView being written as a storage texel buffer where the image format field of theOpTypeImageisUnknown, the view’s buffer features must containVK_FORMAT_FEATURE_2_STORAGE_WRITE_WITHOUT_FORMAT_BIT -
VUID-vkCmdSubpassShadingHUAWEI-OpTypeImage-07030
Any VkBufferView being read as a storage texel buffer where the image format field of theOpTypeImageisUnknownthen the view’s buffer features must containVK_FORMAT_FEATURE_2_STORAGE_READ_WITHOUT_FORMAT_BIT -
VUID-vkCmdSubpassShadingHUAWEI-None-08600
For each set n that is statically used by a bound shader, a descriptor set must have been bound to n at the same pipeline bind point, with a VkPipelineLayout that is compatible for set n, with the VkPipelineLayout used to create the current VkPipeline or the VkDescriptorSetLayout array used to create the current VkShaderEXT , as described in Pipeline Layout Compatibility -
VUID-vkCmdSubpassShadingHUAWEI-None-08601
For each push constant that is statically used by a bound shader, a push constant value must have been set for the same pipeline bind point, with a VkPipelineLayout that is compatible for push constants, with the VkPipelineLayout used to create the current VkPipeline or the VkDescriptorSetLayout array used to create the current VkShaderEXT , as described in Pipeline Layout Compatibility -
VUID-vkCmdSubpassShadingHUAWEI-maintenance4-08602
If themaintenance4feature is not enabled, then for each push constant that is statically used by a bound shader, a push constant value must have been set for the same pipeline bind point, with a VkPipelineLayout that is compatible for push constants, with the VkPipelineLayout used to create the current VkPipeline or the VkDescriptorSetLayout and VkPushConstantRange arrays used to create the current VkShaderEXT , as described in Pipeline Layout Compatibility -
VUID-vkCmdSubpassShadingHUAWEI-None-08114
Descriptors in each bound descriptor set, specified via vkCmdBindDescriptorSets, must be valid as described by descriptor validity if they are statically used by the VkPipeline bound to the pipeline bind point used by this command and the bound VkPipeline was not created withVK_PIPELINE_CREATE_DESCRIPTOR_BUFFER_BIT_EXT -
VUID-vkCmdSubpassShadingHUAWEI-None-08115
If the descriptors used by the VkPipeline bound to the pipeline bind point were specified via vkCmdBindDescriptorSets, the bound VkPipeline must have been created withoutVK_PIPELINE_CREATE_DESCRIPTOR_BUFFER_BIT_EXT -
VUID-vkCmdSubpassShadingHUAWEI-None-08116
Descriptors in bound descriptor buffers, specified via vkCmdSetDescriptorBufferOffsetsEXT, must be valid if they are dynamically used by the VkPipeline bound to the pipeline bind point used by this command and the bound VkPipeline was created withVK_PIPELINE_CREATE_DESCRIPTOR_BUFFER_BIT_EXT -
VUID-vkCmdSubpassShadingHUAWEI-None-08604
Descriptors in bound descriptor buffers, specified via vkCmdSetDescriptorBufferOffsetsEXT, must be valid if they are dynamically used by any VkShaderEXT bound to a stage corresponding to the pipeline bind point used by this command -
VUID-vkCmdSubpassShadingHUAWEI-None-08117
If the descriptors used by the VkPipeline bound to the pipeline bind point were specified via vkCmdSetDescriptorBufferOffsetsEXT, the bound VkPipeline must have been created withVK_PIPELINE_CREATE_DESCRIPTOR_BUFFER_BIT_EXT -
VUID-vkCmdSubpassShadingHUAWEI-None-08119
If a descriptor is dynamically used with a VkPipeline created withVK_PIPELINE_CREATE_DESCRIPTOR_BUFFER_BIT_EXT, the descriptor memory must be resident -
VUID-vkCmdSubpassShadingHUAWEI-None-08605
If a descriptor is dynamically used with a VkShaderEXT created with aVkDescriptorSetLayoutthat was created withVK_DESCRIPTOR_SET_LAYOUT_CREATE_DESCRIPTOR_BUFFER_BIT_EXT, the descriptor memory must be resident -
VUID-vkCmdSubpassShadingHUAWEI-None-08606
If theshaderObjectfeature is not enabled, a valid pipeline must be bound to the pipeline bind point used by this command -
VUID-vkCmdSubpassShadingHUAWEI-None-08608
If a pipeline is bound to the pipeline bind point used by this command, there must not have been any calls to dynamic state setting commands for any state not specified as dynamic in the VkPipeline object bound to the pipeline bind point used by this command, since that pipeline was bound -
VUID-vkCmdSubpassShadingHUAWEI-None-08609
If the VkPipeline object bound to the pipeline bind point used by this command or any VkShaderEXT bound to a stage corresponding to the pipeline bind point used by this command accesses a VkSampler object that uses unnormalized coordinates, that sampler must not be used to sample from any VkImage with a VkImageView of the typeVK_IMAGE_VIEW_TYPE_3D,VK_IMAGE_VIEW_TYPE_CUBE,VK_IMAGE_VIEW_TYPE_1D_ARRAY,VK_IMAGE_VIEW_TYPE_2D_ARRAYorVK_IMAGE_VIEW_TYPE_CUBE_ARRAY, in any shader stage -
VUID-vkCmdSubpassShadingHUAWEI-None-08610
If the VkPipeline object bound to the pipeline bind point used by this command or any VkShaderEXT bound to a stage corresponding to the pipeline bind point used by this command accesses a VkSampler object that uses unnormalized coordinates, that sampler must not be used with any of the SPIR-VOpImageSample*orOpImageSparseSample*instructions withImplicitLod,DreforProjin their name, in any shader stage -
VUID-vkCmdSubpassShadingHUAWEI-None-08611
If the VkPipeline object bound to the pipeline bind point used by this command or any VkShaderEXT bound to a stage corresponding to the pipeline bind point used by this command accesses a VkSampler object that uses unnormalized coordinates, that sampler must not be used with any of the SPIR-VOpImageSample*orOpImageSparseSample*instructions that includes a LOD bias or any offset values, in any shader stage -
VUID-vkCmdSubpassShadingHUAWEI-None-08607
If theshaderObjectis enabled, either a valid pipeline must be bound to the pipeline bind point used by this command, or a valid combination of valid and VK_NULL_HANDLE shader objects must be bound to every supported shader stage corresponding to the pipeline bind point used by this command -
VUID-vkCmdSubpassShadingHUAWEI-uniformBuffers-06935
If any stage of the VkPipeline object bound to the pipeline bind point used by this command accesses a uniform buffer, and that stage was created without enabling eitherVK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_EXTorVK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXTforuniformBuffers, and therobustBufferAccessfeature is not enabled, that stage must not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point -
VUID-vkCmdSubpassShadingHUAWEI-None-08612
If therobustBufferAccessfeature is not enabled, and any VkShaderEXT bound to a stage corresponding to the pipeline bind point used by this command accesses a uniform buffer, it must not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point -
VUID-vkCmdSubpassShadingHUAWEI-storageBuffers-06936
If any stage of the VkPipeline object bound to the pipeline bind point used by this command accesses a storage buffer, and that stage was created without enabling eitherVK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_EXTorVK_PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXTforstorageBuffers, and therobustBufferAccessfeature is not enabled, that stage must not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point -
VUID-vkCmdSubpassShadingHUAWEI-None-08613
If therobustBufferAccessfeature is not enabled, and any VkShaderEXT bound to a stage corresponding to the pipeline bind point used by this command accesses a storage buffer, it must not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point -
VUID-vkCmdSubpassShadingHUAWEI-commandBuffer-02707
IfcommandBufferis an unprotected command buffer andprotectedNoFaultis not supported, any resource accessed by bound shaders must not be a protected resource -
VUID-vkCmdSubpassShadingHUAWEI-None-06550
If a bound shader accesses a VkSampler or VkImageView object that enables sampler Y′CBCR conversion, that object must only be used withOpImageSample*orOpImageSparseSample*instructions -
VUID-vkCmdSubpassShadingHUAWEI-ConstOffset-06551
If a bound shader accesses a VkSampler or VkImageView object that enables sampler Y′CBCR conversion, that object must not use theConstOffsetandOffsetoperands -
VUID-vkCmdSubpassShadingHUAWEI-viewType-07752
If a VkImageView is accessed as a result of this command, then the image view’sviewTypemust match theDimoperand of theOpTypeImageas described in Instruction/Sampler/Image View Validation -
VUID-vkCmdSubpassShadingHUAWEI-format-07753
If a VkImageView is accessed as a result of this command, then the numeric type of the image view’sformatand theSampledTypeoperand of theOpTypeImagemust match -
VUID-vkCmdSubpassShadingHUAWEI-OpImageWrite-08795
If a VkImageView created with a format other thanVK_FORMAT_A8_UNORM_KHRis accessed usingOpImageWriteas a result of this command, then theTypeof theTexeloperand of that instruction must have at least as many components as the image view’s format -
VUID-vkCmdSubpassShadingHUAWEI-OpImageWrite-08796
If a VkImageView created with the formatVK_FORMAT_A8_UNORM_KHRis accessed usingOpImageWriteas a result of this command, then theTypeof theTexeloperand of that instruction must have four components -
VUID-vkCmdSubpassShadingHUAWEI-OpImageWrite-04469
If a VkBufferView is accessed usingOpImageWriteas a result of this command, then theTypeof theTexeloperand of that instruction must have at least as many components as the buffer view’s format -
VUID-vkCmdSubpassShadingHUAWEI-SampledType-04470
If a VkImageView with a VkFormat that has a 64-bit component width is accessed as a result of this command, theSampledTypeof theOpTypeImageoperand of that instruction must have aWidthof 64 -
VUID-vkCmdSubpassShadingHUAWEI-SampledType-04471
If a VkImageView with a VkFormat that has a component width less than 64-bit is accessed as a result of this command, theSampledTypeof theOpTypeImageoperand of that instruction must have aWidthof 32 -
VUID-vkCmdSubpassShadingHUAWEI-SampledType-04472
If a VkBufferView with a VkFormat that has a 64-bit component width is accessed as a result of this command, theSampledTypeof theOpTypeImageoperand of that instruction must have aWidthof 64 -
VUID-vkCmdSubpassShadingHUAWEI-SampledType-04473
If a VkBufferView with a VkFormat that has a component width less than 64-bit is accessed as a result of this command, theSampledTypeof theOpTypeImageoperand of that instruction must have aWidthof 32 -
VUID-vkCmdSubpassShadingHUAWEI-sparseImageInt64Atomics-04474
If thesparseImageInt64Atomicsfeature is not enabled, VkImage objects created with theVK_IMAGE_CREATE_SPARSE_RESIDENCY_BITflag must not be accessed by atomic instructions through anOpTypeImagewith aSampledTypewith aWidthof 64 by this command -
VUID-vkCmdSubpassShadingHUAWEI-sparseImageInt64Atomics-04475
If thesparseImageInt64Atomicsfeature is not enabled, VkBuffer objects created with theVK_BUFFER_CREATE_SPARSE_RESIDENCY_BITflag must not be accessed by atomic instructions through anOpTypeImagewith aSampledTypewith aWidthof 64 by this command -
VUID-vkCmdSubpassShadingHUAWEI-OpImageWeightedSampleQCOM-06971
IfOpImageWeightedSampleQCOMis used to sample a VkImageView as a result of this command, then the image view’s format features must containVK_FORMAT_FEATURE_2_WEIGHT_SAMPLED_IMAGE_BIT_QCOM -
VUID-vkCmdSubpassShadingHUAWEI-OpImageWeightedSampleQCOM-06972
IfOpImageWeightedSampleQCOMuses a VkImageView as a sample weight image as a result of this command, then the image view’s format features must containVK_FORMAT_FEATURE_2_WEIGHT_IMAGE_BIT_QCOM -
VUID-vkCmdSubpassShadingHUAWEI-OpImageBoxFilterQCOM-06973
IfOpImageBoxFilterQCOMis used to sample a VkImageView as a result of this command, then the image view’s format features must containVK_FORMAT_FEATURE_2_BOX_FILTER_SAMPLED_BIT_QCOM -
VUID-vkCmdSubpassShadingHUAWEI-OpImageBlockMatchSSDQCOM-06974
IfOpImageBlockMatchSSDQCOMis used to read from an VkImageView as a result of this command, then the image view’s format features must containVK_FORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM -
VUID-vkCmdSubpassShadingHUAWEI-OpImageBlockMatchSADQCOM-06975
IfOpImageBlockMatchSADQCOMis used to read from an VkImageView as a result of this command, then the image view’s format features must containVK_FORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM -
VUID-vkCmdSubpassShadingHUAWEI-OpImageBlockMatchSADQCOM-06976
IfOpImageBlockMatchSADQCOMor OpImageBlockMatchSSDQCOM is used to read from a reference image as result of this command, then the specified reference coordinates must not fail integer texel coordinate validation -
VUID-vkCmdSubpassShadingHUAWEI-OpImageWeightedSampleQCOM-06977
IfOpImageWeightedSampleQCOM,OpImageBoxFilterQCOM,OpImageBlockMatchWindowSSDQCOM,OpImageBlockMatchWindowSADQCOM,OpImageBlockMatchGatherSSDQCOM,OpImageBlockMatchGatherSADQCOM,OpImageBlockMatchSSDQCOM, orOpImageBlockMatchSADQCOMuses a VkSampler as a result of this command, then the sampler must have been created withVK_SAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM -
VUID-vkCmdSubpassShadingHUAWEI-OpImageWeightedSampleQCOM-06978
If any command other thanOpImageWeightedSampleQCOM,OpImageBoxFilterQCOM,OpImageBlockMatchWindowSSDQCOM,OpImageBlockMatchWindowSADQCOM,OpImageBlockMatchGatherSSDQCOM,OpImageBlockMatchGatherSADQCOM,OpImageBlockMatchSSDQCOM, orOpImageBlockMatchSADQCOMuses a VkSampler as a result of this command, then the sampler must not have been created withVK_SAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM -
VUID-vkCmdSubpassShadingHUAWEI-OpImageBlockMatchWindow-09215
If aOpImageBlockMatchWindow*QCOMorOpImageBlockMatchGather*QCOMinstruction is used to read from an VkImageView as a result of this command, then the image view’s format features must containVK_FORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM -
VUID-vkCmdSubpassShadingHUAWEI-OpImageBlockMatchWindow-09216
If aOpImageBlockMatchWindow*QCOMorOpImageBlockMatchGather*QCOMinstruction is used to read from an VkImageView as a result of this command, then the image view’s format must be a single-component format. -
VUID-vkCmdSubpassShadingHUAWEI-OpImageBlockMatchWindow-09217
If aOpImageBlockMatchWindow*QCOMorOpImageBlockMatchGather*QCOMread from a reference image as result of this command, then the specified reference coordinates must not fail integer texel coordinate validation -
VUID-vkCmdSubpassShadingHUAWEI-None-07288
Any shader invocation executed by this command must terminate -
VUID-vkCmdSubpassShadingHUAWEI-None-04931
This command must be called in a subpass with bind pointVK_PIPELINE_BIND_POINT_SUBPASS_SHADING_HUAWEI. No draw commands can be called in the same subpass. Only one vkCmdSubpassShadingHUAWEI command can be called in a subpass
-
VUID-vkCmdSubpassShadingHUAWEI-commandBuffer-parameter
commandBuffermust be a valid VkCommandBuffer handle -
VUID-vkCmdSubpassShadingHUAWEI-commandBuffer-recording
commandBuffermust be in the recording state -
VUID-vkCmdSubpassShadingHUAWEI-commandBuffer-cmdpool
TheVkCommandPoolthatcommandBufferwas allocated from must support graphics operations -
VUID-vkCmdSubpassShadingHUAWEI-renderpass
This command must only be called inside of a render pass instance -
VUID-vkCmdSubpassShadingHUAWEI-videocoding
This command must only be called outside of a video coding scope
-
Host access to
commandBuffermust be externally synchronized -
Host access to the
VkCommandPoolthatcommandBufferwas allocated from must be externally synchronized
| Command Buffer Levels | Render Pass Scope | Video Coding Scope | Supported Queue Types | Command Type |
|---|---|---|---|---|
Primary |
Inside |
Outside |
Graphics |
Action |
31.1. Dispatch Command for CUDA PTX Kernels
Compute kernels can be provided in SPIR-V or PTX code. When using PTX kernels the dispatch mechanism is different than with regular compute pipelines.
The way to create a PTX assembly file is beyond the scope of this documentation. For mode information, please refer to the CUDA toolkit documentation at https://docs.nvidia.com/cuda/.
Prior to using this command, you must initialize a CUDA module, and create a function handle that will serve as the entry point of the kernel to dispatch. See CUDA Modules.
The dispatching of a CUDA kernel is recorded into a command buffer, and when executed by a queue submit, will produce work which executes according to the bound compute pipeline.
To record a CUDA kernel launch, call:
// Provided by VK_NV_cuda_kernel_launch
void vkCmdCudaLaunchKernelNV(
VkCommandBuffer commandBuffer,
const VkCudaLaunchInfoNV* pLaunchInfo);
-
commandBufferis the command buffer into which the command will be recorded. -
pLaunchInfois a pointer to a VkCudaLaunchInfoNV structure in which the grid (similar to workgroup) dimension, function handle and related arguments are defined.
When the command is executed, a global workgroup consisting of
gridDimX × gridDimY × gridDimZ local
workgroups is assembled.
-
VUID-vkCmdCudaLaunchKernelNV-commandBuffer-parameter
commandBuffermust be a valid VkCommandBuffer handle -
VUID-vkCmdCudaLaunchKernelNV-pLaunchInfo-parameter
pLaunchInfomust be a valid pointer to a valid VkCudaLaunchInfoNV structure -
VUID-vkCmdCudaLaunchKernelNV-commandBuffer-recording
commandBuffermust be in the recording state -
VUID-vkCmdCudaLaunchKernelNV-commandBuffer-cmdpool
TheVkCommandPoolthatcommandBufferwas allocated from must support graphics, or compute operations -
VUID-vkCmdCudaLaunchKernelNV-videocoding
This command must only be called outside of a video coding scope
-
Host access to the
VkCommandPoolthatcommandBufferwas allocated from must be externally synchronized
| Command Buffer Levels | Render Pass Scope | Video Coding Scope | Supported Queue Types | Command Type |
|---|---|---|---|---|
Primary |
Both |
Outside |
Graphics |
Action |
31.1.1. Passing Dispatch Parameters and Arguments
The VkCudaLaunchInfoNV structure is very close to the parameters of
the CUDA-Driver function
cuLaunchKernel
documented in section
6.19
Execution Control of CUDA Driver API.
The structure is defined as:
// Provided by VK_NV_cuda_kernel_launch
typedef struct VkCudaLaunchInfoNV {
VkStructureType sType;
const void* pNext;
VkCudaFunctionNV function;
uint32_t gridDimX;
uint32_t gridDimY;
uint32_t gridDimZ;
uint32_t blockDimX;
uint32_t blockDimY;
uint32_t blockDimZ;
uint32_t sharedMemBytes;
size_t paramCount;
const void* const * pParams;
size_t extraCount;
const void* const * pExtras;
} VkCudaLaunchInfoNV;
-
sTypeis a VkStructureType value identifying this structure. -
pNextisNULLor a pointer to a structure extending this structure. -
functionis the CUDA-Driver handle to the function being launched. -
gridDimXis the number of local workgroups to dispatch in the X dimension. It must be less than or equal toVkPhysicalDeviceLimits::maxComputeWorkGroupCount[0] -
gridDimYis the number of local workgroups to dispatch in the Y dimension. It must be less than or equal toVkPhysicalDeviceLimits::maxComputeWorkGroupCount[1] -
gridDimZis the number of local workgroups to dispatch in the Z dimension. It must be less than or equal toVkPhysicalDeviceLimits::maxComputeWorkGroupCount[2] -
blockDimXis block size in the X dimension. -
blockDimYis block size in the Y dimension. -
blockDimZis block size in the Z dimension. -
sharedMemBytesis the dynamic shared-memory size per thread block in bytes. -
paramCountis the length of thepParamstable. -
pParamsis a pointer to an array ofparamCountpointers, corresponding to the arguments offunction. -
extraCountis reserved for future use. -
pExtrasis reserved for future use.
Kernel parameters of function are specified via pParams, very
much the same way as described in
cuLaunchKernel
If function has N parameters, then pParams must be an array of
N pointers and paramCount must be set to N. Each of
kernelParams[0] through kernelParams[N-1] must point to a
region of memory from which the actual kernel parameter will be copied.
The number of kernel parameters and their offsets and sizes are not
specified here as that information is stored in the VkCudaFunctionNV
object.
The application-owned memory pointed to by pParams and
kernelParams[0] through kernelParams[N-1] are consumed
immediately, and may be altered or freed after
vkCmdCudaLaunchKernelNV has returned.
-
VUID-VkCudaLaunchInfoNV-gridDimX-09406
gridDimXmust be less than or equal toVkPhysicalDeviceLimits::maxComputeWorkGroupCount[0] -
VUID-VkCudaLaunchInfoNV-gridDimY-09407
gridDimYmust be less than or equal toVkPhysicalDeviceLimits::maxComputeWorkGroupCount[1] -
VUID-VkCudaLaunchInfoNV-gridDimZ-09408
gridDimZmust be less than or equal toVkPhysicalDeviceLimits::maxComputeWorkGroupCount[2] -
VUID-VkCudaLaunchInfoNV-paramCount-09409
paramCountmust be the total amount of parameters listed in thepParamstable. -
VUID-VkCudaLaunchInfoNV-pParams-09410
pParamsmust be a pointer to a table ofparamCountparameters, corresponding to the arguments offunction. -
VUID-VkCudaLaunchInfoNV-extraCount-09411
extraCountmust be 0
-
VUID-VkCudaLaunchInfoNV-sType-sType
sTypemust beVK_STRUCTURE_TYPE_CUDA_LAUNCH_INFO_NV -
VUID-VkCudaLaunchInfoNV-function-parameter
functionmust be a valid VkCudaFunctionNV handle
31.1.2. Resource Sharing from Vulkan to the CUDA Kernel
Given that one key limitation of this extension is that Vulkan cannot access, nor bind any global resource of CUDA modules, the only way to exchange data with the kernel must be to pass resources via the arguments of the function.
You can use VK_KHR_buffer_device_address to write/read to/from a
VkBuffer object.
VK_KHR_buffer_device_address allows you to get the device address of
the buffer to pass it as an argument into pParams.
Application-side pointer arithmetic on the device address is legal, but will
not be bounds-checked on the device.
The corresponding argument of the CUDA function should be declared as a pointer of the same type as the referenced buffer. CUDA code may simply read or write to this buffer in the typical C way.
You may also use VK_NVX_image_view_handle as another convenient way to read/write from/to a VkImage.
The corresponding argument of the CUDA function must be typed as
cudaSurfaceObject_t.
-
You may read from it by using CUDA surface-read functions such as
surf3Dread,surf2Dread, andsurf1Dread -
You may write to it by using CUDA surface-write functions such as
surf3Dwrite,surf2Dwrite, andsurf1Dwrite
Please refer to CUDA surface object documentation for more details
On Vulkan side, here is an example on how to setup
VkImageViewHandleInfoNVX to query the handle for
cudaSurfaceObject_t:
VkImageViewHandleInfoNVX imageViewHandleInfo = {VK_STRUCTURE_TYPE_IMAGE_VIEW_HANDLE_INFO_NVX};
imageViewHandleInfo.sampler = VK_NULL_HANDLE;
imageViewHandleInfo.descriptorType = VK_DESCRIPTOR_TYPE_STORAGE_IMAGE;
imageViewHandleInfo.imageView = imageViewIn; // the VkImageView we want to access
uint32_t myViewHandleIn = vkGetImageViewHandleNVX(m_device, &imageViewHandleInfo);
imageViewHandleInfo.imageView = imageViewOut; // the VkImageView we want to access
uint32_t myViewHandleOut = vkGetImageViewHandleNVX(m_device, &imageViewHandleInfo);
Here is an example of how to declare parameters for pParams
VkCudaLaunchInfoNV launchInfo = { VK_STRUCTURE_TYPE_CUDA_LAUNCH_INFO_NV };
int block_size = 8;
float dt = 1.0f / 60.0f;
const void* params[] =
{
&dt,
&uint32_t myViewHandleIn,
&uint32_t myViewHandleOut
};
launchInfo.function = cudaFunction; // CUDA function previously created
launchInfo.gridDimX = (volumeTexDimensionNonBoundary / block_size);
launchInfo.gridDimY = (volumeTexDimensionNonBoundary / block_size);
launchInfo.gridDimZ = (volumeTexDimensionNonBoundary / block_size);
launchInfo.blockDimX = block_size;
launchInfo.blockDimY = block_size;
launchInfo.blockDimZ = block_size;
launchInfo.sharedMemBytes = 0;
launchInfo.paramCount = 3;
launchInfo.pParams = ¶ms[0];
launchInfo.extraCount = 0;
launchInfo.pExtras = nullptr;
vkCmdCudaLaunchKernelNV(commandBuffer, &launchInfo);
In the CUDA kernel source code, here is an example on how arguments match
pParams and how we can use Surface object:
extern "C" __global__ void cudaFunction(
float dt,
cudaSurfaceObject_t volumeTexIn,
cudaSurfaceObject_t volumeTexOut
)
{
int i = 1 + blockIdx.x * blockDim.x + threadIdx.x;
int j = 1 + blockIdx.y * blockDim.y + threadIdx.y;
int k = 1 + blockIdx.z * blockDim.z + threadIdx.z;
float val;
surf3Dread(&val, volumeTexIn, i * sizeof(float), j, k);
...
float result = ...;
// write result
surf3Dwrite(result, volumeTexOut, i * sizeof(float), j, k);
}