QRhiD3D11InitParams Struct
Direct3D 11 전용 초기화 매개변수. 더 보기...
| 헤더: | #include <rhi/qrhi.h> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS GuiPrivate) target_link_libraries(mytarget PRIVATE Qt6::GuiPrivate) |
| qmake: | QT += gui-private |
| 다음부터: | Qt 6.6 |
| 상속: | QRhiInitParams |
공개 변수
| bool | enableDebugLayer |
상세 설명
참고: 이 API는 호환성 보장이 제한된 RHI API입니다. 자세한 내용은 QRhi 를 참조하십시오.
D3D11 기반의 QRhi 는 초기화를 위해 특별한 매개변수가 필요하지 않습니다. 원하는 경우, enableDebugLayer 를 true 로 설정하여 Direct3D 디버그 레이어를 활성화할 수 있습니다. 이는 개발 중에 유용할 수 있지만, 실제 배포 빌드에서는 사용하지 않는 것이 좋습니다.
QRhiD3D11InitParams params;
params.enableDebugLayer = true;
rhi = QRhi::create(QRhi::D3D11, ¶ms);참고: QRhiSwapChain 는 표면 유형(surface type)이 QSurface::Direct3DSurface 로 설정된 QWindow 인스턴스와 함께 사용해야 합니다.
기존 Direct3D 11 장치 사용
다른 그래픽 엔진과 상호 운용할 때, 동일한 Direct3D 장치를 사용하는 ` QRhi ` 인스턴스를 가져와야 할 수 있습니다. 이는 ` QRhiD3D11NativeHandles `에 대한 포인터를 ` QRhi::create()`에 전달하여 달성할 수 있습니다. 장치가 null이 아닌 값으로 설정된 경우, 장치 컨텍스트도 함께 지정해야 합니다. ` QRhi `는 외부 객체에 대한 소유권을 가져가지 않습니다.
예를 들어, OpenXR과 함께 QRhi 를 사용할 때와 같이, QRhi 에 장치 생성을 맡기면서 사용할 어댑터를 지정하고, 선택적으로 장치에서 요청할 기능 레벨을 지정하고자 하는 경우가 있습니다. 이는 어댑터 LUID와 기능 레벨을 지정하는 동시에 장치 및 컨텍스트 포인터를 null로 설정함으로써 달성할 수 있습니다.
참고: ` QRhi `는 즉시 컨텍스트에서만 작동합니다. 지연 컨텍스트는 어떠한 방식으로도 사용되지 않습니다.
참고: 가져온 장치 컨텍스트를 사용하든 QRhi 를 통해 생성된 장치 컨텍스트를 사용하든상관없이 , ID3D11DeviceContext1 인터페이스(Direct3D 11.1)가 지원되어야 합니다. 그렇지 않으면 초기화가 실패합니다.
© 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.