En esta página

QVulkanFunctions Class

La clase QVulkanFunctions ofrece acceso multiplataforma a la API básica de Vulkan 1.3 a nivel de instancia. Más información...

Encabezado: #include <QVulkanFunctions>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui

Descripción detallada

Qt y las aplicaciones Qt no se vinculan a ninguna biblioteca de Vulkan de forma predeterminada. En su lugar, todas las funciones se resuelven dinámicamente en tiempo de ejecución. Cada ` QVulkanInstance ` proporciona un objeto `QVulkanFunctions` al que se puede acceder mediante ` QVulkanInstance::functions()`. Este no contiene funciones a nivel de dispositivo para evitar la posible sobrecarga de un despacho interno. En su lugar, las funciones que dependen de un dispositivo, o de un objeto secundario despachable de un dispositivo, se exponen a través de QVulkanDeviceFunctions y QVulkanInstance::deviceFunctions(). QVulkanFunctions y QVulkanDeviceFunctions proporcionan conjuntamente acceso a toda la API principal de Vulkan, excluyendo cualquier extensión.

Nota: Las instancias deQVulkanFunctions no se pueden crear directamente.

El uso habitual es el siguiente:

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

Nota: Se excluyen los aspectos específicos y las extensiones de la interfaz del sistemade ventanas (WSI). Esta clase solo abarca los comandos básicos de Vulkan, con la excepción de la creación y destrucción de instancias, así como la resolución de funciones, ya que dicha funcionalidad queda cubierta por el propio QVulkanInstance.

Para acceder a funciones adicionales, las aplicaciones pueden utilizar ` QVulkanInstance::getInstanceProcAddr()` y `vkGetDeviceProcAddr()`. Las aplicaciones también pueden optar por enlazar directamente con una biblioteca de Vulkan, ya que las plataformas con un cargador adecuado suelen exportar símbolos de función para los comandos básicos. Consulte la página de manual de `vkGetInstanceProcAddr` para obtener más información.

Nota: Los prototipos de las funciones miembro para los comandos de Vulkan 1.1, 1.2 y 1.3 son ifdefed con el VK_VERSION_1_x adecuado, tal y como se define en los encabezados de Vulkan. Por lo tanto, una aplicación solo podrá llamar a estas funciones cuando el encabezado de Vulkan del sistema (en el que se compila la aplicación) sea lo suficientemente reciente y contenga definiciones de la API de Vulkan 1.1, 1.2 o 1.3. Al compilar Qt desde el código fuente, esto tiene una consecuencia adicional: los encabezados de Vulkan del entorno de compilación también deben ser compatibles con las versiones 1.1, 1.2 y 1.3 para obtener una compilación de Qt que admita la resolución de los comandos de la API 1.1, 1.2 y 1.3. Si no se cumple ninguna de estas condiciones, las aplicaciones solo podrán invocar los comandos de Vulkan 1.0 a través de `QVulkanFunctions` y ` QVulkanDeviceFunctions`.

Consideraciones de seguridad

QVulkanFunctions es una capa de despacho ligera que expone la API de Vulkan tal cual. Los argumentos se reenvían tal cual a la implementación subyacente de Vulkan, que es una dependencia de la plataforma de confianza y dentro del proceso. Qt no inspecciona, valida ni depura los identificadores, estructuras y punteros que se le pasan, y no actúa sobre los resultados devueltos. Por lo tanto, llamar a una función miembro aquí equivale a llamar directamente al comando de Vulkan correspondiente, y se aplican sin cambios las reglas de uso válidas de la especificación de Vulkan. Incumplirlas da lugar a un comportamiento indefinido en la implementación de Vulkan, no a un fallo controlado por parte de Qt.

Advertencia: Se espera quetodos los datos pasados a través de QVulkanFunctions sean de confianza. Se recomienda a los desarrolladores de aplicaciones que consideren cuidadosamente las posibles implicaciones antes de derivar cualquier dato de contenido proporcionado por el usuario que no forme parte de la aplicación y no esté bajo el control de los desarrolladores. Consulte QVulkanInstance para obtener más información.

Véase también QVulkanInstance, QVulkanDeviceFunctions, QWindow::setVulkanInstance() y QWindow::setSurfaceType().

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.