Sur cette page

QRhiD3D11InitParams Struct

Paramètres d'initialisation spécifiques à Direct3D 11. 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
Depuis : Qt 6.6
Hérite de : QRhiInitParams

Variables publiques

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 D3D11 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.

QRhiD3D11InitParams params;
params.enableDebugLayer = true;
rhi = QRhi::create(QRhi::D3D11, &params);

Remarque : l’ QRhiSwapChain ne doit être utilisé qu’en combinaison avec des instances d’ QWindow dont le type de surface est défini sur « QSurface::Direct3DSurface ».

Utilisation de périphériques Direct3D 11 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 passer un pointeur vers un ` QRhiD3D11NativeHandles ` à la fonction ` QRhi::create()`. Lorsque le périphérique est défini sur une valeur non nulle, le contexte du périphérique doit également être spécifié. 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 à ` QRhi`. Pour ce faire, il suffit de laisser les pointeurs du périphérique et du contexte définis sur `null`, tout en spécifiant le LUID de l’adaptateur et le niveau de fonctionnalités.

Remarque : QRhi fonctionne uniquement avec des contextes immédiats. Les contextes différés ne sont en aucun cas utilisés.

Remarque : que vous utilisiez un contexte de périphérique importé ou créé par ` QRhi`, l'interface ` ID3D11DeviceContext1 ` (Direct3D 11.1) doit être prise en charge. Dans le cas contraire, l'initialisation échouera.

Documentation des variables membres

bool QRhiD3D11InitParams::enableDebugLayer

Lorsque cette option est définie sur « true », un périphérique de débogage est créé, à condition que la couche de débogage soit disponible. La valeur par défaut est « false ».

© 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.