Platform SDK: DirectX |
DirectDraw7.TestCooperativeLevel メソッドは、ウィンドウまたはフルスクリーン アプリケーションに対する DirectDraw デバイスの現在の協調レベル ステータスを報告する。
object.TestCooperativeLevel() As Long
成功すれば、DD_OK を返す。これは、呼び出し側のアプリケーションが、実行を続けられることを示す。
失敗するか、DD_OK が返されないとエラーが発生し、Err.Number に次のいずれかの値が設定される (「注意」参照)。
DDERR_INVALIDOBJECT |
DDERR_EXCLUSIVEMODEALREADYSET |
DDERR_NOEXCLUSIVEMODE |
DD_OK |
DDERR_WRONGMODE |
このメソッドは、サーフェスのリストアや DirectDraw オブジェクトの再作成の通知として、WM_ACTIVATEAPP および WM_DISPLAYCHANGE システム メッセージを使用するアプリケーションで特に役立つ。戻り値 0 は、サーフェスをリストアまたは再作成することなく、アプリケーションが実行を続けられることを常に示す。しかし、エラー コードの解釈は、アプリケーションが使用する協調レベルによって異なる。詳細については、「協調レベルのテスト」を参照すること。