Device.TestCooperativeLevel メソッド
[このドキュメントはプレビュー版であり、後のリリースで変更されることがあります。 空白のトピックは、プレースホルダーとして挿入されています。]
ウィンドウ アプリケーションまたは全画面表示アプリケーションでの Direct3D デバイスの現在の協調レベル ステータスを報告します。
名前空間: Microsoft.WindowsMobile.DirectX.Direct3D
アセンブリ: Microsoft.WindowsMobile.DirectX (Microsoft.WindowsMobile.DirectX.dll 内)
構文
'宣言
Public Sub TestCooperativeLevel
'使用
Dim instance As Device
instance.TestCooperativeLevel()
public void TestCooperativeLevel()
public:
void TestCooperativeLevel()
member TestCooperativeLevel : unit -> unit
例外
例外 | 条件 |
---|---|
DeviceLostException | デバイスが消失しましたが、現時点ではリセットできません。したがって、レンダリングできません。 |
DeviceNotResetException | デバイスが消失しましたが、現時点でリセットできます。 |
解説
デバイスが消失し、現時点で復元できない場合、TestCooperativeLevel は DeviceLostException をスローします。これはたとえば、全画面表示デバイスがフォーカスを失ったような場合です。アプリケーションが消失したデバイスを検出した場合、一時停止し、例外がスローされなくなるまで TestCooperativeLevel を定期的に呼び出す必要があります。その後でアプリケーションは Reset を呼び出してデバイスのリセットを試み、成功した場合は、必要なリソースを復元して通常の処理を再開します。デバイスが "消失" または "非リセット" 状態の場合、Present は DeviceLostException をスローします。
TestCooperativeLevel が、リセットするデバイスを作成したスレッドと異なるスレッドで呼び出された場合、呼び出しは失敗します。
.NET Framework セキュリティ
- 直前の呼び出し元に対する完全な信頼。 このメンバーは、部分的に信頼されているコードから使用することはできません。 詳細については、「部分的に信頼される側のコードからライブラリの使用」を参照してください。
プラットフォーム
Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC
.NET Framework および .NET Compact Framework では、各プラットフォームのすべてのバージョンはサポートしていません。 サポートされているバージョンについては、「.NET フレームワークのシステム要件」を参照してください。
バージョン情報
.NET Compact Framework
サポート対象 : 3.5、2.0