IDirectDraw7::TestCooperativeLevel メソッド (ddraw.h)
ウィンドウまたは全画面表示アプリケーションの DirectDraw デバイスの現在の協調レベルの状態を報告します。
構文
HRESULT TestCooperativeLevel();
戻り値
メソッドが成功した場合、戻り値はDD_OK。これは、呼び出し元のアプリケーションが続行できることを示します。
失敗した場合、メソッドは次のいずれかのエラー値を返すことができます (「解説」を参照)。
- DDERR_INVALIDOBJECT
- DDERR_EXCLUSIVEMODEALREADYSET
- DDERR_NOEXCLUSIVEMODE
- DDERR_WRONGMODE
解説
このメソッドは、サーフェスを復元したり DirectDraw オブジェクトを再作成したりするための通知として、WM_ACTIVATEAPPメッセージとWM_DISPLAYCHANGEシステム メッセージを使用するアプリケーションに特に便利です。 DD_OK戻り値は、アプリケーションが続行できることを常に示しますが、エラー コードは、アプリケーションが使用する協調レベルに応じて異なる方法で解釈されます。
要件
| 対象プラットフォーム | Windows |
| ヘッダー | ddraw.h |
| Library | Ddraw.lib |
| [DLL] | Ddraw.dll |