Vulkan.Extensions.VK_KHR_present_id

VkPhysicalDevicePresentIdFeaturesKHR - Structure indicating support for present id

Members

This structure describes the following feature:

Description

If the PhysicalDevicePresentIdFeaturesKHR structure is included in the pNext chain of the PhysicalDeviceFeatures2 structure passed to getPhysicalDeviceFeatures2, it is filled in to indicate whether each corresponding feature is supported. If the application wishes to use a Device with any features described by PhysicalDevicePresentIdFeaturesKHR, it must add an instance of the structure, with the desired feature members set to TRUE, to the pNext chain of DeviceCreateInfo when creating the Device.

Structure Chaining

Extends the structures

• DeviceCreateInfo

• PhysicalDeviceFeatures2

See Also

VK_KHR_present_id, Bool32, StructureType

VkPresentIdKHR - The list of presentation identifiers

Description

For applications to be able to reference specific presentation events queued by a call to queuePresentKHR, an identifier needs to be associated with them. When the presentId feature is enabled, applications can include the PresentIdKHR structure in the pNext chain of the PresentInfoKHR structure to supply identifiers.

Each SwapchainKHR has a presentId associated with it. This value is initially zero when the SwapchainKHR is created.

When a PresentIdKHR structure with a non-NULL pPresentIds is included in the pNext chain of a PresentInfoKHR structure, each pSwapchains entry has a presentId associated in the pPresentIds array at the same index as the swapchain in the pSwapchains array. If this presentId is non-zero, then the application can later use this value to refer to that image presentation. A value of zero indicates that this presentation has no associated presentId. A non-zero presentId must be greater than any non-zero presentId passed previously by the application for the same swapchain.

There is no requirement for any precise timing relationship between the presentation of the image to the user and the update of the presentId value, but implementations should make this as close as possible to the presentation of the first pixel in the new image to the user.

Valid Usage

• swapchainCount must be the same value as PresentInfoKHR::swapchainCount, where this PresentIdKHR is in the pNext chain of the PresentInfoKHR structure

• Each non-zero entry in presentIds must be greater than all previously submitted present ids for the associated swapchain in PresentInfoKHR::pSwapchains

Valid Usage (Implicit)

• sType must be STRUCTURE_TYPE_PRESENT_ID_KHR

• If pPresentIds is not NULL, pPresentIds must be a valid pointer to an array of swapchainCount uint64_t values

• swapchainCount must be greater than 0

Structure Chaining

Extends the structure

• PresentInfoKHR

See Also

VK_KHR_present_id, StructureType