Platform SDK: DirectX

IDirectDraw7::TestCooperativeLevel

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

HRESULT TestCooperativeLevel(void); 

パラメータ

なし。

戻り値

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

失敗すれば、以下のエラー値のいずれかを返す。(「注意」参照)。

DDERR_INVALIDOBJECT
DDERR_EXCLUSIVEMODEALREADYSET
DDERR_NOEXCLUSIVEMODE
DDERR_WRONGMODE

注意

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

動作環境

  Windows NT/2000 :Windows 2000 が必要。
  Windows 95/98 : Windows 98 が必要。
  ヘッダー : ddraw.h で宣言。