Device.CheckCooperativeLevel メソッド ()
アセンブリ: Microsoft.WindowsMobile.DirectX (microsoft.windowsmobile.directx.dll 内)
構文
Dim instance As Device Dim returnValue As Boolean returnValue = instance.CheckCooperativeLevel
デバイスが操作可能状態であり、呼び出し元アプリケーションを続行できる場合は true。デバイスが消失したか、リセットする必要がある場合は false。
.NET Framework のセキュリティ
プラットフォーム
Windows CE, Windows Mobile for Pocket PC, Windows Mobile for Smartphone
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
参照
Device.CheckCooperativeLevel メソッド
オーバーロードの一覧
名前 | 説明 |
---|---|
Device.CheckCooperativeLevel () | ウィンドウ アプリケーションまたは全画面表示アプリケーションでの Direct3D デバイスの現在の協調レベル ステータスを報告します。 .NET Compact Framework によってサポートされています。 |
Device.CheckCooperativeLevel (Int32) | ウィンドウ アプリケーションまたは全画面表示アプリケーションでの Direct3D デバイスの現在の協調レベル ステータスを報告します。 .NET Compact Framework によってサポートされています。 |
Device.CheckCooperativeLevel メソッド (Int32)
アセンブリ: Microsoft.WindowsMobile.DirectX (microsoft.windowsmobile.directx.dll 内)
構文
Dim instance As Device Dim hResult As Integer Dim returnValue As Boolean returnValue = instance.CheckCooperativeLevel(hResult)
- hResult
ResultCode 値を使用して報告される、ウィンドウ アプリケーションまたは全画面表示アプリケーションのデバイスの現在の協調レベル ステータス。Success という結果は、デバイスが操作可能状態であり、呼び出し元アプリケーションを続行できることを示します。DeviceLost という結果は、デバイスが消失したが、現時点ではリセットできないことを示します。したがって、レンダリングはできません。DeviceNotReset という結果は、デバイスが消失したが、現時点でリセットできることを示します。
デバイスが操作可能状態であり、呼び出し元アプリケーションを続行できる場合は true。デバイスが消失したか、リセットする必要がある場合は false。
デバイスが消失したが、現時点では復元できない場合、CheckCooperativeLevel は hResult パラメータの DeviceLost 結果コードを返します。これはたとえば、全画面表示デバイスがフォーカスを失ったような場合です。アプリケーションが消失したデバイスを検出した場合、一時停止し、戻り値の DeviceNotReset を受け取るまで CheckCooperativeLevel を定期的に呼び出す必要があります。その後でアプリケーションは Reset を呼び出してデバイスのリセットを試み、成功した場合は、必要なリソースを復元して通常の処理を再開します。デバイスが消失したまたはリセットされていない場合、Present は DeviceLostException をスローします。
CheckCooperativeLevel が、リセットするデバイスの作成に使用されたスレッドと異なるスレッドで呼び出された場合、呼び出しは失敗します。
プラットフォーム
Windows CE, Windows Mobile for Pocket PC, Windows Mobile for Smartphone
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
参照
- Device.CheckCooperativeLevelのページへのリンク