Function Prototype

vkGetSwapchainTimeDomainPropertiesEXT

Obtain the time domains supported by the PE for the swapchain

The implementation maintains an internal monotonically increasing counter which updates when the presentation engine’s list of supported time domains for a swapchain is modified.

To query the time domains supported by the presentation engine for a given swapchain, call:

VkResult vkGetSwapchainTimeDomainPropertiesEXT(
    VkDevice device,
    VkSwapchainKHR swapchain,
    VkSwapchainTimeDomainPropertiesEXT* pSwapchainTimeDomainProperties,
    uint64_t* pTimeDomainsCounter);
  • device is the device associated with swapchain.
  • swapchain is the swapchain to obtain time domain properties for.
  • pSwapchainTimeDomainProperties is a pointer to an instance of the VkSwapchainTimeDomainPropertiesEXT structure.
  • pTimeDomainsCounter is NULL or a pointer to a 64-bit unsigned integer set by the implementation to the current value of the swapchain’s internal time domain properties counter.

If upon return VkSwapchainTimeDomainPropertiesEXT::timeDomainCount is smaller than the number of time domains supported for the given swapchain, VK_INCOMPLETE will be returned instead of VK_SUCCESS to indicate that not all the available values were returned.

Valid Usage (Implicit)

VUID-vkGetSwapchainTimeDomainPropertiesEXT-pTimeDomainsCounter-parameter

If pTimeDomainsCounter is not NULL, pTimeDomainsCounter must be a valid pointer to a uint64_t value

VUID-vkGetSwapchainTimeDomainPropertiesEXT-swapchain-parent

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

Host Synchronization

  • Host access to swapchain must be externally synchronized