QVulkanFunctions Class

詳細な説明

QtおよびQtアプリケーションは、デフォルトではいかなるVulkanライブラリにもリンクしません。その代わりに、すべての関数は実行時に動的に解決されます。各QVulkanInstance は、QVulkanInstance::functions()を介して取得可能なQVulkanFunctionsオブジェクトを提供します。これには、内部ディスパッチによる潜在的なオーバーヘッドを回避するため、デバイスレベルの関数は含まれていません。 その代わり、デバイス、またはデバイスのディスパッチ可能な子オブジェクトに依存する関数は、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 仕様で定められた有効な使用規則がそのまま適用されます。 これらに違反すると、Qt による正常な失敗ではなく、Vulkan 実装における未定義の挙動を引き起こします。