Device.ValidateDevice メソッド

.NET Framework クラス ライブラリ リファレンス

Device.ValidateDevice メソッド

デバイスが、現在のテクスチャ ブレンディング処理と引数を単一のパスでレンダリングする機能を報告します。

名前空間: Microsoft.WindowsMobile.DirectX.Direct3D
アセンブリ: Microsoft.WindowsMobile.DirectX (microsoft.windowsmobile.directx.dll 内)
構文

Visual Basic (宣言)

Public Function ValidateDevice As
 ValidateDeviceParams

Visual Basic (使用法)

Dim instance As Device
Dim returnValue As ValidateDeviceParams

returnValue = instance.ValidateDevice

C#

public ValidateDeviceParams ValidateDevice ()

C++

public:
ValidateDeviceParams ValidateDevice ()

J#

public ValidateDeviceParams ValidateDevice ()

JScript

public function ValidateDevice () : ValidateDeviceParams

戻り値
パスの数と検証チェックの結果コードを提供する ValidateDeviceParams オブジェクト。

例外

例外の種類	条件
DeviceLostException	デバイスが消失しており、現時点ではリセットできません。したがって、レンダリングできません。
DriverInternalErrorException	ドライバの内部エラーが発生しました。このエラーを受け取った場合、通常、アプリケーションをシャットダウンする必要があります。

解説

ValidateDevice メソッドは、他の機能では不十分な場合にのみ、シナリオの検証に使用する必要があります。たとえば、マルチステージ テクスチャリングのシナリオでは、MaxTextureBlendStages プロパティおよび MaxSimultaneousTextures プロパティを照会することで、デバイスでマルチステージ テクスチャリングが可能であるかどうかを判断できます。

現在のハードウェアは、処理と引数の組み合わせを必ずしもすべて実装しているわけではありません。指定した引数で特定のブレンド処理を実行できるかどうかを調べるには、目的のブレンド処理を設定してから ValidateDevice メソッドを呼び出します。

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

最高のパフォーマンスを得るには、初期化時に ValidateDevice を呼び出します。レンダリング ループ内ではこのメソッドを使用しないでください。

ディフューズ補間値の引数または操作 (Diffuse、BlendDiffuseAlpha) としての使用は、現在のハードウェアではほとんどサポートされていません。ほとんどのハードウェアでは、最後のテクスチャ処理ステージのみで補間色データの値を導入できます。

通常は、各ステージのテクスチャ TextureColor を、第 2 引数ではなく第 1 引数として指定してください。

多くのビデオ カードは、任意のテクスチャ ステージでのディフューズ値やスカラ値の使用をサポートしていません。多くの場合、これらの値は最初または最後のテクスチャ ブレンディング ステージでのみ使用できます。

多くのカードには、アルファ チャネルからカラー チャネルへのレプリケートや入力の反転以上の機能を備えている、最初のテクスチャに関連付けられたブレンディング ユニットがありません。したがって、アプリケーションでは、可能な場合、2 つめのテクスチャ ステージのみを使用しなくてはいけない場合があります。このようなハードウェアでは、最初のユニットは既定の状態にあると見なされます。既定の状態では、SelectArg1 処理での最初のカラー引数が TextureColor に設定されます。

出力アルファに対する処理で、カラー処理よりも複雑な処理、またはカラー処理と本質的に異なる処理をサポートするハードウェアは、さらに少なくなります。

ハードウェアによっては、TFactor と Diffuse の同時使用をサポートしていない場合もあります。

多くのカードは、複数テクスチャと MIPMAP トライリニア フィルタリングの同時使用をサポートしていません。複数テクスチャ ブレンド処理にかかわるテクスチャでトライリニア フィルタリングが要求され、検証が失敗した場合は、トライリニア フィルタリングをオフにして再検証を行ってください。このような場合は、代わりにマルチパス レンダリングを実行することをお勧めします。

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows CE, Windows Mobile for Pocket PC, Windows Mobile for Smartphone

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
Device クラス
Device メンバ
Microsoft.WindowsMobile.DirectX.Direct3D 名前空間