IDirect3DDevice9::ValidateDevice メソッド (d3d9helper.h)

[アーティクル]
03/05/2024

現在のテクスチャブレンド操作と引数を 1 回のパスでレンダリングするデバイスの機能を報告します。

構文

HRESULT ValidateDevice(
  [out, retval] DWORD *pNumPasses
);

パラメーター

[out, retval] pNumPasses

種類: DWORD*

マルチパスレンダリングを通じて目的の効果を完了するために必要なレンダリングパスの数を埋める DWORD 値へのポインター。

戻り値

種類: HRESULT

メソッドが成功した場合、戻り値はD3D_OK。メソッドが失敗した場合、戻り値は、D3DERR_CONFLICTINGRENDERSTATE、D3DERR_CONFLICTINGTEXTUREFILTER、D3DERR_DEVICELOST、D3DERR_DRIVERINTERNALERROR、D3DERR_TOOMANYOPERATIONS、D3DERR_UNSUPPORTEDALPHAARG、D3DERR_UNSUPPORTEDALPHAOPERATION、D3DERR_UNSUPPORTEDCOLORARG、D3DERR_UNSUPPORTEDCOLOROPERATION、D3DERR_UNSUPPORTEDFACTORVALUE、D3DERR_UNSUPPORTEDTEXTUREFILTER、D3DERR_WRONGTEXTUREFORMATのいずれかになります。

注釈

IDirect3DDevice9::ValidateDevice メソッドは、他の機能が不足している場合にのみ、シナリオを検証するために使用する必要があります。たとえば、マルチステージテクスチャリングシナリオでは、 D3DCAPS9 構造体の MaxTextureBlendStages メンバーと MaxSimultaneousTextures メンバーに対してクエリを実行して、デバイスでマルチステージテクスチャリングが可能かどうかを判断できます。

現在のハードウェアでは、操作と引数の可能な組み合わせがすべて実装されているわけではありません。特定のブレンド操作を特定の引数で実行できるかどうかを判断するには、目的のブレンド操作を設定し、 IDirect3DDevice9::ValidateDevice メソッドを呼び出します。

IDirect3DDevice9::ValidateDevice メソッドは、現在のレンダリング状態、テクスチャ、およびテクスチャステージの状態を使用して、呼び出し時に検証を実行します。呼び出し後にこれらの要因を変更すると、前の結果が無効になり、シーンをレンダリングする前にメソッドを再度呼び出す必要があります。

最適なパフォーマンスを得る場合は、初期化時 に IDirect3DDevice9::ValidateDevice を呼び出します。は、レンダーループ内で使用しないでください。

現在のハードウェアでは、拡散反復値を引数または操作 (D3DTA_DIFFUSED3DTOP_BLENDDIFFUSEALPHA) として使用することはほとんどサポートされません。ほとんどのハードウェアでは、最後のテクスチャ操作ステージでのみ反復カラーデータを導入できます。

2 番目の引数ではなく、各ステージのテクスチャ (D3DTA_TEXTURE) を最初の引数として指定してみてください。

多くのカードでは、任意のテクスチャステージでの拡散またはスカラー値の使用はサポートされていません。多くの場合、これらは最初または最後のテクスチャブレンドステージでのみ使用できます。

多くのカードには、アルファをカラーチャネルにレプリケートしたり、入力を反転したりする以外に、最初のテクスチャに関連付けられたブレンドユニットがありません。そのため、可能であれば、アプリケーションで 2 番目のテクスチャステージのみを使用する必要がある場合があります。このようなハードウェアでは、最初のユニットは既定の状態と見なされ、最初の color 引数はD3DTOP_SELECTARG1操作でD3DTA_TEXTUREに設定されます。

出力アルファに対する、カラー操作よりも複雑な操作や、色操作と大きく異なる演算は、サポートされる可能性が低くなります。

一部のハードウェアでは、D3DTA_TFACTORとD3DTA_DIFFUSEの同時使用がサポートされていません。

多くのカードでは、複数のテクスチャと mipmapped 三線式フィルタリングの同時使用はサポートされていません。マルチテキストブレンド操作に関係するテクスチャに対して三線フィルター処理が要求され、検証が失敗した場合は、三線フィルター処理をオフにして再検証します。この場合は、代わりにマルチパスレンダリングを実行する必要があります。