vkDisplayPowerControlEXT - Set the power state of a display

Valid Usage (Implicit)

• device must be a valid Device handle

• display must be a valid DisplayKHR handle
• pDisplayPowerInfo must be a valid pointer to a valid DisplayPowerInfoEXT structure
• Both of device, and display must have been created, allocated, or retrieved from the same PhysicalDevice

Return Codes

Success

• SUCCESS

Failure

• ERROR_OUT_OF_HOST_MEMORY

See Also

VK_EXT_display_control, Device, DisplayKHR, DisplayPowerInfoEXT

vkRegisterDeviceEventEXT - Signal a fence when a device event occurs

Valid Usage (Implicit)

• device must be a valid Device handle

• pDeviceEventInfo must be a valid pointer to a valid DeviceEventInfoEXT structure
• If pAllocator is not NULL, pAllocator must be a valid pointer to a valid AllocationCallbacks structure
• pFence must be a valid pointer to a Fence handle

Return Codes

Success

• SUCCESS

Failure

• ERROR_OUT_OF_HOST_MEMORY

See Also

VK_EXT_display_control, AllocationCallbacks, Device, DeviceEventInfoEXT, Fence

vkRegisterDisplayEventEXT - Signal a fence when a display event occurs

Valid Usage (Implicit)

• device must be a valid Device handle

• display must be a valid DisplayKHR handle
• pDisplayEventInfo must be a valid pointer to a valid DisplayEventInfoEXT structure
• If pAllocator is not NULL, pAllocator must be a valid pointer to a valid AllocationCallbacks structure
• pFence must be a valid pointer to a Fence handle
• Both of device, and display must have been created, allocated, or retrieved from the same PhysicalDevice

Return Codes

Success

• SUCCESS

Failure

• ERROR_OUT_OF_HOST_MEMORY

See Also

VK_EXT_display_control, AllocationCallbacks, Device, DisplayEventInfoEXT, DisplayKHR, Fence

vkGetSwapchainCounterEXT - Query the current value of a surface counter

Description

If a counter is not available because the swapchain is out of date, the implementation may return ERROR_OUT_OF_DATE_KHR.

Valid Usage

• One or more present commands on swapchain must have been processed by the presentation engine

Valid Usage (Implicit)

• device must be a valid Device handle

• swapchain must be a valid SwapchainKHR handle
• counter must be a valid SurfaceCounterFlagBitsEXT value
• pCounterValue must be a valid pointer to a uint64_t value
• swapchain must have been created, allocated, or retrieved from device

Return Codes

Success

• SUCCESS

Failure

• ERROR_OUT_OF_HOST_MEMORY
• ERROR_DEVICE_LOST
• ERROR_OUT_OF_DATE_KHR

See Also

VK_EXT_display_control, Device, SurfaceCounterFlagBitsEXT, SwapchainKHR

VkDisplayPowerInfoEXT - Describe the power state of a display

Valid Usage (Implicit)

See Also

VK_EXT_display_control, DisplayPowerStateEXT, StructureType, displayPowerControlEXT

VkDeviceEventInfoEXT - Describe a device event to create

Valid Usage (Implicit)

See Also

VK_EXT_display_control, DeviceEventTypeEXT, StructureType, registerDeviceEventEXT

VkDisplayEventInfoEXT - Describe a display event to create

Valid Usage (Implicit)

See Also

VK_EXT_display_control, DisplayEventTypeEXT, StructureType, registerDisplayEventEXT

VkSwapchainCounterCreateInfoEXT - Specify the surface counters desired

Valid Usage

• The bits in surfaceCounters must be supported by SwapchainCreateInfoKHR::surface, as reported by getPhysicalDeviceSurfaceCapabilities2EXT

Valid Usage (Implicit)

• sType must be STRUCTURE_TYPE_SWAPCHAIN_COUNTER_CREATE_INFO_EXT

• surfaceCounters must be a valid combination of SurfaceCounterFlagBitsEXT values

See Also

VK_EXT_display_control, StructureType, SurfaceCounterFlagsEXT

VkDisplayPowerStateEXT - Possible power states for a display

See Also

VK_EXT_display_control, DisplayPowerInfoEXT

VkDeviceEventTypeEXT - Events that can occur on a device object

See Also

VK_EXT_display_control, DeviceEventInfoEXT

VkDisplayEventTypeEXT - Events that can occur on a display object

See Also

VK_EXT_display_control, DisplayEventInfoEXT

VkDisplayKHR - Opaque handle to a display object

See Also

VK_KHR_display, DisplayPlanePropertiesKHR, DisplayPropertiesKHR, acquireDrmDisplayEXT, acquireWinrtDisplayNV, acquireXlibDisplayEXT, createDisplayModeKHR, displayPowerControlEXT, getDisplayModeProperties2KHR, getDisplayModePropertiesKHR, getDisplayPlaneSupportedDisplaysKHR, getDrmDisplayEXT, getRandROutputDisplayEXT, getWinrtDisplayNV, registerDisplayEventEXT, releaseDisplayEXT

VkSwapchainKHR - Opaque handle to a swapchain object

Description

A swapchain is an abstraction for an array of presentable images that are associated with a surface. The presentable images are represented by Image objects created by the platform. One image (which can be an array image for multiview/stereoscopic-3D surfaces) is displayed at a time, but multiple images can be queued for presentation. An application renders to the image, and then queues the image for presentation to the surface.

A native window cannot be associated with more than one non-retired swapchain at a time. Further, swapchains cannot be created for native windows that have a non-Vulkan graphics API surface associated with them.

Note

The presentation engine is an abstraction for the platform’s compositor or display engine.

The presentation engine may be synchronous or asynchronous with respect to the application and/or logical device.

Some implementations may use the device’s graphics queue or dedicated presentation hardware to perform presentation.

The presentable images of a swapchain are owned by the presentation engine. An application can acquire use of a presentable image from the presentation engine. Use of a presentable image must occur only after the image is returned by acquireNextImageKHR, and before it is released by queuePresentKHR. This includes transitioning the image layout and rendering commands.

An application can acquire use of a presentable image with acquireNextImageKHR. After acquiring a presentable image and before modifying it, the application must use a synchronization primitive to ensure that the presentation engine has finished reading from the image. The application can then transition the image’s layout, queue rendering commands to it, etc. Finally, the application presents the image with queuePresentKHR, which releases the acquisition of the image. The application can also release the acquisition of the image through releaseSwapchainImagesEXT, if the image is not in use by the device, and skip the present operation.

The presentation engine controls the order in which presentable images are acquired for use by the application.

Note

This allows the platform to handle situations which require out-of-order return of images after presentation. At the same time, it allows the application to generate command buffers referencing all of the images in the swapchain at initialization time, rather than in its main loop.

See Also

VK_KHR_swapchain, AcquireNextImageInfoKHR, BindImageMemorySwapchainInfoKHR, ImageSwapchainCreateInfoKHR, PresentInfoKHR, ReleaseSwapchainImagesInfoEXT, SwapchainCreateInfoKHR, acquireFullScreenExclusiveModeEXT, acquireNextImageKHR, createSharedSwapchainsKHR, createSwapchainKHR, destroySwapchainKHR, getLatencyTimingsNV, getPastPresentationTimingGOOGLE, getRefreshCycleDurationGOOGLE, getSwapchainCounterEXT, getSwapchainImagesKHR, getSwapchainStatusKHR, latencySleepNV, queuePresentKHR, releaseFullScreenExclusiveModeEXT, setHdrMetadataEXT, setLatencyMarkerNV, setLatencySleepModeNV, setLocalDimmingAMD, waitForPresentKHR

VkSurfaceCounterFlagBitsEXT - Surface-relative counter types

See Also

VK_EXT_display_surface_counter, SurfaceCounterFlagsEXT, getSwapchainCounterEXT