VkGpaSessionCreateInfoAMD(3)

# VkGpaSessionCreateInfoAMD(3) Manual Page

## Name

VkGpaSessionCreateInfoAMD - Structure specifying parameters of a newly created GPA session

## C Specification

The `VkGpaSessionCreateInfoAMD` structure is defined as:

    // Provided by VK_AMD_gpa_interface
    typedef struct VkGpaSessionCreateInfoAMD {
        VkStructureType    sType;
        const void*        pNext;
        VkGpaSessionAMD    secondaryCopySource;
    } VkGpaSessionCreateInfoAMD;

## Members

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

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

- `secondaryCopySource` is a `VkGpaSessionAMD` handle whose results can be copied into this session.

## Description

When sampling counters inside secondary command buffers, repeated invocations of the same secondary command buffer causes the previous results to be overwritten. To avoid this a GPA session object’s memory layout can be cloned for use with multiple secondary invocations by specifying its handle in `secondaryCopySource`, allowing the new GPA session object to be the target of a copy using vkCmdCopyGpaSessionResultsAMD.

Valid Usage

- VUID-VkGpaSessionCreateInfoAMD-secondaryCopySource-12461
  `secondaryCopySource` must have been used previously to begin and end a session, and it must not have been reset since then

Valid Usage (Implicit)

- VUID-VkGpaSessionCreateInfoAMD-sType-sType
  `sType` must be VK_STRUCTURE_TYPE_GPA_SESSION_CREATE_INFO_AMD

- VUID-VkGpaSessionCreateInfoAMD-pNext-pNext
  `pNext` must be `NULL`

- VUID-VkGpaSessionCreateInfoAMD-secondaryCopySource-parameter
  If `secondaryCopySource` is not VK_NULL_HANDLE, `secondaryCopySource` must be a valid VkGpaSessionAMD handle

## See Also

VK_AMD_gpa_interface, VkGpaSessionAMD, VkStructureType, vkCreateGpaSessionAMD

## 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