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)

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