QVulkanFunctions Class

Description détaillée

Par défaut, Qt et les applications Qt ne sont liées à aucune bibliothèque Vulkan. Au lieu de cela, toutes les fonctions sont résolues dynamiquement au moment de l’exécution. Chaque instance de ` QVulkanInstance ` fournit un objet `QVulkanFunctions` accessible via ` QVulkanInstance::functions()`. Celui-ci ne contient pas de fonctions au niveau du périphérique afin d’éviter la surcharge potentielle liée à une répartition interne. En revanche, les fonctions qui dépendent d’un périphérique, ou d’un objet enfant dispatchable d’un périphérique, sont exposées via QVulkanDeviceFunctions et QVulkanInstance::deviceFunctions(). QVulkanFunctions et QVulkanDeviceFunctions permettent ensemble d’accéder à l’intégralité de l’API Vulkan de base, à l’exclusion de toute extension.

L’utilisation typique est la suivante :

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

Pour accéder à des fonctions supplémentaires, les applications peuvent utiliser ` QVulkanInstance::getInstanceProcAddr()` et `vkGetDeviceProcAddr()`. Les applications peuvent également choisir de se lier directement à une bibliothèque Vulkan, car les plateformes dotées d’un chargeur approprié exportent généralement les symboles de fonction pour les commandes de base. Consultez la page de manuel de `vkGetInstanceProcAddr` pour plus d’informations.

Considérations de sécurité

QVulkanFunctions est une fine couche de répartition qui expose l’API Vulkan telle quelle. Les arguments sont transmis tels quels à l’implémentation Vulkan sous-jacente, qui est une dépendance de plateforme fiable et intégrée au processus. Qt n’inspecte pas, ne valide pas et ne nettoie pas les descripteurs, les structures et les pointeurs transmis, et n’intervient pas sur les résultats renvoyés. Appeler une fonction membre ici équivaut donc à appeler directement la commande Vulkan correspondante, et les règles d’utilisation valides de la spécification Vulkan s’appliquent sans modification. Leur non-respect entraîne un comportement indéfini dans l’implémentation Vulkan, et non un échec géré par Qt.