vkWriteSamplerDescriptorsEXT - Write sampler descriptors to memory

Description

Each descriptor will be written to pDescriptors[i].address where i is the index of its create info in pSamplers.

Descriptors written using a fully identical SamplerCreateInfo structure on the same Device will always return the same bit pattern. If the descriptorHeapCaptureReplay feature is enabled, descriptors written using a fully identical SamplerCreateInfo structure on a Device created from the same PhysicalDevice with identical parameters will always return the same bit pattern.

YCBCR samplers must be embedded in a shader by using ShaderDescriptorSetAndBindingMappingInfoEXT, they cannot be specified here.

Valid Usage

• The descriptorHeap feature must be enabled

• The size member of each element of pDescriptors must be greater than or equal to the value returned by getPhysicalDeviceDescriptorSizeEXT with a descriptorType equal to DESCRIPTOR_TYPE_SAMPLER
• Elements of pSamplers must not include SamplerYcbcrConversionInfo structures in their pNext chains
• If the borderColor of any element of pSamplers is BORDER_COLOR_FLOAT_CUSTOM_EXT or BORDER_COLOR_INT_CUSTOM_EXT, SamplerCustomBorderColorIndexCreateInfoEXT must be included in the pNext chain of that element
• If the borderColor of any element of pSamplers is BORDER_COLOR_FLOAT_CUSTOM_EXT or BORDER_COLOR_INT_CUSTOM_EXT, SamplerCustomBorderColorIndexCreateInfoEXT::index must be a value less than maxCustomBorderColorSamplers
• If there is a DebugUtilsObjectNameInfoEXT structure in the pNext chain of any element of pSamplers, its objectType must be OBJECT_TYPE_UNKNOWN

Valid Usage (Implicit)

• device must be a valid Device handle

• pSamplers must be a valid pointer to an array of samplerCount valid SamplerCreateInfo structures
• pDescriptors must be a valid pointer to an array of samplerCount valid HostAddressRangeEXT structures
• samplerCount must be greater than 0

Return Codes

Success

• SUCCESS

Failure

• ERROR_OUT_OF_DEVICE_MEMORY
• ERROR_OUT_OF_HOST_MEMORY
• ERROR_UNKNOWN
• ERROR_VALIDATION_FAILED

See Also

VK_EXT_descriptor_heap, Device, HostAddressRangeEXT, SamplerCreateInfo

vkWriteResourceDescriptorsEXT - Write resource descriptors to memory

Description

Each descriptor will be written to pDescriptors[i].address where i is the index of its create info in pResources.

If any image descriptor written by this command includes a SamplerYcbcrConversion, multiple descriptors will be written adjacent to each other for that descriptor, equal to SamplerYcbcrConversionImageFormatProperties::combinedImageSamplerDescriptorCount for the image.

If any image descriptor written by this command is for an image created with flags containing IMAGE_CREATE_SUBSAMPLED_BIT_EXT, multiple descriptors will be written adjacent to each other for that descriptor, equal to SubsampledImageFormatPropertiesEXT::subsampledImageDescriptorCount for the image.

Descriptors using the same type and written using a fully identical TexelBufferDescriptorInfoEXT or DeviceAddressRangeEXT structure on the same Device will always return the same bit pattern. If the descriptorHeapCaptureReplay feature is enabled, this applies to any Device created with identical parameters from the same PhysicalDevice.

Recreating the same buffer descriptor during replay of a prior capture requires that the device address is the same, which requires additional data to be captured and provided during replay when creating a buffer and allocating memory for it.

Image descriptors using the same type and written using a fully identical ImageDescriptorInfoEXT other than ImageDescriptorInfoEXT::pView->image, where image was successfully created with IMAGE_CREATE_DESCRIPTOR_HEAP_CAPTURE_REPLAY_BIT_EXT and a OpaqueCaptureDataCreateInfoEXT with data captured via getImageOpaqueCaptureDataEXT from an image used previously, will write a descriptor with the same bit pattern if possible; if the same bit pattern cannot be generated, ERROR_INVALID_OPAQUE_CAPTURE_ADDRESS will be returned instead.

Tensor descriptors using the same type and written using a fully identical TensorViewCreateInfoARM other than TensorViewCreateInfoARM::tensor, where tensor was successfully created with OpaqueCaptureDataCreateInfoEXT with TENSOR_CREATE_DESCRIPTOR_HEAP_CAPTURE_REPLAY_BIT_ARM and a OpaqueCaptureDataCreateInfoEXT with data captured via getTensorOpaqueCaptureDataARM from a tensor used previously, will write a descriptor with the same bit pattern if possible; if the same bit pattern cannot be generated, ERROR_INVALID_OPAQUE_CAPTURE_ADDRESS will be returned instead.

Image creation is sufficiently complex that it may not be possible to recreate all possible descriptors from an image during replay, even if the image itself was successfully recreated. The conditions for this happening will be largely the same as those which could cause allocating a buffer with the same device address during replay to fail. Replay tools are advised to recreate captured descriptors for an image immediately after recreating the image itself wherever possible. The same is true for tensors.

Valid Usage

• The descriptorHeap feature must be enabled

• The size member of each element of pDescriptors must be greater than or equal to the value returned by getPhysicalDeviceDescriptorSizeEXT with a descriptorType equal to type
• If any element of pResources specifies a ImageViewCreateInfo structure with a SamplerYcbcrConversionInfo structure in its pNext chain, the corresponding element of pDescriptors must have a size member that is greater than or equal to the product of the value returned by getPhysicalDeviceDescriptorSizeEXT with a descriptorType equal to type and SamplerYcbcrConversionImageFormatProperties::combinedImageSamplerDescriptorCount, as queried from PhysicalDeviceImageFormatInfo2 with image format info equivalent to the image view the descriptor is being created for
• If any element of pResources specifies a ImageViewCreateInfo structure with an image created with flags containing IMAGE_CREATE_SUBSAMPLED_BIT_EXT, the corresponding element of pDescriptors must have a size member that is greater than or equal to the product of the value returned by getPhysicalDeviceDescriptorSizeEXT with a descriptorType equal to type and SubsampledImageFormatPropertiesEXT::subsampledImageDescriptorCount, as queried from PhysicalDeviceImageFormatInfo2 with image format info equivalent to the image view the descriptor is being created for

Valid Usage (Implicit)

• device must be a valid Device handle

• pResources must be a valid pointer to an array of resourceCount valid ResourceDescriptorInfoEXT structures
• pDescriptors must be a valid pointer to an array of resourceCount valid HostAddressRangeEXT structures
• resourceCount must be greater than 0

Return Codes

Success

• SUCCESS

Failure

• ERROR_OUT_OF_DEVICE_MEMORY
• ERROR_OUT_OF_HOST_MEMORY
• ERROR_UNKNOWN
• ERROR_VALIDATION_FAILED

See Also

VK_EXT_descriptor_heap, Device, HostAddressRangeEXT, ResourceDescriptorInfoEXT

vkCmdBindSamplerHeapEXT - Binds a sampler heap to a command buffer

Description

Addresses in the range defined by pBindInfo->heapRange are bound as the sampler heap. The application can access samplers and data through this heap anywhere except for the reserved range specified by pBindInfo->reservedRangeOffset. Addresses in the range [pBindInfo->reservedRangeOffset, pBindInfo->reservedRangeOffset + minSamplerHeapReservedRange), or in the range [pBindInfo->reservedRangeOffset, pBindInfo->reservedRangeOffset + minSamplerHeapReservedRangeWithEmbedded) if embedded samplers will be used, are reserved for the implementation and must not be accessed by the application at any time from when this command is recorded until all command buffers with that range bound (even invalid ones) have been reset or freed.

Implementations may require a larger sampler heap reservation to store embedded sampler descriptors when used in a mapping, as advertised by minSamplerHeapReservedRangeWithEmbedded.

Shaders executed by commands recorded after this command can use the specified sampler heap to access resources. pBindInfo->heapRange.address will be available to shaders to access samplers and data through the SamplerHeapEXT BuiltIn or via shader bindings.

When cmdBindSamplerHeapEXT is recorded, it immediately invalidates all non-heap descriptor state. Similarly, recording any non-heap descriptor state commands immediately invalidates state set by this command.

Valid Usage

• The sum of pBindInfo->reservedRangeOffset and pBindInfo->reservedRangeSize must be less than or equal to pBindInfo->heapRange.size

• pBindInfo->reservedRangeSize must be greater than or equal to minSamplerHeapReservedRange
• pBindInfo->heapRange.size must less than or equal to maxSamplerHeapSize
• pBindInfo->heapRange.address must be a multiple of samplerHeapAlignment
• pBindInfo->reservedRangeOffset must be a multiple of samplerDescriptorAlignment
• Memory bound to addresses in the range [pBindInfo->heapRange.address + pBindInfo->reservedRangeOffset, pBindInfo->heapRange.address + pBindInfo->reservedRangeOffset + pBindInfo->reservedRangeSize) must not be bound to any other command buffer as a reserved range for any heap unless the reserved range matches exactly and it is the same heap type
• heapRange must be a device address range allocated to the application from a buffer created with the BUFFER_USAGE_DESCRIPTOR_HEAP_BIT_EXT usage flag set
• If commandBuffer is a secondary command buffer, it must have begun with CommandBufferInheritanceDescriptorHeapInfoEXT::pSamplerHeapBindInfo equal to NULL

Valid Usage (Implicit)

• commandBuffer must be a valid CommandBuffer handle

• pBindInfo must be a valid pointer to a valid BindHeapInfoEXT 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

vkCmdBindSamplerHeapEXT is not affected by conditional rendering

See Also

VK_EXT_descriptor_heap, BindHeapInfoEXT, CommandBuffer

vkCmdBindResourceHeapEXT - Binds a resource heap to a command buffer

Description

Addresses in the range defined by pBindInfo->heapRange are bound as the resource heap. The application can access resources and data through this heap anywhere except for the reserved range specified by pBindInfo->reservedRangeOffset. Addresses in the range [pBindInfo->reservedRangeOffset, pBindInfo->reservedRangeOffset + minResourceHeapReservedRange) are reserved for the implementation and must not be accessed by the application at any time from when this command is recorded until there are no command buffers with that range bound.

Shaders executed by commands recorded after this command can use the specified resource heap to access resources. pBindInfo->heapRange.address will be available to shaders to access resources through the ResourceHeapEXT BuiltIn or via shader bindings.

When cmdBindResourceHeapEXT is recorded, it immediately invalidates all non-heap descriptor state. Similarly, recording any non-heap descriptor state commands immediately invalidates state set by this command.

Valid Usage

• The sum of pBindInfo->reservedRangeOffset and pBindInfo->reservedRangeSize must be less than or equal to pBindInfo->heapRange.size

• pBindInfo->reservedRangeSize must be greater than or equal to minResourceHeapReservedRange
• pBindInfo->heapRange.size must less than or equal to maxResourceHeapSize
• pBindInfo->heapRange.address must be a multiple of resourceHeapAlignment
• pBindInfo->reservedRangeOffset must be a multiple of bufferDescriptorAlignment
• pBindInfo->reservedRangeOffset must be a multiple of imageDescriptorAlignment
• Memory bound to addresses in the range [pBindInfo->heapRange.address + pBindInfo->reservedRangeOffset, pBindInfo->heapRange.address + pBindInfo->reservedRangeOffset + pBindInfo->reservedRangeSize) must not be bound to any other command buffer as a reserved range for any heap unless the reserved range matches exactly and it is the same heap type
• heapRange must be a device address range allocated to the application from a buffer created with the BUFFER_USAGE_DESCRIPTOR_HEAP_BIT_EXT usage flag set
• If commandBuffer is a secondary command buffer, it must have begun with CommandBufferInheritanceDescriptorHeapInfoEXT::pResourceHeapBindInfo equal to NULL

Valid Usage (Implicit)

• commandBuffer must be a valid CommandBuffer handle

• pBindInfo must be a valid pointer to a valid BindHeapInfoEXT 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

vkCmdBindResourceHeapEXT is not affected by conditional rendering

See Also

VK_EXT_descriptor_heap, BindHeapInfoEXT, CommandBuffer

vkCmdPushDataEXT - Update the values of push data

Description

When cmdPushDataEXT is recorded, it immediately invalidates all non-heap descriptor state. Similarly, recording any non-heap descriptor state commands immediately invalidates state set by this command.

All push data is available to all shaders using the existing PushConstant Storage Class.

Device addresses in push data are intended as the fast path for shader-constant data that does not fit into push data directly. In order to maximize performance of constant data inputs, addresses should be aligned to minUniformBufferOffsetAlignment, and decorated with Alignment and NonWritable in the shader when using physical pointers.

Valid Usage (Implicit)

• commandBuffer must be a valid CommandBuffer handle

• pPushDataInfo must be a valid pointer to a valid PushDataInfoEXT 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

vkCmdPushDataEXT is not affected by conditional rendering

See Also

VK_EXT_descriptor_heap, CommandBuffer, PushDataInfoEXT

vkRegisterCustomBorderColorEXT - Register a custom border color

Description

If requestIndex is TRUE, the value present in pIndex when passed to the command is a requested index, and rather than returning a new index, the implementation will attempt to register that index, leaving the value intact. If the implementation is unable to register a requested index, ERROR_INVALID_OPAQUE_CAPTURE_ADDRESS will be returned. If an index has not been registered (either explicitly or implicitly by creating a sampler object), or if it has been subsequently unregistered, the implementation must register that index successfully.

If requestIndex is FALSE, the value stored in pIndex is ignored, and a new index will be returned if the implementation is able to register a new index. If the implementation is unable to register a new index, ERROR_TOO_MANY_OBJECTS will be returned.

If an index is successfully registered, it can be used when writing a sampler descriptor or creating a sampler object to use with the custom border color, via SamplerCustomBorderColorIndexCreateInfoEXT.

The type of border color is not specified by this command (BORDER_COLOR_FLOAT_CUSTOM_EXT vs. BORDER_COLOR_INT_CUSTOM_EXT); the data will be interpreted at the point the border color is sampled with an actual sampler. Implementations are expected to store the data as raw bytes if they do not need the format to be specified.

Valid Usage

• If requestIndex is TRUE, the value stored in pIndex must be less than maxCustomBorderColorSamplers

Valid Usage (Implicit)

• device must be a valid Device handle

• pBorderColor must be a valid pointer to a valid SamplerCustomBorderColorCreateInfoEXT structure
• pIndex must be a valid pointer to a uint32_t value

Return Codes

Success

• SUCCESS

Failure

• ERROR_INVALID_OPAQUE_CAPTURE_ADDRESS
• ERROR_OUT_OF_DEVICE_MEMORY
• ERROR_OUT_OF_HOST_MEMORY
• ERROR_TOO_MANY_OBJECTS
• ERROR_UNKNOWN
• ERROR_VALIDATION_FAILED

See Also

VK_EXT_custom_border_color, VK_EXT_descriptor_heap, Bool32, Device, SamplerCustomBorderColorCreateInfoEXT

vkUnregisterCustomBorderColorEXT - Unregister a custom border color

Valid Usage (Implicit)

See Also

VK_EXT_custom_border_color, VK_EXT_descriptor_heap, Device

vkGetImageOpaqueCaptureDataEXT - Get image opaque capture descriptor data for descriptor heap replay

Valid Usage

• The descriptorHeapCaptureReplay feature must be enabled

• The size member of each element of pDatas must be equal to imageCaptureReplayOpaqueDataSize
• If device was created with multiple physical devices, then the bufferDeviceAddressMultiDevice feature must be enabled
• Each element of pImages must have been created with IMAGE_CREATE_DESCRIPTOR_HEAP_CAPTURE_REPLAY_BIT_EXT set in ImageCreateInfo::flags

Valid Usage (Implicit)

• device must be a valid Device handle

• pImages must be a valid pointer to an array of imageCount valid Image handles
• pDatas must be a valid pointer to an array of imageCount HostAddressRangeEXT structures
• imageCount must be greater than 0
• Each element of pImages must have been created, allocated, or retrieved from device

Return Codes

Success

• SUCCESS

Failure

• ERROR_OUT_OF_DEVICE_MEMORY
• ERROR_OUT_OF_HOST_MEMORY
• ERROR_UNKNOWN
• ERROR_VALIDATION_FAILED

See Also

VK_EXT_descriptor_heap, Device, HostAddressRangeEXT, Image

vkGetPhysicalDeviceDescriptorSizeEXT - Report specific descriptor sizes for each descriptor type

Description

The return value of this function will be a DeviceSize indicating the size in bytes (N) of a heap descriptor with a type equal to descriptorType. When a descriptor of this type is written by writeResourceDescriptorsEXT or writeSamplerDescriptorsEXT, only the first N bytes are written; the rest will not be accessed and can be safely discarded when copying descriptors around. Additionally, those first N bytes are the only bytes that will be accessed when the descriptor is accessed in the shader. N will never be larger than the applicable limits in PhysicalDeviceDescriptorHeapTensorPropertiesARM or PhysicalDeviceDescriptorHeapPropertiesEXT.

Values returned by this function have other requirements, so for example may not be power-of-two values.

This command is not intended for general use, and is for tools that already take advantage of tighter packing with other similar features (e.g. VK_EXT_descriptor_buffer) to optimize accesses in some cases. Applications can safely ignore this function and are advised to do so, to avoid depending on non-portable packing.

Valid Usage (Implicit)

See Also

VK_EXT_descriptor_heap, DescriptorType, PhysicalDevice

vkGetTensorOpaqueCaptureDataARM - Get tensor opaque capture descriptor data for descriptor heap replay

Valid Usage

• The descriptorHeapCaptureReplay feature must be enabled

• The size member of each element of pDatas must be equal to tensorCaptureReplayOpaqueDataSize
• If device was created with multiple physical devices, then the bufferDeviceAddressMultiDevice feature must be enabled
• Each element of pTensors must have been created with TENSOR_CREATE_DESCRIPTOR_HEAP_CAPTURE_REPLAY_BIT_ARM set in TensorCreateInfoARM::flags

Valid Usage (Implicit)

• device must be a valid Device handle

• pTensors must be a valid pointer to an array of tensorCount valid TensorARM handles
• pDatas must be a valid pointer to an array of tensorCount HostAddressRangeEXT structures
• tensorCount must be greater than 0
• Each element of pTensors must have been created, allocated, or retrieved from device

Return Codes

Success

• SUCCESS

Failure

• ERROR_OUT_OF_DEVICE_MEMORY
• ERROR_OUT_OF_HOST_MEMORY
• ERROR_UNKNOWN
• ERROR_VALIDATION_FAILED

See Also

VK_ARM_tensors, VK_EXT_descriptor_heap, Device, HostAddressRangeEXT, TensorARM

VkHostAddressRangeEXT - Structure specifying a host address range

Valid Usage (Implicit)

See Also

VK_EXT_descriptor_heap, getImageOpaqueCaptureDataEXT, getTensorOpaqueCaptureDataARM, writeResourceDescriptorsEXT, writeSamplerDescriptorsEXT

VkHostAddressRangeConstEXT - Structure specifying a constant host address range

Valid Usage (Implicit)

See Also

VK_EXT_descriptor_heap, OpaqueCaptureDataCreateInfoEXT, PushDataInfoEXT

VkDeviceAddressRangeEXT - Structure specifying a device address range

Valid Usage

• If size is not 0, address must not be 0

• The sum of address and size must be less than or equal to the sum of an address retrieved from a Buffer and the value of BufferCreateInfo::size used to create that Buffer

Valid Usage (Implicit)

• If address is not 0, address must be a valid DeviceAddress value

See Also

VK_EXT_descriptor_heap, BindHeapInfoEXT, DeviceAddress, DeviceSize, ResourceDescriptorDataEXT, TexelBufferDescriptorInfoEXT

VkTexelBufferDescriptorInfoEXT - Structure describing an image descriptor created from a buffer

Valid Usage (Implicit)

See Also

VK_EXT_descriptor_heap, DeviceAddressRangeEXT, Format, ResourceDescriptorDataEXT, StructureType

VkImageDescriptorInfoEXT - Structure describing an image descriptor created from an image

Valid Usage

• pView->viewType must not be IMAGE_VIEW_TYPE_2D_ARRAY if pView->image was created with an imageType of IMAGE_TYPE_3D

• If pView->viewType is IMAGE_VIEW_TYPE_2D and pView->image was created with an imageType of IMAGE_TYPE_3D, pView->image must have been created with IMAGE_CREATE_2D_VIEW_COMPATIBLE_BIT_EXT set
• layout must be IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL, IMAGE_LAYOUT_SHADER_READ_ONLY_OPTIMAL, IMAGE_LAYOUT_DEPTH_READ_ONLY_STENCIL_ATTACHMENT_OPTIMAL, IMAGE_LAYOUT_DEPTH_ATTACHMENT_STENCIL_READ_ONLY_OPTIMAL, IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL, IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL, IMAGE_LAYOUT_READ_ONLY_OPTIMAL, IMAGE_LAYOUT_SHARED_PRESENT_KHR, IMAGE_LAYOUT_RENDERING_LOCAL_READ_KHR, IMAGE_LAYOUT_ATTACHMENT_FEEDBACK_LOOP_OPTIMAL_EXT, or IMAGE_LAYOUT_GENERAL
• If layout is IMAGE_LAYOUT_DEPTH_READ_ONLY_STENCIL_ATTACHMENT_OPTIMAL, IMAGE_LAYOUT_DEPTH_ATTACHMENT_STENCIL_READ_ONLY_OPTIMAL, IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL, IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL, or IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL, then pView->aspectMask must not include IMAGE_ASPECT_COLOR_BIT
• If pView->image is a depth/stencil image, pView->subresourceRange.aspectMask must include either IMAGE_ASPECT_DEPTH_BIT or IMAGE_ASPECT_STENCIL_BIT but not both

Valid Usage (Implicit)

• sType must be STRUCTURE_TYPE_IMAGE_DESCRIPTOR_INFO_EXT

• pNext must be NULL
• pView must be a valid pointer to a valid ImageViewCreateInfo structure
• layout must be a valid ImageLayout value

See Also

VK_EXT_descriptor_heap, ImageLayout, ImageViewCreateInfo, ResourceDescriptorDataEXT, StructureType

VkResourceDescriptorInfoEXT - Structure describing a resource descriptor

Description

If type is DESCRIPTOR_TYPE_UNIFORM_TEXEL_BUFFER or DESCRIPTOR_TYPE_STORAGE_TEXEL_BUFFER, data->pTexelBuffer is used to construct the descriptor.

If type is DESCRIPTOR_TYPE_ACCELERATION_STRUCTURE_KHR, DESCRIPTOR_TYPE_ACCELERATION_STRUCTURE_NV, VK_DESCRIPTOR_TYPE_PARTITIONED_ACCELERATION_STRUCTURE_NV, DESCRIPTOR_TYPE_UNIFORM_BUFFER, or DESCRIPTOR_TYPE_STORAGE_BUFFER, data->pAddressRange is used to construct the descriptor. For acceleration structures, the size of the range is not used by the descriptor, and can be set to 0. If a non-zero size is provided though, it must be a valid range.

Applications may wish to provide a valid range as a way to check their own assumptions about the range they are binding; but it has no bearing on anything except validation. Implementations cannot make any assumptions based on the size of the provided range.

If type is DESCRIPTOR_TYPE_SAMPLED_IMAGE, DESCRIPTOR_TYPE_BLOCK_MATCH_IMAGE_QCOM, DESCRIPTOR_TYPE_SAMPLE_WEIGHT_IMAGE_QCOM, DESCRIPTOR_TYPE_STORAGE_IMAGE, or DESCRIPTOR_TYPE_INPUT_ATTACHMENT, data->pImage is used to construct the descriptor. If type is DESCRIPTOR_TYPE_TENSOR_ARM, data->pTensorARM is used to construct the descriptor.

If the nullDescriptor feature is enabled, the corresponding element of data may be NULL to generate a null descriptor.

Applications can give resource descriptors a debug name in a similar way to naming an object, via the DebugUtilsObjectNameInfoEXT structure. However, as there is no actual object, this structure must be passed via the pNext chain of this structure, with a objectType of OBJECT_TYPE_UNKNOWN and a objectHandle of NULL_HANDLE. The name is attached to the unique set of descriptor bits written by the implementation, and writing the same bits again with new debug info may rename the original descriptor.

Implementations are not prevented from returning the same bits for different descriptors. This can result in multiple different resources mapping to the same name. A common case for this might be something like a uniform buffer and storage buffer with the same device address range.

If a descriptor becomes invalid due to the underlying resource becoming invalid, implementations may remove the name association.

Valid Usage

• type must be one of DESCRIPTOR_TYPE_UNIFORM_BUFFER, DESCRIPTOR_TYPE_STORAGE_BUFFER, DESCRIPTOR_TYPE_SAMPLED_IMAGE, DESCRIPTOR_TYPE_STORAGE_IMAGE, DESCRIPTOR_TYPE_UNIFORM_TEXEL_BUFFER, DESCRIPTOR_TYPE_STORAGE_TEXEL_BUFFER, DESCRIPTOR_TYPE_SAMPLE_WEIGHT_IMAGE_QCOM, DESCRIPTOR_TYPE_BLOCK_MATCH_IMAGE_QCOM, DESCRIPTOR_TYPE_ACCELERATION_STRUCTURE_KHR, DESCRIPTOR_TYPE_ACCELERATION_STRUCTURE_NV, VK_DESCRIPTOR_TYPE_PARTITIONED_ACCELERATION_STRUCTURE_NV, DESCRIPTOR_TYPE_TENSOR_ARM, or DESCRIPTOR_TYPE_INPUT_ATTACHMENT

• If the nullDescriptor feature is not enabled, and type is DESCRIPTOR_TYPE_SAMPLED_IMAGE or DESCRIPTOR_TYPE_STORAGE_IMAGE, data->pImage must not be NULL
• If type is DESCRIPTOR_TYPE_SAMPLE_WEIGHT_IMAGE_QCOM, DESCRIPTOR_TYPE_BLOCK_MATCH_IMAGE_QCOM, or DESCRIPTOR_TYPE_INPUT_ATTACHMENT, data->pImage must not be NULL
• If the nullDescriptor feature is not enabled, and type is DESCRIPTOR_TYPE_UNIFORM_TEXEL_BUFFER or DESCRIPTOR_TYPE_STORAGE_TEXEL_BUFFER, data->pTexelBuffer must not be NULL
• If the nullDescriptor feature is not enabled, and type is DESCRIPTOR_TYPE_ACCELERATION_STRUCTURE_KHR, DESCRIPTOR_TYPE_ACCELERATION_STRUCTURE_NV, VK_DESCRIPTOR_TYPE_PARTITIONED_ACCELERATION_STRUCTURE_NV, DESCRIPTOR_TYPE_TENSOR_ARM, DESCRIPTOR_TYPE_UNIFORM_BUFFER, or DESCRIPTOR_TYPE_STORAGE_BUFFER, data->pAddressRange must not be NULL
• If the nullDescriptor feature is not enabled, and type is DESCRIPTOR_TYPE_TENSOR_ARM, data->pTensorARM must not be NULL
• If type is DESCRIPTOR_TYPE_UNIFORM_TEXEL_BUFFER or DESCRIPTOR_TYPE_STORAGE_TEXEL_BUFFER, data->pTexelBuffer->addressRange.address must be a multiple of the effective alignment requirement of data->pTexelBuffer->format as determined by minTexelBufferOffsetAlignment
• If type is DESCRIPTOR_TYPE_UNIFORM_BUFFER, data->pAddressRange->address must be a multiple of minUniformBufferOffsetAlignment
• If type is DESCRIPTOR_TYPE_STORAGE_BUFFER, data->pAddressRange->address must be a multiple of minStorageBufferOffsetAlignment

• If type is one of

  • DESCRIPTOR_TYPE_ACCELERATION_STRUCTURE_KHR
  • DESCRIPTOR_TYPE_ACCELERATION_STRUCTURE_NV

  • VK_DESCRIPTOR_TYPE_PARTITIONED_ACCELERATION_STRUCTURE_NV

    data->pAddressRange->address must be a multiple of 256

• If there is a DebugUtilsObjectNameInfoEXT structure in the pNext chain, its objectType must be OBJECT_TYPE_UNKNOWN
• If type is DESCRIPTOR_TYPE_SAMPLE_WEIGHT_IMAGE_QCOM, DESCRIPTOR_TYPE_BLOCK_MATCH_IMAGE_QCOM, or DESCRIPTOR_TYPE_INPUT_ATTACHMENT, data.pImage->pView->image must not have been created with an imageType of IMAGE_TYPE_3D
• If type is DESCRIPTOR_TYPE_STORAGE_IMAGE, data.pImage->pView->viewType is IMAGE_VIEW_TYPE_2D, and the image2DViewOf3D feature is not enabled, data.pImage->pView->image must not have been created with an imageType of IMAGE_TYPE_3D
• If type is DESCRIPTOR_TYPE_SAMPLED_IMAGE, data.pImage->pView->viewType is IMAGE_VIEW_TYPE_2D, and the sampler2DViewOf3D feature is not enabled, data.pImage->pView->image must not have been created with an imageType of IMAGE_TYPE_3D
• If type is DESCRIPTOR_TYPE_STORAGE_BUFFER or DESCRIPTOR_TYPE_UNIFORM_BUFFER, data.pAddressRange->size must not be 0
• If type is DESCRIPTOR_TYPE_SAMPLED_IMAGE and data.pImage is not NULL, data.pImage->pView->image must have been created with the IMAGE_USAGE_SAMPLED_BIT usage flag set
• If type is DESCRIPTOR_TYPE_STORAGE_IMAGE and data.pImage is not NULL, data.pImage->pView->image must have been created with the IMAGE_USAGE_STORAGE_BIT usage flag set
• If type is DESCRIPTOR_TYPE_INPUT_ATTACHMENT and data.pImage is not NULL, data.pImage->pView->image must have been created with the IMAGE_USAGE_INPUT_ATTACHMENT_BIT usage flag set
• If type is DESCRIPTOR_TYPE_UNIFORM_BUFFER and data.pAddressRange is not NULL, data.pAddressRange must be a device address range allocated to the application from a buffer created with the BUFFER_USAGE_UNIFORM_BUFFER_BIT usage flag set
• If type is DESCRIPTOR_TYPE_STORAGE_BUFFER and data.pAddressRange is not NULL, data.pAddressRange must be a device address range allocated to the application from a buffer created with the BUFFER_USAGE_STORAGE_BUFFER_BIT usage flag set
• If type is DESCRIPTOR_TYPE_UNIFORM_TEXEL_BUFFER and data.pTexelBuffer is not NULL, data.pTexelBuffer->addressRange must be a device address range allocated to the application from a buffer created with the BUFFER_USAGE_UNIFORM_TEXEL_BUFFER_BIT usage flag set
• If type is DESCRIPTOR_TYPE_STORAGE_TEXEL_BUFFER and data.pTexelBuffer is not NULL, data.pTexelBuffer->addressRange must be a device address range allocated to the application from a buffer created with the BUFFER_USAGE_STORAGE_TEXEL_BUFFER_BIT usage flag set
• If type is VK_DESCRIPTOR_TYPE_PARTITIONED_ACCELERATION_STRUCTURE_NV or DESCRIPTOR_TYPE_ACCELERATION_STRUCTURE_KHR, and data.pAddressRange is not NULL, data.pAddressRange->address must be an acceleration structure address retrieved from a AccelerationStructureKHR object via getAccelerationStructureDeviceAddressKHR
• If type is VK_DESCRIPTOR_TYPE_PARTITIONED_ACCELERATION_STRUCTURE_NV or DESCRIPTOR_TYPE_ACCELERATION_STRUCTURE_KHR, data.pAddressRange is not NULL, and data.pAddressRange->size is not 0, data.pAddressRange must be a device address range allocated to the application from the buffer used to create the acceleration structure that data.pAddressRange->address was retrieved from, and within the buffer range bound to that acceleration structure
• If type is DESCRIPTOR_TYPE_ACCELERATION_STRUCTURE_NV and data.pAddressRange is not NULL, data.pAddressRange->address must be an acceleration structure handle retrieved from a AccelerationStructureNV object via getAccelerationStructureHandleNV
• If type is DESCRIPTOR_TYPE_ACCELERATION_STRUCTURE_NV and data.pAddressRange is not NULL, data.pAddressRange->size must be 0

Valid Usage (Implicit)

• sType must be STRUCTURE_TYPE_RESOURCE_DESCRIPTOR_INFO_EXT

• pNext must be NULL or a pointer to a valid instance of DebugUtilsObjectNameInfoEXT
• The sType value of each structure in the pNext chain must be unique
• type must be a valid DescriptorType value
• If type is DESCRIPTOR_TYPE_SAMPLED_IMAGE, DESCRIPTOR_TYPE_STORAGE_IMAGE, DESCRIPTOR_TYPE_INPUT_ATTACHMENT, DESCRIPTOR_TYPE_BLOCK_MATCH_IMAGE_QCOM, or DESCRIPTOR_TYPE_SAMPLE_WEIGHT_IMAGE_QCOM, and if pImage is not NULL, the pImage member of data must be a valid pointer to a valid ImageDescriptorInfoEXT structure
• If type is DESCRIPTOR_TYPE_UNIFORM_TEXEL_BUFFER or DESCRIPTOR_TYPE_STORAGE_TEXEL_BUFFER, and if pTexelBuffer is not NULL, the pTexelBuffer member of data must be a valid pointer to a valid TexelBufferDescriptorInfoEXT structure
• If type is DESCRIPTOR_TYPE_ACCELERATION_STRUCTURE_KHR, DESCRIPTOR_TYPE_UNIFORM_BUFFER, or DESCRIPTOR_TYPE_STORAGE_BUFFER, and if pAddressRange is not NULL, the pAddressRange member of data must be a valid pointer to a valid DeviceAddressRangeEXT structure
• If type is DESCRIPTOR_TYPE_TENSOR_ARM, and if pTensorARM is not NULL, the pTensorARM member of data must be a valid pointer to a valid TensorViewCreateInfoARM structure

See Also

VK_EXT_descriptor_heap, DescriptorType, ResourceDescriptorDataEXT, StructureType, writeResourceDescriptorsEXT

VkBindHeapInfoEXT - Structure describing a device address range and implementation reservation for a descriptor heap

Valid Usage (Implicit)

See Also

VK_EXT_descriptor_heap, CommandBufferInheritanceDescriptorHeapInfoEXT, DeviceAddressRangeEXT, DeviceSize, StructureType, cmdBindResourceHeapEXT, cmdBindSamplerHeapEXT

VkPushDataInfoEXT - Structure specifying a push data update operation

Valid Usage

• The sum of offset and data.size must be less than or equal to maxPushDataSize

• offset must be a multiple of 4
• data.size must be a multiple of 4

Valid Usage (Implicit)

• sType must be STRUCTURE_TYPE_PUSH_DATA_INFO_EXT

• pNext must be NULL or a pointer to a valid instance of PushConstantBankInfoNV
• The sType value of each structure in the pNext chain must be unique
• data must be a valid HostAddressRangeConstEXT structure

See Also

VK_EXT_descriptor_heap, HostAddressRangeConstEXT, StructureType, cmdPushDataEXT

VkDescriptorMappingSourceConstantOffsetEXT - Structure specifying mapping resources to a constant heap index

Description

Resources using this mapping will be backed by a descriptor in the heap, at an offset calculated as

• shaderIndex = (Binding - firstBinding) + arrayIndex
• offset = heapOffset + (shaderIndex * heapArrayStride)

where Binding is the binding value in the shader, arrayIndex is the index into the array if the shader binding is declared as an array.

If the mapped resource is a OpTypeSampledImage, offset is instead calculated for the sampler as

• offset = samplerHeapOffset + (shaderIndex * samplerHeapArrayStride)

If the mapped resource is a OpTypeSampler or OpTypeSampledImage, and pEmbeddedSampler is not NULL, the specified embedded sampler will be used rather than accessing the sampler heap.

Valid Usage

• If pEmbeddedSampler is a valid pointer to a SamplerCreateInfo, its borderColor must not be BORDER_COLOR_FLOAT_CUSTOM_EXT or BORDER_COLOR_INT_CUSTOM_EXT

• If pEmbeddedSampler is a valid pointer to a SamplerCreateInfo, and there is a DebugUtilsObjectNameInfoEXT structure in its pNext chain, its objectType must be OBJECT_TYPE_UNKNOWN

Valid Usage (Implicit)

• If pEmbeddedSampler is not NULL, pEmbeddedSampler must be a valid pointer to a valid SamplerCreateInfo structure

See Also

VK_EXT_descriptor_heap, DescriptorMappingSourceDataEXT, SamplerCreateInfo

VkDescriptorMappingSourcePushIndexEXT - Structure specifying mapping resources to a heap index in push data

Description

Resources using this mapping will be backed by a descriptor in the heap, at an offset calculated as

• pushIndex = ((uint32_t*)pPushData)[pushOffset/4]
• shaderIndex = (Binding - firstBinding) + arrayIndex
• offset = heapOffset + (pushIndex × heapIndexStride) + (shaderIndex × heapArrayStride)

where Binding is the binding value in the shader, arrayIndex is the index into the array if the shader binding is declared as an array, and pPushData is the total set of push data specified by cmdPushDataEXT.

If the mapped resource is a OpTypeSampledImage, offset is instead calculated for the sampler as

• samplerPushIndex = ((uint32_t*)pPushData)[samplerPushOffset/4]
• offset = samplerHeapOffset + (samplerPushIndex × samplerHeapIndexStride) + (shaderIndex × samplerHeapArrayStride)

If useCombinedImageSamplerIndex is TRUE, and the mapped resource is a OpTypeSampledImage, pushIndex and samplerPushIndex in the above equations are instead calculated as

• pushIndex = ((uint32_t*)pPushData)[pushOffset/4] & 0xFFFFF
• samplerPushIndex = (((uint32_t*)pPushData)[pushOffset/4] >> 20) & 0xFFF

If the mapped resource is a OpTypeSampler or OpTypeSampledImage, and pEmbeddedSampler is not NULL, the specified embedded sampler will be used rather than accessing the sampler heap.

Valid Usage

• pushOffset must be a multiple of 4

• pushOffset must be less than or equal to maxPushDataSize - 4
• If pEmbeddedSampler is a valid pointer to a SamplerCreateInfo, its borderColor must not be BORDER_COLOR_FLOAT_CUSTOM_EXT or BORDER_COLOR_INT_CUSTOM_EXT
• If pEmbeddedSampler is a valid pointer to a SamplerCreateInfo, and there is a DebugUtilsObjectNameInfoEXT structure in its pNext chain, its objectType must be OBJECT_TYPE_UNKNOWN

Valid Usage (Implicit)

• If pEmbeddedSampler is not NULL, pEmbeddedSampler must be a valid pointer to a valid SamplerCreateInfo structure

See Also

VK_EXT_descriptor_heap, Bool32, DescriptorMappingSourceDataEXT, SamplerCreateInfo

VkDescriptorMappingSourceIndirectIndexEXT - Structure specifying mapping resources to a heap index in indirect data

Description

Resources using this mapping will be backed by a descriptor in the heap, at an offset calculated as

• uint32_t *indirectAddress = ((VkDeviceAddress*)pPushData)[pushOffset/8]
• indirectIndex = indirectAddress[(addressOffset / 4)]
• shaderIndex = (Binding - firstBinding) + arrayIndex
• offset = heapOffset + (indirectIndex × heapIndexStride) + (shaderIndex × heapArrayStride)

where Binding is the binding value in the shader, arrayIndex is the index into the array if the shader binding is declared as an array, and pPushData is the total set of push data specified by cmdPushDataEXT. The value of the address in push data must be a multiple of 4. Index reads through indirectAddress are performed as non-volatile uniform buffer reads, and can be synchronized using ACCESS_2_UNIFORM_READ_BIT. The value in memory must remain static while any shader invocation using this mapping is in flight to avoid a data race.

If the mapped resource is a OpTypeSampledImage, offset is instead calculated for the sampler as

• uint32_t *samplerIndirectAddress = ((VkDeviceAddress*)pPushData)[samplerPushOffset/8]
• samplerIndirectIndex = samplerIndirectAddress[(samplerAddressOffset / 4)]
• offset = samplerHeapOffset + (samplerIndirectIndex × samplerHeapIndexStride) + (shaderIndex × samplerHeapArrayStride)

If useCombinedImageSamplerIndex is TRUE, and the mapped resource is a OpTypeSampledImage, indirectIndex and samplerIndirectIndex in the above equations are instead calculated as

• indirectIndex = indirectAddress[addressOffset/4] & 0xFFFFF
• samplerIndirectIndex = indirectAddress[addressOffset/4] >> 20) & 0xFFF

If the mapped resource is a OpTypeSampler or OpTypeSampledImage, and pEmbeddedSampler is not NULL, the specified embedded sampler will be used rather than accessing the sampler heap.

Valid Usage

• pushOffset must be a multiple of 8

• pushOffset must be less than or equal to maxPushDataSize - 8
• addressOffset must be a multiple of 4
• If pEmbeddedSampler is a valid pointer to a SamplerCreateInfo, its borderColor must not be BORDER_COLOR_FLOAT_CUSTOM_EXT or BORDER_COLOR_INT_CUSTOM_EXT
• If pEmbeddedSampler is a valid pointer to a SamplerCreateInfo, and there is a DebugUtilsObjectNameInfoEXT structure in its pNext chain, its objectType must be OBJECT_TYPE_UNKNOWN

Valid Usage (Implicit)

• If pEmbeddedSampler is not NULL, pEmbeddedSampler must be a valid pointer to a valid SamplerCreateInfo structure

See Also

VK_EXT_descriptor_heap, Bool32, DescriptorMappingSourceDataEXT, SamplerCreateInfo

VkDescriptorMappingSourceIndirectIndexArrayEXT - Structure specifying mapping resources to a heap index array in indirect data

Description

Resources using this mapping will be backed by a descriptor in the heap, at an offset calculated as

• uint32_t *indirectAddress = ((VkDeviceAddress*)pPushData)[pushOffset/8]
• shaderIndex = (Binding - firstBinding) + arrayIndex
• indirectIndex = indirectAddress[(addressOffset / 4) + shaderIndex]
• offset = heapOffset + (indirectIndex × heapIndexStride)

where Binding is the binding value in the shader, arrayIndex is the index into the array if the shader binding is declared as an array, and pPushData is the total set of push data specified by cmdPushDataEXT. The value of the address in push data must be a multiple of 4. Index reads through indirectAddress are performed as non-volatile uniform buffer reads, and can be synchronized using ACCESS_2_UNIFORM_READ_BIT. The value in memory must remain static while any shader invocation using this mapping is in flight to avoid a data race.

If the mapped resource is a OpTypeSampledImage, offset is instead calculated for the sampler as

• uint32_t *samplerIndirectAddress = ((VkDeviceAddress*)pPushData)[samplerPushOffset/8]
• samplerIndirectIndex = samplerAddr[(samplerAddressOffset / 4) + shaderIndex]
• offset = samplerHeapOffset + (samplerIndirectIndex × samplerHeapIndexStride)

If useCombinedImageSamplerIndex is TRUE, and the mapped resource is a OpTypeSampledImage, indirectIndex and samplerIndirectIndex in the above equations are instead calculated as

• indirectIndex = indirectAddress[addressOffset/4 + shaderIndex] & 0xFFFFF
• samplerIndirectIndex = indirectAddress[addressOffset/4 + shaderIndex] >> 20) & 0xFFF

If the mapped resource is a OpTypeSampler or OpTypeSampledImage, and pEmbeddedSampler is not NULL, the specified embedded sampler will be used rather than accessing the sampler heap.

Valid Usage

• pushOffset must be a multiple of 8

• pushOffset must be less than or equal to maxPushDataSize - 8
• addressOffset must be a multiple of 4
• If pEmbeddedSampler is a valid pointer to a SamplerCreateInfo, its borderColor must not be BORDER_COLOR_FLOAT_CUSTOM_EXT or BORDER_COLOR_INT_CUSTOM_EXT
• If pEmbeddedSampler is a valid pointer to a SamplerCreateInfo, and there is a DebugUtilsObjectNameInfoEXT structure in its pNext chain, its objectType must be OBJECT_TYPE_UNKNOWN

Valid Usage (Implicit)

• If pEmbeddedSampler is not NULL, pEmbeddedSampler must be a valid pointer to a valid SamplerCreateInfo structure

See Also

VK_EXT_descriptor_heap, Bool32, DescriptorMappingSourceDataEXT, SamplerCreateInfo

VkDescriptorMappingSourceHeapDataEXT - Structure specifying mapping a uniform buffer to heap data

Description

Uniform buffers using this mapping will be backed directly by data in the heap. Accessing data in the uniform buffer at an offset of shaderOffset in the shader will access heap data at an offset equal to

• offset = shaderOffset + heapOffset + ((uint32_t*)pPushData)[pushOffset/4]

where pPushData is the total set of push data specified by cmdPushDataEXT. Shader reads through the heap mapped in this way are performed according to the mapped resource.

Valid Usage

See Also

VK_EXT_descriptor_heap, DescriptorMappingSourceDataEXT

VkDescriptorMappingSourceShaderRecordIndexEXT - Structure specifying mapping resources to a heap index in shader record data

Description

Resources using this mapping will be backed by a descriptor in the heap, at an offset calculated as

• shaderRecordIndex = ((uint32_t*)pShaderRecordData)[shaderRecordOffset/4]
• shaderIndex = (Binding - firstBinding) + arrayIndex
• offset = heapOffset + (shaderRecordIndex × heapIndexStride) + (shaderIndex × heapArrayStride)

where Binding is the binding value in the shader, arrayIndex is the index into the array if the shader binding is declared as an array, and pShaderRecordData is the set of shader record data accessible to the shader.

If the mapped resource is a OpTypeSampledImage, offset is instead calculated for the sampler as

• samplerShaderRecordIndex = ((uint32_t*)pShaderRecordData)[samplerShaderRecordOffset/4]
• offset = samplerHeapOffset + (samplerShaderRecordIndex × samplerHeapIndexStride) + (shaderIndex × samplerHeapArrayStride)

If useCombinedImageSamplerIndex is TRUE, and the mapped resource is a OpTypeSampledImage, shaderRecordIndex and samplerShaderRecordIndex in the above equations are instead calculated as

• shaderRecordIndex = ((uint32_t*)pShaderRecordData)[shaderRecordOffset/4] & 0xFFFFF
• samplerShaderRecordIndex = (((uint32_t*)pShaderRecordData)[shaderRecordOffset/4] >> 20) & 0xFFF

If the mapped resource is a OpTypeSampler or OpTypeSampledImage, and pEmbeddedSampler is not NULL, the specified embedded sampler will be used rather than accessing the sampler heap.

Valid Usage

• shaderRecordOffset must be a multiple of 4

• shaderRecordOffset must be less than or equal to maxShaderGroupStride
• 4
• If pEmbeddedSampler is a valid pointer to a SamplerCreateInfo, its borderColor must not be BORDER_COLOR_FLOAT_CUSTOM_EXT or BORDER_COLOR_INT_CUSTOM_EXT
• If pEmbeddedSampler is a valid pointer to a SamplerCreateInfo, and there is a DebugUtilsObjectNameInfoEXT structure in its pNext chain, its objectType must be OBJECT_TYPE_UNKNOWN

Valid Usage (Implicit)

• If pEmbeddedSampler is not NULL, pEmbeddedSampler must be a valid pointer to a valid SamplerCreateInfo structure

See Also

VK_EXT_descriptor_heap, Bool32, DescriptorMappingSourceDataEXT, SamplerCreateInfo

VkDescriptorMappingSourceIndirectAddressEXT - Structure specifying mapping a uniform buffer to an address specified indirectly

Description

Accessing data via the mapped resource in the shader will access data backing the address specified in the indirect address at the supplied offset:

• indirectAddress = ((VkDeviceAddress*)pPushData)[pushOffset/8]
• resourceAddress = ((VkDeviceAddress*)indirectAddress)[addressOffset/8]

where pPushData is the total set of push data specified by cmdPushDataEXT. Reads through indirectAddress are performed as non-volatile uniform buffer reads, and can be synchronized using ACCESS_2_UNIFORM_READ_BIT. Shader reads through resourceAddress are performed according to the mapped resource. If the shader resource is an acceleration structure, the address must be a valid acceleration structure address.

Valid Usage

See Also

VK_EXT_descriptor_heap, DescriptorMappingSourceDataEXT