VkOpaqueCaptureDataCreateInfoEXT(3)

# VkOpaqueCaptureDataCreateInfoEXT(3) Manual Page

## Name

VkOpaqueCaptureDataCreateInfoEXT - Structure specifying opaque capture data

## C Specification

The `VkOpaqueCaptureDataCreateInfoEXT` structure is defined as:

    // Provided by VK_EXT_descriptor_heap
    typedef struct VkOpaqueCaptureDataCreateInfoEXT {
        VkStructureType                      sType;
        const void*                          pNext;
        const VkHostAddressRangeConstEXT*    pData;
    } VkOpaqueCaptureDataCreateInfoEXT;

## Members

- `sType` is a VkStructureType value identifying this structure.

- `pNext` is `NULL` or a pointer to a structure extending this structure.

- `pData` is a pointer to the range of host memory containing opaque data previously captured via vkGetImageOpaqueCaptureDataEXT.

## Description

When an image is created with VK_IMAGE_CREATE_DESCRIPTOR_HEAP_CAPTURE_REPLAY_BIT_EXT set in VkImageCreateInfo::`flags`, if the `pNext` chain of VkImageCreateInfo includes this structure, and `pData` is not `NULL`, the implementation will attempt to recreate the image such that descriptors written with vkWriteResourceDescriptorsEXT will be reproduced with the same bit pattern as during capture if possible. If the implementation is unable to recreate the image based on this data, image creation will fail and return VK_ERROR_INVALID_OPAQUE_CAPTURE_ADDRESS.

When a tensor is created with VK_TENSOR_CREATE_DESCRIPTOR_HEAP_CAPTURE_REPLAY_BIT_ARM set in VkTensorCreateInfoARM::`flags`, if the `pNext` chain of VkTensorCreateInfoARM includes this structure, and `pData` is not `NULL`, the implementation will attempt to recreate the tensor such that descriptors written with vkWriteResourceDescriptorsEXT will be reproduced with the same bit pattern as during capture if possible. If the implementation is unable to recreate the tensor based on this data, tensor creation will fail and return VK_ERROR_INVALID_OPAQUE_CAPTURE_ADDRESS.

If this structure is not present, it is equivalent to setting `pData` to `NULL`.

Valid Usage (Implicit)

- VUID-VkOpaqueCaptureDataCreateInfoEXT-sType-sType
  `sType` must be VK_STRUCTURE_TYPE_OPAQUE_CAPTURE_DATA_CREATE_INFO_EXT

- VUID-VkOpaqueCaptureDataCreateInfoEXT-pData-parameter
  If `pData` is not `NULL`, `pData` must be a valid pointer to a valid VkHostAddressRangeConstEXT structure

Structure Chaining

Extends the structures

  - VkImageCreateInfo

  - VkTensorCreateInfoARM

## See Also

VK_EXT_descriptor_heap, VkHostAddressRangeConstEXT, VkStructureType

## 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 2014-2026 The Khronos Group Inc.

SPDX-License-Identifier: CC-BY-4.0