Function Prototype

vkGetGpaSessionResultsAMD

Getting the status of a GPA session

Once a GPA session’s results are available, they can be obtained by:

VkResult vkGetGpaSessionResultsAMD(
    VkDevice                                 device,
    VkGpaSessionAMD                          gpaSession,
    uint32_t                                 sampleID,
    size_t*                                  pSizeInBytes,
    void* pData);
  • device is the logical device that sets the clocks.
  • gpaSession is the session whose results are queried.
  • sampleID is the sample ID, returned by vkCmdBeginGpaSampleAMD, whose results are to be queried.
  • pSizeInBytes is a pointer to a size_t value related to the size of the results data, as described below.
  • pData is either NULL or a pointer to an array of pSizeInBytes bytes where the results will be written.

Valid Usage (Implicit)

VUID-vkGetGpaSessionResultsAMD-pSizeInBytes-parameter

pSizeInBytes must be a valid pointer to a size_t value

VUID-vkGetGpaSessionResultsAMD-pData-parameter

If pData is not NULL, pData must be a valid pointer to an array of pSizeInBytes bytes

VUID-vkGetGpaSessionResultsAMD-pSizeInBytes-arraylength

If pData is not NULL, the value referenced by pSizeInBytes must be greater than 0

VUID-vkGetGpaSessionResultsAMD-gpaSession-parent

gpaSession must have been created, allocated, or retrieved from device