C Specification
To record an indirect dispatching command, call:
// Provided by VK_VERSION_1_0
void vkCmdDispatchIndirect(
VkCommandBuffer commandBuffer,
VkBuffer buffer,
VkDeviceSize offset);
Parameters
-
commandBuffer
is the command buffer into which the command will be recorded. -
buffer
is the buffer containing dispatch parameters. -
offset
is the byte offset intobuffer
where parameters begin.
Description
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 withmagFilter
orminFilter
equal toVK_FILTER_LINEAR
andcompareEnable
equal toVK_FALSE
is 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 withmipmapMode
equal toVK_SAMPLER_MIPMAP_MODE_LINEAR
andcompareEnable
equal toVK_FALSE
is 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-aspectMask-06478
If a VkImageView is sampled with depth comparison, the image view must have been created with anaspectMask
that containsVK_IMAGE_ASPECT_DEPTH_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_BUFFER
descriptor 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_EXT
as 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_EXT
as 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_EXT
as a result of this command must have a VkImageViewType and format that supports cubic filtering, as specified by VkFilterCubicImageViewImageFormatPropertiesEXT::filterCubic
returned by vkGetPhysicalDeviceImageFormatProperties2 -
VUID-vkCmdDispatchIndirect-filterCubicMinmax-02695
Any VkImageView being sampled withVK_FILTER_CUBIC_EXT
with a reduction mode of eitherVK_SAMPLER_REDUCTION_MODE_MIN
orVK_SAMPLER_REDUCTION_MODE_MAX
as a result of this command must have a VkImageViewType and format that supports cubic filtering together with minmax filtering, as specified by VkFilterCubicImageViewImageFormatPropertiesEXT::filterCubicMinmax
returned by vkGetPhysicalDeviceImageFormatProperties2 -
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 , as described in [descriptorsets-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 , as described in [descriptorsets-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 a bound shader -
VUID-vkCmdDispatchIndirect-None-08606
A valid pipeline must be bound to the pipeline bind point used by this command -
VUID-vkCmdDispatchIndirect-None-08608
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 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_ARRAY
orVK_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 accesses a VkSampler object that uses unnormalized coordinates, that sampler must not be used with any of the SPIR-VOpImageSample*
orOpImageSparseSample*
instructions withImplicitLod
,Dref
orProj
in their name, in any shader stage -
VUID-vkCmdDispatchIndirect-None-08611
If the VkPipeline object bound 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-uniformBuffers-06935
If any stage of the VkPipeline object bound to the pipeline bind point used by this command accesses a uniform buffer, and therobustBufferAccess
feature 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-storageBuffers-06936
If any stage of the VkPipeline object bound to the pipeline bind point used by this command accesses a storage buffer, and therobustBufferAccess
feature 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-commandBuffer-02707
IfcommandBuffer
is an unprotected command buffer andprotectedNoFault
is 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 theConstOffset
andOffset
operands -
VUID-vkCmdDispatchIndirect-viewType-07752
If a VkImageView is accessed as a result of this command, then the image view’sviewType
must match theDim
operand of theOpTypeImage
as described in [textures-operation-validation] -
VUID-vkCmdDispatchIndirect-format-07753
If a VkImageView is accessed as a result of this command, then the numeric type of the image view’sformat
and theSampled
Type
operand of theOpTypeImage
must match -
VUID-vkCmdDispatchIndirect-OpImageWrite-08795
If a VkImageView is accessed usingOpImageWrite
as a result of this command, then theType
of theTexel
operand of that instruction must have at least as many components as the image view’s format -
VUID-vkCmdDispatchIndirect-OpImageWrite-04469
If a VkBufferView is accessed usingOpImageWrite
as a result of this command, then theType
of theTexel
operand 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, theSampledType
of theOpTypeImage
operand of that instruction must have aWidth
of 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, theSampledType
of theOpTypeImage
operand of that instruction must have aWidth
of 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, theSampledType
of theOpTypeImage
operand of that instruction must have aWidth
of 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, theSampledType
of theOpTypeImage
operand of that instruction must have aWidth
of 32 -
VUID-vkCmdDispatchIndirect-sparseImageInt64Atomics-04474
If thesparseImageInt64Atomics
feature is not enabled, VkImage objects created with theVK_IMAGE_CREATE_SPARSE_RESIDENCY_BIT
flag must not be accessed by atomic instructions through anOpTypeImage
with aSampledType
with aWidth
of 64 by this command -
VUID-vkCmdDispatchIndirect-sparseImageInt64Atomics-04475
If thesparseImageInt64Atomics
feature is not enabled, VkBuffer objects created with theVK_BUFFER_CREATE_SPARSE_RESIDENCY_BIT
flag must not be accessed by atomic instructions through anOpTypeImage
with aSampledType
with aWidth
of 64 by this command -
VUID-vkCmdDispatchIndirect-None-07288
Any shader invocation executed by this command must terminate
-
VUID-vkCmdDispatchIndirect-buffer-02708
Ifbuffer
is non-sparse then it must be bound completely and contiguously to a singleVkDeviceMemory
object -
VUID-vkCmdDispatchIndirect-buffer-02709
buffer
must have been created with theVK_BUFFER_USAGE_INDIRECT_BUFFER_BIT
bit set -
VUID-vkCmdDispatchIndirect-offset-02710
offset
must be a multiple of4
-
VUID-vkCmdDispatchIndirect-commandBuffer-02711
commandBuffer
must not be a protected command buffer -
VUID-vkCmdDispatchIndirect-offset-00407
The sum ofoffset
and the size ofVkDispatchIndirectCommand
must be less than or equal to the size ofbuffer
-
VUID-vkCmdDispatchIndirect-commandBuffer-parameter
commandBuffer
must be a valid VkCommandBuffer handle -
VUID-vkCmdDispatchIndirect-buffer-parameter
buffer
must be a valid VkBuffer handle -
VUID-vkCmdDispatchIndirect-commandBuffer-recording
commandBuffer
must be in the recording state -
VUID-vkCmdDispatchIndirect-commandBuffer-cmdpool
TheVkCommandPool
thatcommandBuffer
was allocated from must support compute operations -
VUID-vkCmdDispatchIndirect-renderpass
This command must only be called outside of a render pass instance -
VUID-vkCmdDispatchIndirect-commonparent
Both ofbuffer
, andcommandBuffer
must have been created, allocated, or retrieved from the same VkDevice
-
Host access to
commandBuffer
must be externally synchronized -
Host access to the
VkCommandPool
thatcommandBuffer
was allocated from must be externally synchronized
Command Buffer Levels | Render Pass Scope | Supported Queue Types | Command Type |
---|---|---|---|
Primary |
Outside |
Compute |
Action |
Document Notes
For more information, see the Vulkan Specification
This page is extracted from the Vulkan Specification. Fixes and changes should be made to the Specification, not directly.