Device.CheckCooperativeLevel メソッド (Int32%)
[このドキュメントはプレビュー版であり、後のリリースで変更されることがあります。 空白のトピックは、プレースホルダーとして挿入されています。]
ウィンドウ アプリケーションまたは全画面表示アプリケーションでの Direct3D デバイスの現在の協調レベル ステータスを報告します。
名前空間: Microsoft.WindowsMobile.DirectX.Direct3D
アセンブリ: Microsoft.WindowsMobile.DirectX (Microsoft.WindowsMobile.DirectX.dll 内)
構文
'宣言
Public Function CheckCooperativeLevel ( _
<OutAttribute> ByRef hResult As Integer _
) As Boolean
'使用
Dim instance As Device
Dim hResult As Integer
Dim returnValue As Boolean
returnValue = instance.CheckCooperativeLevel(hResult)
public bool CheckCooperativeLevel(
out int hResult
)
public:
bool CheckCooperativeLevel(
[OutAttribute] int% hResult
)
member CheckCooperativeLevel :
hResult:int byref -> bool
パラメーター
- hResult
型 : System.Int32%
ResultCode 値を使用して報告される、ウィンドウ アプリケーションまたは全画面表示アプリケーションのデバイスの現在の協調レベル ステータス。Success という結果は、デバイスが操作可能状態であり、呼び出し元アプリケーションを続行できることを示します。DeviceLost という結果は、デバイスが消失したが、現時点ではリセットできないことを示します。したがって、レンダリングはできません。DeviceNotReset という結果は、デバイスが消失したが、現時点でリセットできることを示します。
戻り値
型 : System.Boolean
デバイスが操作可能状態であり、呼び出し元アプリケーションを続行できる場合は true。デバイスが消失したか、リセットする必要がある場合は false。
解説
デバイスが消失したが、現時点では復元できない場合、CheckCooperativeLevel は hResult パラメーターの DeviceLost 結果コードを返します。これはたとえば、全画面表示デバイスがフォーカスを失ったような場合です。アプリケーションが消失したデバイスを検出した場合、一時停止し、戻り値の CheckCooperativeLevel を受け取るまで DeviceNotReset を定期的に呼び出す必要があります。その後でアプリケーションは Reset を呼び出してデバイスのリセットを試み、成功した場合は、必要なリソースを復元して通常の処理を再開します。デバイスが消失したまたはリセットされていない場合、Present は DeviceLostException をスローします。
CheckCooperativeLevel が、リセットするデバイスを作成したスレッドと異なるスレッドで呼び出された場合、呼び出しは失敗します。
.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