QVulkanFunctions Class

Ausführliche Beschreibung

Qt und Qt-Anwendungen verknüpfen standardmäßig keine Vulkan-Bibliotheken. Stattdessen werden alle Funktionen zur Laufzeit dynamisch aufgelöst. Jedes „ QVulkanInstance “ stellt ein QVulkanFunctions-Objekt bereit, das über ` QVulkanInstance::functions()` abgerufen werden kann. Dieses enthält keine Funktionen auf Geräteebene, um den potenziellen Overhead einer internen Verteilung zu vermeiden. Stattdessen werden Funktionen, die auf einem Gerät oder einem dispatchbaren untergeordneten Objekt eines Geräts basieren, über ` QVulkanDeviceFunctions ` und ` QVulkanInstance::deviceFunctions()` bereitgestellt. `QVulkanFunctions` und ` QVulkanDeviceFunctions ` bieten zusammen Zugriff auf die gesamte Kern-Vulkan-API, mit Ausnahme etwaiger Erweiterungen.

Die typische Verwendung sieht wie folgt aus:

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

Um auf zusätzliche Funktionen zuzugreifen, können Anwendungen QVulkanInstance::getInstanceProcAddr() und vkGetDeviceProcAddr() verwenden. Anwendungen können sich auch dafür entscheiden, direkt an eine Vulkan-Bibliothek zu binden, da Plattformen mit einem entsprechenden Loader in der Regel Funktionssymbole für die Kernbefehle exportieren. Weitere Informationen finden Sie in der Man-Seite zu vkGetInstanceProcAddr.

Sicherheitshinweise

QVulkanFunctions ist eine dünne Dispatch-Schicht, die die Vulkan-API unverändert bereitstellt. Die Argumente werden unverändert an die zugrunde liegende Vulkan-Implementierung weitergeleitet, bei der es sich um eine vertrauenswürdige, prozessinterne Plattformabhängigkeit handelt. Qt überprüft, validiert oder bereinigt die übergebenen Handles, Strukturen und Zeiger nicht und führt keine Aktionen anhand der zurückgegebenen Ergebnisse durch. Der Aufruf einer Member-Funktion entspricht daher dem direkten Aufruf des entsprechenden Vulkan-Befehls, und die in der Vulkan-Spezifikation festgelegten Regeln für die zulässige Verwendung gelten unverändert. Ein Verstoß gegen diese Regeln führt zu undefiniertem Verhalten in der Vulkan-Implementierung, nicht zu einem kontrollierten Fehler von Qt.