vkCmdBindDescriptorBufferEmbeddedSamplersEXT
To bind an embedded immutable sampler set to a command buffer, call:
void vkCmdBindDescriptorBufferEmbeddedSamplersEXT(
VkCommandBuffer commandBuffer,
VkPipelineBindPoint pipelineBindPoint,
VkPipelineLayout layout,
uint32_t set);
commandBuffer
is the command buffer that the embedded immutable samplers will be bound to.pipelineBindPoint
is a VkPipelineBindPoint indicating the type of the pipeline that will use the embedded immutable samplers.layout
is a VkPipelineLayout object used to program the bindings.set
is the number of the set to be bound.
vkCmdBindDescriptorBufferEmbeddedSamplersEXT
binds the embedded immutable
samplers in set
of layout
to set
for the command buffer
for subsequent bound pipeline commands set
by pipelineBindPoint
.
Any previous binding to this set by vkCmdSetDescriptorBufferOffsetsEXT
or this command is overwritten.
Any sets that were last bound by a call to vkCmdBindDescriptorSets are
invalidated upon calling this command.
Other sets will also be invalidated upon calling this command if
layout
differs from the pipeline layout used to bind those other sets,
as described in Pipeline Layout
Compatibility.
Valid Usage
VUID-vkCmdBindDescriptorBufferEmbeddedSamplersEXT-set-08070
The VkDescriptorSetLayout at index set
when layout
was
created must have been created with the
VK_DESCRIPTOR_SET_LAYOUT_CREATE_EMBEDDED_IMMUTABLE_SAMPLERS_BIT_EXT
bit set
VUID-vkCmdBindDescriptorBufferEmbeddedSamplersEXT-set-08071
set
must be less than or equal to
VkPipelineLayoutCreateInfo::setLayoutCount
provided when
layout
was created
VUID-vkCmdBindDescriptorBufferEmbeddedSamplersEXT-None-08068
The descriptorBuffer
feature must
be enabled
VUID-vkCmdBindDescriptorBufferEmbeddedSamplersEXT-pipelineBindPoint-08069
pipelineBindPoint
must be supported by the commandBuffer
’s
parent VkCommandPool
’s queue family
Valid Usage (Implicit)
VUID-vkCmdBindDescriptorBufferEmbeddedSamplersEXT-commandBuffer-parameter
commandBuffer
must be a valid VkCommandBuffer handle
VUID-vkCmdBindDescriptorBufferEmbeddedSamplersEXT-pipelineBindPoint-parameter
pipelineBindPoint
must be a valid VkPipelineBindPoint value
VUID-vkCmdBindDescriptorBufferEmbeddedSamplersEXT-layout-parameter
layout
must be a valid VkPipelineLayout handle
VUID-vkCmdBindDescriptorBufferEmbeddedSamplersEXT-commandBuffer-recording
commandBuffer
must be in the recording state
VUID-vkCmdBindDescriptorBufferEmbeddedSamplersEXT-commandBuffer-cmdpool
The VkCommandPool
that commandBuffer
was allocated from must support graphics, or compute operations
VUID-vkCmdBindDescriptorBufferEmbeddedSamplersEXT-videocoding
This command must only be called outside of a video coding scope
VUID-vkCmdBindDescriptorBufferEmbeddedSamplersEXT-commonparent
Both of commandBuffer
, and layout
must have been created, allocated, or retrieved from the same VkDevice
Host Synchronization
- Host access to
commandBuffer
must be externally synchronized - Host access to the
VkCommandPool
thatcommandBuffer
was allocated from must be externally synchronized ::