QRhiD3D12InitParams Struct
Direct3D 12 전용 초기화 매개변수. 더 보기...
| 헤더: | #include <rhi/qrhi.h> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS GuiPrivate) target_link_libraries(mytarget PRIVATE Qt6::GuiPrivate) |
| qmake: | QT += gui-private |
| 상속: | QRhiInitParams |
공개 변수
| bool | enableDebugLayer |
상세 설명
참고: 이 RHI API는 호환성 보장이 제한적입니다. 자세한 내용은 QRhi 를 참조하십시오.
D3D12 기반 QRhi 은 초기화에 특별한 매개변수가 필요하지 않습니다. 원하는 경우, enableDebugLayer 을 true 으로 설정하여 Direct3D 디버그 레이어를 활성화할 수 있습니다. 이는 개발 단계에서는 유용할 수 있지만, 실제 배포 빌드에서는 피해야 합니다.
QRhiD3D12InitParams params;
params.enableDebugLayer = true;
rhi = QRhi::create(QRhi::D3D12, ¶ms);참고: QRhiSwapChain 는 표면 유형이 QSurface::Direct3DSurface 로 설정된 QWindow 인스턴스와 함께 사용해야 합니다.
기존 Direct3D 12 장치 사용
다른 그래픽 엔진과 상호 운용할 때, 동일한 Direct3D 장치를 사용하는 QRhi 인스턴스를 가져와야 할 수 있습니다. 이는 QRhiD3D12NativeHandles 에 대한 포인터를 QRhi::create()에 전달하여 달성할 수 있습니다. QRhi 는 외부 객체에 대한 소유권을 가져가지 않습니다.
예를 들어 QRhi 를 OpenXR과 함께 사용할 때와 같이, QRhi 에 장치 생성을 맡기면서 사용할 어댑터를 지정하고, 선택적으로 장치에서 요청할 기능 레벨을 지정하고자 하는 경우가 있습니다. 이는 어댑터 LUID와 기능 레벨을 지정하는 동시에 장치 포인터를 null로 설정함으로써 달성할 수 있습니다.
선택적으로 commandQueue 를 null이 아닌 값으로 설정하여 ID3D12CommandQueue를 지정할 수도 있습니다.
멤버 변수 설명서
bool QRhiD3D12InitParams::enableDebugLayer
true로 설정하면, 디버그 레이어가 설치되어 있고 사용 가능한 경우 활성화됩니다. 기본값은 false입니다.
디버그 레이어에서 발생하는 메시지는 ` qDebug`을 통해 출력됩니다. 단, 디버그 레이어가 너무 오래되어 메시지 콜백을 지원하지 않는 경우에는 메시지가 디버그 출력에만 전송됩니다.
© 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.