VKERROROUTOFDATEKHR

VK_ERROR_OUT_OF_DATE_KHR is a VkResult value returned by Vulkan operations that involve presentation or swapchain management, most commonly by vkQueuePresentKHR and vkAcquireNextImageKHR. It indicates that the swapchain is out of date and must be recreated before rendering can continue. This situation typically arises when the surface or window changes in a way that makes the current swapchain incompatible, such as a resize, a change in surface properties, or other alterations to the rendering surface. The error is defined by the VK_KHR_swapchain extension and corresponds to the value -1000001004.

Handling VK_ERROR_OUT_OF_DATE_KHR involves recreating the swapchain and any resources that depend on it, including image views and framebuffers. The general steps are: wait for the device to be idle if necessary, destroy the old swapchain and related resources, query the surface capabilities and formats, create a new swapchain with updated extent and parameters (often supplying the old swapchain as a hint), and recreate dependent resources. After the swapchain is recreated, retry the original presentation or image acquisition operation.

Related conditions include VK_SUBOPTIMAL_KHR, which indicates the swapchain can still be used but is not optimal for the current surface state; in that case, you may choose to recreate the swapchain at a suitable time. It is also common to encounter VK_ERROR_SURFACE_LOST_KHR in scenarios where the surface becomes invalid and requires handling separate from a simple swapchain recreation.

In practice, robust Vulkan applications check for VK_ERROR_OUT_OF_DATE_KHR (and VK_SUBOPTIMAL_KHR) after present or acquire calls and perform swapchain recreation to resume rendering.