C Specification

The VkSwapchainCalibratedTimestampInfoEXT structure is defined as:

// Provided by VK_EXT_present_timing
typedef struct VkSwapchainCalibratedTimestampInfoEXT {
    VkStructureType           sType;
    const void*               pNext;
    VkSwapchainKHR            swapchain;
    VkPresentStageFlagsEXT    presentStage;
    uint64_t                  timeDomainId;
} VkSwapchainCalibratedTimestampInfoEXT;

Members

  • sType is a VkStructureType value identifying this structure.

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

  • swapchain is the swapchain to retrieve the swapchain-local timestamp from.

  • presentStage is zero or a VkPresentStageFlagsEXT value used to identify a single present stage when calibrating a timestamp in the VK_TIME_DOMAIN_PRESENT_STAGE_LOCAL_EXT time domain.

  • timeDomainId is the id for the opaque time domain being calibrated.

Description

timeDomainId must be an id previously reported by vkGetSwapchainTimeDomainPropertiesEXT for swapchain. If the timeDomainId is no longer supported by the swapchain, implementations may report zero as the calibrated timestamp value.

Valid Usage
Valid Usage (Implicit)

  • VUID-VkSwapchainCalibratedTimestampInfoEXT-sType-sType
    sType must be VK_STRUCTURE_TYPE_SWAPCHAIN_CALIBRATED_TIMESTAMP_INFO_EXT

  • VUID-VkSwapchainCalibratedTimestampInfoEXT-swapchain-parameter
    swapchain must be a valid VkSwapchainKHR handle

  • VUID-VkSwapchainCalibratedTimestampInfoEXT-presentStage-parameter
    presentStage must be a valid combination of VkPresentStageFlagBitsEXT values

  • VUID-VkSwapchainCalibratedTimestampInfoEXT-presentStage-requiredbitmask
    presentStage must not be 0

Host Synchronization

  • Host access to swapchain must be externally synchronized

See Also

VK_EXT_present_timing, VkPresentStageFlagsEXT, VkStructureType, VkSwapchainKHR

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