Function Prototype

vkGetImageOpaqueCaptureDataEXT

Get image opaque capture descriptor data for descriptor heap replay

To get the opaque capture descriptor data for images, call:

VkResult vkGetImageOpaqueCaptureDataEXT(
    VkDevice                                            device,
    uint32_t                                            imageCount,
    const VkImage*                     pImages,
    VkHostAddressRangeEXT*             pDatas);
  • device is the logical device that gets the data.
  • imageCount is the number of images to retrieve data from.
  • pImages is a pointer to an array of VkImage objects to retrieve the opaque capture data from.
  • pDatas is a pointer to an array of VkHostAddressRangeEXT structures defining the host address ranges where each image’s opaque capture data will be written.

Valid Usage

VUID-vkGetImageOpaqueCaptureDataEXT-size-11283

The size member of each element of pDatas must be equal to imageCaptureReplayOpaqueDataSize

VUID-vkGetImageOpaqueCaptureDataEXT-device-11284

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

VUID-vkGetImageOpaqueCaptureDataEXT-pImages-11285

Each element of pImages must have been created with VK_IMAGE_CREATE_DESCRIPTOR_HEAP_CAPTURE_REPLAY_BIT_EXT set in VkImageCreateInfo::flags

Valid Usage (Implicit)

VUID-vkGetImageOpaqueCaptureDataEXT-pImages-parameter

pImages must be a valid pointer to an array of imageCount valid VkImage handles

VUID-vkGetImageOpaqueCaptureDataEXT-pDatas-parameter

pDatas must be a valid pointer to an array of imageCount VkHostAddressRangeEXT structures

VUID-vkGetImageOpaqueCaptureDataEXT-pImages-parent

Each element of pImages must have been created, allocated, or retrieved from device