QVulkanDeviceFunctions Class
La clase `QVulkanDeviceFunctions` proporciona acceso multiplataforma a la API básica de Vulkan 1.3 a nivel de dispositivo. Más información...
| Encabezado: | #include <QVulkanDeviceFunctions> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
- QVulkanDeviceFunctions forma parte de «Renderizado en 3D».
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 central de Vulkan, excluyendo cualquier extensión.
Nota: Las instancias de `QVulkanDeviceFunctions ` no se pueden crear directamente.
El uso habitual es el siguiente:
void Window::render()
{
QVulkanInstance *inst = vulkanInstance();
QVulkanDeviceFunctions *df = inst->deviceFunctions(device);
VkResult err = df->vkAllocateCommandBuffers(device, &cmdBufInfo, &cmdBuf);
// ...
}El objeto `QVulkanDeviceFunctions` específico del `VkDevice` proporcionado se crea cuando se llama por primera vez a ` QVulkanInstance::deviceFunctions()` con el dispositivo en cuestión. A continuación, el objeto se almacena en caché internamente.
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 muchas implementaciones exportan símbolos de función para los comandos básicos. Consulta la página de manual de vkGetInstanceProcAddr para obtener más información.
Consideraciones de seguridad
QVulkanDeviceFunctions 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 mismo proceso. Qt no inspecciona, valida ni depura los identificadores, estructuras y punteros que se le pasan, y no actúa sobre los resultados devueltos. Esto abarca, entre otros, todos los comandos de creación de recursos, mapeo de memoria y construcción de búferes de comandos. Por lo tanto, llamar a una función miembro aquí equivale a llamar directamente al comando Vulkan correspondiente, y las reglas de uso válidas de la especificación de Vulkan se aplican sin modificaciones. 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 QVulkanDeviceFunctions sean contenido de confianza. Se recomienda a los desarrolladores de aplicaciones que consideren cuidadosamente las posibles implicaciones antes de derivar cualquier dato del 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, QVulkanFunctions, 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.