vkGetAccelerationStructureDeviceAddressKHR(3)

# vkGetAccelerationStructureDeviceAddressKHR(3) Manual Page

## Name

vkGetAccelerationStructureDeviceAddressKHR - Query an address of a acceleration structure

## C Specification

To query the 64-bit device address for an acceleration structure, call:

    VkDeviceAddress vkGetAccelerationStructureDeviceAddressKHR(
        VkDevice                                    device,
        const VkAccelerationStructureDeviceAddressInfoKHR* pInfo);

## Parameters

- `device` is the logical device that the accelerationStructure was created on.

- `pInfo` is a pointer to a VkAccelerationStructureDeviceAddressInfoKHR structure specifying the acceleration structure to retrieve an address for.

## Description

The 64-bit return value is an address of the acceleration structure, which can be used for device and shader operations that involve acceleration structures, such as ray traversal and acceleration structure building.

If the acceleration structure was created with a non-zero value of VkAccelerationStructureCreateInfoKHR::`deviceAddress` the return value will be the same address.

Valid Usage

- If `device` was created with multiple physical devices, then the bufferDeviceAddressMultiDevice feature must be enabled

Valid Usage (Implicit)

- `device` must be a valid VkDevice handle

- `pInfo` must be a valid pointer to a valid VkAccelerationStructureDeviceAddressInfoKHR structure

## See Also

VkAccelerationStructureDeviceAddressInfoKHR, VkDevice

## Document Notes

For more information, see the Vulkan Specification

This page is extracted from the Vulkan Specification. Fixes and changes should be made to the Specification, not directly.

## Copyright

Copyright (c) 2014-2020 Khronos Group. This work is licensed under a Creative Commons Attribution 4.0 International License.