如何获取C++中vkCreateInstance返回的VkResult枚举值排查实例创建失败？

1. 捕获实际返回的VkResult值 #

修改你的代码，先保存vkCreateInstance的返回值再判断是否成功，就能直接查看错误码的数值或转换为可读描述：

VkResult result = vkCreateInstance(&createInfo, nullptr, &instance);
if (result != VK_SUCCESS) {
    // 打印错误码数值，方便对照枚举定义
    std::cerr << "创建实例失败！错误码数值: " << static_cast<int>(result) << std::endl;
    throw std::runtime_error("failed to create an instance!");
}

如果需要更直观的错误描述，可以实现一个简单的转换函数：

const char* vkResultToString(VkResult result) {
    switch(result) {
        case VK_ERROR_INCOMPATIBLE_DRIVER: return "驱动版本不兼容，无法支持请求的Vulkan版本";
        case VK_ERROR_EXTENSION_NOT_PRESENT: return "请求的扩展未被驱动支持";
        case VK_ERROR_LAYER_NOT_PRESENT: return "请求的验证层未找到";
        case VK_ERROR_OUT_OF_HOST_MEMORY: return "主机内存不足";
        case VK_ERROR_OUT_OF_DEVICE_MEMORY: return "设备内存不足";
        case VK_ERROR_INITIALIZATION_FAILED: return "初始化过程中发生未知错误";
        default: return "未知错误码";
    }
}

然后在错误处理中调用：

std::cerr << "创建实例失败！错误信息: " << vkResultToString(result) << std::endl;

2. 常见VkResult错误码（中文释义） #

以下是与vkCreateInstance相关的主要错误码及对应解释：

• VK_ERROR_INCOMPATIBLE_DRIVER：驱动版本不兼容，无法支持你请求的Vulkan API版本
• VK_ERROR_EXTENSION_NOT_PRESENT：你在createInfo中指定的一个或多个扩展未被当前驱动支持
• VK_ERROR_LAYER_NOT_PRESENT：你启用的验证层不存在（通常是未正确安装验证层或路径配置错误）
• VK_ERROR_OUT_OF_HOST_MEMORY：主机系统内存不足，无法完成实例创建
• VK_ERROR_OUT_OF_DEVICE_MEMORY：GPU设备内存不足，无法完成实例创建
• VK_ERROR_INITIALIZATION_FAILED：初始化过程中发生未明确归类的错误

内容的提问来源于stack exchange，提问作者KnotALun