QVulkanFunctions Class

详细说明

Qt 和 Qt 应用程序默认不会链接任何 Vulkan 库。相反，所有函数都在运行时动态解析。每个QVulkanInstance 都提供一个 QVulkanFunctions 对象，可通过QVulkanInstance::functions() 获取。该对象不包含设备级函数，以避免内部分派可能带来的开销。 相反，依赖于设备或设备可分派子对象的函数，是通过QVulkanDeviceFunctions 和QVulkanInstance::deviceFunctions() 暴露出来的。QVulkanFunctions 和QVulkanDeviceFunctions 共同提供了对完整核心 Vulkan API 的访问，不包括任何扩展。

典型用法如下：

void Window::init()
{
    QVulkanInstance *inst = vulkanInstance();
    QVulkanFunctions *f = inst->functions();
    // ...
    uint32_t count = 0;
    VkResult err = f->vkEnumeratePhysicalDevices(inst->vkInstance(), &count, nullptr);
    // ...
}

若需访问其他函数，应用程序可使用QVulkanInstance::getInstanceProcAddr() 和 vkGetDeviceProcAddr()。应用程序也可选择直接链接到 Vulkan 库，因为配备适当加载器的平台通常会导出核心命令的函数符号。更多信息请参阅vkGetInstanceProcAddr 的手册页。

安全性注意事项

QVulkanFunctions 是一个轻量级分发层，它原样暴露 Vulkan API。参数会被原样转发给底层的 Vulkan 实现，而该实现是一个可信的、进程内的平台依赖项。 Qt 不会检查、验证或清理传入的句柄、结构体和指针，也不会对返回的结果采取任何操作。因此，在此处调用成员函数等同于直接调用相应的 Vulkan 命令，Vulkan 规范中的有效使用规则同样适用。 违反这些规则将导致 Vulkan 实现中出现未定义行为，而非由 Qt 引发的优雅失败。