vkCmdBuildAccelerationStructuresIndirectKHR
To build acceleration structures with some parameters sourced on the device call:
void vkCmdBuildAccelerationStructuresIndirectKHR(
VkCommandBuffer commandBuffer,
uint32_t infoCount,
const VkAccelerationStructureBuildGeometryInfoKHR* pInfos,
const VkDeviceAddress* pIndirectDeviceAddresses,
const uint32_t* pIndirectStrides,
const uint32_t* const* ppMaxPrimitiveCounts);
commandBuffer
is the command buffer into which the command will be recorded.infoCount
is the number of acceleration structures to build.pInfos
is a pointer to an array ofinfoCount
VkAccelerationStructureBuildGeometryInfoKHR structures defining the geometry used to build each acceleration structure.pIndirectDeviceAddresses
is a pointer to an array ofinfoCount
buffer device addresses which point topInfos
[i].geometryCount
VkAccelerationStructureBuildRangeInfoKHR structures defining dynamic offsets to the addresses where geometry data is stored, as defined bypInfos
[i].pIndirectStrides
is a pointer to an array ofinfoCount
byte strides between elements ofpIndirectDeviceAddresses
.ppMaxPrimitiveCounts
is a pointer to an array ofinfoCount
pointers to arrays ofpInfos
[i].geometryCount
values indicating the maximum number of primitives that will be built by this command for each geometry.
Accesses to acceleration structures, scratch buffers, vertex buffers, index buffers, and instance buffers must be synchronized as with vkCmdBuildAccelerationStructuresKHR.
Accesses to any element of pIndirectDeviceAddresses
must be
synchronized with the
VK_PIPELINE_STAGE_ACCELERATION_STRUCTURE_BUILD_BIT_KHR
pipeline stage and an
access type of
VK_ACCESS_INDIRECT_COMMAND_READ_BIT
.
Valid Usage
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-accelerationStructureIndirectBuild-03650
The VkPhysicalDeviceAccelerationStructureFeaturesKHR
::accelerationStructureIndirectBuild
feature must be enabled
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-mode-04628
The mode
member of each element of pInfos
must be a valid
VkBuildAccelerationStructureModeKHR value
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-srcAccelerationStructure-04629
If the srcAccelerationStructure
member of any element of
pInfos
is not VK_NULL_HANDLE, the
srcAccelerationStructure
member must be a valid
VkAccelerationStructureKHR handle
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-04630
For each element of pInfos
, if its mode
member is
VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR
, its
srcAccelerationStructure
member must not be VK_NULL_HANDLE
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03403
The srcAccelerationStructure
member of any element of pInfos
must not be the same acceleration structure as the
dstAccelerationStructure
member of any other element of
pInfos
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-dstAccelerationStructure-03698
The dstAccelerationStructure
member of any element of pInfos
must not be the same acceleration structure as the
dstAccelerationStructure
member of any other element of
pInfos
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-dstAccelerationStructure-03800
The dstAccelerationStructure
member of any element of pInfos
must be a valid VkAccelerationStructureKHR handle
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03699
For each element of pInfos
, if its type
member is
VK_ACCELERATION_STRUCTURE_TYPE_TOP_LEVEL_KHR
, its
dstAccelerationStructure
member must have been created with a
value of VkAccelerationStructureCreateInfoKHR::type
equal to
either VK_ACCELERATION_STRUCTURE_TYPE_TOP_LEVEL_KHR
or
VK_ACCELERATION_STRUCTURE_TYPE_GENERIC_KHR
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03700
For each element of pInfos
, if its type
member is
VK_ACCELERATION_STRUCTURE_TYPE_BOTTOM_LEVEL_KHR
, its
dstAccelerationStructure
member must have been created with a
value of VkAccelerationStructureCreateInfoKHR::type
equal to
either VK_ACCELERATION_STRUCTURE_TYPE_BOTTOM_LEVEL_KHR
or
VK_ACCELERATION_STRUCTURE_TYPE_GENERIC_KHR
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03663
For each element of pInfos
, if its mode
member is
VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR
,
inactive primitives in its
srcAccelerationStructure
member must not be made active
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03664
For each element of pInfos
, if its mode
member is
VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR
, active primitives
in its srcAccelerationStructure
member must not be made
inactive
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-None-03407
The dstAccelerationStructure
member of any element of pInfos
must not be referenced by the geometry.instances.data
member of
any element of pGeometries
or ppGeometries
with a
geometryType
of VK_GEOMETRY_TYPE_INSTANCES_KHR
in any other
element of pInfos
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-dstAccelerationStructure-03701
The range of memory backing the dstAccelerationStructure
member of
any element of pInfos
that is accessed by this command must not
overlap the memory backing the srcAccelerationStructure
member of
any other element of pInfos
with a mode
equal to
VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR
, which is accessed
by this command
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-dstAccelerationStructure-03702
The range of memory backing the dstAccelerationStructure
member of
any element of pInfos
that is accessed by this command must not
overlap the memory backing the dstAccelerationStructure
member of
any other element of pInfos
, which is accessed by this command
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-dstAccelerationStructure-03703
The range of memory backing the dstAccelerationStructure
member of
any element of pInfos
that is accessed by this command must not
overlap the memory backing the scratchData
member of any element
of pInfos
(including the same element), which is accessed by this
command
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-scratchData-03704
The range of memory backing the scratchData
member of any element
of pInfos
that is accessed by this command must not overlap the
memory backing the scratchData
member of any other element of
pInfos
, which is accessed by this command
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-scratchData-03705
The range of memory backing the scratchData
member of any element
of pInfos
that is accessed by this command must not overlap the
memory backing the srcAccelerationStructure
member of any element
of pInfos
with a mode
equal to
VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR
(including the
same element), which is accessed by this command
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-dstAccelerationStructure-03706
The range of memory backing the dstAccelerationStructure
member of
any element of pInfos
that is accessed by this command must not
overlap the memory backing any acceleration structure referenced by the
geometry.instances.data
member of any element of pGeometries
or ppGeometries
with a geometryType
of
VK_GEOMETRY_TYPE_INSTANCES_KHR
in any other element of
pInfos
, which is accessed by this command
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03667
For each element of pInfos
, if its mode
member is
VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR
, its
srcAccelerationStructure
member must have previously been
constructed with
VK_BUILD_ACCELERATION_STRUCTURE_ALLOW_UPDATE_BIT_KHR
set in
VkAccelerationStructureBuildGeometryInfoKHR::flags
in the
build
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03668
For each element of pInfos
, if its mode
member is
VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR
, its
srcAccelerationStructure
and dstAccelerationStructure
members must either be the same VkAccelerationStructureKHR, or
not have any memory aliasing
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03758
For each element of pInfos
, if its mode
member is
VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR
, its
geometryCount
member must have the same value which was specified
when srcAccelerationStructure
was last built
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03759
For each element of pInfos
, if its mode
member is
VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR
, its flags
member must have the same value which was specified when
srcAccelerationStructure
was last built
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03760
For each element of pInfos
, if its mode
member is
VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR
, its type
member must have the same value which was specified when
srcAccelerationStructure
was last built
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03761
For each element of pInfos
, if its mode
member is
VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR
, then for each
VkAccelerationStructureGeometryKHR
structure referred to by its
pGeometries
or ppGeometries
members, its geometryType
member must have the same value which was specified when
srcAccelerationStructure
was last built
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03762
For each element of pInfos
, if its mode
member is
VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR
, then for each
VkAccelerationStructureGeometryKHR
structure referred to by its
pGeometries
or ppGeometries
members, its flags
member
must have the same value which was specified when
srcAccelerationStructure
was last built
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03763
For each element of pInfos
, if its mode
member is
VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR
, then for each
VkAccelerationStructureGeometryKHR
structure referred to by its
pGeometries
or ppGeometries
members, if geometryType
is VK_GEOMETRY_TYPE_TRIANGLES_KHR
, its
geometry.triangles.vertexFormat
member must have the same value
which was specified when srcAccelerationStructure
was last built
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03764
For each element of pInfos
, if its mode
member is
VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR
, then for each
VkAccelerationStructureGeometryKHR
structure referred to by its
pGeometries
or ppGeometries
members, if geometryType
is VK_GEOMETRY_TYPE_TRIANGLES_KHR
, its
geometry.triangles.maxVertex
member must have the same value
which was specified when srcAccelerationStructure
was last built
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03765
For each element of pInfos
, if its mode
member is
VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR
, then for each
VkAccelerationStructureGeometryKHR
structure referred to by its
pGeometries
or ppGeometries
members, if geometryType
is VK_GEOMETRY_TYPE_TRIANGLES_KHR
, its
geometry.triangles.indexType
member must have the same value
which was specified when srcAccelerationStructure
was last built
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03766
For each element of pInfos
, if its mode
member is
VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR
, then for each
VkAccelerationStructureGeometryKHR
structure referred to by its
pGeometries
or ppGeometries
members, if geometryType
is VK_GEOMETRY_TYPE_TRIANGLES_KHR
, if its
geometry.triangles.transformData
address was NULL
when
srcAccelerationStructure
was last built, then it must be NULL
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03767
For each element of pInfos
, if its mode
member is
VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR
, then for each
VkAccelerationStructureGeometryKHR
structure referred to by its
pGeometries
or ppGeometries
members, if geometryType
is VK_GEOMETRY_TYPE_TRIANGLES_KHR
, if its
geometry.triangles.transformData
address was not NULL
when
srcAccelerationStructure
was last built, then it must not be
NULL
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03768
For each element of pInfos
, if its mode
member is
VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR
, then for each
VkAccelerationStructureGeometryKHR
structure referred to by its
pGeometries
or ppGeometries
members, if geometryType
is VK_GEOMETRY_TYPE_TRIANGLES_KHR
, and
geometry.triangles.indexType
is not VK_INDEX_TYPE_NONE_KHR
,
then the value of each index referenced must be the same as the
corresponding index value when srcAccelerationStructure
was last
built
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-primitiveCount-03769
For each element of pInfos
, if its mode
member is
VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR
, then for each
VkAccelerationStructureGeometryKHR
structure referred to by its
pGeometries
or ppGeometries
members, the
primitiveCount
member of its corresponding
VkAccelerationStructureBuildRangeInfoKHR
structure must have the
same value which was specified when srcAccelerationStructure
was
last built
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03801
For each element of pInfos
[i].pGeometries
or
pInfos
[i].ppGeometries
with a geometryType
of
VK_GEOMETRY_TYPE_INSTANCES_KHR
, the corresponding
ppMaxPrimitiveCounts
[i][j] must be less than or equal to
VkPhysicalDeviceAccelerationStructurePropertiesKHR::maxInstanceCount
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03707
For each element of pInfos
, the buffer
used to create its
dstAccelerationStructure
member must be bound to device memory
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03708
For each element of pInfos
, if its mode
member is
VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR
the buffer
used to create its srcAccelerationStructure
member must be bound
to device memory
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03709
For each element of pInfos
, the buffer
used to create each
acceleration structure referenced by the geometry.instances.data
member of any element of pGeometries
or ppGeometries
with a
geometryType
of VK_GEOMETRY_TYPE_INSTANCES_KHR
must be
bound to device memory
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03671
If pInfos
[i].mode
is
VK_BUILD_ACCELERATION_STRUCTURE_MODE_BUILD_KHR
, all addresses
between pInfos
[i].scratchData.deviceAddress
and
pInfos
[i].scratchData.deviceAddress
+ N - 1 must be in
the buffer device address range of the same buffer, where N is given by
the buildScratchSize
member of the
VkAccelerationStructureBuildSizesInfoKHR structure returned from a
call to vkGetAccelerationStructureBuildSizesKHR with an identical
VkAccelerationStructureBuildGeometryInfoKHR structure and
primitive count
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03672
If pInfos
[i].mode
is
VK_BUILD_ACCELERATION_STRUCTURE_MODE_UPDATE_KHR
, all addresses
between pInfos
[i].scratchData.deviceAddress
and
pInfos
[i].scratchData.deviceAddress
+ N - 1 must be in
the buffer device address range of the same buffer, where N is given by
the updateScratchSize
member of the
VkAccelerationStructureBuildSizesInfoKHR structure returned from a
call to vkGetAccelerationStructureBuildSizesKHR with an identical
VkAccelerationStructureBuildGeometryInfoKHR structure and
primitive count
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-geometry-03673
The buffers from which the buffer device addresses for all of the
geometry.triangles.vertexData
, geometry.triangles.indexData
,
geometry.triangles.transformData
, geometry.aabbs.data
, and
geometry.instances.data
members of all
pInfos
[i].pGeometries
and pInfos
[i].ppGeometries
are queried must have been created with the
VK_BUFFER_USAGE_ACCELERATION_STRUCTURE_BUILD_INPUT_READ_ONLY_BIT_KHR
usage flag
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03674
The buffer from which the buffer device address
pInfos
[i].scratchData.deviceAddress
is queried must have
been created with VK_BUFFER_USAGE_STORAGE_BUFFER_BIT
usage flag
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03802
For each element of pInfos
, its scratchData.deviceAddress
member must be a valid device address obtained from
vkGetBufferDeviceAddress
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03803
For each element of pInfos
, if scratchData.deviceAddress
is
the address of a non-sparse buffer then it must be bound completely and
contiguously to a single VkDeviceMemory object
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03710
For each element of pInfos
, its scratchData.deviceAddress
member must be a multiple of
VkPhysicalDeviceAccelerationStructurePropertiesKHR::minAccelerationStructureScratchOffsetAlignment
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03804
For any element of pInfos
[i].pGeometries
or
pInfos
[i].ppGeometries
with a geometryType
of
VK_GEOMETRY_TYPE_TRIANGLES_KHR
,
geometry.triangles.vertexData.deviceAddress
must be a valid
device address obtained from vkGetBufferDeviceAddress
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03805
For any element of pInfos
[i].pGeometries
or
pInfos
[i].ppGeometries
with a geometryType
of
VK_GEOMETRY_TYPE_TRIANGLES_KHR
, if
geometry.triangles.vertexData.deviceAddress
is the address of a
non-sparse buffer then it must be bound completely and contiguously to
a single VkDeviceMemory object
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03711
For any element of pInfos
[i].pGeometries
or
pInfos
[i].ppGeometries
with a geometryType
of
VK_GEOMETRY_TYPE_TRIANGLES_KHR
,
geometry.triangles.vertexData.deviceAddress
must be aligned to
the size in bytes of the smallest component of the format in
vertexFormat
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03806
For any element of pInfos
[i].pGeometries
or
pInfos
[i].ppGeometries
with a geometryType
of
VK_GEOMETRY_TYPE_TRIANGLES_KHR
, if
geometry.triangles.indexType
is not VK_INDEX_TYPE_NONE_KHR
,
geometry.triangles.indexData.deviceAddress
must be a valid device
address obtained from vkGetBufferDeviceAddress
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03807
For any element of pInfos
[i].pGeometries
or
pInfos
[i].ppGeometries
with a geometryType
of
VK_GEOMETRY_TYPE_TRIANGLES_KHR
, if
geometry.triangles.indexType
is not VK_INDEX_TYPE_NONE_KHR
,
if geometry.triangles.indexData.deviceAddress
is the address of a
non-sparse buffer then it must be bound completely and contiguously to
a single VkDeviceMemory object
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03712
For any element of pInfos
[i].pGeometries
or
pInfos
[i].ppGeometries
with a geometryType
of
VK_GEOMETRY_TYPE_TRIANGLES_KHR
, and with
geometry.triangles.indexType
not equal to
VK_INDEX_TYPE_NONE_KHR
,
geometry.triangles.indexData.deviceAddress
must be aligned to the
size in bytes of the type in indexType
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03808
For any element of pInfos
[i].pGeometries
or
pInfos
[i].ppGeometries
with a geometryType
of
VK_GEOMETRY_TYPE_TRIANGLES_KHR
, if
geometry.triangles.transformData.deviceAddress
is not 0
, it
must be a valid device address obtained from
vkGetBufferDeviceAddress
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03809
For any element of pInfos
[i].pGeometries
or
pInfos
[i].ppGeometries
with a geometryType
of
VK_GEOMETRY_TYPE_TRIANGLES_KHR
, if
geometry.triangles.transformData.deviceAddress
is the address of a
non-sparse buffer then it must be bound completely and contiguously to
a single VkDeviceMemory object
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03810
For any element of pInfos
[i].pGeometries
or
pInfos
[i].ppGeometries
with a geometryType
of
VK_GEOMETRY_TYPE_TRIANGLES_KHR
, if
geometry.triangles.transformData.deviceAddress
is not 0
, it
must be aligned to 16
bytes
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03811
For any element of pInfos
[i].pGeometries
or
pInfos
[i].ppGeometries
with a geometryType
of
VK_GEOMETRY_TYPE_AABBS_KHR
,
geometry.aabbs.data.deviceAddress
must be a valid device address
obtained from vkGetBufferDeviceAddress
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03812
For any element of pInfos
[i].pGeometries
or
pInfos
[i].ppGeometries
with a geometryType
of
VK_GEOMETRY_TYPE_AABBS_KHR
, if
geometry.aabbs.data.deviceAddress
is the address of a non-sparse
buffer then it must be bound completely and contiguously to a single
VkDeviceMemory object
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03714
For any element of pInfos
[i].pGeometries
or
pInfos
[i].ppGeometries
with a geometryType
of
VK_GEOMETRY_TYPE_AABBS_KHR
,
geometry.aabbs.data.deviceAddress
must be aligned to 8
bytes
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03715
For any element of pInfos
[i].pGeometries
or
pInfos
[i].ppGeometries
with a geometryType
of
VK_GEOMETRY_TYPE_INSTANCES_KHR
, if geometry.arrayOfPointers
is VK_FALSE
, geometry.instances.data.deviceAddress
must be
aligned to 16
bytes
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03716
For any element of pInfos
[i].pGeometries
or
pInfos
[i].ppGeometries
with a geometryType
of
VK_GEOMETRY_TYPE_INSTANCES_KHR
, if geometry.arrayOfPointers
is VK_TRUE
, geometry.instances.data.deviceAddress
must be
aligned to 8
bytes
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03717
For any element of pInfos
[i].pGeometries
or
pInfos
[i].ppGeometries
with a geometryType
of
VK_GEOMETRY_TYPE_INSTANCES_KHR
, if geometry.arrayOfPointers
is VK_TRUE
, each element of
geometry.instances.data.deviceAddress
in device memory must be
aligned to 16
bytes
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03813
For any element of pInfos
[i].pGeometries
or
pInfos
[i].ppGeometries
with a geometryType
of
VK_GEOMETRY_TYPE_INSTANCES_KHR
,
geometry.instances.data.deviceAddress
must be a valid device
address obtained from vkGetBufferDeviceAddress
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03814
For any element of pInfos
[i].pGeometries
or
pInfos
[i].ppGeometries
with a geometryType
of
VK_GEOMETRY_TYPE_INSTANCES_KHR
, if
geometry.instances.data.deviceAddress
is the address of a
non-sparse buffer then it must be bound completely and contiguously to
a single VkDeviceMemory object
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-06707
For any element of pInfos
[i].pGeometries
or
pInfos
[i].ppGeometries
with a geometryType
of
VK_GEOMETRY_TYPE_INSTANCES_KHR
, each
VkAccelerationStructureInstanceKHR::accelerationStructureReference
value in geometry.instances.data.deviceAddress
must be a valid
device address containing a value obtained from
vkGetAccelerationStructureDeviceAddressKHR or 0
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-commandBuffer-09547
commandBuffer
must not be a protected command buffer
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pIndirectDeviceAddresses-03645
For any element of pIndirectDeviceAddresses
, if the buffer from
which it was queried is non-sparse then it must be bound completely and
contiguously to a single VkDeviceMemory object
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pIndirectDeviceAddresses-03646
For any element of pIndirectDeviceAddresses
[i], all device
addresses between pIndirectDeviceAddresses
[i] and
pIndirectDeviceAddresses
[i] +
(pInfos
[i].geometryCount
× pIndirectStrides
[i]) -
1 must be in the buffer device address range of the same buffer
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pIndirectDeviceAddresses-03647
For any element of pIndirectDeviceAddresses
, the buffer from which
it was queried must have been created with the
VK_BUFFER_USAGE_INDIRECT_BUFFER_BIT
bit set
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pIndirectDeviceAddresses-03648
Each element of pIndirectDeviceAddresses
must be a multiple of
4
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pIndirectStrides-03787
Each element of pIndirectStrides
must be a multiple of 4
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pIndirectDeviceAddresses-03651
Each VkAccelerationStructureBuildRangeInfoKHR structure referenced
by any element of pIndirectDeviceAddresses
must be a valid
VkAccelerationStructureBuildRangeInfoKHR structure
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-03652
pInfos
[i].dstAccelerationStructure
must have been created
with a value of VkAccelerationStructureCreateInfoKHR::size
greater than or equal to the memory size required by the build
operation, as returned by vkGetAccelerationStructureBuildSizesKHR
with pBuildInfo
= pInfos
[i] and
pMaxPrimitiveCounts
= ppMaxPrimitiveCounts
[i]
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-ppMaxPrimitiveCounts-03653
Each ppMaxPrimitiveCounts
[i][j] must be greater than or equal to
the primitiveCount
value specified by the
VkAccelerationStructureBuildRangeInfoKHR structure located at
pIndirectDeviceAddresses
[i] + (j
×
pIndirectStrides
[i])
Valid Usage (Implicit)
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-commandBuffer-parameter
commandBuffer
must be a valid VkCommandBuffer handle
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pInfos-parameter
pInfos
must be a valid pointer to an array of infoCount
valid VkAccelerationStructureBuildGeometryInfoKHR structures
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pIndirectDeviceAddresses-parameter
pIndirectDeviceAddresses
must be a valid pointer to an array of infoCount
VkDeviceAddress values
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-pIndirectStrides-parameter
pIndirectStrides
must be a valid pointer to an array of infoCount
uint32_t
values
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-ppMaxPrimitiveCounts-parameter
ppMaxPrimitiveCounts
must be a valid pointer to an array of infoCount
uint32_t
values
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-commandBuffer-recording
commandBuffer
must be in the recording state
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-commandBuffer-cmdpool
The VkCommandPool
that commandBuffer
was allocated from must support compute operations
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-renderpass
This command must only be called outside of a render pass instance
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-videocoding
This command must only be called outside of a video coding scope
VUID-vkCmdBuildAccelerationStructuresIndirectKHR-infoCount-arraylength
infoCount
must be greater than 0
Host Synchronization
- Host access to
commandBuffer
must be externally synchronized - Host access to the
VkCommandPool
thatcommandBuffer
was allocated from must be externally synchronized ::