QRhiD3D11InitParams Struct

Direct3D 11固有の初期化パラメータです。詳細...

ヘッダー #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

パブリック変数

詳細説明

注意: これは互換性保証に制限のある 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 に任せて、使用するアダプタと、オプションでデバイスに要求する機能レベルを指定したいことがあります。この場合、デバイスとコンテキスト・ポインタを 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.