VKERRORINCOMPATIBLEDRIVER

VK_ERROR_INCOMPATIBLE_DRIVER is a Vulkan API error code (a VkResult) returned by Vulkan functions when the current graphics driver is not compatible with the application's requested Vulkan API version or extensions. It indicates that the installed driver cannot support the Vulkan features the application or loader is asking for.

The error can occur during instance creation (vkCreateInstance) or device creation (vkCreateDevice) when the Vulkan loader cannot find a driver that supports the requested API version, extensions, or device features. It often points to a driver that is too old, missing Vulkan support, or a mismatch between the loader and the installed driver.

Common causes include an outdated or missing graphics driver, hardware without Vulkan support, incorrect or conflicting Vulkan runtime installations, or enabling extensions that the current driver does not implement. It may also appear if multiple GPUs are present and the active driver does not provide Vulkan support for the selected device.

Resolution typically involves ensuring the system has a Vulkan-capable driver that matches the application's requirements. This includes updating the graphics driver to a version that supports the desired Vulkan API, installing the Vulkan loader and correct ICD (installations vary by operating system), and verifying hardware support with diagnostic tools such as Vulkaninfo. On Linux, install the appropriate packages for libvulkan and Vulkan utilities and ensure the correct ICD is loaded. On Windows, download the latest driver from the GPU vendor. If multiple GPUs are present, ensure the application selects a Vulkan-capable device and that the requested extensions are supported by the driver.