QRhiD3D12InitParams Struct
Direct3D 12-spezifische Initialisierungsparameter. Mehr...
| Header: | #include <rhi/qrhi.h> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS GuiPrivate) target_link_libraries(mytarget PRIVATE Qt6::GuiPrivate) |
| qmake: | QT += gui-private |
| Erbt von: | QRhiInitParams |
Öffentliche Variablen
| bool | enableDebugLayer |
Ausführliche Beschreibung
Hinweis: Dies ist eine RHI-API mit eingeschränkten Kompatibilitätsgarantien; weitere Informationen finden Sie unter QRhi.
Ein D3D12-basiertes „ QRhi “ benötigt keine speziellen Parameter zur Initialisierung. Falls gewünscht, kann „ enableDebugLayer “ auf „ true “ gesetzt werden, um die Direct3D-Debug-Ebene zu aktivieren. Dies kann während der Entwicklung nützlich sein, sollte jedoch in Produktionsbuilds vermieden werden.
QRhiD3D12InitParams params;
params.enableDebugLayer = true;
rhi = QRhi::create(QRhi::D3D12, ¶ms);Hinweis: „ QRhiSwapChain “ sollte nur in Kombination mit „ QWindow “-Instanzen verwendet werden, bei denen der Oberflächentyp auf „ QSurface::Direct3DSurface “ gesetzt ist.
Arbeiten mit vorhandenen Direct3D 12-Geräten
Bei der Zusammenarbeit mit einer anderen Grafik-Engine kann es erforderlich sein, eine ` QRhi `-Instanz zu erhalten, die dasselbe Direct3D-Gerät verwendet. Dies lässt sich erreichen, indem ein Zeiger auf eine ` QRhiD3D12NativeHandles ` an ` QRhi::create()` übergeben wird. ` QRhi ` übernimmt kein Eigentumsrecht an den externen Objekten.
Manchmal, beispielsweise bei der Verwendung von ` QRhi ` in Kombination mit OpenXR, möchte man festlegen, welcher Adapter verwendet werden soll, und optional, welche Feature-Stufe auf dem Gerät angefordert werden soll, während die Erstellung des Geräts ` QRhi` überlassen wird. Dies wird erreicht, indem der Gerätezeiger auf `null` gesetzt wird, während die Adapter-LUID und die Feature-Stufe angegeben werden.
Optional kann auch die `ID3D12CommandQueue` angegeben werden, indem ` commandQueue ` auf einen Wert ungleich Null gesetzt wird.
Dokumentation der Member-Variablen
bool QRhiD3D12InitParams::enableDebugLayer
Wenn dieser Wert auf „true“ gesetzt ist, wird die Debug-Ebene aktiviert, sofern sie installiert und verfügbar ist. Der Standardwert ist „false“.
Die Meldungen der Debug-Ebene werden über „ qDebug “ ausgegeben, es sei denn, die Debug-Ebene ist zu alt, um Callbacks für Meldungen zu unterstützen; in diesem Fall werden die Meldungen nur an die Debug-Ausgabe gesendet.
© 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.