QRhiD3D12InitParams Struct
Paramètres d'initialisation spécifiques à Direct3D 12. En savoir plus...
| En-tête : | #include <rhi/qrhi.h> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS GuiPrivate) target_link_libraries(mytarget PRIVATE Qt6::GuiPrivate) |
| qmake : | QT += gui-private |
| Hérite de : | QRhiInitParams |
Variables publiques
| bool | enableDebugLayer |
Description détaillée
Remarque : il s'agit d'une API RHI dont la compatibilité n'est pas entièrement garantie ; pour plus de détails, consultez QRhi.
Une instance d'QRhi basée sur D3D12 ne nécessite aucun paramètre particulier pour son initialisation. Si vous le souhaitez, la propriété ` enableDebugLayer ` peut être définie sur ` true ` pour activer la couche de débogage Direct3D. Cela peut s'avérer utile pendant le développement, mais doit être évité dans les versions de production.
QRhiD3D12InitParams params;
params.enableDebugLayer = true;
rhi = QRhi::create(QRhi::D3D12, ¶ms);Remarque : ` QRhiSwapChain ` ne doit être utilisé qu’en combinaison avec des instances de ` QWindow ` dont le type de surface est défini sur ` QSurface::Direct3DSurface`.
Utilisation de périphériques Direct3D 12 existants
Lors de l’interopérabilité avec un autre moteur graphique, il peut s’avérer nécessaire d’obtenir une instance ` QRhi ` utilisant le même périphérique Direct3D. Pour ce faire, il suffit de transmettre un pointeur vers une instance ` QRhiD3D12NativeHandles ` à la fonction ` QRhi::create()`. La fonction ` QRhi ` ne prend possession d’aucun des objets externes.
Parfois, par exemple lors de l’utilisation de ` QRhi ` en combinaison avec OpenXR, on peut souhaiter spécifier l’adaptateur à utiliser et, éventuellement, le niveau de fonctionnalités à demander sur le périphérique, tout en laissant la création du périphérique à la charge de ` QRhi`. Pour ce faire, il suffit de laisser le pointeur vers le périphérique défini sur `null`, tout en spécifiant le LUID de l’adaptateur et le niveau de fonctionnalités.
Il est également possible de spécifier l’ID3D12CommandQueue en attribuant une valeur non nulle à commandQueue.
Documentation sur les variables membres
bool QRhiD3D12InitParams::enableDebugLayer
Lorsque cette option est définie sur « true », la couche de débogage est activée, si elle est installée et disponible. La valeur par défaut est « false ».
Les messages provenant de la couche de débogage sont affichés via qDebug, sauf si la couche de débogage est trop ancienne pour prendre en charge les rappels de messages, auquel cas les messages sont uniquement envoyés vers la sortie de débogage.
© 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.