C Specification

When the presentAtAbsoluteTime or presentAtRelativeTime feature is enabled, an application can instruct the presentation engine to attempt to display an image at a specified time, or for a minimum duration, by including the VkPresentTimingsInfoEXT structure in the pNext chain of the VkPresentInfoKHR structure.

The VkPresentTimingsInfoEXT structure is defined as:

// Provided by VK_EXT_present_timing
typedef struct VkPresentTimingsInfoEXT {
    VkStructureType                  sType;
    const void*                      pNext;
    uint32_t                         swapchainCount;
    const VkPresentTimingInfoEXT*    pTimingInfos;
} VkPresentTimingsInfoEXT;

Members

  • sType is a VkStructureType value identifying this structure.

  • pNext is NULL or a pointer to a structure extending this structure.

  • swapchainCount is the number of swapchains being presented to by this command.

  • pTimingInfos is NULL or a pointer to an array of VkPresentTimingInfoEXT elements with swapchainCount entries. If not NULL, each element of pTimingInfos contains timing information for the presentation of the image corresponding to the entry in the VkPresentInfoKHR::pImageIndices array.

Description

Valid Usage
Valid Usage (Implicit)

  • VUID-VkPresentTimingsInfoEXT-sType-sType
    sType must be VK_STRUCTURE_TYPE_PRESENT_TIMINGS_INFO_EXT

  • VUID-VkPresentTimingsInfoEXT-pTimingInfos-parameter
    If pTimingInfos is not NULL, pTimingInfos must be a valid pointer to an array of swapchainCount valid VkPresentTimingInfoEXT structures

  • VUID-VkPresentTimingsInfoEXT-swapchainCount-arraylength
    swapchainCount must be greater than 0

See Also

VK_EXT_present_timing, VkPresentTimingInfoEXT, VkStructureType

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