vkCmdSetDescriptorBufferOffsets2EXT - Setting descriptor buffer offsets in a command buffer

Valid Usage

• If commandBuffer is a secondary command buffer, it must have begun with CommandBufferInheritanceDescriptorHeapInfoEXT::pSamplerHeapBindInfo equal to NULL

• If commandBuffer is a secondary command buffer, it must have begun with CommandBufferInheritanceDescriptorHeapInfoEXT::pResourceHeapBindInfo equal to NULL
• The descriptorBuffer feature must be enabled
• Each bit in pSetDescriptorBufferOffsetsInfo->stageFlags must be a stage supported by the commandBuffer’s parent CommandPool’s queue family

Valid Usage (Implicit)

• commandBuffer must be a valid CommandBuffer handle

• pSetDescriptorBufferOffsetsInfo must be a valid pointer to a valid SetDescriptorBufferOffsetsInfoEXT structure
• commandBuffer must be in the recording state
• The CommandPool that commandBuffer was allocated from must support QUEUE_COMPUTE_BIT, QUEUE_DATA_GRAPH_BIT_ARM, or QUEUE_GRAPHICS_BIT operations
• This command must only be called outside of a video coding scope

Host Synchronization

• Host access to commandBuffer must be externally synchronized

• Host access to the CommandPool that commandBuffer was allocated from must be externally synchronized

Command Properties

'

Conditional Rendering

vkCmdSetDescriptorBufferOffsets2EXT is not affected by conditional rendering

See Also

VK_EXT_descriptor_buffer, VK_KHR_maintenance6, CommandBuffer, SetDescriptorBufferOffsetsInfoEXT

vkCmdBindDescriptorBufferEmbeddedSamplers2EXT - Setting embedded immutable samplers offsets in a command buffer

Valid Usage

• If commandBuffer is a secondary command buffer, it must have begun with CommandBufferInheritanceDescriptorHeapInfoEXT::pSamplerHeapBindInfo equal to NULL

• If commandBuffer is a secondary command buffer, it must have begun with CommandBufferInheritanceDescriptorHeapInfoEXT::pResourceHeapBindInfo equal to NULL
• The descriptorBuffer feature must be enabled
• Each bit in pBindDescriptorBufferEmbeddedSamplersInfo->stageFlags must be a stage supported by the commandBuffer’s parent CommandPool’s queue family

Valid Usage (Implicit)

• commandBuffer must be a valid CommandBuffer handle

• pBindDescriptorBufferEmbeddedSamplersInfo must be a valid pointer to a valid BindDescriptorBufferEmbeddedSamplersInfoEXT structure
• commandBuffer must be in the recording state
• The CommandPool that commandBuffer was allocated from must support QUEUE_COMPUTE_BIT, or QUEUE_GRAPHICS_BIT operations
• This command must only be called outside of a video coding scope

Host Synchronization

• Host access to commandBuffer must be externally synchronized

• Host access to the CommandPool that commandBuffer was allocated from must be externally synchronized

Command Properties

'

Conditional Rendering

vkCmdBindDescriptorBufferEmbeddedSamplers2EXT is not affected by conditional rendering

See Also

VK_EXT_descriptor_buffer, VK_KHR_maintenance6, BindDescriptorBufferEmbeddedSamplersInfoEXT, CommandBuffer

VkSetDescriptorBufferOffsetsInfoEXT - Structure specifying descriptor buffer offsets to set in a command buffer

Description

If stageFlags specifies a subset of all stages corresponding to one or more pipeline bind points, the binding operation still affects all stages corresponding to the given pipeline bind point(s) as if the equivalent original version of this command had been called with the same parameters. For example, specifying a stageFlags value of SHADER_STAGE_VERTEX_BIT | SHADER_STAGE_FRAGMENT_BIT | SHADER_STAGE_COMPUTE_BIT is equivalent to calling the original version of this command once with PIPELINE_BIND_POINT_GRAPHICS and once with PIPELINE_BIND_POINT_COMPUTE.

Valid Usage

• The offsets in pOffsets must be aligned to PhysicalDeviceDescriptorBufferPropertiesEXT::descriptorBufferOffsetAlignment

• The offsets in pOffsets must be small enough such that any descriptor binding referenced by layout without the DESCRIPTOR_BINDING_VARIABLE_DESCRIPTOR_COUNT_BIT flag computes a valid address inside the underlying Buffer
• The offsets in pOffsets must be small enough such that any location accessed by a shader as a sampler descriptor must be within PhysicalDeviceDescriptorBufferPropertiesEXT::maxSamplerDescriptorBufferRange of the sampler descriptor buffer binding
• The offsets in pOffsets must be small enough such that any location accessed by a shader as a resource descriptor must be within PhysicalDeviceDescriptorBufferPropertiesEXT::maxResourceDescriptorBufferRange of the resource descriptor buffer binding
• Each element of pBufferIndices must be less than PhysicalDeviceDescriptorBufferPropertiesEXT::maxDescriptorBufferBindings
• Each element of pBufferIndices must reference a valid descriptor buffer binding set by a previous call to cmdBindDescriptorBuffersEXT in commandBuffer
• The sum of firstSet and setCount must be less than or equal to PipelineLayoutCreateInfo::setLayoutCount provided when layout was created
• The DescriptorSetLayout for each set from firstSet to firstSet + setCount when layout was created must have been created with the DESCRIPTOR_SET_LAYOUT_CREATE_DESCRIPTOR_BUFFER_BIT_EXT bit set
• The DescriptorSetLayout for each set from firstSet to firstSet + setCount when layout was created must not have been created with the DESCRIPTOR_SET_LAYOUT_CREATE_PUSH_DESCRIPTOR_BIT_KHR bit set
• The DescriptorSetLayout for each set from firstSet to firstSet + setCount when layout was created must not have been created with the DESCRIPTOR_SET_LAYOUT_CREATE_EMBEDDED_IMMUTABLE_SAMPLERS_BIT_EXT bit set
• If the dynamicPipelineLayout feature is not enabled, layout must be a valid PipelineLayout handle
• If layout is NULL_HANDLE, the pNext chain must include a valid PipelineLayoutCreateInfo structure

Valid Usage (Implicit)

• sType must be STRUCTURE_TYPE_SET_DESCRIPTOR_BUFFER_OFFSETS_INFO_EXT

• pNext must be NULL or a pointer to a valid instance of PipelineLayoutCreateInfo
• The sType value of each structure in the pNext chain must be unique
• stageFlags must be a valid combination of ShaderStageFlagBits values
• stageFlags must not be 0
• If layout is not NULL_HANDLE, layout must be a valid PipelineLayout handle
• pBufferIndices must be a valid pointer to an array of setCount uint32_t values
• pOffsets must be a valid pointer to an array of setCount DeviceSize values
• setCount must be greater than 0

See Also

VK_EXT_descriptor_buffer, VK_KHR_maintenance6, DeviceSize, PipelineLayout, ShaderStageFlags, StructureType, cmdSetDescriptorBufferOffsets2EXT

VkBindDescriptorBufferEmbeddedSamplersInfoEXT - Structure specifying embedded immutable sampler offsets to set in a command buffer

Description

If stageFlags specifies a subset of all stages corresponding to one or more pipeline bind points, the binding operation still affects all stages corresponding to the given pipeline bind point(s) as if the equivalent original version of this command had been called with the same parameters. For example, specifying a stageFlags value of SHADER_STAGE_VERTEX_BIT | SHADER_STAGE_FRAGMENT_BIT | SHADER_STAGE_COMPUTE_BIT is equivalent to calling the original version of this command once with PIPELINE_BIND_POINT_GRAPHICS and once with PIPELINE_BIND_POINT_COMPUTE.

Valid Usage

• The DescriptorSetLayout at index set when layout was created must have been created with the DESCRIPTOR_SET_LAYOUT_CREATE_EMBEDDED_IMMUTABLE_SAMPLERS_BIT_EXT bit set

• set must be less than or equal to PipelineLayoutCreateInfo::setLayoutCount provided when layout was created
• If the dynamicPipelineLayout feature is not enabled, layout must be a valid PipelineLayout handle
• If layout is NULL_HANDLE, the pNext chain must include a valid PipelineLayoutCreateInfo structure

Valid Usage (Implicit)

• sType must be STRUCTURE_TYPE_BIND_DESCRIPTOR_BUFFER_EMBEDDED_SAMPLERS_INFO_EXT

• pNext must be NULL or a pointer to a valid instance of PipelineLayoutCreateInfo
• The sType value of each structure in the pNext chain must be unique
• stageFlags must be a valid combination of ShaderStageFlagBits values
• stageFlags must not be 0
• If layout is not NULL_HANDLE, layout must be a valid PipelineLayout handle

See Also

VK_EXT_descriptor_buffer, VK_KHR_maintenance6, PipelineLayout, ShaderStageFlags, StructureType, cmdBindDescriptorBufferEmbeddedSamplers2EXT