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
Since: Qt 6.6
Inherits: QRhiInitParams

パブリック変数

詳細説明

注意: これは互換性が限定的に保証された RHI API です。詳細はQRhi を参照してください。

D3D11ベースのQRhi 、初期化に特別なパラメータは必要ありません。必要であれば、enableDebugLayertrue に設定することで、Direct3D デバッグレイヤーを有効にすることができます。これは開発時には便利ですが、製品ビルドでは避けるべきです。

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

注意: QRhiSwapChain は、サーフェスタイプがQSurface::Direct3DSurface に設定されているQWindow インスタンスと組み合わせてのみ使用してください。

既存の Direct3D 11 デバイスとの連携

別のグラフィックエンジンと相互運用する場合、同じ Direct3D デバイスを使用するQRhi インスタンスを取得する必要があります。これは、QRhiD3D11NativeHandles へのポインタをQRhi::create() に渡すことで実現できます。デバイスに NULL 以外の値を設定する場合は、デバイスコンテキストも指定する必要があります。QRhi は、外部オブジェクトの所有権を一切持ちません。

たとえば、QRhi を OpenXR と組み合わせて使用する場合、デバイスの作成はQRhi に任せて、使用するアダプタと、オプションでデバイスに要求する機能レベルを指定したいことがあります。この場合、アダプタの LUID と機能レベルを指定したまま、デバイスとコンテキスト・ポインタを NULL に設定することで実現できます。

注意: QRhi は、即時コンテキストでのみ動作する。遅延コンテキストは一切使用しません。

注意: インポートされたデバイスコンテキスト、QRhi で作成されたデバイスコンテキストにかかわらず、ID3D11DeviceContext1 インターフェース(Direct3D 11.1)に対応している必要があります。そうでない場合、初期化は失敗する。

メンバー変数ドキュメント

bool QRhiD3D11InitParams::enableDebugLayer

trueに設定すると、デバッグレイヤーが利用可能であると仮定して、デバッグデバイスが作成されます。デフォルト値はfalseです。

本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。