Structures

VkOpaqueCaptureDataCreateInfoEXT

Structure specifying opaque capture data

The VkOpaqueCaptureDataCreateInfoEXT structure is defined as:

typedef struct VkOpaqueCaptureDataCreateInfoEXT {
    VkStructureType sType;
    const void* pNext;
    const VkHostAddressRangeConstEXT* pData;
} VkOpaqueCaptureDataCreateInfoEXT;
  • 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.

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