Platform SDK: DirectX |
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 で宣言。