QRhiD3D11InitParams Struct

Paramètres d'initialisation spécifiques à Direct3D 11. Plus d'informations...

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 :	QRhiInitParams

Liste de tous les membres, y compris les membres hérités

Variables publiques

bool	enableDebugLayer

Description détaillée

Remarque : il s'agit d'une API RHI avec des garanties de compatibilité limitées, voir QRhi pour plus de détails.

Un site QRhi basé sur D3D11 n'a besoin d'aucun paramètre spécial pour l'initialisation. Si vous le souhaitez, enableDebugLayer peut être défini à true pour activer la couche de débogage Direct3D. Cela peut être utile pendant le développement, mais devrait être évité dans les versions de production.

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

Remarque : QRhiSwapChain ne doit être utilisé qu'en combinaison avec des instances QWindow dont le type de surface est réglé sur QSurface::Direct3DSurface.

Travailler avec des périphériques Direct3D 11 existants

Lors de l'interopérabilité avec un autre moteur graphique, il peut être nécessaire d'obtenir une instance QRhi qui utilise le même périphérique Direct3D. Pour ce faire, il suffit de passer un pointeur sur QRhiD3D11NativeHandles à 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é. QRhi n'est propriétaire d'aucun des objets externes.

Parfois, par exemple lors de l'utilisation de QRhi en combinaison avec OpenXR, on voudra spécifier l'adaptateur à utiliser, et optionnellement, le niveau de fonctionnalité à demander sur le périphérique, tout en laissant la création du périphérique à QRhi. Ceci est réalisé en laissant les pointeurs de périphérique et de contexte définis à null, tout en spécifiant le LUID de l'adaptateur et le niveau de fonctionnalité.

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

Note : Indépendamment de l'utilisation d'un contexte de périphérique importé ou créé par QRhi, l'interface ID3D11DeviceContext1 (Direct3D 11.1) doit être supportée. Dans le cas contraire, l'initialisation échouera.

Documentation des variables membres

bool QRhiD3D11InitParams::enableDebugLayer

Lorsque cette valeur est fixée à true, un périphérique de débogage est créé, en supposant 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.