vkGetDeviceMemoryOpaqueCaptureAddressKHR(3)

# vkGetDeviceMemoryOpaqueCaptureAddressKHR(3) Manual Page

## Name

vkGetDeviceMemoryOpaqueCaptureAddressKHR - Query an opaque capture address of a memory object

## C Specification

To query a 64-bit opaque capture address value from a memory object, call:

    uint64_t vkGetDeviceMemoryOpaqueCaptureAddressKHR(
        VkDevice                                    device,
        const VkDeviceMemoryOpaqueCaptureAddressInfoKHR* pInfo);

## Parameters

- `device` is the logical device that the memory object was allocated on.

- `pInfo` is a pointer to an instance of the VkDeviceMemoryOpaqueCaptureAddressInfoKHR structure specifying the memory object to retrieve an address for.

## Description

The 64-bit return value is an opaque address representing the start of `pInfo`::`memory`.

If the memory object was allocated with a non-zero value of VkMemoryOpaqueCaptureAddressAllocateInfoKHR::`opaqueCaptureAddress`, the return value must be the same address.

| Note The expected usage for these opaque addresses is only for trace capture/replay tools to store these addresses in a trace and subsequently specify them during replay.

Valid Usage

- The bufferDeviceAddress feature must be enabled

- 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 `VkDeviceMemoryOpaqueCaptureAddressInfoKHR` structure

## See Also

VkDevice, VkDeviceMemoryOpaqueCaptureAddressInfoKHR

## 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-2019 Khronos Group. This work is licensed under a Creative Commons Attribution 4.0 International License.