Platform SDK: DirectX

DirectDraw7.TestCooperativeLevel

DirectDraw7.TestCooperativeLevel メソッドは、ウィンドウまたはフルスクリーン アプリケーションに対する DirectDraw デバイスの現在の協調レベル ステータスを報告する。

object.TestCooperativeLevel() As Long

パラメータ

object
DirectDraw7 オブジェクトを表すオブジェクト式。

戻り値

成功すれば、DD_OK を返す。これは、呼び出し側のアプリケーションが、実行を続けられることを示す。

エラー コード

失敗するか、DD_OK が返されないとエラーが発生し、Err.Number に次のいずれかの値が設定される (「注意」参照)。

DDERR_INVALIDOBJECT
DDERR_EXCLUSIVEMODEALREADYSET
DDERR_NOEXCLUSIVEMODE
DD_OK
DDERR_WRONGMODE

注意

このメソッドは、サーフェスのリストアや DirectDraw オブジェクトの再作成の通知として、WM_ACTIVATEAPP および WM_DISPLAYCHANGE システム メッセージを使用するアプリケーションで特に役立つ。戻り値 0 は、サーフェスをリストアまたは再作成することなく、アプリケーションが実行を続けられることを常に示す。しかし、エラー コードの解釈は、アプリケーションが使用する協調レベルによって異なる。詳細については、「協調レベルのテスト」を参照すること。