QVulkanDeviceFunctions 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 Vermittlung zu vermeiden. Stattdessen werden Funktionen, die auf ein Gerät oder ein dispatchbares untergeordnetes Objekt eines Geräts angewiesen sind, über `QVulkanDeviceFunctions` und ` QVulkanInstance::deviceFunctions()` bereitgestellt. ` QVulkanFunctions ` und `QVulkanDeviceFunctions` bieten gemeinsam Zugriff auf die vollständige Kern-Vulkan-API, mit Ausnahme etwaiger Erweiterungen.

Die typische Verwendung ist wie folgt:

void Window::render()
{
    QVulkanInstance *inst = vulkanInstance();
    QVulkanDeviceFunctions *df = inst->deviceFunctions(device);
    VkResult err = df->vkAllocateCommandBuffers(device, &cmdBufInfo, &cmdBuf);
    // ...
}

Das für das bereitgestellte `VkDevice` spezifische `QVulkanDeviceFunctions`-Objekt wird erstellt, wenn ` QVulkanInstance::deviceFunctions()` zum ersten Mal mit dem betreffenden Gerät aufgerufen wird. Das Objekt wird anschließend intern zwischengespeichert.

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 viele Implementierungen Funktionssymbole für die Kernbefehle exportieren. Weitere Informationen finden Sie in der Manpage zu `vkGetInstanceProcAddr`.

Sicherheitshinweise

QVulkanDeviceFunctions 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. Dies umfasst unter anderem alle Befehle zur Ressourcenerstellung, zum Speicher-Mapping und zum Aufbau von Befehlspuffern. Der Aufruf einer Member-Funktion entspricht hier daher dem direkten Aufruf des entsprechenden Vulkan-Befehls, und die in der Vulkan-Spezifikation festgelegten Nutzungsregeln gelten unverändert. Ein Verstoß gegen diese Regeln führt zu undefiniertem Verhalten in der Vulkan-Implementierung, nicht zu einem kontrollierten Fehler von Qt.