Device.CheckCooperativeLevel

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

Device.CheckCooperativeLevel メソッド ()

ウィンドウ アプリケーションまたは全画面表示アプリケーションでの Direct3D デバイスの現在の協調レベル ステータスを報告します。

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

Visual Basic (宣言)

Public Function CheckCooperativeLevel As
 Boolean

Visual Basic (使用法)

Dim instance As Device
Dim returnValue As Boolean

returnValue = instance.CheckCooperativeLevel

C#

public bool CheckCooperativeLevel ()

C++

public:
bool CheckCooperativeLevel ()

J#

public boolean CheckCooperativeLevel ()

JScript

public function CheckCooperativeLevel () :
 boolean

戻り値
デバイスが操作可能状態であり、呼び出し元アプリケーションを続行できる場合は true。デバイスが消失したか、リセットする必要がある場合は false。

解説

CheckCooperativeLevel が、リセットするデバイスの作成に使用されたスレッドと異なるスレッドで呼び出された場合、呼び出しは失敗します。

.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 名前空間

Device.CheckCooperativeLevel メソッド

ウィンドウ アプリケーションまたは全画面表示アプリケーションでの Direct3D デバイスの現在の協調レベル ステータスを報告します。
オーバーロードの一覧

名前	説明
Device.CheckCooperativeLevel ()	ウィンドウ アプリケーションまたは全画面表示アプリケーションでの Direct3D デバイスの現在の協調レベル ステータスを報告します。 .NET Compact Framework によってサポートされています。
Device.CheckCooperativeLevel (Int32)	ウィンドウ アプリケーションまたは全画面表示アプリケーションでの Direct3D デバイスの現在の協調レベル ステータスを報告します。 .NET Compact Framework によってサポートされています。

参照

関連項目

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

Device.CheckCooperativeLevel メソッド (Int32)

ウィンドウ アプリケーションまたは全画面表示アプリケーションでの Direct3D デバイスの現在の協調レベル ステータスを報告します。

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

Visual Basic (宣言)

Public Function CheckCooperativeLevel ( _
    <OutAttribute> ByRef hResult As Integer
 _
) As Boolean

Visual Basic (使用法)

Dim instance As Device
Dim hResult As Integer
Dim returnValue As Boolean

returnValue = instance.CheckCooperativeLevel(hResult)

C#

public bool CheckCooperativeLevel (
    out int hResult
)

C++

public:
bool CheckCooperativeLevel (
    [OutAttribute] int% hResult
)

J#

public boolean CheckCooperativeLevel (
    /** @attribute OutAttribute() */ /** @ref */ int hResult
)

JScript

JScript では、値型の引数は参照渡しされません。

パラメータ

hResult

ResultCode 値を使用して報告される、ウィンドウ アプリケーションまたは全画面表示アプリケーションのデバイスの現在の協調レベル ステータス。Success という結果は、デバイスが操作可能状態であり、呼び出し元アプリケーションを続行できることを示します。DeviceLost という結果は、デバイスが消失したが、現時点ではリセットできないことを示します。したがって、レンダリングはできません。DeviceNotReset という結果は、デバイスが消失したが、現時点でリセットできることを示します。

戻り値
デバイスが操作可能状態であり、呼び出し元アプリケーションを続行できる場合は true。デバイスが消失したか、リセットする必要がある場合は false。

解説

デバイスが消失したが、現時点では復元できない場合、CheckCooperativeLevel は hResult パラメータの DeviceLost 結果コードを返します。これはたとえば、全画面表示デバイスがフォーカスを失ったような場合です。アプリケーションが消失したデバイスを検出した場合、一時停止し、戻り値の DeviceNotReset を受け取るまで CheckCooperativeLevel を定期的に呼び出す必要があります。その後でアプリケーションは Reset を呼び出してデバイスのリセットを試み、成功した場合は、必要なリソースを復元して通常の処理を再開します。デバイスが消失したまたはリセットされていない場合、Present は DeviceLostException をスローします。

CheckCooperativeLevel が、リセットするデバイスの作成に使用されたスレッドと異なるスレッドで呼び出された場合、呼び出しは失敗します。

.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 名前空間