C Specification

To create a GPA session object, call:

// Provided by VK_AMD_gpa_interface
VkResult vkCreateGpaSessionAMD(
    VkDevice                                    device,
    const VkGpaSessionCreateInfoAMD*            pCreateInfo,
    const VkAllocationCallbacks*                pAllocator,
    VkGpaSessionAMD*                            pGpaSession);

Parameters

  • device is the logical device that creates the GPA session object.

  • pCreateInfo is a pointer to a VkGpaSessionCreateInfoAMD structure containing information about how the GPA session object is to be created.

  • pAllocator controls host memory allocation as described in the Memory Allocation chapter.

  • pGpaSession is a pointer to a handle in which the resulting GPA session object is returned.

Description

Valid Usage (Implicit)

  • VUID-vkCreateGpaSessionAMD-device-parameter
    device must be a valid VkDevice handle

  • VUID-vkCreateGpaSessionAMD-pCreateInfo-parameter
    pCreateInfo must be a valid pointer to a valid VkGpaSessionCreateInfoAMD structure

  • VUID-vkCreateGpaSessionAMD-pAllocator-parameter
    If pAllocator is not NULL, pAllocator must be a valid pointer to a valid VkAllocationCallbacks structure

  • VUID-vkCreateGpaSessionAMD-pGpaSession-parameter
    pGpaSession must be a valid pointer to a VkGpaSessionAMD handle

  • VUID-vkCreateGpaSessionAMD-device-queuecount
    The device must have been created with at least 1 queue

Return Codes
On success, this command returns
On failure, this command returns

See Also

VK_AMD_gpa_interface, VkAllocationCallbacks, VkDevice, VkGpaSessionAMD, VkGpaSessionCreateInfoAMD

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