QRhiD3D12InitParams Struct

Paramètres d'initialisation spécifiques à Direct3D 12. 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`
Héritages :	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 D3D12 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.

QRhiD3D12InitParams params;
params.enableDebugLayer = true;
rhi = QRhi::create(QRhi::D3D12, &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 12 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 QRhiD3D12NativeHandles à QRhi::create(). 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, éventuellement, le niveau de fonctionnalité à demander sur le périphérique, tout en laissant la création du périphérique à QRhi. On y parvient en laissant le pointeur de périphérique fixé à null, tout en spécifiant le LUID de l'adaptateur et le niveau de fonctionnalité.

La file d'attente ID3D12CommandQueue peut également être spécifiée, en attribuant à commandQueue une valeur non nulle.

Documentation des variables membres

bool QRhiD3D12InitParams::enableDebugLayer

Lorsqu'elle vaut true, la couche de débogage est activée, si elle est installée et 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.