Class KHRBufferDeviceAddress
PhysicalStorageBuffer storage class in the GL_EXT_buffer_reference GLSL extension and SPV_KHR_physical_storage_buffer SPIR-V extension.
Another way to describe this extension is that it adds “pointers to buffer memory in shaders”. By calling GetBufferDeviceAddress with a VkBuffer, it will return a VkDeviceAddress value which represents the address of the start of the buffer.
GetBufferOpaqueCaptureAddress and GetDeviceMemoryOpaqueCaptureAddress allow opaque addresses for buffers and memory objects to be queried for the current process. A trace capture and replay tool can then supply these addresses to be used at replay time to match the addresses used when the trace was captured. To enable tools to insert these queries, new memory allocation flags must be specified for memory objects that will be bound to buffers accessed via the PhysicalStorageBuffer storage class. Note that this mechanism is intended only to support capture/replay tools, and is not recommended for use in other applications.
Promotion to Vulkan 1.2
All functionality in this extension is included in core Vulkan 1.2, with the KHR suffix omitted. However, if Vulkan 1.2 is supported and this extension is not, the bufferDeviceAddress feature is optional. The original type, enum, and command names are still available as aliases of the core functionality.
Promotion to Vulkan 1.3
Support for the bufferDeviceAddress feature is mandatory in Vulkan 1.3, regardless of whether this extension is supported.
- Name String
VK_KHR_buffer_device_address- Extension Type
- Device extension
- Registered Extension Number
- 258
- Revision
- 1
- Extension and Version Dependencies
VK_KHR_get_physical_device_properties2andVK_KHR_device_groupor Version 1.1- SPIR-V Dependencies
- Deprecation State
- Promoted to Vulkan 1.2
- Contact
- Jeff Bolz jeffbolznv
Other Extension Metadata
- Last Modified Date
- 2019-06-24
- IP Status
- No known IP claims.
- Interactions and External Dependencies
- This extension provides API support for
GL_EXT_buffer_referenceandGL_EXT_buffer_reference2andGL_EXT_buffer_reference_uvec2
- This extension provides API support for
- Contributors
- Jeff Bolz, NVIDIA
- Neil Henning, AMD
- Tobias Hector, AMD
- Faith Ekstrand, Intel
- Baldur Karlsson, Valve
- Jan-Harald Fredriksen, Arm
-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final intExtendsVkBufferCreateFlagBits.static final intExtendsVkBufferUsageFlagBits.static final intExtendsVkResult.static final StringThe extension name.static final intThe extension specification version.static final intExtendsVkMemoryAllocateFlagBits.static final intExtendsVkMemoryAllocateFlagBits.static final intExtendsVkStructureType.static final intExtendsVkStructureType.static final intExtendsVkStructureType.static final intExtendsVkStructureType.static final intExtendsVkStructureType. -
Method Summary
Modifier and TypeMethodDescriptionstatic longnvkGetBufferDeviceAddressKHR(org.lwjgl.vulkan.VkDevice device, long pInfo) Unsafe version of:GetBufferDeviceAddressKHRstatic longnvkGetBufferOpaqueCaptureAddressKHR(org.lwjgl.vulkan.VkDevice device, long pInfo) Unsafe version of:GetBufferOpaqueCaptureAddressKHRstatic longnvkGetDeviceMemoryOpaqueCaptureAddressKHR(org.lwjgl.vulkan.VkDevice device, long pInfo) Unsafe version of:GetDeviceMemoryOpaqueCaptureAddressKHRstatic longvkGetBufferDeviceAddressKHR(org.lwjgl.vulkan.VkDevice device, VkBufferDeviceAddressInfo pInfo) static longvkGetBufferOpaqueCaptureAddressKHR(org.lwjgl.vulkan.VkDevice device, VkBufferDeviceAddressInfo pInfo) static longvkGetDeviceMemoryOpaqueCaptureAddressKHR(org.lwjgl.vulkan.VkDevice device, VkDeviceMemoryOpaqueCaptureAddressInfo pInfo)
-
Field Details
-
VK_KHR_BUFFER_DEVICE_ADDRESS_SPEC_VERSION
public static final int VK_KHR_BUFFER_DEVICE_ADDRESS_SPEC_VERSIONThe extension specification version.- See Also:
-
VK_KHR_BUFFER_DEVICE_ADDRESS_EXTENSION_NAME
The extension name.- See Also:
-
VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_BUFFER_DEVICE_ADDRESS_FEATURES_KHR
public static final int VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_BUFFER_DEVICE_ADDRESS_FEATURES_KHRExtendsVkStructureType.Enum values:
- See Also:
-
VK_STRUCTURE_TYPE_BUFFER_DEVICE_ADDRESS_INFO_KHR
public static final int VK_STRUCTURE_TYPE_BUFFER_DEVICE_ADDRESS_INFO_KHRExtendsVkStructureType.Enum values:
- See Also:
-
VK_STRUCTURE_TYPE_BUFFER_OPAQUE_CAPTURE_ADDRESS_CREATE_INFO_KHR
public static final int VK_STRUCTURE_TYPE_BUFFER_OPAQUE_CAPTURE_ADDRESS_CREATE_INFO_KHRExtendsVkStructureType.Enum values:
- See Also:
-
VK_STRUCTURE_TYPE_MEMORY_OPAQUE_CAPTURE_ADDRESS_ALLOCATE_INFO_KHR
public static final int VK_STRUCTURE_TYPE_MEMORY_OPAQUE_CAPTURE_ADDRESS_ALLOCATE_INFO_KHRExtendsVkStructureType.Enum values:
- See Also:
-
VK_STRUCTURE_TYPE_DEVICE_MEMORY_OPAQUE_CAPTURE_ADDRESS_INFO_KHR
public static final int VK_STRUCTURE_TYPE_DEVICE_MEMORY_OPAQUE_CAPTURE_ADDRESS_INFO_KHRExtendsVkStructureType.Enum values:
- See Also:
-
VK_BUFFER_USAGE_SHADER_DEVICE_ADDRESS_BIT_KHR
public static final int VK_BUFFER_USAGE_SHADER_DEVICE_ADDRESS_BIT_KHRExtendsVkBufferUsageFlagBits.- See Also:
-
VK_BUFFER_CREATE_DEVICE_ADDRESS_CAPTURE_REPLAY_BIT_KHR
public static final int VK_BUFFER_CREATE_DEVICE_ADDRESS_CAPTURE_REPLAY_BIT_KHRExtendsVkBufferCreateFlagBits.- See Also:
-
VK_MEMORY_ALLOCATE_DEVICE_ADDRESS_BIT_KHR
public static final int VK_MEMORY_ALLOCATE_DEVICE_ADDRESS_BIT_KHRExtendsVkMemoryAllocateFlagBits.Enum values:
- See Also:
-
VK_MEMORY_ALLOCATE_DEVICE_ADDRESS_CAPTURE_REPLAY_BIT_KHR
public static final int VK_MEMORY_ALLOCATE_DEVICE_ADDRESS_CAPTURE_REPLAY_BIT_KHRExtendsVkMemoryAllocateFlagBits.Enum values:
- See Also:
-
VK_ERROR_INVALID_OPAQUE_CAPTURE_ADDRESS_KHR
public static final int VK_ERROR_INVALID_OPAQUE_CAPTURE_ADDRESS_KHRExtendsVkResult.- See Also:
-
-
Method Details
-
nvkGetBufferDeviceAddressKHR
public static long nvkGetBufferDeviceAddressKHR(org.lwjgl.vulkan.VkDevice device, long pInfo) Unsafe version of:GetBufferDeviceAddressKHR -
vkGetBufferDeviceAddressKHR
public static long vkGetBufferDeviceAddressKHR(org.lwjgl.vulkan.VkDevice device, VkBufferDeviceAddressInfo pInfo) - Parameters:
device- the logical device that the buffer was created on.pInfo- a pointer to aVkBufferDeviceAddressInfostructure specifying the buffer to retrieve an address for.
-
nvkGetBufferOpaqueCaptureAddressKHR
public static long nvkGetBufferOpaqueCaptureAddressKHR(org.lwjgl.vulkan.VkDevice device, long pInfo) Unsafe version of:GetBufferOpaqueCaptureAddressKHR -
vkGetBufferOpaqueCaptureAddressKHR
public static long vkGetBufferOpaqueCaptureAddressKHR(org.lwjgl.vulkan.VkDevice device, VkBufferDeviceAddressInfo pInfo) - Parameters:
device- the logical device that the buffer was created on.pInfo- a pointer to aVkBufferDeviceAddressInfostructure specifying the buffer to retrieve an address for.
-
nvkGetDeviceMemoryOpaqueCaptureAddressKHR
public static long nvkGetDeviceMemoryOpaqueCaptureAddressKHR(org.lwjgl.vulkan.VkDevice device, long pInfo) Unsafe version of:GetDeviceMemoryOpaqueCaptureAddressKHR -
vkGetDeviceMemoryOpaqueCaptureAddressKHR
public static long vkGetDeviceMemoryOpaqueCaptureAddressKHR(org.lwjgl.vulkan.VkDevice device, VkDeviceMemoryOpaqueCaptureAddressInfo pInfo) - Parameters:
device- the logical device that the memory object was allocated on.pInfo- a pointer to aVkDeviceMemoryOpaqueCaptureAddressInfostructure specifying the memory object to retrieve an address for.
-