QRhiD3D11InitParams Struct

Parámetros de inicialización específicos de Direct3D 11. Más...

Cabecera:	`#include <rhi/qrhi.h>`
CMake:	`find_package(Qt6 REQUIRED COMPONENTS GuiPrivate)` `target_link_libraries(mytarget PRIVATE Qt6::GuiPrivate)`
qmake:	`QT += gui-private`
Desde:	Qt 6.6
Hereda:	QRhiInitParams

Lista de todos los miembros, incluyendo los heredados

Variables Públicas

bool	enableDebugLayer

Descripción detallada

Nota: Esta es una API RHI con garantías de compatibilidad limitadas, ver QRhi para más detalles.

Un QRhi basado en D3D11 no necesita parámetros especiales para su inicialización. Si se desea, enableDebugLayer puede establecerse en true para habilitar la capa de depuración de Direct3D. Esto puede ser útil durante el desarrollo, pero debe evitarse en compilaciones de producción.

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

Nota: QRhiSwapChain sólo debe utilizarse en combinación con instancias de QWindow que tengan su tipo de superficie establecido en QSurface::Direct3DSurface.

Trabajo con dispositivos Direct3D 11 existentes

Al interoperar con otro motor gráfico, puede ser necesario obtener una instancia de QRhi que utilice el mismo dispositivo Direct3D. Esto se puede conseguir pasando un puntero a QRhiD3D11NativeHandles a QRhi::create(). Cuando el dispositivo se establece en un valor no nulo, también debe especificarse el contexto del dispositivo. QRhi no toma propiedad de ninguno de los objetos externos.

A veces, por ejemplo cuando se usa QRhi en combinación con OpenXR, se querrá especificar qué adaptador usar, y opcionalmente, qué nivel de característica solicitar en el dispositivo, mientras se deja la creación del dispositivo a QRhi. Esto se consigue dejando los punteros de dispositivo y contexto a null, mientras se especifica el LUID del adaptador y el nivel de característica.

Nota: QRhi sólo funciona con contextos inmediatos. Los contextos diferidos no se utilizan de ninguna manera.

Nota: Independientemente de si se utiliza un contexto de dispositivo importado o creado en QRhi, la interfaz ID3D11DeviceContext1 (Direct3D 11.1) debe ser compatible. De lo contrario, la inicialización fallará.

Documentación de variables miembro

bool QRhiD3D11InitParams::enableDebugLayer

Cuando se establece en true, se crea un dispositivo de depuración, asumiendo que la capa de depuración está disponible. El valor por defecto es false.

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