QRhiD3D11InitParams Struct
Direct3D 11-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 |
| Seit: | Qt 6.6 |
| Erbt von: | QRhiInitParams |
Öffentliche Variablen
| bool | enableDebugLayer |
Ausführliche Beschreibung
Hinweis: Hierbei handelt es sich um eine RHI-API mit eingeschränkten Kompatibilitätsgarantien. Weitere Informationen finden Sie unter QRhi.
Ein D3D11-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.
QRhiD3D11InitParams params;
params.enableDebugLayer = true;
rhi = QRhi::create(QRhi::D3D11, ¶ms);Hinweis: „ QRhiSwapChain “ sollte nur in Kombination mit „ QWindow “-Instanzen verwendet werden, deren Oberflächentyp auf „ QSurface::Direct3DSurface “ gesetzt ist.
Arbeiten mit vorhandenen Direct3D 11-Geräten
Bei der Interoperabilität 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 „ QRhiD3D11NativeHandles “-Instanz an „ QRhi::create()“ übergeben wird. Wenn das Gerät auf einen Wert ungleich Null gesetzt ist, muss auch der Gerätekontext angegeben werden. „ QRhi “ übernimmt keine Eigentumsrechte 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 Geräteerstellung „ QRhi “ überlassen wird. Dies wird erreicht, indem die Zeiger auf das Gerät und den Kontext auf „null“ gesetzt bleiben, während die Adapter-LUID und die Feature-Stufe angegeben werden.
Hinweis: „ QRhi “ funktioniert nur mit sofortigen Kontexten. Aufgeschobene Kontexte werden in keiner Weise verwendet.
Hinweis: Unabhängig davon, ob ein importierter oder ein von „ QRhi “ erstellter Gerätekonttext verwendet wird, muss die Schnittstelle „ ID3D11DeviceContext1 “ (Direct3D 11.1) unterstützt werden. Andernfalls schlägt die Initialisierung fehl.
© 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.