QRhiD3D11InitParams Struct

Direct3D 11 특정 초기화 매개변수. 자세히...

Header:	`#include <rhi/qrhi.h>`
CMake:	`find_package(Qt6 REQUIRED COMPONENTS Gui)` `target_link_libraries(mytarget PRIVATE Qt6::GuiPrivate)`
qmake:	`QT += gui-private`
이후:	Qt 6.6
상속합니다:	QRhiInitParams

상속된 멤버를 포함한 모든 멤버 목록

공용 변수

bool	enableDebugLayer

상세 설명

참고: 호환성이 제한적으로 보장되는 RHI API이며, 자세한 내용은 QRhi 을 참조하세요.

D3D11 기반 QRhi 에는 초기화를 위한 특별한 매개변수가 필요하지 않습니다. 원하는 경우 enableDebugLayer 을 true 으로 설정하여 Direct3D 디버그 레이어를 활성화할 수 있습니다. 이는 개발 중에는 유용할 수 있지만 프로덕션 빌드에서는 피해야 합니다.

QRhiD3D11InitParams params;
params.enableDebugLayer = true;
rhi = QRhi::create(QRhi::D3D11, &params);

참고: QRhiSwapChain 은 표면 유형이 QSurface::Direct3DSurface 으로 설정된 QWindow 인스턴스와 함께만 사용해야 합니다.

기존 Direct3D 11 장치로 작업하기

다른 그래픽 엔진과 상호 운용할 때 동일한 Direct3D 장치를 사용하는 QRhi 인스턴스를 가져와야 할 수 있습니다. 이는 QRhi::create()에 QRhiD3D11NativeHandles 포인터를 전달하여 얻을 수 있습니다. 장치가 null이 아닌 값으로 설정된 경우 장치 컨텍스트도 지정해야 합니다. QRhi 은 외부 객체에 대한 소유권을 갖지 않습니다.

예를 들어 OpenXR과 함께 QRhi 을 사용하는 경우 장치 생성은 QRhi 으로 남겨두고 사용할 어댑터와 선택적으로 장치에 요청할 기능 수준을 지정하고 싶을 때가 있습니다. 이 경우 장치 및 컨텍스트 포인터를 null로 설정하고 어댑터 LUID 및 기능 수준을 지정하면 됩니다.

참고: QRhi 은 즉시 컨텍스트에서만 작동합니다. 지연된 컨텍스트는 어떤 방식으로도 사용되지 않습니다.

참고: 가져온 컨텍스트 또는 QRhi-생성된 장치 컨텍스트를 사용하는 것과 관계없이 ID3D11DeviceContext1 인터페이스(Direct3D 11.1)가 지원되어야 합니다. 그렇지 않으면 초기화에 실패합니다.

멤버 변수 문서

bool QRhiD3D11InitParams::enableDebugLayer

true로 설정하면 디버그 계층을 사용할 수 있다고 가정하여 디버그 장치가 만들어집니다. 기본값은 false입니다.

© 2025 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.